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. Wenn Sie die Einstellung der Schwellenwerte für die Kontosperrung verwenden, aktivieren Sie den Wartungsmodus.
2. Generieren Sie die cluster_config.json-Datei.
3. Geben Sie die neuen Verbindungszeichenfolgen für die installierten Produkte in cluster_config.json an.
4. Führen Sie das Installationsprogramm aus.
5. Wenn Sie die Einstellung der Schwellenwerte für die Kontosperrung verwenden, deaktivieren Sie den Wartungsmodus.

Generieren der cluster_config.json-Datei

Generieren Sie die neueste cluster_config.json-Datei mit dem folgenden Befehl:

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

Hinweis: Weitere Informationen zum Konfigurieren der cluster_config.json- Parameter finden Sie unter Erweiterte Installation.

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 '.
• Für JDBC/ODBC: Fügen Sie { am Anfang des Kennworts und } am Ende hinzu und verdoppeln Sie alle anderen }. Verdoppeln Sie nicht {.

Wenn Sie TrustServerCertificate=False festlegen, müssen Sie möglicherweise ein zusätzliches Zertifizierungsstellenzertifikat für den SQL-Server bereitstellen. Dies ist erforderlich, wenn das SQL Server-Zertifikat selbstsigniert oder von einer internen Zertifizierungsstelle signiert wurde. Weitere Details finden Sie unter Aktualisieren der Zertifikate von Zertifizierungsstellen.

Um Base64-Strings mit PowerShell zu codieren oder zu decodieren, können Sie die folgenden Befehle verwenden:

• Base64-String decodieren: [System.Text.Encoding]::Default.GetString([System.Convert]::FromBase64String('<base64_string>'))
• Base64-Zeichenfolge codieren: [System.Convert]::ToBase64String([System.Text.Encoding]::Default.GetBytes('<plain_text>'))

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:

• Auswertung mit einem einzelnen Knoten: Konfigurieren von Microsoft SQL-Servern

• HA-fähige Produktion mit mehreren Knoten: Konfigurieren von Microsoft SQL-Servern

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, Automation Suite Robots, Test Manager, Automation Hub, Automation Ops, Insights, Data Service, Process Mining, ECS, LLM-Gateway, LLM-Beobachtbarkeit, Lösungen
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, Apps
sql_connection_string_template_sqlalchemy_pyodbc	Vollständige SQLAlchemy-PYODBC-Verbindungszeichenfolge, bei welcher der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Document Understanding
postgresql_connection_string_template_sqlalchemy_pyodbc	Vollständige Zeichenfolge der SQL Alchemy PSYCOPG2- Verbindung, wobei der Datenbankname auf DB_NAME_PLACEHOLDER festgelegt ist. Das Installationsprogramm ersetzt diesen Platzhalter durch die Standarddatenbanknamen für die installierten Suite-Dienste.	Process Mining

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

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

ein Beispiel von postgresql_connection_string_template_sqlalchemy_pyodbc

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

Hinweis: Aktualisieren Sie cluster_config.jsonmit der neuen Verbindungszeichenfolgevorlage, 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 cluster_config.json-Datei 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.jsonhinzu oder aktualisieren Sie ihn:

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

Automation Suite-Roboter

Automation Suite-Roboter und Orchestrator verwenden standardmäßig dieselbe Datenbank. Der Datenbankname ist AutomationSuite_Orchestrator .

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

"asrobots": {
  "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 cluster_config.json-Datei 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 cluster_config.json-Datei 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.jsonhinzu oder aktualisieren Sie ihn:

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

Wichtig:

Um FIPS 140-2 auf der Maschine zu aktivieren, auf der das AI Center installiert ist, müssen Sie Folgendes an sql_connection_string_template_jdbc anfügen:

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

Apps

Der Standarddatenbankname für Apps ist AutomationSuite_Apps.

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

"apps": {
  "sql_connection_str": "***" // odbc 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 cluster_config.json-Datei 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 cluster_config.json-Datei hinzu oder aktualisieren Sie ihn:

"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

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 cluster_config.json-Datei hinzu oder aktualisieren Sie ihn:

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

Process Mining

Der Standarddatenbankname für Process Mining ist AutomationSuite_ProcessMining_Metadata .

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

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

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.jsonhinzu oder aktualisieren Sie ihn:

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

Integration Services

Der Standarddatenbankname für Integration Services ist AutomationSuite_Integration_Services .

Um eine Verbindungszeichenfolge anzugeben, fügen Sie den folgenden Abschnitt in der Datei cluster_config.jsonhinzu oder aktualisieren Sie ihn:

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

Ausführen des Installationsprogramms

Um das Installationsprogramm auszuführen, verwenden Sie den folgenden Befehl:

cd /opt/UiPathAutomationSuite/{version}/installer

./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json