Product Documentation

Installing the Command Center Server on Linux

May 27, 2015

To install the Command Center server on Linux, download the installation package from the Citrix portal: http://mycitrix.com. The installation package is a binary file with the following naming convention:

CC_Setup_ReleaseNumber_BuildNumber.bin

Example:

There are two types of server installation: Evaluation and Typical. The installation type is specified at the start of the installation process.

Evaluation installation type enables you to quickly install the Command Center server by installing the pre-packaged PostgreSQL database and by using predefined defaults, such as the HTTPS security mode. Although this installation type provides all functionality of Command Center, it is not supported in production environment. Citrix recommends you use the Evaluation installation type only for evaluation purposes.

Typical installation type provides more flexibility and enables you to connect to an external database and specify the security mode you want to use. This installation type provides all Command Center functionality and Citrix recommends you use this in production environment.

Note: You can also configure Command Center in a distributed multi-tier architecture by installing Command Center agents that manage and monitor the Citrix devices. For more information, see Installing Command Center Agents on Linux

You can install the Command Center server on Linux using either the installation wizard or the CLI.

To install the Command Center server by using the installation wizard

  1. Run the setup file and follow the instructions on the screen. To run the setup file, at the Linux terminal window, type the following and press Enter.
    • For a 32-bit kernel, type ./CC_Setup_ReleaseNumber_BuildNumber.bin
    • For a 64-bit kernel, type ./CC_Setup64_ReleaseNumber_BuildNumber.bin
    Note: The commands listed above are applicable only when you install Command Center on Linux.

    Example:

    • 32-bit kernel: ./CC_SP_5.2_42_7.bin
    • 64-bit kernel: ./CC_SP64_5.2_42_7.bin
  2. On the installation type screen, select either Evaluation or Typical.
  3. If you have selected Evaluation, click Next, and then click Install. This installs the packaged Postgre SQL database, and installs Command Center in the HTTPS security mode.

    If you have selected Typical, perform the following steps:

    1. On the database settings screen, under Database Settings, enter the values for the database parameters, and then click Test Connection. After the connection to the database is successful, click Next
      Note: For information on the database parameters and their values, see the table in the section Database Settings.
    2. Under Security Settings, select either HTTP or HTTPS.
    3. Click Next, and then click Install.
    Note: After Command Center is successfully installed, the summary screen appears with a brief note about getting started with Command Center.
  4. On the summary screen, click Done..
    Note: The Command Center service is installed and started automatically and Command Center can be accessed from the web browser.

To install the Command Center Server from the command line

  1. At a command prompt, log on as root and type the following:

    ./CC_Setup_ReleaseNumber_Build Number.bin -i console

    Example:

    Note: Specifying the -i console option runs the setup file from the command line.
    The Installation Wizard starts and displays a set of numerical options.
  2. To continue with the installation, follow the instructions on the screen.
  3. To accept the license agreement, type 1 and press Enter, and then type 0 and press Enter to confirm.
  4. When prompted, specify the complete path where you want to install the server, and then press Enter.
  5. Enter one of the installation type options - Type1 for Evaluation or 2 for Typical.
    Note: For information about installing Command Center agents, see Installing Command Center Agents on Linux.
  6. If you have typed 1 for Evaluation, to confirm and move to the next step, type 0 and press Enter, and then type 1 and press Enter. The packaged database and security mode details appear on the screen. Type 1 and press Enter to proceed with the installation.

    If you have typed 2 for Typical, perform the following steps:

    1. Enter one of the following database options - 1 for MYSQL, 2 for Oracle, or 3 for MS SQL.
    2. Enter the values for the following database parameters: hostname, port number, database name, username, and password.
      Note: For information on the database parameters and their values, see the table in section "Database Settings."
    3. Enter the communication mode you want to use. Type 1 for HTTP or 2 for HTTPS.
    4. View the Pre-Installation Summary and press Enter to proceed.

    After Command Center is successfully installed, the summary screen appears with a brief note about getting started with Command Center.

    Note: The Command Center service is installed and started automatically and Command Center can be accessed from the web browser.

Installing Command Center Agents on Linux

Consider a scenario where you use 300 NetScaler VPX devices in the development and testing stages in your production environment. To manage and monitor such large number of devices, you can now set up Command Center in a distributed multi-tier architecture by configuring Command Center agents to manage and monitor the Citrix devices.

This architecture reduces the load on the Command Center server by distributing the load across the different agents. In a distributed multi-tier setup, the Command Center server performs operations, such as discovery, trap processing, and configuration using tasks. The agents are used for polling and collecting data used for performance monitoring, such as CPU usage, resource utilization, and IP bytes transmitted, and for certificate management. The Command Center server and the agents are connected to the same database.

After the agents are installed and connected to the Command Center server, you can view the agent details on the Administration tab from the Command Center client. You can activate the agents from the client, and then assign devices to the agent to manage. For more information, see Setting Up Command Center Agents.

You can also monitor the state of the agents from your Command Center client. For example, when an agent connects to the Command Center server, an event with severity as clear is raised. And, when an agent connected to the server is down, an event with severity as critical is raised. This allows the user to take appropriate action.

To install the Command Center agents, use the Command Center installation package available at the Citrix portal: http://mycitrix.com. The installation package is an binary file with the following naming convention:

CC_Setup_ReleaseNumber_BuildNumber.bin

Example:

Note: You cannot install the Command Center server and the agent on the same system. Also, you cannot install more than one agent on a system.

To install Command Center agents on Linux

  1. Install and start the Command Center server on a system. 
  2. On the system where you want to install the agent, run the setup file either in graphical mode or CLI mode, and then follow the instructions on the screen.
  3. On the installation type screen, select Agent Setup. If you are using the CLI mode, under Choose Installation Type, type 3 for Agent Setup, and then press Enter.
  4. In Server IP address, type the IP address of your Command Center server, and then test the connection. If you are using the CLI mode, enter the server IP address, type 1, and then press Enter to test the connection.
  5. After the connection is successfully tested, follow the instructions on the screen to install the agent.

     

    Note: The Command Center Agent as a service is installed automatically, but you have to start the service manually.

Uninstalling the Command Center Server from Linux

This section describes the procedure to uninstall the Command Center server and service packs, if any. It also describes the procedure to uninstall Command Center configured to run as a service.

To uninstall the Command Center server

  1. Stop the Command Center server.
  2. At a command prompt, navigate to the bin subdirectory of the CC_Home directory.
  3. Run the reinitialize_nms.sh shell script. This deletes the database tables created by the Command Center server.
  4. Navigate to the CC_Home/_Citrix Command Center_installation directory and run Uninstall.bin file. Follow the steps in the wizard to uninstall.
    Note: Uninstalling Command Center removes only the user-created files and folders; you must manually delete the database.