Repository tools command to import repository data with concurrent processing

Use the importConcurrent command to import repository data from a compressed export file using concurrent processing for improved performance.

Purpose

The importConcurrent command imports repository data using multiple internal worker threads to parallelize the import operation within a single import process. This improves performance through internal concurrent processing, not by running multiple imports simultaneously.
Important: Like exportConcurrent, this command does not mean running multiple imports at the same time. It enables concurrent processing within a single import operation to improve performance through parallelization.
Important: You must shut down the server before you run the command.

Prerequisites

  • A valid export file created by exportConcurrent or export command
  • The target database must be properly configured
  • Sufficient database space for the imported data

Parameters

Attribute Description Required Default
fromFile Path and file name of the export file to import. Yes N/A
statsEnabled Enables or disables statistics logging during the import operation. Valid values: yes, no No yes
statsLogFrequency Specifies how often (in seconds) statistics are written to the log file. Valid values: Integer from 1 to 1440. No 60
teamserver.properties The path to the teamserver.properties file. No conf/${com.ibm.team.repository.provision.context.path}/teamserver.properties
logFile Path to the log file. No ${com.ibm.team.repotools.rcp.scriptName}_importConcurrent.log
noEstimate Skips the estimation phase before starting the import. Begins the import immediately without calculating the estimated time. No None
noPrompt Runs the command without prompting for user confirmation. Use for automated scripts. No None
skipRebuildIndices Skips the index rebuilding phase after import. This can significantly reduce import time, but indices must be rebuilt manually later using the reindex command. No None

Examples

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:

Basic import with default settings:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-ccm.bat -importConcurrent fromFile=../export/ccm_backup.zip

Import without estimation or prompts:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-ccm.bat -importConcurrent fromFile=../export/ccm_backup.zip noEstimate noPrompt

Import with custom statistics logging:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-ccm.bat -importConcurrent fromFile=../export/ccm_backup.zip statsEnabled=yes statsLogFrequency=30

Import and skip index rebuilding:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-ccm.bat -importConcurrent fromFile=../export/ccm_backup.zip skipRebuildIndices noPrompt

Complete automated import:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-ccm.bat -importConcurrent fromFile=../export/ccm_backup.zip noEstimate noPrompt statsEnabled=yes

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

cd opt/IBM/JazzTeamServer/server
./repotools-ccm.sh -importConcurrent fromFile=../export/ccm_backup.zip noPrompt