In this section:

System Requirements

SOAtest and 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.

Installation

You can install SOAtest and Virtualize as a standalone Eclipse application or as an Eclipse plug-in. 

The standalone version ships with Eclipse 4.6.1, which contains a known defect that may result in IDE crashes on macOS. Eclipse 4.6.1, furthermore, does not run on macOS X if a version of Java newer than 8 is installed. Eclipse 4.8 or later is required to launchSOAtest and Virtualize if a newer version of Java  is installed. Future versions will ship with a newer version of Eclipse to address these issues. 

If you experience issues with the standalone version, we recommend installing SOAtest and Virtualize as a plug-in for Eclipse 4.2 to 4.16 (2020-06).

Standalone Installation

1. If you haven’t already done so, copy the installation file to the directory where you would like to install the application.
2. Change directories to the destination directory.
3. Set "execute" permissions on the installer.
   • chmod +x parasoft_soavirt_<version>_linux.sh
   • chmod +x parasoft_soavirt_<version>_macosx.sh
4. Execute the installer, then follow the onscreen instructions to complete the installation.
   • ./parasoft_soavirt_<version>_linux.sh
   • ./parasoft_soavirt__<version>_macosx.sh

A directory under parasoft/soatest_virtualize/<version> (Linux) or soatest_virtualize/<version>/Parasoft SOAtest & Virtualize/Virtualize.app/Contents/ParasoftSOAtestVirtualize (Mac) will be created. We refer to this location as <soavirt> throughout this user guide. The SOAtest and Virtualize executables, command line interfaces, examples, etc. are available within this directory.

Plug-in Installation 

See Eclipse p2 Update Site Installation for additional information.

1. Launch Eclipse and choose Help> Install New Software from the Eclipse menu.
2. Click Add. 

3. Click Archive and browse for theparasoft_soavirt_<version>_macosx_x86_64_updatesite_p2.zip archive.

4. Click Add and select all Parasoft items to install.
5. Click Finish and restart Eclipse when prompted. 

Updates

See Service Pack Updates.

Start Up on Linux

To run SOAtest GUI:

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

To run SOAtest Command Line:

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

For details on using soatestcli, see Testing from the Command Line Interface - soatestcli.

To start Load Test:

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

To run Virtualize GUI:

1. Change directories to the virtualize/<version> directory 
2. Enter the following command at the prompt:
   ./Virtualize

To run Virtualize Command Line:

1. Change directories to the virtualize/<version> directory 
2. Enter the following command at the prompt:
   ./virtualizecli

Start Up on MacOS

Double-click the Parasoft SOAtest & Virtualize icon in Finder to start the SOAtest and Virtualize desktop application.

You must run command line distributions separately.

To start Virtualize command line:

1. Change directories to the soatest_virtualize/<version>/Parasoft SOAtest & Virtualize.app/Contents/ParasoftSOAtestVirtualize directory
2. Enter the following command at the prompt:
   ./virtualizecli

To start SOAtest command line:

1. Change directories to the soatest_virtualize/<version>/Parasoft SOAtest & Virtualize.app/Contents/ParasoftSOAtestVirtualize directory
2. Enter the following command at the prompt:
   ./soatestcli

See Load Test Command Line Interface - cli for information on running Load Test from the command line.