Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengganti AWS DataSync agen Anda
Untuk mengganti AWS DataSync agen, Anda harus membuat agen baru dan memperbarui lokasi transfer yang menggunakan agen lama.
## Membuat agen baru
Untuk membuat DataSync agen baru Anda, ikuti proses yang sama ketika Anda membuat agen lama Anda:
1. [Menyebarkan agen](deploy-agents.md) di lingkungan penyimpanan Anda.
1. [Pilih titik akhir layanan](choose-service-endpoint.md) yang digunakan agen untuk berkomunikasi AWS.
1. [Konfigurasikan jaringan Anda](datasync-network.md) sehingga agen dapat berkomunikasi dengan penyimpanan Anda dan AWS.
1. [Aktifkan agen Anda](activate-agent.md).
1. Setelah diaktifkan, catat Nama Sumber Daya Amazon (ARN) agen.
Anda memerlukan ARN ini saat memperbarui DataSync lokasi Anda untuk menggunakan agen baru.
## Memperbarui lokasi Anda dengan agen baru
Setelah Anda membuat agen baru, Anda dapat memperbarui DataSync lokasi yang ada untuk menggunakan agen ini. Dalam kebanyakan kasus, Anda juga harus memasukkan kembali kredensi akses untuk memperbarui lokasi. Ini karena DataSync menyimpan kredensyal lokasi dengan cara yang hanya agen Anda yang dapat menggunakannya.
### Menggunakan DataSync konsol
Petunjuk berikut menjelaskan cara memperbarui lokasi dengan agen baru dengan menggunakan DataSync konsol.
------
#### [ NFS ]
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Lokasi**.
1. Pilih lokasi yang ingin Anda perbarui, lalu pilih **Edit**.
1. Untuk **Agen**, pilih agen baru Anda.
Anda dapat memilih lebih dari satu agen jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Pilih **Simpan perubahan**.
------
#### [ SMB ]
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Lokasi**.
1. Pilih lokasi yang ingin Anda perbarui, lalu pilih **Edit**.
1. Untuk **Agen**, pilih agen baru Anda.
Anda dapat memilih lebih dari satu agen jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Untuk **Kata Sandi**, masukkan kata sandi pengguna yang dapat memasang server file SMB Anda dan memiliki izin untuk mengakses file dan folder yang terlibat dalam transfer Anda.
1. Pilih **Simpan perubahan**.
------
#### [ HDFS ]
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Lokasi**.
1. Pilih lokasi yang ingin Anda perbarui, lalu pilih **Edit**.
1. Untuk **Agen**, pilih agen baru Anda.
Anda dapat memilih lebih dari satu agen jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. **Jika Anda menggunakan otentikasi Kerberos, unggah file **Keytab dan file** konfigurasi Kerberos Anda.**
1. Pilih **Simpan perubahan**.
------
#### [ Object storage ]
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Lokasi**.
1. Pilih lokasi yang ingin Anda perbarui, lalu pilih **Edit**.
1. Untuk **Agen**, pilih agen baru Anda.
Anda dapat memilih lebih dari satu agen jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Jika lokasi Anda memerlukan kredensyal, masukkan **kunci Rahasia** yang memungkinkan DataSync untuk mengakses bucket penyimpanan objek Anda.
1. Pilih **Simpan perubahan**.
------
#### [ Azure Blob Storage ]
Lakukan hal berikut untuk memperbarui Microsoft Azure Blob Storage lokasi:
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Lokasi**.
1. Pilih lokasi yang ingin Anda perbarui, lalu pilih **Edit**.
1. Untuk **Agen**, pilih agen baru Anda.
Anda dapat memilih lebih dari satu agen jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Untuk **token SAS**, masukkan [token tanda tangan akses bersama (SAS)](creating-azure-blob-location.md#azure-blob-sas-tokens) yang memungkinkan DataSync untuk mengakses penyimpanan gumpalan Anda.
1. Pilih **Simpan perubahan**.
------
### Menggunakan AWS CLI
Petunjuk berikut menjelaskan cara memperbarui lokasi dengan agen baru dengan menggunakan AWS CLI. (Anda juga dapat melakukan ini dengan menggunakan [DataSync API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html).)
------
#### [ NFS ]
1. Salin [update-location-nfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html)perintah berikut:
```
aws datasync update-location-nfs \
--location-arn datasync-nfs-location-arn \
--on-prem-config AgentArns=new-datasync-agent-arn
```
1. Untuk `--location-arn` parameter, tentukan ARN dari lokasi NFS yang Anda perbarui.
1. Untuk `AgentArns` opsi `--on-prem-config` parameter, tentukan ARN agen baru Anda.
Anda dapat menentukan lebih dari satu ARN jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Jalankan `update-location-nfs` perintah untuk memperbarui lokasi.
------
#### [ SMB ]
1. Salin [update-location-smb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html)perintah berikut:
```
aws datasync update-location-smb \
--location-arn datasync-smb-location-arn \
--agent-arns new-datasync-agent-arn \
--password smb-file-server-password
```
1. Untuk `--location-arn` parameter, tentukan ARN lokasi SMB yang Anda perbarui.
1. Untuk `--agent-arns` parameternya, tentukan ARN agen baru Anda.
Anda dapat menentukan lebih dari satu ARN jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Untuk `--password` parameter, tentukan kata sandi pengguna yang dapat memasang server file SMB Anda dan memiliki izin untuk mengakses file dan folder yang terlibat dalam transfer Anda.
1. Jalankan `update-location-smb` perintah untuk memperbarui lokasi.
------
#### [ HDFS ]
1. Salin [update-location-hdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html)perintah berikut:
```
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. Untuk `--location-arn` parameter, tentukan ARN dari lokasi HDFS yang Anda perbarui.
1. Untuk `--agent-arns` parameternya, tentukan ARN agen baru Anda.
Anda dapat menentukan lebih dari satu ARN jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Jika Anda menggunakan otentikasi Kerberos, sertakan parameter dan`--kerberos-keytab`: `--kerberos-krb5-conf`
+ Untuk `--kerberos-keytab` parameter, tentukan tabel kunci Kerberos (tab tombol) yang berisi pemetaan antara kunci utama Kerberos yang ditentukan dan kunci terenkripsi.
Anda dapat menentukan file tab tombol dengan memberikan alamat file.
+ Untuk `--kerberos-krb5-conf` parameternya, tentukan file yang berisi konfigurasi untuk ranah Kerberos Anda.
Anda dapat menentukan `krb5.conf` file dengan memberikan alamat file.
Jika Anda menggunakan otentikasi sederhana, Anda tidak perlu menyertakan parameter terkait Kerberos ini dalam perintah Anda.
1. Jalankan `update-location-hdfs` perintah untuk memperbarui lokasi.
------
#### [ Object storage ]
1. Salin [update-location-object-storage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html)perintah berikut:
```
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. Untuk `--location-arn` parameter, tentukan ARN dari lokasi penyimpanan objek yang Anda perbarui.
1. Untuk `--agent-arns` parameternya, tentukan ARN agen baru Anda.
Anda dapat menentukan lebih dari satu ARN jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Lakukan hal berikut tergantung pada apakah lokasi penyimpanan objek Anda memerlukan kredensi akses:
+ **Jika lokasi Anda memerlukan kredensyal** — Untuk `--secret-key` parameter, tentukan kunci rahasia yang memungkinkan DataSync untuk mengakses bucket penyimpanan objek Anda.
+ **Jika lokasi Anda memerlukan kredensyal** — Tentukan string kosong untuk parameter dan. `--access-key` `--secret-key` Berikut adalah contoh perintah:
```
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. Jalankan `update-location-object-storage` perintah untuk memperbarui lokasi.
------
#### [ Azure Blob Storage ]
1. Salin [update-location-azure-blob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html)perintah berikut:
```
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. Untuk `--location-arn` parameter, tentukan ARN dari Azure Blob Storage lokasi yang Anda perbarui.
1. Untuk `--agent-arns` parameternya, tentukan ARN agen baru Anda.
Anda dapat menentukan lebih dari satu ARN jika Anda mengganti [beberapa agen](do-i-need-datasync-agent.md#multiple-agents) untuk suatu lokasi.
1. Untuk `Token` opsi `--sas-configuration` parameter, tentukan [token SAS](creating-azure-blob-location.md#azure-blob-sas-tokens) yang memungkinkan DataSync untuk mengakses penyimpanan gumpalan Anda.
1. Jalankan `update-location-azure-blob` perintah untuk memperbarui lokasi.
------
## Langkah selanjutnya
1. [Hapus agen lama Anda](clean-up.md#deleting-agent). Jika Anda memiliki DataSync tugas yang berjalan menggunakan agen ini, tunggu hingga tugas tersebut selesai sebelum menghapusnya.
1. Jika Anda perlu mengganti agen untuk beberapa lokasi, ulangi langkah sebelumnya.
1. Setelah selesai, Anda dapat melanjutkan [menjalankan tugas Anda](run-task.md).
**catatan**
**Mengganti agen untuk tugas terjadwal** — Jika Anda mengganti agen untuk [tugas terjadwal](task-scheduling.md), Anda harus memulai tugas itu secara manual jika agen baru menggunakan jenis [titik akhir layanan](choose-service-endpoint.md) yang berbeda dari agen lama Anda. Jika Anda tidak menjalankan tugas secara manual sebelum jadwal berjalan berikutnya, tugas gagal.
Misalnya, jika agen lama Anda menggunakan titik akhir layanan publik, tetapi agen baru menggunakan titik akhir VPC, mulailah tugas itu secara manual dengan menggunakan konsol atau operasi. `StartTaskExecution` Setelah itu, tugas Anda akan kembali berjalan sesuai jadwalnya.