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 Automation Suite.

As instruções nesta página aplicam-se para migrar seu Orchestrator no local, independente ou por meio do Automation Suite, para o Automation Cloud^TM.

Ao planejar sua migração do Orchestrator no local para o Automation Cloud^TM, é aconselhável que você execute as seguintes etapas:

Atualize para uma versão do On-Premises Orchestrator compatível.
Migre de pastas clássicas para modernas, pois as pastas clássicas têm restrições no Automation Cloud^TM.
Execute a ferramenta de migração para migrar do On-Premises Orchestrator para o Automation Cloud^TM.

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 do Enterprise ou do Enterprise Trial está ativo no Automation Cloud^TM (Administrador > Licenças).
Certifique-se de ter licenças de robôs suficientes para corresponder ao número de robôs sendo migrados (Administrador > 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.
Verifique se você tem credenciais de administrador para o On-Premises Orchestrator
Certifique-se de ter a 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.
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. Pode acessar o Automation Cloud^TM (tem acesso à Internet e 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 anterior.

Entidades migradas pela ferramenta de migração

Ao usar a ferramenta de migração, as seguintes entidades são criadas automaticamente no Automation Cloud^TM 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
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 o Automation Cloud^TM 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 no Automation Cloud^TM 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 elas são definidas como desabilitadas	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

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

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

A ferramenta de migração deve conectar-se à API de serviço do Orchestrator no Automation Cloud^TM 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:

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 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 ao Automation Cloud^TM 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 .zip arquivo que você baixou para a ferramenta e, em seguida, execute a ferramenta .exe .
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.
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.
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.
Selecione Início para retornar à primeira tela da ferramenta de migração.
Para o método de ativação, dessa vez escolha Connect to Automation Cloud^TM.

Preencha as informações para permitir que a ferramenta se conecte à Automation Cloud^TM 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 no Automation Cloud^TM. Você pode encontrar esse valor na página Administrador > Aplicativos externos.
Organization Name	A parte específica da organização da sua URL do Automation Cloud^TM . 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 do Automation Cloud^TM 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 ao Automation Cloud^TM 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 ao Automation Cloud^TM usando o OAuth, um usuário com as permissões adequadas para os escopos adicionados quando você registrou o aplicativo externo deve fazer login no Automation Cloud^TM. 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 no Automation Cloud^TM.

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

No Automation Cloud^TM, 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 de nuvem do 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: