Product Documentation

Changing System Settings by Using the Command-Line Console

Oct 08, 2015

You manage some system settings by using the App Controller command-line console. You can use the command-line console from the Console tab in either XenCenter or in vSphere. If you enable Secure Shell (SSH) access, you can also open any command prompt, such as PuTTY, and log on to App Controller. The following sections appear in the App Controller command-line console:

Express Setup

With Express Setup, you can configure the basic network settings to enable App Controller to work within your network. These settings include:

  • The App Controller IP address and subnet mask
  • The default gateway
  • The Domain Name Server (DNS)
  • The Network Time Protocol (NTP) server

For more information about using these settings, see Setting the App Controller IP Address for the First Time.

Clustering

You can install multiple instances of the App Controller virtual machine (VM) to create a cluster. One App Controller VM acts as the cluster head. All other App Controller VMs in the cluster are called service nodes. Each service node has a local database that is used by the service node only. Updating user information from the service node to the cluster head requires writing to the database. A service node connects to the database on the cluster head by using a secure channel.

Citrix recommends deploying two App Controller VMs in a high availability pair. Each VM is a cluster head. If one VM fails, the secondary VM can act as the cluster head. Citrix also recommends using the gateway proxy to establish a secure connection between the service node and the cluster head.

When you create the cluster head, you enter a shared key for the cluster. When you join additional VMs to the cluster, you enter the shared key. For more information about clustering, see Creating a Cluster.

High Availability

With high availability, you configure the settings for the primary and secondary App Controller VMs. These settings include:

  • The App Controller role (primary or secondary)
  • The IP address and shared key of the other App Controller VM
  • The option to start and stop the App Controller VM
  • The option to view the status of the App Controller VM
  • The option to enable or disable high availability

For more information about configuring high availability, see xmob-appc-ha-wrapper-con.html#clg-appc-ha-wrapper-con.

System Menu

With the System Menu, you can configure or view basic system settings that include:

  • The system date and time
  • The system disk usage
  • The option to enable or disable SSH access
  • The option to reset the test certificate
  • The option to import or export an App Controller configuration file
  • The option to configure a web proxy server
  • The option to restart and shut down App Controller

Troubleshooting

With Troubleshooting, you can access three tools that help you view network settings, view logs, and create a support bundle that you can send to technical support. In Network Utilities, you can do the following:

  • View network information, including the loopback address.
  • Show the network routing table.
  • Show information from the Address Resolution Protocol (ARP) table.
  • Ping a network IP address or web site.
  • Display the network route and transit delay of packets by using traceroute.
  • Show DNS information by using DNS lookup.
  • Capture a network trace.

You can configure logs by using the Logging menu. In the menu, you can:

  • Set class and group logging levels to include any of the following information:
    • Info
    • Warn
    • Debug
    • Fatal
    • Error
  • Reset the logging level to the App Controller default setting.
  • Create a new log file.
  • Show the log file.

You can also create a support bundle to send to technical support staff for evaluation.

To view the App Controller date and time

You can view the date and time in App Controller.
Note: Citrix recommends using a Network Time Protocol (NTP) server to set the date and time on App Controller.
  1. Log on to the command-line console.
  2. In the Main menu, type 3 and then press ENTER to open the System menu.
  3. In the System menu, type 1 and then press ENTER.

    The day, date, time, time zone, and year appear.

To view the system disk usage

When you install App Controller, 50 GB of disk space is allocated in XenServer for the App Controller VM. You can use the command-line console to view how much disk space App Controller is using.

  1. Log on to the command-line console.
  2. In the Main menu, type 3 and then press ENTER to open the System menu.
  3. In the System menu, type 2 and then press ENTER.

    The system disk usage statistics appear.

Enabling or Disabling SSH Access

You can enable Secure Shell (SSH) access by using the command-line console. When you enable SSH access, you can log on to App Controller from an application that supports SSH, such as PuTTY. You can also enable or disable SSH access from the App Controller management console.

To enable or disable SSH access by using the command-line console

  1. Log on to the command-line console.
  2. In the Main menu, type 3 and then press ENTER to open the System menu.
  3. In the System menu, type 3 and then press ENTER.
  4. Do one of the following:
    1. If SSH access is disabled, type y and then press ENTER to enable SSH access.
    2. If SSH access is enabled, type y and then press ENTER to disable SSH access.

To enable or disable SSH access in the management console

  1. In the App Controller management console, click the Settings tab.
  2. In the left pane, under System Configuration, click Network Connectivity.
  3. In the right pane, next to Network Connectivity, click Edit.
  4. Click Allow support access and then click Save.

To reset the App Controller server certificate

You can use the command-line console to change the default server certificate in App Controller. When you reset the certificate, App Controller removes the passphrase and the new certificate file overwrites the old certificate file. When you reset the default certificate, you must restart App Controller.

  1. Log on to the command-line console.
  2. In the Main menu, type 3 and then press ENTER to open the System menu.
  3. In the System menu, type 4 and then press ENTER.
  4. When Reset Certificate appears, type y and then press ENTER.

    The certificate resets.

  5. Restart App Controller.

To restart or shut down App Controller by using the command-line console

You can restart or shut down App Controller by using the command-line console.

  1. Log on to the command-line console.
  2. In the Main menu, type 3 and then press ENTER to open the System menu.
  3. Do one of the following:
    1. To restart App Controller, in the System menu, type 8 and then press ENTER.
    2. To shut down App Controller, in the System menu, type 9 and then press ENTER.