Product Documentation

Installing Licensing Components for Windows

Feb 28, 2012

Licensing components can either be installed on a separate, dedicated server or on a server they share with another application (for example, a backup data collector, farm metric server or terminal server license server). Alternatively, you can use a Web or application server; however, the locations mentioned below are less resource intensive. If you are running fewer than 50 servers, you can install the license server on the same server as your product.

Software and Hardware Requirements

Firewall Considerations

To import and configure the License Server VPX 11.12 Build 14001

To install the license server and console using the setup wizard

  1. Log on as an administrator or a member of the Administrators group.
  2. Insert the product installation media and navigate through the Autorun screens to Citrix Licensing and follow the instructions. The exact screen names vary, depending on the product. For example:
    • In XenApp, select Manually install components > Common Components > Citrix Licensing.
    • In XenDesktop, select Install Server Components > I accept the license agreement > Citrix License Server.
  3. Follow the setup wizard to accept the destination folder. Licensing components are installed in C:\Program Files\Citrix\Licensing on a 32-bit computer and C:\Program Files (x86)\Citrix\Licensing on a 64-bit computer.
  4. Accept or change the default port numbers for use by Licensing components. You can change the port numbers after the installation, if needed.
    • License server port number is 27000
    • Vendor daemon port number is 7279
    • Console Web port is 8082
  5. For workgroup installations, set a password for the admin user of the console. If you are in a domain, the license server adds the installing user (domain\user) as a default License Administration Console administrator.
You are now ready to go to the Citrix Web site to obtain the license files needed to run your Citrix products. This procedure is detailed in Obtaining Your License Files.

Using the Command Line to Install Licensing

When using the Msiexec command to install licensing, set properties by adding Property=“value” on the command line anywhere except between an option and its argument.

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

The following sample command line installs licensing in silent mode and creates a log file to capture information about this operation. Add the properties you want to set after the switches.

Type the command in one line without returns. The following example shows multiple lines due to space limitations.

msiexec /I ctx_licensing.msi /l*v install.log /qn INSTALLDIR=installdirectory LICSERVERPORT=portnumber  
VENDORDAEMONPORT=portnumber MNGMTCONSOLEWEBPORT=portnumber ADMINPASS=password

where:

  • /l*v is the location of the setup log. Optional parameter.
  • /qn specifies a silent (quiet) installation.
  • 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.
  • LICSERVERPORT is the port number used for the license server. Optional parameter. The default is 27000.
  • VENDORDAEMONPORT is the port number used for the vendor daemon. Optional parameter. The default is 7279.
  • MNGMTCONSOLEWEBPORT is the port number used for the console. Optional parameter. The default is 8082.
  • ADMINPASS is the password for the console user "admin". This parameter is required only in non-Active Directory environments. It is ignored when the license server is installed on an Active Directory computer. In an Active Directory environment, the license server adds the installing user (domain\user) as a default License Administration Console administrator.
Note: On an Active Directory computer, you can specify the following command and have a fully functional license server.
msiexec /I ctx_licensing.msi /qn 

If you are installing in a clustered environment, use the two additional properties in this example:

msiexec /I ctx_licensing.msi /l*v install.log /qn LICSERVERPORT=portnumber  
VENDORDAEMONPORT=portnumber MNGMTCONSOLEWEBPORT=portnumber ADMINPASS=password  
CTX_CLUSTER_RESOURCE_DLL_PATH="c:\ctxlic\" REGISTER_CTX_LS_CLUSTERING="No"

where:

  • CTX_CLUSTER_RESOURCE_DLL_PATH is the location where the cluster resource DLL executable is stored. Used for clustering only.
  • REGISTER_CTX_LS_CLUSTERING is either "no" for cluster node 1 or "yes" for cluster node 2. Used for clustering only.