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 your WebSphere® Application Server..

Before you begin

Note:
  • Rational® Engineering Lifecycle Manager v1.x must share an application server with the Lifecycle Query Engine.
  • Rational Engineering Lifecycle Manager v4.x can share an application server with the Lifecycle Query Engine or be deployed to a different application server. However both applications must be registered to the same Jazz Team Server.

Procedure

  1. In the WebSphere Application Server admin console, select Servers > Server Types > WebSphere application servers
  2. Select the server on which you will deploy Lifecycle Query Engine
    Selecting the WebSphere server
  3. On the Configuration page, select Java and Process Management.
    Screen capture showing Java and Process Management link
  4. Select Process definition > Java Virtual Machine.
  5. Locate the Generic JVM arguments text field, and add this environment variable to the JVM startup process:
     -Dlqe.config.location=file://drive:\lqe_installation_folder\server\conf\lqe
    For example:
    • Windows:
       -Dlqe.config.location=file://C:\Program Files\IBM\JazzTeamServer\server\conf\lqe
    • Linux:
      -Dlqe.config.location=file:///opt/IBM/JazzTeamServer/server/conf/lqe
     -Dlqe.config.location=file://C:\Program Files\IBM\JazzTeamServer\server\conf\lqe
    Click Save to save your updates.
  6. Increase the default thread pool to allow for multiple users. Click Servers > Server Types > WebSphere application servers > Server1.
  7. Under Additional Properties, click Thread pools.
  8. Click WebContainer, and increase the default maximum size from 50 to 200 threads.
  9. Click Save directly to the master configuration.
  10. Install the Lifecycle Query Engine WAR file. Select Applications > Application Types > WebSphere enterprise application.
  11. Select Install.
  12. Choose the Local file system radio button, and provide the location for the lqe.war file where it was installed. For example,
    C:\Program Files\IBM\JazzTeamServer\server\tomcat\webapps\lqe.war
  13. Select Next, choose the Fast Path radio button and select + Choose to generate default bindings and mappings
    Installing the LQE into WebSphere
    Click Next.
  14. Keep all the defaults on the Installation Options page, and click Next.
  15. On the Map Modules to Servers page, specify the target scope on the server for the Lifecycle Query Engine module.
    specifying the target scope
    Click Next.
  16. Add /lqe as the context root.
    adding the context root
    Click Next.
  17. Review your selections and click Finish. You should receive a message stating Application lqe_war installed successfully
  18. Next you will modify the configuration options for the WAR file you just installed. Select Applications > Application Types > WebSphere enterprise application
  19. Select the lqe.war application.
    selecting your application in WebSphere
  20. Select Manage Modules
    Selecting to manage your modules
  21. Select lqe
  22. 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.
  23. Select the lqe.war application
    selecting your application in WebSphere
  24. Select Class loading and update detection
    class loading page
  25. 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.
  26. 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.
  27. If the LQE application has not be automatically started, select the check box for lqe.war and select Start.
    Starting your lqe.war application

Feedback