Product Documentation

Managing Citrix Receiver Updates

May 07, 2015

You can configure App Controller to update Citrix Receiver on Windows-based devices and Mac OS X computers. You can configure Receiver updates by using the following methods:

  • Do not check for updates. Update services are not provided.
  • Citrix. Updates Receiver from the Citrix update service on Citrix.com. You can also select other plug-ins to update from Citrix. These include:
    • NetScaler Gateway Plug-in
    • ShareFile for Outlook
    • ShareFile Sync
  • Citrix Merchandising Server. Updates all plug-ins installed on the user device from the Merchandising Server that you specify.

If you configure StoreFront in Trust Settings, you cannot configure Receiver updates.

To configure Receiver updates

  1. In the management console, click the Settings tab.
  2. Under System Configuration, click Receiver Updates.
  3. In the details pane, next to Manage Receiver Updates, click Edit.
  4. In Get updates from, do one of the following:
    1. To prevent Receiver updates, click Do not check for updates.

      This is the default setting.

    2. Click Citrix (citrix.com). Under Citrix Update Options, in Include plug-ins, select the plug-ins for updates.
    3. Click Citrix Merchandising Server. Under Merchandising Server Option, in Server, enter the fully qualified domain name (FQDN) of the Merchandising Server.
  5. Click Save.

To change the administrator password

When you log on to the App Controller management console for the first time, you enter the user name administrator and the password, which is password. You can change the administrator password in the Configure dialog box when you first log on by using a web browser.

You can also change the administrator password at a later time from the System Configuration panel.

Note: When you change the administrator password in the management console, the password also changes in the command-line console.
  1. Log on to the management console and then click the Settings tab.
  2. Under System Configuration, click Administrator.
  3. In the details pane, next to Administrator, click Edit.
  4. In Old password, type the current password.
  5. In New password and Confirm password, type the new password.
  6. Click Save.

Changing System Settings by Using the Command-Line Console

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.

Note: Configure 4 VCPUs on the App Controller virtual machine that runs as the cluster head. You can set the VCPUs by using properties in XenCenter, vSphere, or Hyper-V.

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 Configuring High Availability.

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.