Product Documentation

Upgrade

Jun 27, 2017
Each time you upgrade your Citrix product, also upgrade the Citrix License Server. Each time a new License Server is released, it might contain better security, fixes to known issues, and so on. Sometimes, new versions of the Citrix product are not compatible with older versions of the License Server.
Note: New versions of the License Server are compatible with older versions of the product and old licenses.

Current Citrix Subscription Advantage members are eligible to version upgrade to the latest release of Citrix products and upgrade existing licenses to the license system used by these products.

Version upgrade means the movement from any previous version of a product to the newest version of the product. For example, moving from XenDesktop 5.6 to XenDesktop 7.x.

Edition upgrade means the purchase of a higher edition level of a product. For example, you now have Enterprise Edition and you purchase an upgrade to Platinum Edition.

Warning

Upgrades are not supported for License Server VPX. See Move license files from an older License Server VPX version and Export historical usage data.

Upgrade the License Server

Citrix recommends that you install the newest License Server. The new License Server is backward compatible and supports older products and license files. However, new products require the newest License Server to check out licenses correctly. You can install or upgrade the latest version from the Citrix website (Downloads page).

Upgrade your licensing components before upgrading your product, if necessary.

Uninstall any versions of Citrix Licensing older than version 11.3 (released in 2007) before installing this version.

Use the new CitrixLicensing.exe file for all future installations and upgrades, except for Active Directory deployments. In that case, use the .msi. Ensure that both .exe and .msi files are present for the installation.

Unsure which version of the License Server you have? See Ensure you have the latest license server.

For information about system requirements, see System requirements.

 

Important

To avoid the failure of any subsequent License Server upgrades: Ensure that when you installed your License Server, you successfully configured it with the post installation License Server Configuration tool or uninstalled your previous License Server.

To upgrade the License Server:

Download the license components on the Citrix website (Downloads page), start the License Server installer (CitrixLicensing.exe) as an administrator, and follow the graphical interface.

To upgrade the License Server from your product media:

If you use the product media for your installation, you might have to enable some functionality by using the Citrix Licensing Manager after your installation. For example, use the Citrix Licensing Manager to enable Subscription Advantage renewals.

  1. From your License Server, open the media for your product.
  2. If you do not see Setup, use Windows Explorer to open Autorun.exe or AutoSelect.exe.
  3. Navigate through the Setup screens to Citrix Licensing and follow the instructions.

To upgrade the License Server from the command line

Ensure that you run the command line with administrator privileges. To start the command prompt with elevated privileges, choose Start, right-click Command Prompt, and choose Run as administrator.

Note: The Citrix Service Provider program requires Customer Experience Improvement Program (CEIP) and Call Home. If you are a Citrix Service Provider, you cannot disable CEIP or Call Home.

You cannot change ports during a command line upgrade.

The following sample command line installs licensing in silent mode.  

CitrixLicensing.exe /quiet /l install.log INSTALLDIR=installdirectory CEIPOPTIN=ANON

  • /quiet specifies a silent (quiet) installation.
  • /l specifies the log file location
  • INSTALLDIR is the location where the License Server executable is stored. Optional parameter. The default is c:\program files\citrix licensing or c:\program files (x86)\citrix\licensing.
  • CEIPOPTIN specifies whether, or how, to opt in to Citrix Customer Experience Improvement Program (CEIP) or Call Home. Optional parameter. The default is ANON.
    • DIAG - Call Home
    • ANON - CEIP
    • NONE

You can modify the CEIP and Call Home choice using the Citrix Licensing Manager.

Upgrade licenses for your edition

To run a higher edition of a Citrix product (for example, XenDesktop Enterprise to Platinum), purchase an upgrade license and add it to the License Server. Also change the product edition setting in the product user interface. It's best to change the product edition setting when there are few connections to the affected servers or redirect connections to another computer. When you change the product edition setting, restart the product server for changes to take effect. See the product documentation for changing the edition setting. If you add the upgrade license to the License Server before you set the edition to the new edition, the Citrix product stops accepting new connections.

Note

Licenses from old product editions display on the Dashboard of the License Administration Console even though they are no longer valid. If you do not remove obsolete or unnecessary license allocations, you might see persistent alerts regarding the Subscription Advantage expiration dates of these licenses. You cannot turn off these alerts. The only impact of leaving obsolete license allocations on License Servers is that you continue to receive these alerts. If you want to remove the licenses, see Delete License Files.

To upgrade edition licenses:

  1. From a web browser, go to http://www.citrix.com.
  2. Click Log In and enter your user ID and password.
  3. Select All Licensing Tools.
  4. From the main menu, select Upgrade.
  5. Follow the site options and instructions for upgrading your product edition licenses.
  6. Either download or order new media. An email message provides you with instructions to return to citrix.com to allocate or receive more feature licenses.
  7. Log on to www.citrix.com to allocate your licenses, generate a license file, download the license file to your License Server, and reread the file.

Configure a proxy server for use with Citrix Licensing Manager, Customer Experience Improvement Program (CEIP), and Call Home

You can use a proxy with the Citrix Licensing Manager, CEIP, and Call Home. When you configure a proxy server, requests to download licenses and upload Call Home data is sent through a proxy server.

If you are a Citrix Service Provider who requires a proxy, follow this configuration.

Important

Citrix Licensing components requiring outward bound web communications can inherit network proxy settings using Windows automatic proxy detection. We do not support authenticated proxies. For more information, see WinHTTP AutoProxy Functions.

To configure a proxy server

  1. Edit the SimpleLicenseServiceConfig.xml file, which is in the <citrix Licensing>\WebServicesForLicensing directory.
  2. Add a line of xml to the file in the format <Proxy>proxy server name:port number</Proxy>
    Important: The .xml tags are case-sensitive.
Sample Copy

<Configurations>

  <EncoreConfiguration>

    <SamplingPeriod>15</SamplingPeriod>

    <RetentionTime>180</RetentionTime>

    <Enabled>true</Enabled>

  </EncoreConfiguration>

  <Proxy>10.211.55.5:808</Proxy>

</Configurations>