The upgrade program converts a database from Releases 7.0, 7.1, or 7.1a to
the 7.2 or later 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 upgrade a database from a
previous release before you use it with the 7.2 or later 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 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 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 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.
- -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 or
later, using the default model file:
ccm_root$ ccmdb
upgrade /vol/ccmdbs/production1