Repository tools command to export SCM components

Edit online

Use the scmExportComponent command to export the contents of source-control management (SCM) components to a .tar file.

Purpose

The scmExportComponent command exports the contents of a database, scoped to a set of SCM components, to a .tar file.

The exported .tar file contains data that is only part of the specified SCM components and is not a full database export. You can import the .tar file onto a different server.

Note:
  • To export components that are accessible to users, the server must be offline. To export a component while the server is running, the component must first be archived by using the command: scm set attributes -C <component UUID> --ownedby <admin user> --visibility archived. Archived components are locked during the export and cannot be unarchived during this time.
  • Before you import components, ensure that they do not exist on the server already. All components in the archive are imported together.
  • •The following data is included in an exported component archive:
    • The component, contained baselines, history, and change sets.
    • All files and folders modified by change sets in the component, and all content that is associated with those files.
    • Version identifiers, item permissions, and custom attributes for any files and folders that are part of the export.
    • Contributor information for all users who create or modify any exported item.
  • The following data is not included in an exported component archive:
    • The current state of the component in the workspace or stream, and the history of operations performed in a stream or workspace. Before you export, create baselines to record the current state of any notable streams or workspaces.
    • Snapshots are not included, but the individual baselines on components being exported are included.
    • Baseline hierarchies are not included, but the individual baselines on components being exported that make up the hierarchy are included.

Parameters

In addition to the standard command-line arguments available to the repotools command, the following arguments are available.

Attribute Description Required Default
toFile Path to the .tar file into which to export data. Yes N/A
logFile Path to the log file. No repotools-application_scmExportComponent.log where application is usually ccm.
overwrite Specify whether to overwrite the file specified by the toFile attribute. Valid values: yes, no, true, and false. No no
components The list of components to export. A comma-separated list of UUIDs. Yes N/A
noVerify Does not perform component verification before export. No N/A
resetLocks Resets component locks instead of performing a component export. Can be used to manually unlock a component that is in the locked state by a failed or interrupted export. No N/A

Example

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

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-ccm.bat  -scmExportComponent components=_iIfDAEKSEd2A5aJWEO8dbA,_pN8RYPi-Ed2J16MAqQXG5g toFile=exportComponents.tar

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

cd /opt/IBM/JazzTeamServer/server/
./repotools-ccm.sh  -scmExportComponent components=_iIfDAEKSEd2A5aJWEO8dbA,_pN8RYPi-Ed2J16MAqQXG5g toFile=./exportComponents.tar