Deploy the XenMobile Enterprise or Advanced Edition blueprint

This page has moved to You can now find all Smart Tools documentation at the Citrix Product Documentation site. Please update any page links to the new URL:

The XenMobile Enterprise or Advanced Edition blueprint configures XenMobile Enterprise or Advanced Edition which consists of a pair of XenMobile appliances, a NetScaler Gateway, and MAM, MDM and Enrollment Load Balancers. 


What does the blueprint do?

The XenMobile Enterprise or Advanced blueprint includes a collection of PowerShell scripts that perform the following tasks: 

  • Deploys primary and secondary XenMobile servers.
  • Configures NetScaler.
  • Configures a NetScaler Gateway and MAM, MDM, and Enrollment load balancers.

These scripts run on a Windows Server 2012 R2 "helper" server. During the deployment you can allow the blueprint to create a new helper server or you may elect to use an existing machine.

Important: If you use an existing machine, it must have the Smart Tools Agent installed so that Smart Tools can detect it in your resource location.

Helper server recommendations

The blueprint includes the following recommended configuration for the helper server that Smart Tools provisions to the deployment:

  • Operating system: Windows Server 2012 R2
  • Storage available in the resource location: 32 GB
  • vCPUs: 4
  • Memory: 2 GB

For more technical information about XenMobile, see

Back to top

Which resource locations are supported?

You can deploy the XenMobile Enterprise or Advanced Edition blueprint on the following resource location types:

  • Citrix XenServer 6.2 and 6.5
  • VMware vSphere 5.1 and 5.5
  • Microsoft Hyper-V

Back to top

Who should use these blueprints?

The blueprint is intended for use by a XenMobile administrator. You should be familiar with the architecture and terminology of a XenMobile deployment. For more information, refer to the XenMobile product documentation at

Back to top

Prepare for deployment

Before you deploy the XenMobile blueprints, use the following tasks to prepare your environment.

Prep Task 1: Prepare the XenMobile appliance file

The XenMobile appliance file is included in the XenMobile product available for download from the Citrix web site. Ensure the appliance file (in XVA or OVA format) is available on a local web server for importing to your resource location. You will specify this file location during blueprint deployment. 

Prep Task 2: Prepare a Windows Server template

Prepare a Windows Server 2012 R2 virtual machine template for your chosen resource location. Smart Tools uses this template to provision the helper server. For instructions for creating this template, see Prepare Windows Server VM templates for deploying blueprints.

Prep Task 3: Credentials for the XenMobile administrator

You will need to specify the following items during deployment:

  • A password to assign to the XenMobile server console administrator account
  • A username and password to create the account for accessing the XenMobile web console

Prep Task 4: Identify the Active Directory domain

XenMobile uses Active Directory for user authentication. Identify the fully qualified domain name you intend to assign to the XenMobile server cluster.

Prep Task 5: Prepare database and NetScaler resources

Identify the address and credentials for the following resources in your environment:

  • An existing Microsoft SQL Server on which the XenMobile database will be created
  • An existing NetScaler appliance that will be used to configure the NetScaler Gateway and Load Balancers required by the system

Prep Task 6: Prepare IP addresses

Identify available IP addresses to assign to the following resources that the blueprint will deploy:

  • NetScaler Gateway
  • MAM Load Balancer
  • MDM and Enrollment Load Balancers (one IP address is shared between the two load balancers)

Prep Task 7: Prepare certificates

During blueprint deployment, you will need to supply a file containing an X.509 certificate and private key (in PEM or PFX format) to assign to the following resources that the blueprint will deploy:

  • NetScaler Gateway
  • MDM and Enrollment Load Balancers (this certificate typically has a name corresponding to the FQDN you assign to the XenMobile servers)

Additionally, identify the URL of the server where these certificates reside so the blueprint can download them during deployment.

Back to top

Deploy the blueprints

Deploying these blueprints follows the same general process that you follow for any blueprint in the Checks and Blueprints catalog. For more information about this process, refer to the following topics in Deploy blueprints:

XenMobile appliance files

The blueprint includes parameters for acquiring the XenMobile appliance file and importing it to your resource location. When you configure the primary and secondary XenMobile machine tiers in Smart Tools, you specify the file location, as well as the VM host and storage repository where the file will be downloaded. 

Save time by downloading configuration settings from the Pre-Deployment Checklist

When you deploy these blueprints, you will need to configure a number of blueprint settings such as server IP addresses and credentials, certificate information, and NetScaler information. To save time and minimize errors during deployment, consider downloading these settings beforehand as a CSV file that you can update and import to the blueprint. The CSV file contains complete descriptions for each setting so you can enter the right information in the correct format. 

The CSV file is available from the blueprint's Pre-deployment Checklist. You can access the checklist by:

  • Viewing the blueprint in the Blueprint Designer. On the Overview tab, click Preview pre-deployment checklist.
  • Deploying the blueprint. The Pre-deployment Checklist displays automatically after you supply the resource location where you want to deploy the blueprint. 

On the Pre-deployment Checklist, scroll down to the bottom and click Export parameter list (.csv).

After you have updated the CSV file with the required values, you can import it at the Configuration step in the blueprint deployment process. 


Back to top