Sequencing Attachmate Reflection 2011 with Microsoft App-V

    General discussion

  • Application Name: Attachmate Reflection 2011

    Application Version: R1

    Company Name: Attachmate

    Sequencer Version: 4.6

    App-V Client Version Tested On: 4.6

    Operating System Sequenced On: Windows 7

    Pre-requisites:  .NET 3.5 (comes with Windows 7)

    Client Operating Systems Successfully Deployed To: Windows 7

    Posted by non-Microsoft Employee: Kris Lall and Chinh Vu, Attachmate

    How to sequence Reflection:

    Steps to Create an Application that Runs as a Virtual Application

    There are three main phases to create an application that will run as a virtual application:

    Phase I. Document the application's installation requirements for sequencing—determine your sequencing requirements by documenting which Reflection 2011 components and features are installed, the location of installation files, and the location of any configured user data, such as session documents.

    Phase II. Sequence the application using the Application Virtualization Sequencer, and then copy the sequenced package files to the Distribution Point or Virtual Application Server.

    Phase III. Publish and assign the virtual application package to users.

    Phase I: Document a Customized Reflection Installation Before Sequencing

    Before you use the Microsoft Application Virtualization Sequencer utility to sequence Reflection, you should document your sequencing requirements and steps. Some Reflection application components may not be needed. To determine your requirements for sequencing, install Reflection on another PC to help identify and document the sequencing steps.

    Note the following:

    • The sequencing steps described in this document were performed on 32-bit Windows 7 with .NET Framework 3.5. If Reflection has any service packs, ensure that the service pack installer file, .MSP, is available for installation during the sequencing process.
    • Reflection Productivity Microsoft Office Tools have not been tested to work with Microsoft Office streamed as a virtual application.

    Follow these best practices:

    • Always use a clean sequencing PC that has not yet been used for sequencing an application.
    • Install as a User with local administrator rights on the PC used for sequencing.
    • Turn off Windows Defender, Anti-virus software, Automatic Windows Update, and Windows Security Alerts. If User Account Control is used on the client PC, then it should be turned on during the sequencing process.
    • Sequence on the same operating system type, version, and patch level as the App-V Desktop Client systems.

    Creating Companion Packages, Permissions Files, and Transforms

    Use the Attachmate Customization Tool to create companion packages, to define permissions files, and to create transforms; the basic steps are listed below. Refer to the following technical notes as resources:

    • Technical Note 2369 – Creating and Deploying Transforms and Companion Packages Using the Attachmate Customization Tool.
    • Technical Note 2396 – Unable to Create a Companion Installer Containing Permission Files in Reflection Using the Attachmate Customization Tool (ACT)

    Note: In the section below, the steps for using the Attachmate Customization Tool assume that you have set up a Reflection Administrative Installation. If you do not plan to use an Administrative Install to automate parts of the installation and add user session documents, then proceed to Phase II. Sequence Reflection Using the Sequencer Package Configuration Wizard.

    Create a Companion .MSI File Using the Attachmate Customization Tool

    Use the Attachmate Customization Tool to create a companion .MSI file.

    1. Navigate to your Reflection Administrative Installation and run <tt style="FONT-FAMILY: 'Courier New', Courier, mono; FONT-SIZE: 12px">Setup.exe /Admin</tt> to launch the Attachmate Customization Tool.
    2. Select "Create a new Companion installer." Click OK.
    3. In the left pane, click "Specify install locations."

    Note: It is important to perform steps a and b in order.

      1. Under Installation type, select the "Installs only for the user who installs it" option.
      2. In the Default installation folder drop-down list, select [AppDataFolder].
    2. In the left pane, click Add files to add files to [AppDataFolder]. Click the Add button to add files that you may want to include, such as your pre-configured Reflection session documents (.RD3X, .RD5X, .RDOX, .RFW, or .RWSP settings files, for example).
    3. Click File > Save As. Save the companion.msi file in the same location as Setup.exe.

    Define Permissions Files

    Use the Attachmate Customization Tool to define permissions files.

    1. If the companion file that you created in the previous section is no longer open, open the companion.msi file.
    2. In the left pane, click "Specify install locations" and verify that "Installs only for the user who installs it" is selected. (This option may be dimmed; as long as it is selected, there is no cause for concern.)
    3. In the left pane, click "Modify user settings" to define *.access permission files. For example, you may want to define .RD3X.access to restrict TN3270Basic or TN3270Advanced settings.
      1. Select the Application – Settings to modify and click the Define button.
      2. Select the Group from the Groups drop-down list. You can allow or restrict accessibility for each item listed.
      3. Repeat steps a and b until you have configured the permissions for your environment. Click Next.
      4. Optional: Select Additional security options for Session file encryption.
      5. Click Finish.
    4. Click File > Save and save the companion.msi in the same location as Setup.exe.

    Use the Attachmate Customization Tool to Create a Custom Transform File

    To prepare Reflection as a virtual application, you can use the Attachmate Customization Tool to create a custom transform file.

    1. Use the Attachmate Customization Tool to create a new custom.mst transform file by navigating to your Reflection installation and running <tt style="FONT-FAMILY: 'Courier New', Courier, mono; FONT-SIZE: 12px">Setup.exe /Admin</tt>.
    2. Select "Create a new Setup customization file for the following product."
    3. In the Welcome pane, under Setup, click "Install location and organization name." In the Default installation folder field, enter a location on Q:\ (for example, Q:\Reflection).
    4. Under Setup, click "Licensing and session metering." Complete the licensing agreement and accept the Session Metering setting defaults.
    5. Under Setup, click "User interface." Select the "Use this customization with interactive installs using setup.exe" option. Also, verify that the user interface level is Full, the default.
    6. To add a chained companion.msi to your installation, under Setup, click "Add installations and run programs." Add a companion.msi file (using the UNC path) to the installation command. For example: "msiexec.exe /i \\hostname\ReflectionAdminstall\companion.msi".

    Or, you can install the companion.msi file by clicking it after Reflection is installed.

    1. Under Setup, click "Modify setup properties." INSTALLDIR_Custom should display with a value of Q:\Reflection (step 3 above).
    2. Under Features, click "Set feature installation states." Select the Reflection features you will install. Since user interface level is set at Full (step 5 above), you should be able to also select or de-select features during installation while in the sequencing process.
    3. Save the custom.mst file in the same location as Setup.exe.

    Phase II. Sequence Reflection Using the Microsoft Application Virtualization Sequencer

    Use the Application Virtualization Sequencer to start the sequencing process.

    1. To start the Sequencing Wizard, click on Create a Package.
    2. Enter a Package Name and click next.
    3. Click Begin Monitoring.
    4. Create the primary install directory, for example: Q:\Refl2011, and click OK.  Note: Microsoft recommends you select a unique 8 character folder name.
    5. Wait for the Virtual Environment to load.
    6. When "Install the application, and then click Stop Monitoring" option becomes visible, navigate to Reflection and install it by clicking Setup.exe.
    7. On the Install Attachmate Reflection screen, click Continue.
    8. Read and accept the License Agreement; then click Continue.
    9. Personalize the installation by completing the Full name, Organization, and VPA number fields on the User Information tab.
    10. On the File Location tab, change the File Location by clicking the Browse button. Following the example in this technical note, File Location is specified as Q:\Refl2011.
    11. On the Feature Selection Tab, de-select any features not needed so that they will not install. 
    12. On the Advanced Tab verify that "Install to this PC" is enabled. Then click the Install Now button.
    13. When the Installation has completed successfully, click the Close button.
    14. If you have a chained companion *.msi package, allow the package to install. 
    15. If you have a Reflection *.msp update file, then click the file to install the patch. If there is no *.msp update to install, then click Stop Monitoring.
    16. When the virtual environment is downloaded and monitoring is finished, click Next, and then the Configure Application screen displays.
    17. Click Next.

    Configure and Launch Sequenced Applications

    Launch the Reflection sequenced application to create the virtualization .OSD files, which are used for streaming the application.

    1. Remove any applications that are not needed, but were captured during the sequencing process. Typical application components to remove include Reflection ‘No Open’ Handler, Reflection IBM Printer, and Macro execution utility.
    2. Click the Add button to add any Reflection session documents that were installed by the companion *.msi file. To find the files, browse to the Q:\Refl2011\VFS\CSIDL _COMMON_APPDATA folder.
    3. After adding any session documents, click Next to Launch Applications. (Do not click Launch All.) Then launch Reflection Workspace.
    4. If you need to create any additional session documents, you can use the Create New Document wizard. Save the session in, for example, Q:\Refl2011\VFS\CSIDL _COMMON_APPDATA.
    5. If you create any new Reflection session documents, you must click the Back button to add them to the application package, as in step 2 above.
    6. Launch and then close each session document to create .OSD files that will be used for streaming. Note: If you launch Reflection Workspace, Reflection FTP client, or any session document, and a Sequencer error displays: “The Sequencer could not stop the MSIServer service,” click OK and try again.
    7. Once you have completed launching the session document applications, you can click Back to remove any applications that will not be published to users. For example, you can remove Reflection Workspace and Reflection FTP Client since users have pre-configured session documents while Reflection is running in the App-V Desktop Client environment.
    8. After all the applications and Reflection Session documents have been launched and closed, click Next to complete the sequencing.
    9. Click Finish when sequencing is completed.
    10. Enter deployment information on the Deployment Tab of the Sequencer, including operating systems.
    11. Create path location for package contents to be saved.
    12. Click Package > Save.

    Note: Instead of using a Virtual Application Server to deploy the application, you could also create an .MSI package when you save Reflection sequenced as a virtual application to run in a standalone environment. Instead of streaming the virtualized application, this method uses .MSI installer technology to load and configure virtual applications onto PCs running the App-V Desktop Client.

    Phase III. Publish Reflection with Virtual Application Management Console

    Once Reflection has been sequenced and configured for streaming, copy the sequenced package files to the Virtual Application Server Content folder, and then prepare Reflection for publishing.

    1. When moving the package of Reflection files to the Virtual Application Server Content folder, include the following files:
    • Saved session .OSD files
    • Reflection .ICO icon files
    • Project .SFT asset files
    • Manifest XML and .SPRJ files
    1. Use the Application Virtualization Management Console to create and configure the Reflection Package and Application.
    2. Publish Reflection for users running the Application Virtualization Desktop Client software.

    Verify that Reflection Streams Correctly

    From the client computer, double-click the shortcut icon for Reflection. If a Launch Failed dialog box opens, click the box for details, and troubleshoot as appropriate.

    Saturday, May 22, 2010 4:39 PM