Repository tools command-line reference
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, Data Collection Component, Global Configuration Management, IBM Engineering Test Management, IBM Engineering Lifecycle Optimization Engineering Insights, and IBM Engineering Requirements Management DOORS® Next.
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.
The repotools scripts are in JazzInstallDir/server. Use the script that is associated with your IBM Engineering Lifecycle Management application. Table 1 describes each repotools script and the associated Engineering Lifecycle Management application that it manages.
Script | Engineering Lifecycle Management 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 |
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
.
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.
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.
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 Engineering Lifecycle Management client configuration
for Kerberos/SPNEGO SSO.