Oracle Cloud Infrastructureドキュメント

Data Transferユーティリティのインストールおよび構成

このトピックでは、「Data Transferユーティリティ」をインストールして構成する方法について説明します。 さらに、このトピックでは、Data Transferユーティリティコマンドの構文について説明します。

前提条件

Data Transferユーティリティをインストールして使用するには、次のものが必要です:

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

    詳細については、「Data Transferの準備」を参照してください。

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

    • Oracle Linux 6以上、Ubuntu 14.04以上、またはSUSE 11以上
    • Java 1.8またはJava 1.11
    • hdparm 9.0以降
  • HDDデータ転送の場合、ホスト・マシンには次のものが必要です:

    • Cryptsetup 1.2.0またはgreater
  • アプライアンスのデータ転送の場合、ホスト・マシンには次のものが必要です:

    • シリアル・コンソール端末エミュレータ・ソフトウェア。 次のターミナル・エミュレータ・ソフトウェアを使用することをお勧めします:
      • Windows用PuTTY
      • OS X用のZOC
      • PuTTYまたはMinicom for Linux
    • ターミナル・エミュレータのソフトウェア設定は次のとおりです:

      • ボー・レート: 115200
      • エミュレーション: VT102
      • ハンドシェイク: Disabled/off
      • RTS/DTS: Disabled/off
    • ホストはNFSクライアントとして設定されます:

      • DebianまたはUbuntuの場合は、nfs-commonパッケージをインストールしてください。
      • Oracle LinuxまたはRed Hat Linuxの場合は、nfs-utilsパッケージをインストールします。

「Data Transferユーティリティ」「Data Transferアプライアンス」管理サービスと通信するためにパブリック・インターネットにアクセスするHTTPプロキシ環境を設定し、ローカル・ネットワーク接続を介して転送アプライアンスに接続する必要があります。 環境でインターネット対応アプリケーションがネットワーク・プロキシを使用する必要がある場合は、ホスト・マシン上の標準Linux環境変数を設定して、環境ネットワーク・プロキシを使用するようにData Transferユーティリティを構成します。

組織がhttp://www-proxy.myorg.comに企業インターネット・プロキシを持ち、プロキシがポート80のHTTPアドレスであると仮定します。 次の環境変数を設定します:

export HTTPS_PROXY=http://www-proxy.myorg.com:80

ホスト・マシン上にプロキシを構成していて、転送アプライアンスがそのホストに直接接続されている場合、ホスト・マシンはプロキシを使用して転送アプライアンスと通信することができませんでした。 転送アプライアンスの環境変数no_proxyを設定する必要があります。 たとえば、アプライアンスが10.0.0.1のローカル・ネットワーク上にある場合は、次の環境変数を設定します:

export NO_PROXY=10.0.0.1

「Data Transferユーティリティ」のインストール

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

DebianまたはUbuntuにData Transferユーティリティをインストールするには
Oracle LinuxまたはRed Hat LinuxにData Transferユーティリティをインストールするには

「Data Transferユーティリティ」の構成

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

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

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

mkdir /root/.oci/

Data Transfer管理者の構成ファイル

次の構造を持つデータ転送管理者構成ファイル/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オプションを使用して、コマンドで使用するプロファイルを指定します。 さまざまなプロファイル・セクションを持つData Transfer管理者構成ファイルの例を次に示します:

[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プロファイルはすべてのData Transferユーティリティコマンドに使用されます。 次に例を示します。

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

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

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

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

Data Transferアップロード・ユーザーの構成ファイル

次の構造を持つデータ転送アップロード・ユーザー/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

構成ファイルのエントリ

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

ノート

Data Transferサービスが秘密キーのパスフレーズをサポートしない

API署名キーを生成する際には、秘密キーをパスフレーズで暗号化することをお勧めしますが、Data Transferサービスはconfig_upload_userに必要なキー・ファイルのパスフレーズをサポートしていません。 パスフレーズを使用すると、Oracle担当者はデータをアップロードできません。

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

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

はい
fingerprint

使用されているキー・ペアの指紋。 値を取得するには、「必要なキーとOCID」を参照してください。

はい
key_file

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

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

はい
tenancy

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

はい
region

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

データ転送は、現在、us-ashburn-1us-phoenix-1eu-frankfurt-1、およびuk-london-1でサポートされています。

はい

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

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

構成ファイルの場所

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

「Data Transferユーティリティ」の使用

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

重要

Data Transferユーティリティは、rootユーザーとして実行する必要があります。

Data Transferユーティリティコマンド・オプションは、次の2つの方法で指定できます。
--option <value>
または
--option=<value>

構文

基本的な「Data Transferユーティリティ」の構文は次のとおりです:

dts <resource> <action> <options>

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

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

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

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

または

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

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

コマンドのヘルプの入手

--help-h、または-?を使用してヘルプを得ることができます。 次に例を示します。

dts --help

「Data Transferユーティリティ」のインストール済みバージョンの検索

--versionまたは-vを使用して、インストールされたバージョンのData Transferユーティリティを入手できます。 次に例を示します。

dts --version

次の手順

Data Transfer関連のタスクを実行する準備が整いました。