Skip to content

Setting up a Basic Deployment

This video and walkthrough show a way to deploy Reflection out-of-the-box by installing an image of Reflection on a file server and then sending a link to its Setup.exe program to users. When users are ready to install, they click on the link to the Setup.exe program.

It also shows how to use the Installation Customization Tool to create a package of customized files that can be installed in the same way.

Setting up a Basic Deployment

Deploy Reflection out-of-the-box

  1. Download the Reflection installation files.

  2. Create a network share on a network file server.

  3. From the root directory of the installation files, double-click setup.exe.

    This starts the Reflection Setup program.

  4. Click Continue and accept the license.

  5. From the Advanced tab, click Create an Administrative install image on a server.

  6. Click Continue.

    The File Location tab is selected.

  7. Browse to the network share you want to use for the administrative install image and then click Install Now.


    Be sure to specify a UNC path for the network share. For example: \\share_name\administrative_install_point

  8. To deploy to users, distribute the network path to the Reflection Setup.exe file through e-mail or another type of notification: \\share_name\administrative_install_point\setup.exe


    All the files required to install Reflection are on the administrative installation point. This location also includes the administrative tools provided to help you customize Reflection.

Create and Deploy Customized session files

After you create an administrative installation point, you can use it along with a local installation of Reflection to create and deploy customized session files to your users.

First, you'll need to install Reflection on a workstation so you can create and customize your configuration files.

Install Reflection on a workstation

  1. On the workstation, navigate to the network share where you have created the administrative installation point, and double-click setup.exe.

  2. From the Reflection Setup program, click Continue, and then accept a license.

  3. To select which features, components, or languages are installed, click the Feature Selection tab. The default installation does not include all features and components.


    If you are working with legacy macros or other legacy files, select the compatibility features that support the products you are upgrading or migrating from.

  4. Click Install Now.

Create a custom compound session document file

After you install Reflection on the workstation, you can use it to create custom session document files.

You can simplify your deployment by saving your customized settings in a compound session document file. Compound session document files save all of the settings for QuickPads, keyboard maps, themes, mouse maps, hotspots, and ribbons in a single file.

This video and the instructions that follow show how to create a session with a custom keyboard map, save all of the settings in a compound session document file, and then package that file in an .msi file.

Simplifying Deployment with Compound Session Document Files

  1. On the workstation, open Reflection. If the Create New Document box doesn't open automatically, select File | New to open it.

  2. Select 3270 terminal and then click Create.

  3. In the Host Name /IP address box, enter the host name. To use the Reflection onboard demo, enter


  4. After the session opens, click the Document Settings button on the Quick Access toolbar and then select Manage Keyboard Map.

  5. In the Manage Keyboard Map dialog box, select Create a new keyboard map from an existing keyboard map file.

  6. In the Create a New Keyboard Map file dialog box, select to base the new keyboard map on the default map.

  7. In the Keyboard Mapper, press the key combination to map (for example, Ctrl+F8) and then click Select Action.

  8. In the Select Action dialog box, select an action.

  9. Enter a new file name for the keyboard map and save it.

  10. From the File menu, choose Save As and then save the session as a compound session file type:


    Saving a session in a compound session document file simplifies your deployment. When you save the session as a compound session document, the custom keyboard map settings are saved in your session file. If you were to save the session as a regular session document, these settings would be saved in a separate file that you would need to deploy along with your session file.

The Installation Customization Tool is designed to be opened from a command line. However, you can create a desktop shortcut that opens this tool. This will save time when you are working with the tool.

Set up a shortcut that opens the Installation Customization Tool

  1. On your administrative installation point, right-click the setup.exe file, and choose Create Shortcut.

  2. Right-click the shortcut and choose Properties.

  3. In the Target box, add the /admin option to the end of the command line. For example:

    \\myServer\adminInstallPoint\setup.exe /admin


    The path in the Target box must conform to the Uniform Naming Convention (UNC) format and cannot include drive letters. Drive letters can cause problems if you try to use the shortcut on other workstations.

  4. Rename the shortcut and save it on the desktop of your workstation.

Create a companion installer package

  1. To start the Installation Customization Tool, double-click the shortcut on your workstation, and in the Select Customization dialog box, select Create a new Companion installer.

  2. On the left pane, click Specify install locations, and specify the Installation type.

    • Installs to all users of a machine installs the file in a common folder so that the settings apply to all users of the machine.

    • Installs only for the user who installs it installs the file in a personal folder so that the settings apply only to a single user.

  3. On the left pane, click Add files and then click in the Add files to box and type the rest of the path. If you previously selected Installs only for the user who installs it, The final entry should be:

    [PersonalFolder]\Micro Focus\Reflection\


    By default, this folder is a trusted location. If you use another folder, you will need to add it to the trusted location list and deploy that setting. Reflection does not open files unless they are in trusted locations.

  4. Click the Add button, and browse to the file you added earlier.

  5. From the navigation pane, click Specify package information.

    • In the Add/Remove name box, type the package name to display in the Windows Programs and Features control panel.

    • In the Organization name box, enter the name of your department.

  6. From the File menu, save the.msi file on the administrative installation point.

Now that you have created the companion MSI file, distribute a link to the file to users. When they run this MSI, the session document file is installed to their workstations in the location specified in the MSI.