- Notas de Versão
- Antes de começar
- Introdução
- Instalação do Automation Suite
- Migração e atualização
- Migração para o ambiente autônomo ou do Automation Suite
- Projetos
- Conjuntos de dados
- Pacotes de ML
- Pipelines
- Habilidades de ML
- Logs de ML
- Document Understanding no AI Center
- Licenciamento
- Como fazer
- Guia básico de solução de problemas
Migração para o ambiente autônomo ou do Automation Suite
Para atualizar do AI Center versão 2021.10, siga os procedimentos descritos na página Atualizar o AI Center.
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.
Certifique-se de que o AI Center esteja em execução 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
sudo susudo apt install -y jq awscli s3cmd zip gitsudo apt --fix-broken installsudo apt install -y jq awscli s3cmd zip
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
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.
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.
- Conecte-se usando SSH à máquina que você deseja migrar.
- 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
wget https://raw.githubusercontent.com/UiPath/ai-customer-scripts/stable/platform/sfmigration/storagemigration/get-credentials.sh chmod 777 get-credentials.sh ./get-credentials.sh
./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}
./get-credentials.sh {PUBLIC_IP_REPLICATED_MACHINE}
bash -l
e tente executar o script acima novamente
storage-creds.json
) será usado em outras etapas. Certifique-se de copiar e salvar o conteúdo do arquivo localmente.
Essa etapa precisa ser executada na segunda máquina, aquela em execução no ambiente do Automation Suite.
- Abra a porta 22 na máquina do Automation Suite.
- Conecte-se usando SSH à máquina do Automation Suite.
- Execute o comando abaixo:
sudo su export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin
sudo su export KUBECONFIG=/etc/rancher/rke2/rke2.yaml PATH=$PATH:/var/lib/rancher/rke2/bin - 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
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
storage-creds-sf.json
) será usado em outras etapas. Certifique-se de copiar e salvar o conteúdo do arquivo localmente.
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.
- 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/
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/ - Substitua o conteúdo no arquivo
SOURCE_CREDENTIAL_FILE
pelo conteúdo destorage-creds.json
(consulte Etapa 2). - Substitua o conteúdo no arquivo
TARGET_CREDENTIAL_FILE
pelo conteúdo destorage-creds-sf.json
(consulte Etapa 3). - Acesse o diretório base executando o seguinte comando:
cd ~/migration/ai-customer-scripts/platform/sfmigration/
cd ~/migration/ai-customer-scripts/platform/sfmigration/
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
}
]
{
"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
}
]
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"
}
]
}
{
"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"
}
]
}
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_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:
- Clique no logotipo da UiPath na página inicial do aplicativo do 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. O ID do tenant pode ser exibido na seção de Visualização como na captura de tela abaixo.
- 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"
sudo bash -c "echo "LB_IP objectstore.DNS_NAME" >> /etc/hosts"
sfmigration
é baixado no diretório Usage: execute o seguinte comando:
cd ~/migration/ai-customer-scripts/platform/sfmigration/
./mastermigrationscript.sh input.json
cd ~/migration/ai-customer-scripts/platform/sfmigration/
./mastermigrationscript.sh input.json
O tenant precisa ser criado no ambiente do Automation Suite antes de executar o script de 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',...);
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',...);
'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
cd ~/migration/ai-customer-scripts/platform/sfmigration/
./mastermigrationscript.sh input.json
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.
- Visão geral
- Pré-requisitos
- Procedimento
- Step 1: Create a tenant with the same name in the Automation Suite or new AI Center environment
- Etapa 2: gerar o arquivo Storage-creds.json na primeira máquina (também chamada de máquina de origem)
- Etapa 3: gerar o arquivo Storage-creds.json na segunda máquina
- Etapa 4: configurar máquina executando o script
- Etapa 5: executar o script de migração
- Solução de problemas
- Criando tenants
- Executando novamente a migração
- Pacotes clonados