Executando uma migração de único tenant

Use a ferramenta de migração uipathctl para migrar dados entre clusters do Automation Suite no EKS/AKS.

Você pode usar a Ferramenta de Migração da UiPath Automation Cloud™ para migrar automaticamente entidades do seu Orchestrator independente para o serviço do Orchestrator no Automation Suite.

Esta página fornece detalhes sobre o tipo de entidades sendo migradas, os requisitos para a migração do Orchestrator independente para o Automation Suite, o procedimento de migração específico e quaisquer operações que possam ser necessárias após a migração.

Entidades sendo migradas

Quando você executa a Ferramenta de Migração do Automation Cloud, ela cria automaticamente as seguintes entidades no Automation Suite para corresponder à sua configuração do Orchestrator independente:

Entidade	Migrado	Não migrado
Configurações	Sim, com exceções (veja à direita).	Algumas configurações que ficam expostas ao tenant no caminho de leitura não podem ser modificadas no Automation Suite, como o logotipo e a cor do host. As senhas na tabela Configurações não podem ser exportadas porque a API remove os valores da resposta. Como resultado, nenhuma senha será migrada. Isso afeta alertas de e-mail (senha SMTP) e feeds externos com autenticação básica.
Pacotes	Migra todos os pacotes e suas versões. Se um feed de pacotes for externo e configurado com a autenticação básica, as credenciais terão que ser inseridas após a conclusão da migração.	Se um feed de pacotes for externo e não for acessível pela Internet, as entidades que dependem desses pacotes não são migradas.
Bibliotecas	Apenas os feeds de nível de tenant.	Se um feed de biblioteca estiver ao nível do host ou for externo e não estiver acessível pela Internet, as entidades que dependem dessas bibliotecas não são migradas.
Calendários	Sim	N/A
Máquinas	Sim, mas se não houver licenças suficientes para acomodar as atribuições de slots da máquina, a máquina será importada com todos os slots definidos como 0.	As chaves de máquina não são migradas.
Pastas	Sim. Você pode optar por migrar todas as pastas em massa, bem como pastas individuais.	As pastas de espaços de trabalho pessoais não são migradas.
Ambientes	Sim, para pastas clássicas.	Não se aplica à pastas modernas.
Robôs (classico)	Sim, mas se não houver licenças suficientes para acomodar a criação do robô, o robô é ignorado durante a importação.	Ignorado quando as licenças acabam e um erro é registrado para cada um.
Robôs (moderno)	Os robôs modernos são migrados se o usuário com o qual estão associados existir no Automation Suite e tiver o mesmo endereço de e-mail.	- Se o usuário não existir no Automation Suite, essa migração de robô específica falhará. - Ignorado quando as licenças se esgotam e um erro é registrado para cada uma.
Associações de ambientes	O mapeamento do ambiente de robô é migrado.	N/A
Processos	Os processos são migrados. A ferramenta pode se referir a esses como Versões.	N/A
Filas	Sim	N/A
Gatilhos	Os gatilhos são migrados, mas são todos definidos como desabilitados.
Ativos	- Os tipos de ativo Boolean, Text e Integer são totalmente compatíveis. - Os ativos de credenciais também são migrados, mas uma senha fictícia é usada porque as senhas não podem ser migradas pela ferramenta. Você precisará atualizar manualmente as senhas para cada ativo de credencial após a migração. Os ativos de credenciais são atribuídos ao armazenamento de credenciais padrão no Automation Suite. - Os valores por robô também são migrados, mas se o robô não tiver sido migrado, esse valor será ignorado e um aviso de importação será registrado.	Os valores de ativos por usuário nas pastas modernas não são compatíveis. O ativo é importado com o valor padrão ou ignorado se nenhum estiver definido.
Associações de máquina	Os mapeamentos de robô-máquina são migrados.	N/A

Entidades não migradas

As seguintes entidades não são migradas pela ferramenta:

• Feed de pastas
• Usuários
• Itens de Fila
• Catálogos de Ações
• Webhooks
• Entidades de teste (conjuntos de testes, casos de testes, execuções de testes, horários de testes, filas de dados de testes)
• Logs

Pré-requisitos

Antes de abrir a ferramenta, faça as seguintes preparações:

1. Certifique-se de ter licenças de robô suficientes no Automation Suite para corresponder ao número de robôs sendo migrados (Administrador > Licenças > Robôs e serviços). A ferramenta só migra robôs enquanto houver licenças disponíveis, depois do que ela começa a pular robôs.
2. Você deve ter credenciais de administrador para a versão independente do Orchestrator e permissões de Exibir para todas as entidades sendo migradas. Se você não tiver a permissão de Exibir para algumas entidades, essas entidades não serão migradas.
3. Você deve ser um administrador da organização no Automation Suite.
4. Para executar a ferramenta, você precisa de uma máquina que:
   1. pode se conectar ao Orchestrator independente e ao Automation Suite (tem acesso à internet)
   2. b. tem o sistema operacional Windows
   3. se ela se conectar ao Automation Suite por meio de um proxy, terá as variáveis HTTP_PROXY, HTTPS_PROXY e NO_PROXY definidas como variáveis de ambiente do sistema, com NO_PROXY listando os hosts que a ferramenta deve alcançar diretamente, como seu Orchestrator independente. Sem essas variáveis, a etapa de importação falha.
5. Baixe UiPath.AutomationCloudMigrationTool.zip na máquina mencionada.
6. Registre a ferramenta como um aplicativo externo na organização do Automation Suite de destino.

Registrando a ferramenta como um aplicativo externo

A ferramenta de migração precisa se conectar à API de serviço do Orchestrator no Automation Suite para criar as entidades migradas. Ela usa o fluxo do OAuth para isso e, portanto, deve ser registrada no Automation Suite como um aplicativo externo.

1. Follow these instructions to add the tool as a new external application with the following specifics:
   • Tipo: não confidencial
   • Recursos: API do Orchestrator
   • Escopos de usuários: OR.Folders, OR.Settings, OR.Robots, OR.Machines, OR.Execution, OR.Assets, OR.Users, OR.Jobs, e OR.Queues.
   • URL de redirecionamento: http://127.0.0.1:8888/auth/
2. Salve o ID do aplicativo para uso posterior.

Executando a ferramenta

A ferramenta pode migrar um tenant de cada vez. Você pode executar a ferramenta várias vezes para cada um de seus tenants.

Com cada execução, a ferramenta:

1. Conecta-se ao seu Orchestrator independente para exportar entidades para o tenant escolhido.
2. Conecta-se ao Automation Suite para importar e criar as entidades migradas no tenant do Orchestrator.

For more information about entities that are subject to migration, refer to Entities Being Migrated.

Para executar a ferramenta:

1. Extraia o arquivo ZIP que você baixou para a ferramenta e execute o EXE da ferramenta.

2. Para o método de ativação, escolha Conectar à versão On-Premises:

   

3. Preencha as informações para permitir que a ferramenta se conecte ao seu Orchestrator independente:

   

   Certifique-se de que as credenciais que você fornece sejam de uma conta de administrador que também tenha permissões para Exibir em todas as entidades que você deseja migrar.

4. Selecione Iniciar exportação para se conectar ao seu Orchestrator independente e baixar as informações de configuração. A exportação se inicia e pode levar um tempo para ser concluída:

   

   Quando concluído, o resumo de exportação lista todas as entidades que foram exportadas com sucesso:

   

   Você pode selecionar Abrir arquivo para exibir o arquivo local criado para o resumo de exportação, que inclui alguns detalhes adicionais.

5. Selecione Início para retornar à primeira tela.

6. Para o método de ativação, dessa vez escolha Conectar ao Automation Suite.

7. Preencha as informações para permitir que a ferramenta se conecte ao Automation Suite para carregar as informações de configuração:

   

   Campo	Detalhes
   URL da organização	A URL da sua organização do Automation Suite. Os administradores da organização podem encontrar o nome da organização em Administrador > Configurações da organização. Por exemplo, insira https://mySite.com/myOrgName.
   ID do Aplicativo	O valor do ID do aplicativo associado ao registro do aplicativo externo no Automation Suite. Você pode encontrar esse valor na página Administrador > Aplicativos externos.
   Nome do Tenant	O nome exato do tenant do Automation Suite no qual você deseja adicionar as informações migradas. Os dados migrados ficarão visíveis no tenant do Orchestrator especificado.
   URL do Identity (opcional)	O URL do endpoint de identidade para sua organização do Automation Suite. Por exemplo, insira https://mySite.com/myOrgName/identity_.

8. Selecione Iniciar importação para conectar-se ao Automation Suite e comece a migrar as informações para o tenant do Orchestrator de destino.

   A importação começa e pode levar um tempo para ser concluída:

   

   To connect to Automation Suite using OAuth, a user with the adequate permissions for the scopes added when you registered the external application must log in to Automation Suite. When they do, a new window opens with a success message if the OAuth flow was successful:

   

   Quando concluído, o resumo de importação lista todas as entidades que foram importadas com sucesso para o tenant do Orchestrator no Automation Suite:

   

   Tudo que não tenha sido importado aparece como um erro e as importações parciais são listadas como alertas. Você pode selecionar Exibir relatório para obter mais detalhes sobre quais entidades encontraram um erro ou um alerta.

9. Quando estiver pronto, selecione Concluído para fechar a ferramenta.

   Dica:

   Se necessário, você pode executar a ferramenta novamente para migrar dados para tenants adicionais.

Tarefas de pós-migração

Como a ferramenta não pode migrar tudo, existem algumas tarefas finais que devem ser executadas manualmente para que você obtenha a mesma configuração que tinha em seu Orchestrator independente.

1. No Automation Suite, faça login na organização do tenant que era o destino de importação e abra o Orchestrator.

2. Verifique se as pastas e entidades foram migradas com sucesso.

   Você pode usar o resumo de importação para verificar os itens específicos marcados com alertas ou erros.

3. Aloque licenças de robô e serviço para o Orchestrator.

   Durante a importação, máquinas são criadas e licenciadas enquanto houver licenças disponíveis. Após as licenças acabarem, as máquinas continuam sendo criadas sem licenças, portanto, você deve atualizá-las para alocar o número adequado de licenças.

   Observação:

   Se você migrou sem ativar sua licença do Automation Suite, nesse estágio você precisa ativá-la para continuar com a configuração.

4. Carregue manualmente qualquer feed de biblioteca que a ferramenta não tenha migrado.

5. Se algum robô foi pulado durante a exportação ou importação, crie-o manualmente.

6. Crie quaisquer webhooks, catálogos de tarefas, armazenamento de credenciais ou outras informações que a ferramenta não migra.

   The section Entities being migrated includes a list of what the tool does not migrate.

7. Conecte os robôs manualmente ao serviço do Orchestrator do Automation Suite.

8. Habilite manualmente os gatilhos conforme necessário.

   Enquanto a ferramenta migra os gatilhos, eles são todos desabilitados e você deve habilitá-los manualmente.

9. Verifique qualquer local no Orchestrator onde uma senha seja necessária e adicione-a: Robôs, Configurações e Ativos de credenciais.

Ajuda

Se você precisar de ajuda com um problema encontrado durante a exportação, importação ou após a importação, abra um Tíquete de suporte e inclua os seguintes arquivos:

• Registrar o arquivo (na subpasta de logs)
• Exportar arquivo de relatório (na subpasta MigrationAssets)
• Importar arquivo de relatório (na subpasta MigrationAssets)

Além desses arquivos, seria útil saber:

• A versão do seu Orchestrator independente
• Os nomes de sua organização e tenant do Automation Suite.