アップグレード・プログラムは、データベースをリリース 7.0、7.1、7.1a、7.2 以降 から 7.2 以降のリリースに変換します。
このコマンドでは、個別のモデルのインストールはサポートされていません。
概要
ccmdb upgrade
[/f model_file]
[/m model1,model2,...]
[/url server_url]
[/l log_file]
[/w]
database_path1 database_path2 ...
用途
このコマンドを実行するには、CM アドミニストレーターである必要があります。オンデータベース・サーバーにログオンされている必要があります。
旧リリースのデータベースは、7.2 以降リリースで使用する前にアップグレードする必要があります。
アップグレードするデータベースは 7.2 以降リリースのデータベース・サーバー上になければなりません。古いサーバーをアップグレードできます。あるいは、最初に旧リリースを実行している古いサーバーからデータベースのパックまたはダンプを行うことができます。
その後、そのデータベースを 7.2 以降リリースのサーバーにアンパックまたはロードできます。
オプションおよび引数
- database_path1 database_path2
...
- この引数は、アップグレードするデータベースのリストを指定します。
これらのパスは、ログオンしたサーバー上のデータベースの UNC パスである必要があります。
- /f model_file
- このオプションでは、モデル・パッケージ・ファイル名を指定します。モデル・ファイルを指定しない場合、
デフォルト・モデル名 CCM_HOME¥packfiles¥base.model が使用されます。標準以外のモデルの使用については、このインフォメーション・センターでは説明しません。
- このオプション値は、UNC パスでなければなりません。
- [/m model1,model2...]
- このオプションでは、インストールするモデル名のリストを指定します。モデル名は、モデル・データベースのモデル・プロジェクト名と同じです。付属の
デフォルト・モデルは base モデルおよび modsup モデルです。
注: モデル・ファイルの各モデルには固有の名前が必要です。
- このオプションが指定されない場合、ccmdb upgrade は現在各データベースにインストールされているモデルを読み取り、それらのモデルをアップグレードします。
- このオプションが指定された場合は、新しいリストが使用されて、現行モデルがオーバーライドされます。ターゲット・データベースへの
モデルのインストール順序は、
このオプションでモデルがリストされている順序と同じです。指定されたリストに存在しない現行モデルはすべて削除されます。したがって、オプション /m base を指定すると、データベースが Rational® ベース・モデルにアップグレードされ、旧リリースに存在するカスタム・モデルがすべて削除されます。
- /url server_url
- このオプションでは、アップグレード後のデータベースが接続する必要がある CCM サーバーを指定します。デフォルトでは、アップグレード後のデータベースはデータベース・サーバー・ホストのデフォルト・ポートでこのサーバーに接続します。デフォルト・ポートは、インストール時に CCM サーバー・ポートとして指定したポートです。
これは $CCM_HOME/etc/system_info.txt ファイルに保存されています。
- データベースでセッションを開始するには、cmsynergy /s server_url と入力します。
- server_url が互換サーバーで有効な URL になるように、http:// または https:// で開始します。
- /l log file
- このオプションは、このアップグレード・コマンドに関連したログ・メッセージが書き込まれるログ・ファイルを指定します。
- /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