[email protected] +1.303.779.0344

Installing and Activating in a Virtual Desktop Environment

OnePager can be installed and activated in a virtual desktop (VDI) environment using technologies such as VMware or Citrix, but there are a few steps you need to take to ensure that your license key will work seamlessly for your end users and that the application can be launched multi-instance.

First, you need to obtain a machine-agnostic license key from our licensing department or from your sales representative. The machine-agnostic key can be activated on any device, which is different from the standard device-specific keys that are typically used.

Once you have obtained your machine-agnostic key, you'll need to install OnePager with the key and ensure that the key is stored in HKEY_LOCAL_MACHINE. This is a critical step to VDI environments since multiple users will need to access the same key to have their software activated in their own instance. To do this:

  1. Windows Key + X to open either Windows Powershell (Admin) or the Command Prompt (Admin). Admin rights are required to do a command line install and to inspect registry key values, as outlined in the steps below. Admin rights are NOT required to use OnePager once it has been installed.

  2. Navigate to the folder where the installer (MSI) file is located.

  3. Run the following command:

    msiexec /i onepager.msi /qb+ ALLUSERS=1 CGKEY=is/69NG91SAYjpoN/QduuQ== ALLOWSECONDOPSALAUNCH=1

    In this example, we've renamed the standard MSI installer to a generic "onepager.msi", so you will need to either rename your MSI or change the command line syntax to match the name of your actual MSI file.

    The key shown above for the CGKEY parameter is an example key. Please make sure that you run the command line installer using your real key, not the dummy key shown above.

    It's important to set ALLUSERS equal to 1, as this is what drives a per-machine installation and population of the key in the local machine hive instead of the user hive.

    If you are installing version 7.1.7 or later, we also recommend setting ALLOWSECONDOPSALAUNCH equal to 1, which enables multiple users to run the application simultaneously in the same environment.

  4. After receiving notification that OnePager setup has completed successfully, open the Windows Registry Editor and navigate to:

    Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Chronicle Graphics\OnePager

  5. Inspect the CGKey key, which should be set to whatever key you specified during installation. Also confirm that AllowSecondOPSALaunch is set to 1:

  6. Launch OnePager, either using the desktop icon, or from the Add-Ins tab of Microsoft Project or Excel. The first time OnePager launches after a fresh installation, it will copy the key from HKLM to HKCU, thereby activating the software in the local user's account.

  7. You can double-check this by refreshing the Windows Registry Editor (View > Refresh), and then inspecting the key in the local machine hive:

    Computer\HKEY_CURRENT_USER\Software\Chronicle Graphics\OnePager

  8. You'll notice that the CGKey and AllowSecondOPSALaunch keys in HKCU now match the keys in HKLM that were supplied during the initial installation:

Last Updated: August 19, 2022