This topic explains how to install Virtualize (which is built upon the Eclipse framework) on a Linux or Mac system.

SOAtest - Virtualize Co-Installation

When Parasoft SOAtest and Parasoft Virtualize are installed on the same machine, SOAtest and Virtualize must have an identical version number. This ensures compatibility between both products. 

If you are updating an existing installation (including updating from a service pack), be sure to update both products at the same time. 

System Requirements


  • At least 2 GB RAM
  • Java 8 or higher
  • GTK+ 2.18 or higher
  • GLib 2.17.6 or higher
  • Pango 1.20 or higher
  • X.Org 1.0 or higher
  • 32-bit or 64-bit (x86_64) processors with at least 4 cores are supported
  • Default font size of 8 is recommended. For example, on Ubuntu, use the following in the terminal: gsettings set org.gnome.desktop.interface font-name 'Ubuntu 8'

The Virtualize/Eclipse application and the system libraries must be for the same architecture. Thus, if you are using a 64-bit Linux but you are running the 32-bit (x86) version of Virtualize, you need the 32-bit version of the above libraries. 


  • Mac OS X 10.9 or higher
  • Java 8 or higher
  • Intel® Xeon® 2.0 GHz or higher with at least 4 cores recommended
  • 1 GB RAM minimum; 2 GB RAM recommended


To install:

  1. If you haven’t already done so, copy the installation file to the directory where you would like to install Virtualize.
  2. Change directories to the directory where you are going to install Virtualize.
  3. Set "execute" permissions on the installer.
    • chmod +x parasoft_virtualize_<version>
    • chmod +x parasoft_virtualize_<version>
  4. Execute the installer, then follow the onscreen instructions to complete the installation.
    • ./parasoft_virtualize_<version>
    • ./parasoft_virtualize__<version>

A directory under parasoft/virtualize/<version> (Linux) or virtualize/<version>/ (Mac) will be created. We refer to this location as <virtualize_install_dir> throughout this user guide. The Virtualize executable, command line interface, examples, manuals, etc. are available within this directory.

Mac Note - Accessing <virtualize_install_dir> Contents

 After installation is completed, an application icon will be added in Finder. This is the icon that you double-click to launch Virtualize. If you want to view the various files and folders available within <virtualize_install_dir>, right-click that same icon, and choose Show Package Contents

The default Virtualize workspace will be set to <user_home_dir>/parasoft/workspace. This default workspace is preselected in the Select a Workspace dialog when you first start Virtualize. If you select a different workspace, that new workspace will be preselected when you start Virtualize from that point forward. The command line interface uses the default workspace any time that you do explicitly specify a workspace from the command line (with the "-data" argument)—whether or not you have previously run the command line interface with another workspace. 



To run Virtualize GUI:

  • Change directories to the virtualize/<version> directory, then enter the following command at the prompt:

To run Virtualize Command Line:

  • Change directories to the virtualize/<version> directory, then enter the following command at the prompt:

You must install a license before you begin using Virtualize. See Licensing.

Mac Startup

To start Virtualize GUI:

  • Double-click the Parasoft Virtualize icon in Finder.

Frozen Workspace Launcher?

On Eclipse 4.5 and Mac OS X 10.11, there is a known issue with the workspace launcher freezing (becoming unresponsive) when Virtualize starts up. The workaround is to launch Virtualize from the command line with the –nosplash argument.

To run Virtualize Command Line:

  • Change directories to the virtualize/<version>/ directory, then enter the following command at the prompt:

You must install a license before you begin using Virtualize. See Licensing.

  • No labels