Migrate Configuration Management Version Control to Rational Team Concert: Part 1. Configure the server and install the CMVC Connector

This two-part article explains migration of Configuration Management Version Control (CMVC) to IBM Rational Team Concert. Part 1 provides the details about Rational Team Concert server configurations and installation of CMVC Connector on the Rational Team Concert Eclipse client required for the migration.

Murali Dhandapani (muralindia@in.ibm.com), IT Specialist, IBM

author photoMurali Dhandapani is part of the ISL Operations Software Engineering Service team at IBM Software Labs, India, where is a technical lead for Rational Jazz products infrastructure deployment. Murali has a master’s degree in computer science and is an IBM Certified IT Specialist in System Management, an IBM Certified Specialist in System p administration, and IBM eServer Certified Systems Expert - pSeries HACMP.


developerWorks Contributing author
        level

13 March 2012

Also available in Chinese

This article explains the IBM® Rational Team Concert™ server and Rational Team Concert Eclipse client configurations required for the migration of Configuration Management Version Control (CMVC) data to Rational Team Concert. It also gives an overview of how to install CMVC connector Version 1.4 on The Eclipse client 3.0.1 and provides the server prerequisites for the migration of defects or features and source code from CMVC to Rational Team Concert.

Configure the Rational Team Concert Eclipse client

This section explains how to install the CMVC Connector, using the Eclipse client, and how to configure the database that is required for the migration.

Rational Team Concert Connector CMVC 1.4 installation

  1. Download the CMVC-Rational Team Concert-Connector1.4GA.zip file (see Resources for a link). It contains two compressed files:
    • CMVC-Rational Team Concert-Connector.zip
    • ExternalRepositoryManager.zip.
  2. Open Rational Team Concert Eclipse client, and click Help > Install New Software.

The screen shown in Figure 1 will prompt you for input.

Figure 1. Install window and selection of cmvc-rtc-connector.zip
Install, Add Site, and Repository archive windows
  1. Click Add > Archive, select CMVC-Rational Team Concert-Connector.zip, and finish the installation.
  2. Restart the Rational Team Concert Eclipse client after the successful installation of CMVC Rational Team Concert Connector.

CMVC Connector

Successful installation of CMVC Rational Team Concert Connector software will create the CMVC Connector menu in the Rational Team Concert Eclipse client. The CMVC Connector drop-down menu shown in Figure 2 displays the options available:

  • WorkItem helps with importing defect or feature and two-way synchronization.
  • SCM (software configuration management) helps with importing source code from the CMVC to Rational Team Concert and CMV- to-Rational Team Concert source code synchronization.

Both WorkItem and SCM contain audit options used for checking data integrity after successful import and synchronization.

Figure 2. CMVC Connecter menu
4 options: WorkItem, SCM, Administration, Help

The screen shown in Figure 3 displays the Administration option of the CMVC Connector.

Note:
Create the CMVCSYNC database on the Rational Team Concert server before configuring the Administration page (see the next section for more about that).

  1. Configure the Database Properties section, and save the configuration.
  2. Then click Generate DB Properties, which creates a file named ExternalRepositoryManager.properties.

You will be prompted to save this file, which contains the database properties details. You will use it to configure the Rational Team Concert server (in the next section).

Figure 3. CMVC connector Administration page
Administration dialog window

Configure the Rational Team Concert server

This section explains how to install the Jazz server component that is required for synchronization and how to configure the external repository.

Install the Jazz server component and configure the external repository

  1. Create a folder called ERM (for External Repository Manager) in the following path, and extract the files from the ExternalRepositoryManager.zip file.

    Tomcat:
     /opt/IBM/JazzTeamServer_3.0.1/server/conf/ccm/sites/ERM
    WebSphere Application Server:
    /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/JazzTeamServer_3.0.1/server/conf/ccm
    /sites/ERM

    The following files should be extracted:
    drwxr-xr-x    3 root     system          256 Dec 23 17:48 configuration
    drwxr-xr-x    2 root     system          256 Dec 23 17:48 features
    drwxr-xr-x    2 root     system          256 Dec 23 17:48 plugins
    -rw-r--r--    1 root     system          444 Dec 23 17:48 site.xml

Note:
If the Rational Team Concert 3.0 or later server is an upgraded version from Rational Team Concert 2.0, then the context root will be /jazz and in the path, rather than .../.../ccm/sites. So the path should show be: .../.../jazz/sites.

  1. Create a file named cmvcjazzsync-profile.ini in the following path:
    /opt/IBM/WebSphereAppServer/profiles/AppSrv01/JazzTeamServer_3.0.1/server/conf/ccm/provision_profiles
  2. Open the cmvcjazzsync-profile.ini file, and enter the following details:
    • url:
      file:/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/JazzTeamServer_3.0.1/server/conf/ccm/sites/ERM
    • featureid:
      com.ibm.sdwb.connector.cmvc.workitem.ExternalRepositoryManager.server.feature
  3. Create a database named CMVCSYNC on the Rational Team Concert server:
     db2 create database CMVCSYNC
    Note:
    To deploy Rational Team Concert 3.0.1, you would already have created databases named JTS, CCM, or JAZZ (if Rational Team Concert was upgraded from version 2.0 or earlier) and DW. Similarly, create the CMVCSYNC database for CMVC-to-RTC migration.
  4. Place the ExternalRepositoryManager.properties file, which you created earlier by using Generate DB Properties, in the following path:
    Tomcat:
     /opt/IBM/JazzTeamServer/server
    WebSphere Application Server:
     /opt/IBM/WebSphere/AppServer/profiles/AppSrv01

Listing 1 shows the sample contents of the ExternalRepositoryManager.properties file.

Listing 1. ExternalRepositoryManager.properties
IIPAuthentication=false
# Properties for the database used internally by the outgoing synchronizer
# These properties are generated by incoming synchronizer wizard
DB_HOSTNAME=islswestest2.in.ibm.com
DB_PORTNO=50010
DB_USERNAME=sdwbins
DB_PASSWORD=1WBZcSBE+d2qhIZHiC9JRg==
DB2_JDBC_URL=jdbc:db2://islswestest2.in.ibm.com:50010/CMVCSYNC
DB_MAX_RETRY=1440
DB_RETRY_INTERVAL=1
CREATE_CMVC_USER=false

Important:
Set IIPAuthentication to false if you use CMVC Password for authentication or to true if you use intranet authentication. Any change in this file requires a restart of the Rational Team Concert server as indicated here:

Tomcat:
server.shutdown and server.startup

WebSphere Application Server:
Restart of respective server profile

  1. Add the entries shown in Listing 2 to the log4j.properties file to enable logging for the outgoing synchronization process. The file is available in this location:
    JazzTeamServer_3.0.1/server/conf/ccm
Listing 2. Entries to enable logging for outgoing synchronization
log4j.logger.com.ibm.sdwb.connector.cmvc.workitem=WARN,Connector
                
log4j.appender.Connector=org.apache.log4j.FileAppender

log4j.appender.Connector.File=logs/OutgoingConnector.log

log4j.appender.Connector.layout=org.apache.log4j.PatternLayout

log4j.appender.Connector.layout.ConversionPattern=%d{ABSOLUTE} [%t] %5p  %-50.50c  - %m%n

log4j.additivity.com.ibm.sdwb.connector.cmvc.workitem=false

Note:
This will add logs to a separate file called OutgoingConnector.log, which is needed only for the defect or feature outgoing synchronization process. You can find the OutgoingConnector.log file in the following path:

Tomcat:
/opt/IBM/JazzTeamServer/server/logs (Create the logs folder if it does not exist.)

WebSphere Application Server:
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs

  1. Reset the server by entering the following link in the Jazz web client:https://localhost:9443/ccm/admin/cmd/requestResetNote:
    Replace localhost with your Jazz server name.
  2. Stop and restart the Rational Team Concert server.
  3. Log in to https://localhost:9443/ccm/admin, and click Component Status.

You should see the com.ibm.sdwb.connector.cmvc.workitem service on this page, as shown in Figure 4.

Figure 4. sdwb components
Displays sdwb components

Prepare for migration from CMVC to Rational Team Concert

This section explains the setup architecture, as well as the prerequisites for both CMVC and Rational Team Concert before proceeding to the migration.

CMVC and Rational Team Concert setup architecture

The diagram in Figure 5 shows the setup used as the basis of this article.

Figure 5. CMVC and Rational Team Concert setup
Flow diagram of setup

CMVC prerequisites

  1. Identify the CMVC family to import or synchronize.
  2. The CMVC family user ID should have super-user privileges.

Rational Team Concert prerequisites

  1. Create a project area by using the Scrum template.
  2. Create a team area.
  3. Include the member (user) in the project area who is importing CMVC data to Rational Team Concert.
  4. Assign the Scrum Master role to that user.
  5. The Rational Team Concert user should have a Developer license.
  6. Disable email notification by setting the value to false to avoid an overflow of email during import.

Summary and what's next

This first part of this two-part article explained the configurations of Rational Team Concert server and Rational Team Concert Eclipse client that are necessary to initiate the CMVC-to-Rational Team Concert migration, along with prerequisites required for the migration of defects or features and source code data from CMVC to Rational Team Concert.

Part 2 provides systematic instructions for how to import defect or features and SCM from CMVC to Rational Team Concert.

Resources

Learn

Get products and technologies

  • Download Rational Team Concert from Jazz.net (requires registration).
  • Download the connector file, CMVC-Rational Team Concert-Connector1.4GA.zip, from CMVC RTC Connector Community in Rational Asset Manager (requires registration, free).
  • Evaluate 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. Select information in your profile (name, country/region, and company) is displayed to the public and will accompany any content you post. 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, DevOps
ArticleID=801215
ArticleTitle=Migrate Configuration Management Version Control to Rational Team Concert: Part 1. Configure the server and install the CMVC Connector
publish-date=03132012