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.

Instructions on this page apply for migrating your on-premises Orchestrator, either standalone or via Automation Suite, to Automation Cloud^TM.

When planning your migration from on-premises Orchestrator to Automation Cloud^TM, it is advisable that you take the following steps:

1. Atualize para uma versão do On-Premises Orchestrator compatível.

2. Migrate from classic to modern folders, as classic folders have restrictions in Automation Cloud.

3. Run the migration tool to migrate from on-premises Orchestrator to 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.

Pré-requisitos

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

1. Check that the Enterprise or Enterprise Trial licensing plan is active in Automation Cloud^TM (Admin > Licenses).

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

3. Certifique-se de ter credenciais de administrador para o ambiente do qual você migra.

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

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 ao Orchestrator independente, ao Orchestrator no Automation Cloud ou ao Orchestrator no Automation Suite.

   2. Can access Automation Cloud^TM (has internet access and a supported browser);

   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

When using the migration tool, the following entities, as described in the table, are automatically created in Automation Cloud^TM to mirror your Orchestrator setup:

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: If certain conditions are met, robots are associated with an on-premises user that has an email address, and that same email was already invited to Automation CloudTM and is associated to a user.	Ignorado quando as licenças se esgotam, com um erro registrado para cada robô ignorado Fails if a user in Automation CloudTM does not exist
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

• Tarefas

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

The migration tool must connect to the Orchestrator service API in Automation Cloud^TM to create the migrated entities. It uses the OAuth flow for this and, therefore, must be registered as an external application.

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

• Connects to Automation Cloud^TM to import and create the migrated entities in Orchestrator.

Para obter mais informações sobre as 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 para uma conta de administrador que também tenha permissões de Visualização 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. For the activation method, this time choose Connect to Automation Cloud^TM.
7. Fill in the information to allow the tool to connect to Automation Cloud^TM to upload the setup information. The following table describes the necessary fields to connect to Automation Cloud^TM.
   

   Campo	Detalhes
   ID do Aplicativo do Cliente	The Application ID value associated with the external application registration in Automation CloudTM. Você pode encontrar esse valor na página Administrador > Aplicativos externos.
   Organization Name	The organization-specific part of your Automation CloudTM URL. Organization administrators can find this information in the URL field in Admin > Organization Settings. 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, adicionemyOrgNameao campo.
   Nome do Tenant	The exact name of the Automation CloudTM tenant where you want to add the migrated information. The migrated data will be visible in the Orchestrator service associated to that tenant.

8. Select Start Import to connect to Automation Cloud^TM and start to migrate the information to the target Orchestrator service.

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

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

   

   When finished, the import summary lists all entities that were successfully imported into the Orchestrator service in 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.
9. 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.

1. In Automation Cloud^TM, select the tenant that was the import target, and open Orchestrator. Check that folders and entities were successfully migrated. You can use the import summary to check the specific items that had warnings or errors.
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;

• Your Automation Cloud^TM organization and tenant names.