Mise à jour des chaînes de connexion SQL

Il existe plusieurs scénarios dans lesquels vous souhaiterez peut-être mettre à jour la chaîne de connexion utilisée par les produits Automation Suite pour se connecter à la base de données SQL, tels que les suivants :

• Lors de la rotation périodique du mot de passe utilisé pour se connecter à la base de données, à des fins de sécurité et de conformité

• Lors de la modification du nom de domaine complet du serveur SQL

• Lors de la migration de la base de données vers un autre serveur SQL à des fins de maintenance

• Lors de l'ajout, de la modification ou de la suppression d'un ou plusieurs attributs de connexion, tels que MultiSubnetFailover

• Lorsque vous passez de l'authentification de base à l'authentification intégrée à l'aide de Kerberos et AD

  Important :

  Les produits d'Automation Suite ne créent pas de tables ou de schémas au moment de la mise à jour de la chaîne de connexion à la base de données SQL. Assurez-vous que votre nouvelle chaîne de connexion fait référence à la même base de données que vous utilisez actuellement.

  Pour éviter les temps d'arrêt pendant le processus de mise à jour, assurez-vous que votre chaîne de connexion actuelle est valide au moment du processus de mise à jour. Vous pouvez révoquer votre ancienne chaîne de connexion après la mise à jour.

Mise à jour des chaînes de connexion des produits installés

Pour mettre à jour la chaîne de connexion des produits installés dans Automation Suite, connectez-vous à l'un des nœuds du serveur et effectuez les opérations suivantes.

1. Si vous utilisez le paramètre de stratégie Seuil de verrouillage du compte (Account lockout threshold), activez le mode maintenance.
2. Générez le fichier cluster_config.json .
3. Fournissez les nouvelles chaînes de connexion pour les produits installés dans le cluster_config.json.
4. Exécutez le programme d'installation du service.
5. Si vous utilisez le paramètre de stratégie Seuil de verrouillage du compte (Account lockout threshold), désactivez le mode maintenance.

Génération du fichier cluster_config.json

Générez le dernier fichier cluster_config.json à l’aide de la commande suivante :

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

Remarque :

For details on how to configure the cluster_config.json parameters, see Advanced installation experience.

Fournir les nouvelles chaînes de connexion pour les produits installés

Il existe deux façons de fournir les chaînes de connexion pour les produits s'exécutant dans Automation Suite :

• R : Fournissez un modèle de chaîne de connexion qui sera commun à tous les produits exécutés dans Automation Suite. Cette approche supposera les noms de base de données par défaut pour tous les produits.
• B : fournissez des chaînes de connexion spécifiques à chaque produit.

Important :

Assurez-vous d'échapper aux mots de passe NET, JDBC ou ODBC comme suit :

• pour NET : ajoutez ' au début et à la fin du mot de passe, puis doublez tout autre '.
• for JDBC/ODBC: add { at the beginning of the password and } at the end, and double any other }.

If you set TrustServerCertificate=False, then you may have to provide an additional CA certificate for the SQL Server. This is required if the SQL Server certificate is self-signed or signed by an internal CA. For details, see Updating the CA certificates.

Pour encoder ou décoder des chaînes Base64 à l'aide de PowerShell, vous pouvez utiliser les commandes suivantes :

• décoder la chaîne Base64 : [System.Text.Encoding]::Default.GetString([System.Convert]::FromBase64String('<base64_string>'))
• encoder la chaîne Base64 : [System.Convert]::ToBase64String([System.Text.Encoding]::Default.GetBytes('<plain_text>'))

A : Fournir une chaîne de connexion commune pour tous les produits

Tous les produits exécutés dans Automation Suite font référence à un modèle de chaîne de connexion commun. Un cas d'utilisation pour choisir cette méthode serait lorsque vous souhaitez modifier le mot de passe pour tous les produits à la fois. Notez que, dans ce cas, le mot de passe sera le même pour tous les produits.

Dans ce scénario, les noms de base de données de tous les produits doivent être ceux par défaut, comme requis par Automation Suite. Si les noms de base de données que vous avez configurés ne répondent pas aux exigences d'Automation Suite, passez à l'étape suivante.

Astuce :

Consultez la liste des bases de données et leurs noms par défaut :

• Single-node evaluation: Configuring Microsoft SQL server
• Multi-node HA-ready production: Configuring Microsoft SQL Server

Le tableau suivant explique le format de modèle accepté par les services produit :

Paramètre	Description	Produits
sql_connection_string_template	Chaîne de connexion ADO.NET complète où le nom du catalogue est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Platform, Orchestrator, Robots Automation Suite, Test Manager, Automation Hub, Automation Ops, Insights, Task Mining, Data Service, Process Mining
sql_connection_string_template_jdbc	Chaîne de connexion JDBC complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	AI Center 1
sql_connection_string_template_odbc	Chaîne de connexion ODBC complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Apps Document Understanding
sql_connection_string_template_sqlalchemy_pyodbc	Chaîne de connexion PYODBC alchemy SQL complète où le nom de la base de données est défini sur DB_NAME_PLACEHOLDER. Le programme d'installation remplacera cet espace réservé par les noms de base de données par défaut pour les services de la suite installée.	Process Mining

¹ To enable FIPS 140-2 on the machine on which AI Center is installed, you must append the following to sql_connection_string_template_jdbc: encrypt=true;trustServerCertificate=false;fips=true;.

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

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

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

sql_connection_string_template_sqlalchemy_pyodbc example

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

Remarque :

Mettez à jour le cluster_config.json avec le nouveau modèle de chaîne de connexion que vous souhaitez mettre à jour.

B : Fournir des chaînes de connexion spécifiques à chaque produit

Plate-forme

Le service Platform fournit des capacités administratives telles que la gestion de l'organisation et des locataires, la gestion des licences, la gestion des utilisateurs, etc. Le service Platform est activé par défaut et ne peut pas être supprimé. Son nom de base de données par défaut est AutomationSuite_Platform .

Pour fournir une chaîne de connexion au service Platform, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Orchestrator

Le nom de base de données par défaut pour Orchestrator est AutomationSuite_Orchestrator .

Pour fournir une chaîne de connexion au service Orchestrator, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Robots Automation Suite

Les Robots Automation Suite et Orchestrator partagent la même base de données par défaut. Le nom de la base de données est AutomationSuite_Orchestrator .

Pour fournir une chaîne de connexion aux Robots Automation Suite, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Automation Hub

Le nom de la base de données par défaut pour Automation Hub est AutomationSuite_Automation_Hub .

Pour fournir une chaîne de connexion au service Automation Suite, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Automation Ops

Le nom de la base de données par défaut pour Automation Ops est AutomationSuite_Platform .

Pour fournir une chaîne de connexion au service Automation Ops, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

AI Center

Le nom de la base de données par défaut pour AI Center est AutomationSuite_AICenter .

Pour fournir une chaîne de connexion au service AI Center, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Important :

Pour activer FIPS 140-2 sur la machine sur laquelle AI Center est installé, vous devez ajouter ce qui suit à sql_connection_string_template_jdbc :

encrypt=true;trustServerCertificate=false;fips=true;

Apps

Le nom de base de données par défaut pour Apps est AutomationSuite_Apps.

Pour fournir une chaîne de connexion au service Apps, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

"apps": {
  "sql_connection_str": "***" // odbc connection string
}

Data Service

Le nom de base de données par défaut pour Data Service est AutomationSuite_DataService .

Pour fournir une chaîne de connexion au service Data Service, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Document Understanding

Le nom de base de données par défaut pour Document Understanding est AutomationSuite_DU_Datamanager .

Pour fournir une chaîne de connexion au service Document Understanding, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

"documentunderstanding": {
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
 "sql_connection_str": "***" // odbc connection string
 }
}

Insights

Le nom de la base de données par défaut pour Insights est AutomationSuite_Insights .

Pour fournir une chaîne de connexion au service Insights, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Process Mining

Le nom de la base de données par défaut pour Process Mining est AutomationSuite_ProcessMining_Metadata .

Pour fournir une chaîne de connexion au service Process Mining, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

"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

Le nom de la base de données par défaut pour Task Mining estAutomationSuite_Task_Mining.

Pour fournir une chaîne de connexion au service Task Mining, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Test Manager

Le nom de base de données par défaut de Test Manager est AutomationSuite_Test_Manager .

Pour fournir une chaîne de connexion au service Test Manager, ajoutez ou mettez à jour la section suivante dans le fichier cluster_config.json :

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

Exécution du programme d'installation du service

En ligne

Pour exécuter le programme d'installation du service dans un environnement en ligne, utilisez la commande suivante :

cd /opt/UiPathAutomationSuite/{version}/installer

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

Hors ligne

Pour exécuter le programme d'installation du service dans un environnement hors ligne, utilisez la commande suivante :

cd /opt/UiPathAutomationSuite/{version}/installer

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