Atualizando Credenciais

Diretrizes

Para atualizar credenciais para os diferentes componentes do Automation Suite , execute as seguintes etapas:

1. Gere o arquivo input.json .
2. Forneça as novas credenciais para os componentes fornecidos no input.json conforme descrito em cada seção do componente (SQL, Redis e Object Store).
3. Execute a CLI uipathctl conforme descrito em cada seção do componente (SQL, Redis e Armazenamento de Objetos)..

Geração do arquivo input.json

Generate the latest input.json file as follows:

• A: Execute o seguinte comando para obter a revisão mais recente do seu arquivo input.json :

  uipathctl manifest get-revision

• B: Execute o comando a seguir para listar todos os arquivos input.json anteriores e determine qual você deseja escolher:

  uipathctl manifest list-revisions

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 input.json .
2. Forneça as novas strings de conexão para os produtos instalados no arquivo input.json.
3. Execute uipathctl.

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: Verifique a lista de bancos de dados e seus nomes padrão no Banco de dados SQL.

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.	Platform, 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 da suíte instalada. Exemplo: "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:07%3Cl%5Bxj-%3D~[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"	Process Mining

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:07%3Cl%5Bxj-%3D~[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

Observação: atualize o input.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 input.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 input.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 input.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 input.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 input.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 input.json:

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

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 input.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 input.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 input.json:

"documentunderstanding": { 
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"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 input.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 input.json file:

"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

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 input.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 input.json:

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

Execução do instalador de 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

Atualização de credenciais do Redis

Fornecimento das novas credenciais para o Redis

Atualize a seguinte seção no arquivo input.json com a nova senha e/ou nome de host:

"fabric": {
  "redis": {
    "hostname": "new_hostname",
    "password": "new_password",
    "port": 6380,
    "tls": true
  }

Execução do instalador do uipathctl

Para concluir a atualização das credenciais do Redis, execute o instalador uipathctl usando o seguinte comando:

uipathctl manifest apply input.json --only redis --versions versions.json

Observação:

Você pode usar o sinalizador de simulação com uipathctl para imprimir o resultado do comando sem aplicá-lo.

Atualização de credenciais da objectstore

Atualize a seguinte seção no arquivo input.json com o novo acesso_chave_chave_segredo ou chave_conta e nome_conta:

"external_object_storage": {
  "enabled": false, // <true/false>
  "create_bucket": true, // <true/false>
  "storage_type": "s3", // <s3,azure,aws>
  "fqdn": "",  // <needed in case of aws non instance profile>
  "port": 443, // <needed in case of aws non instance profile>
  "region": "", 
  "access_key": "", // <needed in case of aws non instance profile>
  "secret_key": "", // <needed in case of aws non instance profile>
  "use_managed_identity": false, // <true/false>
  "bucket_name_prefix": "",
  "bucket_name_suffix": "",
  "account_key": "", // <needed only when using non managed identity>
  "account_name": "",
  "azure_fqdn_suffix": "core.windows.net",
  "client_id": "" // <optional field in case of managed identity>
},

Execução do instalador do uipathctl

Para concluir a atualização das credenciais do armazenamento de objetos, execute o instalador uipathctl usando o seguinte comando:

uipathctl manifest apply input.json --versions versions.json

Observação:

Você pode usar o sinalizador de simulação com uipathctl para imprimir o resultado do comando sem aplicá-lo.