RQM - Getting Started
IBM.com Jazz.net Documentation Downloads developerWorks

RQM Getting Started

New: RQM Learning Circle

Check out a small RQM setup at RQM - Tiny.

The following steps can be considered to take a closer look at RQM. If you are serious get a userid/password access on Jazz.net and wonder around in the RQM area.

Sandbox on Jazz.net

How to get code, running code. The quickest option is:

  1. Get yourself a sandbox on Jazz.net (Here)

That would take about 5 minutes or less and you are in business.

Local install

More timeconsuming, but giving you more options is:

  1. Download the code
    1. IBM Installation Manager
    2. Jazz Downloads
      1. Select Downloads tab
      2. Select latest (non Mx) release.
        M1, M2 releases are beta releases of upcoming software.
      3. Select All Downloads - Tab
      4. Full install package (of JTS,CCM,RQM and RM) - About 1800MB
  2. Upzip downloaded files in separate directories.

     

    Install

  3. Install IIM.
    Direct link to get IBM Installation Manager
  4. Install CLM with defaults.
    1. Start IIM
    2. In the File > Pref make sure you are referencing the appropriate repositories (sources of software to install).
    3. Install DOORSNG/RRC, JTS, RTC and RQM. All! In very specific situations you might choose to ommit programs.
    4. Make use of the integrated Derby DB for Trail (not for production!).
  5. Now make a copy of the /server directory.
    Not for production situations! By restoring the backup you can restore the 'empty' status to reconfigure again and play along.

     

    Configure

    This and the following steps will configure a (default) CLM environment. This includes steps like defining users, adding licenses and roles in one process. Following steps will add/configure in detail these users and roles.

  6. Start the Jazz server (as Admin)
  7. Point your browser to 
    https://[fully qualified hostname]:9443/jts/setup.

    Follow the proposed steps, more on installation of CLM Express.
    A 'default' admin user is clmadmin/clmadmin

    Figure: Don't forget to activate the trial keys by selecting (several of them)


    Select these links to activate (11 times!)
  8. Confirm that clmadmin user has the right Client Access Licenses
    1. RQM - Quality Professional (2nd from the Quality Manager lics)
    2. RRC - Analyst (1st from the Requirements Composer lics)
    3. RTC - Developer (2nd from the Team Concert lics)
    or
    1. CLM - Practitioner license.

    Otherwise you can create the "Money That Matters" with that user.
  9. Select "Try out the Money That Matter sample..."
    Right hand side of dashboard.
  10. Select Create Button
  11. Select Checkmark "I have read ..."
  12. Select Create button again
  13. Explore RQM as part of CLM.

When having downloaded the full install (about 1.5G) the above steps migh take 30 minutes.

Heads Up! When you've created a Lifecycle Project you must add users and give them roles!

Creating users

When creating a user make sure it has the right license. These users can be used to be member of multiple projects. At project level the users must get the appropriate role for authorisations.

The clmadmin user has, normally, the following Client Access Licenses

Connector Users

The connector user must have the "Connector License".

A License for a user, used to connect a connector to an RQM project.

Creating a Lifecycle Project

A Lifecycle Project is a combination of DoorsNG, RTC and RQM projects. Next to a valid license a user must have priveleges to access each (!) project.

A 'default' admin user is clmadmin/clmadmin

Adding users to the Project

If you add users make sure that the user has the appropriate licenses!

If you create a life cycle project, make sure you add the users and give them an appropriate role!

Check this! Make sure that the users have a role which grant them RW privelidges to work in the project.

Add Roles to each user! (Select to see full image)

Connector Users

The user, used to connect the various adapters need the "RQM Connector" license (nothing else).

The connector user must also have a rol to store test results in RQM (e.g. Tester)

A Role for a user, used to connect a connector to an RQM project.

Local re-install - Clear the database

Warning! This will discard all data!
As if it's a clean installation.

Based on the activities of the 'Local Install' do the following: 

%SOURCE_FILES%
	/server
		/conf
			/ccm
				teamserver.properties
			/jts
				teamserver.properties
			/qm
				teamserver.properties
		/tomcat
			/conf
				tomcat-users.xml
  1. Restore the teamserver.properties (in conf/ccm, conf/jts, conf/qm)
  2. Restore the tomcat-users.xml (in tomcat/conf)
  3. Run the following clear40.bat (you might need admin rights) 
    rem correct this pointer to the location of the Jazz server.
set JAZZ_HOME=C:\Program Files\IBM\JazzTeamServer
rem correct this pointer to the directory with the backup of source files.
set SOURCE_FILES=C:\mybackup\server

xcopy /Y /E /I "%SOURCE_FILES%\server" "%JAZZ_HOME%\server"
cd "%JAZZ_HOME%\server"
call repotools-jts.bat -createTables
call repotools-ccm.bat -createTables
call repotools-qm.bat -createTables
echo "Start the server and goto:"
echo "  http://www.server.com:9443/jts/setup"
  4. Continue at step 4 of the Local install.

Recently I experienced that the license is not cleared, even after re-importing!

Other "Getting Started"-pages