Aktualisieren der SQL-Verbindungszeichenfolgen

Es gibt mehrere Szenarien, in denen Sie die Verbindungszeichenfolge aktualisieren möchten, die von Automation Suite-Produkten verwendet wird, um eine Verbindung mit der SQL-Datenbank herzustellen, z. B. die folgenden:

• Beim regelmäßigen Rotieren des Kennworts, das zum Herstellen einer Verbindung mit der Datenbank verwendet wird, für Sicherheit und Compliance

• Beim Ändern des FQDN für den SQL-Server

• Beim Migrieren der Datenbank auf einen anderen SQL-Server zu Wartungszwecken

• Beim Hinzufügen, Ändern oder Entfernen eines oder mehrerer Verbindungsattribute, z. B. MultiSubnetFailover

• Beim Wechsel von der einfachen Authentifizierung zur integrierten Authentifizierung mit Kerberos und AD

  Wichtig:

  Produkte in der Automation Suite erstellen zum Zeitpunkt der Aktualisierung der SQL-Datenbankverbindungszeichenfolge keine Tabellen oder Schemata. Stellen Sie sicher, dass sich Ihre neue Verbindungszeichenfolge auf dieselbe Datenbank bezieht, die Sie derzeit verwenden.

  Um Ausfallzeiten während des Aktualisierungsprozesses zu vermeiden, stellen Sie sicher, dass Ihre aktuelle Verbindungszeichenfolge zum Zeitpunkt des Aktualisierungsprozesses gültig ist. Sie können Ihre alte Verbindungszeichenfolge nach der Aktualisierung widerrufen.

Aktualisieren der Verbindungszeichenfolgen für installierte Produkte

Um die Verbindungszeichenfolge für installierte Produkte in der Automation Suite zu aktualisieren, stellen Sie eine Verbindung mit einem der Serverknoten her und führen Sie die folgenden Vorgänge aus.

1. Generieren Sie die cluster_config.json -Datei.
2. Geben Sie die neuen Verbindungszeichenfolgen für die installierten Produkte an.
3. Führen Sie das Dienstinstallationsprogramm aus.

Schritt 1: Generieren der Datei „cluster_config.json“

Generieren Sie die neueste Datei „cluster_config.json“ wie folgt:

• A: Wenn Sie das alte cluster_config.jsonhaben, generieren Sie die Konfigurationsdatei aus dem Cluster mit dem folgenden Befehl:

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

• B: Wenn Sie nicht über die alte cluster_config.json -Datei verfügen, generieren Sie mit dem folgenden Befehl eine Überschreibung aller Standardwerte, die während der Installation der vorherigen Version entstanden sind:

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

Hinweis:

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

Schritt 2: Bereitstellen der neuen Verbindungszeichenfolgen für installierte Produkte

Es gibt zwei Möglichkeiten, die Verbindungszeichenfolgen für Produkte bereitzustellen, die in der Automation Suite ausgeführt werden:

• A: Stellen Sie eine Verbindungszeichenfolge-Vorlage bereit, die für alle Produkte gilt, die in der Automation Suite ausgeführt werden. Bei diesem Ansatz werden die Standarddatenbanknamen für alle Produkte angenommen.
• B: Geben Sie Verbindungszeichenfolgen an, die für jedes Produkt spezifisch sind.

Wichtig:

Stellen Sie sicher, dass Sie NET-, JDBC- oder ODBC-Kennwörter wie folgt maskieren:

• Für NET: Fügen Sie ' am Anfang und Ende des Kennworts hinzu und verdoppeln Sie alle anderen '.
• 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.

A: Bereitstellung einer gemeinsamen Verbindungszeichenfolge für alle Produkte

Alle Produkte, die in der Automation Suite ausgeführt werden, verweisen auf eine gemeinsame Vorlagenverbindungszeichenfolge. Ein Anwendungsfall für die Auswahl dieser Methode wäre, wenn Sie das Kennwort für alle Produkte gleichzeitig ändern möchten. Beachten Sie, dass das Kennwort in diesem Fall für alle Produkte gleich ist.

In diesen Szenarien müssen die Datenbanknamen für alle Produkte die Standardnamen sein, wie von der Automation Suite gefordert. Wenn die von Ihnen konfigurierten Datenbanknamen die Anforderungen der Automation Suite nicht erfüllen, führen Sie den nächsten Schritt aus.

Tipp:

Überprüfen Sie die Liste der Datenbanken und ihrer Standardnamen:

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

In der folgenden Tabelle wird erläutert, welches Vorlagenformat die Produktdienste akzeptieren:

Parameter	Beschreibung	Produkte
sql_connection_string_template	Vollständige ADO.NET-Verbindungszeichenfolge, in der der Katalogname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Plattform, Orchestrator, Test Manager, Automation Hub, Automation Ops, Insights, Task Mining, Data Service
sql_connection_string_template_jdbc	Vollständige JDBC-Verbindungszeichenfolge, in der der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	AI Center
sql_connection_string_template_odbc	Vollständige ODBC-Verbindungszeichenfolge, bei der der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Document Understanding

Beispiel: 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;

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

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

Hinweis:

Aktualisieren Sie cluster_config.json mit der neuen Verbindungszeichenfolgenvorlage, die Sie aktualisieren möchten.

B: Bereitstellung von Verbindungszeichenfolgen für jedes Produkt

Plattform

Der Plattformdienst bietet Verwaltungsfunktionen wie Organisations- und Mandantenverwaltung, Lizenzverwaltung, Benutzerverwaltung usw. Der Plattformdienst ist standardmäßig aktiviert und kann nicht entfernt werden. Der Standarddatenbankname ist AutomationSuite_Platform .

Um eine Verbindungszeichenfolge für den Plattformdienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Orchestrator

Der Standarddatenbankname für Orchestrator ist AutomationSuite_Orchestrator .

Um eine Verbindungszeichenfolge für den Orchestrator-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Automation Hub

Der Standarddatenbankname für Automation Hub ist AutomationSuite_Automation_Hub .

Um eine Verbindungszeichenfolge für den Automation Suite-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Automation Ops

Der Standarddatenbankname für Automation Ops ist AutomationSuite_Platform .

Um eine Verbindungszeichenfolge für den Automation Ops-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

AI Center

Der Standarddatenbankname für AI Center ist AutomationSuite_AICenter .

Um eine Verbindungszeichenfolge für den AI Center-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Data Service

Der Standarddatenbankname für Data Service ist AutomationSuite_DataService .

Um eine Verbindungszeichenfolge für den Data Service-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Document Understanding

Der Standarddatenbankname für Document Understanding ist AutomationSuite_DU_Datamanager .

Um eine Verbindungszeichenfolge für den Document Understanding-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Insights

Der Standarddatenbankname für Insights ist AutomationSuite_Insights .

Um eine Verbindungszeichenfolge für den Insights-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Task Mining

Der Standarddatenbankname für Task Mining istAutomationSuite_Task_Mining.

Um eine Verbindungszeichenfolge für den Task Mining-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Test Manager

Der Standarddatenbankname für Test Manager ist AutomationSuite_Test_Manager.

Um eine Verbindungszeichenfolge für den Test Manager-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json hinzu oder aktualisieren Sie ihn:

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

Schritt 3: Ausführen des Dienstinstallationsprogramms

Online

Um das Dienstinstallationsprogramm in einer Onlineumgebung auszuführen, verwenden Sie den folgenden Befehl:

cd /opt/UiPathAutomationSuite/{version}/installer

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

Offline

Um das Dienstinstallationsprogramm in einer Offlineumgebung auszuführen, verwenden Sie den folgenden Befehl:

cd /opt/UiPathAutomationSuite/{version}/installer

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

Schritt 4: Neustarten der Pods für den Test Manager und Document Understanding

Hinweis:

Dieser Schritt ist nur erforderlich, wenn Sie die SQL-Verbindungszeichenfolgen für Test Manager oder Document Understanding geändert haben.

1. Rufen Sie die Liste aller Test Manager-/Document Understanding- Pods ab:

   // 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. Löschen Sie alle aufgelisteten Pods. Dadurch wird erzwungen, dass die Pods mit der richtigen SQL-Verbindungszeichenfolge neu gestartet werden.

   kubectl delete pods <pod name>