ccmdb upgrade command

The upgrade program converts a database from Releases 7.0, 7.1, 7.1a, or 7.2 to the 7.2 or later release. This command does not support individual model installs.

Synopsis

ccmdb upgrade
        [-f model_file]
        [-m model1,model2 ...]
        [-url server_url]
        [-l log_file] 
        database_path1 database_path2 ...

Uses

You must upgrade a database from a previous release before you use it with the 7.2 or later release.

You must be ccm_root to run this command.

The database to be upgraded must be on a 7.2 or later or later release database server. You can upgrade a previous server with the ccm_install -u -s server command, 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 absolute paths to databases visible from the current computer.
-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. Nonstandard models are not documented in this information center.
-m model1,model2 ...
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 is 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.
l log_file
This option specifies the file where the log messages related to this upgrade command shall be written.
-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 Rational Synergy session on a database, enter cmsynergy -s <server_url>.
Ensure that the server_url is a valid URL for a compatible server, starting with either http:// or https://
-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 conventions. 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 database /vol/ccmdbs/production1 to Release 7.2 or later, using the default model file:

ccm_root$ ccmdb upgrade /vol/ccmdbs/production1


Feedback