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 :

Pour plus de détails sur la configuration des paramètres du fichier cluster_config.json , consultez la section Expérience d’installation avancée.

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 '.
• pour JDBC/ODBC : ajoutez { au début du mot de passe et } à la fin, et doublez tout autre }. Ne doublez pas {.

Si vous définissez TrustServerCertificate=False, vous devrez peut-être fournir un certificat CA supplémentaire pour SQL Server. Ceci est requis si le certificat SQL Server est auto-signé ou signé par une autorité de certification interne. Pour plus de détails, consultez la section Mise à jour des certificats CA.

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 ces scénarios, les noms de base de données pour tous les produits doivent être ceux par défaut, tels que 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 :

• Évaluation à nœud unique : configuration de Microsoft SQL Server
• Mode de production multi-nœuds compatible haute disponibilité : configuration de 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.	Plate-forme 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
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.	Document Understanding Apps
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.	Document Understanding Process Mining
postgresql_connection_string_template_sqlalchemy_pyodbc	Chaîne de connexion SQL alchemy PsyCoPG2 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 (2023.10.9 ou version supérieure)

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:<password>@sfdev4515230-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

exemple postgresql_connection_string_template_sqlalchemy_pyodbc (Process Mining 2023.10.9 ou version plus récente)

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

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
 "pyodbc_sql_connection_str": "***" // python sql 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 :

Pour 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": ""
    }
}

Pour 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

Le nom de la base de données par défaut pour Task Mining est AutomationSuite_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

Afin d’exécuter le programme d’installation des services, utilisez la commande suivante :

cd /opt/UiPathAutomationSuite/{version}/installer

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