Multiple Instance Installation

The most common scenario for needing more than one version of OneStream Desktop installed on the same computer is that your company has setup a test environment with a newer version in order to perform testing prior to upgrading production servers. To test the new version and maintain access to the current version, you might need to install an additional instance of the Desktop application on your computer.

You can install up to eight instances of the desktop application on a single computer. Each installation instance has a specific named instance embedded in the installer: 0, I2, I3, I4, I5, I6, I7, I8.

Each instance also has a corresponding name in the installation folder and shortcut. The default instance is named 0 and does not have a corresponding change to the installation folder or shortcut. For example, I2 has a shortcut name of OneStream Desktop (2).

NOTE: More than one user can have the same named instance.

NOTE: With a per machine installation, you must use a named instance that is unique across all users on a machine. It is possible that all eight instances may already be claimed, in which case the installation attempt fails.

To install additional desktop application instances:

  1. Double-click the OneStream Desktop EXE installer file to launch the wizard, and then click Next.

  2. Select one of the following:

    • Install a new side side by side instance for just me: installs the application for the current user.

    • Install a new side side by side instance for all users: installs the application for all users on the computer.

  3. NOTE: You must be a local administrator to see both options. Otherwise, you can only install a single instance.

  4. Click Next.

  5. Click Next to begin the installation of the new instance. The instance number is indicated in the title.

  6. Accept the terms of the license agreement, then click Next.

  7. Change the folder path if needed, then click Next.

  8. Click Install.

  9. Click Finish to complete the installation.

You can now log in and use the application.