Installation planning worksheet for the Rational® Team Concert Jazz Team Server

This worksheet helps you plan a successful installation and choose your custom configuration options.

By default, the Jazz™ Team Server is configured to work without additional configuration for entry level use only. To install Jazz Team Server in a production environment, consider upgrading to one of the supported databases. Use this planning worksheet to guide you through your installation and configuration decisions and details. You can also use the interactive installation guide to get information about your installation scenarios.

The following table lists the choices and information you might need to provide during the installation and setup process. This table helps in filling out forms while installing and setting up your server.

Table 1. Installation planning worksheet
Determine your needs and configuration details Installation considerations and some example answers
How many Client Access Licenses do you need?
Note: Each user needs to be assigned a Client Access License in order to perform certain functions within Rational Team Concert. See ../../com.ibm.team.concert.doc/topics/c_rtc-editions.html#c_rtc-editions__cals for a listing of actions allowed for each Client Access License type. To Configure CALs for each user see Managing client access licenses
  • Contributor
  • Developer
  • Build System
  • ClearCase® Synchronizer
  • ClearQuest® Synchronizer
Verify your server environment is supported.
Record the server information
  • Hostname: jazzserver.example.com
  • IP address: 192.168.1.1
  • Platform: Linux RHEL 5

Choose an application server.

The Jazz Team Server includes Apache Tomcat as the default application server. If you already have Apache Tomcat installed, the Jazz Team Server can be configured to run in your existing environment.

The Jazz Team Server can also be configured to run with WebSphere Application Server. IBM WebSphere Application Server version 7.0 is bundled with Jazz Team Server.

Note: The only application server supported on IBM® i is WebSphere® Application Server. You cannot choose another application server.
Note: This information does not apply to IBM i.
Choose an application server:
  • Apache Tomcat (included)
  • IBM WebSphere Application Server
If you are installing Jazz Team Server to use with IBM WebSphere Application Server, record the following information:
  • Web application directory:
    • Windows: Program Files\IBM\JazzTeamServer\server (default)
    • Linux: /opt/IBM/JazzTeamServer/server (default)
If the default ports conflict with ports that are already in use, list the ports you use instead.
  • http port: 9080 (default)
  • https port: 9443 (default)

Choose a database and connection type.

The following databases are supported:
  • Derby
  • DB2
  • Oracle
  • SQL Server
Note: Although a Derby database is included in the default configuration and requires no installation, this database cannot support more than 10 users. If you want to support more than 10 users and do not have access to an existing DB2, Oracle, or SQL Server database, install the bundled DB2 database.
Note: The only database supported on IBM i is DB2 for i, which is already part of the operating system. You cannot choose another database.
Note: This information does not apply to IBM i.
Database connection type:
  • JDBC
    • JDBC Password: db2admin
    • JDBC Location: //localhost:50000/JAZZ:fullyMaterializeLobData=false (default)
    • User name: db2admin
  • J2EE
    • J2EE Datasource: jdbc/mydatasource
Database location:
  • Database port: 50000
    Tip: In the DB2 Command Window, run the command db2 get dbm cfg, then find the line that contains SVCENAME, which indicates the DB2 port name or number. If this command displays a number, use it as the port number (in place of 50000 in the example above). If the command returns a non-numeric name, determine what port number was assigned for this name and use that port number. On Linux, the file /etc/services contains the mapping between port names and numbers, and on Windows, the file C:\windows\system32\drivers\etc\services contains the mapping. For more information, ask your database administrator or consult the database documentation.
    Tip: If you are installing DB2®, accepting the defaults during the installation simplifies the Jazz Team Server configuration.
How do you want to manage the users?
Identity management option:
  • Apache Tomcat user database realm (not applicable to IBM i)
    • User ID: username
    • Name: Full Name
    • E-mail Address: username@example.com
  • LDAP
    • LDAP Registry Location: ldap://ldap.example.com:389
    • User Name: username
    • Password: SecretPassword
    • Base User DN: o=[company],l=[your city],c=[your country]
    • User Property Names Mapping: userId=mail,name=cn,emailAddress=mail
    • Base Group DN: ou=memberlist,ou=yourgroups,o=example.com
    • Jazz to LDAP Group Mapping: JazzAdmins= YourGroupA, JazzUsers= YourGroupB, JazzDWAdmins= YourGroupC, JazzGuests= YourGroupD, JazzProjectAdmins= YourGroupE
    • Group Name Property: cn
    • Group Member Property: uniquemember
  • Non-LDAP custom realm
    • User ID: username
    • Name: Full Name
    • User roles: JazzAdmins, JazzUsers, JazzDWAdmins, JazzGuests JazzProjectAdmins
      Note: You need to set up groups that can be mapped to the Jazz J2EE security roles.

Optional: Do you want to enable e-mail notification?

SMTP Server details
  • SMTP Server: smtp.example.com
  • SMTP Username: EmailUserName
  • SMTP Password: SecretPassword
  • Mail From Address: you@example.com
  • Mail From Name: Your Mail Name
  • SMTP Reply Address: from@example.com
  • SMTP Server Port: 25
  • Use STARTTLS: True or False
Do you plan to enable the e-mail whitelist to restrict e-mail notifications? For example, *@example.com only allows e-mails to your company e-mail addresses.

Optional: Do you want to enable the Jabber chat server?
Jabber Server details
  • Server URL: jabberserver.example.com
  • Port: 5222 or 5223
Verify that your client environment is supported.
 
Do you want to use the ClearCase Synchronizer or ClearQuest Synchronizer?
 
Latest entries in the jazz.net library on installation
Feedback