Technical Notes

This technical note explains how to install and publish Reflection products to a Windows 2000 Terminal Server with Citrix MetaFrame XP 1.0 or a Windows 2000 server with Citrix MetaFrame 1.8.

Before proceeding, note the following:

• To evaluate Reflection on your Citrix server, obtain a Reflection Evaluator CD, 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 Reflection Evaluator CD from http://www.attachmate.com/Evals/.
• If you are installing Reflection to one of the multi-user operating systems listed below, see the associated technical note.

• For further information about upgrading and patching Reflection products, see the following technical notes:

Running Reflection with Citrix MetaFrame

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

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 MetaFrame environment, please refer to the Citrix documentation at http://www.citrix.com.

Installing Reflection Executables

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

• Reflection 11.0 or higher require Microsoft Windows Installer (MSI) version 2.0 or higher. During installation, if MSI 2.0 or higher is not detected on your machine, you will be prompted to install the MSI service. After installing the service, you must restart Windows and restart the Reflection installation.

• Attachmate recommends 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 2000 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.

3. When prompted to Run Installation Program, follow these steps.

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.

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.
4. When the Reflection Wizard opens, carefully read all messages, warnings, and instructions presented, and then click Next.
5. Proceed through the installation, using the following details when applicable. If you have questions about this process, please contact Attachmate Technical Support. For information on contacting support, see http://support.attachmate.com/contact/.

• Reflection NFS Client version 11.0 or higher is supported in the multi-user environment; earlier versions cannot 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.
• Performance Tuner. If the Performance Tuner is installed, the first time users run Reflection X they will be prompted to run the Performance Tuner. Attachmate strongly recommends that you not install the Performance Tuner, or that you uninstall it, in the Windows Terminal Server environment. The Performance Tuner offers no value in the Windows Terminal Server environment.

Publishing Reflection Applications

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

Note: These steps refer to Citrix MetaFrame 1.8. The same concepts and settings apply to Citrix MetaFrame XP 1.0, but the steps will be slightly different. Please refer to your Citrix MetaFrame documentation for further details.

1. Click Start > Programs > Citrix, and then click Citrix Management 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 (version 14.x: <Metadrive>:\Program Files\Attachmate\Reflection; versions 11.0 through 13.x: <Metadrive>:\Program Files\Reflection, by default), select the Reflection EXE file, and click OK.

Product	Executable
Reflection for HP	R1win.exe
Reflection for UNIX and OpenVMS	R2win.exe
Reflection for ReGIS Graphics	R4win.exe
Reflection for IBM	R8win.exe
Reflection FTP Client	Rftpc.exe
Reflection X	Rx.exe
Reflection for Secure IT Windows Client	R3win.exe
Reflection SFTP Client	Rsftpc.exe

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

3. Change the Working Directory to

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

6. Select the application appearance settings for your environment, and then click Next.
7. Select ICA Client requirements, and then click Next.
8. Select the Trusted Domain where your user and group accounts are located, click Add, and then click Next.
9. Choose the accounts or groups who should have access to Reflection (typically Domain Users), click Add, and then click Next.
10. Choose the server farm you want to run Reflection from, and then click Next.

11. 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 using Citrix MetaFrame XP, and 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.