3. pure::variants Desktop Client

The pure::variants Desktop Client can be installed using the pure::variants installer as a stand-alone application or it can be installed into an existing Eclipse based tool chain. For both ways to install pure::variants we recommend to use the pure::variants installer.

The pure::variants installer is available for Windows only. If the operating system platform is Linux or MacOS X, pure::variants needs to be installed into an existing Eclipse instance. See Section 3.1.2, “Install into an existing Eclipse”.

In case of very strict firewalls or no network access on the installation machine either install pure::variants as a stand-alone application. (Section 3.1.1, “Install with pure::variants Installer”) or install pure::variants into an existing Eclipse instance using an update site. ( the section called “Using update site”). These installation methods allow you to first download the installation packages and install pure::variants afterwards.

The installation procedures are described below. Once the initial installation has finished, installation of a license is required to use pure::variants. See following section for more information on license installation.

This installation method is available for Windows only. If you do not use Windows please see Section 3.1.2, “Install into an existing Eclipse”.

To be able to successfully install the pure::variants Desktop Client you need to following:

  • pure::variants Desktop Client license

    • If a floating license is used additionally the license server URL is needed to be able to connect and obtain a license form the license server.

  • pure::variants Desktop Client installer or pure::variants update site

  • supported 64-Bit Java version installed

The Windows Installer can be download from the pure::variants product web page. Go to https://www.pure-systems.com/pvde-update. The product download pages are protected by a password. You need to login by using the email address and the registration number from the license file.

Download the installer package ("pure::variants Windows Installer Package") and extract it. The installer will set up a fresh Eclipse with pure::variants and documentation. Start the installation by double-clicking "Setup Enterprise X.Y.ZZ.exe". Running the pure::variants enterprise installer requires Administrator privileges.

All pure::variants extensions available for the account are automatically included in the Windows Installer download. However, some may not be enabled by default in Installer. Make sure to select the desired extensions during the installation process. Later updates to the extension selection can be done either by reinstalling pure::variants or by following the alternatives described in the section called “Using update site”.


Click Next.


Read the license agreement and after accepting it click Next.


Select the folder where to install the pure::variants Desktop Client files. Click Next.


Select the connectors which shall be installed with the pure::variants Desktop Client. Click Next after the feature selection is complete.


Enter the name for the Windows start menu entry, or disable the creation of the start menu entry. Click Next

The next pages may show information about pure::variants integrations, which are installed along with the pure::variants Desktop Client. If no connector was selected providing an integration, this page will show the Install button.

Click Install to start the installation process.


The Option Show further manual installation steps will open a text document showing more information about the installed integrations and possible manual installation steps, which have to be performed for the integrations to work properly.

The pure::variants installer provides the following command line options:


Example commandline with JAVA path:

"D:\5.x.x\pure-variants Setup 5.x.x\Setup Enterprise 5.x.x.exe" /JAVA="C:\Program Files\Java\jre1.8.0_231\bin\java.exe"

pure::variant can be installed into an existing Eclipse based tool chain. To install pure::variants, the pure::variants installer package download from the pure::variants updatesite can be used. We recommend this for all Windows users.

Alternatively the pure::variants update site can be used directly with the Eclipse client. You can also download an archived update site from the pure::variants update site and use this with the Eclipse client (See the section called “Using update site”).

If the direct remote update is not possible (often due to firewall/proxies preventing Eclipse accessing external web sites), please go to the web site using an Internet browser:

and download the "Complete Updatesite" archive:

This update method is available for Windows only. If you do not use Windows please see Section 3.2.2, “Update with Update Action” or Section 3.2.3, “Update with Eclipse package manager”.

The Windows Installer can be downloaded from the pure::variants product web page. Go to https://www.pure-systems.com/pvde-update. The product download pages are protected by a password. You need to login using the email address and the registration number from the license file.

Download the installer package ("pure::variants Windows Installer Package") and extract it. The installer will check for an existing pure::variants Desktop Client installation and start in update mode if it finds one. Start the update by double-clicking "Setup Enterprise X.Y.ZZ.exe". Running the pure::variants enterprise installer requires administrator privileges.


Click Next.


Read the license agreement, and after accepting it click Next.


Choose Update if the current pure::variants Desktop Client installation shall just be updated with the same installed feature and settings. The installed pure::variants integrations will also be updated. The installed components cannot be changed. If a change of the installed components is wanted, choose Install mode.

Or choose Install if the current pure::variants installation shall be removed and a new fresh pure::variants Desktop Client shall be installed. The Install option runs the installer as described in Section 3.1.1, “Install with pure::variants Installer”. Please see this section for further installation steps.

Click Next.


Click Update to start the update process.


This page is showing the installation details. Click Next after this is finished.


The Option Show further manual installation steps will open a text document showing more information about the installed integrations and possible manual installation steps, which have to be performed for the integrations to work properly.

The quickest way to get a update for pure:.variants is to run the software updater inside pure::variants:

If the online update is not possible (often due to firewall/proxies preventing Eclipse accessing external web sites), please go to the web site using an Internet browser:

and download the "Complete Updatesite" archive:

There are two ways to remove pure::variants from an Eclipse instance. You can use the Eclipse command line or remove the pure::variants features one by one in the running Eclipse Instance. Either way a cleanup of the Eclipse instance has to be performed afterwards.

If the Eclipse instance is not needed anymore you can just remove the whole Eclipse installation from the file system. If the Eclipse is of further use, follow one of the installation methods.

A valid license file is required in order to use pure::variants. If pure::variants is started and no license is present, then the user is prompted to supply a license. Select the “Yes” button and use the file dialog to specify the license file delivered with pure::variants. The specified license will be stored in the user's application data directory. If you are using multiple workspaces then the license file has to be installed only once. The pure::variants integrations also use the installed license and thus no further setup step is needed here.

To replace an existing pure::variants license, start pure::variants and open the Preferences (menu Window -> Preferences). Navigate to Variant Management -> pure::variants License and use the Install License button to select the new license.


The pure::variants client license can also be defined using the PVLICENSE environment variable. This variable has to define the fullpath to a license file. If this variable is defined the given license file is used and the user does not need to define the license for pure::variants client instances.

The next step is necessary only if a floating license with a pure::variants license server is used. The license server URL can be provided with the floating license file, or it has to be set by the user.

To set the license server URL, open the sub pageVariantMan- agement -> pure::variants License -> License Server and enter the URL of the license server into the FloatingLicense Server text field, click button Test connection for check, that connection is successfully.


Click button Reserve Offline License to chose how long the license shall be reserved.