- Überblick
- Anforderungen
- Installation
- Voraussetzungsprüfungen
- Herunterladen der Installationspakete
- uipathctl-Cluster
- uipathctl-Clusterwartung
- uipathctl cluster maintenance disable
- uipathctl cluster maintenance enable
- uipathctl cluster maintenance is-enabled
- uipathctl cluster migration
- uipathctl cluster migration export
- uipathctl cluster migration import
- uipathctl cluster migration run
- uipathctl-Cluster-Upgrade
- uipathctl config
- uipathctl config add-host-admin
- uipathctl config additional-ca-certificates
- uipathctl config additional-ca-certificates get
- uipathctl config additional-ca-certificates update
- uipathctl config-Warnungen
- uipathctl config Alerts add-email
- uipathctl config alerts remove-email
- uipathctl config alerts update-email
- uipathctl config argocd
- uipathctl config argocd ca-certificates
- uipathctl config argocd ca-certificates get
- uipathctl config argocd ca-certificates update
- uipathctl config argocd generate-dex-config
- uipathctl config argocd generate-rbac
- uipathctl config argocd registry
- uipathctl config argocd registry get
- uipathctl config argocd registry update
- uipathctl config enable-basic-auth
- uipathctl config Orchestrator
- uipathctl config Orchestrator get-config
- uipathctl config orchestrator update-config
- uipathctl config saml-certificates get
- uipathctl config saml-certificates rotate
- uipathctl config saml-certificates update
- uipathctl config tls-certificates
- uipathctl config tls-certificates get
- uipathctl config tls-certificates update
- uipathctl config token-signing-certificates
- uipathctl config token-signing-certificates get
- uipathctl config token-signing-certificates rotate
- uipathctl config token-signing-certificates update
- UiPathctl-Zustand
- Uipathctl-Gesundheitspaket
- Uipathctl-Zustandsprüfung
- uipathctl health diagnose
- uipathctl health test
- uipathctl-Manifest
- uipathctl manifest apply
- uipathctl manifest diff
- uipathctl manifest get
- uipathctl manifest get-revision
- uipathctl Manifest list-applications
- uipathctl manifest list-revisions
- uipathctl manifest render
- uipathctl-Voraussetzung
- uipathctl prereq create
- uipathctl prereq run
- „uipathctl“-Ressource
- uipathctl-Ressourcenbericht
- uipathctl-Snapshot
- uipathctl-Snapshot-Sicherung
- uipathctl snapshot backup create
- uipathctl snapshot backup disable
- uipathctl snapshot backup enable
- uipathctl snapshot delete
- uipathctl snapshot list
- uipathctl snapshot restore
- uipathctl snapshot restore create
- uipathctl snapshot restore delete
- uipathctl snapshot restore history
- uipathctl snapshot restore logs
- uipathctl-Version
- Nach der Installation
- Migration und Upgrade
- Aktualisieren der Automation Suite auf EKS/AKS
- Schritt 1: Verschieben der Identitätsorganisationsdaten von einer eigenständigen in die Automation Suite
- Schritt 2: Wiederherstellen der eigenständigen Produktdatenbank
- Schritt 3: Sichern der Plattformdatenbank in der Automation Suite
- Schritt 4: Zusammenführen von Organisationen in der Automation Suite
- Schritt 5: Aktualisieren der migrierten Produktverbindungszeichenfolgen
- Schritt 6: Migrieren des eigenständigen Orchestrators
- Schritt 7: Migrieren von eigenständigen Insights
- Schritt 8: Löschen des Standardmandanten
- B) Migration von einzelnen Mandanten
- Migrieren von der Automation Suite unter Linux zur Automation Suite unter EKS/AKS
- Überwachung und Warnungen
- Clusterverwaltung
- Produktspezifische Konfiguration
- Verwenden des Orchestrator-Konfiguratortools
- Konfigurieren von Orchestrator-Parametern
- Orchestrator-appSettings
- Konfigurieren von AppSettings
- Konfigurieren der maximalen Anforderungsgröße
- Überschreiben der Speicherkonfiguration auf Clusterebene
- Konfigurieren von Anmeldeinformationsspeichern
- Konfigurieren der Verwendung von einem Verschlüsselungsschlüssel pro Mandant
- Bereinigen der Orchestrator-Datenbank
- Fehlersuche und ‑behebung
Aktualisieren von Anmeldeinformationen
Um Anmeldeinformationen für die verschiedenen Automation Suite Komponenten zu aktualisieren, führen Sie die folgenden Schritte aus:
-
Generieren Sie die
input.json
-Datei. -
Geben Sie die neuen Anmeldeinformationen für die jeweiligen Komponenten in der
input.json
-Datei an, wie in den einzelnen Komponentenabschnitten beschrieben. -
Führen Sie die
uipathctl
-CLI aus, wie in den einzelnen Komponentenabschnitten beschrieben.
input.json
-Datei wie folgt:
-
A: Führen Sie den folgenden Befehl aus, um die neueste Revision Ihrer
input.json
-Datei abzurufen:uipathctl manifest get-revision
uipathctl manifest get-revision -
B: Führen Sie den folgenden Befehl aus, um alle letzten
input.json
-Dateien aufzulisten und diejenige zu bestimmen, die Sie auswählen möchten:uipathctl manifest list-revisions
uipathctl manifest list-revisions
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 Wechseln des Kennworts, das zum Herstellen einer Verbindung mit der Datenbank verwendet wird, aus Sicherheits- und Compliance-Gründen;
- 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 Standardauthentifizierung 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.
- Generieren Sie die
input.json
-Datei. - Geben Sie die neuen Verbindungszeichenfolgen für die installierten Produkte in der Datei input.json an.
- Ausführen:
uipathctl
.
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.
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}
.
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.
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.
In der folgenden Tabelle wird erläutert, welches Vorlagenformat die Produktdienste akzeptieren:
Parameter |
Beschreibung |
Produkte |
---|---|---|
|
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, Task Mining, Data Service, Process Mining |
|
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 |
|
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.
Beispiel:
|
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;
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"
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;"
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;"
"mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:07%3Cl%5Bxj-%3D~%3Az%60Ds%26nl@sfdev4515230-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
"mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:07%3Cl%5Bxj-%3D~%3Az%60Ds%26nl@sfdev4515230-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
input.json
mit der neuen Verbindungszeichenfolgenvorlage, die Sie aktualisieren möchten.
B: Bereitstellung von Verbindungszeichenfolgen für jedes Produkt
Plattform
AutomationSuite_Platform
.
input.json
hinzu oder aktualisieren Sie ihn:
"platform": {
"sql_connection_str": "***" // dotnet connection string
}
"platform": {
"sql_connection_str": "***" // dotnet connection string
}
Orchestrator
AutomationSuite_Orchestrator
.
input.json
hinzu oder aktualisieren Sie ihn:
"orchestrator": {
"sql_connection_str": "***" // dotnet connection string
}
"orchestrator": {
"sql_connection_str": "***" // dotnet connection string
}
Automation Suite-Roboter
AutomationSuite_Orchestrator
.
input.json
hinzu oder aktualisieren Sie ihn:
"asrobots": {
"sql_connection_str": "***" // dotnet connection string
}
"asrobots": {
"sql_connection_str": "***" // dotnet connection string
}
Automation Hub
AutomationSuite_Automation_Hub
.
input.json
hinzu oder aktualisieren Sie ihn:
"automation_hub": {
"sql_connection_str": "***" // dotnet connection string
}
"automation_hub": {
"sql_connection_str": "***" // dotnet connection string
}
Automation Ops
AutomationSuite_Platform
.
input.json
hinzu oder aktualisieren Sie ihn:
"automation_ops": {
"sql_connection_str": "***" // dotnet connection string
}
"automation_ops": {
"sql_connection_str": "***" // dotnet connection string
}
AI Center
AutomationSuite_AICenter
.
input.json
hinzu oder aktualisieren Sie ihn:
"aicenter": {
"sql_connection_str": "***" // jdbc connection string
}
"aicenter": {
"sql_connection_str": "***" // jdbc connection string
}
Apps
AutomationSuite_Apps
.
input.json
hinzu oder aktualisieren Sie ihn:
"apps": {
"sql_connection_str": "***" // odbc connection string
}
"apps": {
"sql_connection_str": "***" // odbc connection string
}
Data Service
AutomationSuite_DataService
.
input.json
hinzu oder aktualisieren Sie ihn:
"dataservice": {
"sql_connection_str": "***" // dotnet connection string
}
"dataservice": {
"sql_connection_str": "***" // dotnet connection string
}
Document Understanding
AutomationSuite_DU_Datamanager
.
input.json
hinzu oder aktualisieren Sie ihn:
"documentunderstanding": {
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
"sql_connection_str": "***" // odbc connection string
}
}
"documentunderstanding": {
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
"sql_connection_str": "***" // odbc connection string
}
}
Insights
AutomationSuite_Insights
.
input.json
hinzu oder aktualisieren Sie ihn:
"insights": {
"sql_connection_str": "***" // dotnet connection string
}
"insights": {
"sql_connection_str": "***" // dotnet connection string
}
Process Mining
AutomationSuite_ProcessMining_Metadata
.
input.json
hinzu oder aktualisieren Sie ihn:
"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": ""
}
}
"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
AutomationSuite_Task_Mining
.
input.json
hinzu oder aktualisieren Sie ihn:
"task_mining": {
"sql_connection_str": "***" // dotnet connection string
}
"task_mining": {
"sql_connection_str": "***" // dotnet connection string
}
Test Manager
AutomationSuite_Test_Manager
.
input.json
hinzu oder aktualisieren Sie ihn:
"test_manager": {
"sql_connection_str": "***" // dotnet connection string
}
"test_manager": {
"sql_connection_str": "***" // dotnet connection string
}
Ausführen des uipathctl-Installationsprogramms
uipathctl
-Installationsprogramm mit dem folgenden Befehl aus:
uipathctl manifest apply input.json --versions versions.json
uipathctl manifest apply input.json --versions versions.json
input.json
mit dem neuen Kennwort und/oder Hostnamen:
"fabric": {
"redis": {
"hostname": "new_hostname",
"password": "new_password",
"port": 6380,
"tls": true
}
"fabric": {
"redis": {
"hostname": "new_hostname",
"password": "new_password",
"port": 6380,
"tls": true
}
uipathctl
-Installationsprogramm mit dem folgenden Befehl aus:
uipathctl manifest apply input.json --only redis --versions versions.json
uipathctl manifest apply input.json --only redis --versions versions.json
uipathctl
verwenden, um das Ergebnis des Befehls auszugeben, ohne es anzuwenden.
input.json
-Datei mit dem neuen access_key, secret_key oder acount_key und account_name:
"external_object_storage": {
"enabled": false, // <true/false>
"create_bucket": true, // <true/false>
"storage_type": "s3", // <s3,azure,aws>
"fqdn": "", // <needed in case of aws non instance profile>
"port": 443, // <needed in case of aws non instance profile>
"region": "",
"access_key": "", // <needed in case of aws non instance profile>
"secret_key": "", // <needed in case of aws non instance profile>
"use_managed_identity": false, // <true/false>
"bucket_name_prefix": "",
"bucket_name_suffix": "",
"account_key": "", // <needed only when using non managed identity>
"account_name": "",
"azure_fqdn_suffix": "core.windows.net",
"client_id": "" // <optional field in case of managed identity>
},
"external_object_storage": {
"enabled": false, // <true/false>
"create_bucket": true, // <true/false>
"storage_type": "s3", // <s3,azure,aws>
"fqdn": "", // <needed in case of aws non instance profile>
"port": 443, // <needed in case of aws non instance profile>
"region": "",
"access_key": "", // <needed in case of aws non instance profile>
"secret_key": "", // <needed in case of aws non instance profile>
"use_managed_identity": false, // <true/false>
"bucket_name_prefix": "",
"bucket_name_suffix": "",
"account_key": "", // <needed only when using non managed identity>
"account_name": "",
"azure_fqdn_suffix": "core.windows.net",
"client_id": "" // <optional field in case of managed identity>
},
uipathctl
-Installationsprogramm mit dem folgenden Befehl aus:
uipathctl manifest apply input.json --versions versions.json
uipathctl manifest apply input.json --versions versions.json
uipathctl
verwenden, um das Ergebnis des Befehls auszugeben, ohne es anzuwenden.
uipathpullsecret
verwenden. Um uipathpullsecret
zu aktualisieren, führen Sie die folgenden Schritte aus:
- Aktualisieren Sie den Registrierungsabschnitt der
input.json
-Datei:"registries": { "docker": { "url": "yourContainerRegistryUrl", "username": "username", "password": "newpassword" }, "helm": { "url": "yourContainerRegistryUrl", "username": "username", "password": "newpassword" } }
"registries": { "docker": { "url": "yourContainerRegistryUrl", "username": "username", "password": "newpassword" }, "helm": { "url": "yourContainerRegistryUrl", "username": "username", "password": "newpassword" } } - Vorhandenes
uipathpullsecret
löschen:kubectl delete secret uipathpullsecret -n uipath
kubectl delete secret uipathpullsecret -n uipath - Führen Sie den Installationsbefehl erneut aus:
./uipathctl manifest apply input.json --versions versions.json
./uipathctl manifest apply input.json --versions versions.json
- Richtlinien
- Generieren der input.json-Datei
- Aktualisieren der SQL-Verbindungszeichenfolgen
- Aktualisieren der Verbindungszeichenfolgen für installierte Produkte
- Aktualisieren von Redis-Anmeldeinformationen
- Bereitstellen der neuen Anmeldeinformationen für Redis
- Ausführen des uipathctl-Installationsprogramms
- Aktualisieren von objectstore-Anmeldeinformationen
- Ausführen des uipathctl-Installationsprogramms
- Aktualisieren der Registrierungsanmeldeinformationen