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