Overview of installing the Jazz Team Server on IBM i

The Jazz™ Team Server is packaged for IBM® i as a DVD for IBM i or PC installation, or as an electronic image via Passport Advantage® download.

To purchase and download the Jazz Team Server packages, go to the Passport Advantage web site at

http://www.ibm.com/support/docview.wss?rs=727&uid=swg24020826.

Note: By default, Jazz Team Server is installed with a trial license. You can convert a trial licence to a permanent license by downloading the Server Activation Key from the Passport Advantage Web site. For more information, see the licensing considerations in Completing the installation on IBM i.

For detailed step-by-step installation instructions, follow the links below. The procedures vary slightly, depending on file names and media type. For a new installation, start with Installing the Build System Toolkit on IBM i and complete all steps in that section. Continue withInstalling Jazz Team Server on IBM i. To update from Version 2.0 to Version 2.0.0.2, continue with i_s_ptf_install_overview.html. Then proceed with Configuring your installation on IBM i.

Here is an overview of the installation sequence for a new installation using WebSphere® Application Server V6.1. For WebSphere Application Server V7.0, the steps are the same only the paths are slightly different.
  1. Restore Rational Team Concert 2.0 License Program.
  2. Edit teamserver.properties and replace jazzDBuser with your user ID. Your user ID must have the authority to create and write to a library on the system.
  3. Replace jazzDBpswd with your password.
    Note: Do not modify the entry 
    password={password}
  4. Create Group profiles with names such as JAZZADMINS, JAZZDWADMS, JAZZGUESTS, JAZZUSERS and JAZZPROJECTADMINS, for example using command 
    crtusrprf usrprf(JAZZADMINS) password(*none) grpprf(*none) 
		text('Group profile for JAZZADMINS')
  5. Add your user ID to the JAZZADMINS group, for example using command 
    chgusrprf usrprf(yourUserID) grpprf(JAZZADMINS)
  6. Start a Qshell session and run the following commands in order:
    1. cd <JazzInstallDirectory>/jazz/server
    2. ./repotools.qsh -createTables
    3. cd /QIBM/ProdData/WebSphere/AppServer/v61/Base/bin
    4. manageProfiles -create -profileName <yourWASInstanceName>
    5. cd /QIBM/UserData/websphere/AppServer/v61/Base/profiles/<yourWASInstanceName>/bin
    6. ./startServer and record your WebSphere Application Server port number for later use.
  7. Open <InstallDirectory>/jazz/server/script_py/RTCi_JVM.qsh and replace #Replace_ME with /QIBM/UserData/WebSphere/AppServer/V61/Base/profiles/<yourWASInstanceName>/bin
  8. In the Qshell session, run the following commands in order:
    1. cd <JazzInstallDirectory>/jazz/server/script_py
    2. Log on to the WebSphere Application Server Integrated Solutions console at the following URL: http://<yourServerHostName>:<yourWASAdminPortNumber>/ibm/console expand Environment, select WebSphere Variables, click the right arrow to go to Page: 2 of 2 and record the value fields of WAS_CELL_NAME and WAS_SERVER_NAME.
    3. Navigate to <JazzInstallDirectory>/jazz/server/script_py and run ./RTCI_JVM.qsh to reset Java™ Virtual Machine parameters using the recorded values for WAS_CELL_NAME and WAS_SERVER_NAME.
    4. cd /QIBM/UserData/WebSphere/AppServer/v61/base/profiles/<yourWASInstanceName>/bin
    5. To set up IBM i authentication, run the ./wsadmin command and perform the next 2 steps.
    6. securityon <yourUserID> <yourPassword>. This UserID will be used to access the WebSphere Application Server Integrated Solutions console.
    7. quit
    8. ./stopServer
    9. ./startServer
  9. Deploy the Jazz.war file by following the steps in Part 3: Installing the Jazz Team Server web archive file .
  10. Expand Servers, click Application, <yourWASInstanceName> and then Ports. Record the port for WC_defaulthost_secure which is <yourJazzServerPortNumber>.
  11. Launch the Jazz server admin page at this URL:

    https://<yourServerHostName>:<yourJazzServerPortNumber>/jazz/admin

    Log in with <yourUserID> and verify that the Server Status summary does not display any error messages and J9VM is listed as the Server JVM.
  12. Click License Key Management and upload Server Activation Kit and Client Access License Activation key(Contributor or Developer).
  13. On IBM i, add user profiles to the groups (JAZZADMINS, JAZZDWADMS, JAZZGUESTS, JAZZUSERS, or JAZZPROJECTADMINS).
  14. On the Jazz server admin page, assign the appropriate client access licenses to the user profiles.

Feedback