Part 3: Installing the Jazz Team Server web archive file

Jazz™ Team Server is composed of a web archive file called jazz.war, along with other dependent files. The jazz.war file must be installed on your WebSphere® Application Server if you want to be able to use Jazz Team Server. Use the following procedure on the WebSphere Application Server Integrated Solutions console to install the file:

1. Use a Web browser to log on to the WebSphere Application Server Integrated Solutions console with a URL like http://<yourServerHostName>:<yourWASAdminPort>/ibm/console/. For example,

   http://<yourServerHostName>:9060/ibm/console

   If you followed the setup in Part 2, you have already enabled WebSphere Application Server security, and you will be redirected to a secure port.
2. Ensure that the WAS security setting Use available authentication data when an unprotected URI is accessed is checked. If you are using the WAS Integrated Solutions Console, you can do this by:
   1. Navigating to Security -> Secure administration, applications, and infrastructure -> Web Security - General Settings.
   2. Selecting the checkbox for Use available authentication data when an unprotected URI is accessed. Click OK to apply the changes and select Save changes to save to the master configuration.
3. Expand Applications, then click Enterprise Applications
4. On the Enterprise Applications window, click Install.
5. For Path to new application, select Remote file system.
6. Navigate to the jazz.war file at <JazzInstallDirectory>/jazz/server/jazz.war.
7. Set Context root to /jazz.
8. Under How do you want to install the application?, select Show me all installation options and parameters and click Next.
9. Complete each subsequent step, accepting all defaults until you get to Map security roles to users or groups. The security roles and levels of access defined by the Jazz Team Server include:

   JazzAdmins

   Jazz repository administrators with full read-write access

   JazzDWAdmins

   Jazz repository administrators with specific permissions to control the data warehouse on a Jazz Team Server

   JazzGuests

   Users with read-only access to the Jazz repository

   JazzUsers

   Users with regular read-write access to the Jazz repository

   JazzProjectAdmins

   Administrators of a Jazz repository with specific permissions to create and modify project areas, team areas, and process templates

   There are two options for mapping security roles. If you have many users, it is more efficient to create group profiles on IBM® i and map those groups to Jazz Team Server roles rather than mapping a large number of individual users.

   To map groups of users to Jazz Team Server roles (recommended):

   1. On IBM i, create Group Profiles using names such as JAZZADMINS, JAZZDWADMS, JAZZGUESTS, JAZZUSERS, JAZZPRJADM. (There is a ten-character limit.)
      Note: These group profile names are suggestions only. You can choose to assign any group profile name you prefer (up to ten characters in length).
      For more information about creating group profiles on IBM i, go to Frequently asked questions about installing on IBM i.
   2. Assign users to the appropriate group profiles.
   3. On the WebSphere Application Server Integrated Solutions console, use Look up groups to map those groups of users to their corresponding roles.
      1. Select JazzAdmins and click Look up groups.
      2. On the next screen, click Search, and select at least one group from the Available list and move it to Selected using >>.
         Note: The WebSphere Application Server console displays only those groups that have at least one user assigned.
      3. Repeat these steps for JazzDWAdmins, JazzUsers, and JazzGuests, JazzProjectAdmins.

   To map individual users to Jazz Team Server roles:

   1. Select JazzAdmins and click Look up users.
   2. On the next screen, click Search, and select at least one user ID from the Available list and move it to Selected using >>.
   3. Repeat these steps for JazzDWAdmins, JazzUsers, and JazzGuests, JazzProjectAdmins.

   Note: This setup is different if you use LDAP security. The users and groups in this case would correspond to user IDs or groups on your LDAP server. For more information on LDAP security and Jazz Team Server, see Managing users with Lightweight Directory Access Protocol (LDAP).
10. Click Finish, then Save directly to the master configuration. When the save is complete, a red x is displayed under Application status for jazz.war.
11. Select the jazz.war.radio button, and click Start.

The jazz.war file is now installed. At this point, you should re-start the WebSphere Application Server by running the ./stopServer command followed by the ./startServer command when the stop command completes.