Uso da Ferramenta de migração da Automation Cloud

A Ferramenta de migração da Automation Cloud é um aplicativo de área de trabalho projetado para simplificar o processo de migração de uma opção de implantação para outra. A ferramenta automatiza várias etapas de migração, tornando mais fácil fazer a transição de seu independente ou do Automation Suite Orchestrator para Test Cloud, Test Cloud Dedicated, Test Cloud Public Sector ou Test Cloud para local.

As instruções nesta página aplicam-se para migrar seu On-Premises Orchestrator, independente ou por meio do Automation Suite, para uma plataforma de nuvem.

Observação:

A disponibilidade de funcionalidades depende da plataforma de nuvem que você usa. Para obter detalhes, consulte a página de disponibilidade de recursos.

Antes de começar

Ao planejar sua migração do On-Premises Orchestrator para uma plataforma na nuvem, é aconselhável que você siga as seguintes etapas:

1. Atualize para uma versão do On-Premises Orchestrator compatível.
2. Migre de pastas clássicas para modernas, pois as pastas clássicas têm restrições nas plataformas em nuvem, o que significa que elas não existem nas plataformas em nuvem da UiPath.
3. Execute a ferramenta de migração para migrar do On-Premises Orchestrator para a plataforma de nuvem desejada.
   Observação:

   • Embora outras sequências sejam tecnicamente possíveis, esta é a abordagem mais comum.
   • A Ferramenta de migração da Automation Cloud opera de forma independente e não está em conformidade com nosso Ciclo de vida padrão do produto.

Requisitos

Para usar a ferramenta de migração, você deve atender aos seguintes critérios:

• Sua versão independente do Orchestrator deve ser compatível. Para obter detalhes específicos da versão, consulte nossa documentação do Ciclo de vida do produto.
• Você precisa de uma licença ativa para uma plataforma de nuvem. Para obter mais informações, consulte nossa documentação de Licenciamento .
• Para o licenciamento Flex, você precisa de uma licença Pro, Pro Trial ou Enterprise na Automation Cloud. Embora você possa usar a ferramenta durante uma Pro Trial para avaliação, algumas limitações podem se aplicar, como restrições de licença do tenant e do robô. Para obter mais informações, consulte nossa documentação de Licenciamento .

Pré-requisitos

Antes de abrir a Ferramenta de migração da Automation Cloud, faça as seguintes preparações:

1. Dependendo da sua plataforma de nuvem, verifique se o plano de licenciamento Enterprise ou Enterprise Trial está ativo (Admin > Licenças).
2. Certifique-se de ter licenças de robôs suficientes para corresponder ao número de robôs que estão sendo migrados (Admin > Licenças > Robôs e serviços). A ferramenta migra robôs enquanto houver licenças disponíveis, depois do que ela começa a pular robôs.
3. Certifique-se de ter credenciais de administrador para o ambiente do qual você migra.
4. Certifique-se de ter permissão de Exibir para todas as entidades sendo migradas. Se você não tiver a permissão Visualizar para algumas entidades, essas entidades não serão migradas.
5. Você deve ser um administrador da organização na Automation Cloud para registrar a ferramenta como um aplicativo externo.
6. Certifique-se de que a máquina na qual você executa a Ferramenta de migração da Automation Cloud atenda aos seguintes requisitos:
   1. Pode se conectar à versão independente do Orchestrator, do Orchestrator em uma plataforma de nuvem ou do Orchestrator no Automation Suite.
   2. possa acessar a plataforma de nuvem (tem acesso à internet e um navegador compatível);
   3. Executa o sistema operacional Windows.
7. Baixe a ferramenta de migração na máquina que atende aos requisitos na etapa anterior.

Entidades migradas pela ferramenta de migração

Ao usar a ferramenta de migração, as seguintes entidades, conforme descrito na tabela, são criadas automaticamente na plataforma de nuvem para espelhar sua configuração do Orchestrator:

Entidade	Migrado	Não migrado
Configurações	Sim, com exceções	Algumas configurações locais, como senhas e certas configurações expostas a tenants
Pacotes	Todos os pacotes e versões do pacote	Entidades que dependem de feeds de pacote externos que exigem autenticação Observação: A autenticação é necessária após a conclusão da migração para feeds de pacote externos configurados com autenticação básica
Bibliotecas	Apenas feeds em nível de tenant	Entidades que dependem de bibliotecas com configurações no nível do host ou bibliotecas externas inacessíveis
Calendários	Sim	N/A
Máquinas	Sim Observação: Possíveis limitações de atribuições de slots de máquina devido a licenças ausentes	Chaves de máquina A falha se o mapeamento da conta do robô for usado.
Pastas	Sim Observação: você pode optar por migrar todas as pastas em massa, assim como pastas individuais.	Pastas do espaço de trabalho pessoal
Ambientes	Sim, para pastas clássicas.	N/A (para pastas modernas)
Robôs (classico)	Sim Observação: Possíveis limitações de criação de robôs devido a licenças ausentes.	Ignorado quando as licenças se esgotam, com um erro registrado para cada robô ignorado
Robôs (moderno)	Sim Observação: Se certas condições forem atendidas, os robôs serão associados a um usuário local que tenha um endereço de email e esse mesmo email já foi convidado para uma plataforma de nuvem da UiPath e está associado a um usuário.	Ignorado quando as licenças se esgotam, com um erro registrado para cada robô ignorado. Falha se um usuário em uma plataforma de nuvem da UiPath não existir. A falha se o mapeamento da conta do robô for usado.
Associações de ambientes	O mapeamento do ambiente do robô	N/A
Processos	Sim Observação: A ferramenta de migração pode se referir a processos como versões	N/A
Filas	Sim	N/A
Gatilhos	Sim, mas elas são definidas como desabilitadas	Falha se um usuário em uma plataforma de nuvem da UiPath não existir. A falha se o mapeamento da conta do robô for usado.
Ativos	Certos tipos de ativos são totalmente compatíveis, com algumas considerações para ativos de credenciais	Valores de ativo por usuário em pastas modernas
Feed de pastas	Sim	N/A

Entidades não migradas pela ferramenta de migração

A ferramenta de migração não migra as seguintes entidades:

• Contas de usuários e robôs
• Atribuições de função
• 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)
• Armazenar buckets
• Logs
• Tarefas

Registro da ferramenta de migração como um aplicativo externo

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

Para registrar a Ferramenta de migração da Automation Cloud como um aplicativo externo, siga as seguintes etapas:

1. Adicione a ferramenta como um novo aplicativo externo seguindo as instruções em Adição de um aplicativo externo. Certifique-se de usar a seguinte configuração:
   • Tipo: não confidencial
   • Recursos: API do Orchestrator
   • Escopos de usuário: 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.

Execução da ferramenta de migração

A ferramenta pode migrar um tenant de cada vez. Você pode executar a ferramenta para cada um de seus tenants. Com cada execução, a ferramenta realiza as seguintes operações:

• Conecta ao seu Orchestrator no local para exportar entidades para o tenant fornecido.
• Conecta-se à plataforma de nuvem para importar e criar as entidades migradas no Orchestrator.

Para obter mais informações sobre entidades sujeitas à migração, consulte Entidades migradas pela ferramenta de migração.

1. Extraia o .zip arquivo que você baixou para a ferramenta e, em seguida, execute a ferramenta .exe .

2. Para escolher seu ambiente de exportação, siga uma das seguintes etapas:

   • Selecione MSI no local, se você migrar do Orchestrator independente.
   • Selecione o Automation Suite para conectar-se ao aplicativo externo e preencha o formulário de entrada de exportação, se você migrar do Automation Suite Orchestrator.
   

3. Preencha as informações para permitir que a ferramenta se conecte ao seu On-premises Orchestrator.

   
   
   Observação:

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

4. Selecione Iniciar exportação para conectar-se ao seu ambiente de origem e baixar as informações de configuração. A exportação inicia-se 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 da ferramenta de migração.

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

7. Preencha as informações para permitir que a ferramenta se conecte à plataforma de nuvem para carregar as informações de configuração. A tabela a seguir descreve os campos necessários para se conectar à plataforma de nuvem.

   

Campo	Detalhes
ID do Aplicativo do Cliente	O valor do ID do aplicativo associado ao registro do aplicativo externo na plataforma de nuvem. Você pode encontrar esse valor na página Administrador > Aplicativos externos.
Organization Name	A parte específica da organização da sua URL da plataforma de nuvem. Os administradores da organização podem localizar essas informações no campo URL em Admin > Configurações da organização . Nota: Você não precisa incluir a URL completa, apenas a parte editável, que é específica para sua organização. Por exemplo, se a URL for https://cloud.uipath.com/myOrgName, adicione myOrgName ao campo.
Nome do Tenant	O nome exato do tenant da plataforma de nuvem onde você deseja adicionar as informações migradas. Os dados migrados serão visíveis no serviço do Orchestrator associado àquele tenant.

8. Selecione **Iniciar importação** para conectar-se à plataforma de nuvem e comece a migrar as informações para o serviço do Orchestrator de destino.

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

Para se conectar à plataforma de nuvem usando o OAuth, um usuário com as permissões adequadas para os escopos adicionados quando você registrou o aplicativo externo deve fazer login na oferta de nuvem. Quando isso acontece, uma nova janela se abre com uma mensagem de sucesso se o fluxo do OAuth tiver sido bem sucedido.

Quando concluído, o resumo de importação lista todas as entidades que foram importadas com sucesso para o serviço do Orchestrator na plataforma de nuvem.

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 de migração da Automation Cloud não pode migrar todos os dados, há algumas tarefas finais que devem ser executadas manualmente.

1. Na plataforma de nuvem, selecione o tenant que foi o alvo da importação e abra o Orchestrator. 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.
2. Aloque licenças de robô e serviço para o Orchestrator. As máquinas são criadas e licenciadas enquanto existem licenças disponíveis, mas quando as licenças acabarem, as máquinas continuam sendo criadas sem licenças, portanto, você precisa atualizá-las para alocar o número adequado de licenças.
3. Carregue manualmente qualquer feed de biblioteca que a ferramenta não tenha migrado.
4. Se algum robô foi pulado durante a exportação ou importação, crie-o manualmente.
5. Crie quaisquer webhooks, catálogos de tarefas, armazenamento de credenciais ou outras informações que a ferramenta não migra. A seção Entidades migradas pela ferramenta de migração também inclui uma lista do que a ferramenta não migra.
6. Conecte robôs manualmente ao serviço de nuvem do Orchestrator.
7. Habilite manualmente os gatilhos conforme necessário.
8. 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 dos arquivos anteriores, seria útil saber o seguinte:

• A versão de seu On-premises Orchestrator;
• Os nomes da sua organização da plataforma de nuvem e dos tenant.