You can set up communication between IBM® Rational® Quality Manager and IBM Rational Team Concert so
that you can use Rational Team Concert as
your build provider and synchronize build information with Rational Quality Manager.
After you set up this communication, users can track builds in the Rational Quality Manager user
interface, even though the build information is maintained in Rational Team Concert.
Before you begin
To enable build integration, you must meet the following
requirements:
- At minimum, you must install iFix01 for Rational Team Concert version
2.0.0.2.
- Before you begin, verify that the computer that hosts the Rational Quality Manager Jazz™ server can communicate with
the computer that hosts the Rational Team Concert Jazz server.
- You must be logged in to both Rational Quality Manager and Rational Team Concert from
the browser where you are doing this configuration.
About this task
To set up build integration with Rational Team Concert:
Procedure
- Set up Rational Team Concert to
accept cross domain requests from Rational Quality Manager.
- In the Rational Team Concert Admin
Web UI, click the Server tab.
- In the Configuration pane, click Advanced
Properties.
- Under Core Repository Component,
scroll to the com.ibm.team.repository.service.internal.xdomain.DynamicProxyFrameService component.
- For the Current Value of the Cross
Domain Host Whitelist property, type the various URLs
that can be used to access the Rational Quality Manager Jazz server. Separate each path
with a comma, and try to include all of the possible paths, for example:
https://myserver:9443/jazz, https://myserver.ourdomain.mycompany.com:9443/jazz, https://9.12.345.67:9443/jazz
The
previous examples include the simple host name, the host name along
with the domain name, and the IP address.
If you need to configure
multiple Rational Quality Manager servers,
you can also use commas to separate each server URL.
- For the Enable Cross Domain Communication property,
change the Current Value to true.
- Scroll to the com.ibm.team.repository.servlet.internal.ServletConfigurationService component.
- In the Host Name field, type the host name of the Rational Team Concert server,
for example, myrtcserver.ourdomain.mycompany.com.
- Set Use Canonical Host Name to false.
- Click Save.
- Set up Rational Quality Manager so
that it can communicate with Rational Team Concert.
- In the Rational Quality Manager user
interface, click Admin, and then click Jazz
Server Administration.
- Click Advanced Properties.
- Under Build Integration Framework,
go to the com.ibm.rqm.buildintegration.service.asynctask.RTCBuildInformationCollector component
and modify the properties as necessary.
- If necessary, under Current Value, type
the correct User Name and Password for
the Rational Team Concert Jazz Server administrator. At minimum,
the User Name must have JazzUsers repository
permissions.
- If necessary, update the Delay value or
accept the default.
The Delay value determines how frequently the Rational Quality Manager server
synchronizes with the Rational Team Concert server.
The default is set to 500 seconds. If you want to see changes more
frequently, decrease the delay frequency. If this produces too great
a load on the Rational Quality Manager server,
you can increase the delay frequency.
- Under Integration Provider Component,
go to the com.ibm.rqm.integrationprovider.service.rest.internal.ConnectionRestService component
and modify the properties as necessary. Under Current Value,
type the correct User Name and Password for
the Rational Team Concert Jazz Server user. This User
Name must have JazzUsers repository
permissions.
- Under Core Repository Component,
scroll to the com.ibm.team.repository.servlet.internal.ServletConfigurationService component.
- Type the host name of the Rational Quality Manager server,
for example, myrqmserver.ourdomain.mycompany.com.
- Set Use Canonical Host Name to false.
- Click Save.
- Set up the link between the Rational Team Concert project
area and the Rational Quality Manager project
area. After you set up this link, the build information that gets
created in Rational Team Concert will
be stored in the corresponding Rational Quality Manager project
area.
- In the Rational Quality Manager user
interface, click Admin, and then click System
Properties.
- Click Build Provider.
- For the Provider, select RTC
Integration Provider.
- Click Configure.
A
wizard starts for setting up Rational Team Concert as
the build provider.
- In the URL field, type the full
URL of the Rational Team Concert server,
for example, https://rtc_server1:9443/jazz.
Note: The hostname in the URL must be the same that you used
in Step 1g.
- In the Name field, type a name
for this particular Rational Team Concert server.
- Optional: In the Description field,
type a description of the server.
- Click Next.
Note: If
you see a warning message, Security Error: Domain Name
Mismatch, simply click OK. If
you are asked to Verify the Logged in User click Continue or
click Log in as different user.
- On the next wizard page, select the Rational Team Concert project
area for the builds. By default, this is the QM Builds project
area.
- Click Finish.
After
you complete the wizard, the Builds Provider page is updated to show
a successful status and summary.
Results
After you complete these steps, users can track builds that
are created in
Rational Team Concert.