Setting up a WebSphere Application Server for the Lifecycle Query Engine

Deploying and starting the Jazz™ Team Server begins with the selection of the application server, which hosts the Jazz Team Server and its applications. Before you can deploy the Lifecycle Query Engine war files, you must set up the WebSphere® Application Server.

Before you begin

Note: If you are using Lifecycle Query Engine with Rational® Engineering Lifecycle Manager, both applications can share application server or be deployed to different application servers. However, both applications must be registered to the same Jazz Team Server.

Procedure

  1. In the WebSphere Application Server administrative console navigation, expand Servers and Server Types and click WebSphere application servers.
  2. Select the server on which you want to deploy Lifecycle Query Engine.
    Screen capture of the Application servers page where you select the server on which to deploy Lifecycle Query Engine.
  3. On the Configuration page, under Server Infrastructure, click Java and Process Management.
    Screen capture showing the Java and Process Management link
  4. Click Process definition > Java Virtual Machine.
  5. In the Generic JVM arguments field, add the following environment variable to the JVM startup process:
     -Dlqe.config.location=file://drive:\lqe_installation_folder\server\conf\lqe
    For example:
    • For Windows:
       -Dlqe.config.location=file://C:\Program Files\IBM\JazzTeamServer\server\conf\lqe
    • For Linux:
      -Dlqe.config.location=file:///opt/IBM/JazzTeamServer/server/conf/lqe
  6. Click Save.
  7. To increase the default thread pool to allow for multiple users, in the WebSphere Application Server administrative console navigation, expand Servers and Server Types and click WebSphere application servers.
  8. Under Additional Properties, click Thread pools.
  9. Click WebContainer and increase the default maximum size from 50 to 200 threads.
  10. Click Save directly to the master configuration.
  11. To install the Lifecycle Query Engine WAR file, in the WebSphere Application Server administrative console navigation, expand Applications and Application Types and click WebSphere enterprise application.
  12. Click Install.
  13. Choose the Local file system option, and provide the location where the lqe.war file was installed. For example,
    C:\Program Files\IBM\JazzTeamServer\server\tomcat\webapps\lqe.war
  14. Click Next, choose the Fast Path option, expand Choose to generate default bindings and mappings, and select the Generate Default Bindings check box.
    Installing the LQE into WebSphere
  15. Click Next.
  16. Keep all the defaults on the Installation Options page, and click Next.
  17. On the Map Modules to Servers page, specify the target scope on the server for the Lifecycle Query Engine module.
    Specifying the target scope
  18. Click Next.
  19. In the Context Root field, add /lqe.
    Adding the context root
  20. Click Next.
  21. Review your selections and click Finish. You should receive a message stating Application lqe_war installed successfully.
  22. Next, you modify the configuration options for the WAR file you just installed. Select Applications > Application Types > WebSphere enterprise application
  23. Select the lqe.war application.
    Selecting your application in WebSphere
  24. Click Manage Modules
    Selecting to manage your modules
  25. Select lqe
  26. Locate the Class loader order field and select Classes loaded with local class loader first (parent last)
    Selecting the class loader order
    Click OK and save your changes.
  27. Select the lqe.war application
    Selecting your application in WebSphere
  28. Click Class loading and update detection.
    Class loading page
  29. Find Class loader order, and select Classes loaded with local class loader first (parent last)
    Selecting the class loading order
    Select Apply, and Save directly to the master configuration.
  30. In order for the variable added in step 5 to be applied to WebSphere Application Server, the server must be restarted. Restart WebSphere Application Server.
  31. If the Lifecycle Query Engine application has not been automatically started, select the check box for lqe.war and select Start.
    Starting your lqe.war application

Feedback