Product Documentation

Multi-Tenant Console

Feb 24, 2013

The Citrix Multi-Tenant Console for XenMobile MDM is a web-based console that enables consolidated management of multiple XenMobile Device Manager servers. You can use Multi-Tenant Console to manage service providers and enterprises with multiple distributed entities and to administer several physical XenMobile servers from a single site. Each server can run multiple instances (also called tenants) of XenMobile MDM Device Manager. The servers are logically independent from each other. In such cases, Multi-Tenant Console provides a single integrated management environment across the Device Manager servers.

Multi-Tenant Console System Requirements

To install XenMobile Multi-Tenant Console, you need an installation package that includes following files:

  • XenMobile Mobility Manager for Multi-Tenant-xxxxx.exe. The installer used to install PostgreSQL and Tomcat for the servers running XenMobile Device Manager. It can also be used to install the repository database for Multi-Tenant Console.
  • Java Development Kit (JDK)
  • Grails framework that is included in the Multi-Tenant Console package distribution. The file name is grails-1.3.7.zip.
  • Google Web Tools that is included in the Multi-Tenant Console package distribution. The file name is gwt-windows-1.5.3.zip.
  • XenMobile_MTC-8.0.1.xxxxx.zip that are the files for Multi-Tenant Console.
  • PsTools from Microsoft that are command line utilities.

You also need the Device Manager distribution to get the zdm.war archive, and the appropriate license file.

Multi-Tenant Console requires the following minimum system configuration:

Component Requirement

Computer and processor

Intel Xeon/Pentium 4-3 Ghz or AMD Opteron-1.8 Ghz server class

Memory

512 megabytes (MB) of RAM or more recommended

Hard disk

500 MB of available hard disk space

Operating system

Microsoft Windows 2008 Server 64-bit, Standard Edition or Enterprise Edition

Microsoft Windows 2008 Server R2 SP1 64-bit, Standard Edition or Enterprise Edition

Note: NTFS partitioning is required for Windows operating systems.

Browser

Internet Explorer 7 or later, Mozilla Firefox 3.0 or later

Additional software

Sun JDK 6 most recent update or 7

Installing the Prerequisites for Multi-Tenant Console

Before you install Multi-Tenant Console, you need to install the following programs and configure the associated environment variables:

  • Java JDK
  • Grails
  • Google Web Toolkit
Note: Citrix recommends that you back up the Multi-Tenant Console database if you need revert to an earlier version or if you need to restore the Multi-Tenant Console.

After you complete the following procedures, make user you set the environment variables correctly. You can set environment variables from the command-line console, by running the command C:\Windows\System32\set.

In addition, you need to do the following:

To install the Java JDK

  1. Install the Java JDK by browsing to the directory where you downloaded the Java JDK, double-click the jdk-6u25-windows-x64 executable and then follow the instructions.
  2. Browse to the directory containing the java cryptography files and copy local_policy.jar and US_export_policy.jar to the following folders (overwrite existing files):
    • C:\Program Files\Java\jdk1.6.0_xx\jre\lib\security
    • C:\Program Files\Java\jre6\lib\security
  3. Ensure that the JAVA_HOME and PATH Variables are set. To do so, do the following:
    1. From the Start menu, right-click Computer and then click Properties.
    2. Click the Advanced Systems Settings tab and then click Environment Variables.

To install Grails

  1. In the Multi-Tenant Console distribution package, locate the Grails zip file, grails-1.3.7.zip.
  2. Extract the files to: C:\Zenprise\.
  3. Set the Grails environment variable by doing the following:
    1. From the Start menu, right-click Computer and then click Properties.
    2. Click the Advanced Systems Settings tab and then click Environment Variables.
    3. Create a new System Variable where the Variable Value equals the path where you installed Grails.
    4. In Variable value, add %GRAILS_HOME%\bin to the path.

To install the Google Web Toolkit

  1. In the Multi-Tenant Console distribution package, locate the Google Web Toolkit zip file, gwt-windows-1.5.3.zip.
  2. Extract the files to: c:\Zenprise\.
  3. Set the Google Web Toolkit environment variable by doing the following:
    1. On the Start menu, right-click Computer and then click Properties.
    2. Click the Advanced Systems Settings tab and then click Environment Variables.
    3. Create a new System Variable where the Variable Value equals the path where you installed the Google Web Toolkit.
    4. In Variable value, add %GWT_HOME% to the path.