Installing Data Virtuality Studio (Windows)

You are looking at an older version of the documentation. The latest version is found here.

Technical Specifications

Data Virtuality Studio is an Eclipse RCP-based Java application. It includes a bundled java runtime environment (JRE). For system requirements, please refer to this page.

We strongly recommend having the Data Virtuality Server and Studio on the same version. Updating the Data Virtuality Server requires a rollout of a newer Data Virtuality Studio version to all desktop users.

Downloading the Data Virtuality Studio Installer

The Data Virtuality Server download page (by default, http://serverHost:8080/downloads.html) contains a Studio version matching the version number of the Server. Alternately, you can find it in the Data Virtuality Server file system: <dvserver_install_path>/standalone/deployments/ROOT.war/dvstudio.

When installing the Data Virtuality Suite (a special all-in-one package containing the Server, the Studio, and the ODBC drivers) on a Windows Server machine, the wizard will also install a current Data Virtuality Studio.

For Windows, there is an executable installation wizard for a 32/64-bit system available.

Installation

Start the installation by running the installer. Administration permissions are not required.

You can choose between two installation options:

• "Only for me": the default installation path will be like C:\Users\<username>\AppData\Roaming\Data Virtuality Studio;
• "Anyone who is using this computer" (available when running the installer as Administrator): the default installation path will be like C:\Program Files\Data Virtuality Studio.
  

The Data Virtuality Studio does not require a specific path to be installed: it will find its files relative to the executable Data Virtuality Studio.exe file.

Alternative Deployment (Unattended Installation)

You can also copy the Data Virtuality Studio folder (containing the Data Virtuality Studio.exe file) to a different machine. Please note that this will disable the option to uninstall via the wizard: you will be able to uninstall by removing the Data Virtuality Studio folder.

Updating the Data Virtuality Studio

You can safely install a newer Data Virtuality Studio over the old installation when using the wizard. For the alternative deployment, please remove the current installation directory completely, then follow the alternative deployment instructions.

Configuration and Paths

Workspace

By default, the Data Virtuality Studio uses the working directory (called Eclipse Workspace) in C:\Users\<username>\.dvstudio to store connection information and open tabs and their content.

You can configure this path in the Data Virtuality Studio\configuration\config.ini file: osgi.instance.area=@user.home/.dvstudio.

To run multiple instances of the Data Virtuality Studio simultaneously, this folder must be different for each instance. Otherwise, you will see the following error message: "Could not launch the product because the associated workspace is currently in use by another Eclipse application".

Memory configuration

The java memory used in the Data Virtuality Studio can be configured in the Data Virtuality Studio\Data Virtuality Studio.ini file as follows:

-vmargs
-Xms96m
-Xmx2048m
-XX:+UseG1GC

These values are sufficient for most cases, but can be increased if out-of-memory errors appear.

Networking

The required ports are as follows:

The network access will only target the Data Virtuality Server.