プロジェクトのアップグレード

以前のバージョンの ALM で作成されたプロジェクトを現在のバージョンの ALM で使用するには、現在のバージョンの ALM に必要な設定に合わせるために、プロジェクトをアップグレードする必要があります。

アップグレードする場合は、その前に、プロジェクトの検証と修復を行って、データベースのユーザ・スキーマとデータのエラーを検出し修復してください。

概要

プロジェクトの検証、修復、アップグレードの前に、次のことを理解しておいてください。

プロジェクトのバックアップ	修復プロセスまたはアップグレード・プロセスを実行すると、ALM はプロジェクトに変更を加えて、現在のバージョンの ALM の仕様に合わせます。プロジェクトの修復またはアップグレードを開始する前に、プロジェクトをバックアップする必要があります。修復プロセスは、プロジェクト・データベース・スキーマに対してのみ変更を行います。修復プロセスの前には、データベース・サーバ上のプロジェクト・データベース・スキーマのバックアップは必要ですが、ファイル・システム内のプロジェクト・データのバックアップは不要です。アップグレード・プロセスの前には、プロジェクト・データベース・スキーマとプロジェクト・データを含むプロジェクトのフルバックアップを行ってください。
例外ファイルの定義	テーブル、カラムの追加などでスキーマが変更済みの場合は、アップグレード・プロセスが失敗することがあります。データベースのユーザ・スキーマに手動で追加されたオブジェクトで、スキーマ設定ファイルに定義されていないものについては、例外ファイルを定義できます。そうすることで、このような変更をアップグレード・プロセス中に無視するよう ALM に指示します。検証、修復、アップグレードのプロセスを実行するときは、同じ例外ファイルを使用する必要があります。例外ファイルは、1 つのプロジェクトに対して設定することも、「サイト管理」内のすべてのプロジェクトに対して設定することもできます。
検証プロセス	検証プロセスを実行して、データベースのユーザ・スキーマとデータが正しいことを確認します。以前のバージョンの ALM ではデータベースのユーザ・スキーマとデータが正しい場合でも、現在のバージョンの ALM の仕様には合っていないことがあります。検証プロセスでは、環境、設定、スキーマ構造、データ整合性に関する問題で、アップグレードを失敗する原因となる可能性があるものが検出されます。このプロセスでは、ALM で修復できる問題と、ユーザが手動で修復する必要がある問題を知らせる検証ログが生成されます。
修復プロセス	修復プロセスでは、検証プロセスで見つかった、データとスキーマのほとんどの問題が修正されます。データの損失を招く可能性がある問題が検証プロセスで検出された場合、その問題が修復プロセスで自動的に修正されることはありません。これらの問題は手動で修復する必要があります。特定の問題が自動的に処理されるかどうかを調べるには、検証ログを参照してください。
修復/アップグレード・モード	標準設定では、修復プロセスとアップグレード・プロセスは非サイレント・モードで実行されます。プロセスを非サイレント・モードで実行しているときにエラーが発生すると、処理が一時停止され、情報の入力が求められる場合があります。このモードの代わりに、サイレント・モードでプロセスを実行することもできます。プロセスがサイレント・モードで実行されている場合、ALM はユーザの入力を求めずにプロセスを中止します。
検証、修復、またはアップグレードされたプロジェクトの以前のバージョンでの使用	検証または修復したプロジェクトは、以前の ALM バージョンで今までどおり使用できます。アップグレードしたプロジェクトは、以前の ALM バージョンでは使用できなくなります。

先頭に戻る

アップグレード・バージョン

次の表は、以前の ALM バージョンから直接アップグレードできる最新の ALM バージョンを示しています。

対象バージョン	直接アップグレードをサポートする最終バージョン
ALM 11.0	ALM 12.2
ALM 11.5x	ALM 12.5
ALM 12.0	ALM 15.0
ALM 12.2 - 15.0.x	ALM 15.5
ALM 12.5x - 15.x.x	ALM 16.0.x
ALM 12.6x - 16.0.x	ALM 17.0

先頭に戻る

プロジェクトのバックアップ

プロジェクトの完全バックアップには、プロジェクト・データベース・スキーマのバックアップとプロジェクト・データのバックアップが含まれます。

修復プロセスは、プロジェクト・データベース・スキーマに対してのみ変更を行います。修復プロセスを実行する前に、データベース・サーバ上のプロジェクト・データベース・スキーマをバックアップしてください。ファイル・システム内のプロジェクト・データをバックアップする必要はありません。

アップグレード・プロセスの前には、プロジェクト・データベース・スキーマとプロジェクト・データを含むプロジェクトのフルバックアップを行ってください。

データベース・サーバ上のプロジェクト・データベース・スキーマをバックアップするには、次の手順を実行します。

Microsoft SQL データベース	Microsoft SQL データベース・スキーマのバックアップ方法の詳細については、「How to back up and restore MS SQL database」を参照してください。
Oracle データベース	Oracle データベース・スキーマのバックアップ方法の詳細については、「How to export and import an Oracle database to dump files」を参照してください。

ファイル・システムのプロジェクト・データをバックアップするには、次の手順を実行します。

ファイル・システムで、すべてのデータ（自動テスト・スクリプトと結果、添付）が ALM のインストール時に定義したリポジトリにあるプロジェクト・ディレクトリに保存されていることを確認します。このプロジェクト・ディレクトリを、サブディレクトリとファイルをすべて含めてコピーします。

先頭に戻る

例外ファイルの定義

例外ファイルを使用すると、特別なテーブル、ビュー、カラム、シーケンスに対する警告を無視できます。例外ファイルは、1 つのプロジェクトに対して設定することも、すべてのプロジェクトに対して設定することもできます。

例外ファイルを定義するには、次の手順を実行します。

ALM インストール・ディレクトリにある SchemaExceptions.xml ファイルをコピーします。このファイルは、標準設定では＜ALM のインストール・パス＞\data\sa\DomsInfo\MaintenanceData にあります。

例外ファイル（my_exceptions.xml など）を作成し、次のように例外を定義します。

特別なテーブルについて：

Copy code

<TableMissing>
         <object pattern="MY_Table" type="extra"/> 
</TableMissing>

特別なビューについて：

Copy code

<ViewMissing>
         <object pattern="MY_VIEW" type="extra"/> 
</ViewMissing>

特別なカラムについて：

Copy code

<ColumnMissing>
         <object pattern="MY_COLUMN" type="extra"/> 
</ColumnMissing>

特別なシーケンスについて：

Copy code

<SequenceMissing>
         <object pattern="MY_SEQUENCE" type="extra"/> 
</SequenceMissing>

例外ファイルを 1 つのプロジェクトに対して設定するには、次の手順で行います。
1. ［サイト管理］＞［プロジェクト］タブを開きます。
2. プロジェクトのリストからプロジェクトを選択します。
3. ［詳細］タブの［プロジェクトデータベース］セクションの［例外ファイル］フィールドに、例外ファイルの場所を入力します。
例外ファイルをすべてのプロジェクトに対して設定するには、UPGRADE_EXCEPTION_FILE パラメータを追加し、例外ファイルの場所を定義します。
サイト・パラメータの設定方法の詳細については、「設定パラメータの指定」を参照してください。

先頭に戻る

プロジェクトの検証

検証プロセスは、個々のプロジェクトレベルでご実行するか、ドメイン・レベルで実行して、ドメイン内の複数またはすべてのプロジェクトを検証できます。

個々のプロジェクトを検証するには、次の手順を実行します。

［サイト管理］＞［プロジェクト］タブを開きます。
プロジェクトのリストからターゲット・プロジェクトを選択し、［プロジェクトのメンテナンス］＞［プロジェクトの検証］をクリックします。
［プロジェクトの検証］をクリックして、検証プロセスを開始します。
プロジェクトがまだアクティブな場合は、最初に非アクティブにするように求めるメッセージが表示されます。
プロセスの実行中にエラーが発生すると、メッセージ・ボックスが開きます。状況に応じて、［中断］または［再試行］をクリックしてください。
検証プロセスを中止するには、［中断］をクリックし、確認ダイアログ・ボックスで［はい］をクリックします。
検証プロセスを一時停止するには、［一時停止］をクリックします。続行するには、［再開］をクリックします。
検証プロセスが完了するまで待ちます。
検証プロセスが完了すると、検証ログが次のディレクトリに保存されます。
＜ALM リポジトリ・パス＞\sa\DomsInfo\MaintenanceData\out\＜ドメイン名＞\＜プロジェクト名＞
検証ログをテキスト・ファイルにエクスポートするには、［ログのエクスポート］をクリックします。
検証ログをクリアするには、［ログのクリア］をクリックします。
検証ログを分析します。このログには、ALM で修復できる問題と、ユーザが手動で修復する必要がある問題が示されます。

ドメイン内の複数またはすべてのプロジェクトを検証するには、次の手順を実行します。

［サイト管理］＞［プロジェクト］タブを開きます。
プロジェクトのリストからターゲット・ドメインを選択し、［ドメインのメンテナンス］＞［ドメインの検証］をクリックします。
ターゲット・プロジェクトを選択するか、［プロジェクト名］カラムのチェックボックスをクリックしてすべてのプロジェクトを選択します。
［プロジェクトの検証］をクリックします。
選択したプロジェクトのいずれかがまだアクティブな場合は、最初にそのプロジェクトを非アクティブにするように求められます。
プロセスの実行中にエラーが発生すると、メッセージ・ボックスが開きます。状況に応じて、［中断］または［再試行］をクリックしてください。
検証プロセスを中止するには、［中断］をクリックし、確認ダイアログ・ボックスで［はい］をクリックします。
検証プロセスを一時停止するには、［一時停止］をクリックします。続行するには、［再開］をクリックします。
検証プロセスが完了するまで待ちます。
検証プロセスが完了すると、検証ログが次のディレクトリに保存されます。
＜ALM リポジトリ・パス＞\sa\DomsInfo\MaintenanceData\out\＜ドメイン名＞\＜プロジェクト名＞
検証ログをテキスト・ファイルにエクスポートするには、［ログのエクスポート］をクリックします。
検証ログをクリアするには、［ログのクリア］をクリックします。
検証ログを分析します。このログには、ALM で修復できる問題と、ユーザが手動で修復する必要がある問題が示されます。

先頭に戻る

プロジェクトの修復

修復プロセスは、個々のプロジェクトレベルで実行するか、ドメイン・レベルで実行してドメイン内の複数またはすべてのプロジェクトを修復できます。

前提条件：

プロジェクトをバックアップします。
検証ログに ALM では修正できないと示されている問題を修復します。「プロジェクトの検証」を参照してください。

個々のプロジェクトを修復するには、次の手順を実行します。

［サイト管理］＞［プロジェクト］タブを開きます。
プロジェクトのリストからターゲット・プロジェクトを選択し、［プロジェクトのメンテナンス］＞［プロジェクトの修復］をクリックします。
修復プロセスをユーザの介在なしで実行するには、［サイレントモードで実行］を選択します。
修復プロセスを開始するには、［プロジェクトの修復］をクリックします。
プロジェクトがまだアクティブな場合は、最初に非アクティブにするように求めるメッセージが表示されます。
プロセスの実行中にエラーが発生すると、メッセージ・ボックスが開きます。状況に応じて、［中断］または［再試行］をクリックしてください。
修復プロセスを中止するには、［中断］をクリックし、確認ダイアログ・ボックスで［はい］をクリックします。
修復プロセスを一時停止するには、［一時停止］をクリックします。続行するには、［再開］をクリックします。
修復プロセスが完了するまで待ちます。
修復ログをテキスト・ファイルにエクスポートするには、［ログのエクスポート］をクリックします。
修復ログをクリアするには、［ログのクリア］をクリックします。

ドメイン内の複数またはすべてのプロジェクトを修復するには、次の手順を実行します。

［サイト管理］＞［プロジェクト］タブを開きます。
プロジェクトのリストからターゲット・ドメインを選択し、［ドメインのメンテナンス］＞［ドメインの修復］をクリックします。

修復設定を設定します。

修復モード

次のオプションを選択できます。

サイレント・モードで実行：ユーザの介在なしでプロセスを実行します。
失敗した場合は次のプロジェクトに進む：修復が失敗した場合に、その次のプロジェクトに進みます。これは、標準設定のオプションです。

修復後

次のいずれかのオプションを選択します。

すべてのプロジェクトを非アクティブのままにする：修復プロセスの完了後に、すべてのプロジェクトを非アクティブのままにしておきます。
現在アクティブなプロジェクトのみをアクティブ化する：アクティブだったプロジェクトは、修復プロセスの終了後に再びアクティブにします。これは、標準設定のオプションです。
すべてのプロジェクトをアクティブ化する：修復プロセスの完了後に、すべてのプロジェクトをアクティブにします。

ターゲット・プロジェクトを選択するか、［プロジェクト名］カラムのチェックボックスをクリックしてすべてのプロジェクトを選択します。
［プロジェクトの修復］をクリックします。
選択したプロジェクトのいずれかがまだアクティブな場合は、最初にそのプロジェクトを非アクティブにするように求められます。
プロセスの実行中にエラーが発生すると、メッセージ・ボックスが開きます。状況に応じて、［中断］または［再試行］をクリックしてください。
修復プロセスを中止するには、［中断］をクリックし、確認ダイアログ・ボックスで［はい］をクリックします。
修復プロセスを一時停止するには、［一時停止］をクリックします。続行するには、［再開］をクリックします。
修復プロセスが完了するまで待ちます。
修復ログをテキスト・ファイルにエクスポートするには、［ログのエクスポート］をクリックします。
修復ログをクリアするには、［ログのクリア］をクリックします。

先頭に戻る