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

Observação: uma atualização clássica para o AI Center 2021.10 não está disponível. Em vez disso, você precisa instalar o AI Center™ independente 2021.10 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, o AI Center independente ou o ambiente do Automation Suite.

Visão geral

Use esse procedimento para migrar de 2021.4 ou 2020.10 para 2021.10. 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.