Repository tools command to dump Global Configuration Management components, configurations, and user-defined queries

Use the dumpArtifacts command to write global components, configurations, and user-defined queries into the server file system. Then, search the command output for data spills.

Purpose

  • Generates searchable versions of global configurations, components, and user-defined queries. You can then search for occurrences of sensitive data.
  • Provides a list of artifact dump jobs that were initiated since the last time the server was restarted.
This command is not intended to retrieve data about Global Configuration Management artifacts for other purposes, such as reporting or importing.
This task adds significant load to the server and can take a long time to run. If you close the shell or window before the command finishes:
  • If the server is not restarted, you can see the status and output of the job.
  • If the server is restarted, assume that the job did not finish. The system deletes the command output.
Note: This command applies only to the Global Configuration Management application. You cannot run it against other IBM® Engineering Lifecycle Management applications, for example, repotools-jts, repotools-rm, and so on.
To avoid overloading the server, the default maximum number of concurrent dump artifacts operations is set to 3. If there are already 3 dump jobs running, the command displays the following error: 
Too many concurrent dump jobs are running. Try again later.

You can configure the maximum number of concurrent dump jobs in the server's Advanced Properties section, under DumpFrontService.maxConcurrentDumps.

Parameters

Attribute Description Required Default
adminUserId, adminPassword The user ID and password of a team member that has JazzAdmin permissions for the repository.

To get a list of all the jobs that were initiated since the last server restart, specify these parameters and omit the others in this table.

 Yes N/A
dumpDirectory Include this parameter to dump the artifacts: specify an absolute path to a directory or parent directory on the server.

Example: If you specify dumpDirectory=C:\GCM-DUMP\dump1, either C:\GCM-DUMP\dump1 must exist, or C:\GCM-DUMP must exist and the system creates directory dump1.

Omit this parameter to list the dump jobs that were initiated since the last server restart.

No N/A
projectArea Name of a Global Configuration Management project area whose artifacts you want to search for data spills.

Omit this parameter to dump the artifacts of all the Global Configuration Management project areas on the server.

 No N/A

Example: Dump artifacts

Dump all the Global Configuration Management artifacts for either one project area or all project areas into a directory on the server.

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

cd C:\JazzInstallDir\server
repotools-gc.bat -dumpArtifacts adminUserId=userId adminPassword=password dumpDirectory=C:\dumpDirectory [projectArea=projectAreaName]

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

cd JazzInstallDir/server
./repotools-gc.sh -dumpArtifacts adminUserId=userId adminPassword=password dumpDirectory=dumpDirectory [projectArea=projectAreaName]

After you run this command, search the output files for data spills or occurrences of sensitive data. Then, a team member assigned the Global Configuration Management Administrator role can use the Scrub commands in the Global Configuration Management application to delete sensitive information from those configurations and components, or delete user-defined queries that contain any sensitive data.

Example: List dump jobs

Show details of the dump jobs that were initiated since the last server restart: start and finish times, duration, status, project area (if provided), and location of the output files.

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

cd C:\JazzInstallDir\server
repotools-gc.bat -dumpArtifacts adminUserId=userId adminPassword=password

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

cd JazzInstallDir/server
./repotools-gc.sh -dumpArtifacts adminUserId=userId adminPassword=password