Prerequisites

• Apache Tomcat 8 or higher installed and running
• Core CTP functionality is backwards compatible with Virtualize and/or SOAtest 9.8.3 or higher, but some tools and features require the latest version of Virtualize/SOAtest. 

Installation

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.

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.

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

   Data Modeling: Enables test data modeling functionality, such as test data visualization, sophisticated test data generation, and test data masking for sensitive information.

   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, enable the Network option and specify the name and port of your License Server. Specify which of the available license features you want to enable. 

   • For a local (machine-locked) license, enable the Local option and paste your license license key into the Password field.  
     
     
     
     

    

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 http://dev.mysql.com/downloads/connector/j/ 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 http://www.oracle.com/technetwork/database/features/jdbc/index-091264.html to the same WEB-INF/lib/ folder.