Top

Using EdgeSight with Provisioned XenApp Servers

Using EdgeSight in provisioned XenApp environments can be tricky if you don’t follow the proper installation steps.  Monitoring provisioned XenApp servers is pretty straight forward and easy to setup with minimal requirements.  In this blog post I am going to go over what the requirements are for provisioned XenApp servers and how to setup the EdgeSight for XenApp agent.

What is required to use the EdgeSight for XenApp Agent when provisioning XenApp servers?

The EdgeSight for XenApp agent requires a local persistent disk when used in provisioned XenApp environments.  What this means is you need to setup a local disk, whether streaming XenApp to virtual or physical machines, for the EdgeSight data.  This local persistent disk is already setup if you using the Standard vDisk mode with write cache on target device hard drive.  If don’t have this setup, you are either placing the Provisioning Services write cache in the target device RAM or on the Provisioning Servers/shared location. 

Along with EdgeSight data, you can also store Windows Event Logs, Crash Dumps, Windows Page File, and Application Streaming rade cache on the local persistent disk.

Installing the EdgeSight for XenApp Agent

Installing the EdgeSight for XenApp Agent is the same process as installing it on a non provisioned XenApp server except for the following:

  • When installing the EdgeSight for XenApp agent, the vDisk must be in Private Mode.
  • At the Agent Location dialog, change the default location  of the data files folder to your persistent local disk.  Default location is C:Documents and SettingsAll UsersApplication DataCitrixSystem MonitoringData for Windows 2003 or C:ProgramDataCitrixSystem MonitoringData for Windows 2008.  Change this to your local persistent disk.  For example if my local persistent disk is E:, I would change the data files folder to something like E:CitrixSystem MonitoringData.

  • When the install completes, click NO when prompted to reboot.

  • Set the Citrix System Monitoring Agent service startup type to Manual.

 

  • Reboot

If you accidentally reboot before setting the Citrix System Monitoring Agent service startup type to Manual, see the EdgeSight Install Guide pages 47 to 48 for steps to clean up the XenApp for EdgeSight Agent install.  Starting the Citrix System Monitoring Agent while in Private Mode can cause registry settings to be generated that only apply the vDisk image that is in Private Mode that are pushed out to all Target Devices when the vDisk is change back to Standard Mode.

Now before shutting down the XenApp server and placing the vDisk image back into Standard Mode, you have two options:

  • Change the Citrix System Monitoring Agent service startup type to Automatic so the service starts automatically in Standard Mode.
  • Leave the Citrix System Monitoring Agent service startup type to Manual and control service via startup scripts.

I like to control the service via startup scripts so the Citrix System Monitoring Agent service only starts when the vDisk is in Standard Mode.  See the following example script that detects the vDisk mode and only starts the Citrix System Monitoring Agent service if the vDisk is in Standard Mode.  The script will also write and event to the Windows Event Log.

@Echo off
REM Script by Jarian Gibson for Provisioning Services and EdgeSight
REM Add this script as a startup script in Group Policy.
REM Set the Citrix System Monitoring Agent service (EdgeSight) to manual startup.
REM ***************************************************
REM This section will check to see the PVS vDisk Mode.
REM If the PVS vDisk is in Private Mode, then the EdgeSight service will not start.
Type C:Personality.ini | FIND /I “$WriteCacheType=0″ >nul
If %errorlevel%==0 (
Echo “Warning: Private Mode vDisk – Citrix System Monitoring Agent Service (EdgeSight) Will Not Start”
REM Write Warning to Windows Application Event Log                         
eventcreate /t warning /id 100 /l application /so EdgeSight /d “Private Mode vDisk – Citrix System Monitoring Agent Service(EdgeSight) will not start.”
GoTo NoEdgeSight 
)
Net Start RSCorSVC
Echo “Info: Standard Mode vDisk – Citrix System Monitoring Agent Service (EdgeSight) Will Start”                             
REM Write Info to Windows Application Event Log                          
eventcreate /t information /id 100 /l application /so EdgeSight /d “Standard Mode vDisk – Citrix System Monitoring Agent Service(EdgeSight) will start.”
:NoEdgeSight
REM ***************************************************

This script can be combined with my script from my previous blog Updating Provisioned XenApp vDisks: To XenAppPrep to not to XenAppPrep? to detect the vDisk mode and only start the XenAppPrep service and Citrix System Monitoring Agent service if the vDisk image is in Standard Mode. 

@Echo off
REM Script by Jarian Gibson for Provisioning Services for XenApp with EdgeSight and XenAppPrep
REM Add this script as a startup script in Group Policy.
REM Set the XenAppPrep service to manual startup.
REM Make Sure EdgeSight Agent for XenApp Agent is installed, set service to manual startup, and local database files are on local PVS cache disk.
REM ***************************************************
REM This section will check to see the PVS vDisk Mode.
REM If the PVS vDisk is in Private Mode, then the Citrix System Monitoring Agent Service(EdgeSight) and XenAppPrep service will not start.
Type C:Personality.ini | FIND /I “$WriteCacheType=0″ >nul
If %errorlevel%==0 (
Echo “Warning: Private Mode vDisk – Citrix System Monitoring Agent Service (EdgeSight) and XenAppPrep Service Will Not Start”
REM Write Warning to Windows Application Event Log                         
eventcreate /t warning /id 100 /l application /so EdgeSight_XenAppPrep /d “Private Mode vDisk – Citrix System Monitoring Agent Service(EdgeSight) and XenAppPrep Service will not start.”
GoTo NoEdgeSightXenAppPrep 
)
Net Start XenAppPrep
Net Start RSCorSVC
Echo “Info: Standard Mode vDisk – Citrix System Monitoring Agent Service (EdgeSight) and XenAppPrep Service Will Start”                             
REM Write Info to Windows Application Event Log                          
eventcreate /t information /id 100 /l application /so EdgeSight_XenAppPrep /d “Standard Mode vDisk – Citrix System Monitoring Agent Service(EdgeSight) and XenAppPrep Service will start.”
:NoEdgeSightXenAppPrep
REM ***************************************************

So as you can see, using EdgeSight with provisioned XenApp Servers is pretty straight forward as long as you following the proper installation steps.  Just make sure you have a local persistent disk for the EdgeSight database files, do not reboot when the EdgeSight for XenApp agent install completes, and set the Citrix System Monitoring Agent service to startup type to Manual.  Using the script examples above you can control the services thru Group Policy startup scripts.

Update: As of EdgeSight 5.2 Service Pack 1, you no longer need to set the Citrix System Monitoring Agent Service to manual.  The EdgeSight Agent is smart enough to detect the vDisk mode and won’t start in Private Mode just like it does with the EdgeSight for Virtual Desktop Agents in XenDesktop.  Thanks to Joe Shonk for pointing that out.

How do I use the EdgeSight for XenApp Agent with provisioned XenApp Servers in Private Mode?

All you have to do is set the REG_DWORD IgnorePVSMode to 1 in the registry at HKLMSoftwareCitrixSystem MonitoringAgentCore4.00.  Thanks to David Sachon from Citrix for helping me out in the Citrix Support Forums.

If you have found this article interesting or if you have any other insights, please feel free to leave comments on this article.

, , ,

21 Responses to Using EdgeSight with Provisioned XenApp Servers

  1. johan Martens September 14, 2010 at 12:52 PM #

    Hi

    I tried this script and I cant make it work, I get a lot of error messages. What kind of scipt language do I ned to use? is it not *.cmd/bat?

    Thanks

    • Jarian Gibson September 14, 2010 at 5:17 PM #

      .cmd file

    • Jarian Gibson September 14, 2010 at 5:23 PM #

      What error messages are you getting?

    • Manoj March 20, 2012 at 10:37 AM #

      Hi, I have a provisioning Xenapp environment production. I just installed the edgesight and is it necessary to install the edgesight client on each five xenapp server in private mode?

      • Jarian Gibson March 20, 2012 at 10:47 AM #

        No, you only need to install the EdgeSight agent in private mode. Make sure to put the EdgeSight data on a persistent drive. When you put the image back into standard mode and roll back out all XenApp servers using the image will have the EdgeSight agent.

  2. Richard January 5, 2011 at 1:10 PM #

    This info is rather dated. I did this for a while but later found that you don’t need to do anything special with ES to work with PVS, assuming the data store for it is on a peristent disk. It now also has intelligence that it will not start at all when running on a machine in private mode. Leave it set to auto and forget about it.

    All personalized/machine specific settings for ES are kept in text files with the firebird database on the peristent disk.

    • Jarian Gibson January 5, 2011 at 1:15 PM #

      You are correct. That is why I have it stated in the article if you are 5.2 sp1 or above you no longer need to control the service. You would be surprised that some people have not upgraded yet.

  3. pavan September 28, 2011 at 2:27 PM #

    Hi, I am planning to setup a POC and now in stage of reading documents. I am reading Citrix Edgesight Installation Guid for XenApp 5.3. We are running PVS XenApp Server with Single Disk. Where dose the Firebird Service keep the data temporarily in this case. Do we need to create a Agent File share similar to ES Agent for Virtual Desktop? Is there any clear documentation around this. Please help.

    Thanks.

    • Jarian Gibson October 2, 2011 at 12:21 AM #

      The agent file share is only for XenDesktop. To EdgeSight with provisioned XenApp servers you need to follow the article above. The EdgeSight data has to be on a persistent disk. This can be the Provisioning Services write cache disk (if setting write cache to local device hd) or another persistent disk attached.

  4. MOHAN K October 6, 2011 at 8:02 AM #

    Mohan k

    Can any one help me out for disable edgesight for virtual desktops other then stopping services ( citrix system monitoring agent & firebrid server CSMInstance) i need to disable this services automatically in all desktops.

  5. Jeem Jeem December 20, 2011 at 6:31 PM #

    Worth noting that if you copy and paste the script into a Notepad doc that some of the characters do not translate properly and cause issues when you run the script as a batch file. The characters in question seem to the beginning and ending quotation marks and the dash or hyphen in the information messages.

  6. Vibranze February 28, 2012 at 10:26 PM #

    Hi Jarian,
    I have an issue where the persistent disk used for edgesight always went offline everytime i restart the target device and this has caused the edgesight server didn’t receive any reporting. Any pointers on this?
    Thanks.

    • Jarian Gibson March 20, 2012 at 10:50 AM #

      Where are you putting the EdgeSight data? If you are putting on the write cache disk, any issues with the disk?

  7. iPadU May 18, 2012 at 11:26 AM #

    We just took the master xenapp image (in private mode) and installed the edgesight agent, and re-packaged the image for deployment. We are finding that some xenapp hosts do check in with the Edgesight server, but then some that were there disappear again afterwards.
    Do you have to have a persistent drive attached or could you map to a network share instead? Or would that cause overwriting issues?
    If I do need to have a persistent drive attached to each XenApp PV’d server, what size do they need to be?

    • Jarian Gibson May 18, 2012 at 11:44 AM #

      For XenApp and EdgeSight you will need to have a persistent drive. This can be the write cache drive if using write cache on target device hard drive. Watch your storage performance when doing this. EdgeSight can and will have extra performance overhead. As far as size it depends what all data you are putting on the persistent drive.

      • Josh Lindemann May 18, 2012 at 11:46 AM #

        so what size are yours typically? Just trying to figure out a range to work with. I don’t want to give it 100GB if its only going to use 2-5GB.

        • Jarian Gibson May 18, 2012 at 3:35 PM #

          Will this be the same disk used for write cache or any other persistent data like event logs, stream cache, etc?

      • Josh Lindemann May 18, 2012 at 3:32 PM #

        I guess I’m curious as well, since it works with XenDesktp, if you used a UNC path on the XenApp Server agent could that work?
        Perhaps a share with a folder for each xenapp server?
        ie:path = servernameshare%computername%

        This way it could be stored on the Edgesight server and reduce the need to create multiple persistent drives.

        Thoughts?

      • deeptidevikarepti December 6, 2012 at 11:20 PM #

        Hi Jarian , I have a similar problem like iPadU stated above. I am using a common image for 6 XenApp 6.5 servers but 4 of them do not appear on the console. I checked and the agent is running fine , there is a persistent drive on all servers and the logs are being updated. All XenApp5 servers are there in the ES console. Please guide.

Trackbacks/Pingbacks

  1. uberVU - social comments - March 17, 2010

    Social comments and analytics for this post…

    This post was mentioned on Twitter by jariangibson: Using EdgeSight with Provisioned XenApp Servers: http://wp.me/pCar2-8p #Citrix #in…

  2. XenApp Power and Capacity Management with provisioned machines | archy.net - January 5, 2012

    [...] I use a login script for the XenApp servers, a very good example can be find here : http://jariangibson.com/2010/03/17/using-edgesight-with-provisioned-xenapp-servers/ I just add a line to start the PCMAgent service [...]

Leave a Reply

%d bloggers like this: