Repository tools command-line reference

Edit online

The repository tools application is a command-line interface that provides a set of tools to manage Jazz based applications such as the Jazz® Team Server, IBM® Engineering Workflow Management (Change and Configuration Management application), Data Collection Component, Global Configuration Management, IBM Engineering Test Management (Quality Management application), IBM Engineering Lifecycle Optimization - Engineering Insights, and IBM Engineering Requirements Management DOORS® Next (Requirements Management application).

The repository tools application is intended primarily for performing database migrations. The application is not intended for performing database backups. You can use tools that are supplied by your database vendor to back up your database. Consult your database vendor documentation for information about performing a backup.

Note: Shutdown and back up the database before you use any repotools commands that perform system maintenance operations.

The repotools scripts are in JazzInstallDir/server. Use the script that is associated with your IBM Engineering Lifecycle Management (ELM) application. Table 1 describes each repotools script and the associated ELM application that it manages.

Table 1. repotools scripts
Script	ELM application
repotools-jts	Jazz Team Server
repotools-ccm	IBM Engineering Workflow Management (Change and Configuration Management application)
repotools-dcc	Data Collection Component
repotools-gc	Global Configuration Management
repotools-qm	IBM Engineering Test Management (Quality Management application)
repotools-relm	IBM Engineering Lifecycle Optimization - Engineering Insights
repotools-rm	IBM Engineering Requirements Management DOORS Next (Requirements Management application)

In the following examples, repotools-jts is used, but the same commands can be used with any of the repotools scripts that are described in Table 1.

Note: If you want to run the repotools commands from a directory other than JazzInstallDir/server, you must change the *.ini files in JazzInstallDir/server/conf/application/provision_profiles to use an absolute path. For example, change url=file:./update-site on UNIX to url=file:/opt/IBM/JazzTeamServer/server/conf/application/sites/update-site, and on Windows to

url=file:c:\program
files\IBM\JazzTeamServer\server\conf\application\sites\update-site

On z/OS®, the repotools application is started with Job Control Language (JCL). A number of sample jobs are provided for the most often used repository tools functions. These jobs are found in the hlq.SBLZSAMP data set created by your SMP/E installation. Table 2 describes the member names.

Table 2. Jobs associated with commonly used repotools functions
Job	Repository tools function
`BLZCREDB`	-createTables (for Db2® on z/OS)

To run other repository tools functions, you can copy one of the existing System z® sample JCL members. Modify the copied member by changing the //MAINARGS DD statement to correspond to the repository tools function that you want to run on z/OS.

Enabling repotools to connect with Oracle database using secure connection

You can enable repotools commands to connect with Oracle database using a secure SSL connection. Add the following lines to all repotools commands for every application.

Windows

Find repotool-xxx.bat from the ELMInstall\server directory. Edit the file and add the following lines to the set DEFINE session.

set DEFINE=%DEFINE% "-Djavax.net.ssl.trustStore=c:\pathname\ewallet.jks"
set DEFINE=%DEFINE% "-Djavax.net.ssl.trustStoreType=jks"
set DEFINE=%DEFINE% "-Djavax.net.ssl.trustStorePassword=xxxx"
set DEFINE=%DEFINE% "-Doracle.net.ssl_cipher_suites = SSL_RSA_WITH_AES_256_CBC_SHA"
set DEFINE=%DEFINE% "-Doracle.net.ssl_client_authentication = FALSE"
set DEFINE=%DEFINE% "-Doracle.net.ssl_version = 1.2"

Linux

Find repotool-xxx.sh from the ELMInstall/server directory. Edit the file and add the following lines:

DEFINE="$DEFINE -Djavax.net.ssl.trustStore=/root/ewallet/ewallet.jks"
DEFINE="$DEFINE -Djavax.net.ssl.trustStoreType=jks"
DEFINE="$DEFINE -Djavax.net.ssl.trustStorePassword=xxxx"
DEFINE="$DEFINE -Doracle.net.ssl_cipher_suites = SSL_RSA_WITH_AES_256_CBC_SHA"
DEFINE="$DEFINE -Doracle.net.ssl_client_authentication = FALSE"
DEFINE="$DEFINE -Doracle.net.ssl_version = 1.2"

Kerberos authentication

Some repotools commands are used against a running Jazz Team Server. The standard authentication model is to provide administrative user credentials either as command-line parameters or by using a credentials file. Alternatively, the user might use a client certificate or smart card. In all cases, the user must be a member of the JazzAdmins group.

To use Kerberos/SPNEGO to authenticate with the server, you must run the repotools-jts command with the kerberos parameter. If the parameter is set to windows, the authentication type is Integrated Windows Authentication. If the parameter is set to any other value, the authentication type is Kerberos. For example,

repotools-jts -repository=repositoryURL -createUser userID=UserID kerberos=true

This command creates the UserID user on the server while it authenticates with Kerberos/SPNEGO.

When the Kerberos parameter is set to true, the command-line interface obtains a Kerberos ticket through either Windows logon or the kinit utility. Ensure that the Java based client is configured through krb5.ini, krb5.conf, or the Java system properties (java.security.krb5.realm and java.security.krb5.kdc system properties, or the java.security.krb5.conf system property). For more information, see ELM client configuration for Kerberos/SPNEGO SSO.