The intent of this blog is to provide information on configuring multi-node clustering in XenMobile Device Manager (XDM) 9.0.
For this activity, I have used the following:
- 2 Instances of Windows 2012 R2 VMs
- XDM executable file with APNS certificate
- Access to Citrix v6 License Server
- Access to MSSQL 2012 DB
Follow the below steps in sequence if you are configuring the XDM from the basics. Before installing the XDM make sure you have access to Citrix license server.
1. Setup XenMobile Device Manager – Node 1
Step 1: Within XenCenter / VMware ESXi start the Windows 2012 server and remotely login to the server
Step 2: Locate the folder where the XDM executable files are located and start the XDM installation
Step 3: Accept the License Agreement
Step 4: Un-check the boxes next to ‘License Server’ and ‘Database Server’ as we will be using external Citrix Licensing server and MSSQL database server.
Note: XDM 9.0 uses license server to read the license from. The license file would be in .LIC format. The reason we are unchecking license server option is, we will be pointing the XDM to an existing license server.
Step 5: Choose the path were the XDM needs to be installed and click on ‘Install’ button.
Step 6: The XDM installation will start
Step 7: When prompted, enter the license server IP address and port number (if the port is changed from default one) and click on Next.
Step 8: Enter the details of the SQL database that you want to use with this XDM, as below:
- Select Database Driver as “SQL Server JTDS”
- Specify the Authentication Type as Windows Auth or SQL Server Auth, based on how you have configured
- Provide the IP address / hostname of MSSQL
- Provide username / password
Step 9: Once the new database is created, you will get a success message. Click OK to continue.
Step 10: Continue the installation by clicking on Next.
Note: If you want to enable FIPS mode, click on the check box.
Step 11: Continue by clicking Next for the subsequent 3 -4 screens.
Step 12: Enter the keystore password two times when prompted and click Next to continue.
Step 12: Enter the keystore password and the FQDN, which will be used to access the XDM server
Step 13: Upload the APNS certificate and click Next to continue
Step 14: When prompted, enter the admin user name with which you want to login to XDM server and a password for that admin. Click on ‘check the user name’ to ensure that there are no duplicate accounts.
Step 15: Click OK to continue. In the subsequent screen, click Finish to continue the configuration.
Step 16: Once the configuration is completed, you will get a dialog box to close. Click on Close button.
Step 17: Now, complete with the installation by clicking on Next.
Step 18: Click on Finish to close the XDM installation wizard.
Step 19: Now check that everything is working fine by accessing the XDM console
2. Enable Clustering on Node 1
To enable the clustering option on Node 1, follow the steps below:
Step 1: Stop the XDM service on Node 1
Step 2: Using a Wordpad, open ew.config.properties file located at
C:\<Installation folder>\Citrix\XenMobile Device Manager\tomcat\webapps\zdm\WEB-INF\classes
Step 3: Search for ‘multi.node’
Step 4: As shown below, change the ‘multi.node’ flag from false to true
Step 5: Save the file.
This completes the configuration on Node 1. Lets now move to Node 2.
3. Setup XDM on Node 2
After installation on Node 1, perform the same XDM installation steps in Node 2.
Note: I am not getting into details of how to install XDM on Node 2 as they are similar to that of Node 1. Wherever there are changes, only those steps have been defined. Rest all steps are same.
Step 1: Start the XDM installation – Without the License server and without database server (uncheck the boxes). Click Next
Step 2: Continue with installation till you get the SQL server configuration page. Point to the same database that you have given while configuring Node 1.
Step 3: Continue with the installation, till you get to the below screen
Step 4: Wait at this step. Go to the system where XDM Node 1 is installed. Navigate to ‘conf’ folder present in the XDM installation path on Node 1. In my case, ‘conf’ is located as given below.
C:\Program Files (x86)\Citrix\XenMobile Device Manager\tomcat\conf
Step 5: Copy the below files:
Step 6: Navigate to same location in Node 2 and paste these files there.
Step 7: Continue with the installation. When prompted, enter the same keystore password that you have given in Node 1
Step 8: When you enter the correct keystore password, the FQDN will auto filled by the system
Step 9: Since you have pointed to the existing DB, you will not be prompted to enter the user name again. Just continue with the installation.
Step 10: Once the installation is complete, validate the setup by logging into the portal.
Step 11: After validation, stop the XDM service on Node 2.
Step 12: Enable clustering on Node 2 as you have done in Node 1. Follow the same steps.
Note: If you come across any issues on Node 2, then overwrite .pem files on Node 2. Copy the below listed .pem files from Node 1 and copy them onto Node 2. (Make sure you back up the existing files on Node 2). Overwrite the below files from ‘Node 1’ <installation_dir>\tomcat\conf to ‘Node 2’ <installation_dir>\tomcat\conf.
Step 13: Now, with multi.node flag set to true on both the nodes, start the XDM service on Node 1. Wait till it comes up and then start the other nodes of the cluster.
Note: To configure the load balancing on NetScaler, refer to section #4 in the below blog:
Step 14: To check if the clustering is completed, you can login to helper console and click on ‘Cluster Info’
This concludes the blog on configuring multi-node clustering on XenMobile Device Manager (XDM) 9.0.