Aktualisieren der SQL-Verbindungszeichenfolgen

Aktualisieren Sie die SQL-Verbindungszeichenfolgen, die von Automation Suite-Produkten verwendet werden, um eine Verbindung mit der Datenbank herzustellen.

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 der 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:

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

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 {.

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, refer to Updating the CA certificates.

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 die 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 Automation Suite-Roboter Test Manager Automation Hub Automation Ops Insights Data Service Process Mining ECS LLM-Gateway LLM-Beobachtbarkeit Solutions (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 SQL-Alchemy PSYCOPG2- 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.	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.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 Suite-Roboter

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

Um eine Verbindungszeichenfolge für Automation Suite-Roboter bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei cluster_config.json 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 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
}

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.json hinzu 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 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": { 
"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 Datei cluster_config.json 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 Datei cluster_config.json 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.json hinzu 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.json hinzu 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