Oracle Cloud Infrastructureドキュメント

アプリケーション・ベースのデータ転送のためのホストの準備

このトピックでは、アプリケーション・ベースのデータ転送を実行する前にホスト上で実行する必要がある様々な準備について説明します。

コマンドライン・ユーティリティのインストールおよび使用

重要

このリリースでは、「アプライアンス・ベースのデータ転送」は、すべてのコマンドライン・ベースのタスクに対してOracle Cloud Infrastructureコマンドライン・インタフェース(CLI)を使用します。
「データ転送ユーティリティ」では、アプライアンス・ベースの転送ジョブはサポートされなくなりました。 ディスク・ベースのデータ転送にも、「データ転送ユーティリティ」コマンドを使用できます。

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

クライアントの使用

クライアントは、rootユーザーとして実行する必要があります。

次のコマンドを使用して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..<unique_ID> --display-name "mycompany transfer1" ‑‑bucket mybucket --device-type appliance 

または

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

前の例では、‑‑display‑nameオプションを使用して転送ジョブのフレンドリ名を指定しています。 入力しない

ターミナル・エミュレーションの設定

アプライアンス・ベースの転送では、アプライアンス・シリアル・コンソールを介してアプライアンス・デバイスと通信できるように、端末エミュレーション用にホストを設定する必要があります。 この通信には、シリアル・コンソール端末エミュレータ・ソフトウェアの取り付けが必要です。 次を使用することをお薦めします:

  • Windows用PuTTY
  • OS X用のZOC
  • PuTTYまたはMinicom for Linux

次のターミナル・エミュレータ・ソフトウェア設定を構成します:

  • ボー・レート: 115200
  • エミュレーション: VT102
  • ハンドシェイク: Disabled/off
  • RTS/DTS: Disabled/off

NFSクライアントとしてのホストの設定

ホストをNFSクライアントとして設定します:

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

HTTPプロキシ環境の設定

「データ転送ユーティリティ」「データ転送アプライアンス」管理サービスと通信し、ローカル・ネットワーク接続を介してアプライアンスを転送できるように、パブリック・インターネットへのアクセスを許可するよう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

構成ファイルの準備

アプライアンス・ベースのデータ転送にクライアントを使用する前に、必要な資格証明を使用してベース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プロファイルはすべてのCLIコマンドで使用されます。 例えば:

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

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

oci 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

構成ファイルのエントリ

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

ノート

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

エントリ 説明と値の入手場所 必須?
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)でサポートされています。

はい

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

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

構成ファイルの場所

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

次の手順

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