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 Automation Cloud, Automation Cloud Setor Público ou para Automation Suite.

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

When planning your migration from on-premises Orchestrator to Automation Cloud, it is advisable that you adhere to the following sequence:

Upgrade to a supported on-premises Orchestrator version.
Migrate from classic to modern folders, as classic folders have restrictions in Automation Cloud.
Run the migration tool to migrate from on-premises Orchestrator to Automation Cloud.

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 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:

Verifique se o plano de licenciamento Enterprise ou Enterprise Trial está ativo em Automation Cloud (Administrador) > Licenças).
Certifique-se de ter licenças de robôs suficientes na Automation Cloud 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.
Certifique-se de ter credenciais de administrador para o On-Premises Orchestrator e a permissão Visualizar para todas as entidades migradas. Se você não tiver a permissão Visualizar para algumas entidades, essas entidades não serão migradas.
Você deve ser um administrador da organização na Automation Cloud para registrar a ferramenta como um aplicativo externo.
Certifique-se de que a máquina na qual você executa a Ferramenta de migração da Automation Cloud atenda aos seguintes requisitos:
1. possa conectar-se ao On premises Orchestrator:
2. possa acessar a Automation Cloud (tenha acesso à Internet e a um navegador compatível);
3. execute o sistema operacional Windows;
4. tenha o .NET Core Desktop Runtime para x64 instalado.
Baixe a ferramenta de migração na máquina que atende aos requisitos na etapa 5.

Entidades migradas pela ferramenta de migração

Ao usar a ferramenta de migração, as seguintes entidades são criadas automaticamente na Automation Cloud 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. 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 os feeds de 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
Pastas	Sim	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 a Automation Cloud 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 na Automation Cloud não existir.
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 eles são definidos como desabilitados.	N/A
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

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

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

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 Automation Cloud para criar as entidades migradas. Ela usa o fluxo do OAuth para isso e, portanto, deve ser registrada na Automation Cloud como um aplicativo externo.

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

Adicione a ferramenta como um novo aplicativo externo seguindo as instruções 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 eOR.Queues.
- URL de redirecionamento: http://127.0.0.1:8888/auth/
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 à Automation Cloud 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.

Extraia o .ziparquivo que você baixou para a ferramenta e execute a ferramenta .exe.
To choose your export environment:
- Select On-premises MSI, if you migrate from standalone Orchestrator.
- Select Automation Suite to connect to the external application and fill in the export input form, if you migrate from Automation Suite Orchestrator.
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 para uma conta de administrador que também tenha permissões de Visualização em todas as entidades que você deseja migrar.
Clique em 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.
Clique em Início para retornar à primeira tela da ferramenta de migração.
Para o método de ativação, dessa vez escolha Conectar à Automation Cloud.

Preencha as informações para permitir que a ferramenta conecte-se à Automation Cloud para carregar as informações de configuração:

Campo	Detalhes
ID do Aplicativo do Cliente	O valor do ID do aplicativo associado ao registro do aplicativo externo na Automation Cloud. Você pode encontrar esse valor na página Administrador > Aplicativos externos.
Organization Name	A parte específica da organização da sua URL da Automation Cloud. 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 Automation Cloud onde você deseja adicionar as informações migradas. Os dados migrados serão visíveis no serviço do Orchestrator associado àquele tenant.

Selecione Iniciar importação para conectar-se à Automation Cloud 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 conectar-se à Automation Cloud 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 Automation Cloud. 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 Automation Cloud.
Tudo que não tenha sido importado aparece como um erro e as importações parciais são listadas como alertas. Você pode clicar em Exibir relatório para obter mais detalhes sobre quais entidades encontraram um erro ou um alerta.
Quando estiver pronto, selecione Concluído para fechar a ferramenta.

Nota: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.

Na Automation Cloud, 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.
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.
Carregue manualmente qualquer feed de biblioteca que a ferramenta não tenha migrado.
Se algum robô foi pulado durante a exportação ou importação, crie-o manualmente.
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.
Conecte robôs manualmente ao serviço do Cloud Orchestrator.
Habilite manualmente os gatilhos conforme necessário.
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: