Installing EXTRA! X-treme or INFOConnect 9.x on Windows 2003/Citrix XenApp Server 4.5
Technical Note 2418
Last Reviewed 12-Feb-2009
Applies To
EXTRA! X-treme version 9.x
INFOConnect version 9.x
Microsoft Windows Server 2003
Citrix XenApp (formerly Presentation Server) version 4.5
Citrix Presentation Server version 4.5
Summary
This technical note explains how to install and publish EXTRA! X-treme or INFOConnect version 9.x to Windows Server 2003 with Citrix XenApp 4.5 (formerly Citrix Presentation Server 4.5).
For information about installing EXTRA! X-treme or INFOConnect version 8.x, see Technical Note 2355.
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:
- User data and application data folders can be customized during installation using command line switches or transforms. See Technical notes 2153 and 2369, or refer to the INFOConnect or EXTRA! X-treme online help.
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 Server 2003 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 OK.
- 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 Server 2003 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: Do not click Finish in the After Installation dialog box at this time.
- Use Browse to locate the product installation files. Navigate to the INFOEE folder and double-click setup.exe.
- Click Next, and then click Continue.
- Accept the License Agreement, and then click Continue.
- In the Personalize your install dialog box, make any changes to the User Information, File Location, Feature Selection, and Advanced settings, or leave them at default.
- Click Install Now, and then click Close.
- Back in After Installation dialog box, click Next, and then click Finish.
When the installation is complete, log off, log back on to the server 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, click Add, click OK, and then click Next.
- On the Users panel, click Add, and double-click 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. (If you do not see Type and State on the screen, right-click the product name, and then click Change display > Information.)
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) |
| 2153 |
Running EXTRA! X-treme from the Command Line |
| 2355 |
Installing EXTRA! X-treme or INFOConnect 8.x on Windows 2003/Citrix XenApp Server 4.5 |
| 2369 |
Creating and Deploying Transforms and Companion Packages Using the Attachmate Customization Tool |