Migração para o ambiente autônomo ou do Automation Suite

Observação: uma atualização clássica para o AI Center™ 2022.4 de 2020.10 ou 2021.4 não está disponível; em vez disso, você precisa instalar o AI Center™ independente 2022.4 ou como parte de uma nova instalação do Automation Suite e pode migrar seu trabalho do ambiente anterior. Esse script de migração funciona para ambos os tipos de instalação, AI Center independente ou ambiente do Automation Suite.

Para atualizar do AI Center versão 2021.10, siga os procedimentos descritos na página Atualizar o AI Center.

Visão geral

Use este procedimento para migrar de 2021.4 ou 2020.10 para 2022.4. Para isso, uma nova instalação e migração são necessárias, em vez de atualização.

Use as seguintes etapas para migrar os dados de tenant do AI Center™ para o ambiente do AI Center independente ou ambiente do Automation Suite. Esse procedimento oferece suporte à migração para o seguinte:

• Banco de Dados
• Conjuntos de dados
• Pacotes de ML
  Observação: o pacote do Document Understanding sob demanda deve ser executado antes de implantar e treinar os pacotes DU ML migrados.

  No caso de instalação isolada, certifique-se de que os modelos com a mesma versão principal sejam adicionados ao seu modelo prontos para o uso. Para mais informações sobre instalação de modelos off-line, consulte Instalação off-line de pacotes de ML.

Pré-requisitos

Certifique-se de que o AI Center™ esteja funcionando em ambos os ambientes.

Além disso, os seguintes pré-requisitos devem ser atendidos na máquina na qual o script de migração é executado:

• Uma máquina Linux com as seguintes dependências instaladas: aws s3, s3cmd, jq, zip. A máquina pode ser uma das máquinas do AI Center ou uma nova. Para mais informações, consulte o exemplo abaixo.

Instalando dependências aws s3, s3cmd, jq, zip

Observação: no caso de dependências não atendidas, execute os seguintes comandos sem pacotes:

sudo susudo apt install -y jq awscli s3cmd zip gitsudo apt --fix-broken installsudo apt install -y jq awscli s3cmd zip

• Instale o utilitário do MS SQL a partir daqui. Você pode fazê-lo executando os seguintes comandos:

  sudo su
  curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list | sudo tee /etc/apt/sources.list.d/msprod.listsudo apt-get update 
  sudo apt-get install mssql-tools unixodbc-devsudo apt-get update 
  sudo apt-get install mssql-toolsecho 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bash_profileecho 'export PATH="$PATH:/opt/mssql-tools/bin"' >> ~/.bashrc
  source ~/.bashrc

• Conectividade com ambas as instâncias do AI Center™.
• Conectividade com ambas as instâncias do Orchestrator (no caso de as instâncias não serem as mesmas).
• Conectividade com servidores SQL (no caso de as instâncias não serem as mesmas).
• Possibilidade de acessar ambas as instâncias do AI Center.

Procedimento

Etapa 1: criar um tenant com o mesmo nome no Automation Suite ou no novo ambiente do AI Center

Crie um tenant correspondente no ambiente do Automation Suite ou do novo AI Center™ para cada tenant que você deseja migrar.

Etapa 2: gerar o arquivo Storage-creds.json na primeira máquina (também chamada de máquina de origem)

Essa etapa precisa ser executada na primeira máquina, aquela que você deseja migrar para o ambiente novo.

1. Conecte-se usando SSH à máquina que você deseja migrar.
2. Gere o arquivo storage-creds.json executando o comando abaixo:

   wget https://raw.githubusercontent.com/UiPath/ai-customer-scripts/stable/platform/sfmigration/storagemigration/get-credentials.sh
   chmod 777 get-credentials.sh
   ./get-credentials.sh

Observação: se estiver em execução a partir de uma terceira máquina, certifique-se de executar o seguinte comando :

./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}

Observação: se a mensagem de erro abaixo for exibida após executar o script acima, execute o comando bash -l e tente executar o script acima novamente

O arquivo gerado na Etapa 2 (storage-creds.json) será usado em outras etapas. Certifique-se de copiar e salvar o conteúdo do arquivo localmente.

Etapa 3: gerar o arquivo Storage-creds.json na segunda máquina

Essa etapa precisa ser executada na segunda máquina, aquela em execução no ambiente do Automation Suite.

1. Abra a porta 22 na máquina do Automation Suite.
2. Conecte-se usando SSH à máquina do Automation Suite.
3. Execute o comando abaixo:

   sudo su
   export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin

4. Baixe o arquivo de credenciais executando o comando abaixo:

   wget https://raw.githubusercontent.com/UiPath/ai-customer-scripts/stable/platform/sfmigration/storagemigration/get-credentials-sf.sh
   chmod 777 get-credentials-sf.sh
   ./get-credentials-sf.sh

O arquivo gerado na Etapa 4 (storage-creds-sf.json) será usado em outras etapas. Certifique-se de copiar e salvar o conteúdo do arquivo localmente.

Etapa 4: configurar máquina executando o script

Antes de percorrer as etapas abaixo, crie manualmente um tenant com o mesmo nome no ambiente do Automation Suite. Qualquer que seja o tenant que precisar ser migrado, um tenant correspondente deve ser criado no Automation Suite também.

Essa etapa precisa ser executada na máquina que executa o script.

1. Execute o comando abaixo para baixar o script de migração (Isso baixará o script do repositório público do git):

   sudo su 
   cd ~
   mkdir migration
   cd migration
   git clone https://github.com/UiPath/ai-customer-scripts
   cd ai-customer-scripts
   git checkout stable
   cd platform
   chmod 777 -R sfmigration
   cd ~/migration/ai-customer-scripts/platform/sfmigration/storagemigration/

2. Substitua o conteúdo no arquivo SOURCE_CREDENTIAL_FILE pelo conteúdo de storage-creds.json (consulte Etapa 2).
3. Substitua o conteúdo no arquivo TARGET_CREDENTIAL_FILE pelo conteúdo de storage-creds-sf.json (consulte Etapa 3).
4. Acesse o diretório base executando o seguinte comando:

   cd ~/migration/ai-customer-scripts/platform/sfmigration/

Substitua os detalhes no arquivo input.json (o arquivo que já está no diretório). Para facilitar a consulta, as credenciais são marcadas como TO-BE-REPLACED no arquivo input.json.

O arquivo JSON de amostra com descrição de cada campo é mencionado abaixo.

{
"SRC_AIC_INSTALLATION_VERSION": "TO-BE-REPLACED", // Values can be : 20.10 OR 21.4
"SRC_SERVER": "TO-BE-REPLACED",   // Replicated SQL Server host
"SRC_PKGMANAGER_DB_NAME": "TO-BE-REPLACED", // Replicated SQL Server Pkgmanager DB name
"SRC_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager", // Replicated SQL Server Pkgmanager DB schema, Note : Please check schema in case of multiple dbs in replicated
"SRC_PKGMANAGER_DB_USERNAME": "TO-BE-REPLACED", // Replicated SQL Server Pkgmanager DB Username
"SRC_PKGMANAGER_DB_PASSWORD": "TO-BE-REPLACED",  // Replicated SQL Server Pkgmanager DB Password
"SRC_TRAINER_DB_NAME": "TO-BE-REPLACED", // Replicated SQL Server AI-Trainer DB Name
"SRC_TRAINER_DB_SCHEMA": "ai_trainer", // Replicated SQL Server AI-Trainer DB Schema, Note : Please check schema in case of multiple dbs in replicated
"SRC_TRAINER_DB_USERNAME": "TO-BE-REPLACED", // Replicated SQL Server AI-Trainer DB Username
"SRC_TRAINER_DB_PASSWORD": "TO-BE-REPLACED",// Replicated SQL Server AI-Trainer DB Password
"DESTINATION_SERVER": "TO-BE-REPLACED", // Destination SQL Server host i.e ServiceFabric SQL Server host
"DESTINATION_DB_NAME": "TO-BE-REPLACED", // Destination SQL Server DB Name
"DESTINATION_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager", 
"DESTINATION_TRAINER_DB_SCHEMA": "ai_trainer",
"DESTINATION_DB_USERNAME": "TO-BE-REPLACED", // Destination SQL Server Username
"DESTINATION_DB_PASSWORD": "TO-BE-REPLACED", // Destination SQL Server Password
"TENANT_MAP": [
{
"SRC_TENANT_ID": "TO-BE-REPLACED", // Source Tenant Id i.e tenant UUID in replicated environment
"DESTINATION_TENANT_ID": "TO-BE-REPLACED", // Destination Tenant Id i.e Tenant UUID in the destination environment
"DESTINATION_ACCOUNT_ID": "TO-BE-REPLACED" // Destination Account UUID Id , host if Migrating to ServiceFabric standalone environment otherwise provide the actual Account UUID
}
]

O arquivo de amostra input.json com valores de amostra preenchidos para consulta (Observe que a captura de tela abaixo é para migração de Banco de dados de origem única para Banco de dados de destino único)

{
        "SRC_AIC_INSTALLATION_VERSION": "20.10",
        "SRC_SERVER": "sankar-sf-migration1sqlserver.database.windows.net",
        "SRC_PKGMANAGER_DB_NAME": "aifabric",
        "SRC_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager",
        "SRC_PKGMANAGER_DB_USERNAME": "test",
        "SRC_PKGMANAGER_DB_PASSWORD": "test",
        "SRC_TRAINER_DB_NAME": "aifabric",
        "SRC_TRAINER_DB_SCHEMA": "ai_trainer",
        "SRC_TRAINER_DB_USERNAME": "test",
        "SRC_TRAINER_DB_PASSWORD": "test",
        "DESTINATION_SERVER": "sfdev2290542-9a5254d2-sql.database.windows.net",
        "DESTINATION_DB_NAME": "AutomationSuite_AICenter",
        "DESTINATION_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager",
        "DESTINATION_TRAINER_DB_SCHEMA": "ai_trainer",
        "DESTINATION_DB_USERNAME": "test",
        "DESTINATION_DB_PASSWORD": "test",
        "TENANT_MAP": [
                {
                        "SRC_TENANT_ID": "d1eb428c-e188-46bf-a1dd-8908f90b4084",
                        "DESTINATION_TENANT_ID": "03527165-b242-4b98-834f-2eb3e5957223",
                        "DESTINATION_ACCOUNT_ID": "8cd64e27-12f4-427c-a575-dd4f2ea82551"
                }
        ]
}

O arquivo de amostra input.json com valores de amostra preenchidos para consulta (Observe que a captura de tela abaixo é para migração de Banco de dados de origem múltipla para Banco de dados de destino único)

{
        "SRC_AIC_INSTALLATION_VERSION": "20.10",
        "SRC_SERVER": "sankar-sf-migration1sqlserver.database.windows.net",
        "SRC_PKGMANAGER_DB_NAME": "aifabric_pkgmanager",
        "SRC_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager",
        "SRC_PKGMANAGER_DB_USERNAME": "test_1",
        "SRC_PKGMANAGER_DB_PASSWORD": "test_1",
        "SRC_TRAINER_DB_NAME": "aifabric_trainer",
        "SRC_TRAINER_DB_SCHEMA": "ai_trainer",
        "SRC_TRAINER_DB_USERNAME": "test_2",
        "SRC_TRAINER_DB_PASSWORD": "test_2",
        "DESTINATION_SERVER": "sfdev2290542-9a5254d2-sql.database.windows.net",
        "DESTINATION_DB_NAME": "AutomationSuite_AICenter",
        "DESTINATION_PKGMANAGER_DB_SCHEMA": "ai_pkgmanager",
        "DESTINATION_TRAINER_DB_SCHEMA": "ai_trainer",
        "DESTINATION_DB_USERNAME": "test",
        "DESTINATION_DB_PASSWORD": "test",
        "TENANT_MAP": [
                {
                        "SRC_TENANT_ID": "d1eb428c-e188-46bf-a1dd-8908f90b4084",
                        "DESTINATION_TENANT_ID": "03527165-b242-4b98-834f-2eb3e5957223",
                        "DESTINATION_ACCOUNT_ID": "8cd64e27-12f4-427c-a575-dd4f2ea82551"
                }
        ]
}

SRC_TENANT_ID pode ser obtido seguindo as etapas abaixo:

1. Clique no logotipo da UiPath na página inicial do aplicativo do AI Center™.
2. Clique com o botão direito no navegador e acesse inspecionar. Depois que a janela de inspeção for aberta, verifique a aba de rede para chamadas de API de projetos. O ID do tenant pode ser exibido na seção de Visualização como na captura de tela abaixo.
   
   

   

   
   
3. Adicione o DNS do armazenamento de objetos da máquina do Automation Suite no máquina que executa o script. Isso pode ser encontrado na aba de extensão do pipeline a partir da qual o ambiente do Automation Suite foi criado.

   sudo bash -c "echo "LB_IP objectstore.DNS_NAME" >> /etc/hosts"

Etapa 5: executar o script de migração

Acesse a pasta na qual o sfmigration é baixado no diretório Usage: execute o seguinte comando:

cd ~/migration/ai-customer-scripts/platform/sfmigration/
 
 ./mastermigrationscript.sh input.json

Solução de problemas

Criando tenants

O tenant precisa ser criado no ambiente do Automation Suite antes de executar o script de migração.

Executando novamente a migração

O script de migração é feito para migrar conjuntos de dados e pacotes de ML apenas uma vez. Em raras ocasiões, existem alguns conjuntos de dados ou pacotes de ML extras adicionados ao ambiente de origem após a migração estar concluída, então, nesse caso, a migração precisa ser executada novamente. Execute os seguintes comandos no banco de dados de destino antes de executar a migração novamente:

delete from [ai_pkgmanager].[ml_package_versions_temp];
delete from [ai_pkgmanager].[projects] where tenant_id in ('T1','T2',...);
delete from [ai_pkgmanager].[ml_packages] where tenant_id in ('T1','T2',...);
delete from [ai_pkgmanager].[ml_package_versions] where tenant_id in ('T1','T2',...);
delete from [ai_trainer].[datasets] where tenant_id in ('T1','T2',...);

OBSERVAÇÃO: 'T1','T2',... na consulta acima são tenant UUIDs no ambiente de destino. Esses são o DESTINATION_TENANT_ID como mencionado no arquivo input.json passado ao executar o script de migração ./mastermigrationscript.sh input.json

Em seguida, você pode executar novamente a migração usando os seguintes comandos:

cd ~/migration/ai-customer-scripts/platform/sfmigration/
 
./mastermigrationscript.sh input.json

Pacotes clonados

Após a migração, Pacotes de ML clonados presentes no ambiente de origem serão marcados como VALIDATION_FAILED no ambiente do Automation Suite. Esses pacotes precisam ser clonados novamente no ambiente de destino depois que a migração for concluída.

Observação: nesse caso, os pacotes clonados referem-se aos pacotes da UiPath e Pacotes de código aberto.