• Apache Tomcat 8 or higher installed and running
  • Parasoft Virtualize and/or SOAtest 9.8.3 or higher
  • CTP must be compatible with your most recent Virtualize and/or SOAtest installation. CTP  3.0 is required for Virtualize 9.10/SOAtest 9.10. For example, if your team has several older Virtualize servers and one Virtualize 9.10 server connected to CTP, then CTP must be version 3.0. CTP 3.0 is backward compatible with SOAtest/Virtualize versions 9.8.3 and higher.


  1. If you have not already done so, extract CTP from the download:
    unzip em_<version>.zip
  2. Copy em.war to the <tomcat installation>/webapps folder.

In a few moments, you should see an em folder appear under <tomcat installation>/webapps. This is CTP; it has been automatically deployed by Tomcat.

Using a separately-installed, MySQL or Oracle database?

If you are using a separately-installed, MySQL or Oracle database (rather than the embedded HyperSQL database), you must setup the database before proceeding. See Setting up the Database (MySQL or Oracle) for details.

Configuring the License and Database

  1. Open a web browser and point it to http://<hostname>:8080/em, where <hostname> is the machine name or IP address where Tomcat/CTP is installed. You should see a license page like this:

    If you need to reach this page later, just navigate to Administration> License Configuration.


  2. If you do not already have an appropriate license available on your Parasoft License Server, email [email protected] with the Machine ID to obtain a license key you can add to your License Server or a password for a machine-locked local license.

    Understanding the available license features

    Each license will enable one or more of the following features:

    API Testing: Enables the API Testing module and makes test scenarios available within the Environment Manager module.

    Environment Management: Enables the Environment Manager module.

    Service Virtualization: Enables the Service Virtualization module and makes virtual assets, proxies, and provisioning actions available within the Environment Manager module.

    Test Data Management: Enables the Test Data Manager module and makes repositories available throughout CTP.

    Installing new license keys to License Server

    If you need to add new license keys and your License Server is on the same host as CTP, you can do it directly from CTP. Just choose License Configuration from the Administration menu (on the top right of the page) then copy your license key (provided by your Parasoft representative) into the Add New License area and click the Add License button. Once the key is processed, it will be added to the list in the Installed Licenses area.

    If you don’t see the Add New License area, be sure that you have the network license’s Host name field set to localhost.

  3. Configure your license in one of the following ways, then click Save:
    • For a network license, select Network, specify the name and port of your License Server, then specify which of the available license features you want to enable. A check mark indicates that a license feature is being requested. Blue indicates that it is available. Gray indicates that it is not available. White indicates that it is not being requested. For example, the following example shows a setup that is licensed for everything except API testing:

    • For a local (machine-locked) license, select Local, then paste your license license key into the Password field. The features will display enabled features in black and unavailable features in gray. For example, the following example shows a setup that is licensed for everything except API testing:

  4. Validate your database configuration as follows:

    1. Choose Administration> Database Configuration.
    2. Check the default settings. If you installed MySQL on the same machine as CTP, the default settings should already be correct.
    3. If needed, modify these settings, then click Test Connection to verify that the settings are correct. See notes below for tips on configuring HyperSQL and JDBC Drivers.
  5. (Optional) Configure user settings as described in Defining Users and Permissions. If security and users are not configured, users will not be required to log in.  

You can now create systems, components, and instances, as well as link your Virtualize Server to CTP. 

HyperSQL Notes

If you are using the embedded HyperSQL database (rather than a separately-installed MySQL or Oracle database):

  1. Set Type to HyperSQL.
  2. Enter a path where the database files should be saved on the host that runs Apache Tomcat.  Prepend a forward slash ‘/’ to make the path absolute in the file system.  
  3. If the database files do not yet exist, click the Create Database button to create a complete HyperSQL database.

JDBC Driver Notes

CTP does not ship with JDBC driver libraries for MySQL or Oracle.  The Database Configuration page will instruct you to copy a JDBC connector jar file to the WEB-INF/lib/ folder on the application server.

For example, with MySQL download mysql-connector-java-<version>.jar from and copy it to the C:\Program Files\Apache\Tomcat\<version>\webapps\em\WEB-INF\lib folder.

For Oracle databases, copy the ojdbc jar from to the same WEB-INF/lib/ folder.


  • No labels