Oracle Cloud Infrastructureドキュメント

データ転送ユーティリティのインストールおよび構成

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

前提条件

ディスク・ベースまたはアプライアンス・ベースの転送に「データ転送ユーティリティ」をインストールして使用するには、次を取得します:

  • Oracle Cloud Infrastructureアカウント。

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

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

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

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

    • Java 1.8またはJava 1.11

    • hdparm 9.0以降

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

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

 

実行する転送のタイプによって、次の追加の前提条件が必要になります。

ディスク・ベース転送

HDDデータ転送の場合、ホスト・マシンにはCryptsetup 1.2.0以上が必要です。

アプライアンス・ベースの転送

  • アプライアンス・データ転送の場合、ホスト・マシンには次が必要です:
    • シリアル・コンソール端末エミュレータ・ソフトウェア。 次のターミナル・エミュレータ・ソフトウェアを使用することをお勧めします:

      • Windows用PuTTY
      • OS X用のZOC
      • PuTTYまたはMinicom for Linux
    • ターミナル・エミュレータのソフトウェア設定は次のとおりです:

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

      • DebianまたはUbuntuの場合は、nfs-commonパッケージをインストールしてください。 例えば:

        sudo apt-get install nfs-common
      • Oracle LinuxまたはRed Hat Linuxの場合は、nfs-utilsパッケージをインストールします。 例えば:

        sudo yum install nfs-utils

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

    組織が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

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

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

    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_or_appliance>

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

    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になります。

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

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

    構成ファイルのエントリ

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

    ノート

    データ転送サービスが秘密キーのパスフレーズをサポートしない

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

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

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

    はい
    fingerprint

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

    はい
    key_file

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

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

    はい
    テナンシ

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

    はい
    region

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

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

    はい

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

    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 appliance 

    または

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

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

    コマンドのヘルプの入手

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

    dts

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

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

    dts --version

    次の手順

    データ転送関連のタスクを実行する準備が整いました。