Aktualisieren von Anmeldeinformationen

Richtlinien

Um Anmeldeinformationen für die verschiedenen Automation Suite Komponenten zu aktualisieren, führen Sie die folgenden Schritte aus:

1. Generieren Sie die input.json -Datei.
2. Geben Sie die neuen Anmeldeinformationen für die jeweiligen Komponenten in der input.json-Datei an, wie in den einzelnen Komponentenabschnitten beschrieben.
3. Führen Sie die uipathctl-CLI aus, wie in den einzelnen Komponentenabschnitten beschrieben.

Generieren der input.json-Datei

Generieren Sie die neueste input.json -Datei wie folgt:

• A: Um die neueste Revision Ihrer input.json -Datei abzurufen, führen Sie den folgenden Befehl aus:

  uipathctl manifest get-revision --namespace <uipath>
  

• B: Um alle letzten input.json -Dateien aufzulisten und diejenige zu bestimmen, die Sie auswählen möchten, führen Sie den folgenden Befehl aus:

  uipathctl manifest list-revisions --namespace <uipath>
  

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 input.json -Datei.
2. Geben Sie die neuen Verbindungszeichenfolgen für die installierten Produkte in der input.json an.
3. 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.

  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 deren Standardnamen in der SQL-Datenbank.

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, Task Mining, Data Service, Process Mining
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, Process Mining
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 (2024.10.3 oder höher)

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"

Beispiel „postgresql_connection_string_template_sqlalchemy_pyodbc“ (Process Mining 2024.10.3 oder höher)

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

Hinweis:

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

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

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

Für 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": ""
    }
}

Für 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

Der Standarddatenbankname für Task Mining ist AutomationSuite_Task_Mining .

Um eine Verbindungszeichenfolge für den Task Mining-Dienst bereitzustellen, fügen Sie den folgenden Abschnitt in der Datei input.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 input.json hinzu oder aktualisieren Sie ihn:

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

Ausführen des uipathctl-Installationsprogramms

Führen Sie den folgenden Befehl aus, um die Aktualisierung abzuschließen:

uipathctl manifest apply input.json --versions versions.json

Aktualisieren von Redis-Anmeldeinformationen

Bereitstellen der neuen Anmeldeinformationen für Redis

Aktualisieren Sie den folgenden Abschnitt in der Datei input.json mit dem neuen Kennwort und/oder Hostnamen:

"fabric": {
  "redis": {
    "hostname": "new_hostname",
    "password": "new_password",
    "port": 6380,
    "tls": true
  }

Ausführen des uipathctl-Installationsprogramms

Um die Aktualisierung der Redis-Anmeldeinformationen abzuschließen, führen Sie den folgenden Befehl aus:

uipathctl manifest apply input.json --only redis --versions versions.json

Hinweis:

Sie können das Testlauf-Flag mit uipathctl verwenden, um das Ergebnis des Befehls auszugeben, ohne es anzuwenden.

Aktualisieren von objectstore-Anmeldeinformationen

Aktualisieren Sie den folgenden Abschnitt in der 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>
},

Ausführen des uipathctl-Installationsprogramms

Um die Aktualisierung der Objektspeicher-Anmeldeinformationen abzuschließen, führen Sie den folgenden Befehl aus:

uipathctl manifest apply input.json --versions versions.json

Hinweis:

Sie können das Testlauf-Flag mit uipathctl verwenden, um das Ergebnis des Befehls auszugeben, ohne es anzuwenden.

Aktualisieren der Registrierungsanmeldeinformationen

Wenn die verwendete Containerregistrierung eine Authentifizierung zum Abrufen von Images erfordert, müssen Pods ein Geheimnis mit dem Namen uipathpullsecret verwenden.

Führen Sie die folgenden Schritte aus, um uipathpullsecret zu aktualisieren:

1. Aktualisieren Sie den Registrierungsabschnitt der input.json-Datei:

     "registries": { 
       "docker": { 
         "url": "yourContainerRegistryUrl", 
         "username": "username", 
         "password": "newpassword" 
       }, 
       "helm": { 
         "url": "yourContainerRegistryUrl", 
         "username": "username", 
         "password": "newpassword" 
       } 
     }
   

2. Vorhandenes uipathpullsecret löschen:

   oc delete secret uipathpullsecret -n <uipath>
   

3. Führen Sie den Installationsbefehl erneut aus:

   uipathctl manifest apply input.json --versions versions.json