Setting up a Tomcat server for Rational® Engineering Lifecycle Manager

Deploying and starting the Jazz™ Team Server begins with the selection of the application server, which hosts the Jazz Team Server and its applications.

About this task

Deploying and starting the Jazz Team Server begins with the selection of the application server, which hosts the Jazz Team Server and its applications.

If you plan to use the included Apache Tomcat application server as your Jazz Team Server hosting environment, click the Deploying and starting the Apache Tomcat server link.

If you plan to use the IBM® WebSphere® Application Service as your hosting environment, click Deploying and starting WebSphere Application Server link.

Resolving an error that occurs when starting the RM server in headless mode on Linux. The RM application includes a converter that provides visual rendering of graphical artifacts, such as business process diagrams, use case diagrams, parts, sketches, storyboards and screenflows. The converter runs on the server. When starting the RM server in headless (console) mode on Linux, the action silently fails and a CRRRW8010E error occurs. If this happens, you must terminate the Java™ process and take remedial action before you can successfully launch the server. For more information, see the following wiki page: https://jazz.net/wiki/bin/view/Main/RRCConverterTroubleshooting.

Running in Apache Tomcat as a Windows service (64-bit)

To run Jazz Team Server as a service on a 64-bit computer, you must configure the 64-bit version of Tomcat that ships with the Jazz Team Server.

Before you begin

Tip: To avoid problems, do not use spaces in file paths. For example, for the Program Files directory you can use PROGRA~1.
If you are using Derby as the database for your Jazz Repository, edit the teamserver.properties file for each application to make the DB locations an absolute path. Substitute the app name variable with the appropriate application directory name, for example, jts, ccm, qm. In the examples below, JazzInstallDir refers to the location where Jazz Team Server is installed.
  1. Open the JazzInstallDir\server\conf\app name\teamserver.properties file.
  2. Change the com.ibm.team.repository.db.jdbc.location=conf/app name/derby/repositoryDB entry to com.ibm.team.repository.db.jdbc.location=C:/JazzInstallDir/server/conf/app name/derby/repositoryDB. Note the forward slash (/) in the path.
  3. Also change the com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/conf/jts/derby/warehouseDB entry to com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527/C:/JazzInstallDir/server/conf/jts/derby/warehouseDB for the applications. And com.ibm.team.datawarehouse.db.jdbc.location=conf/jts/derby/warehouseDB entry to com.ibm.team.datawarehouse.db.jdbc.location=C:/JazzInstallDir/server/conf/jts/derby/warehouseDB for JTS. Note the forward slash (/) in the path.
In addition to editing the teamserver.properties, you must also edit the log4j.properties file to make the log file path name absolute. Substitute the app name variable with the appropriate application directory names, for example, jts, ccm, qm, rm, admin. Substitute app name.log and app name-etl.log variables with each appropriate application log file name, for example, jts.log, ccm.log, qm.log, rm.log, admin.log and jts-etl.log, ccm-etl.log, qm-etl.log(there is no *-etl.log for admin and rm):
  1. Open the JazzInstallDir\server\conf\app name\log4j.propertiesfile.
  2. Change the log4j.appender.file.File=logs/appName.log entry to log4j.appender.file.File=C:/JazzInstallDir/server/logs/appName.log. Note the forward slash (/) in the path.
  3. Change the log4j.appender.etl.File=logs/appName-etl.log entry to log4j.appender.etl.File=C:/JazzInstallDir/server/logs/appName-etl.log. Note the forward slash (/) in the path.
Note: If you skip this step and do not provide paths for the log files, the log files will be written to the default Windows directory. For example, on Windows 7 the log directory is C:\Windows\System32\LogFiles.

Verify that the service is not installed. If the service is installed, uninstall the service, and then restart the computer. Then install the new service.

Procedure

  1. Set the CATALINA_HOME variable by following these steps:
    1. From Windows Control Panel, open the System Properties window.
    2. Click the Advanced tab, then click Environment Variables.
    3. Under System variables, click New.
    4. In Variable name enter CATALINA_HOME and in Variable value enter C:\JazzInstallDir\server\tomcat.
  2. Restart your system for the variable to take effect.
  3. Open a command prompt and install the new 64-bit service by changing to the JazzInstallDir\server\tomcat\bin directory, and typing this command:

    service.bat install tomcat7.

    Note: On Windows operating systems that have User Account Control (UAC) such as Windows 7, the command shell must be run as an administrator.
  4. Run the JazzInstallDir\server\tomcat\bin\tomcat7w.exe program to configure the service.
  5. Click the Java tab, and clear the Use default check box.
  6. Add the following path to the Java Virtual Machine. You can also click the ellipsis icon to browse for the jvm.dll file.
    JazzInstallDir\server\jre\bin\j9vm\jvm.dll
  7. Add the following lines at the end of the Java Options text field
    Note: The path to -DJAZZ_HOME and -Dlog4j.configuration must be a URL path. Note the three forward slashes (///) after "file:" and forward slashes in the path. The path to tempDir must be an absolute path.
    -DJAZZ_HOME=file:///C:/JazzInstallDir/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=C:\JazzInstallDir\server\tomcat\temp
    -Djazz.connector.sslProtocol=SSL_TLS
    -Djazz.connector.algorithm=IbmX509
    -Dlog4j.configuration=file:///C:/JazzInstallDir/server/conf/startup_log4j.properties
    -Xmx4g
    -Xms4g
    -Xgcpolicy:gencon
    -Xcompressedrefs 
    If your Jazz Team Server is installed on a Windows platform, but you are using the DB2® for z/OS® database server, add this line substituting the path with the driver location.
    Note: The path to the driver location must be a file path and note the forward slash.
    -DDB2Z_JDBC=D:/JazzInstallDir/server/db2z
    If you are using the Oracle database, add this line substituting the path with the driver location.
    Note: The path to the driver location must be a file path.
    -DORACLE_JDBC_DRIVER_FILE=C:\OJDBCLocation\ojdbc6.jar
    If you are using the SQL Server database, add this line substituting the path with the driver location.
    Note: The path to the driver location must be a file path.
    -DSQLSERVER_JDBC_DRIVER_FILE=C:\SQLJDBCLocation\sqljdbc4.jar
  8. In Maximum memory pool, change the pool size to 4000.
  9. On the Startup and Shutdown tabs, make sure that jvm is selected for the Mode setting.
  10. Click the General tab and change the Startup type to Automatic to start the service automatically when Windows starts.
  11. After the service starts, verify that the server is running by logging on to the server from your browser.

Feedback