You will need to go through the configuration wizard for
each Rational® Engineering Lifecycle
Manager application
you installed on a separate machine. For example, if you have installed Rational Engineering Lifecycle
Manager and
the Configuration Management application on one machine, and the Lifecycle
Query Engine on
another machine, you will run this wizard for both Jazz™ Team Server: https://RELM_fully_qualified_host_name:9443/jts/setup and https://lqe_fully_qualified_host_name:9443/jts/setup.
The instructions in this topic use the Rational Engineering Lifecycle
Manager JTS
as the example, but the Lifecycle
Query Engine can
be configured in a similar way.
Before you begin
- For new installations, if you do not want to use the default port
numbers, you must change them before you use the setup wizard. Refer
to Changing the port numbers for the application server for
more details.
- If you are using an enterprise database such as DB2® or Oracle, you must have created the databases
for each application. Note that when you create the databases, you
do not need to create the database tables by running the repotools
command. On the Configure database page of
this wizard, click Create tables to create
the database tables.
- Make sure that you have started the server.
- Ensure that pop-ups are allowed in the browser you are using to
run the setup wizard. If you have a pop-up blocker enabled, during
the Finalize Application Setup step for each
application an essential pop-up window will be blocked and your configuration
will appear to hang. If this occurs, exit the setup wizard and run
it again with pop-ups enabled.
Procedure
- In a web browser open https://RELM_fully_qualified_host_name:9443/jts/setup
- Log into Jazz Team Server as ADMIN/ADMIN (case-sensitive)
- On the Setup page select Custom Setup and
click Next.
- Read the Introduction page and click Next.
- On the Public URI page enter https://RELM_fully_qualified_host_name:9443/jts and
check I Understand then click Next.
- On the Configure Database page,
enter the information for your database. Derby is the default database,
but DB2 and Oracle are also
supported. Test the connection and then click Next.
- On the Email Notification page leave
notification disabled and press Next
- On the Register Applications page,
any application sharing the JTS should be pre-filled. Record the discovery
URLs and functional user IDs. Any JTS-based applications installed
on remote machines should be added to this list manually, and later
you will set up a friend relationship between them as described in Configuring OSLC consumers.
Click Register Applications. If the Lifecycle Query Engine
is on a different Jazz Team
Server, you will need to add it manually to the Rational Engineering Lifecycle
Manager:
- Application Instance: /lqe
- Application Type: Lifecycle
Query Engine
- Discovery URL: https://[lqe_hostname]:9443/lqe/scr
- Functional User ID: lqe_user
You can also add this at a later time at this URL: https://relm_host_name:9443/jts/admin#action=com.ibm.team.repository.admin.registeredApplicationsSince DOORS® Web Access will always be
remote from your Jazz Team Server,
you will need to add it manually to the Rational Engineering Lifecycle
Manager JTS:- Application Instance: DWA
- Application Type: IBM Rational DOORS Web Access
- Discovery URL: https://dwa_host_name:9443/dwa/public/scr
- Functional User ID: rm_user
You can also add this at a later time at this URL: https://RELM_fully_qualified_host_name:9443/jts/admin#action=com.ibm.team.repository.admin.registeredApplications
- On the Setup User Registry page,
select to use Tomcat as your user database, and create a user ID and
password. Select the Disable default ADMIN access check
box. This will disable the ADMIN/ADMIN user
id and password you are using for this initial setup. If you choose
not to select this, you should change the password as soon as the Jazz Team Server setup
is complete. From the list of applications registered to this Jazz Team Server,
select Rational Engineering Lifecycle
Manager and
any other application you want to be administered by this user ID.
- On the /vvc Configure Database page
select the database you will use for storing the Configuration Management
application data, finalize the application, and click Next.
- On the /relm Configure Database page
select the database you will use to store your Rational Engineering Lifecycle
Manager data,
finalize the application, and click Next
- The Summary page should look similar to the following;
review the information then click Finish.
Results
You can test your newly created user ID at https://RELM_fully_qualified_host_name:9443/jts/admin
What to do next
Once you have configured your JTS server, there are some
advanced settings that you must update:
- Open the administrative console at: https://RELM_fully_qualified_host_name:9443/jts/admin
- On the Server Administration home page
click Server.
- Under Configuration > Advanced Properties look
for the OAuth access token timeout field.
- Change the value to 86400 seconds and click Save.