Licensing guide for Citrix Virtual Apps and Desktops

Install a new license

To install a license, you can either use the automatic method or the manual method. Automatic license installation is the preferred method and requires access to citrix.com public domains through the License Server.

This section contains the following procedures:

Before you start

  • Ensure you have your license access code in the LA-xxxxxxxxxx-xxxxx format. This code is listed in the Citrix email when you purchase a license.
  • Install a License Server if a new site does not have an existing Citrix infrastructure.
  • Partially allocate licenses as required for your deployment. For more information, see the term Allocate licenses in the Glossary.

Automatic installation

  1. Download the Citrix Virtual Apps and Desktops product installer from citrix.com and start the installation.

  2. Choose the License Server as an administrator or a member of the administrators group. If you already have the latest version of the License Server installed, skip to step 5.

  3. Follow the installer instructions to accept the destination folder.

  4. Choose to start the Citrix Licensing Manager and whether to join the Citrix Customer Experience Improvement Program.

  5. Log on to the License Server.

  6. In the Start menu, select All Programs > Citrix > Citrix Licensing Manager or from a remote machine use https://licenseservername:8083 with your actual License Server name.

  7. Click Install Licenses.

    Install license

  8. Select Use license access code and enter the license access code you got in an email from Citrix, and choose Display Licenses. Your license entitlements display and you can choose licenses and the quantity to install.

  9. Select a product from the displayed list, type the number of entitlements to install, and choose Install.

  10. To display the newly downloaded licenses, select the Dashboard tab.

    Dashboard

Manual installation

If your License Server is not able to contact www.citrix.com, use the Citrix Manage Licenses portal to allocate licenses, download the license file, and upload it to the appliance.

  1. From a web browser, go to www.citrix.com.

  2. Click Sign In > My Account and type your user ID and password.

  3. Select Manage Licenses.

    Manage license

  4. Select the licenses you want to allocate. The landing page displays only new licenses within 30 days and expiring term licenses. You can use the Find a license by… search to find all licenses using one of the search criteria. Then use the Filter by menu to narrow the display down to specific types of licenses. You can select Quick find: All active to see all licenses.

  5. From the Select an action menu, choose Allocate licenses.

  6. Enter the host name (case sensitive) and how many licenses to allocate and click Create license file. You can find the License Server host name, Ethernet address, and IPv4 address from the License Server version drop-down in the Citrix Licensing Manager navigation bar.

  7. Select Yes, create license file.

  8. Select Download license file, and save the file to a location accessible from your License Server or Appliance.

  9. Log on to the License Server.

  10. On the Start menu, click All Programs > Citrix > Citrix Licensing Manager or from a remote machine use this URL with your actual License Server name https://licenseservername:8083.

  11. Click Install Licenses.

    Manage license

  12. Select Use downloaded license file, browse and choose a file, and check the check box if you want to replace and older file with the same name.

  13. Click Import. The Citrix Licensing Manager displays information about the licenses. If your license file is successfully uploaded to the License Server, a message displays.

  14. Click the Dashboard tab to display the newly downloaded licenses.

  15. Once the license server is connected, you can select these licenses during the site configuration in the wizard.

If you already have a site setup, your new licenses are now ready for consumption.

For a new Virtual Apps and Desktops installation and configuration, see the following documentation https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/install-configure.html.

Renew a license

Use the Citrix Licensing Manager to automatically install any renewed licenses to the license server. For automatic license renewal, you need access to citrix.com public domains through the License Server.

To renew the CSS agreement for your license files, refer to the Renewal guide.

The following section contains methods to renew a license

Renew a license - Automatic method

  1. Log on to the License Server.

  2. On the Start menu, click All Programs > Citrix > Citrix Licensing Manager or from a remote machine use this URL with your actual License Server name https://licenseservername:8083.

  3. Go to the Update Licenses tab.

  4. Check for available Customer Success Services renewal licenses. When licenses are available, the list of licenses, quantity, and Customer Success Services date displays on the screen. You can download and install the licenses. The following screen lists any licenses that are installed in the last 30 days.

    Update licenses

  5. Click Download and Install next to the licenses you want to install.

  6. You can configure the Citrix Licensing Manager to automatically install any renewed licenses in the future. Click the Settings icon on the top right of the screen.

  7. Select from the following options on how you want to be notified and automatically install the renewal licenses:

    • Automatically check for Customer Success Services renewal licenses and notify when available: Citrix Licensing Manager displays a notification. Click a link to download and install the available renewals. This same notification appears in Studio and Director if they are configured to manage the License Server.
    • Automatically check for and install Customer Success Services renewal licenses when available: Citrix Licensing Manager checks weekly and automatically installs renewal licenses when available. A notification displays for a few days stating that renewals have been installed.
    • Manually check for Customer Success Services renewal licenses: Select the Update Licenses tab and Check for Available Renewals. You can check the Update Licenses tab at any time to see a list of licenses installed in the last 30 days.

Note:

If the automatic checks for Customer Success Services renewal licenses fail, check the firewall setting or configure a proxy.

For this feature to work, the License Server must be able to access https://citrixservices.citrix.com. For more information, see Configure a proxy server manually.

Renew a license - Manual method

If your License Server cannot connect to the www.citrix.com or no Customer Success Services renewal licenses are available in the Licensing Manager, use the Citrix Manage Licenses portal to download the renewed license file and then install it inside the Citrix Licensing Manager.

  1. From a web browser, go to www.citrix.com.

  2. Click Sign In > My Account and type your user ID and password.

  3. Select Manage Licenses.

    Manage license

  4. Select the licenses you want to allocate. The landing page displays only new licenses within 30 days and expiring term licenses. You can use the Find a license by… search to find all licenses using one of the search criteria. Then use the Filter by menu to narrow the display down to specific types of licenses. You can select Quick find: All active to see all licenses.

  5. From the Select an action menu, choose Download license files, and save the file to a temporary location. Remember the file name and location where you downloaded the file.

  6. Log on to the License Server.

  7. On the start menu, click All Programs > Citrix > Citrix Licensing Manager or from a remote machine use this URL with your actual License Server name https://licenseservername:8083.

  8. Go to the Install Licenses tab.

  9. Select Download and Install to download and install the licenses. Your renewed licenses are now installed on the License Server. Manage license

  10. Select Use downloaded license file, browse and choose a file, and check the check box if you want to replace and older file with the same name.

  11. Click Import. The Citrix Licensing Manager displays information about the licenses. If your license file is successfully uploaded to the License Server, a message displays.

  12. Click the Dashboard tab to display the newly downloaded licenses.

Licensing guide for Citrix Virtual Apps and Desktops