Repository tools command to export SCM components
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 only contains data that is 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. 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 left in the locked state by a failed or interrupted export. | No | N/A |
Example
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
Open a command line and enter this command:
cd /opt/IBM/JazzTeamServer/server/ ./repotools-ccm.sh -scmExportComponent components=_iIfDAEKSEd2A5aJWEO8dbA,_pN8RYPi-Ed2J16MAqQXG5g toFile=./exportComponents.tar