Installing Reflection Products to a Windows 2003/Citrix MetaFrame Presentation Server 4.x

  • 7021754
  • 16-Mar-2006
  • 01-Apr-2018


Reflection for UNIX and OpenVMS version 14.x
Reflection for HP version 14.x
Reflection for ReGIS Graphics version 14.x
Reflection for IBM version 14.x
Reflection X version 14.x
Reflection for Secure IT Windows Client version 7.0 or higher
Microsoft Windows Server 2003
Citrix MetaFrame Presentation Server version 4


This technical note explains how to install and publish Reflection products to a Windows 2003 Terminal Server with Citrix MetaFrame Presentation Server 4.x.

Note: 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 Presentation Server environment, please refer to the Citrix documentation at


Before proceeding, note the following:

  • To evaluate Reflection on your Citrix server, obtain an evaluation CD of Reflection, rather than downloading the evaluation software, and install from the CD. The original media may be required during removal of the product. You can obtain a free copy of the evaluation CD from
  • If you are installing Reflection to one of the multi-user operating systems listed below, see the associated technical note.
KB 7021751 - Windows 2000 Terminal Server
KB 7021638 - Windows 2000 Citrix Server

Running Reflection with Citrix Presentation Server

The following sections describe how to install and publish Reflection applications in a Citrix Presentation Server environment.

Installing Reflection Executables

Install Reflection to the Citrix server. Before proceeding with the installation, note the following:

  • We recommend that you close all applications, including the Independent Computing Architecture (ICA) Toolbar, before installing Reflection.

To install the Reflection executable files, follow the steps below.

  1. At your Windows 2003 Server console, log in as an Administrator. From the Windows Control Panel, double-click Add/Remove Programs, and then click Add New Programs.
  2. When prompted to Install Program from Floppy Disk or CD-ROM, insert the Reflection CD and click Next.

Note: If you are installing Reflection 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. When prompted to Run Installation Program, follow these steps.

If you are installing from the Reflection Evaluator CD:

    1. Browse to and double-click Evaluate.exe.
    2. When the Welcome window opens, click Continue.
    3. To evaluate Reflection X, click PC X-Server Software. To evaluate Reflection for HP, Reflection for UNIX and OpenVMS, Reflection for IBM, or Reflection for ReGIS Graphics, click Windows Based Terminal Emulation. To evaluate Reflection for Secure IT Windows Client, click Secure Shell Technology.
    4. Click Evaluate Reflection Now.
    5. Select the product to install, and then click Install. Proceed to step 4 below.

If you are installing from the Reflection product CD:

    1. Browse to and double-click Install.exe.
    2. When the Welcome window opens, click Install Reflection.
    3. Click Install Reflection, select the product to install, and then click Workstation Install.
  1. When the Reflection Wizard opens, carefully read all messages, warnings, and instructions presented, and then click Next.
  2. Proceed through the installation, using the following details when applicable. If you have questions about this process, please contact Technical Support. For information on contacting support, see

VPA Number: During installation, you may enter your Attachmate volume purchase agreement (VPA) number in the Customer Information page. If entered, then the VPA is available from within the product by clicking Help > About Reflection > System Information. Easy access to this number will be helpful if you need to contact Attachmate.

Destination Folder: Accept the default install location, <Windows server drive>:\Program Files\Reflection.

Installation Type: Select Custom Installation Type. This enables you to add and remove product component from the feature tree.

We recommend that you do not install the following Reflection components and products on a Citrix server:

    • Reflection NFS Client version 10.x or earlier. Version 11.0 is the first version of Reflection NFS Client to support the multi-user environment; earlier versions can not be installed on a Citrix server.
    • The SNA engine. The SNA engine was originally designed to run on individual PC workstations. Modifications have been made to enable the SNA engine to function in a Terminal Server environment, but it can handle only a limited number of simultaneous connections (10 or less). For this reason, it is strongly recommended that you use Telnet in an IBM environment.
    • Reflection Virtual Desktop. This feature causes extra network overhead.

User Folder: It is recommended that you accept the default value user folder. This folder is used to store user-generated files, such as settings files and scripts. If it is necessary to change the user folder (not recommended), the folder can be changed from the Reflection Customization Manager.

Default: <metadrive>:\Documents and Settings\<Administrative account>\My Documents\Reflection.

Publishing Reflection Applications

Follow the steps below to publish the Reflection executable files to the Citrix MetaFrame Presentation Server environment.

Note: These steps refer to Citrix MetaFrame Presentation Server 4.0. The same concepts and settings apply to Citrix MetaFrame Presentation Server 3.x, but the steps may be slightly different. Please refer to your Citrix MetaFrame documentation for further details.

  1. Click Start > Programs > Citrix> MetaFrame Presentation Server > Presentation Server Console.
  2. Log in to the console, and then click Actions > New > Published Application.
  3. In the Application Publishing Wizard dialog box, enter a Display Name and Application Description, and the click Next.
  4. In the Specify What to Publish dialog box:
    1. Click Browse (below the Command Line entry field), navigate to the Reflection installation directory (<Metadrive>:\Program Files\Reflection, by default), select the Reflection EXE file, and click OK.

Reflection executables:

      Reflection for HP
      Reflection for UNIX and OpenVMS
      Reflection for ReGIS Graphics
      Reflection for IBM
      Reflection FTP Client
      Reflection X
      Reflection for Secure IT Windows Client
      Reflection SFTP Client
    1. Optional. Specify a settings file to be used when Reflection is launched. To do so, add the path and settings file name to the end of the Command Line.

Note: For details about starting Reflection from a command line, see 'startup switches' in the Reflection online help. Additional information on Reflection X startup parameters can be found in Technical Note 1530.

    1. Change the Working Directory to <Metadrive>:\Documents and Settings\%username%\My Documents\Reflection.

Or, if user-generated files are stored on a separate file server, enter that location. For example, \\<file server>\home\%username%.

    1. Click Next.
  1. Select the applicable neighborhood settings for your environment, and then click Next.

Note: If you do not select one of the Application Shortcut Placement options, the user will see the Reflection icons only after they log in to the Citrix Program Neighborhood. This can be useful in a high-security environment where workstations do not display a Start Menu or Client desktop.

  1. Specify the settings appropriate for your network environment in the Application Appearance, Client Requirements, Application Limits, and Access Control dialog boxes, clicking Next as you complete your selections in each dialog box.
  2. In the Specify Users dialog box, select the Trusted Domain where your user and group accounts are located, click Add, and then click Next.

Note: If there is more than one server in your server farm, install Reflection to the servers where you have Load Balancing enabled.

  1. Choose the accounts or groups who should have access to Reflection (typically Domain Users), click Add, and then click Next.
  2. Specify the r<#>w file extension if you want users to be able to launch Reflection from settings files, and then click Finish.

The Reflection application should now appear in the console with Type set to Explicit, and State set to Enabled.

Note: 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.
  2. Navigate to the Server Location, which defaults to "auto-detect."
  3. Change the Server Location to the IP Address for the Citrix Server you are connecting to. Click Next twice, and then click Finish.

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

Additional Information

Legacy KB ID

This document was originally published as Attachmate Technical Note 1888.