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