Automate build deployment and accelerate releases with Rational software

Integrate Rational Build Forge, Rational Team Concert, and Rational Quality Manager

By integrating Rational Team Concert and Rational Build Forge, you can generate product offerings automatically. Then you can use Rational Team Concert to pass the offerings to Rational Quality Manager. By integrating Rational Quality Manager and Rational Build Forge, you can run various automation tasks from Rational Quality Manager through Build Forge. You can also schedule automated tasks, based on various parameters, from Rational Quality Manager. This helps in automating the entire process, from the production of offerings through running tests and reporting test results.

Share:

Lohith Doddamane (Lohith.nagendrappa@in.ibm.com), System Software Engineer, IBM

Lohith Doddamane photoLohith Doddamane has worked with the IBM Rational DOORS requirements management tool for the past four years, and has five years of experience in the IT industry. His areas of interest include automation and open services lifecycle collaboration.



Pawan M. Ranganath (pavan03@gmail.com), Software Engineer, IBM

author photoPawan was with IBM for more than two years, working on Rational DOORS and DOORS Next Generation software. He is currently a graduate student at New York University. His interests include information and network security, computer networking, and software development.



09 October 2012

Also available in Portuguese

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

  1. Edit the buildforge.conf file:
    1. In the local Rational Build Forge installation folder, open the buildforge.conf file in a text editor.
    2. Add the db_system_password password string (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.
  2. Save the file.
Figure 1. Edit the Build Forge config file
configuration file content
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.

  1. In the Rational Quality Manager installation folder, in the server subfolder, open the integration_config.xml file in a text editor.
  2. Delete the comment tags at the beginning and the end of the code: <!-- and -->.
  3. In the <hostname> </hostname> line, change the text to the hostname or the IP address of the Rational Build Forge server, for example: <hostname>server1</hostname>
  4. 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:
    <password>stage1</password>
  5. 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.
  6. Save this file.
  7. 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
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

  1. 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.
  2. 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.
  3. Click the Add to Build Forge icon (Add to provider), which will open the Add Lab Resource to Build Forge window.
  4. Enter the user name and password of the user account on the lab resource that you are adding to Rational Build Forge.
  5. 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).
  6. In the Build Forge Temp Path field, type the path to the Rational Build Forge agent folder. This field is mandatory.
  7. 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.
  8. 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
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

  1. Set up build integration with the Change and Configuration Management (CCM) application (Rational Team Concert).
  2. Set up a Change and Configuration Management server as a friend of the Quality Management (QM) server.
  3. Set up the Quality Management application (Rational Quality Manager) so that it can communicate with the CCM application.
  4. On the Jazz™ Team Server home page, under Application Administration, go to the Quality Management (/qm) section, and click Application.
  5. Under Configuration on the left, click Advanced Properties.
  6. Under Build Integration Framework, go to the com.ibm.rqm.buildintegration.service.asynctask.RTCBuildInformationCollector component, and click Edit. Modify the properties as required.
  7. 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.
  8. 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.
  9. 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.
  10. At the top of the page, click Save.
  1. 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.
  2. In the Quality Management project, click the Admin (Administration) icon in the top-right portion of the banner, and select Manage Project Properties.
  3. Under Properties, click Build Provider.
  4. For the Provider, select RTC Integration Provider.
  5. Click Configure to start a wizard for setting up Change and Configuration Management as the build provider.
  6. Click Next.
  7. 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.
  8. 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
Manage Properties Properties

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
Execution Schedules dialog window
Figure 6. Available Automations to Run view lists name and provider
Screen also lists machines available for automation

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

Resources

Learn

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.

Discuss

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into Rational software on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational
ArticleID=839056
ArticleTitle= Automate build deployment and accelerate releases with Rational software
publish-date=10092012