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 LDAP.

Choose a setup path. The setup wizard has two main paths.
  • The Fast Path Setup uses the default configuration. If you want to get the server running quickly, the fast path setup is a good option. During the Fast Path Setup, setup
    • the user registry.
  • The Custom Setup guides you through the detailed server configuration, including the ability to enable e-mail notifications. During the Custom Setup, you set up the following items:
    • Database
    • E-mail notification
    • User registry
    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.

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:

Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug