Product Documentation

Configuring the Management Service

The Management Service lets you manage client sessions and perform configuration tasks, such as creating and managing user accounts and tweaking backup and pruning policies according to your requirements. You can also restart the Management Service and upgrade the version of the Management Service. You can further create tar files of the Management Service and the XenServer and send it to technical support.

If a task that you need to perform is not described below, see the list of tasks at the left.

Managing Client Sessions

A client session is created when a user logs on to the Management Service. You can view all the client sessions on the appliance in the Sessions pane.

In the Sessions pane, you can view the following details:

  • User Name

    The user account that is being used for the session.

  • IP Address

    The IP address of the client from which the session has been created.

  • Port

    The port being used for the session.

  • Login Time

    The time at which the current session was created on the SDX appliance.

  • Last Activity Time

    The time at which user activity was last detected in the session.

  • Session Expires In

    Time left for session expiry.

To view client sessions, on the Configuration tab, in the navigation pane, expand System, and then click Sessions.

To end a client session, in the Sessions pane, click the session you want to remove, and then click End Session.

You cannot end a session from the client that has initiated that session.

Configuring Policies

To keep the size of logged data within manageable limits, the SDX appliance runs backup and data-pruning policies automatically at a specified time.

The prune policy runs at 00:00 A.M every day and specifies the number of days of data to retain on the appliance. By default, the appliance prunes data older than 3 days, but you can specify the number of days of data that you want to keep. Only event logs, audit logs, and task logs are pruned.

The backup policy runs at 00:30 A.M. every day and creates a backup of logs and configuration files. By default, the policy retains three backups, but you can specify the number of backups you want to keep. And, using the backup policy, you can:

  • Encrypt the backup files.
  • Configure the SDX appliance to transfer the backup files to an external backup server using FTP, SFTP, and SCP.

To specify the number of days for which logged data is pruned:

  1. On the Configuration tab, in the navigation pane, click System.
  2. In the System pane, under Policy Administration, click Prune Policy.
  3. In the Modify Prune Policy dialog box, in Data to keep (days), specify the number of days of data that the appliance must retain at any given time.
  4. Click OK.

To configure the backup policy:

  1. On the Configuration tab, in the navigation pane, click System.
  2. In the System pane, under Policy Administration, click Backup Policy.
  3. In the Modify Backup Policy dialog box, in #Previous Backups to retain, specify the number of backups that the appliance must retain at any given time.
  4. Select Encrypt Backup File to encrypt the backup file.
  5. Select External Transfer and do the following to transfer the backup file to a external backup server:
    1. In the Server field, enter hostname or IP address of the external backup server.
    2. In the User Name and Password fields, enter the username and password to access the external backup server.
    3. In the Port field, enter the port number.
    4. In the Transfer Protocol field, select the protocol you want to use to transfer the backup file to the external backup server.
    5. In the Directory Path field, enter the path of the directory in the external backup server where you want to store the backup files.
  6. Select Delete file from Management Service after transfer if you want to delete the backup file from the SDX appliance after you have transfered the backup file to the external backup server.
  7. Click OK.

Restarting the Management Service

You can restart the Management Service from the System pane. Restarting the Management Service does not affect the working of the instances. The instances continue to function during the Management Service restart process.

To restart the Management Service:

  1. On the Configuration tab, in the navigation pane, click System.
  2. In the System pane, under System Administration, click Reboot Management Service.

Removing Management Service Files

Updated: 2013-10-07

You can remove any unneeded Management Service build and documentation files from the SDX appliance.

To remove a Management Service file:

  1. On the Configuration tab, in the navigation pane, expand Management Service, and then click the file that you want to remove.
  2. In the details pane, select the file name, and then click Delete.

Generating a Tar Archive for Technical Support

You can use the Technical Support option to generate a tar archive of data and statistics for submission to Citrix technical support. This tar can be generated for the Management Service or the XenServer, or for both at the same time. You can then download the file to your local system and send it to Citrix technical support.

In the Technical Support pane, you can view the following details.

  • Name

    The name of the tar archive file. The file name indicates whether the tar is for the Management Service or the XenServer server.

  • Last Modified

    The date when this file was last modified.

  • Size

    The size of the tar file.

To generate the tar archive for technical support:

  1. On the Configuration tab, navigate to Diagnostics > Technical Support.
  2. In the details pane, from the Action list, select Generate Technical Support File.
  3. In the Generate Technical Support File dialog box, from the Mode list, select the appropriate option for whether you want to archive data of XenServer, Management Service, Appliance (including XenServer and Management Service), Instances, or Appliance (including instances).
  4. Click OK.

To download the tar archive for technical support:

  1. In the Technical Support pane, select the technical support file that you want to download.
  2. From the Action list, select Download. The file is saved to your local computer.

Command Line Interface support for Management Service

You can now use the command line interface to perform operations on the Management Service. The following operations are supported:

  • Add, Set, Delete—To configure the resources.
  • Do—To perform system level operations. For example, management service upgrade or shutdown, or reboot.
  • Save—To add interfaces, which are used for Citrix provisioning.

To access the CLI, start the secure shell (SSH) client from any workstation connected to the Management Service IP address. Log on by using the administrator credentials.

You can access detailed information about command usage and syntax from the man pages.

Note: CLI is not supported over console access.