インポート・アプライアンスおよびデータ転送のモニタリング

Oracle提供の転送アプライアンスがOracle提供の転送アプライアンスがOracleに返送されてからの進捗をモニターする方法について学習します。

アプライアンス転送のモニター・フェーズ・インジケータ

このトピックでは、Oracle Cloud Infrastructureへのデータ転送のためにコピーされたデータを含むインポート・アプライアンスをOracleに送付した後に実行するモニタリング・タスクについて説明します。通常、プロジェクト・スポンサ・ロールがこれらのタスクを実行します。ロールおよび職責を参照してください。

ノート

Oracle Cloud Infrastructure CLIコマンドは、Linuxホストからのみ実行できます。これは、様々なホスト・オペレーティング・システム上の他のOracle Cloud InfrastructureサービスでCLIコマンドを実行することとは異なります。アプライアンスベースのコマンドでは、Linuxホストでのみ使用可能な検証が必要です。

インポート・アプライアンス返送のステータスのモニタリング

Oracle Cloud Infrastructure Object Storageへのアップロード用にインポート・アプライアンスが取り外されて返送されると、出荷ベンダーからOracleに通知されます。

コンソールの使用

  1. ナビゲーション・メニューを開き、「移行と障害時リカバリ」をクリックします。「データ転送」で、「インポート」をクリックします。「転送ジョブ」ページが表示されます。

  2. データをアップロードするためにOracleに返送された転送ジョブと関連付けられたインポート・アプライアンスを見つけます。

  3. 「転送アプライアンス」「ステータス」フィールドを確認します。

CLIの使用

インポート・アプライアンス・リクエストのステータスをモニターするには、oci dts appliance showコマンドと必要なパラメータを使用します。

oci dts appliance show --job-id job_id --appliance-label appliance_label [OPTIONS]

CLIコマンドのフラグおよび変数オプションの完全なリストは、コマンドライン・リファレンスを参照してください。

例:

oci dts appliance show --job-id ocid1.datatransferjob.oc1..exampleuniqueID --appliance-label XAKWEGKZ5T
					
{
  "data": {
    "appliance-delivery-tracking-number": null,
    "appliance-delivery-vendor": null,
    "appliance-return-delivery-tracking-number": null,
    "creation-time": "2020-05-20T22:08:13+00:00",
    "customer-received-time": null,
    "customer-returned-time": null,
    "customer-shipping-address": {
      "address1": "2300 Oracle Way",
      "address2": null,
      "address3": null,
      "address4": null,
      "addressee": "Example, Inc.",
      "care-of": "Robert Smith",
      "city-or-locality": "Austin",
      "country": "USA",
      "email": "rsmith@example.com",
      "phone-number": "6035550100",
      "state-or-region": "TX",
      "zipcode": "78741"
    },
    "delivery-security-tie-id": "exampleuniqueID",
    "label": "XAKWEGKZ5T",
    "lifecycle-state": "PROCESSING",
    "next-billing-time": null,
    "return-security-tie-id": "exampleuniqueID",
    "serial-number": "exampleuniqueserialnumber",
    "transfer-job-id": "ocid1.datatransferjob.oc1..exampleuniqueID",
    "upload-status-log-uri": "JAKQVAGJF/XAKWEGKZ5T/upload_summary.txt"
  }
}

インポート・アプライアンスのステータスは、lifecycle-state属性で示されます。

インポート・アプライアンスのステータス値

次の表に、インポート・アプライアンスのステータス値を示します:

インポート・アプライアンスのステータス値
説明

取消済

Oracle Cloud Infrastructure Object Storageへのデータのアップロードについて考えが変わった場合、インポート・アプライアンスを取り消すことができます。アプライアンスをOracleに返送してから、アプライアンスを取り消してください。Oracleでは、アプライアンスが返却されると、常にブート領域とデータ領域に対してセキュアな消去ツールを使用します。

完了

Oracleは、インポート・アプライアンスのデータ・アップロードを完了しました。データは、Oracle Cloud Infrastructure Object Storageの指定されたバケットで使用できます。

顧客逸失

要求されている90日以内にインポート・アプライアンスを返却しませんでした。

配送済

Oracleは、インポート・アプライアンスが配達されたという出荷ベンダーからの配達確認を受け取りました。アプライアンスが配達されると、アプライアンスの詳細に、アプライアンスの受領日時が表示されます。アプライアンス使用状況のトラッキングが開始されます。

エラー

Oracleで、インポート・アプライアンスの処理中に回復不能なエラーが発生しました。Oracleは、アプライアンスからデータをアップロードできません。データを保護するために、Oracleでは、処理できない転送アプライアンスのブート領域とデータ領域に対してセキュアな消去ツールを使用します。アプライアンスの別のリクエストを完了します。

ORACLEの準備

Oracleは、インポート・アプライアンス・リクエストを承認しました。ステータスには、アプライアンスが出荷されるまで「準備中」と表示されます。

ORACLE受信済

Oracleは、インポート・アプライアンス送付を受け取りました。ステータスには、Oracleがアプライアンスからのデータの処理およびアップロードを開始するまで「Oracle Received」と表示されます。

ORACLE受信取消済

インポート・アプライアンスをOracleに返送した後にアプライアンスを取り消しました。Oracleが受け取った取消済のアプライアンスからは、データはアップロードされません。

準備中

インポート・アプライアンスをアクティブ化しました。これで、データをアプライアンスにコピーできます。ステータスには、アプライアンスがOracleに返送されるまで「準備中」が表示されます。

プロセス中

Oracleは、インポート・アプライアンスのデータを処理してアップロードしています。ステータスには、Oracleがアプライアンスのデータ・アップロードを完了するまで、「処理中」が表示されます。

拒否

Oracleは、インポート・アプライアンス・リクエストを拒否しました。アプライアンス・リクエストが拒否され、質問がある場合は、営業担当に連絡するか、サービス・リクエスト(SR)を提出してください。

リクエスト

インポート・アプライアンスに対するリクエストが正常に完了しました。ステータスには、Oracleがアプライアンス・リクエストを承認するまで「リクエスト済」と表示されます。

返却ラベル使用可能

Oracleは、返品ラベルの要求を完了しました。コンソールまたはCLIを使用して、インポート・アプライアンスの詳細から戻りラベルをダウンロードできます。

返却ラベル生成中

Oracleは、返品ラベル・リクエストを受信しました。ステータスには、ラベルが生成されるまで「戻りラベル生成中」と表示されます。

返信ラベル・リクエスト済

返品ラベルの要求が正常に完了しました。ステータスには、Oracleがラベルリクエストを処理するまで Return Label Requestedと表示されます。

返品出荷済

Oracleは、インポート・アプライアンスがOracleに返送されたという出荷ベンダーからの確認を受け取りました。ステータスには、Oracleがアプライアンスを受信するまで「返却出荷済」が表示されます。

返却出荷取消済

インポート・アプライアンスが配達されたか、Oracleに返送した後にアプライアンスを取り消しました。Oracleは、取り消された転送アプライアンスがOracleに返送中であるという出荷ベンダーからの確認を受け取りました。ステータスには、Oracleがアプライアンスを受信するまで「返却出荷取消済」が表示されます。

出荷

Oracleで必要な準備が完了し、インポート・アプライアンスが出荷されました。アプライアンスが出荷されると、アプライアンスの詳細に、アプライアンスのシリアル番号、出荷ベンダー、およびトラッキング番号が表示されます。ステータスには、アプライアンスが配達されるまで「出荷中」と表示されます。

アップロード・サマリーの確認

Oracleは、アップロードしたアプライアンスごとにアップロード・サマリー・ログ・ファイルを作成します。これらのログ・ファイルは、Oracle Cloud Infrastructureにデータがアップロードされたバケットに配置されます。アップロード・サマリー・ファイルでは、ファイルのアップロード後に、アプライアンスのマニフェスト・ファイルとターゲットのOracle Cloud Infrastructure Object Storageバケットのコンテンツが比較されます。

ノート

データをアーカイブ・ストレージ・バケットにアップロードすることを選択した場合、確認のためにそのファイルをダウンロードするには、まずログ・ファイル・オブジェクトをリストアする必要があります。

ログ・レポートの先頭部分には、全体的なファイル処理ステータスが要約されます:

P - Present: The file is present in both the device and the target bucket
M - Missing: The file is present in the device but not the target bucket. It was likely uploaded and then deleted by another user before the summary was generated.
C - Name Collision: The file is present in the manifest but a file with the same name but different contents is present in the target bucket.
U - Unreadable: The file is not readable from the disk
N - Name Too Long: The file name on disk is too long and could not be uploaded

完全なファイル・アップロードの詳細は、サマリーの後に続きます。

このスクリーンショットは、データ転送ログ・ファイルの例を示しています。

100,000を超えるファイルをアップロードした場合、アップロード詳細は複数のページに分割されます。コンソールからは最初のページのみダウンロードできます。残りのページはオブジェクト・ストレージ・バケットから直接ダウンロードしてください。後続のページには最初のページと同じオブジェクト名が付けられますが、列挙型の接尾辞があります。

アップロードされたファイルの整合性の確認

データ転送アプライアンスからオブジェクト・ストレージにアップロードされたファイルのオブジェクト・データ整合性を検証するために、データ転送アプライアンスからオブジェクト・ストレージにアップロードされたすべてのオブジェクトに対して、MD5を使用した暗号化ハッシュが提供されます。Oracle Cloud Infrastructureでは、オブジェクト・ハッシュ値がbase64エンコーディングで提供されます。

オブジェクト・ストレージにインポートされたファイルをダウンロードし、その整合性を検証するには、次のCLIコマンドを実行します:

oci os object get --namespace object_storage_namespace --bucket-name bucket_name --name object_name --file file_location

例:

oci os object get --namespace MyNamespace --bucket-name MyBucket1 --name JLA12B3C/XAABC12EFG/upload_summary.txt –file upload_summary.txt
		
Downloading object  [####################################]  100%

ファイルを開き、アップロードしたファイルのファイル名をMD5列と照合します:

DTAダウンロード・サマリー

この例では、file_1.txtのMD5サムはEoN8s6dgT/9pGYA7Yx1klQ==です

file_1.txtをダウンロードするには、次のCLIコマンドを実行します:

oci os object get --namespace object_storage_namespace --bucket-name bucket_name --name object_name --file file_location

例:

oci os object get --namespace example_namespace --bucket-name bucket-1 --name file_1.txt –file file_1.txt
		
Downloading object  [####################################]  100%

base64エンコードされたハッシュ値を16進値に変換し、次のコマンドを使用します:

python -c 'print "BASE64-ENCODED-MD5-VALUE".decode("base64").encode("hex")'

例:

python -c 'print "EoN8s6dgT/9pGYA7Yx1klQ==".decode("base64").encode("hex")'
		
12837cb3a7604fff6919803b631d6495

次に、Linuxでmd5sumを生成し、両方の値が一致することを確認します:

md5sum file_name

例:

md5sum file_1.txt
		
12837cb3a7604fff6919803b631d6495  file_1.txt

マルチパート・アップロード済ファイルの検証

大きなファイルは、データ転送アプライアンスからオブジェクト・ストレージにアップロードされるときに1 GBのパーツに分割されます。複数のパーツで転送されたファイルをダウンロードした後、使用可能なスクリプトのいずれかを使用してmd5sumを検証できます。詳細およびこれらのスクリプトへのリンクは、次を参照してください:

https://github.com/oracle/oci-cli/issues/134

データ転送メトリックの表示

コピーしたデータを含むインポート・アプライアンスがOracleによって受信され、データ転送が開始された後、「転送アプライアンスの詳細」ページで、転送ジョブに関連付けられているメトリックをチャートまたは表形式で表示できます。

ヒント

アプライアンスからOracle Cloud Infrastructureへのデータ転送が発生したときにアラートを生成するように通知を設定します。状態がORACLE_RECEIVEDからPROCESSINGに変わると、データ転送メトリックの表示を開始できます。CLIからアプライアンス・リクエストを行ったときに--setup-notificationオプションを含めた場合、このアラートは自動的に発生します。詳細は、通知を参照してください。

「リソース」の下の「メトリック」を選択して、次の各メジャーを表示します:

  • アップロードされたインポート・ファイル: インポート用にアップロードされたファイルの合計数。

  • アップロードされたインポート・バイト: インポート用にアップロードされた合計バイト数。

  • 残りのインポート・ファイル: インポート・アップロードの残りのファイルの合計数。

  • 残りのインポート・バイト: インポート・アップロードの残りの合計バイト数。

  • エラーのインポート・ファイル: インポートでエラーになったファイルの合計数。

  • インポート・アップロードの検証の進行状況: すでにインポート用にアップロードされたファイルの検証の進行状況。

これらのメジャーの「開始時刻」および「終了時刻」を選択します。それぞれのフィールドに日付と時刻を手動で入力するか、カレンダ機能を選択してその時刻を選択します。開始時刻と終了時刻を選択するかわりに、測定された期間の「クイック選択」リストで標準時間(過去1時間、過去6時間など)のリストから選択することもできます。指定した期間はすべてのメジャーに適用されます。

リストの各メジャーが記録される間隔(たとえば、5分、1時間)を指定します。

リストのメジャーごとに、記録される統計(たとえば、合計、平均)を指定します。

ヒント

平均は、メトリックの絶対値を反映しているため、データ転送に最も有用な統計です。

メトリック・エクスプローラでの問合せの表示、メジャーのURLの取得、チャート・ビューと表ビューの切替えなど、追加のアクションを「オプション」リストから選択します。

チャート内の既存の情報を削除して新しいメトリックの記録を開始するには、「チャートのリセット」をクリックします。

Oracle Cloud Infrastructureサービスのモニタリングの一般情報は、モニタリングを参照してください。

転送ジョブの終了

転送ジョブ・アクティビティの続行が不要または不可能であれば、転送ジョブを終了します。転送ジョブを終了するには、関連するすべてのインポート・アプライアンスのステータスが返却済、取消済または削除済である必要があります。

コンソールの使用

  1. ナビゲーション・メニューを開き、「移行と障害時リカバリ」をクリックします。「データ転送」で、「インポート」をクリックします。「転送ジョブ」ページが表示されます。
  2. リストからコンパートメントを選択します。そのコンパートメント内の転送ジョブが表形式で表示されます。
  3. クローズする転送ジョブをクリックします。転送ジョブの「詳細」ページが表示されます。

  4. 「転送ジョブの終了」をクリックします。

CLIの使用

アプライアンス・インポート転送ジョブをクローズするには、oci dts job closeコマンドと必要なパラメータを使用します。

oci dts job close --job-id job_id [OPTIONS]

CLIコマンドのフラグおよび変数オプションの完全なリストは、コマンドライン・リファレンスを参照してください。

例:

oci dts job close --job-id ocid1.datatransferjob.oc1..exampleuniqueID
{					
  "data": {
    "attached-transfer-appliance-labels": [],
    "attached-transfer-device-labels": [],
    "attached-transfer-package-labels": [],
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "creation-time": "2020-05-20T22:00:43+00:00",
    "defined-tags": {},
    "device-type": "APPLIANCE",
    "display-name": "MyApplianceImportJob",
    "freeform-tags": {},
    "id": "ocid1.datatransferjob.oc1..exampleuniqueID",
    "label": "JGX4N1XLI",
    "lifecycle-state": "CLOSED",
    "upload-bucket-name": "MyBucket"
  },
  "etag": "1"
}

lifecycle-state属性値は"CLOSED"です。

モニタリング・フェーズの検証

次のフェーズに進む前に、このフェーズの最後に次のコマンドライン・インタフェース(CLI)検証タスクを実行します。ここで説明する検証手順を実行すると、環境が評価され、必要な設定要件がすべて正常に完了したことが確認されます。これらの手順は、スムーズで正常なデータ転送を確保するためのトラブルシューティング・リソースとしても機能します。

oci dts verify monitorコマンドと必須パラメータを使用して、作成したモニタリング・フェーズ・タスクおよび構成を検証します:

oci dts verify monitored --job-id job_ocid --appliance-label appliance_label [OPTIONS]

このCLIコマンドを実行すると、正常なインポート・アプライアンスのステータスが検証されます。

CLIコマンドのフラグおよび変数オプションの完全なリストは、コマンドライン・リファレンスを参照してください。

例:

oci dts verify monitored --job-id ocid1.datatransferjob.oc1..exampleuniqueID --appliance-label XAKWEGKZ5T
Verifying requirements after 'Monitoring the Import Appliance and Data Transfer'...
Checking Import Appliance Status... OK
Oracle completed your import appliance data upload. Your data is available in your designated bucket in Oracle 
Cloud Infrastructure Object Storage.
Verification successful.

失敗シナリオ

この項では、検証中に検出される可能性のある障害シナリオについて説明します。

  • 正常なインポート・アプライアンスのステータス

    • 無効な返却セキュリティ・タイ

      Checking Import Appliance Status... Fail
      Oracle encountered an unrecoverable error trying to process your import appliance. Please file a Service Request (SR).

次の手順

アプライアンスベースのデータ・インポートの設定、実行およびモニタリングのプロセスが完了しました。別のアプライアンスベースのデータ転送が必要であると判断した場合は、手順を最初から繰り返します。