IBM®Rational® Build Forge® is an adaptive process execution framework that automates, orchestrates, manages, and tracks all of the processes between each handoff within the assembly line of software development.
IBM Rational Team Concert™ is a lean collaborative lifecycle management solution that helps companies build better software and products with a complete lean development environment for teams, which includes agile, formal and hybrid planning and reporting, all on a common platform.
IBM Rational® Quality Manager is a web-based centralized test management environment that helps in providing a collaborative and customizable solution for test planning, workflow control, tracking and metrics reporting.
By integrating Rational Team Concert and Build Forge, generation of product offerings can be automated. The result of the offering production can then be passed on to Rational Quality Manager from Rational Team Concert for further use.
By integrating Rational Quality Manager and Build Forge, various automation tasks can be run from Rational Quality Manager on different servers through Build Forge. The automated tasks can be scheduled based on various parameters from Rational Quality Manager.
Integrate Rational Build Forge and Rational Quality Manager
- Edit the buildforge.conf file:
- In the local Rational Build Forge installation folder, open the buildforge.conf file in a text editor.
- Add the
db_system_password passwordstring (include a space between db_system_password and password), where password is the password to use to connect Rational Build Forge with Rational Quality Manager. Tip: Keep track of this password, because you will need it when you configure Rational Quality Manager to connect with Rational Build Forge.
- Save the file.
Figure 1. Edit the Build Forge config file
Listing 1. Sample code after editing the config file
db_hostname machineName db_tcp_port 50000 db_database BUILD db_schema BUILD db_username db2admin db_password 222645190c6614c900f6764a297e650525fb14b0d8b8108f4c87 db_type odbc db_provider db2 db_system_password password services_hostname machineName services_url https://machineName:8443/rbf-services bf_plugin_dir c:/Program Files/IBM/Build Forge/services-plugins services_tcp_port 3966 services_ssl_port 49150 birt_home c:/Program Files/IBM/Build Forge/birt bf_file_storage c:/Program Files/IBM/Build Forge/temp real_hostname machineName gdd none location_name normal
Configure Rational Quality Manager to receive lab resource data from Build Forge
After you configure Build Forge to connect with IBM Rational Quality Manager, there are several steps that you must perform in Rational Quality Manager to receive lab resource data from Rational Build Forge.
- In the Rational Quality Manager installation folder, in the server subfolder, open the integration_config.xml file in a text editor.
- Delete the comment tags at the beginning and the end of the code:
<!-- and -->.
- In the
<hostname> </hostname>line, change the text to the hostname or the IP address of the Rational Build Forge server, for example:
- In the
<password> </password>line, change the password to the password that you defined in the buildforge.conf file on the Rational Build Forge server, for example:
- In the
<instanceID> </instanceID>line, change the instance ID to a meaningful name for the Rational Build Forge server. This name will display in the user interface.
- Save this file.
- If Rational Quality Manager is running, restart it. If not, start it to enable these changes.
Figure 2. Edit integration_config.xml in Rational Quality Manager
Listing 2. Sample code after modification to integration_config.xml file
<adapter> <name>BuildForge 7.1.1 RTLM Imtegration Adaptor </name> <version>1.0</version> <APIVersionSupported>1.0</APIVersionSupported> <inventoryExtensionId> com.ibm.rational.test.lm.spi.bf.v71.inventory </inventoryExtensionId> <pluginId>com.ibm.rational.test.lm.spi.bf.v71</pluginId> <instance> <instanceId>buildforge_rqm</instanceId> <hostname>Build_Forge_Server_Hostname</hostname> <port>3966</port> <offline>FALSE</offline> <credential> <password>root</password> </credential> </instance> </adapter>
Add lab resources to Rational Build Forge
- Add a lab resource to Rational Build Forge using Rational Quality Manager. In the left navigation pane, point to the Lab Management icon and click All Lab Resources to open the editor.
- Select a lab resource to add to Rational Build Forge. Be sure that either the IP address or the hostname is defined. If neither is defined, you must add this information to the lab resource.
- To enter the IP address, select Hardware and, if necessary, click the Expand icon. In IP Address, type the IP address of the machine.
- To enter the hostname, select Operating System and, if necessary, click the Expand icon. Then click the Add icon to open the Operating System section. In Hostname, type the hostname of the machine.
- Click the Add to Build Forge icon (Add to provider), which will open the Add Lab Resource to Build Forge window.
- Enter the user name and password of the user account on the lab resource that you are adding to Rational Build Forge.
- In Provider, select the Rational Build Forge server that you want to add the lab resource to (in most cases, the default value for the Rational Build Forge server is correct).
- In the Build Forge Temp Path field, type the path to the Rational Build Forge agent folder. This field is mandatory.
- If the Rational Build Forge agent machine is configured to use a port other than the default port of 5555, in Port, type the port number. If you did not configure an alternative port for the agent machine nor accept the default during the installation of the agent machine, you do not need to enter anything in the Port field.
- Click Save.
The progress bar shows progress in connecting to the Rational Build Forge server, and a status message will confirm that the lab resource was successfully added.
After this integration has been configured, the Automations view in Rational Quality Manager lists all of the available projects in Build Forge and the lab resources on which these projects can be run.
Figure 3. Projects available and lab resources
Create a test execution schedule
The next goal is to create and schedule a test execution schedule that can run upon a successful build arrival. For source code management and build development purposes, you can use Rational Team Concert. The builds that are produced using Rational Team Concert can be passed on to Rational Quality Manager.
Follow these steps listed in "Section 1" and "Section 1a" to configure Rational Quality Manager to use Rational Team Concert as a Build Provider:
Configure the build integration framework
- Set up build integration with the Change and Configuration Management (CCM) application (Rational Team Concert).
- Set up a Change and Configuration Management server as a friend of the Quality Management (QM) server.
- Set up the Quality Management application (Rational Quality Manager) so that it can communicate with the CCM application.
- On the Jazz™ Team Server home page, under Application Administration, go to the Quality Management (/qm) section, and click Application.
- Under Configuration on the left, click Advanced Properties.
- Under Build Integration Framework, go to the com.ibm.rqm.buildintegration.service.asynctask.RTCBuildInformationCollector component, and click Edit. Modify the properties as required.
- Under Current Value, type the correct user name and password for the CCM Jazz Team Server administrator. At minimum, the user must have JazzUsers repository permissions.
- Update the Delay value or accept the default setting. The Delay value determines how frequently the QM server synchronizes with the CCM server. The default setting is 500 seconds. If you want to see changes more frequently, decrease the delay. If this produces too heavy a load on the QM server, you can increase the delay.
- Under Integration Provider, click Edit, go to the com.ibm.rqm.integrationprovider.service.rest.internal.ConnectionRestService component, and modify the properties as required. Under Current Value, type the correct user name and password for the CCM Jazz Team Server user. This user must have JazzUsers repository permissions.
- At the top of the page, click Save.
Link the CCM and quality management project areas
- Set up the link between the Change and Configuration Management project area and the Quality Management project area. After you set up this link, the build information that is created in Change and Configuration Management will be stored in the corresponding Quality Management project area.
- In the Quality Management project, click the Admin (Administration) icon in the top-right portion of the banner, and select Manage Project Properties.
- Under Properties, click Build Provider.
- For the Provider, select RTC Integration Provider.
- Click Configure to start a wizard for setting up Change and Configuration Management as the build provider.
- Click Next.
- On the next wizard page, select the Change and Configuration Management project area for the builds. Select the project area for which the builds will be created.
- Click Finish.
After the wizard finishes, the Builds Provider page is updated to show a successful status and summary.
Figure 4. Manage Project Properties view
Now that you have configured Rational Team Concert as a Build Provider for Rational Quality Manager, you can create an automated test execution schedule in Rational Quality Manager that runs upon build arrival. Its results are recorded in Rational Quality Manager.
Figure 5. Sample of an automated schedule
Figure 6. Available Automations to Run view lists name and provider
You can now manage lab resources through Rational Quality Manager, generate builds through Rational Team Concert, and deploy those builds through projects in Build Forge and its integration with Rational Quality Manager. Your Build Forge projects could even include basic build verification tests that can be run on the deployed builds..
- Learn more about CLM:
- IBM Rational solution for Collaborative Lifecycle Management 4.0 information center
- IBM Rational solution for Collaborative Lifecycle Management 4.0 sandboxes
- Collaborative Lifecycle Management page on Jazz.net
- Explore the Rational software area on developerWorks for technical resources, best practices, and information about Rational collaborative and integrated solutions for software and systems delivery.
- Subscribe to the developerWorks weekly email newsletter, and choose the topics to follow.
- Stay current with developerWorks technical events and webcasts focused on a variety of IBM products and IT industry topics.
- Attend a free developerWorks Live! briefing to get up-to-speed quickly on IBM products and tools, as well as IT industry trends.
- Watch developerWorks on-demand demos, ranging from product installation and setup demos for beginners to advanced functionality for experienced developers.
Get products and technologies
- Download a free trial version of Rational software.
- Evaluate other IBM software in the way that suits you best: Download it for a trial, try it online, use it in a cloud environment, or spend a few hours in the SOA Sandbox learning how to implement service-oriented architecture efficiently.
- Join the Rational software forums to ask questions and participate in discussions.
- Ask and answer questions and increase your expertise when you get involved in the Rational forums, cafés, and wikis.
- Join the Rational community to share your Rational software expertise and get connected with your peers.
- Rate or review Rational software. It's quick and easy.
Dig deeper into Rational software on developerWorks
Get samples, articles, product docs, and community resources to help build, deploy, and manage your cloud apps.
Keep up with the best and latest technical info to help you tackle your development challenges.
Software development in the cloud. Register today to create a project.
Evaluate IBM software and solutions, and transform challenges into opportunities.