Deploying on WebSphere Application Server

Use these instructions to deploy the adapter application on WebSphere® from the console.

Before you begin

During the installation, by default, the web application file (hpqm.war) is copied into the HPInstallDir/server/webapps directory.

About this task

Important: On UNIX, if WebSphere Application Server is installed in a non-root environment, the user who deploys the adapter application must have read and write access to the installation directory and all subdirectories.
In the following command-line examples, the WASInstallDir variable represents the location where WebSphere Application Server is installed on your server.
  • For Windows The default value for the WebSphere Application Server installation directory is as follows:
    C:\Program Files\IBM\WebSphere\AppServer
    You can restart the server with these commands on Windows:
    cd WASInstallDir\bin 
    stopserver.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
    startserver.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}]
  • For Linux. The default value for the WebSphere Application Server installation directory is as follows:
    /opt/IBM/WebSphere/Appserver
    You can restart the server with these commands on UNIX:
    cd WASInstallDir/bin 
    ./stopserver.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
    ./startserver.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}]

You set up the application server to host the HP adapter web application from the console, by installing the adapter web application on WebSphere Application Server.

Important: To deploy the HP adapter web application on a WebSphere Application Server, V8.0, you must set the class-loader. The class-loader policy is set to single class loader for the application. The class-loader mode is set to classes loaded with local class loader first (parent last). For more information about class loaders, see Class loading.

Procedure

  1. From the Admin console, click Applications > Application Types > WebSphere enterprise applications.
  2. Click Install.
  3. Under Full path, enter the path to the hpqm.war web application file. If you did not install Apache Tomcat when you installed the HP adapter, the directory that contains the web application is the one that you defined during the installation. The default directory is HPInstallDir/server/webapps/hpqm.war
  4. Select Fast Path - Prompt only when additional information is required and click Next.
  5. Click Next to accept the default options until you reach the Map context roots for web modules page.
  6. In the Map context roots for web modules, set Context root to /hpqm and click Next.
  7. Click Finish.
  8. Verify that the hpqm_war application was installed correctly and click Save directly to the master configuration. The Preparing for the application installation page displays again.
  9. Click Applications > Application Types > Websphere enterprise applications to exit the page and to see your application in the list of installed applications. If you are not deploying the Rational Adapter for HP ALM web application on a WebSphere Application Server, V8.0, you can skip the next step.
  10. Set the class-loader policy to single class loader for application and class-loader mode to classes loaded with local class loader first (parent last) for this application.
    1. Click Applications > Application Types > Websphere enterprise applications > hpqm_war > Class loading and update to access the settings page for an application class loader.
    2. Select Classes loaded for local class loader first (parent last) for the class loader order for the application.
    3. Select Single class loader for application for the WAR class loader policy.
    4. Click OK.
    5. Save the changes to the administrative configuration.
  11. Next, click Start. A green arrow indicates that the application started.
  12. Point your browser to https://[fully qualified hostname]:[port]/hpqm. Log in to the Rational® Adapter for HP ALM server by using an account that has administrator privileges.
    Tip: You can find the port number used for your application server from the administrative console. Click Servers > Server Types > WebSphere Application Servers > server_ name > Ports. Look for the value for the port name WC_defaulthost if you are using an HTTP Transport Port or the value for the port name WC_defaulthost_secure if you are using an HTTPS Transport Secure Port.

What to do next

Set up properties for the adapter, see Setting up properties for the HP adapter.

Feedback