Configuring the WebSphere Application Server

This topic describes how to set up the Jazz Team Server for System z to work with the WebSphere Application Server on z/OS.

Before you begin
Before you perform this task, make sure you have done the following:
About this task
This configuration assumes that you are installing the Jazz Team Server for System z on the same machine as the WebSphere Application Server. Also, this topic does not list the steps for configuring the WebSphere authentication on SSL. For detailed information about the various authentication and encryption options for WebSphere, visit the WebSphere Information Center at http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jspand search Securing applications and their environment.
Note: You must register as a Jazz.net user before you can visit the WebSphere Information Center. Go to http://jazz.net.

Perform the following steps to deploy the Jazz Team Server for System z on the WebSphere Application Server. Each step is detailed below in its own task.

  1. Define application server JVM custom properties.
  2. Deploy the jazz.war file and restart the application server.

Defining application server JVM custom properties

About this task
Note:
  • There might be minor differences in the WebSphere administrative console depending on your version of the WebSphere Application Server.
  • Substitute @confPath@ with your Jazz Team Server for System z configuration directory as determined when you ran the BLZCPDIR sample job.
  1. Select Servers > Application Servers.
  2. Select server1.
  3. Select Java and Process Management > Process Definition > Servant.
  4. Select Java Virtual Machine.
  5. Add the value 100 to the Initial Heap.
  6. Add the value 1000 to the Maximum Heap Size.
  7. Click Apply.
  8. Click Logging and Tracing.
  9. Click Change Log Detail Levels. The Jazz Team Server for System z uses the BIRT reporting engine. To prevent BIRT informational entries from being written to the WebSphere log file, set the logging level to Severe for the org.eclipse.birt.* packages.
  10. Click Apply.
  11. SelectCustom Properties.
  12. Add the following properties by clicking New. Click OK after you add each one.
    Name
    java.awt.headless; value = true
    Name
    org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin; value = true
    Name
    JAZZ_HOME ; value: file:///@confPath@
    Name
    DB2Z_JDBC; value: /@db2PathPrefix@/db2910_jdbc/classes
    Note: Replace @db2PathPrefix@ with the path to the DB2 V9 JDBC license and JDBC jar files on your system. These files are named db2jcc_license_cisuz.jar and db2jcc.jar and are located by default at /usr/lpp/db2910_jdbc/classes.
  13. Select Save directly to the master configuration.

Deploying the jazz.war file and restarting the WebSphere Application Server

  1. From the WebSphere Application Server administrative console, select Applications > Install New Application.
  2. Under Path to new Application, select Remote file system.
  3. Under Full path, browse to @pathPrefix@/usr/lpp/jazz/v2.0/server/tomcat/webapps/jazz.war, where @pathPrefix@ is any prefix you specified when you installed the SMP/E.
  4. Set the context root to /jazz.
  5. Click Next, then continue with the remaining Install New Application steps as prompted by that editor.
  6. Click Finish.
  7. Select Save directly to the master configuration.
  8. Restart the application server.
  9. Check the servant logs for errors.
What to do next
After you start the server, review this topic: RTCz: Running the setup wizard
For more information about configuring the WebSphere Application Server, visit the following sites: