upgradeSyncStream, uss

Upgrade ClearCase Synchronized Stream(s)

Purpose

Note: This subcommand is only available if you have installed the ClearCase Connector.
When migrating to Rational Team Concert™ version 2.0, you must upgrade your ClearCase® Synchronized Streams, using this subcommand, in order for synchronizations to continue running correctly. The ccc upgradeSyncStream subcommand upgrades ClearCase Synchronized Streams in all team and process areas of which the logged-in user is a member. For each synchronization stream specified, this subcommand changes the default buildkind from ant to the command line and copies the credentials file for the synchronization engine to each stream's specific subdirectory. This subcommand must be run on the synchronization host. The alias for ccc upgradeSyncStream is ccc uss.

Synopsis

Options and arguments

-L  |  --locallySyncd ] 
Operate on all synchronized streams that are synchronized on this host.
-P  |  --password ] password for user ID in repository
The password for the specified user ID in the named repository. If this option is not included on the command line, you are prompted for a password. If you specified a repository URI or nickname for which you have stored credentials using the scm login command, this option is ignored.
-r  |  --repository-uri ] repository URI
Specifies the repository in which to take this action. If you have stored repository credentials using the scm login command, you can use the nickname you supplied for these stored credentials
-u  |  --username ] user ID in repository
Specifies a user ID that exists in the named repository. If you specified a repository URI or nickname for which you have stored credentials using the scm login command, this option is ignored.
-v  |  --verbose ]
Provide additional informational messages while operating.
synchronized stream [...]
A space-separated list of synchronized streams, specified by name, on which the upgrade will be performed. You must specify one or more stream names or include the [ -L  |  --locallySyncd ]  option to specify all streams on this host.

Examples

C:\local-workspaces\HelloJazz> ccc uss -v -r https://arteB:9443/jazz -u someOne -P someThing stream stream2 XYZZY
WARNING: Could not resolve XYZZY
stream: updated build kind. Upgrade complete.
stream2: no upgrade required

The output reports the status for each stream listed. If an invalid stream name is entered, the upgrade continues for the remaining streams and a WARNING message is displayed for the invalid stream. A no upgrade required message is displayed for any streams that have already been successfully upgraded.

Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug