Completing the installation on IBM i

This topic describes how to complete the installation of Rational Team Concert™.

Licensing considerations

By default, Rational Team Concert on IBM® i is installed with a trial license. If you are evaluating Rational Team Concert, you can skip this section.

To convert a license from trial to permanent, download the Server Activation Key file from Passport Advantage®. In Passport Advantage, right-click the file and select Save. Install the key by performing these steps:

In a web browser, enter the URL for the Jazz™ Team Server Administrative page. For example: https://<yourHostServerName>:<yourJazzServerPortNumber>/jazz/admin.
Log in with your Jazz Team Server administrative user account.
Click Server.
In the Configuration section, click License Key Management.
In the Server Activation Key section, click Edit.
In the dialog that displays, click Browse.
Navigate to the jazz_team_server_express_p-release.jar, jazz_team_server_standard_p-release.jar, or jazz_team_server_enterprise_p-release.jar file, select it, then click Open to upload the key.
Note: If you purchased additional Rational Team Concert client licenses from Passport Advantage, download the Contributor and Developer Client Activation Key files from Passport Advantage. Install the keys by performing the steps above, except that in step 5 you must click Add in the Client Access License Types section, not the Server Access License Types section. Make sure to enter the number of Contributor or Developer licenses you have purchased.
Click Finish to save your changes.

After the server is installed, you must also consider some configuration options before continuing.

Refer to the Rational Team Concert documentation for important information about additional administrative tasks, including creating users, creating project areas and teams, configuring e-mail settings, and configuring advanced properties.
Some files contain passwords. Those files should be protected so that they are readable only by users who are authorized to know the password for the accounts. The Jazz Team Server requires that the database password is stored in <JazzInstallDirectory>/server/teamserver.properties. You can encrypt the passwords by changing any one of the advanced properties and saving the properties file. To do this:
1. Go to http://<yourServerHostName>:<yourJazzServerPortNumber>/jazz/admin.
2. Click Advanced properties on the left side.
3. Change any one of the properties and save the file. Change the property setting back to its previous value, if you do not wish to keep the new setting.
By saving the properties file, the passwords are now encrypted. When the properties file is saved, the application always makes a backup copy of the previous version in the same directory. Remove all backup properties files that contain the clear-text password, after configuring the server for the first time. You should also delete the copy of teamserver.properties, if it exists in directory /QIBM/ProdData/RTCp
If you configured the application server to use ports other than the defaults, these ports should also be configured in the Jazz Team Server configuration. These port numbers are used for composing URLs for things like feed links and item links in e-mail notifications. To update the defaults, use the Jazz Team Server administrative web interface. Click Configuration, then Advanced Properties to locate the properties below.
- com.ibm.team.repository.servlet.internal.ServletConfigurationService
  - Repository HTTPS port
- com.ibm.team.repository.service.internal.webuiInitializer. ConfigPropertyInitializer
  - URL HTTPS port
Click Edit to enable the editing of these properties, then click Save to save your changes.

Note: When using IBM i authentication, giving a user access to Jazz Team Server is a three-step process:

Create the IBM i user ID. If you are using group profiles, add the user to the group, otherwise you need to add the user mapping. See To map individual users to Jazz Team Server roles in Part 3: Installing the Jazz Team Server web archive file for more details.
Create a corresponding user in the Jazz Team Server repository.
Give the Jazz Team Server user the correct user permissions as developer or contributor.