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 rotacionar periodicamente a senha usada para se conectar ao banco de dados, por segurança e conformidade
• Ao alterar o FQDN para o SQL Server
• Ao migrar o banco de dados para outro SQL Server para fins de manutenção
• Ao adicionar, modificar ou remover um ou mais atributos de conexão, como MultiSubnetFailover
• Ao alternar da autenticação básica para a autenticação integrada usando o Kerberos e o 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. Se você usar a configuração de política de limite de bloqueio de conta, habilite o modo de manutenção.
2. Gere o arquivo cluster_config.json .
3. Forneça as novas strings de conexão para os produtos instalados no cluster_config.json.
4. Execute o instalador do serviço.
5. Se você usar a configuração de política de limite de bloqueio de conta, desabilite o modo de manutenção.

Geração do arquivo cluster_config.json

Gere o arquivo cluster_config.json mais recente usando o seguinte comando:

./bin/uipathctl manifest get-revision > ./cluster_config.json

Observação:

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

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 duplique qualquer outro '.
• para JDBC/ODBC: adicione { no início da senha e } no final, e duplique qualquer outro }. Não duplique {.

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 Atualizar os certificados de CA.

Para codificar ou decodificar strings Base64 usando o PowerShell, você pode usar os seguintes comandos:

• decodificar string Base64: [System.Text.Encoding]::Default.GetString([System.Convert]::FromBase64String('<base64_string>'))
• codificar string Base64: [System.Convert]::ToBase64String([System.Text.Encoding]::Default.GetBytes('<plain_text>'))

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

All the products running in Automation Suite refer to a common template connection string. One use case for choosing this method would be when you want to change the password for all the products at once. Note that, in this case, the password will be the same for all the products.

Nesses cenários, os nomes de bancos de dados para todos os produtos devem ser os padrão, conforme exigido pelo Automation Suite. Se os nomes dos bancos de dados que você configurou 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 da suíte instalada.	Plataforma Orchestrator Automation Suite Robots Test Manager Automation Hub Automation Ops Insights Task Mining Data Service Process Mining
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 da suíte instalada.	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 da suíte instalada.	Document Understanding Apps
sql_connection_string_template_sqlalchemy_pyodbc	String de conexão SQL alchemy PYODBC completa em que 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 Process Mining
postgresql_connection_string_template_sqlalchemy_pyodbc	String de conexão SQL alchemy PSYCOPG2 completa na qual 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.	Process Mining (2023.10.9 ou superior)

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;"

Exemplo do sql_connection_string_template_sqlalchemy_pyodbc

"mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:<password>@sfdev4515230-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

Exemplo: postgresql_connection_string_template_sqlalchemy_pyodbc (Process Mining 2023.10.9 ou superior)

"postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/DB_NAME_PLACEHOLDER"

Observação:

Update the cluster_config.json with the new connection string template you want to update.

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 Suite Robots

Automation Suite Robots and Orchestrator share the same database by default. The database name is AutomationSuite_Orchestrator.

To provide a connection string for Automation Suite Robots, add or update the following section in the cluster_config.json file:

"asrobots": {
  "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
}

Importante:

Para habilitar o FIPS 140-2 na máquina em que o AI Center está instalado, você deve acrescentar a sql_connection_string_template_jdbc o seguinte: encrypt=true;trustServerCertificate=false;fips=true;

Apps

O nome padrão para o banco de dados do Apps é AutomationSuite_Apps.

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

"apps": {
  "sql_connection_str": "***" // odbc 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": { 
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
 "sql_connection_str": "***" // odbc connection string
 "pyodbc_sql_connection_str": "***" // python sql 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
}

Process Mining

The default database name for Process Mining is AutomationSuite_ProcessMining_Metadata.

To provide a connection string for the Process Mining service, add or update the following section in the cluster_config.json file:

Para o PostgreSQL:

"process_mining": {
    "enabled": true,
    "sql_connection_str": "***", // dotnet connection string
    "airflow": {
        "metadata_db_connection_str": ""
    },
    "warehouse": {
        "sql_connection_str": "",
        "master_sql_connection_str": "",
        "sqlalchemy_pyodbc_sql_connection_str": ""
    }
}

Para o Microsoft SQL Server:

"process_mining": {
  "enabled": true,
  "sql_connection_str": "***" // dotnet connection string
  "sqlalchemy_pyodbc_sql_connection_str": "", 
  "warehouse": {
     "sql_connection_str": "",
     "master_sql_connection_str": "",
     "sqlalchemy_pyodbc_sql_connection_str": ""
  }
}

Task Mining

The default database name for Task Mining is 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
}

Execução do instalador de serviço

Para executar o instalador de serviço, use o seguinte comando:

cd /opt/UiPathAutomationSuite/{version}/installer

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