Atualização das strings de conexão SQL

Existem vários cenários em que você pode querer atualizar a string de conexão usada pelos produtos Automation Suite para se conectar ao banco de dados SQL, como o seguinte:

• Ao alternar periodicamente a senha usada para se conectar ao banco de dados, para segurança e conformidade;
• Ao alterar o FQDN para o servidor SQL;
• Ao migrar o banco de dados para outro servidor SQL para fins de manutenção;
• Ao adicionar, modificar ou remover um ou mais atributos de conexão, como MultiSubnetFailover;
• Ao mudar de autenticação básica para autenticação integrada usando Kerberos e AD.
  Importante:

  Os produtos no Automation Suite não criam tabelas ou esquemas no momento da atualização da string de conexão do banco de dados SQL. Certifique-se de que sua nova string de conexão se refira ao mesmo banco de dados que você usa atualmente.

  Para evitar tempo de inatividade durante o processo de atualização, certifique-se de que sua string de conexão atual seja válida no momento do processo de atualização. Você pode revogar sua string de conexão antiga após a atualização.

Atualizando as strings de conexão para produtos instalados

Para atualizar a string de conexão para produtos instalados no Automation Suite, conecte-se a qualquer um dos nós do servidor e execute as seguintes operações.

1. Gere o arquivo cluster_config.json .
2. Forneça as novas strings de conexão para os produtos instalados.
3. Execute o instalador do serviço.

Etapa 1: Gerando o arquivo cluster_config.json

Gere o arquivo cluster_config.json mais recente da seguinte maneira:

• R: Se você tiver o antigo cluster_config.json, gere o arquivo de configuração do cluster usando o seguinte comando:

  cd /opt/UiPathAutomationSuite/{version}/installer
  
  ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json

• B: Se você não tiver o arquivo cluster_config.json antigo, gere uma substituição de quaisquer valores padrão resultantes durante a instalação da versão anterior usando o seguinte comando:

  cd /opt/UiPathAutomationSuite/{version}/installer
  
  ./configureUiPathAS.sh config get -o ./cluster_config.json

Observação: para obter detalhes sobre como configurar os parâmetros do cluster_config.json , consulte Experiência de instalação avançada.

Etapa 2: fornecer as novas strings de conexão para produtos instalados

Há duas maneiras de fornecer strings de conexão para produtos em execução no Automation Suite:

• R: Forneça um modelo de string de conexão que seja comum a todos os produtos em execução no Automation Suite. Essa abordagem assumirá os nomes de banco de dados padrão para todos os produtos.

• B: Fornece conexão de strings específica para cada produto.

Importante:

Certifique-se de escapar das senhas NET, JDBC ou ODBC da seguinte maneira:

• para NET: adicione ' no início e no final da senha e dobre qualquer outro '.

• para JDBC/ODBC: adicione { no início da senha e } no final, e duplique qualquer outro }.

Se você definir TrustServerCertificate=False, talvez seja necessário fornecer um certificado de CA adicional para o SQL Server. Isso é necessário se o certificado do SQL Server for autoassinado ou assinado por uma CA interna. Para obter detalhes, consulte Atualização dos certificados de CA.

R: Fornecimento de uma string de conexão comum para todos os produtos

Todos os produtos em execução no Automation Suite referem-se a uma string de conexão de modelo comum. Um caso de uso para escolher esse método seria quando você deseja alterar a senha de todos os produtos de uma só vez. Observe que, neste caso, a senha será a mesma para todos os produtos.

Nesses cenários, os nomes do banco de dados para todos os produtos devem ser os padrão, conforme exigido pelo Automation Suite. Se os nomes do banco de dados configurados não atenderem aos requisitos do Automation Suite, siga a próxima etapa.

Dica:

Confira a lista dos bancos de dados e seus nomes padrão:

• Avaliação de nó único: configuração do Microsoft SQL Server

• Produção pronta para alta disponibilidade de vários nós: configuração do Microsoft SQL Server

A tabela a seguir explica qual formato de modelo os serviços do produto aceitam:

Parâmetro	Description	Produtos
sql_connection_string_template	String de conexão completa do ADO.NET onde o nome do catálogo é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do pacote instalado.	Platform, Orchestrator, Test Manager, Automation Hub, Automation Ops, Insights, Task Mining, Data Service
sql_connection_string_template_jdbc	String de conexão completa do JDBC onde o nome da base de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do pacote instalado.	AI Center
sql_connection_string_template_odbc	String de conexão completa de ODBC onde o nome do banco de dados é definido como DB_NAME_PLACEHOLDER. O instalador substituirá esse espaço reservado pelos nomes de banco de dados padrão para os serviços do pacote instalado.	Document Understanding

Exemplo do sql_connection_string_template

Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net:1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=testadmin;Password=***;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;

Exemplo do sql_connection_string_template_jdbc

jdbc:sqlserver://sfdev1804627-c83f074b-sql.database.windows.net:1433;database=DB_NAME_PLACEHOLDER;user=testadmin;password=***;encrypt=true;trustServerCertificate=false;Connection Timeout=30;hostNameInCertificate=sfdev1804627-c83f074b-sql.database.windows.net"

Exemplo do sql_connection_string_template_odbc

SERVER=sfdev1804627-c83f074b-sql.database.windows.net,1433;DATABASE=DB_NAME_PLACEHOLDER;DRIVER={ODBC Driver 17 for SQL Server};UID=testadmin;PWD=***;MultipleActiveResultSets=False;Encrypt=YES;TrustServerCertificate=NO;Connection Timeout=30;"

Observação: atualize o cluster_config.json com o novo modelo de string de conexão que deseja atualizar.

B: Fornecimento de strings de conexão específicas para cada produto

Plataforma

O serviço de plataforma fornece recursos administrativos, como organização e gerenciamento de locatários, gerenciamento de licenciamento, gerenciamento de usuários, etc. O serviço de plataforma é ativado por padrão e não pode ser removido. Seu nome de banco de dados padrão é AutomationSuite_Platform.

Para fornecer uma string de conexão para o serviço Platform, adicione ou atualize a seguinte seção no arquivo cluster_config.json :

"platform": {
  "sql_connection_str": "***" // dotnet connection string 
}

Orchestrator

O nome do banco de dados padrão para Orchestrator é AutomationSuite_Orchestrator.

Para fornecer um string de conexão para o serviço do Orchestrator, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"orchestrator": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Hub

O nome do banco de dados padrão para o Automation Hub é AutomationSuite_Automation_Hub.

Para fornecer um string de conexão para o serviço do Automation Suite, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"automation_hub": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Ops

O nome padrão de banco de dados para o Automation Ops é AutomationSuite_Platform.

Para fornecer um string de conexão para o serviço do Automation Ops, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"automation_ops": {
  "sql_connection_str": "***" // dotnet connection string
}

AI Center

O nome padrão para o banco de dados do AI Center é AutomationSuite_AICenter.

Para fornecer um string de conexão para o serviço do AI Center, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"aicenter": {
  "sql_connection_str": "***" // jdbc connection string
}

Data Service

O nome padrão para o banco de dados do Data Service é AutomationSuite_DataService.

Para fornecer um string de conexão para o serviço do Data Service, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"dataservice": {
  "sql_connection_str": "***" // dotnet connection string
}

Document Understanding

O nome do banco de dados padrão para Document Understanding é AutomationSuite_DU_Datamanager.

Para fornecer um string de conexão para o serviço do Document Understanding, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"documentunderstanding": {
  "datamanager": {
    "sql_connection_str": "***" // odbc connection string
  }
}

Insights

O nome padrão para o banco de dados do Insights é AutomationSuite_Insights.

Para fornecer um string de conexão para o serviço do Insights, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"insights": {
  "sql_connection_str": "***" // dotnet connection string
}

Task Mining

O nome padrão para o banco de dados do Task Mining éAutomationSuite_Task_Mining.

Para fornecer um string de conexão para o serviço do Task Mining, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"task_mining": {
  "sql_connection_str": "***" // dotnet connection string
}

Test Manager

O nome padrão para o banco de dados do Test Manager é AutomationSuite_Test_Manager .

Para fornecer um string de conexão para o serviço do Test Manager, adicione ou atualize a seguinte seção no arquivo cluster_config.json:

"test_manager": {
  "sql_connection_str": "***" // dotnet connection string
}

Etapa 3: Executando o instalador do serviço

Online

Para executar o instalador do serviço em um ambiente online, use o seguinte comando:

cd /opt/UiPathAutomationSuite/{version}/installer

./install-uipath.sh -i ./cluster_config.json -s -o output.json --accept-license-agreement

Offline

Para executar o instalador de serviço em um ambiente offline, use o comando a seguir:

cd /opt/UiPathAutomationSuite/{version}/installer

./install-uipath.sh -i ./cluster_config.json -s --install-type offline -o output.json --accept-license-agreement

Etapa 4: reiniciando os pods para o Test Manager e o Document Understanding

Observação:

Essa etapa é necessária apenas se você tiver modificado as strings de conexão SQL para o Test Manager ou Document Understanding.

1. Obtenha a lista de todos os pods do Test Manager/Document Understanding:

   // for Test Manager
   kubectl get pods -A | grep testmanager | awk '{print $2}'
   
   //for Document Understanding
   kubectl get pods -A | grep du-datamanager | awk '{print $2}'

2. Exclua todos os pods listados. Isso força os pods a reiniciarem com a string de conexão SQL correta.

   kubectl delete pods <pod name>