AWS DataSyncエージェントの交換 - AWS DataSync
新しいエージェントの作成新しいエージェントによる位置情報の更新次のステップ

2023 年 12 月 7 日より、バージョン 1 DataSync のエージェントは廃止されます。 DataSync コンソールの [エージェント] ページをチェックして、影響を受けるエージェントがいないか確認してください。その場合は、データ転送やストレージ検出の中断を避けるため、その前にそれらのエージェントを交換してください。さらにサポートが必要な場合は、お問い合わせくださいAWS Support。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS DataSyncエージェントの交換

AWS DataSyncエージェントを交換するには、新しいエージェントを作成し、古いエージェントを使用している転送場所をすべて更新する必要があります。

新しいエージェントの作成

DataSync 新しいエージェントを作成するには、古いエージェントを作成したときと同じ手順に従います。

  1. ストレージ環境にエージェントをデプロイします。

  2. エージェントが通信に使用するサービスエンドポイントを選択しますAWS。

  3. エージェントがストレージと通信できるようにネットワークを設定しますAWS。

  4. エージェントを有効化します。

  5. 有効化したら、エージェントの Amazon リソースネーム (ARN) を書き留めておきます。

    この ARN は、 DataSync 新しいエージェントを使用するためにロケーションを更新する際に必要になります。

新しいエージェントによる位置情報の更新

新しいエージェントを作成したら、 DataSync 既存のロケーションを更新してそのエージェントを使用できます。ほとんどの場合、ロケーションを更新するにはアクセス認証情報を再入力する必要もあります。これは、 DataSync 位置情報認証情報をエージェントだけが使用できるように保存するためです。

以下の手順では、 DataSync コンソールを使用して新しいエージェントでロケーションを更新する方法について説明します。

NFS

  1. https://console.aws.amazon.com/datasync/ AWS DataSync でコンソールを開きます。

  2. 左のナビゲーションペインで [データ転送] を展開し、[ロケーション] を選択します。

  3. 更新する場所を選択し、[編集] を選択します。

  4. [エージェント] で、新しいエージェントを選択します。

    1 つのロケーションで複数のエージェントを置き換える場合は、複数のエージェントを選択できます。

  5. [変更を保存] を選択します。

SMB

  1. https://console.aws.amazon.com/datasync/ AWS DataSync でコンソールを開きます。

  2. 左のナビゲーションペインで [データ転送] を展開し、[ロケーション] を選択します。

  3. 更新する場所を選択し、[編集] を選択します。

  4. [エージェント] で、新しいエージェントを選択します。

    1 つのロケーションで複数のエージェントを置き換える場合は、複数のエージェントを選択できます。

  5. Password には、SMB ファイルサーバーをマウントでき、転送に関係するファイルやフォルダーにアクセスする権限を持つユーザーのパスワードを入力します。

  6. [変更を保存] を選択します。

HDFS

  1. https://console.aws.amazon.com/datasync/ AWS DataSync でコンソールを開きます。

  2. 左のナビゲーションペインで [データ転送] を展開し、[ロケーション] を選択します。

  3. 更新する場所を選択し、[編集] を選択します。

  4. [エージェント] で、新しいエージェントを選択します。

    1 つのロケーションで複数のエージェントを置き換える場合は、複数のエージェントを選択できます。

  5. Kerberos 認証を使用している場合は、キータブファイルと Kerberos 設定ファイルをアップロードします。

  6. [変更を保存] を選択します。

Object storage
注記

バケットにアクセス認証情報 (アクセスキーとシークレットキー) が必要ない場合は、新しいエージェントを使用する新しいオブジェクトストレージロケーションを作成する必要があります。

  1. https://console.aws.amazon.com/datasync/ AWS DataSync でコンソールを開きます。

  2. 左のナビゲーションペインで [データ転送] を展開し、[ロケーション] を選択します。

  3. 更新する場所を選択し、[編集] を選択します。

  4. [エージェント] で、新しいエージェントを選択します。

    1 つのロケーションで複数のエージェントを置き換える場合は、複数のエージェントを選択できます。

  5. 「認証情報が必要」を選択し、 DataSync オブジェクトストレージバケットへのアクセスを許可するシークレットキーを入力します。

  6. [変更を保存] を選択します。

Azure Blob ストレージ

Microsoft Azure Blob Storage以下を実行して場所を更新してください。

  1. https://console.aws.amazon.com/datasync/ AWS DataSync でコンソールを開きます。

  2. 左のナビゲーションペインで [データ転送] を展開し、[ロケーション] を選択します。

  3. 更新する場所を選択し、[編集] を選択します。

  4. [エージェント] で、新しいエージェントを選択します。

    1 つのロケーションで複数のエージェントを置き換える場合は、複数のエージェントを選択できます。

  5. SAS トークンの場合は、Blob DataSync ストレージへのアクセスを許可する共有アクセス署名 (SAS) トークンを入力します。

  6. [Save changes] (変更の保存) をクリックします。

以下の手順では、を使用して新しいエージェントでロケーションを更新する方法について説明します。AWS CLI(DataSync API を使用してこれを行うこともできます)。

NFS

  1. 次の update-location-nfs コマンドをコピーします。

    aws datasync update-location-nfs \
  --location-arn datasync-nfs-location-arn \
  --on-prem-config AgentArns=new-datasync-agent-arn

  2. --location-arnパラメータには、更新する NFS ロケーションの ARN を指定します。

  3. --on-prem-configAgentArnsパラメータのオプションには、新しいエージェントの ARN を指定します。

    1 つのロケーションの複数のエージェントを置き換える場合は、複数の ARN を指定できます。

  4. update-location-nfsコマンドを実行してロケーションを更新します。

SMB

  1. 次の update-location-smb コマンドをコピーします。

    aws datasync update-location-smb \
  --location-arn datasync-smb-location-arn \
  --agent-arns new-datasync-agent-arn \
  --password smb-file-server-password

  2. --location-arnパラメータには、更新する SMB ロケーションの ARN を指定します。

  3. --agent-arnsパラメータには、新しいエージェントの ARN を指定します。

    1 つのロケーションの複数のエージェントを置き換える場合は、複数の ARN を指定できます。

  4. --passwordパラメータには、SMB ファイルサーバーをマウントでき、転送に関係するファイルやフォルダーにアクセスする権限を持つユーザーのパスワードを指定します。

  5. update-location-smbコマンドを実行して場所を更新します。

HDFS

  1. 次の update-location-hdfs コマンドをコピーします。

    aws datasync update-location-hdfs \
  --location-arn datasync-hdfs-location-arn \
  --agent-arns new-datasync-agent-arn \
  --kerberos-keytab keytab-file \
  --kerberos-krb5-conf krb5-conf-file

  2. --location-arnパラメータには、更新する HDFS ロケーションの ARN を指定します。

  3. --agent-arnsパラメータには、新しいエージェントの ARN を指定します。

    1 つのロケーションの複数のエージェントを置き換える場合は、複数の ARN を指定できます。

  4. Kerberos 認証を使用している場合は、とパラメータを含めてください。--kerberos-keytab --kerberos-krb5-conf

    • --kerberos-keytabパラメータには、定義済みの Kerberos プリンシパルキーと暗号化キーとのマッピングを含む Kerberos キーテーブル (キータブ) を指定します。

      キータブファイルは、ファイルのアドレスを指定することで指定できます。

    • --kerberos-krb5-confパラメータには、Kerberos レルムの設定を含むファイルを指定します。

      krb5.confファイルのアドレスを指定することでファイルを指定できます。

    単純認証を使用している場合は、これらの Kerberos 関連パラメータをコマンドに含める必要はありません。

  5. update-location-hdfsコマンドを実行して場所を更新します。

Object storage
注記

バケットにアクセス認証情報 (アクセスキーとシークレットキー) が必要ない場合は、新しいエージェントを使用する新しいオブジェクトストレージロケーションを作成する必要があります。

  1. 次の update-location-object-storage コマンドをコピーします。

    aws datasync update-location-object-storage \
  --location-arn datasync-object-storage-location-arn \
  --agent-arns new-datasync-agent-arn \
  --secret-key bucket-secret-key

  2. --location-arnパラメータには、更新するオブジェクトストレージロケーションの ARN を指定します。

  3. --agent-arnsパラメータには、新しいエージェントの ARN を指定します。

    1 つのロケーションの複数のエージェントを置き換える場合は、複数の ARN を指定できます。

  4. --secret-keyパラメータには、 DataSync オブジェクトストレージバケットへのアクセスを許可するシークレットキーを指定します。

  5. update-location-object-storageコマンドを実行してロケーションを更新します。

Azure Blob ストレージ

  1. 次の update-location-azure-blob コマンドをコピーします。

    aws datasync update-location-azure-blob \
  --location-arn datasync-azure-blob-storage-location-arn \
  --agent-arns new-datasync-agent-arn \
  --sas-configuration '{
      "Token": "sas-token-for-azure-blob-storage"
    }'

  2. --location-arnパラメータには、Azure Blob Storage更新するロケーションの ARN を指定します。

  3. --agent-arnsパラメータには、新しいエージェントの ARN を指定します。

    1 つのロケーションの複数のエージェントを置き換える場合は、複数の ARN を指定できます。

  4. --sas-configurationTokenパラメータのオプションには、Blob DataSync ストレージへのアクセスを許可する SAS トークンを指定します。

  5. update-location-azure-blobコマンドを実行して場所を更新します。

次のステップ

  1. 古いエージェントを削除します。 DataSync このエージェントを使用して実行中のタスクがある場合は、それらのタスクが終了するまで待ってから削除してください。

  2. 複数の場所のエージェントを交換する必要がある場合は、前の手順を繰り返してください。

  3. 完了したら、タスクの実行を再開できます。