As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Substituindo seu agente AWS DataSync Para substituir um agente AWS DataSync, você deve criar um novo agente e atualizar todos os locais de transferência que estejam usando o agente antigo. ## Criar um novo agente Para criar seu novo agente do DataSync, siga o mesmo processo de criação do agente antigo: 1. [Implante um agente](deploy-agents.md) em seu ambiente de armazenamento. 1. [Escolha um endpoint de serviço](choose-service-endpoint.md) que o atendente use para se comunicar com AWS. 1. [Configure sua rede](datasync-network.md) para que o agente possa se comunicar com seu armazenamento e AWS. 1. [Ative seu agente](activate-agent.md). 1. Depois de ativado, anote o nome do recurso da Amazon (ARN) do agente. Você precisa desse ARN ao atualizar sua localização no DataSync para usar o novo agente. ## Atualizando sua localização com o novo agente Depois de criar um novo agente, você pode atualizar um local existente do DataSync para usar esse agente. Na maioria dos casos, você também precisa inserir as credenciais de acesso novamente para atualizar o local. Isso ocorre porque o DataSync armazena as credenciais de localização de uma forma que somente seu agente pode usá-las. ### Utilizar o console do DataSync As instruções a seguir descrevem como atualizar locais com um novo agente usando o console do DataSync. ------ #### [ NFS ] 1. Abra o console AWS DataSync em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. No painel de navegação esquerdo, expanda **Transferência de dados** e, em seguida, escolha **Locais**. 1. Escolha o local que você deseja atualizar e, em seguida, escolha **Editar**. 1. Em **Agentes**, escolha seu novo agente. Você pode escolher mais de um agente se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Escolha **Salvar alterações**. ------ #### [ SMB ] 1. Abra o console AWS DataSync em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. No painel de navegação esquerdo, expanda **Transferência de dados** e, em seguida, escolha **Locais**. 1. Escolha o local que você deseja atualizar e, em seguida, escolha **Editar**. 1. Em **Agentes**, escolha seu novo agente. Você pode escolher mais de um agente se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Em **Password (Senha)**, insira a senha do usuário que pode montar o servidor de arquivos SMB e tenha permissão para acessar os arquivos e pastas envolvidos na sua transferência. 1. Escolha **Salvar alterações**. ------ #### [ HDFS ] 1. Abra o console AWS DataSync em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. No painel de navegação esquerdo, expanda **Transferência de dados** e, em seguida, escolha **Locais**. 1. Escolha o local que você deseja atualizar e, em seguida, escolha **Editar**. 1. Em **Agentes**, escolha seu novo agente. Você pode escolher mais de um agente se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Se você estiver usando a autenticação Kerberos, faça o upload do seu **arquivo Keytab** e do **arquivo de configuração do Kerberos**. 1. Escolha **Salvar alterações**. ------ #### [ Object storage ] 1. Abra o console AWS DataSync em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. No painel de navegação esquerdo, expanda **Transferência de dados** e, em seguida, escolha **Locais**. 1. Escolha o local que você deseja atualizar e, em seguida, escolha **Editar**. 1. Em **Agentes**, escolha seu novo agente. Você pode escolher mais de um agente se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Se o local exigir credenciais, insira a **chave secreta** que permite que o DataSync acesse o bucket de armazenamento de objetos. 1. Escolha **Salvar alterações**. ------ #### [ Armazenamento de blobs do Azure ] Faça o seguinte para atualizar sua localização Microsoft Azure Blob Storage: 1. Abra o console AWS DataSync em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. No painel de navegação esquerdo, expanda **Transferência de dados** e, em seguida, escolha **Locais**. 1. Escolha o local que você deseja atualizar e, em seguida, escolha **Editar**. 1. Em **Agentes**, escolha seu novo agente. Você pode escolher mais de um agente se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Em **token**, insira o [token de assinatura de acesso compartilhado (SAS)](creating-azure-blob-location.md#azure-blob-sas-tokens) que permite que o DataSync acesse seu armazenamento de blobs. 1. Escolha **Salvar alterações**. ------ ### Utilizar o AWS CLI As instruções a seguir descrevem como atualizar locais com um novo agente usando o AWS CLI. (Também é possível fazer isso usando a [API do DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html)). ------ #### [ NFS ] 1. Copie o seguinte comando [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. Para o parâmetro `--location-arn`, especifique o ARN do local do NFS que você está atualizando. 1. Para a opção `--on-prem-config` do parâmetro `AgentArns`, especifique o ARN do seu novo agente. Você pode especificar mais de um ARN se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Execute o comando `update-location-nfs` para atualizar o local. ------ #### [ SMB ] 1. Copie o seguinte comando [pdate-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. Para o parâmetro `--location-arn`, especifique o ARN do local do SMB que você está atualizando. 1. Para o parâmetro `--agent-arns`, especifique o ARN do seu novo agente. Você pode especificar mais de um ARN se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Para o parâmetro `--password`, especifique a senha do usuário que pode montar o servidor de arquivos SMB e tenha permissão para acessar os arquivos e pastas envolvidos na sua transferência. 1. Execute o comando `update-location-smb` para atualizar o local. ------ #### [ HDFS ] 1. Copie o seguinte comando [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. Para o parâmetro `--location-arn`, especifique o ARN do local do HDFS que você está atualizando. 1. Para o parâmetro `--agent-arns`, especifique o ARN do seu novo agente. Você pode especificar mais de um ARN se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Se você estiver usando a autenticação Kerberos, inclua os parâmetros `--kerberos-keytab` e `--kerberos-krb5-conf`: + Para o parâmetro `--kerberos-keytab`, a tabela de chaves Kerberos (keytab) que contém mapeamentos entre a entidade principal Kerberos definida e as chaves criptografadas. Você pode carregar o arquivo keytab fornecendo o endereço do arquivo. + Para o parâmetro `--kerberos-krb5-conf`, especifique o arquivo que contém a configuração do seu realm Kerberos. Você pode especificar o arquivo `krb5.conf` fornecendo o endereço do arquivo. Se você estiver usando uma autenticação simples, não precisará incluir esses parâmetros relacionados ao Kerberos no seu comando. 1. Execute o comando `update-location-hdfs` para atualizar o local. ------ #### [ Object storage ] 1. Copie o seguinte comando [pdate-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. Para o parâmetro `--location-arn`, especifique o ARN do local de armazenamento do objeto que você está atualizando. 1. Para o parâmetro `--agent-arns`, especifique o ARN do seu novo agente. Você pode especificar mais de um ARN se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Faça o seguinte, dependendo de se o local de armazenamento de objetos exige credenciais de acesso: + **Se o local exigir credenciais**: no parâmetro `--secret-key`, especifique a chave secreta que permite que o DataSync acesse o bucket de armazenamento de objetos. + **Se o local exigir credenciais**: especifique strings vazias para os parâmetros `--access-key` e `--secret-key`. Veja um exemplo de comando : ``` 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. Execute o comando `update-location-object-storage` para atualizar o local. ------ #### [ Armazenamento de blobs do Azure ] 1. Copie o seguinte comando [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. Para o parâmetro `--location-arn`, especifique o ARN do local Azure Blob Storage que você está atualizando. 1. Para o parâmetro `--agent-arns`, especifique o ARN do seu novo agente. Você pode especificar mais de um ARN se estiver substituindo [vários agentes](do-i-need-datasync-agent.md#multiple-agents) em um local. 1. Para a opção `--sas-configuration` do parâmetro `Token`, especifique o [token SAS](creating-azure-blob-location.md#azure-blob-sas-tokens) que permite que o DataSync acesse seu armazenamento de blob. 1. Execute o comando `update-location-azure-blob` para atualizar o local. ------ ## Próximas etapas 1. [Exclua seu agente antigo](clean-up.md#deleting-agent). Se você tiver alguma tarefa do DataSync em execução usando esse agente, espere até que essas tarefas terminem antes de excluí-las. 1. Se você precisar substituir agentes em vários locais, repita as etapas anteriores. 1. Quando terminar, você pode retomar a [execução das tarefas](run-task.md). **nota** **Substituição de agentes para tarefas agendadas**: se substituir um agente para uma [tarefa agendada](task-scheduling.md), inicie a tarefa manualmente se o novo agente estiver usando um tipo de [endpoint de serviço](choose-service-endpoint.md) diferente do antigo. Se você não executar a tarefa manualmente antes da execução agendada, haverá falha na tarefa. Por exemplo, se o agente antigo usava um endpoint de serviço público, mas o novo agente usa um endpoint da VPC, inicie a tarefa manualmente usando o console ou a operação `StartTaskExecution`. Depois disso, a execução da tarefa será retomada segundo o agendamento.