サーバー構成 > コンフィギュレーション管理用のファイルボルト > 既存のリビジョンのファイルボルトへの移行
既存のリビジョンのファイルボルトへの移行
PTC RV&S データベースから有効なリビジョンを抽出し、1 回の一括操作でこれらのリビジョンをコンフィギュレーション管理用のファイルボルトに移動することができます。有効なリビジョンには、以下に示すリビジョンが含まれます。
• バイナリアーカイブのリビジョン
• アーカイブの保存形式が参照による保存に設定されているテキストアーカイブのリビジョン
リビジョンをデータベースからボルトに移行する際は、正規のアーカイブの場所によってリビジョンの保存場所が決まります。次の例を考えてみます。
ProjectA は、リビジョンをファイルボルトに保存するように構成されています。ProjectB は、リビジョンをデータベースに保存するように構成されています。ProjectA のサブプロジェクトは、共有サブプロジェクトとして ProjectB と共有されています。
共有サブプロジェクトの正規の場所は ProjectA の階層内にあるため、この共有サブプロジェクトメンバーの正規のアーカイブの場所も ProjectA の下になります。このため、共有サブプロジェクトのリビジョンはファイルボルトに保存されます。
既存のリビジョンのファイルボルトへの移行
CLI で既存のリビジョンをファイルボルトに移行するには:
* 
管理者が既存のリビジョンをファイルボルトに移行するには、AdminServer 権限が必要です。
* 
このオプションの移行手順は 1 回かぎりで、実行すると元に戻すことができなくなります。また、実行中にシステムパフォーマンスが低下する場合があります。コンフィギュレーション管理用のファイルボルトに PTC RV&S のリビジョンを保存すると、データベースに戻すことができなくなります。
移行を開始する前に、データをバックアップすることをお勧めします。
1. ファイルボルトが正しく構成されていて、ファイルボルトのディレクトリが PTC RV&S Server のファイルシステム上に存在していることを確認します。詳細については、ファイルボルトの構成を参照してください。
2. 次のファイルボルト移行コマンドを実行し、リポジトリ内のすべての有効なリビジョンをファイルボルトに移行します。 si diag --diag="migrateRevisionsFromDBToFileVaultAsPerPolicy"
migrateRevisionsFromDBToFileVaultAsPerPolicy 診断コマンドには次のオプションがあります。
• path を指定すると、コンフィギュレーション管理プロジェクトパスがファイルボルトに移行されます。このパラメータを指定した場合、指定したプロジェクトパス上の有効なリビジョンだけが移行されます。このパラメータを使用して指定できるのは、1 つのプロジェクトだけです。このパラメータを指定しなかった場合、すべての有効なコンフィギュレーション管理プロジェクトが移行の対象となります。
* 
この path パラメータで指定したプロジェクトでは、コンフィギュレーション管理ポリシーの「「参照による保存」メンバーリビジョンにファイルボルトを使用」を設定する必要があります。このポリシーがプロジェクトレベルで無効になっている場合、このプロジェクトの有効なリビジョンは移行されません。コンフィギュレーション管理ポリシーの設定方法については、「標準ポリシーを設定するには」のトピックを参照してください。
このパラメータのプロジェクトパスは、プロジェクトの正規パスとして指定する必要があります。たとえば、ProjectDirectory/demoMigrate/project.pj にある demoMigrate プロジェクトを移行するには、/project.pj を除外して正規のプロジェクトパスだけを指定したコマンド構文を CLI で入力します。正規パスを使用してプロジェクトを指定する方法の詳細については、CLI マニュアルページ を参照してください。
• count により、ファイルボルトに移行する処理対象のアーカイブの最大数を指定します。移行時は、アーカイブのすべてのリビジョンが移動され、最も古いリビジョンが最優先されます。
• before により、サーバーの日付と時刻を指定します。指定した日時を過ぎると、リビジョンは移行されなくなります。
たとえば、リポジトリ内で最も古い 100件の demoMigrate リビジョンをファイルボルトに移行するには、次のコマンドを実行します。
si diag --diag="migrateRevisionsFromDBToFileVaultAsPerPolicy"
--param=path="/demoMigrate" --param=count=100
作成のタイムスタンプが 2015 年 1 月 1 日よりも前になっている demoMigrate リビジョンをすべて移行するには、次のコマンドを実行します。
si diag --diag="migrateRevisionsFromDBToFileVaultAsPerPolicy"
--param=path="/demoMigrate" --param=before="2015/01/01 12:00:00"
* 
パラメータを何も指定しなかった場合、システム内のすべての有効なリビジョンが、データベースからファイルボルトに永続的に移行されます。
移行コマンドの実行が完了すると、移行サマリーが次のように表示されます。
--------Archives Statistics--------
Migrated= , Skipped=
--------Revision Statistics--------
Migrated= , Failed= , Skipped=
リビジョン統計などのその他の詳細情報は、PTCRV&SServerinstalldir/log フォルダ内の DB_to_FileVault_Migration.log ファイルに記録されます。
古いリビジョンのファイルボルトへの移行
古いリビジョンをデータベースに移行することなく、新しいリビジョンをデータベース内に保存することができます。この特別なコンフィギュレーションモードを使用するには、ファイルボルトのプロパティを無効にしたまま、有効なファイルボルトの場所を構成する必要があります。次に、移行を実行して有効なリビジョンをファイルボルトに保存します。これにより、新しく作成されたリビジョンは、すべてデータベースに保存されるようになります。
古いリビジョンだけをファイルボルトに移行するには:
1. PTC RV&S Server を停止します。
2. PTCRV&SServerinstalldir/config/properties フォルダ内の si.properties ファイルで、si.vault.location= を使用してボルトの場所を指定し、ボルトのサポートが無効 (si.vault.enable=false) になっていることを確認します。
3. PTC RV&S を起動します。
Server を起動します。
4. PTC RV&S Administration Client で、コンフィギュレーション管理ポリシーの「「参照による保存」メンバーリビジョンにファイルボルトを使用」をグローバルに有効にするか、特定のプロジェクトに対して有効にします。
5. ファイルボルト移行コマンド si diag migrateRevisionsFromDBToFileVaultAsPerPolicy を実行します。特定のプロジェクトをファイルボルトに保存する場合は path オプションを指定し、必要に応じて、before オプションなど、その他のサポートされているオプションを指定します。
古いリビジョンをファイルボルトに移行し、その後追加のリビジョンを移行する予定がない場合は、「「参照による保存」メンバーリビジョンにファイルボルトを使用」ポリシーを削除してかまいません。
* 
ファイルボルトがすでに有効になっている状態で古いリビジョンデータを移行するには、ファイルボルトを一時的に無効にし、ファイルボルトに保存するプロジェクトの「「参照による保存」メンバーリビジョンにファイルボルトを使用」ポリシーを有効にします。次に、そのプロジェクトの移行コマンドを実行します。移行が完了したらこのポリシーを削除し、ファイルボルトを再び有効にして、新しいリビジョンのファイルボルトへの保存を再開します。
* 
ファイルボルトに移行したデータがこれまで使用していたスペースを再利用するには、データベースを圧縮する必要があります。サポートが必要な場合は、データベースの管理者に連絡してください。
これは役に立ちましたか?