XenMobile Server

Configure clustering

To configure clustering, configure the following two load balancing virtual IP addresses on the Citrix ADC.

  • Mobile device management (MDM) load balancing virtual IP address: An MDM load balancing virtual IP address is required to communicate with the XenMobile nodes that are configured in a cluster. This load balancing is done in SSL Bridge mode.
  • Mobile app management (MAM) load balancing virtual IP address: MAM load balancing virtual IP addresses are required for Citrix Gateway to communicate with XenMobile nodes that are configured in a cluster. In XenMobile, by default, all traffic from Citrix Gateway routes to the load balancing virtual IP address on port 8443.

The procedures in this section explain how to create a XenMobile virtual machine (VM) and joining the new VM to an existing VM. Those steps create a cluster setup.

Prerequisites

  • You have fully configured the required XenMobile node.
  • Configure NTP on all cluster nodes and the XenMobile database. For clustering to work properly, all of those servers must have the same time.
  • One public IP address for MDM load balancer and one private IP address for MAM.
  • Server certificates.
  • One free IP for Citrix Gateway virtual IP address.
  • With XenMobile deployed in a cluster setup and in MDM-only or Enterprise mode (MDM+MAM): Modify your Citrix ADC load balancer configuration to use Source IP persistence for all Citrix ADC MDM load balancers, that is, virtual servers set up for ports 8443 and 443. Complete that configuration before user devices upgrade to iOS 11. For more information, see this Citrix Knowledge Center article: https://support.citrix.com/article/CTX227406.
  • To install apps from the XenMobile Store on iOS 11 devices, you must enable port 80 on the XenMobile Server.

For reference architectural diagrams for XenMobile 10.x in clustered configurations, see Architecture.

Installing the XenMobile Cluster Nodes

Based on the number of nodes you require, you create XenMobile VMs. You point the new VMs to the same database and provide the same PKI certificate passwords.

  1. Open the command-line console of the new VM and enter the new password for the administrator account.

    Cluster node setup

  2. Provide the network configuration details as shown in the following figure.

    Cluster node setup

  3. If you want to use the default password for data protection, type y; or, type n and enter a new password.

    Cluster node setup

  4. If you want to use FIPS, type y; or, type n.

    Cluster node setup

  5. Configure the database so that you point to the same database that the earlier fully configured VM pointed to. You see the message: Database already exists.

    Cluster node setup

  6. Enter the same passwords for the certificates that you provided for the first VM.

    Cluster node setup

    After you have entered the password, the initial configuration on the second node will complete.

    Cluster node setup

  7. When the configuration is complete, the server restarts and the logon dialog box appears.

    Cluster node setup

    Note:

    The logon dialog box is similar to the logon dialog box of the first VM. The match is a way for you to confirm that both VMs are using the same database server.

  8. Use the fully qualified domain name (FQDN) of XenMobile to open the XenMobile console in a web browser.

  9. In the XenMobile console, click the wrench icon in the upper-right corner of the console.

    Cluster Information configuration screen

    The Support page opens.

  10. Under Advanced, click Cluster Information.

    Cluster Information configuration screen

    All the information about the cluster including cluster member, device connection information, tasks, and so on appears. The new node is now a member of the cluster.

    Cluster Information configuration screen

    You can add other nodes by following the same steps. The first node added to the cluster has a Role of OLDEST. Nodes added after that show a Role of NONE or null.

To configure load balancing for the XenMobile cluster in Citrix ADC

After you add the required nodes as members of the XenMobile cluster, load balance the nodes so you can access the clusters. Load balancing is done by running XenMobile Wizard available in Citrix ADC. The following steps describe how to load balance XenMobile by running the wizard.

  1. Log on to Citrix ADC.

  2. On the Configuration tab, click XenMobile and then click Get Started.

    Cluster node setup

  3. Select the Access through Citrix Gateway checkbox and the Load Balance XenMobile Servers checkbox and then click Continue.

    Cluster node setup

  4. Enter the IP address for Citrix Gateway and then click Continue.

    Cluster node setup

  5. Bind the server certificate to the Citrix Gateway virtual IP address by doing one of the following and then click Continue.

    • In Use existing certificate, choose the server certificate from the list.
    • Click the Install Certificate tab to upload a new server certificate.

    Cluster node setup

  6. Enter the Authentication server details and then click Continue.

    Cluster node setup

    Note:

    Ensure that the Server Logon Name Attribute is the same as you provided in the XenMobile LDAP configuration.

  7. Under XenMobile settings, enter the Load Balancing FQDN for MAM and then click Continue.

    Cluster node setup

    Note:

    Ensure that the FQDN of the MAM load balancing virtual IP address and the FQDN of XenMobile are the same.

  8. If you want to use SSL Bridge mode (HTTPS), select HTTPS communication to XenMobile Server. However, if you want to use SSL offload, select HTTP communication to XenMobile Server, as shown in the preceding figure. For the purposes of this article, the choice is SSL Bridge mode (HTTPS).

  9. Bind the server certificate for the MAM load balancing virtual IP address and then click Continue. Cluster node setup

  10. Under XenMobile Servers, click Add Server to add the XenMobile nodes.

    Cluster node setup

  11. Enter the IP address of the XenMobile node and then click Add.

    Cluster node setup

  12. Repeat steps 10 and 11 to add more XenMobile nodes that are part of the XenMobile cluster. You see all the XenMobile nodes that you have added. Click Continue.

    Cluster node setup

  13. Click Load Balance Device Manager Servers to continue with the MDM load balancing configuration.

    Cluster node setup

  14. Enter the IP address to be used for MDM load balancing IP address and then click Continue.

    Cluster node setup

  15. Once you see the XenMobile nodes in the list, click Continue and then click Done to finish the process.

    Cluster node setup

    You see the virtual IP address status on the XenMobile page.

    Cluster node setup

  16. To confirm if the virtual IP addresses are up and running, click the Configuration tab and then navigate to Traffic Management > Load Balancing > Virtual Servers.

    Cluster node setup

    You also see that the DNS entry in the Citrix ADC points to the MAM load balancing virtual IP address.

    Cluster node setup

Configure clustering