アプライアンス・データ転送の準備

最低限必要なCLIバージョン

アプライアンスベースのデータ・インポートに必要なCLIの最小バージョンは2.12.1です。

CLIバージョンの確認

次のURLにアクセスして、現在使用可能なCLIバージョンを確認します:

https://github.com/oracle/oci-cli/blob/master/CHANGELOG.rst

プロンプトで次のコマンドを入力して、マシンに現在インストールされているCLIのバージョンを確認します:

oci --version

マシンに現在使用可能なバージョンより前のバージョンがある場合は、最新バージョンをインストールします。

Linuxオペレーティング・システムの要件

CLIをサポートするLinuxオペレーティング・システムのリストについては、要件を参照してください。

CLIのインストール

CLIのインストールおよび構成の詳細は、コマンドライン・インタフェース(CLI)を参照してください。

CLIの使用

次のコマンドを使用してCLIオプションを指定できます:

• --option value または

• --option=value

基本的なCLI構文は:

oci dts resource action options

この構文は次のように適用されます:

• oci dtsは短縮されたCLIコマンド名です

• jobはresourceの例です。

• createはactionの例です。

• その他の文字列はoptionsです。

転送ジョブを作成する次のコマンドは、一般的なCLIコマンドの構成を示しています。

oci dts job create --compartment-id ocid1.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyApplianceImportJob --device-type appliance

コマンドライン・インタフェースのヘルプへのアクセス

oci dts job --help
			
NAME
  dts_job -

DESCRIPTION
  Transfer disk or appliance job operations

AVAILABLE COMMANDS
  o change-compartment
  o close
  o create
  o delete
  o detach-devices-details
  ...

oci dts job create --help
			
NAME
  dts_job_create -

DESCRIPTION
  Creates a new transfer disk or appliance job.

USAGE
  oci dts job create [OPTIONS]

REQUIRED PARAMETERS
  --bucket [text]

Upload bucket name

--compartment-id, -c [text]

Compartment OCID

--device-type [text]

データ転送ディレクトリの作成

Oracle Cloud Infrastructure CLIがインストールされている場所と同じ制御ホスト・マシンにOracle Cloud Infrastructureディレクトリ(.oci)を作成します。例:

mkdir /root/.oci/

2つの構成ファイル(configおよびconfig_upload_user)が、選択した場所に格納されます。

データ転送管理者の構成ファイルの作成

データ転送管理者構成ファイルには、Oracle Cloud Infrastructureの操作に必要な資格証明が含まれています。このファイルは、設定CLIを使用して作成することも、テキスト・エディタを使用して手動で作成することもできます。

設定CLIの使用

oci setup configコマンドライン・ユーティリティを実行して、初回設定プロセスを実行します。このコマンドを使用すると、構成ファイルで必要な情報とAPI公開/秘密キーの入力を求められます。設定ダイアログにより、APIキー・ペアが生成され、構成ファイルが作成されます。

必要な情報を確認する方法の詳細は、次を参照してください:

• テナンシのOCIDとユーザーのOCIDを取得する場所

• リージョンと可用性ドメイン

手動設定

APIのパブリック/プライベート・キーを独自に設定して、独自の構成ファイルを作成する場合は、SDKおよびCLIの構成ファイルを参照してください。

次の構造を持つデータ転送管理者の構成ファイル/root/.oci/configを作成します:

[DEFAULT]
user=<The OCID for the data transfer administrator>
fingerprint=<The fingerprint of the above user's public key>
key_file=<The _absolute_ path to the above user's private key file on the host machine>
tenancy=<The OCID for the tenancy that owns the data transfer job and bucket>
region=<The region where the transfer job and bucket should exist. Valid values are: 
supported regions>.

ここで、supported regionsは、データ転送でサポートされているリージョンにリストされているリージョンです。

例:

[DEFAULT]
user=ocid1.user.oc1..unique_ID
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..exampleuniqueID.pem
tenancy=ocid1.tenancy.oc1..unique_ID
region=us-phoenix-1

データ転送管理者に対して、複数のユーザーの資格証明を使用した様々なプロファイル・セクションを含む単一の構成ファイルを作成できます。その後、--profileオプションを使用して、コマンドで使用するプロファイルを指定します。次に、異なるプロファイル・セクションを持つデータ転送管理者の構成ファイルの例を示します:

[DEFAULT]
user=ocid1.user.oc1..exampleuniqueID
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..exampleuniqueID.pem
tenancy=ocid1.tenancy.oc1..exampleuniqueID
region=us-phoenix-1
[PROFILE1]
user=ocid1.user.oc1..exampleuniqueID
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..exampleuniqueID.pem
tenancy=ocid1.tenancy.oc1..exampleuniqueID
region=us-ashburn-1

デフォルトでは、すべてのCLIコマンドにDEFAULTプロファイルが使用されます。例:

oci dts job create --compartment-id ocid.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyDisplay --device-type appliance

かわりに、別のデータ転送管理者のプロファイルを指定するために、--profileオプションを使用して任意のCLIコマンドを発行することもできます。例:

oci dts job create --compartment-id ocid.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyDisplay --device-type appliance --profile MyProfile

前述の構成ファイルの例を使用すると、profile_nameはprofile1になります。

2つの別々の構成ファイルを作成した場合は、次のコマンドを使用して、使用する構成ファイルを指定します:

oci dts job create --compartment-id compartment_id --bucket bucket_name --display-name display_name --config 
                
                

データ転送アップロード・ユーザーの構成ファイルの作成

config_upload_user構成ファイルは、データ転送アップロード・ユーザー(Oracleがデータをユーザーのかわりにアップロードするために使用する一時的なIAMユーザー)用です。次の構造を持つ構成ファイルを作成します:

[DEFAULT]
user=<The OCID for the data transfer upload user>
fingerprint=<The fingerprint of the above user's public key>
key_file=<The _absolute_ path to the above user's private key file on the host machine>
tenancy=<The OCID for the tenancy that owns the data transfer job and bucket>
region=<The region where the transfer job and bucket should exist. Valid values are: 
supported regions>.

ここで、supported regionsは、データ転送でサポートされているリージョンにリストされているリージョンです。

構成ファイルのエントリ

次の表に、各構成ファイルに必要な基本エントリと、各エントリに関する情報の取得場所を示します。

次のコマンドを使用して、データ転送アップロード・ユーザーの資格証明を確認できます:

oci dts job verify-upload-user-credentials --bucket bucket_name

新規インポート・アプライアンス・リクエストの通知の設定

インポート・アプライアンスのリクエスト時にジョブ通知を含めるには、oci dts Appliance requestコマンドの一部として--setup-notificationsオプションを含めます:

oci dts appliance request --job-id ... --setup-notifications

既存のインポート・アプライアンス・リクエストの通知の設定

既存のインポート・アプライアンス・リクエストの通知を設定するには、アプライアンスでoci dts Appliance setup-notificationsコマンドを実行します:

oci dts appliance setup-notifications --appliance-label appliance_label

失敗シナリオ

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

• Data Transferサービスへの接続

  • データ転送エンドポイントへのリクエストがタイムアウトしました

    Checking Data Transfer Service connectivity... datatransfer.r1.oracleiaas.com is not reachable.
    Please ensure there there are no firewall rules blocking connectivity.
    RequestException:
    {
        "client_version": "Oracle-PythonCLI/3.22.0",
        "logging_tips": "Please run the OCI CLI command using --debug flag to find more debug information.",
        "message": "The connection to endpoint timed out.",
        "request_endpoint": null,
        "target_service": "CLI",
        "timestamp": "2023-02-01T11:46:02.374857",
        "troubleshooting_tips": " See [https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_troubleshooting.htm] for more information about resolving this error. If you are unable to resolve this issue, run this CLI command with --debug option and contact Oracle support and provide them the full error message."
    }

• オブジェクト・ストレージへの接続

  • オブジェクト・ストレージ・エンドポイントへのタイムアウト・リクエスト

    Checking Object Storage connectivity... objectstorage.r1.oracleiaas.com is not reachable.
    Please ensure there there are no firewall rules blocking connectivity.
    RequestException:
    {
        "client_version": "Oracle-PythonCLI/3.22.0",
        "logging_tips": "Please run the OCI CLI command using --debug flag to find more debug information.",
        "message": "The connection to endpoint timed out while trying to reach https://objectstorage.r1.oracleiaas.com",
        "request_endpoint": " GET https://objectstorage.r1.oracleiaas.com",
        "target_service": "CLI",
        "timestamp": "2023-02-01T12:52:33.979490",
        "troubleshooting_tips": "Try running curl https://objectstorage.r1.oracleiaas.com. If the curl doesn't work, check your network setting or contact your network administrator. See [https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_troubleshooting.htm] for more information about resolving this error. If you are unable to resolve this issue, run this CLI command with --debug option and contact Oracle support and provide them the full error message."
    }

• 管理者ユーザーに必要なIAMユーザー、グループおよびポリシー

  • 管理ユーザーのオブジェクト・ストレージ認可ポリシーがありません

    Checking Required IAM Users, Groups, and Policies... Fail
    Unauthorized access to Object Storage.
    Please ensure you have the required IAM Users, Groups, and Policies to access Object Storage.

  • 管理ユーザーのデータ転送認可ポリシーがありません

    Checking Required IAM Users, Groups, and Policies... Fail
    Unauthorized access to Data Transfer Service.
    Please ensure you have the required IAM Users, Groups, and Policies to access Data Transfer Service.

• アップロード・バケットはコンパートメントに属しています

  • アップロード・バケットが存在しません

    Checking Upload Bucket exists in Compartment... Fail
    Bucket not found.
    The bucket 'e2e_test_hdx' does not exist in namespace 'bdtstest1' or you are unauthorized to access it.

  • コンパートメントにないバケットのアップロード

    
    Checking Upload Bucket exists in Compartment... Fail
    The bucket 'e2e_test_hdd' does not belong to compartment 'ocid1.compartment.region1..aaaaaaaaph2r5w24faket2vsp22hiboxjzk4k3s47d2ut37jghjagfb3abca'.

• データ転送アップロード・ユーザーは、Object Storageのバケットからオブジェクトを作成、上書き、検査および削除できます

  • アップロード・ユーザーの認可ポリシーがありません

    Checking Upload User credentials...
    Failed to Create object BulkDataTransferTestObject in bucket e2e_test_hdd using upload user in tenancy bdtstest1 as upload user
    Fail
    ServiceError:
    {
        "client_version": "Oracle-PythonSDK/2.90.0+2664, Oracle-PythonCLI/3.22.0",
        "code": "BucketNotFound",
        "logging_tips": "Please run the OCI CLI command using --debug flag to find more debug information.",
        "message": "Either the bucket named 'e2e_test_hdd' does not exist in the namespace 'bdtstest1' or you are not authorized to access it",
        "opc-request-id": "sea-1:tpz7tEO-SLezjoTd506L8R5wm3HewQNHFfpg-EKsAINe6P8fFj4b_znPyfujFeqq",
        "operation_name": "put_object",
        "request_endpoint": "PUT https://objectstorage.r1.oracleiaas.com/n/bdtstest1/b/e2e_test_hdd/o/BulkDataTransferTestObject",
        "status": 404,
        "target_service": "object_storage",
        "timestamp": "2023-02-07T06:39:24.816918+00:00",
        "troubleshooting_tips": "See [https://docs.oracle.com/iaas/Content/API/References/apierrors.htm] for more information about resolving this error. If you are unable to resolve this issue, run this CLI command with --debug option and contact Oracle support and provide them the full error message."
    }

• 承認されたデータ転送アプライアンスの資格

  • データ転送サービス資格なし

    Checking Data Transfer Appliance Entitlement... Fail
    Unable to find Data Transfer Appliance Entitlement in Compartment 'ocid1.compartment.region1..aaaaaaaaa5mxm3fd6tanvthad5oplmdcmxjqdsoehidua7iz3sxauih3deja'.

  • 未承認のデータ転送資格

    Checking Data Transfer Appliance Entitlement... Fail
    Data Transfer Appliance Entitlement needs to be in an APPROVED lifecycle state.

• データ転送のインポート・アプライアンスベースの転送ジョブが存在します

  • データ転送アプライアンスベースの転送ジョブがありません

    Checking Transfer Job and Appliance Request... Fail
    There is no Appliance Transfer Job 'ocid1.datatransferjob.oc1..exampleuniqueID' for Data Import into Bucket 'e2e_test_hdd'.

• 有効な転送ジョブに関連付けられたアプライアンス・リクエスト

  • アプライアンス・リクエストがありません

    Checking Transfer Job and Appliance Request... Fail
    There is no Transfer Appliance Request for Appliance Transfer Job 'ocid1.datatransferjob.oc1..exampleuniqueID'.