Oracle Cloud Infrastructureドキュメント

ディスク・ベースのデータ転送用の「データ転送ユーティリティ」のインストール

このトピックでは、ディスク・ベースのデータ転送で使用するために「データ転送ユーティリティ」をインストールして構成する方法について説明します。 さらに、このトピックでは、「データ転送ユーティリティ」コマンドの構文について説明します。

重要

このリリースでは、「データ転送ユーティリティ」はディスク・ベースのデータ転送のみをサポートします。
アプライアンス・ベースの転送に使用する「データ転送ユーティリティ」は、Oracle Cloud Infrastructureコマンドライン・インタフェース(CLI)に置き換えられました。 詳細については、「アプライアンス・データ転送の管理」を参照してください。

「データ転送ユーティリティ」は、Universal Permissive License 1.0とApache License 2.0でライセンスされています。 サードパーティのコンテンツは、コードに記述されているように個別にライセンスされています。

前提条件

「データ転送ユーティリティ」をインストールして使用するには、次を取得します:

  • Oracle Cloud Infrastructureアカウント。

  • 必要なOracle Cloud Infrastructureユーザーおよびグループに、必要なIAMポリシーが必要です。

    詳細については、「データ転送の準備」を参照してください。

  • 次のものがインストールされているホスト・マシン:

    • Oracle Linux 6以上、Ubuntu 14.04以上、またはSUSE 11以上

    • Java 1.8またはJava 1.11

    • hdparm 9.0以降

    • Cryptsetup 1.2.0またはgreater

  • ファイアウォール・アクセス: 「データ転送ユーティリティ」を使用している環境で制限のあるファイアウォールがある場合、次のIPアドレス範囲にファイアウォール構成を開く必要があることがあります: 140.91.0.0/16。

    また、オブジェクト・ストレージIPアドレス範囲へのオープン・アクセスも必要です: 134.70.0.0/17。

「データ転送ユーティリティ」のインストール

ホスト・マシンのオペレーティング・システムに対応する「データ転送ユーティリティ」インストーラをダウンロードしてインストールします。

DebianまたはUbuntuにデータ転送ユーティリティをインストールするには
Oracle LinuxまたはRed Hat Linuxにデータ転送ユーティリティをインストールするには

「データ転送ユーティリティ」の構成

「データ転送ユーティリティ」を使用する前に、基本のOracle Cloud Infrastructureディレクトリと、必要な資格証明を持つ2つの構成ファイルを作成する必要があります。 1つの構成ファイルは、データ転送管理者、転送ジョブを作成および管理する権限とアクセス権を持つIAMユーザー用です。 もう1つの構成ファイルは、Oracleがユーザーのためにデータをアップロードするために使用する一時的なIAMユーザーであるデータ転送アップロード・ユーザー用です。

基本データ転送ディレクトリ

ベースのOracle Cloud Infrastructureディレクトリを作成します:

mkdir /root/.oci/

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

次の構造を持つデータ転送管理者構成ファイル/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: us-ashburn-1, us-phoenix-1, eu-frankfurt-1, and uk-london-1.>

例えば:

[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..<unique_ID>.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-phoenix-1

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

[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..<unique_ID>.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-phoenix-1
[PROFILE1]
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..<unique_ID>.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-ashburn-1

重要

複数のプロファイルを含むアップロード・ユーザー構成ファイルの作成はサポートされていません。

デフォルトでは、DEFAULTプロファイルはすべてのデータ転送ユーティリティ・コマンドに使用されます。 例えば:

dts job create --compartment-id <compartment_id> --bucket <bucket_name> --display-name <display_name> --device-type <disk>

代わりに、--profileオプションを指定して任意の「データ転送ユーティリティ」コマンドを発行し、別のデータ転送管理者プロファイルを指定することができます。 例えば:

dts job create --compartment-id <compartment_id> --bucket <bucket_name> --display-name <display_name> --device-type <disk> --profile <profile_name>

上記の構成ファイルの例を使用すると、<profile_name>profile1になります。

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

次の構造を持つデータ転送アップロード・ユーザー/root/.oci/config_upload_user構成ファイルを作成します:

[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: us-ashburn-1, us-phoenix-1, eu-frankfurt-1, and uk-london-1.>

例えば:

[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..<unique_ID>.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-phoenix-1

構成ファイルのエントリ

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

ノート

「データ転送」サービスでは、データ転送管理者とデータ転送アップロード・ユーザーの両方のキー・ファイルのパスフレーズはサポートされていません。

エントリ 説明と値の入手場所 必須?
user

作成しているプロファイルに応じて、データ転送管理者またはデータ転送アップロード・ユーザーのOCID。 値を取得するには、「必要なキーとOCID」を参照してください。

はい
fingerprint

使用されているキー・ペアのフィンガープリント。 値を取得するには、「必要なキーとOCID」を参照してください。

はい
key_file

秘密キーのフルパスとファイル名。

重要: キー・ペアはPEM形式でなければなりません。 PEM形式でキー・ペアを生成する方法については、「必要なキーとOCID」を参照してください。

はい
テナンシ

テナンシのOCID。 値を取得するには、「必要なキーとOCID」を参照してください。

はい
region

Oracle Cloud Infrastructureリージョン。 「リージョンと可用性ドメイン」を参照してください。

データ転送は、US East (Ashburn)US West (Phoenix)Germany Central (Frankfurt)およびUK South (London)でサポートされています。

はい

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

dts job verify-upload-user-credentials --bucket <bucket_name>

構成ファイルの場所

構成ファイルのロケーションは/root/.oci/configです。

「データ転送ユーティリティ」の使用

このセクションでは、「データ転送ユーティリティ」の構文の概要を説明します。

重要

「データ転送ユーティリティ」は、rootユーザーとして実行する必要があります。

次のコマンドを使用して、「データ転送ユーティリティ」コマンド・オプションを指定できます:

  • --option <value>または
  • --option=<value>

構文

基本的な「データ転送ユーティリティ」の構文は次のとおりです:

dts <resource> <action> <options>

この構文は、次の内容に適用されます:

  • dtsは短縮されたユーティリティ・コマンド名です
  • job<resource>の例です
  • createは、<action>の例です
  • その他のユーティリティ文字列は<options>です

転送ジョブを作成する次のコマンドは、典型的な「データ転送ユーティリティ」構成を示しています。

dts job create --compartment-id ocid1.compartment.oc1..<unique_ID> --display-name "mycompany transfer1" ‑‑bucket mybucket --device-type disk

または

dts job create --compartment-id=ocid1.compartment.oc1..<unique_ID> --display-name="mycompany transfer1" ‑‑bucket=mybucket --device-type=disk
ノート

前の例では、‑‑display‑nameオプションを使用して転送ジョブのフレンドリ名を指定しています。 リソース名や説明を提供するときは機密情報を入力しないでください。

コマンドのヘルプの入手

dtsを単独で使用すると、「データ転送ユーティリティ」に関連付けられた様々なコマンドに関するヘルプを参照できます。 例えば:

dts

「データ転送ユーティリティ」のインストール済みバージョンの検索

--versionまたは-vを使用して、インストールされたバージョンの「データ転送ユーティリティ」を入手できます。 例えば:

dts --version

次の手順

これで、ディスク・ベースのデータ転送を実行する準備ができました。 「ディスク・データ転送の管理」も参照してください。