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 Rational® Engineering Lifecycle
Manager application
war files, you must set up your WebSphere® Application
Server.
Before you begin
Important: If you are upgrading from an older
product version, follow the upgrading instructions to configure your
application server.
Ensure you have completed the following
tasks:
- The database is created. If you use the default Derby database
for evaluation purposes, ensure the location to the database in the teamserver.properties file
is an absolute path.
- Navigate to JazzInstallDir/server/conf/relm where JazzInstallDir is
where you installed Jazz Team
Server.
- Open teamserver.properties for editing.
- Locate the Derby database at com.ibm.team.repository.db.jdbc.location=conf/relm/derby/repositoryDB,
and change the location with an absolute path. For example, com.ibm.team.repository.db.jdbc.location=C:/IBM/JazzTeamServer/server/conf/relm/derby/repositoryDB.
- The Java™ 2 Security option
must be turned off. If this option is turned on in WebSphere Application Server, the web application
will not start.
- Click .
- Under Java 2 security, clear
the check box for Use Java 2
security to restrict application access to local resources.
- Ensure that the Enable administrative security and Enable
application security check boxes are selected.
- Ensure that the Use available authentication data when an unprotected
URI is accessed application server security setting is selected.
If you are using the Integrated Solutions Console for the server,
use the following steps to verify this setting:
- Click .
- Click the Use available authentication data when an
unprotected URI is accessed check box.
- Click OK and Save directly to
the master configuration.
- To ensure that the LTPA cookies are secure, enable the Requires
SSL setting:
- In WebSphere Integrated
Solutions Console, click Security > Global security > Web
and SIP security > Single sign-on (SSO).
- Select the Requires SSL check box.
- Click OK and Save directly to
the master configuration.
- There is a WebSphere Application
Server fix that is essential to ensuring consistent user authentication
between applications. APAR PM75942 describes the issue, and provides
a pointer to fix packs V8.0.0.8 and V8.5.5.2, which resolve the problem.
The Jazz web interface
requires that authentication be configured in order to perform authorization
and personalize the application.
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.
About this task
This document does not provide details for
configuring WebSphere authentication
or SSL, which is a complex topic. Detailed information about the various
authentication and encryption options is covered in the WebSphere Application Server product documentation.
For more information, go to the
WebSphere product
documentation and use this phrase in search:
Securing applications
and their environment.
What to do next
- Deploy your application files.
- On the WebSphere Application
Server administrative console, go to .
- In the Preparing for application installation wizard,
under Path to the new application, select Local
file system and specify the full path to your application
file. In the Install New Application wizard,
set the application context root, and follow all the installation
steps. On the Install New Application summary
page, verify your selected installation options, an click Finish.
Table 4. Application files and values| Application |
Full Path Value |
Context Root |
| Rational Engineering Lifecycle
Manager |
RELM_install_dir/server/webapps/relm.war |
/relm |
| Rational Engineering Lifecycle
Manager documentation |
RELM_install_dir/server/webapps/relmhelp.war |
/relmhelp |
| Configuration Management application |
RELM_install_dir/server/webapps/vvc.war |
/vvc |
| Jazz
Reporting Service |
RELM_install_dir/server/webapps/rs.war |
/rs |
- Click Save directly to the master configuration.
- Add the Jazz
Reporting Service library
reference.
- Go to , and click rs_war in the application
list.
- In the Reference section, click Shared
library references.
- Select the check box next to rs_war, and
click Reference shared libraries.
- Select JRS Shared Library, and click the
right arrow.
- Click OK. Then, click OK again
to save your settings to the master configuration.
- Ensure that Jazz
Reporting Service class
loading order is configured correctly.
- Go to , and click rs_war in the application
list.
- In the Detail Properties section, click Class
loading and update detection.
- In the Class loader order section, select Classes
loaded with local class loader first (parent last).
- Click OK, and Save to master
configuration.
- On the Enterprise Applications page, select
the applications that you have just deployed to WebSphere Application Server and select Start.
Note: This document does not provide details for configuring WebSphere authentication or
SSL, which is a complex topic. Detailed information about the various
authentication and encryption options is covered in the WebSphere Application Server product documentation.
For more information, go to the
WebSphere product
documentation and use this phrase in search:
Securing applications
and their environment.