アップグレード・プログラムによって、データベースがリリース 7.0、
7.1、7.1a、または 7.2 から 7.2 以降 のリリースに変換されます。
このコマンドでは、個別のモデルのインストールはサポートされていません。
概要
ccmdb upgrade
[-f model_file]
[-m model1,model2 ...]
[-url server_url]
[-l log_file]
database_path1 database_path2 ...
用途
旧リリースのデータベースは、7.2 以降 のリリースで使用する前にアップグレードする必要があります。
このコマンドを実行するには ccm_root である必要があります。
アップグレードするデータベースは 7.2 以降 以降のリリースのデータベース・サーバー上になければなりません。ccm_install
-u -s server コマンドを使用して、古いサーバーをアップグレードできます。あるいは、まず、旧リリースを実行している古いサーバーから圧縮またはダンプすることができます。次に、そのサーバーを 7.2 以降 のリリースのサーバーにアンパックまたはロードできます。
オプションおよび引数
- database_path [database_path
...]
- このオプションでは、アップグレード対象のデータベースのリストを指定します。指定するパスは、現行コンピューターにとって可視のデータベースの絶対パスでなければなりません。
- -f model_file
- このオプションでは、モデル・パッケージ・ファイル名を指定します。
- モデル・ファイルを指定しない場合、デフォルト・モデル名 $CCM_HOME/packfiles/base.model が使用されます。標準以外のモデルについては、このインフォメーション・センターには記載されていません。
- -m model1,model2 ...
- このオプションでは、インストールするモデル名のリストを指定します。モデル名は、モデル・データベースのモデル・プロジェクト名と同じです。付属のデフォルト・モデルは base モデルおよび modsup モデルです。
注: モデル・ファイルの各モデルには固有の名前が必要です。
- このオプションが指定されていない場合、ccmdb upgrade は、各データベースに現在インストールされているモデルを読み取り、それらをアップグレードします。
- このオプションが指定された場合は、新しいリストが使用されて、現行モデルがオーバーライドされます。ターゲット・データベースへのモデルのインストール順序は、このオプションでモデルがリストされている順序と同じです。指定されたリストに存在しない現行モデルはすべて削除されます。したがって、オプション -m base を指定すると、データベースが Rational® ベース・モデルにアップグレードされ、旧リリースに存在するカスタム・モデルがすべて削除されます。
- l log_file
- このオプションは、このアップグレード・コマンドに関連するログ・メッセージが書き込まれるファイルを指定します。
- -url server_url
- このオプションでは、アップグレード後のデータベースが接続する必要がある CCM サーバーを指定します。デフォルトでは、アップグレード後のデータベースはデータベース・サーバー・ホストのデフォルト・ポートでこのサーバーに接続します。デフォルト・ポートは、インストール時にヘルプ・サーバー・ポートとして指定したポートです。これは $CCM_HOME/etc/system_info.txt ファイルに保存されています。
- データベースで Rational Synergy セッションを開始するには、cmsynergy -s <server_url> と入力します。
- server_url が、互換サーバーの有効な URL であり、http:// または https:// で始まっていることを確認してください。
- -w
- このオプションを指定すると、タイプ ascii およびそのサブタイプであるデータベース構成ファイルおよび制御ファイルがすべて検査され、行末が Windows の規則から UNIX 規則に、または UNIX の規則から Windows の規則に変換されます。
この処理はアップグレード中に実行されます。この変換の影響を受けるのは、アーカイブとキャッシュに入っている制御ファイルのみです。ワークエリアは更新されません。
注: この操作は静的アーカイブ・ファイルの内容を変更するため、使用する際には十分に注意してください。問題が検出された場合に備えて、元のパック・ファイルを常に保持しておいてください。
例
以下のデフォルト・モデル・ファイルを使用して、データベース /vol/ccmdbs/production1 をリリース 7.2 以降 にアップグレードします。
ccm_root$ ccmdb upgrade /vol/ccmdbs/production1