This topic describes how to set up communication between Rational® Quality Manager and Rational Team Concert so
your users can create and track defects in Rational Team Concert.
After you set this up, users can create and track defects using the Rational Quality Manager user
interface, even though the defects themselves are maintained in Rational Team Concert.
Note: Before you begin, verify that you can log in to Rational Quality Manager from
the machine hosting the Rational Team Concert server.
Likewise, verify that you can log in to the Rational Team Concert Admin
Web UI from the machine hosting the Rational Quality Manager server.
To set up defect tracking in Rational Team Concert:
- 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.
Note: This
path must be the same one that users use to access Rational Quality Manager.
- For the Enable Cross Domain Communication property,
change the Current Value to true.
- Scroll to the com.ibm.team.repository.servlet.internal.ServletConfigurationService component.
- Type the host name of the Rational Team Concert server.
- 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 Adapter for RTC Component,
go to the com.ibm.rqm.adapter.rtc.service.internal.RTCDefectsCollector 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 and also
have a Client Access License assigned to it.
- 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.
- If necessary, update the Draft Link Lifespan value
or accept the default.
This is the time before a draft defect expires
automatically. The default is set to 1000 seconds. If a user creates
a new defect or associates an existing defect, the user must save
the defect before the Draft Link Lifespan times out.
- Also under Adapter for RTC Component,
go to the com.ibm.rqm.adapter.rtc.service.internal.rest.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 and also have a Client Access License assigned to it.
- Scroll to the com.ibm.team.repository.servlet.internal.ServletConfigurationService component.
- Type the host name of the Rational Quality Manager server.
- Set Use Canonical Host Name to false.
- Click Save.
- Set up the linkage between the Rational Team Concert project
area and the Rational Quality Manager project
area. After you set up this linkage, the defects that users create
in Rational Quality Manager will
be stored in the corresponding Rational Team Concert project
area.
- In the Rational Quality Manager user
interface, click Admin, and then click System
Properties.
- Click Defects Provider.
- For the Provider, select Rational
Team Concert (Defects).
- Click Configure.
This
starts a wizard for setting up Rational Team Concert as
the defect provider.
- In the URL field, type the full
URL of the Rational Team Concert server,
for example, https://rtc_server1:9443/jazz.
- 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.
- In the next wizard page, select the Rational Team Concert project
area for which the defects will be created. By default, this is the QM
Defects project area.
- Click Finish.
After
you complete the wizard, the Defects Provider page will be updated
to show a successful status and summary.
After you complete these steps, users will be able to create
and track defects that are saved in Rational Team Concert.