2.1 Installation

You can install Reflection from a downloaded distribution, an administrative installation image, or from a CD. If you are an administrator looking for instructions on how to create a customized installer, see the Reflection Deployment Guide.

NOTE:Reflection is typically distributed electronically. If your installation requires a CD, you will need to request it when you place your order.

2.1.1 System Requirements

Requirements for Reflection Desktop can vary, depending on your hardware and other software components present.

Hardware Requirements and Supported Operating Systems

Processor

2 GHz, 64-bit (1.5 GHz or higher multi-core recommended)

System memory (RAM)

2 GB (4 GB recommended)

Operating system and platform

One of the following:

 

Microsoft Windows 10 Pro 64-bit

 

Microsoft Windows 10 Enterprise 64-bit

 

Microsoft Windows 8.1 Pro 64-bit

 

Microsoft Windows Server 2019 with Remote Desktop Services (for multi-user environments)

 

Microsoft Windows Server 2016 with Remote Desktop Services (for multi-user environments)

 

Microsoft Windows Server 2012 R1 or R2 with Remote Desktop Services (for multi-user environments)

Additional software requirements

To use the Office integration features in Reflection, Microsoft Office 2013 or later must be installed.

NOTE:Where listed in the Hardware Requirements and Supported Operating Systems table, 64-bit operating systems are supported by the 32-bit Reflection Desktop product. The 64-bit .NET Framework Runtime is used on Windows 64-bit operating systems, which also supports native 64-bit applications calling the Reflection .NET API.

Prerequisite software — Microsoft .NET Framework

Reflection Desktop requires .NET Framework 4.7.1 or later. On desktop systems, If the required .NET Framework isn't installed, the Reflection Setup program installs version 4.7.1. On Microsoft Windows servers, the .NET Framework must be manually installed if version 4.7.1 or later is not installed.

Notes:

  • If you install Reflection directly with MSI and the product features you install do not require .NET 4.7.1, you can add the SKIPDOTNET=1 property to the command line to bypass this test condition.

Microsoft Windows Installer 4.5

The Microsoft Windows Installer (MSI) version 4.5 is distributed with Reflection Desktop.

Microsoft Visual Basic for Applications (VBA)

Reflection Desktop supports Microsoft VBA 7.1. If you select to install this feature in the Reflection Setup program, it is automatically installed. If you install Reflection Desktop directly with MSI or with a deployment tool and you want to install this feature, you must install it directly, using the core VBA 7.1 MSI and an appropriate language specific MSI (these MSIs are in the Prerequisites folder, in the distribution media).

Windows 10 “Windows as a Service” Support Statement

Reflection Desktop is supported on the following editions of Windows 10: Windows 10 Education, Windows 10 Pro, and Windows 10 Enterprise. Reflection Desktop is supported on the in-market supported servicing branches (https://technet.microsoft.com/en-us/windows/release-info.aspx) of Windows 10 including: Current Branch, Current Branch for Business, and Long-Term Servicing branches.

Supported Virtualization Platforms

Reflection Desktop is supported with the following virtualization platforms:

  • Citrix XenApp

    NOTE:Note: Reflection Desktop TouchUx User Interface Mode is supported with Citrix 6.5 or higher. Reflection is supported only on Citrix versions currently supported by Citrix.

  • Microsoft Application Virtualization (App-V)

  • VMware Workstation/Player

  • VMware ThinApp

2.1.2 Upgrading from Previous Versions

When you install Reflection Desktop, it upgrades the following Micro Focus products:

  • Reflection for IBM 2007, 2008, 2011, and 2014

  • Reflection for UNIX and OpenVMS 2008, 2011, and 2014

  • Reflection for IBM v. 8.0 - 14.x

  • Reflection for UNIX and OpenVMS v. 8.0 - 14.x

  • Reflection for the Multi-Host Enterprise,Standard Edition v. 8.0 - 14.x

  • EXTRA! X-treme v. 8.0 - 9.3

  • Extra! X-treme v. 9.4 or greater

  • myEXTRA! Enterprise v. 7.0

  • myEXTRA! v. 7.x

  • EXTRA! Enterprise 2000

    NOTE:Reflection 2007, 2008, 2011, and 2014 are automatically removed when you upgrade. Extra! and the other Reflection products are automatically removed when you upgrade using setup.exe. If you upgrade these products by deploying the .msi file directly, you will get a message telling you to uninstall the older software first.

Supported Reflection Configuration Files

Reflection Desktop represents an upgrade over previous versions of both Reflection and Extra!. Most configuration files used with these products are supported by the new version.

For a complete list of Extra! and legacy Reflection files supported by Reflection Desktop, see Knowledge Base Article 7021411.

2.1.3 Install Reflection on a Workstation

NOTE:You must log on with administrator privileges to install Reflection. If you do not have the necessary access rights, ask your system administrator to elevate your privileges.

To install on a workstation

  1. Run the Reflection Setup program.

    If you install from

    Do This

    A download site

    Click the download link, and then run the download program. Select a location for the installer files, and then click Next. This extracts the files to the specified location and starts the Reflection Setup program.

    An administrative installation image

    From the administrative installation point, double-click the setup.exe file.

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

  3. (Optional) To change the default installation folder, click the File Location tab and browse to the folder in which you want to install Reflection.

  4. (Optional) To select which features, components, or languages are installed, click the Feature Selection tab.

  5. Click Install Now.

NOTE:Use the Advanced tab of the installer only if you want to modify the installer log settings, or if you are an administrator configuring a Reflection deployment. An administrative installation does not actually install the product — instead, it creates an installation image that administrators can use to customize and deploy Reflection to end users.

2.1.4 Features Selection Tab

Use the Feature Selection tab to select which features you want to install.

Click the icon to the left of the feature name and select from the options below.

Option

Description

Feature will be installed on local hard drive

Installs the selected feature.

NOTE:Some features listed under a selected feature may not be included when you select to install the higher-level feature. The features that are included are the recommended defaults. If you select the higher level feature a second time, all sub-features will be included.

Feature will be installed when required

Installs the feature when you first use it (for example, when you click the Start menu shortcut for this feature).

Feature will be unavailable

Leaves the feature uninstalled.

2.1.5 Set Your User Data Directory

You can specify any location as the user data directory. The default directory is Documents\Micro Focus\Reflection\.The directory you specify will be added as a Trusted Location.

To set the user data directory

  1. Run the Reflection Setup program as shown in Install Reflection on a Workstation.

  2. On the Reflection Setup program, click File Location, and then under Default user data directory, browse to the directory you want to use.

    NOTE:This change only affects those features that you include in your initial installation. If you add a feature later using Programs and Features (or Add/Remove Programs), that application will use the original default directory ( Documents\Micro Focus\Reflection\), not the value you specified for Default user data directory.

2.1.6 Advanced Tab

Use the Advanced tab of the installer only if you want to modify the installer log settings or you are an administrator configuring a Reflection deployment.

Install to this PC

Installs Reflection to your computer.

Create an Administrative install image on a server

NOTE:An administrative install image does not actually install the product — instead, it creates an installation image that administrators can use to deploy Reflection to end users.

When you create an administrative install image, an image of Reflection is copied to a network location for later installation to multiple workstations. This network location can be used by deployment tools to access and create packages that are deployed to workstations. Also, end users can perform installations by running setup.exe from this location.

Log file settings

By default, an installation log file is created and then deleted after installation successfully completes. (This configuration avoids accumulation of large log files after successful installations.) To save a log file for all installations, including successful ones, select Create a log file for this installation, and clear Delete log file if install succeeds.

The installation log file, which provides details about the installation, is saved in the user's Windows temporary folder (%tmp%) with a generated name that begins with atm. To open this directory, launch the Start menu Run command and enter %tmp%.