Installing EXTRA! X-treme or INFOConnect on Citrix XenApp Server as Published Application

  • 7021295
  • 12-Feb-2009
  • 02-Mar-2018

Environment

EXTRA! X-treme version 9.x
INFOConnect version 9.x
Microsoft Windows Server 2008
Microsoft Windows Server 2003
Citrix XenApp
Citrix Presentation Server

Situation

This technical note explains how to install and publish EXTRA! X-treme or INFOConnect to Citrix XenApp (formerly Citrix Presentation Server).

Resolution

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 (formerly known as Citrix Presentation Server). 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. Refer to the EXTRA! X-treme or INFOConnect 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 or the Citrix Receiver.

  1. At the Windows Server console, log in as Administrator.
  2. In the Windows Control Panel, double-click "Add or Remove Programs" or "Programs and Features," 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 elevated command prompt (Run as Administrator). Either way, you must be in install mode before installing EXTRA! X-treme.

  1. Click CD or Floppy.
  2. 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."

  1. Verify that the Open field specifies install.exe for EXTRA! X-treme version 9.x. Click Finish.
  2. In EXTRA! version 9.x, click "Install Attachmate EXTRA! X-treme 9."
  3. Select your install language, and then click OK.
  4. In the Setup Wizard, click Next.
  5. Accept the License Agreement, and then click Next.
  6. Enter a User Name, Organization, and under "Install this application for," select "Anyone who uses this computer (all users)." Click Next.
  7. Specify a Destination Folder, and then click Next.
  8. For User Data Location, select User Defined Directory, and then click Next. On the User Data Destination Folder screen, click Browse. The Attachmate variable called USERID should be entered in the path string as shown below.

For Windows 7, Windows 2008 R2 Server, and Windows Vista enter:

c:\Users\USERID\Documents\Attachmate\

For Windows XP and Windows 2003 Server, enter:

c:\Documents and Settings\USERID\My Documents\Attachmate\

and click OK, and then click Next.

Note the following:

The USERID parameter needs to be all upper case. At EXTRA!’s runtime the USERID parameter will be resolved to the currently logged-in user.

The files located at

c:\Program Files\Attachmate\EXTRA!\macros | schemes | sessions\ENU

or

c:\Program Files (X86)\Attachmate\EXTRA!\macros | schemes | sessions\ENU

will be copied to the user’s personal folders location the first time EXTRA! is run for that particular user.

  1. 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."

  1. If the Centralized Management dialog box displays, do not select "Enable centralized management on the computer." Leave the check box clear and click Next.
  2. 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.

  1. At the Windows Server console, log in as Administrator.
  2. In the Windows Control Panel, double-click "Add or Remove Programs" or "Programs and Features," 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.

  1. Click CD or Floppy, and then click Next.

Note: Do not click Finish in the After Installation dialog box at this time.

  1. Use Browse to locate the product installation files. Navigate to the INFOEE folder and double-click setup.exe.
  2. Click Next, and then click Continue.
  3. Accept the License Agreement, and then click Continue.
  4. 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.
  5. Click Install Now, and then click Close.
  6. 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.

  1. Click Start > Programs > Citrix > Management Console > Access Management Console.
  2. 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.

  1. Right-click the Applications node, and then click New > Publish application.
  2. On the Welcome panel (if displayed), click Next.
  3. On the Name panel, enter a Display name and Application description, and the click Next.
  4. On the Type panel, select Application, and then click Next.
  5. 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.
  6. 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.

Note: For details about starting EXTRA! X-treme from a command line, see "Installing EXTRA! X-treme from the Command Line'" in the EXTRA! X-treme Help Update (http://support.microfocus.com/manuals/extra.html).

  1. In the Working directory field, enter the User Data Location specified in step 11 of the previous section, and then click Next.
  2. On the Servers panel, click Add. Select the servers to host the published application, click Add, click OK, and then click Next.
  3. 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.
  4. 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.

  1. 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.

    1. Select "Configure advanced application settings now."
    2. Click Next until you reach the Content redirect panel.
    3. Select "Show all available file types for this application."
    4. Select the settings file extensions, such as .edp for EXTRA! 3270, AS400, and VT connections and .adp for INFOConnect, and then click Next until you reach the Appearance panel.
  1. 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:

  1. 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.)
  2. Select the type of connection, and then click Next.
  3. Enter a name for the Application Set, and then click Server Location.
  4. Click Add, and then enter the IP address for the Citrix Server you are connecting to. Click OK twice.
  5. Click the drop-down arrow above the Server Location button, and select the Application Set.
  6. Click Next > Next > Finish.

When you refresh the Citrix Program Neighborhood you should now see all of your published applications.

Accessing APIs

If an emulator is running in a virtual environment, APIs (like COM and HLLAPI) cannot be accessed by client applications that are running on the desktop outside of the virtual environment. Client applications like these that depend on components found in the directory where the emulator is installed will not work unless they are also installed on the server where the emulator software is located.

Additional Information

Legacy KB ID

This document was originally published as Attachmate Technical Note 2418.