Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Sostituire il tuo AWS DataSync agente
Per sostituire un AWS DataSync agente, è necessario creare un nuovo agente e aggiornare tutte le sedi di trasferimento che utilizzano il vecchio agente.
## Creazione di un nuovo agente
Per creare un nuovo DataSync agente, segui la stessa procedura utilizzata per creare il vecchio agente:
1. [Implementa un agente](deploy-agents.md) nel tuo ambiente di storage.
1. [Scegli un endpoint di servizio](choose-service-endpoint.md) con cui l'agente comunica. AWS
1. [Configura la rete](datasync-network.md) in modo che l'agente possa comunicare con lo storage e AWS.
1. [Attiva il tuo agente](activate-agent.md).
1. Una volta attivato, prendi nota dell'Amazon Resource Name (ARN) dell'agente.
È necessario questo ARN quando si aggiorna la DataSync posizione per utilizzare il nuovo agente.
## Aggiornamento della posizione con il nuovo agente
Dopo aver creato un nuovo agente, puoi aggiornare una DataSync sede esistente per utilizzare questo agente. Nella maggior parte dei casi, è inoltre necessario reinserire le credenziali di accesso per aggiornare la posizione. Questo perché DataSync archivia le credenziali di localizzazione in modo che solo l'agente possa utilizzarle.
### Utilizzo della console DataSync
Le seguenti istruzioni descrivono come aggiornare le posizioni con un nuovo agente utilizzando la DataSync console.
------
#### [ NFS ]
1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Posizioni**.
1. Scegli la posizione che desideri aggiornare, quindi scegli **Modifica**.
1. Per **gli agenti**, scegli il tuo nuovo agente.
Puoi scegliere più di un agente se sostituisci [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Scegli **Save changes** (Salva modifiche).
------
#### [ SMB ]
1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Posizioni**.
1. Scegli la posizione che desideri aggiornare, quindi scegli **Modifica**.
1. Per **gli agenti**, scegli il tuo nuovo agente.
Puoi scegliere più di un agente se sostituisci [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Per **Password**, inserisci la password dell'utente che può installare il file server SMB e dispone dell'autorizzazione per accedere ai file e alle cartelle coinvolti nel trasferimento.
1. Scegli **Save changes** (Salva modifiche).
------
#### [ HDFS ]
1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Posizioni**.
1. Scegli la posizione che desideri aggiornare, quindi scegli **Modifica**.
1. Per **gli agenti**, scegli il tuo nuovo agente.
Puoi scegliere più di un agente se sostituisci [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Se utilizzi l'autenticazione Kerberos, carica il file **Keytab e il file** di configurazione **Kerberos**.
1. Scegli **Save changes** (Salva modifiche).
------
#### [ Object storage ]
1. Apri la console all'indirizzo. AWS DataSync [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/)
1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Posizioni**.
1. Scegli la posizione che desideri aggiornare, quindi scegli **Modifica**.
1. Per **gli agenti**, scegli il tuo nuovo agente.
Puoi scegliere più di un agente se sostituisci [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Se la tua posizione richiede credenziali, inserisci la **chiave segreta** che consente di accedere DataSync al tuo bucket di archiviazione degli oggetti.
1. Scegli **Save changes** (Salva modifiche).
------
#### [ Azure Blob Storage ]
Effettua le seguenti operazioni per aggiornare il tuo Microsoft Azure Blob Storage ubicazione:
1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Posizioni**.
1. Scegli la posizione che desideri aggiornare, quindi scegli **Modifica**.
1. Per **gli agenti**, scegli il tuo nuovo agente.
Puoi scegliere più di un agente se sostituisci [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Per il **token SAS**, inserisci il [token SAS (Shared Access Signature)](creating-azure-blob-location.md#azure-blob-sas-tokens) che DataSync consente di accedere allo storage BLOB.
1. Scegli **Save changes** (Salva modifiche).
------
### Utilizzando il AWS CLI
Le seguenti istruzioni descrivono come aggiornare le sedi con un nuovo agente utilizzando il AWS CLI. (Puoi farlo anche utilizzando l'[DataSync API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html).)
------
#### [ NFS ]
1. Copia il seguente [update-location-nfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html)comando:
```
aws datasync update-location-nfs \
--location-arn datasync-nfs-location-arn \
--on-prem-config AgentArns=new-datasync-agent-arn
```
1. Per il `--location-arn` parametro, specifica l'ARN della posizione NFS che stai aggiornando.
1. Per l'`AgentArns`opzione del `--on-prem-config` parametro, specifica l'ARN del tuo nuovo agente.
Puoi specificare più di un ARN se stai sostituendo [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Esegui il `update-location-nfs` comando per aggiornare la posizione.
------
#### [ SMB ]
1. Copia il seguente [update-location-smb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html)comando:
```
aws datasync update-location-smb \
--location-arn datasync-smb-location-arn \
--agent-arns new-datasync-agent-arn \
--password smb-file-server-password
```
1. Per il `--location-arn` parametro, specifica l'ARN della posizione SMB che stai aggiornando.
1. Per il `--agent-arns` parametro, specifica l'ARN del tuo nuovo agente.
Puoi specificare più di un ARN se stai sostituendo [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Per il `--password` parametro, specificate la password dell'utente che può montare il file server SMB e dispone dell'autorizzazione per accedere ai file e alle cartelle coinvolti nel trasferimento.
1. Eseguite il `update-location-smb` comando per aggiornare la posizione.
------
#### [ HDFS ]
1. Copia il seguente [update-location-hdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html)comando:
```
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. Per il `--location-arn` parametro, specifica l'ARN della posizione HDFS che stai aggiornando.
1. Per il `--agent-arns` parametro, specifica l'ARN del tuo nuovo agente.
Puoi specificare più di un ARN se stai sostituendo [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Se utilizzi l'autenticazione Kerberos, includi i `--kerberos-keytab` parametri e: `--kerberos-krb5-conf`
+ Per il `--kerberos-keytab` parametro, specifica la tabella delle chiavi Kerberos (keytab) che contiene le mappature tra il principale Kerberos definito e le chiavi crittografate.
È possibile specificare il file keytab fornendo l'indirizzo del file.
+ Per il `--kerberos-krb5-conf` parametro, specifica il file che contiene la configurazione per il tuo realm Kerberos.
È possibile specificare il `krb5.conf` file fornendo l'indirizzo del file.
Se utilizzi l'autenticazione semplice, non è necessario includere questi parametri relativi a Kerberos nel comando.
1. Esegui il `update-location-hdfs` comando per aggiornare la posizione.
------
#### [ Object storage ]
1. Copia il seguente [update-location-object-storage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html)comando:
```
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. Per il `--location-arn` parametro, specificate l'ARN della posizione di archiviazione degli oggetti che state aggiornando.
1. Per il `--agent-arns` parametro, specifica l'ARN del tuo nuovo agente.
Puoi specificare più di un ARN se stai sostituendo [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Effettuate le seguenti operazioni a seconda che la posizione di archiviazione degli oggetti richieda credenziali di accesso:
+ **Se la posizione richiede credenziali**: per il `--secret-key` parametro, specifica la chiave segreta che consente di accedere DataSync al bucket di archiviazione degli oggetti.
+ **Se la tua posizione richiede credenziali**, specifica delle stringhe vuote per i parametri and. `--access-key` `--secret-key` Ecco un comando di esempio:
```
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. Esegui il `update-location-object-storage` comando per aggiornare la posizione.
------
#### [ Azure Blob Storage ]
1. Copia il seguente [update-location-azure-blob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html)comando:
```
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. Per il `--location-arn` parametro, specificare l'ARN del Azure Blob Storage posizione che stai aggiornando.
1. Per il `--agent-arns` parametro, specifica l'ARN del tuo nuovo agente.
Puoi specificare più di un ARN se stai sostituendo [più agenti](do-i-need-datasync-agent.md#multiple-agents) per una sede.
1. Per l'`Token`opzione del `--sas-configuration` parametro, specifica il [token SAS](creating-azure-blob-location.md#azure-blob-sas-tokens) che consente di accedere DataSync al tuo archivio BLOB.
1. Esegui il `update-location-azure-blob` comando per aggiornare la posizione.
------
## Passaggi successivi
1. [Elimina il tuo vecchio agente](clean-up.md#deleting-agent). Se hai delle DataSync attività in esecuzione che utilizzano questo agente, attendi il completamento di tali attività prima di eliminarle.
1. Se devi sostituire agenti per più sedi, ripeti i passaggi precedenti.
1. Quando hai finito, puoi riprendere a [eseguire le tue attività](run-task.md).
**Nota**
**Sostituzione di agenti per attività pianificate**: se sostituisci un agente per un'[attività pianificata](task-scheduling.md), devi avviare l'attività manualmente se il nuovo agente utilizza un tipo di [endpoint di servizio](choose-service-endpoint.md) diverso rispetto al vecchio agente. Se non si esegue l'operazione manualmente prima della successiva esecuzione pianificata, l'operazione ha esito negativo.
Ad esempio, se il vecchio agente utilizzava un endpoint di servizio pubblico, ma il nuovo agente utilizza un endpoint VPC, avvia l'attività manualmente utilizzando la console o l'operazione. `StartTaskExecution` Dopodiché, l'attività riprenderà a funzionare secondo la pianificazione.