This topic explains how to install SOAtest and Virtualize from an Eclipse p2 update site.

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. 

Requirements & Support

IDEEclipse 2022-03 (4.23) or later.
Java

Java 11 (deprecated), 17 (installed with the application), or 21. Oracle and OpenJDK are supported.

IP Address FormatsIPv4 and IPv6 addresses are supported.
Additional When installing from the update site, you need to install the Eclipse Graphical Editing Framework (GEF). You can download and install Eclipse GEF from http://www.eclipse.org/gef/.
Recommended

We also recommend configuring the osgi.bundlefile.limit property to 0 (unlimited) for Windows or 300 for Linux and macOS when starting Eclipse. For example:

eclipse.exe -vmargs -Dosgi.bundlefile.limit=0

The osgi.bundlefile.limit property limits the number of JAR files the Eclipse framework will keep open. This property defaults to 100, which may be too low and result in performance issues. Setting the property manually overrides the default setting. If you experience crashes or a "Too many open files" exception after setting the property to the recommended values, try setting the property to a lower limit.

Installation

  1. Launch Eclipse and go to Help > Install New Software.
  2. Click Add and enter Parasoft in the Name field.
  3. Click OK and select the features that you want to install when prompted
  4. Click Next and follow the prompts to complete the installation process.
  5. Restart Eclipse when prompted.


Installing the Parasoft Root Certificate Authority

When installing Parasoft SOAtest from the p2 update site, you will need to take some extra steps to ensure that your browser can utilize the Parasoft certificate for components like browser playback. The process differs depending on your OS and/or browser.

Windows

If you are on Windows, you should run soatest_install.bat installed into the eclipse directory of the Eclipse installation into which you installed the update site as an administrator. The script executes tasks that are normally completed by the Parasoft installers but are not supported by the p2 update site.

Running the script as an administrator allows it to install the Parasoft certificate for the local machine. If you are not able to run this script as an administrator, you can manually install the certificate for the current user. To do so:

  1. Navigate to <ECLIPSE_DIRECTORY>\plugins\com.parasoft.ptest.libs.web_<VER>\root\lib and double-click the parasoft.cer certificate file.
  2. Click Install Certificate. The Certificate Import Wizard opens.
  3. Choose Current User and click Next.
  4. Choose Place all certificates in the following store, then click Browse and choose Trusted Root Certification Authorities.
  5. Click Next and review the settings then click Finish.

Once the certificate has been placed in the "Trusted Root Certification Authorities" certificate store, browser playback and related components will work for the user. Repeat the process for other users, if necessary.

MacOS: Chrome

If you are on MacOS and using Chrome as your browser, do the following:

  1. Open the Chrome settings page (chrome://settings) and expand the Advanced section.
  2. Click Manage certificates in the Privacy and security section. The Keychain Access application will open. 
  3. Choose login under Keychains and choose Certificates under Category.
  4. Choose File > Import items and navigate to parasoft.cer in the Eclipse directory.
  5. Right-click the Parasoft Root Certificate Authority when it appears and choose Get Info.
  6. Expand the Trust section and choose Always Trust from the When using this certificate drop-down menu.
  7. Enter your credentials when prompted to save the configuration.

Linux: Chromium-based Browsers

If you are on Linux and using a Chromium-based browser, run the following command:

certutil -d sql:$HOME/.pki/nssdb -A -t "C,," -n <certificate nickname> \
-i <path to parasoft.cer certificate>

See the Chromium documentation regarding Linux Cert Management for more information, including how to install certutil for your distribution, if necessary.

Firefox

If you are using Firefox on either MacOS or Linux, see Firefox's documentation regarding setting up certificate authorities.

Mac OS Installation Using the Eclipse Installer

If you have installed Eclipse on Mac using the Eclipse installer, you will need to start Eclipse from the command line before using the update site.

 A valid license is required. See Licensing for details on configuring your license.

Potential Issues with Eclipse Oomph Installer

If you experience issues with SOAtest and Virtualize after installing into a version of Eclipse that uses the Oomph installer, reinstall Eclipse and disable bundle pools.