Product Documentation

App Controller 2.9

May 07, 2015

Citrix App Controller delivers access to web, SaaS, Android, and iOS apps, as well as integrated ShareFile data and documents. Users access their applications through Citrix Receiver, Receiver for Web, or Worx Home.

This topic provides information about installing and configuring App Controller 2.9

With App Controller, you can provide the following benefits for each application type:

  • SaaS applications. Active Directory-based user identity creation and management, with SAML-based single sign-on (SSO).
  • Intranet web applications. HTTP form-based SSO by using password storage.
  • iOS and Android apps. Unified store to which you can install MDX apps for iOS and Android devices, and security management for MDX policies, encompassing WorxMail and WorxWeb. You can wrap iOS and Android apps with the MDX Toolkit to create MDX apps.
  • ShareFile access. Delivery of files by configuring ShareFile settings and the ShareFile application that provides seamless SAML SSO, and Active Directory-based ShareFile service user account management.

Installing App Controller

The App Controller virtual machine (VM) runs on Citrix XenServer, Microsoft Hyper-V, or VMware ESXi. You can use XenCenter or vSphere management consoles to install App Controller 2.9.

Before installing App Controller, you must do the following:
  • Install XenServer or VMware ESXi on a computer with adequate hardware resources.
  • Install XenCenter or vSphere on a separate computer. The computer that hosts XenCenter or vSphere connects to XenServer or VMware ESXi host through the network.
  • Install Windows Server 2008 R2 or Windows Server 2012 with Hyper-V enabled, role enabled, on a computer with adequate system resources. While installing the Hyper-V role, be sure to specify the network interface cards (NICs) on the server that Hyper-V will use to create the virtual networks. You can reserve some NICs for the host.
This section details the following steps for installing App Controller on XenServer, Hyper-V, or VMware:
  • Installing the VM on XenServer and setting the properties for App Controller in XenCenter.
  • Installing App Controller on VMware ESXi and using vSphere to allocate virtual hardware components to App Controller, such as memory and virtual CPUs.
  • Installing App Controller on Hyper-V.
  • Configuring the IP address and subnet mask, default gateway, DNS servers, and Network Time Protocol (NTP) servers for App Controller by using the XenCenter or vSphere command-line console.

When you finish configuring App Controller network settings by using the command-line console, you log on to the App Controller management console. Then, you configure the following network settings:

  • Active Directory configuration from which you obtain groups for App Controller
    Note: After you complete the Configure wizard, you can configure settings for additional Active Directory servers in your network.
  • Administrator settings
  • Workflow email settings

Optionally, you can change the settings you configured by using the command-line console in the wizard. These settings include:

  • App Controller system settings, such as IP address, subnet mask, and the default gateway
  • NTP and DNS server settings and the time zone

After you configure App Controller system settings, to complete the configuration, App Controller retrieves the groups and members of the groups from the specified Base DN in Active Directory. When the retrieval is complete, App Controller logs off. You can log on again to continue configuring App Controller features.

Installing App Controller on XenServer

After you download the virtual image (VM) from the Citrix web site, install App Controller on XenServer. After installation, set the properties for App Controller in XenCenter.

  1. Start XenCenter on your computer.
  2. In the navigation pane, click the name of the XenServer on which you want to install App Controller and then connect.
  3. On the File menu, click Import.
  4. In the Import wizard, in Filename, browse to the location to which you saved the .xva image file and then click Open.
  5. Follow the instructions in the wizard to import the App Controller image.

After you click Finish in the wizard, you can click the Logs tab to view the status of the import process. When the import process is complete, you configure the initial settings for App Controller by using the command-line console. For more information, see Setting the App Controller IP Address for the First Time.

Setting the properties for App Controller

When you import App Controller, the number of virtual CPUs (VCPUs) is set to 2. You cannot change this setting. The default memory setting is 4096. You can leave the memory setting or change it by using the Memory tab in XenCenter.

Note: If the App Controller virtual machine acts as the cluster head, configure 4 VCPUs.

Installing App Controller by Using VMware ESXi

To install App Controller on VMware ESXi, you must first install VMware on a computer with adequate hardware resources. To perform the App Controller installation, you use vSphere. You install vSphere on a remote computer that can connect to the VMware host through the network. After you install App Controller, you can create virtual hardware components on VMware and then use vSphere to allocate them to App Controller.

When you install App Controller on VMware ESXi, you use the vSphere client. You select the OVF template to start the Deploy OVF Wizard. Follow the directions in the wizard to import the App Controller OVA (.ova) file. You provide a name for App Controller and then configure additional settings to import the file to VMWare ESXi.

After the import is complete, you set the App Controller properties in vSphere. These settings include:

  • Allow the virtual machine to start and stop automatically with the system.
  • Set the startup order for App Controller.
  • Set the memory size to 4096.
  • Set the number of VCPUs to 2.

For more information about VMWare ESXi and the vSphere client, see the manufacturer's documentation.

Installing App Controller on Microsoft Hyper-V

To install App Controller on Microsoft Hyper-V, you must first install Microsoft Server 2012 with Hyper-V enabled or Microsoft Hyper-V Server 2012 on a computer with adequate hardware resources. To perform the App Controller installation, you use the Hyper-V Manager, which is a Microsoft Management Console (MMC) snap-in. Hyper-V Manager is installed automatically when you enable the Hyper-V role.

You download a compressed ZIP file to install App Controller on Microsoft Hyper-V. You extract the files and then use Hyper-V Manager to install App Controller.

Note: Make sure that you extract the files in the ZIP folder into a different folder before you specify the path to the folder.

After you import the virtual machine, you need to configure the virtual network adapter by associating the adapter to the virtual networks created by Hyper-V. App Controller 2.8 requires one virtual network adapter.

In Hyper-V Manager, you select the server on which you want to install App Controller and then import the virtual machine. When the import starts, your are prompted to specify the path of the folder that contains the App Controller software files.

After the import is complete, you set the App Controller properties in Hyper-V Manager. These settings include:

  • Allow the virtual machine to start and stop automatically with the system.
  • Set the startup order for App Controller.
  • Set the memory size to 4096.
  • Set the number of VCPUs to 2.

For more information about Microsoft Hyper-V and the Hyper-V Manager, see the manufacturer's documentation.

Setting the App Controller IP Address for the First Time

After importing the App Controller image, you need to configure the IP address. The IP address is the management address at which you can access App Controller through a web browser or by using a Secure Shell (SSH) client, such as PuTTY. You can access the App Controller command-line interface through the XenCenter console to specify an IP address, subnet mask, default gateway, Domain Name Servers (DNS) and a Network Time Protocol (NTP) server. The default IP address for App Controller is 10.20.30.40.

To change the IP address for App Controller in XenCenter

  1. In XenCenter, select the App Controller virtual machine and then click the Console tab.
  2. At the console logon prompt, enter the administrator credentials.

    The default user name for the console is admin and the default password is password.

  3. At a command prompt, type 0 to select Express Setup.
  4. Select the appropriate number to change the IP address, subnet mask, default gateway, DNS servers, and NTP server.
    Note: Citrix recommends using an NTP server to set the date and time on App Controller.
  5. Press 5 to commit the changes.

When you commit the changes, you are prompted to restart App Controller. Review your settings and then type y to commit the changes. After App Controller restarts, you can then access the management console by using the new IP address in a web browser. To open the management console, type https://App ControllerIPaddress:4443/ControlPoint in the address bar of the web browser. For example, type https:// 10.20.30.40:4443/ControlPoint. The user name is administrator and the password is password.

When you connect to App Controller, you must use HTTPS. If you attempt to connect with HTTP, the connection fails.