Product Documentation

Upgrade

Oct 16, 2015

Upgrading or Uninstalling EdgeSight Server

You can directly upgrade from EdgeSight Server 5.3 to EdgeSight Server 5.4. Upgrades from Technology Preview releases are not supported.

Note:
  • EdgeSight Server 5.4 and EdgeSight Server 5.3 require either SQL Server 2008 R2 or SQL Server 2005. If you are upgrading EdgeSight Server from a release prior to EdgeSight 5.2 using SQL Server 2000, you will also need to upgrade your SQL Server installation.
  • If your SQL database is mirrored, disable the mirroring before you perform the upgrade. After the upgrade, you can restore the SQL server to the normal configuration. Refer to http://support.citrix.com/article/CTX138637 for details.
  • Support for the EdgeSight Virtual Desktop Agent is not enabled by default when you upgrade EdgeSight Server from a release prior to EdgeSight 5.2. To enable support after upgrading, open the EdgeSight Server Console and go to Configure > Server Configuration > Settings and set EdgeSight for XenDesktop Support to On.
Important: You should back up your EdgeSight database before performing an EdgeSight Server upgrade. Optionally, you may want to reboot your EdgeSight Server so that all EdgeSight processes are restarted, providing a known state from which to upgrade. Also, the EdgeSight Server should be upgraded before upgrading the associated EdgeSight agents.

Each time you invoke server setup, the MSI file checks for existing versions of the Citrix EdgeSight database and Web server components.

The time it takes to perform an upgrade may be affected by size of the database and the distribution of the database file group. Additional time may be required to perform file group moves during the upgrade.

If you are performing a database-only upgrade on a system hosting both the EdgeSight Web site and database, turn off IIS on the system before performing the upgrade. This will prevent EdgeSight from attempting to process data uploads and alerts at the same time that the database is being updated. In the case of a full update, however, IIS must be running in order to allow an IIS reset as part of the installation process.

  1. Open the EdgeSight Server Console.
  2. Select the Configuration tab.
  3. Navigate to Server Configuration > Settings and select the Agent Support tab.
  4. Set EdgeSight for XenDesktop Support to On.

Upgrading Citrix License Server Monitoring

If you are upgrading from EdgeSight 5.3 and have been monitoring license servers running earlier versions of Citrix Licensing, you must upgrade to Citrix Licensing 11.9 to monitor those license servers with EdgeSight 5.4.

Upgrading Agents

Important:
  • Perform the EdgeSight Server upgrade before upgrading the associated EdgeSight agents.
  • Upgrading from a Technology Preview Release is not supported.

You can directly upgrade from the EdgeSight for XenApp 6 Agent 5.3 (64-bit) to the EdgeSight for XenApp 6 Agent 5.4 (64-bit). You can also directly upgrade from EdgeSight Agent 4.2 or 4.5 to EdgeSight Agent 5.4 using a new MSI file. If you do not have the latest service pack installed for a prior version, install the service packs for the specific version before upgrading to EdgeSight Agent 5.4. Agent data files (agent database and log files) and registry key settings are retained during the upgrade.

Important: If agents are not upgraded to a minimum version of 5.3, data for the associated device cannot be uploaded to an EdgeSight 5.4 server, as described in "Agent Requirements" in System Requirements for EdgeSight 5.4.

Direct upgrades of EdgeSight 4.1 agents are not supported. If you are using an EdgeSight 4.1 agent, you can first upgrade to a 4.2 agent and then perform a 5.4 upgrade. This will retain agent data and settings. If you do not need to retain data, you can uninstall the 4.1 agent and reinstall an EdgeSight 5.4 agent.

Uninstalling Agents

You can uninstall an agent using any of the following methods:

  • Execute the msiexec command for the EdgeSight MSI with the /uninstall argument.
  • Right-click on EdgeSight.msi and choose Uninstall from the pop-up menu.
  • Use the Add and Remove Programs feature on the Control Panel.

You may encounter an error during uninstallation indicating that files cannot be removed from the system. In most cases, clicking Retry will result in a successful uninstallation. After uninstalling an agent, reboot the target machine. If the machine is not rebooted, a subsequent attempt to install an agent will fail.

Note: The DELETE_DATA_ON_UNINSTALL property controls whether agent data files (agent database and log files) are deleted when the agent is uninstalled. The default setting is to delete agent data files. See Installing EdgeSight Agents Using the Command Line for more information.

Upgrading EdgeSight in a Virtual Desktop Environment

The following upgrade information relates to upgrades from EdgeSight 5.0, 5.1, 5.2, or 5.3 agents to EdgeSight 5.4 agents:

  • If you have existing EdgeSight Agents running on virtual desktops, you must uninstall and reinstall the agents.
  • The Agent Database Server can be directly upgraded. Any agent databases currently resident on the server are also upgraded. This ensures that no data is lost when EdgeSight for Endpoints Agents are replaced with EdgeSight for Virtual Desktops Agents.

Because all required components must be in place, and because some installation steps are dependent on previous actions, the following task sequence is recommended:

  1. Uninstall the agents.
  2. Upgrade EdgeSight Server.
  3. Upgrade the Agent Database Server (Installing the Agent Database Server).
  4. Install the new agents (Installing the Agent).