Clustering Licensing Server 11.5
The Citrix Licensing Server Version 11.5 was recently released and is a requirement of Presentation Server 4.5 Roll-up Pack 2 servers and Xen App 5.0 servers.
The following components are required prior to the implementation of Citrix Licensing Server 11.5 on to a Windows 2003 cluster :-
- Java Runtime Environment V6 Update 5 or above
- MS XML 6.0 SP2
- IIS 6.0 installed on both nodes of the cluster
- A Physical Disk Resource on the cluster
- Cluster node Hostnames MUST be in Capitals
- Cluster Network Name resource MUST be in Capitals
In order to successfully implement the Citrix Licensing Server Version 11.5 on to a cluster perform the following sub sections.
Part One – Installing On To The Primary Cluster Node
1. In the command prompt of the Primary Cluster Node enter the command shown below :-
msiexec /i D:\Licensing\ctx_licensing.msi CTX_CLUSTER_RESOURCE_DLL_PATH=” C:\ctxlic” REGISTER_CTX_LS_CLUSTERING=”No” /l*v “f:\install.log”
2. The example above uses D: as the install media location and F: as the shared cluster disk
3. Run through the Licensing setup pointing the destination folder to the shared cluster disk e.g. F:\Program Files\Citrix\Licensing
4. Once the installation has completed successfully fail the Cluster Groups over to the second node
Part Two – Installing On To The Secondary Cluster Node
1. In the command prompt of the Secondary Cluster Node enter the command shown below :-
msiexec /i D:\Licensing\ctx_licensing.msi CTX_CLUSTER_RESOURCE_DLL_PATH=” C:\ctxlic” REGISTER_CTX_LS_CLUSTERING=”Yes” /l*v “f:\install.log”
N.B. – Ensure the REGISTER_CTX_LS_CLUSTERING option is set to Yes
2. Run through the Licensing setup pointing the destination folder to the shared cluster disk e.g. F:\Program Files\Citrix\Licensing
3. Once the installation has completed successfully fail the Cluster Groups back to the primary node
Testing The Implementation
Once installed, configured, and running on the Primary Node the first tests is to make sure that the Presentation Servers and Access Gateways are able to contact the Licensing Server and are issued a Start up license.
Testing A Presentation Server
To test a Presentation Server perform the following steps :-
- Change the servers License Server to the new IP Address or Network Name of the Licensing Cluster and the ports which it is listening (default 27000)
- Restart the IMA service on the server and once its started logon to the Licensing Server Console
- Check that a Startup License has been issued
Resolving A Looping Resource Group
At the moment, clustering the new 11.5 Licensing Server is not recommended as it can cause a fail over loop where one service fails to start and the group fails over to the other node. This node then fails to start the service and it fails the group back and the loop starts. To break out set the Citrix Resources not to fail the group over if they fail to start. I believe mine was caused by inconsistent / confused XML versions on the two nodes as they had recently been updated by WSUS with XML4 SP1 where as they already had XML 6 installed. The solution was to de-install the WSUS update and XML 6 and then install XML 6 again. Once installed on both servers and rebooted the Licensing Resources came online and were able to fail over between each node without issue.