ccmdb upgrade コマンド

アップグレード・プログラムは、データベースをリリース 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        

フィードバック