Running the setup wizard

Running the setup wizard verifies that the server is operating properly and guides you through the steps to configure the server.

About this task

To verify that the Jazz™ Team Server is connecting to the database, look at the server log or console output. The connection and database information is echoed on its first access. The directory JazzInstallDir/server/logs is used for the server log files.

This procedure assumes your server is available using the hostname localhost and the default ports 9443. If necessary, replace localhost with your server hostname and replace the port 9443.

Procedure

Start the setup wizard to configure your server. Use the URL https://localhost:9443/jazz/setup.

On Apache Tomcat application server, login with the default ADMIN/ADMIN username and password. Both username and password are case sensitive.

For WebSphere application server and LDAP, you must properly setup user mappings so that WAS user registry users or LDAP users are mapped to corresponding Jazz groups (for example, JazzAdmins, JazzUsers, and so on). After the users are properly mapped, you can login to Jazz Team Server using your WAS or LDAP account. For more information, see Managing users with Lightweight Directory Access Protocol (LDAP).

Choose a setup path. The setup wizard has two main paths.

Fast Path Setup (ONLY for default Tomcat/Derby configuration)
Click for instructions
1. The configuration wizard will skip to step 5.
2. In step 5, Setup User Registry, provide the following information.
  1. In step 5.1, select the Tomcat User Database user registry.
  2. In step 5.2, enter the User ID, Name, Password, and E-mail Address of the individual who will have administrator privileges for the server.
  3. In step 5.3, check the box to disable default ADMIN access.
  4. In step 5.4, assign an author license to the administrator. Click Next.
3. You should now have returned to step 2 on the Jazz Team Server Setup page. Click Configure.
4. Wait until you see the message "Congratulations! The setup has completed successfully." Then, click Next.
Custom Setup (Recommended)
Note: By default, the server is configured to use Derby as the database. To use another database, such as DB2, select the custom setup path and complete Step 2: Configure Database. If you have not created your database tables, after testing the connection you will be prompted to create the database tables. If you choose the Fast Path Setup and your database tables are not created, you will be prompted to go to Step 2 and create database tables.
Click for instructions
1. In step 2, Configure Database, enter the information that will be used to configure your database.
  1. Enter the following information in Step 2.1: Configure Database Vendor and Connection Type
    In step 2.1, select your database vendor: (1) DB2 or (2) Oracle.
    
    In step 2.2, select JDBC as the Connection Type
  2. Enter the following information in Step 2.2: Configure Database Connection Properties
    JDBC Password: Enter the password for the JDBC database.
    
    JDBC location:
    If you are using a DB2 database
    Use the following syntax
    //servername:db2port/dbname:user=db2user;password={password};
    ONLY replace servername:db2port, dbname, and db2user with information relevant to your DB2 setup. Retain all other values as is, including {password} for the JDBC password.
    
    If you are using an Oracle database
    Use the following syntax
    thin:dbuser/{password}@//servername:1521/ORCL
    ONLY replace dbuser and servername with information relevant to your Oracle setup. Retain all other values as is, including {password} for the JDBC password.
  3. Click Test Connection; when this is successful, click Next.
2. In step 3, Enable E-mail Notification, set the e-mail configuration properties. Click Test Connection; when this is successful, click Next.
3. Step 4, Configure Repository's Public URL, is essential when your repository server is known by multiple hostnames or domains on your network. If you choose to enter a URL in this field, ensure that it is in the format https://[hostname or IP]:9443/jazz and click Next.
4. In step 5, Setup User Registry, provide the following information.
  1. In step 5.1, select the type of user registry you will use: (1) LDAP or (2) Non-LDAP External Registry.
  2. In step 5.2, enter the properties you used to configure your LDAP server to set up communication between the Jazz server and the LDAP server.
  3. Click Test Connection; when this is successful, click Next.
5. You should now have returned to step 2 on the Jazz Team Server Setup page. Click Configure.
6. Wait until you see the message "Congratulations! The setup has completed successfully." Then, click Next.

When the initial setup is complete, additional options can be configured from the Jazz Team Server Admin Web user interface by using the URL https://localhost:9443/jazz/admin.

What to do next

If the server setup wizard does not load, check the following items:

Verify that the application server has started. Use the URL http://localhost:9080.
Verify the Jazz Team Server has started by logging in to the Jazz Team Server Admin Web UI using the URL https://localhost:9443/jazz/admin. If the page does not load or the server has errors, the server did not start correctly.
The URI root for the Jazz Team Server path must be /jazz. For example https://example.com:9443/jazz must be used rather than https://example.com:9443.