Repository tools command to import data into a new database

Use the import command to import the contents of a tar file into a new database.

Purpose

The import command is used to import the contents of a tar file, using the current system encoding, into a new database. This encoding must match the encoding used when the tar file was created.
Note: The import command is only to be used for changing database vendors, for example, going from Derby to Db2®. This command should not be used for backing up databases.
Important:
  • You must make sure that the repotools -export and -import commands are run on servers with same time zone set for the operating systems . There is a known limitation when the import is done in a different OS time zone than the export, data might be lost after the import, especially for configuration enabled projects.
  • You must shut down the server before you run the command.

Parameters

Attribute Description Required Default
fromFile The name of the tar file from which to import data. Yes N/A
teamserver.properties The file system path to the teamserver.properties file. No conf/application/teamserver.properties

where application is jts, ccm, rm, qm, gc, dcc, or relm.

logFile Path to the log file. No repotools-application_import.log

where application is jts, ccm, rm, qm, gc, dcc, or relm.

noPrompt Cause the database tables to be created without confirmation from the user. This option is useful when writing automated scripts. No N/A
noVerify Skip the post-import verification phase. Verification should be performed, and if necessary, can be done separately using the -verify command. No N/A

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 -import fromFile=C:\export.tar teamserver.properties=conf\jts\teamserver.properties

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

cd C:\Program Files\IBM\JazzTeamServer\server\
./repotools-jts.sh -import fromFile=opt/export.tar teamserver.properties=conf/jts/teamserver.properties

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki