In this section:

About the Plugin

The Environment Manager Test Type allows you to perform Environment Manager provisioning actions from within HP Quality Center. This test type can be included in a test plan to perform Environment Manager provisioning actions, such as:

• Setting up your testing environment prior to testing
• Performing environment maintenance for the Application Under Test during testing
• Tearing down your testing environment to free up limited resources when testing completes

Server-side Installation

The plugin can be installed on the following versions of HP ALM Quality Center.

Quality Center 11

1. Extract the contents of environment_mananger_test_type.zip to the <HP Deployment Location>\application\20qcbin.war folder. Refer to the HP ALM Installation Guide for the HP Deployment Location.

   Windows Server 2003 Installation

   The installation directory for on Windows Server 2003 is C:\Documents and Settings\All Users\Application Data\HP\ALM

2. Run the HP Server Deployment Wizard, which redeploys Quality Center with the necessary test type updates.
3. Using Internet Explorer with Administrator privileges, log into Quality Center as Site Administration.
4. Choose Tools> Update Test Types to make the custom test type available for use in the active projects.
5. Log out of Quality Center.

Quality Center 10

1. Create a temporary scratch directory on the Quality Center server machine. You can create the scratch directory in the Quality Center application directory (for example, C:\Program Files\HP\Quality Center\application\my_scratch_files).
2. Open Quality Center’s jboss\server\default\deploy directory and copy the 20qcbin.war file to your scratch directory.
3. Unzip environment_manager_test_type.zip into your scratch directory. Two folders are created: CustomTestTypes and Extensions.
4. Update 20wcbin.war with CustomTestTypes and Extensions. You can do this using the jar command from the Java JDK. For example:
jar uvf 20qcbin.war CustomTestTypes Extensions
   Because war files use the zip file format, a zip application could also be used to update 20qcbin.war.
5. Make a backup copy of the original 20qcbin.war file in the jboss\server\default\deploy directory. You could make a copy the original file rename it to 20qcbin.war.bak.
6. Copy the new 20qcbin.war file from your scratch directory to the jboss\server\default\deploy directory.
7. Restart Quality Center. In most cases, you could the Windows Services console to restart Quality Center (i.e., Start> Administrative Tools> Services).
8. Add Parasoft Environment Manager to the list of test type options.
   1. Open a browser and enter the URL http://<server:port>/qcbin/start_a.htm 
   2. Click the HP Quality Center link and log into Quality Center. 
   3. Choose Tools> Customize and click Project Entities. 
   4. Expand Test> System Fields. 
   5. Choose Type and click Goto List. 
   6. Click New Item and enter Parasoft Environment Manager for the item name. 
   7. Click OK and close the Project Lists box.
   8. Click Save and log out of Quality Center. 

Client-side Installation

The Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) must be installed on any client machines that you want to use the Parasoft Environment Manager test type. The Parasoft Environment Manager test type will not function without the Visual C++ libraries from Microsoft. You can download the installer from the Microsoft Download Center at http://www.microsoft.com/en-us/download/details.aspx?id=5582.

Additionally, each client machine should be configured to permit Parasoft software to execute.

1. Re-register each client that uses QC:
   1. Run Internet Explorer with Administrator privileges.
   2. Navigate to http://<HP QC server>:<HP QC port>/qcbin/start_a.jsp?common=true 

   3. Install Parasoft-branded add-ins when prompted. 
      
      
      
      

      Responding to Security Warnings

      If the dialogs ask whether to run software from Parasoft, choose the Always run software from Parasoft Corporation option. If the dialogs refer to "unknown publisher" instead of "Parasoft Corporation"

      1. Close Internet Explorer and install the Thawte Code Signing Intermediate CA: https://search.thawte.com/support/ssl-digital-certificates/index?page=content&actp=CROSSLINK&id=AR1493
      2. Restart Internet Explorer and log in again.
   4. Close the browser after client registration is complete.
2. Open Internet Explorer again and navigate to the client login (http://<server:port>/qcbin/start_a.htm).
3. Click the HP Quality Center link. Internet Explorer will open several Security Warning dialogs.

4. Respond to the dialogs as described in the above box.

Clicking Run without enabling the Always run software from Parasoft Corporation option is sufficient to enable the integration—but Internet Explorer will continue to open these security warning dialogs every time that you log in to Quality Center.

Using the Environment Manager Test Type

Quality Center 11

1. Log into Quality Center and choose the Test Plan module. The Test Plan module allows you to set up your automated test and custom scripts for Quality Center.
2. Choose the Test Plan folder for your Environment Manager Test Type instance and click New Test from the toolbar.
   
   
   
   
3. Enter a name for the test type instance in the Test Name field and choose Parasoft Environment Manager from the Type menu.
4. Configure the remaining optional fields and click OK.
   
   
   
   
5. Navigate to the Test Script tab and modify the controls (see Available Controls) to perform the desired provisioning action.
   
   
   
   
6. Click Save. 
7. Navigate to the Test Lab module and add the test to the desired Test Set.

Quality Center 10

Log into Quality Center and choose the Test Plan module. The Test Plan module allows you to set up your automated test and custom scripts for Quality Center.

1. In the Test Plan tree, choose Subject and click New Folder in the toolbar.
   
   
   
   
2. Enter a name for the folder and click the New Test icon in the toolbar.  
3. Choose Parasoft Environment Manager from the Test Type drop-down menu.
4. Enter a name in the Test Name field and click OK.
5. Choose the new test and open the Test Script tab.
6. Modify the test using the available controls (outlined below).

Available Controls

Using the Environment Manager Vapi-XP JavaScript

The Environment Manager Vapi-XP JavaScript is an alternative to using the Environment Manager Test Type in instances where the test type cannot be installed. The Vapi-XP JavaScript works in the same fashion as the test type–a host, port, username, and password must be defined. However, the Environment ID and Environment Instance ID to provision must be manually looked up on Environment Manger and configured in the script as there are no convenient drop down menus to make the selection. Once properly configured the provisioning results are reported exactly as they are in the test type solution.

Finding the IDs

1. Open a browser and navigate to Environment Manager (or CTP).
2. The ID is visiable in the URL.
   
   
    
3. Choose API Documentation from the help link.
   
    
    
4. Click on the GET /v2/enviroments/{environementId}/instances operation and enter the ID.
   
   
    
5. Click Try it out! and find the instance ID you want to provision in the response.
   
    

Configuring the Vapi-XP Test

1. Create a new Vapi-XP Test in HP ALM QC and set the Script Language to JavaScript.
2. Enter a Script Name and click Next >>
   
   
    
3. Enable the COM/DCOM Server Test option and click Finish.
   
   
    
4. Copy the contents of EnvironmentManager-VAPI.js contained in the ZIP distribution into the Test Script editor.
5. Configure the User Defined Fields with the Environment Manager credentials and the IDs collected previously.
   
   
    
6. Save the test script and add it to the desired Test Set in the Test Lab.