Procedimento

Para obter uma visão geral do procedimento, confira as etapas abaixo. Cada uma delas está detalhada nas páginas a seguir.

1. Crie um tenant com o mesmo nome no Automation Suite ou no novo ambiente do AI Center.
2. Gere o arquivo storage-cred.json na primeira máquina (também chamada de Máquina de origem).
3. Gere o arquivo storage-creds.json na segunda máquina.
4. Configure a máquina que está executando o script.
5. Execute o script de migração.

Etapa 1

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

Etapa 2

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

   Se estiver executando em uma terceira máquina, certifique-se de executar o seguinte comando:

   ./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}

   Se a mensagem de erro abaixo for exibida após executar o script acima, execute o comando bash -1 e tente executar o script acima novamente.

   

O arquivo gerado (storage-creds.json) será usado nas próximas etapas. Certifique-se de copiar e salvar o conteúdo do arquivo localmente.

Etapa 3

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 (storage-creds-sf.json) será usado nas próximas etapas. Certifique-se de copiar e salvar o conteúdo do arquivo localmente.

Etapa 4

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 fará o download do script de um repositório git público:

   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 TARGE_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/

5. Substitua os detalhes no arquivo input.json.Para facilitar a consulta, as credenciais são marcadas como TO-BE-REPLACED no arquivo input.json.

O arquivo JSON de amostra com a 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
}
]

Como referência, aqui está um arquivo input.json de exemplo preenchido com valores de exemplo:

{
        "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"
                }
        ]
}

Observação: SRC_TENANT_ID pode ser obtido seguindo os passos abaixo:

• Clique no logotipo UiPath na página inicial do aplicativo AI Center.
• 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. A ID do tenant pode ser vista na seção Visualização.
• 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

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

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