VM Setup - quality-manager/onboarding GitHub Wiki

See 183795: Document required applications/configuration for installing/upgrading ELM on test/development VM.

Installation Process for ELM Applications with Derby Database

To install the ELM applications, download the latest Installation Manager from the below location -

https://jazz.net/downloads/ibm-installation-manager/

Once the installation is done, you need to search for the latest build from the following link. ((e.g - ELM 7.0.2 current) https://jazzweb.ratl.swg.usma.ibm.com/elmb/elmb-702/I.html

From this URL, search for the repository URL from ELM Launchpad which looks similar to the one that is shown below:

The repository URL looks like this - https://jazzweb.ratl.swg.usma.ibm.com/elmb/elmb-702/I/ELMB702-I20200721-2058/repo-web-clm/repository/repository.config

Steps

Copy the repository URL and install it using Installation Manager. complete the following steps: -

  1. Open Installation Manager.
  2. Click the File on the top left.
  3. Click Preferences.
  4. Click Add Repository.
  5. Add the above copied URL.
  6. Click OK and provide your jazz credentials and IBM credentials.
  7. Select all the applications that you want to install, such as JTS, CCM, QM , RM, GC, DCC, LQE, LDX, Trial Licenses, and so on.
  8. Provide the location to install and complete the installation.
  9. Start the server by clicking startup.bat file.
  10. Wait for the server to get started.
  11. Go to the JTS Setup link. E.g. - https://servername:9443/jts/setup
  12. Select Express Setup or Custom Setup according to your need.
  13. If you have selected Express Setup, then provide an user who acts as admin user, such as qmuser.
  14. Provide the 3 licenses to the user (qmuser) - Analyst for RM, Quality professional for ETM, and Developer for IBM Workflow Management.**
  15. Express setup creation is started.
  16. Wait for ~10 mins for Setup to get completed.
  17. JTS Home Page is displayed.
  18. Click Create MTM Sample Project Area to create a sample project area.
  19. Provide a name for Project area or go with default name.
  20. Once the MTM Sample project gets created (default name - JKE Banking (Quality Management)), go to admin page and add the admin user to the project area.
  21. Provide the role and permission to the user.
  22. Create sample test artifacts in the project area to verify successful installation.
  23. Ensure the repo debug setting is enabled and functional as mentioned under "Additional System Properties Settings" section.

Minimum Required infrastructure for good performance

  1. You need 2 Virtual Machines for installation.
  2. 1 machine to host the DB2 Database. The configuration should be 4 CPU and 8 GB RAM and 200 GB hard disk.
  3. 1 machine to install the ELM server with all the required applications. The configuration should be 8 CPU and 16 GB RAM and 200 GB hard disk.

Process of Installation, Creation and Backup of DB2 Database

You have to install the DB2.

Creation of Database for all ELM Applications -

To create the database, use the following batch file:

Refer Example Batch File Initdb2 batch file

Example format of command for creating database for JTS -

db2 create database (database name)(version)jts using codeset UTF-8 territory en PAGESIZE 16384

Follow the below steps to use the batch file -

  1. Create the above batch file and keep it on your desktop.
  2. Run the batch file by double clicking.
  3. Provide the location properly in the batch file.

Backup of DB2 Database -

To take the Backup of database use batch file below.

Refer Example Batch File Backup db2 batch file

Example format of command for taking backup of ETM -

db2 BACKUP DATABASE (database name)(version)qm

Process of Installation of ELM Server (All Apps)

Follow the below mentioned link to install ELM Server https://www.ibm.com/support/knowledgecenter/SSYMRC_7.0.2/com.ibm.jazz.install.doc/topics/roadmap_form.html

Process for Installation of ELM Server

Refer Example Batch File Install ETM70 batch

Follow below steps to use the batch file -

  1. Create the above batch file and keep it on your desktop.
  2. Provide the server name which you are using.
  3. Give the location of the folder where you want to install the ELM server.
  4. Provide the name of your DB2 machine.
  5. Follow all the instructions coming while running the batch file.

Verify the server is up

Log in with admin user and check the admin pages, look for any service startup errors, DB issues, and failing diagnostics (other than unreachable Friends):

https://servername:9443/jts/admin#action=com.ibm.team.repository.admin.serverDiagnostics https://servername:9443/qm/admin#action=com.ibm.team.repository.admin.serverDiagnostics https://servername:9443/ccm/admin#action=com.ibm.team.repository.admin.serverDiagnostics https://servername:9443/rm/admin#action=com.ibm.team.repository.admin.serverDiagnostics

Log in with the admin user and check the build version (Help->About) is correct for the RM, CCM, QM, and JTS applications (see the "Contributing Builds" section of the "External Links" tab of the calm.jcb build).

Do a quick sanity test of ETM with the following steps

  • Create a test plan
  • Link a development plan from CCM
  • Link a requirement collection from RM
  • Edit some other data and save the plan
  • Reconcile the requirement collection, generating test cases
  • Create different ETM Artifacts and try CRUD operations.

Additional System Properties Settings

Set the Repodebug Utilities to True under Advanced Server Properties section of the Server as follows:

Enable repodebug service = true . ( Note by default this property is set to false)

Set the following system properties on all the test servers used by ETM team

  • Give access to restricted areas to all JazzAdmins users :

set JAVA_OPTS=%JAVA_OPTS% -Dcom.ibm.team.repository.debug.users=JazzAdmins

  • Enable support for multiple components :

set JAVA_OPTS=%JAVA_OPTS% -DisCompositeEnabled=true

  • Expose /repodebug/access service :

set JAVA_OPTS=%JAVA_OPTS% -Dcom.ibm.team.repository.debug.accessServiceEnabled=true

Process of Upgrading ELM Server

Follow either the steps from point 1 or refer Interactive upgrade guide from step 2.

  1. Refer Example Batch File Upgrade ETM70 batch for server upgrade.
  2. Follow the steps from the Interactive Upgrade Guide

Installation Process for Clustered Environment

Follow the below Wiki Link to create the Clustered Environment. https://jazz.net/wiki/bin/view/Main/ClusterDeploymentBuild_CCM

NOTE : List of VMs maintained by ETM team can be found here : Virtual Machines

Support