翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS DataSync エージェントの交換
AWS DataSync エージェントを交換するには、新しいエージェントを作成し、古いエージェントを使用している転送場所をすべて更新する必要があります。
## 新しいエージェントの作成
新しい DataSync エージェントを作成するには、以下の古いエージェントを作成したときと同じ手順に従います。
1. ストレージ環境に[エージェントをデプロイ](deploy-agents.md)します。
1. エージェントが AWS との通信に使用する[サービスエンドポイントを選択](choose-service-endpoint.md)します。
1. エージェントが、ストレージと AWS と通信できるように[ネットワークを設定](datasync-network.md)します。
1. [エージェントをアクティブ化します](activate-agent.md)。
1. 有効化したら、エージェントの Amazon リソースネーム (ARN) をメモしておきます。
この ARN は、DataSync の場所を更新して新しいエージェントを使用するときに必要です。
## 新しいエージェントで場所を更新する
新しいエージェントを作成したら、既存の DataSync 転送場所を更新してこのエージェントを使用します。ほとんどの場合、場所を更新するときにアクセス認証情報を再入力する必要があります。これは、エージェントのみが使用できるような形で、DataSync が場所認証情報を保存するためです。
### DataSync コンソールの使用
以下の手順では、DataSync コンソールを使用して新しいエージェントで場所を更新する方法について説明します。
------
#### [ NFS ]
1. [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) で AWS DataSync コンソールを開きます。
1. 左側のナビゲーションペインで **[データ転送]** を展開し、**[ロケーション]** を選択します。
1. 更新する場所を選択し、次に **[編集]** を選択します。
1. **[エージェント]** で、新しいエージェントを選択します。
1 つの場所に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ SMB ]
1. [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) で AWS DataSync コンソールを開きます。
1. 左側のナビゲーションペインで **[データ転送]** を展開し、**[ロケーション]** を選択します。
1. 更新する場所を選択し、次に **[編集]** を選択します。
1. **[エージェント]** で、新しいエージェントを選択します。
1 つの場所に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. **[パスワード]** には、SMB ファイルサーバーをマウントでき、転送に関係するファイルやフォルダーにアクセスする権限を持つユーザーのパスワードを入力します。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ HDFS ]
1. [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) で AWS DataSync コンソールを開きます。
1. 左側のナビゲーションペインで **[データ転送]** を展開し、**[ロケーション]** を選択します。
1. 更新する場所を選択し、次に **[編集]** を選択します。
1. **[エージェント]** で、新しいエージェントを選択します。
1 つの場所に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. Kerberos 認証を使用している場合は、**[キータブファイル]**と **[Kerberos 設定ファイル]** をアップロードします。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ Object storage ]
1. [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) で AWS DataSync コンソールを開きます。
1. 左側のナビゲーションペインで **[データ転送]** を展開し、**[ロケーション]** を選択します。
1. 更新する場所を選択し、次に **[編集]** を選択します。
1. **[エージェント]** で、新しいエージェントを選択します。
1 つの場所に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. ロケーションに認証情報が必要な場合は、DataSync にオブジェクトストレージバケットへのアクセスを許可する **[シークレットキー]** を入力します。
1. **[Save changes]** (変更の保存) をクリックします。
------
#### [ Azure Blob ストレージ ]
以下を実行して Microsoft Azure Blob Storage の場所を更新します。
1. [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) で AWS DataSync コンソールを開きます。
1. 左側のナビゲーションペインで **[データ転送]** を展開し、**[ロケーション]** を選択します。
1. 更新する場所を選択し、次に **[編集]** を選択します。
1. **[エージェント]** で、新しいエージェントを選択します。
1 つの場所に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. **[SAS トークン]** には、DataSync が Blob ストレージにアクセスできるようにする[共有アクセス署名 (SAS) トークン](creating-azure-blob-location.md#azure-blob-sas-tokens)を入力します。
1. **[Save changes]** (変更の保存) をクリックします。
------
### の使用AWS CLI
以下の手順に従い、AWS CLI を使用して新しいエージェントの場所を更新します。([DataSync API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html) を使用して、これを行うこともできます。)
------
#### [ NFS ]
1. 次の [update-location-nfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html) コマンドをコピーします。
```
aws datasync update-location-nfs \
--location-arn datasync-nfs-location-arn \
--on-prem-config AgentArns=new-datasync-agent-arn
```
1. `--location-arn` パラメータには、更新する NFS の場所の ARN を指定します。
1. `--on-prem-config` パラメータの `AgentArns` オプションには、新しいエージェントの ARN を指定します。
1 つの ARN に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. `update-location-nfs` コマンドを実行して場所を更新します。
------
#### [ SMB ]
1. 次の [update-location-smb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html) コマンドをコピーします。
```
aws datasync update-location-smb \
--location-arn datasync-smb-location-arn \
--agent-arns new-datasync-agent-arn \
--password smb-file-server-password
```
1. `--location-arn` パラメータには、更新する SMB の場所の ARN を指定します。
1. `--agent-arns` パラメータには、新しいエージェントの ARN を指定します。
1 つの ARN に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. `--password` パラメータには、SMB ファイルサーバーをマウントでき、転送に関係するファイルやフォルダーにアクセスする権限を持つユーザーのパスワードを指定します。
1. `update-location-smb` コマンドを実行して場所を更新します。
------
#### [ HDFS ]
1. 次の [update-location-hdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html) コマンドをコピーします。
```
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
```
1. `--location-arn` パラメータには、更新する HDFS の場所の ARN を指定します。
1. `--agent-arns` パラメータには、新しいエージェントの ARN を指定します。
1 つの ARN に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. Kerberos 認証を使用している場合は、`--kerberos-keytab` と `--kerberos-krb5-conf` のパラメータを含めてください。
+ `--kerberos-keytab` パラメータには、定義された Kerberos プリンシパルと暗号化キー間のマッピングを含む Kerberos キーテーブル (キータブ) を指定します。
ファイルのアドレスを指定して、キータブファイルを指定できます。
+ `--kerberos-krb5-conf` パラメータには、Kerberos 領域の設定を含むファイルを指定します。
ファイルのアドレスを指定して、`krb5.conf` ファイルを指定できます。
簡易認証を使用する場合、Kerberos 関連のパラメーターをコマンドに含める必要はありません。
1. `update-location-hdfs` コマンドを実行して場所を更新します。
------
#### [ Object storage ]
1. 次の [update-location-object-storage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html) コマンドをコピーします。
```
aws datasync update-location-object-storage \
--location-arn datasync-object-storage-location-arn \
--agent-arns new-datasync-agent-arn \
--secret-key bucket-secret-key
```
1. `--location-arn` パラメータには、更新する オブジェクトストレージの場所の ARN を指定します。
1. `--agent-arns` パラメータには、新しいエージェントの ARN を指定します。
1 つの ARN に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. オブジェクトストレージのロケーションにアクセス認証情報が必要かどうかに応じて、以下を実行します。
+ **ロケーションに認証情報が必要な場合** - `--secret-key` パラメータで、オブジェクトストレージバケットへのアクセスを DataSync に許可するシークレットキーを指定します。
+ **ロケーションに認証情報が必要な場合** - `--access-key` および `--secret-key` パラメータに空の文字列を指定します。以下に コマンドの例を示します。
```
aws datasync update-location-object-storage \
--location-arn arn:aws:datasync:us-east-2:111122223333:location/loc-abcdef01234567890 \
--agent-arns arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0 \
--access-key "" \
--secret-key ""
```
1. `update-location-object-storage` コマンドを実行して場所を更新します。
------
#### [ Azure Blob ストレージ ]
1. 次の [update-location-azure-blob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html) コマンドをコピーします。
```
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"
}'
```
1. `--location-arn` パラメータには、更新する Azure Blob Storage の場所の ARN を指定します。
1. `--agent-arns` パラメータには、新しいエージェントの ARN を指定します。
1 つの ARN に対して[複数のエージェント](do-i-need-datasync-agent.md#multiple-agents)を交換する場合は、複数のエージェントを選択できます。
1. `--sas-configuration` パラメータの `Token` オプションには、DataSync が Blob ストレージにアクセスできるようにする [SAS トークン](creating-azure-blob-location.md#azure-blob-sas-tokens)を指定します。
1. `update-location-azure-blob` コマンドを実行して場所を更新します。
------
## 次のステップ
1. [古いエージェントを削除します](clean-up.md#deleting-agent)。このエージェントを使用して実行中の DataSync タスクがある場合は、それらのタスクが終了するまで待ってから削除してください。
1. 複数の場所のエージェントを更新する必要がある場合は、以上のステップを繰り返します。
1. 完了したら、[タスクの実行](run-task.md)を再開できます。
**注記**
**スケジュールされたタスクのエージェントの置き換え** – [スケジュールされたタスク](task-scheduling.md)のエージェントを置き換える場合、新しいエージェントが古いエージェントとは異なるタイプの[サービスエンドポイント](choose-service-endpoint.md)を使用している場合はそのタスクを手動で開始します。次回のスケジュールされた実行が始まる前にタスクを手動で実行しないと、そのタスクは失敗します。
例えば、古いエージェントがパブリックサービスエンドポイントを使用しているが、新しいエージェントは VPC エンドポイントを使用している場合は、コンソールまたは `StartTaskExecution` オペレーションを使用して手動でタスクを開始します。その後、タスクはスケジュールに従って実行を再開します。