Installing EXTRA! X-treme or INFOConnect on Windows 2003/Citrix XenApp Server 4.5
Technical Note 2355
Last Reviewed 10-Jul-2008
Applies To
EXTRA! X-treme version 8.0 or higher
INFOConnect version 8.0 or higher
Microsoft Windows 2003 Server with Terminal Services
Citrix Presentation Server version 4.5
Citrix XenApp version 4.5
Summary
This technical note explains how to install and publish EXTRA! X-treme or INFOConnect to a Windows 2003 Terminal Server with Citrix XenApp 4.5 (formerly Citrix Presentation Server 4.5).
Running EXTRA! X-treme or INFOConnect with Citrix XenApp
The following sections describe how to install and publish EXTRA! X-treme or INFOConnect in a Citrix XenApp environment.
Note the following:
- This note assumes that Citrix is installed and configured in your network environment. For information about implementing a Citrix server and installing and publishing applications in a Citrix XenApp environment, please refer to the Citrix documentation at http://www.citrix.com.
- This technical note refers to Citrix XenApp 4.5 (formerly known as Citrix Presentation Server 4.5). The same concepts and settings apply to other versions of Citrix XenApp and Citrix Presentation Server, but the steps may be slightly different. Please refer to your Citrix documentation for further details.
- For more information about installing applications in a Terminal Server environment, see the Microsoft TechNet Article 186498 at http://support.microsoft.com/kb/186498.
- For information about the performance and scalability of Citrix XenApp and Microsoft Terminal Server, see one of the following resources:
Installing Extra! X-treme Executables
Install EXTRA! X-treme to the Citrix server.
Note: Before installing the product, we recommend that you close all applications, including the Independent Computing Architecture (ICA) Toolbar.
- At the Windows 2003 Server console, log in as Administrator.
- In the Windows Control Panel, double-click "Add or Remove Programs," and then click the Add New Programs icon.
Note: Installing the product through Add or Remove Programs automatically puts the server in install mode. Alternatively, you could type change user /install at the command prompt. Either way, you must be in install mode before installing EXTRA! X-treme.
- Click CD or Floppy.
- Insert the product CD or point to the product installation files, and then click Next.
Note: If you are installing the product from a network location, use a UNC path to access the installation files, not a mapped drive letter.
UNC path syntax: \\<servername>\<path>
Installing from a mapped drive may generate a Microsoft Windows installation error similar to the following: "Error 2755. The installer has encountered an unexpected error installing this package. This may indicate a problem with this package."
- Verify that the Open field specifies install.exe for EXTRA! X-treme version 9.x or setup.exe for EXTRA! X-treme 8.x. Click Finish.
- In EXTRA! version 9.x, click "Install Attachmate EXTRA! X-treme 9." (Skip this step if you are installing EXTRA! X-treme 8.x.)
- Select your install language, and then click Next.
- Enter the product Access Code, and then click Next.
- In the Setup Wizard, click Next.
- Accept the License Agreement, and then click Next.
- Enter a User Name, Organization, and under "Install this application for," select "Anyone who uses this computer (all users)." Click Next.
- Specify a Destination Folder, and then click Next.
- For User Data Location, select My Documents Directory, and then click Next.
- Select Typical, and then click Next.
Note: If you choose to do a Custom install, and you are using HLLAPI, you will be prompted to select a HLLAPI Session Shortname Option. Select "Shared among all users."
- If the Centralized Management dialog box displays, do not select "Enable centralized management on the computer." Leave the check box clear and click Next.
- Click Install.
When the installation is complete, log off, log back on as a user and verify that you can access and run the application.
Installing INFOConnect Executables
Install INFOConnect to the Citrix server.
Note: Before installing the product, we recommend that you close all applications, including the Independent Computing Architecture (ICA) Toolbar.
- At the Windows 2003 Server console, log in as Administrator.
- In the Windows Control Panel, double-click "Add or Remove Programs," and then click the Add New Programs icon.
Note: Installing the product through Add or Remove Programs automatically puts the server in install mode. Alternatively, you could type change user /install at the command prompt. Either way, you must be in install mode before installing INFOConnect.
- Click CD or Floppy, and then click Next.
Note: If you are installing the product from a network location, use a UNC path to access the installation files, not a mapped drive letter.
UNC path syntax: \\<servername>\<path>
Installing from a mapped drive may generate a Microsoft Windows installation error similar to the following: "Error 2755. The installer has encountered an unexpected error installing this package. This may indicate a problem with this package."
- Use Browse to locate the product installation files. Navigate to the INFOEE folder and double-click setup.exe.
- Click Finish.
- Click the INFOConnect product you wish to install, and then click Next.
- If prompted, enter the product Access Code, and then click Next.
Note: The access code is provided in the product release notification e-mail.
- Under Transport\Options, specify the appropriate transport types for your network environment, and then click Next.
- Accept the License Agreement, and then click Next.
- Under "Install this application for," select "Anyone who uses this computer (all users)," and then click Next.
- Specify a Destination Folder, and then click Next.
- For User Data Location, select My Documents Directory, and then click Next.
- For Application Data Location, select "All Users\My Documents Directory," and then click Next.
- Do not select the "Enable centralized management on this computer" check box. Leave it cleared. Click Next.
- Click Install.
When the installation is complete, log off, log back on as a user and verify that you can access and run the application.
Publishing EXTRA! X-treme or INFOConnect
This section explains how to publish the EXTRA! X-treme or INFOConnect to the Citrix XenApp environment. Follow the steps below to publish the Attachmate product.
Note: These steps apply to applications accessed from a server, not streamed.
- Click Start > Programs > Citrix> Management Console > Access Management Console.
- Expand the appropriate server farm node.
Note: If there is more than one server in your server farm, install EXTRA! X-treme or INFOConnect to the servers where you have Load Balancing enabled.
- Right-click the Applications node, and then click New Publish application.
- On the Welcome panel (if displayed), click Next.
- On the Name panel, enter a Display name and Application description, and the click Next.
- On the Type panel, select Application, and then click Next.
- On the Location panel, under the Command line field, click Browse and navigate to the product installation directory (by default, <Metadrive>:\Program Files\Attachmate\<product name>), select the product executable, and then click OK.
- Optional. Specify a settings file to be used when the product is launched. To do so, add the path and settings file name to the end of the Command line.
- In the Working directory field, enter the User Data Location specified in step 11 of the previous section, and then click Next.
- On the Servers panel, click Add, select the servers to host the published application, and then click Next.
- On the Users panel, click Add, and select the Trusted Domain where your user and group accounts are located. Choose the accounts or groups who should have access to the application (typically Domain Users), click Add, click OK, and then click Next.
- On the Shortcut presentation panel, select the applicable neighborhood settings for your environment, and then click Next.
Note: If you do not select one of the check boxes under Application shortcut placement, users will see the EXTRA! or INFOConnect icons only after they log in to the Program Neighborhood. This can be useful in a high-security environment where workstations do not display a Start Menu or Client desktop.
- Optional. To enable users to start EXTRA! or INFOConnect from a saved settings file, click Next until you reach the Content redirection panel, and then follow the steps below. If you do not want users starting the product from a settings file, continue to step 14.
Note: There are several Citrix configuration requirements that must be made for Content redirection support, such as having Program Neighborhood Agent (PNA) running and client drive mapping enabled. Refer to your Citrix documentation for further details.
- Select "Configure advanced application settings now."
- Click Next until you reach the Content redirect panel.
- Select "Show all available file types for this application."
- Select the settings file extensions, such as .edp for EXTRA! AS400 and VT connections and .adp for INFOConnect, and then click Next until you reach the Appearance panel.
- Click Finish.
EXTRA! X-treme or INFOConnect should now appear in the console with Type set to Explicit, and State set to Enabled.
Published Applications Not Appearing In Citrix Program Neighborhood
If you are unable to see your published applications on the device where the ICA connection resides, follow these steps:
- Open the Citrix Program Neighborhood and click Find New Application Set. (You may need to click Up before the Find New Application Set icon is accessible.)
- Select the type of connection, and then click Next.
- Enter a name for the Application Set, and then click Server Location.
- Click Add, and then enter the IP address for the Citrix Server you are connecting to. Click OK twice.
- Click the drop-down arrow above the Server Location button, and select the Application Set.
- Click Next > Next > Finish.
When you refresh the Citrix Program Neighborhood you should now see all of your published applications.
Related Technical Notes
| 0200 |
Using the Attachmate Download Library (FAQ) |
| 1097 |
Index of Windows Terminal Server and Citrix XenApp Topics (Includes Citrix Presentation Server and MetaFrame) |
| 1626 |
Reflection Products and Windows Terminal Server/Citrix |