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
- To run ccc upgradeSyncStream after
you have used ccc login to create stored
credentials:
ccc upgradeSyncStream [ -r
| --repository-uri ] repository URI or nickname { [ -v | --verbose ] } [synchronized stream [...] | [ --L | --locallySyncd] ]
- To run ccc upgradeSyncStream supplying
credentials on the command line:
ccc upgradeSyncStream [ -r | --repository-uri ] repository URI [ -u | --username ] user ID in repository [ -P | --password ] password for user ID in repository { [ -v | --verbose ] } [synchronized stream [...] | [ --L | --locallySyncd] ]
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.