XenMobile Server

Command-line interface options

For an on-premises installation of XenMobile Server, you can access the CLI options as follows:

  • From the hypervisor on which you installed XenMobile: In your hypervisor, select the imported XenMobile virtual machine, start the command prompt view, and log on to your administrator account for XenMobile. For details, see the documentation for your hypervisor.
  • If SSH is enabled in your firewall, by using SSH: Log on to your administrator account for XenMobile.

You can do various configuration and troubleshooting tasks using the CLI. The following figure shows the top-level menu for the CLI.

Command-line options

Configuration options

The following are samples of the Configuration Menu and the settings displayed for each option.

Command-line options

[1] Network

Command-line options

[2] Firewall

Command-line options

[3] Database

Command-line options

[4] Listener Ports

Command-line options

Clustering options

The following are samples of the Clustering Menu and the settings displayed for each option.

Command-line options

[1] Show Cluster Status

Command-line options

[2] Enable/Disable cluster

When you choose to enable clustering, the following message appears:

To enable real-time communication between cluster members, please open port 80 using the Firewall menu option in CLI menu. Also configure Access white list under Firewall settings for restricted access.

When you choose to disable clustering, the following message appears:

You have chosen to disable clustering. Access to port 80 is not needed. Please disable it.

[3] Cluster member white list

Command-line options

[4] Enable or disable SSL offload

When you select to enable or disable SSL offloading, the following message appears:

Enabling SSL offload opens port 80 for everyone. Please configure Access white list under Firewall settings for restricted access.

[5] Display Hazelcast Cluster

When you select to display the Hazelcast Cluster, the following options appear:

Hazelcast Cluster Members:

[IP addresses listed]

Note:

If a configured node is not part of the cluster, restart that node.

System options

From the System Menu, you can display or set system-level information, restart, or shut down the server, or access Advanced Settings.

Command-line options

Set NTP Server enables you to specify NTP server information. If you have time zone issues when syncing XenMobile time with a hypervisor, you can avoid the issues by pointing XenMobile to an NTP server. Restart all cluster servers after changing this option.

You can also check the disk space by viewing the [5] Display System Disk Usage menu item.

About shutting down server nodes

When you shut down a single server node in a cluster, other nodes can generally handle the workload if they meet the requirements documented in Scalability and performance. The impact can vary depending on how many nodes are down at the same time, the total number of users, and how long the nodes are down.

  • Users can still access the Secure Hub and the store.
  • Users can still access and launch deployed managed apps, if an available node can handle the number of users. Connections might be slower resulting in slower device check-ins.
  • Device policies continue to work unless all nodes are down. Depending on resources and the number of devices, policies might deploy more slowly.

[12] Advanced Settings

Command-line options

SSL protocols options default to all allowed protocols. After the prompt New SSL protocols to enable, type the protocols you want to enable. XenMobile disables any protocols that you don’t include in your response. For example: To disable TLSv1, type TLSv1.2,TLSv1.1 and then type y to restart XenMobile Server.

Server Tuning options include the server connection timeout, maximum connections (by port), and maximum threads (by port).

Switch JDBC driver options are jTDS and Microsoft JDBC. The default driver is jTDS. For information about switching to the Microsoft JDBC driver, see SQL Server drivers.

Troubleshooting options

The following are samples of the Troubleshooting Menu and the settings displayed for each option.

Command-line options

[1] Network Utilities

Command-line options

[2] Logs

Command-line options

[3] Support Bundle

Command-line options

[4] Disk Usage

Command-line options

To upload a support bundle by using Citrix Files as the FTP site

Before you start the upload of a support bundle, configure the following prerequisites on Citrix Files:

  1. Verify the FTP logon details.

    a. In a web browser, open https://citrix.sharefile.com.

    b. Click Personal Settings and then click Advanced connections.

    Citrix Files personal settings

    Citrix Files advanced connections

    c. In FTP Server information, for User name, verify that an alphanumeric user ID appears, along with the default Subdomain/username details.

    Citrix Files FTP configuration

    Notes:

    • The file you are uploading from XenMobile is a Linux CLI-based FTP client. As a result, you cannot enter backslash () and at sign (@) characters as part of your user name.
    • If you don’t see the alphanumeric user ID, you can request this user ID from your ShareFile admin or ShareFile support.
  2. Verify that the Citrix Files server is enabled for FTP communication along with FTPS. Ideally, ShareFile admins allow a user account to be opened for FTP communication. Sometimes, however, only FTPS communication is allowed.

    A user with administrator rights can verify and enable this setting by clicking Settings > Admin Settings > Advanced Preferences > Enable ShareFile Tools. In External Apps > FTP Access, verify that the Enable checkbox is selected.

    The Citrix Files enable checkbox

  3. Create a shared folder for the FTP client to use as a directory for file uploads. Click Home, click Folders, and then click Personal Folders.

  4. On the far right, click the plus sign (+) icon, click Create Folder and then enter a name for the folder.

    Citrix Files shared folder dialog box

  5. In the XenMobile Server CLI, on the Main Menu, select Troubleshooting > Support Bundle. Then, on the Support Bundle Menu, select Generate Support Bundle.

    Command-line options

    Note:

    If a support bundle exists, when prompted, type y to override the bundle.

  6. Upload the support bundle to the FTP server:

    a. Select Upload Support Bundle by using FTP.

    b. Enter remote host: When prompted, type your FTP server name. When Citrix Files is used as an FTP server, type your company name followed by Citrix Files FTP site name. For example citrix.sharefileftp.com.

    c. Enter remote user name: When prompted, type the alphanumeric user ID.

    d. Enter remote user password: When prompted, enter your password.

    e. Enter remote directory: When prompted, enter the shared folder name you created in the Citrix Files and then press Enter.

    FTP upload commands

You can view the uploaded support bundle in the shared folder you created in the Citrix Files.

FTP upload commands

For more information about Citrix Files FTP, see this Citrix Support Knowledge Center article.

To check the disk space

You can check the system disk space in the CLI as follows:

  1. On the main menu, select the System menu.
  2. In the System menu, select the Display System Disk Usage option.

    The file system information appears.

    The disk space results

To do self-service disk cleanup

You can clean up the disk in the CLI as follows:

  1. On the Troubleshooting menu, select Disk Usage. The Disk Usage list has the following options: Disk Usage list

  2. Type 1 to list the core dump file and support bundles file types. If there no files exist, you get the following message: No core dump and support bundles found.

  3. Type 2 to clean the scanned core dump file and support bundle file.

Command-line interface options