Attachmate Worldwide  |   Contact Us  |   NetIQ.com
Home » Support » Solution Library

Technical Notes

Installing Reflection Products (version 11.0 through 12.x) to a Windows NT 4.0 Terminal Server with Citrix MetaFrame
Technical Note 1480
Last Reviewed 31-May-2006
Applies To
Reflection for UNIX and OpenVMS version 11.0 through 12.x
Reflection for HP version 11.0 through 12.x
Reflection for ReGIS Graphics version 11.0 through 12.x
Reflection for IBM version 11.0 through 12.x
Reflection X version 11.0 through 12.x
Microsoft Windows NT 4.0, Terminal Server Edition
Citrix MetaFrame version 1.8 Terminal Server Edition
Summary

This technical note explains how to install and publish Reflection products (version 11.0 through 12.x) to a Windows NT 4.0 Terminal 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 installing from the CD. The original media may be required when removing 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.
1608 - Windows NT 4.0 Terminal Server
1606 - Windows 2000 Terminal Server
1535 - Windows 2000/Citrix Server
  • For more information about upgrading and patching Reflection products, see the following technical notes:
1645 - Reflection Upgrading Topics
1619 - Reflection Patch Topics
1097 - Windows Terminal Service Topics
  • Beginning in Reflection 13.0, Windows NT 4.0 is no longer supported.

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

For more details about MSI 2.0, see Technical Note 1565; see Technical Note 1851 for information about MSI 3.0.

  • 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 Terminal Server console, log in as Administrator. From Control Panel, double-click the Add/Remove Programs icon, and then click Install on the Install/Uninstall Tab.
  2. When prompted to Install Program From Floppy Disk or CD-ROM, insert the 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. Under User Option, select All users begin with common application, and then click Next.
    3. When the Welcome window opens, click Continue.
    4. To evaluate Reflection X, click PC UNIX Integration. To evaluate Reflection for HP, Reflection for UNIX and OpenVMS, Reflection for IBM, or Reflection for ReGIS Graphics, click Windows Based Terminal Emulation.
    5. Click Evaluate Reflection Now.
    6. Select the product to install, click Install, and then proceed to step 4 below.

If you are installing from the Reflection product CD:

    1. Browse to and double-click Install.exe.
    2. Under User Option, select All users begin with common application, and then click Next.
    3. When the Welcome window opens, click Install Reflection.
    4. 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 Attachmate Technical Support. For information on contacting support, see http://support.attachmate.com/contact/.

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 2000 server drive>:\Program Files\Reflection.

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

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

    • Beginning in version 11.0, Reflection NFS Client is supported the multi-user environment; earlier versions cannot be installed on a Citrix server.

For more information about Reflection NFS Client and Windows Terminal Server/Citrix, see Technical Note 1421.

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

User Folder: We recommend 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 using the Reflection Customization Manager in version 12.x and using the Reflection Deployment Manager in version 11.x.

Default: <metadrive>:\Wtsrv\Profiles\<Administrative account>\Personal\Reflection

Publishing Reflection Applications

If you are using Citrix MetaFrame, follow the steps below to publish the Reflection executable files to the MetaFrame 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 > MetaFrame Tools > Published Application Manager.
  2. Click Application, and then click New.
  3. Enter an Application Name and Description, and then click Next.
  4. Select the Explicit radio button, and then click Next.

Note: Because profiles are not stored for anonymous users, Attachmate recommends not choosing Anonymous. If Reflection cannot find a user's profile, the Microsoft Windows Installer is run each time the user logs in.

  1. In the Specify What to Publish dialog box:
    1. Click Browse, navigate to the Reflection installation directory (<Metadrive>:\Program Files\Reflection, by default), select the Reflection EXE file, and click OK.

Reflection executables:

      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

    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>:\wtsrv\profiles\%username%\Personal\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 Maximize application at startup, and then click Next.
  2. Select the applicable program neighborhood settings, and then click Next.
  3. Select the applicable neighborhood administration features.

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. Select the Trusted Domain where your user and group accounts are located, click Add, and then click Next.
  2. Choose the accounts or groups who should have access to Reflection (typically Domain Users), click Add, and then click Next.
  3. Choose the server farm you want to run Reflection from, and then click Next.

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

  1. Click Finish.

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

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.

Related Technical Notes
1097 Index of Windows Terminal Server and Citrix XenApp Topics (Includes Citrix Presentation Server and MetaFrame)
1421 Reflection NFS Client: Frequently Asked Questions (FAQ)
1530 Startup Parameters for Reflection X
1535 Installing Reflection Products to a Windows 2000/Citrix Server
1565 Recommendations when Upgrading to Reflection 11.0
1569 Optimizing Reflection Settings in the Registry for Use in a Windows Terminal Server Environment
1606 Installing Reflection Products to a Windows Terminal Server
1608 Installing Reflection Products (version 11.0 through 12.x) to a Windows NT 4.0 Terminal Server
1619 Reflection Patch Topics
1645 Reflection Upgrading Topics
1851 Reflection Support for Microsoft Windows Installer Version 3.x

Did this technical note answer your question?

Yes    No    Somewhat     Not sure yet

Additional comments about this tech note:

Need further help? For technical support, please contact Support.