スペースのエクスポートとインポート、およびスペースのカスタマイズ

あるスペースからカスタマイズをエクスポートして別のスペースにインポートすることにより、共有スペースのカスタマイズを別のスペースに適用できます。

さらに、スペースをエクスポートして、別のALM Octaneインスタンスに再インポートできます。

このトピックの内容:

共有スペースのカスタマイズのエクスポート

共有スペースのカスタマイズからファイルにデータをエクスポートできます。その後、ファイルを別の共有スペースにインポートできます。ソーススペースとターゲットスペースは共有する必要があり、同じALM Octaneバージョンである必要があります。

エクスポートファイルには、ルール、フィールド (UDFを含む)、ワークフロー (フェーズと遷移、フォーム、ラベル、リスト、エンティティラベル、ロール、データの非表示、および電子メールテンプレート) のエンティティが含まれています。

共有スペースのカスタマイズをエクスポートするには:

1. 設定を展開し、管理>スペースを選択します。
2. 共有スペースを選択します。
3. 左側のペインで、カスタマイズのエクスポートをクリックします。[共有スペースのカスタマイズのエクスポート] ダイアログボックスが開きます。

4. エクスポートをクリックします。データは、標準設定のダウンロードフォルダー内のファイルに保存されます (例: Default Shared Space_1001_15.1.21_entities.zip).

   注: ファイルを抽出しないでください。別の共有スペースにインポートする場合は、このファイルをそのままアップロードします。

トップに戻る

共有スペースのカスタマイズのインポート

このセクションでは、共有スペースのカスタマイズファイルをインポートする方法について説明します。

共有スペースのカスタマイズをインポートするには:

1. 設定を展開し、管理>スペースを選択します。

2. 共有スペースを選択します。

3. 左側のペインで、カスタマイズのインポートをクリックします。[共有スペースのカスタマイズのインポート] ダイアログボックスが開きます。

4. 参照をクリックして、インポートするファイルに移動します (例: Default Shared Space_1001_15.1.21_entities.zip).

   注: ファイルを抽出しないでください。このファイルをそのままアップロードします。

5. インポートをクリックします。ALM Octaneは、ファイルの正しいフォーマットをチェックするための検証を実行します。

6. 検証が失敗した場合、エラーは [共有スペースのカスタマイズのインポート] ダイアログボックスに表示されます。

   例:

   The following role cannot be deleted because users are still assigned to it: [role name].	このエラーは、ユーザーがまだ割り当てられているときにロールを削除しようとすると発生します。続行するには、エクスポートされたスペースからユーザーの割り当てを解除し、エクスポートファイルを再生成して、新しいファイルをインポートします。
   This entity cannot be updated as it does not exist anymore. To successfully complete the import process, delete this entity from the exported space.	このエラーは、存在しなくなったエンティティを更新しようとしたときに発生します。続行するには、エクスポートされたスペースからエンティティを削除し、エクスポートファイルを再生成して、新しいファイルをインポートします。

7. 検証が成功した場合は、差分レポートをクリックして詳細を確認してください。

   差分レポートには、現在のスペースのカスタマイズに適用される変更が一覧表示されます。

   インポートプロセスを続行するには、変更の適用をクリックします。

   インポートプロセスが完了したら、閉じるをクリックします。

   注: 変更を反映するためにブラウザを更新する必要がある場合があります。

トップに戻る

スペースのエクスポートとインポート

スペースをその設定およびデータとともにエクスポートおよびインポートできます。すべての情報は、拡張子がosaの自己完結型ファイルに保存されます。エクスポートにより、以前に設定したスペースをバックアップおよび共有できます。

スペースをエクスポートまたはインポートするときに、スペースのデータを含めるかどうかを指定できます。データを含めない場合は、サイトユーザーとその関係のみが保存/ロードされます。データを含めると、スペースのテーブルとファイルシステムも含まれます。

非常に大きなスペースで作業している場合は、データを除外し、Oracle DUMPなどのデータベースユーティリティを使用してデータとファイルシステムを手動で移行することを選択できます。この方法は、ALM Octaneを介したエクスポートおよびインポートよりも時間がかからず、パフォーマンスに影響を与えません。

一部のオプションのテーブルは非常に大きくなる可能性があり、それらの移行には長い時間がかかる可能性があることに注意してください。エクスポートするときに、検索と実行の履歴、傾向、および監査情報を含めるかどうかを選択できます。

前提条件:

• インポートは、同じバージョンのALM Octaneでエクスポートされたスペースでのみ機能します。

• エクスポートとインポートは、同じデータベースベンダーでのみサポートされています。たとえば、Oracleからエクスポートされたスペースは、Oracleにのみインポートできます。

• Octaneデータベースユーザーがデータベースにスキーマを作成する権限を持っていない場合は、事前に新しいスペースを作成してから、インポートのターゲットスペースとして使用する必要があります。

スペースをエクスポートするには:  

1. 設定 >サイトを開きます。標準設定では、ALM Octaneはスペースサブタブを開きます。

2. エクスポートするスペースの横にあるチェックボックスを選択し、スペースの非アクティブ化をクリックします。エクスポートプロセス中に変更があった場合に備えて、エクスポートする前にスペースを非アクティブ化することが重要です。

3. チェックボックスを選択したまま、スペースのエクスポートをクリックします。このボタンは、単一のスペースが選択されている場合にのみ有効になります。複数のスペースを選択すると、無効になります。

4. [スペースのエクスポート] ダイアログボックスで、サイトユーザーのみまたはDBのどちらをエクスポートするかを指定します。DBオプションには次のものがあります。

   オプション	エクスポートされたコンテンツ
   ストレージ	画像と添付ファイルを含む完全なファイルシステム。
   弾性	履歴、傾向、および監査情報を検索して実行します。 詳細については、Elasticデータのエクスポートとインポートを有効にするを参照してください。
   監査	履歴テーブル。

5. エクスポートをクリックします。ステータスメッセージにExported Successfullyが表示され、ダイアログボックスにDownloadリンクとMD5ID番号が表示されるのを待ちます。

6. ダウンロードをクリックして、.osaファイルを標準設定のダウンロードフォルダーに保存します。ファイル名には、テナント文字列とALM Octaneのバージョンが含まれています。

7. エクスポートファイルをクリーンアップするには、すべてのスペースの選択を解除し、エクスポートスペースの削除をクリックします。

8. 選択し、スペースのアクティブ化をクリックすることでスペースを再アクティブ化します。

スペースをインポートするには:  

1. 設定 >サイトを開きます。標準設定では、ALM Octaneはスペースサブタブを開きます。
2. スペースが選択されていないことを確認してください。

3. スペースのインポートをクリックします。[スペースのインポート] ダイアログボックスが開きます。

   1. すべてのデータをインポートするか、サイトユーザーのみをインポートするかを指定します。

      • すべてのデータが選択されている場合、既存のスペースにスペースをインポートすると、ターゲットスペースのデータが上書きされます。2つのスペースからのデータのマージはサポートされていません。

      • サイトユーザーのみを使用して既存のスペースにインポートする場合、ALM Octaneはスペースデータを変更せず、欠落しているサイトユーザーを作成してスペースに接続します。このオプションは、エクスポート/インポートツールではなく、手動ツールを使用してスペースデータを複製することを目的としています。サイトユーザーのみをインポートする場合は、既存のスペースのスペースデータがエクスポートされたスペースのスペースデータと一致していることを確認してください。

   2. 同じバージョンのALM Octaneからエクスポートされた.osaファイルを見つけます。

   3. インポートするスペースを選択します。

4. インポートをクリックします。

   インポート中に、スペースがインポートされたサイトに新しいユーザーが追加された場合、標準設定のパスワードが割り当てられます。NewSiteUser1

トップに戻る

Elasticデータのエクスポートとインポートを有効にする

次の手順では、エクスポートされたALM Octaneのスナップショットを保存して、その名前でALM Octaneでこのリポジトリを登録する弾性サーバ内の物理リポジトリを作成します。

この目的で使用できるElasticリポジトリがすでにある場合、またはリポジトリを作成するための独自のガイドラインがある場合は、手順1～3をスキップしてください。ステップ4を使用してALM Octaneでリポジトリを登録します。

ある環境から別の環境にインポートする場合 (たとえば、ステージングから本番環境へ)、エクスポート環境とインポート環境の両方でこの手順を実行します。

Elasticでリポジトリを作成し、ALM Octaneに登録するには:

1. elasticsearch.ymlファイル (configフォルダーの下) に次のプロパティを追加します。

   • Windows:  path.repo: ["c:\\mqm\\site\\storage\\site"]

   • Linux:  path.repo: ["/opt/octanerepo/storage/site"]

   これを、スペースのエクスポートツールによってインデックスのバックアップが保存される環境内の任意のフォルダーに置き換えます。

2. エラスティックサーバーを再起動します。

3. エラスティックサーバーへのREST呼び出しを使用して、新しいElasticリポジトリを登録します。

   Windows:

   curl -X PUT localhost:9200/_snapshot/octane_migrate -H "Content-Type: application/json" -d "{\"type\": \"fs\", \"settings\": { \"location\": \"C:\\mqm\\site\\storage\\site\\migrate_ssp\"}}"

   Linux:

   curl -X PUT <server>:9200/_snapshot/octane_migrate -H "Content-Type: application/json" -d '{"type": "fs", "settings": { "location": "/opt/octanerepo/storage/site/migrate_ssp"}}'

   • octane_migrateは、新しいリポジトリを識別する任意の論理名です。

   • locationは、ymlファイルで指定したパスの下の任意のフォルダーである必要があります。

4. ALM Octaneで次のサイトパラメーターを定義します。MIGRATION_ELASTIC_REPOSITORY

   これは、前の手順で登録したリポジトリの名前として定義する必要があります。上記の例では、パラメーターの値はoctane_migrateになります。

トップに戻る

参照情報:

• ファイルからインポート