Repository tools command to run diagnostics on the server

Edit online

Use the executeDiagnostics command to run diagnostics on the remote server.

Purpose

The executeDiagnostics command runs diagnostics on the remote server and saves the results.
Important: The server must be running when you run the command.

Parameters

Attribute Description Required Default
zipOutputFile The name of the .zip file to hold the detailed results No None
summaryOutputFile The name of the file to hold the results summary. No None
skipExecution The default is false. When switched to true, the diagnostics are not executed. Instead, the most recent existing diagnostics results are reported. No False
verbose Enables verbose output. No N/A
repositoryURL The connection URL for the server. No https://localhost:9443/jts
adminUserId Administrator user ID to log in to the repository. No ADMIN
adminPassword Administrator password to log in to the repository. No ADMIN
credentialsFile The file containing the administrator user's login credentials. No credentials.properties
certificateFile The file containing the administrator user's login certificate. No None
smartCard The alias to login using a smart card, or ? to list available aliases. No None
kerberos Authenticate with Windows user credentials using Kerberos/SPNEGO by setting to true. Or authenticate with Windows Integrated Authentication by setting to windows. No None

Example

The following example is for Jazz Team Server. To use this command for other applications, run these options from the server directory:
  • IBM® Engineering Workflow Management (Change and Configuration Management application): repotools-ccm
  • IBM Engineering Requirements Management DOORS® Next (Requirements Management application): repotools-rm
  • IBM Engineering Test Management (Quality Management application): repotools-qm
  • Global Configuration Management: repotools-gc
  • Data Collection Component: repotools-dcc
  • IBM Engineering Lifecycle Optimization Engineering Insights: repotools-relm

For Windows operating system Open a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -executeDiagnostics zipOutputFile=C:\myServerDiagnostics.zip kerberos=true

For Unix operating systems Open a command line and enter this command:

cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -executeDiagnostics zipOutputFile=opt/myServerDiagnostics.zip