The upgrade program converts a database from Releases 7.0, 7.1, or 7.1a to
the 7.2 or later release. This command does not support individual
model installs.
Synopsis
ccmdb upgrade
[/f model_file]
[/m] model [model ...]]
[/db_update_only] [/v] [/url server_url]
[/l log_file] [/w] [/url server_url]
database_path1 [database_path2]...
Uses
You must be the CM Administrator to
run this command. You must be logged on to the database server.
You
must upgrade a database from a previous release before you use it
with the 7.2 or later release.
The
database to be upgraded must be on a 7.2 or later release
database server. You can upgrade a previous server, or you can first
pack or dump from the previous server that is running the previous
release. Then, you can unpack or load the server into a 7.2 or later release
server.
Options and arguments
- database_path [database_path
...]
- This option specifies the list of databases to be upgraded. These
paths must be UNC paths to databases on the server where you are logged
on.
- /f model_file
- This option specifies the model package file name. If you do not
specify the model file, the default model name CCM_HOME\packfiles\base.model is
used. Use of non-standard models is not documented in this information
center.
- This option must be a UNC path.
- /m model [model ...]
- This option specifies the list of model names to be installed.
The model name is the same name as the model project name in the model
database. The default models that are shipped are the base and modsup models.
Note: Each model in the model file must have a unique name.
- If this option is not specified, ccmdb upgrade reads
the models that are currently installed on each database and upgrades
them.
- If this option is specified, the new list is used to override
the current models. The sequence of the models that are listed in
this option is the sequence of the models to be installed in the target
database. All the current models that are not in the specified list
are removed. As a result, specifying the option /m base causes
the database to be upgraded to a Rational® base
model, removing all custom models present in a previous release.
- /url server_url
- This option specifies the CCM server that the upgraded databases
must connect to. By default, upgraded databases are connected to the
server on the default port of the database server host. The default
port is the one you specified as the help server port during installation.
It is saved in the $CCM_HOME/etc/system_info.txt file.
- To start a session on a database, enter cmsynergy /s server_url.
- Start with either http:// or https:// to
ensure that the server_url is a valid URL for a
compatible server.
- /w
- This option checks all database configuration files and controlled
files of type ascii or its subtypes and converts
the line endings from Windows to UNIX conventions or UNIX to Windows conversions.
This process occurs during the upgrade. The conversion affects controlled
files in the archive and cache only. No work areas are updated.
Note: Because this operation changes the contents of static, archived
files, use with caution. Always retain the original pack file in case
any problems are discovered.
Example
Upgrade the two databases \\elite\ccmdbs\production1 and \\elite\ccmdbs\testdb to
the 7.2 or later release, using the default model file. Log on to elite as
the CM Administrator, open a command-line utility, and then issue
this command:
ccmdb upgrade \\elite\ccmdbs\production1
\\elite\ccmdbs\testdb