Upgrade von AI Center

Um das AI Center von einer Nebenversion auf eine andere zu aktualisieren (z. B. von 2021.10.1 auf 2021.10.2), Verwenden Sie die Verfahren auf dieser Seite.

Hinweis: Stellen Sie sicher, dass während des Upgrades keine neuen Bereitstellungen vorhanden sind.

Wichtig:

Wenn Sie ein Upgrade von AI Center 2021.10.3 oder 2021.10.4 auf eine neuere Version durchführen, ist ein Downgrade von Ceph 16.2.6 auf 15.2.9 erforderlich, um eine Datenbeschädigung zu verhindern.

Weitere Informationen finden Sie auf der Seite Herabstufen von Ceph von 16.2.6 auf 15.2.9.

Bereitstellungsmodus	Anweisungen zum Upgraden
Online-Auswertung mit einem einzelnen Knoten	Online-Auswertungsmodus mit einem einzelnen Knoten
Offline-Auswertung mit einem einzelnen Knoten	Offline-Auswertungsmodus mit einem einzelnen Knoten
HA-fähige Online-Produktion mit mehreren Knoten	HA-fähiger Online-Produktionsmodus mit mehreren Knoten
HA-fähige Offline-Produktion mit mehreren Knoten	HA-fähiger Offline-Produktionsmodus mit mehreren Knoten

Online-Auswertungsmodus mit einem einzelnen Knoten

Vorbereitung

1. Stellen Sie sicher, dass genügend Speicherplatz auf dem Knoten vorhanden ist.
2. Laden Sie das neue Installationsprogramm (installer.zip) auf den Server herunter und entpacken Sie es.
3. Stellen Sie die ursprüngliche cluster_config.json-Datei auf dem Server zur Verfügung.
4. Generieren Sie die neue cluster_config.json-Datei wie folgt:

• Wenn Sie die alte cluster_config.json-Datei haben, verwenden Sie den folgenden Befehl, um die Konfigurationsdatei aus dem Cluster zu generieren:

cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

• Wenn Sie nicht über die alte cluster_config.json-Datei verfügen, führen Sie den folgenden Befehl aus:

cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

Ausführung

Wartung und Sicherung

1. Stellen Sie sicher, dass Sie die Sicherung im Cluster aktiviert haben.
2. Stellen Sie eine Verbindung mit dem Serverknoten über SSH her.
3. Stellen Sie sicher, dass alle gewünschten Volumes Sicherungen im Cluster haben, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup

   Hinweis: Die Sicherung kann einige Zeit in Anspruch nehmen. Warten Sie etwa 15–20 Minuten und überprüfen Sie die Sicherung des Volumes erneut.
4. Versetzen Sie den Cluster wie folgt in den Wartungsmodus:
5. Führen Sie den folgenden Befehl aus:

   /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

6. Stellen Sie sicher, dass sich der Cluster im Wartungsmodus befindet, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

7. Erstellen Sie eine Sicherung der SQL-Datenbank.

Upgrade von Infrastruktur und Diensten auf Servern

1. Stellen Sie eine Verbindung mit dem Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Entfernen Sie den Abschnitt redis in der Patch-JSON-Datei.
   Aufgrund eines bekannten Problems beim Upgrade müssen wir die /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json -Datei manuell bearbeiten. Dies ist in Version 2022.4 behoben.
   Öffnen Sie dazu die Datei mit einem Texteditor und entfernen Sie die Zeilen 22 bis 25 und die Endung , in Zeile 21:

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Nach den Änderungen sollten die Dateien wie folgt aussehen:

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Führen Sie mit dem folgenden Befehl ein Upgrade der Infrastruktur und der Server durch:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

5. Aktualisieren Sie das Fabric, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

6. Führen Sie das Software-Installationsprogramm mit dem folgenden Befehl aus.

   Zuerst müssen Sie eine Verbindung mit dem Identitätsserver herstellen und ein Installationstoken abrufen. Kopieren Sie dann dieses Token und fügen Sie es in den Platzhalter aus der Datei „cluster_config.json“ ein.

   Sobald das Token vorhanden ist, können Sie die AI Center-Installation ausführen.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   Hinweis: Dieser Befehl deaktiviert den Wartungsmodus, den Sie vor dem Upgrade aktiviert haben, da alle Dienste während des Upgrades aktiv sein müssen. Der Befehl erstellt auch eine Sicherung des Clusterstatus und pausiert alle anderen geplanten Sicherungen.
7. Setzen Sie nach dem erfolgreichen Upgrade und der Verifizierung die Sicherungsplanung auf dem Knoten fort, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Rollback bei Fehler

Vorbereitung

1. Erstellen Sie einen separaten Ordner, um ältere Bundles zu speichern. Führen Sie die folgenden Vorgänge innerhalb dieses Ordners aus.
2. Laden Sie das Installationsprogramm der älteren Version (installer.zip) auf den Knoten herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
3. Erstellen Sie eine restore.json-Datei und kopieren Sie sie auf alle Knoten.
4. Stellen Sie sicher, dass die etcd-Sicherungsdaten auf dem primären Server am folgenden Speicherort vorhanden sind: /mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots.
   • etcdBackupPath – Dies ist derselbe wie der beim Aktivieren des node-name der Sicherung in backup.json angegeben;
   • node-name – der Hostname der VM des primären Servers.

Bereinigung des Clusters

1. Kopieren Sie das dedizierte Skript und führen Sie es aus, um alles von diesem Knoten zu deinstallieren. Tun Sie dies für alle Knoten. Weitere Informationen finden Sie im Abschnitt Deinstallieren des Clusters auf der Seite Fehlerbehebung.
2. Stellen Sie alle UiPath-Datenbanken in der Sicherung wieder her, die vor dem Upgrade erstellt wurde.

Wiederherstellen der Infrastruktur auf Serverknoten

1. Stellen Sie eine Verbindung mit dem Server über SSH her.
2. Stellen Sie die Infrastruktur wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

Wiederherstellen von Volume-Daten

1. Stellen Sie eine Verbindung mit dem Server über SSH her.
2. Wechseln Sie zum neuen Installationsordner.
   Hinweis: Die vorherigen Infrastruktur-Wiederherstellungsbefehle wurden mit dem alten Installationsprogramm ausgeführt. Die folgenden Befehle werden mit dem neuen Installationspaket ausgeführt.
3. Deaktivieren Sie den Wartungsmodus im Cluster, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. Stellen Sie sicher, dass der Wartungsmodus deaktiviert ist, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. Kopieren Sie die Datei restore.json, die in der Phase der Infrastrukturwiederherstellung verwendet wurde, in den neuen Installationspaketordner.
6. Stellen Sie Volumes wieder her, indem Sie den folgenden Befehl vom neueren Installationspaket aus ausführen:

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. Überprüfen Sie nach Abschluss der Wiederherstellung, ob alles wiederhergestellt ist und ordnungsgemäß funktioniert.
8. Während des Upgrades wurden geplante Sicherungen auf dem primären Knoten deaktiviert. Führen Sie den folgenden Befehl aus, um sie wieder zu aktivieren:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Offline-Auswertungsmodus mit einem einzelnen Knoten

Vorbereitung

1. Stellen Sie sicher, dass genügend Speicherplatz auf dem Knoten vorhanden ist.
2. Laden Sie das vollständige Offlinepaket (sf.tar.gz) auf den ausgewählten Server herunter.
3. Laden Sie das neue Installationsprogramm (installer.zip) auf den primären Server herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
4. Stellen Sie die ursprüngliche cluster_config.json-Datei auf dem Server zur Verfügung.
5. Generieren Sie die neue cluster_config.json-Datei wie folgt:
   • Wenn Sie die alte cluster_config.json-Datei haben, verwenden Sie den folgenden Befehl, um die Konfigurationsdatei aus dem Cluster zu generieren.

cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

• Wenn Sie nicht über die alte Konfigurationsdatei verfügen, führen Sie den folgenden Befehl aus:

cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

Ausführung

Wartung und Sicherung

1. Stellen Sie sicher, dass Sie die Sicherung im Cluster aktiviert haben.
2. Stellen Sie eine Verbindung mit dem Serverknoten über SSH her.
3. Stellen Sie sicher, dass alle Volumes Sicherungen im Cluster haben, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup

   Hinweis: Die Sicherung kann einige Zeit in Anspruch nehmen. Warten Sie etwa 15–20 Minuten und überprüfen Sie die Sicherung des Volumes erneut.
4. Versetzen Sie den Cluster wie folgt in den Wartungsmodus:
5. Führen Sie den folgenden Befehl aus:

   /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

6. Stellen Sie sicher, dass sich der Cluster im Wartungsmodus befindet, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

7. Erstellen Sie eine Sicherung der SQL-Datenbank.

Upgrade von Infrastruktur und Diensten auf Servern

1. Stellen Sie eine Verbindung mit dem Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Entfernen Sie den Abschnitt redis in der Patch-JSON-Datei.
   Aufgrund eines bekannten Problems beim Upgrade müssen wir die /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json -Datei manuell bearbeiten. Dies ist in Version 2022.4 behoben.
   Öffnen Sie dazu die Datei mit einem Texteditor und entfernen Sie die Zeilen 22 bis 25 und die Endung , in Zeile 21:

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Nach den Änderungen sollten die Dateien wie folgt aussehen:

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Die Infrastruktur mit dem folgenden Befehl aktualisieren:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

5. Aktualisieren Sie das Fabric, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

6. Führen Sie das Software-Installationsprogramm mit dem folgenden Befehl aus.

   Zuerst müssen Sie eine Verbindung mit dem Identitätsserver herstellen und ein Installationstoken abrufen. Kopieren Sie dann dieses Token und fügen Sie es in den Platzhalter aus der Datei „cluster_config.json“ ein.

   Sobald das Token vorhanden ist, können Sie die AI Center-Installation ausführen.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

   Hinweis: Dieser Befehl deaktiviert den Wartungsmodus, den Sie vor dem Upgrade aktiviert haben, da alle Dienste während des Upgrades aktiv sein müssen. Der Befehl erstellt außerdem eine Sicherung des Clusterstatus und pausiert alle anderen geplanten Sicherungen.

7. Setzen Sie nach dem erfolgreichen Upgrade und der Verifizierung die Sicherungsplanung auf dem Knoten fort, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Rollback bei Fehler

Vorbereitung

1. Erstellen Sie einen separaten Ordner, um alte Bundles zu speichern und die folgenden Vorgänge innerhalb dieses Ordners durchzuführen.
2. Laden Sie das reine Infrastruktur-Offlinepaket (sf-infra-bundle.tar.gz), das der alten Version entspricht, auf alle Knoten herunter.
3. Laden Sie das Installationsprogramm der alten Version (installer.zip) auf all die Knoten herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
4. Erstellen Sie eine restore.json-Datei und kopieren Sie sie auf den Knoten.
5. Stellen Sie sicher, dass die etcd-Sicherungsdaten auf dem primären Server am folgenden Speicherort vorhanden sind: /mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots.
   • etcdBackupPath – Dies ist derselbe wie der beim Aktivieren des node-name der Sicherung in backup.json angegeben;
   • node-name – der Hostname der VM des primären Servers.

Bereinigung des Clusters

1. Kopieren Sie das dedizierte Skript und führen Sie es aus, um alles von diesem Knoten zu deinstallieren. Weitere Informationen finden Sie im Abschnitt Deinstallieren des Clusters auf der Seite Fehlerbehebung.
2. Stellen Sie alle UiPath-Datenbanken in der älteren Sicherung wieder her, die vor dem Upgrade erstellt wurde.

Wiederherstellen der Infrastruktur auf Serverknoten

1. Stellen Sie eine Verbindung mit dem Serverknoten her.
2. Stellen Sie die Infrastruktur wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --offline-bundle "/path/to/older-version/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Wiederherstellen von Volume-Daten

1. Stellen Sie eine Verbindung mit dem Server über SSH her.
2. Wechseln Sie zum neuen Installationsordner.
   Hinweis: Die vorherigen Infrastruktur-Wiederherstellungsbefehle wurden mit dem alten Installationsprogramm ausgeführt. Die folgenden Befehle werden mit dem neuen Installationspaket ausgeführt.
3. Deaktivieren Sie den Wartungsmodus im Cluster, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. Stellen Sie sicher, dass der Wartungsmodus deaktiviert ist, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. Kopieren Sie die Datei restore.json, die in der Phase der Infrastrukturwiederherstellung verwendet wurde, in den neuen Installationspaketordner.
6. Stellen Sie Volumes vom dem neuen Installationspaket aus wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type offline

7. Überprüfen Sie nach Abschluss der Wiederherstellung, ob alles wiederhergestellt ist und ordnungsgemäß funktioniert.
8. Während des Upgrades wurden geplante Sicherungen auf diesem Knoten deaktiviert. Führen Sie den folgenden Befehl aus, um sie wieder zu aktivieren:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

HA-fähiger Online-Produktionsmodus mit mehreren Knoten

Vorbereitung

1. Suchen Sie einen Server (kein Agent), der die Anforderungen an die Festplatte für eine Onlineinstallation erfüllt. Dieser wird im gesamten Dokument primärer Server genannt. Wenn Sie ein selbstsigniertes Zertifikat verwenden, führen Sie den folgenden Befehl aus:

   <h3>Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   ### Update the trust store
   sudo update-ca-trust</h3>

2. Laden Sie das neue Installationsprogramm (installer.zip) auf alle Knoten herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
3. Stellen Sie die ursprüngliche cluster_config.json-Datei auf dem primären Server zur Verfügung.
4. Generieren Sie die neue cluster_config.json-Datei wie folgt:
   • Wenn Sie die alte cluster_config.json-Datei haben, verwenden Sie den folgenden Befehl, um die Konfigurationsdatei aus dem Cluster zu generieren:

cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

• Wenn Sie nicht über die alte Konfigurationsdatei verfügen, führen Sie den folgenden Befehl aus:

cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

5. Kopieren Sie diese Datei cluster_config.json in den Installationsordner auf allen Knoten.

Ausführung

Wartung und Sicherung

1. Stellen Sie sicher, dass Sie die Sicherung im Cluster aktiviert haben.
2. Stellen Sie eine Verbindung mit einem der Serverknoten über SSH her.
3. Stellen Sie sicher, dass alle gewünschten Volumes Sicherungen im Cluster haben, indem Sie /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup ausführen.
   Hinweis: Die Sicherung kann einige Zeit in Anspruch nehmen. Warten Sie etwa 15–20 Minuten und überprüfen Sie die Sicherung des Volumes erneut.
4. Versetzen Sie den Cluster wie folgt in den Wartungsmodus:
5. Führen Sie den folgenden Befehl aus:

   /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

6. Stellen Sie sicher, dass sich der Cluster im Wartungsmodus befindet, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

7. Erstellen Sie eine Sicherung der SQL-Datenbank.

Upgrade der Infrastruktur auf Servern

1. Stellen Sie eine Verbindung mit jedem Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Führen Sie den folgenden Befehl auf allen Servern aus:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

Als Teil dieses Befehls wird auch die Sicherung des Clusterstatus übernommen und alle weiteren geplanten Sicherungen pausiert.

Hinweis: Dieser Befehl erstellt auch eine Sicherung des Clusterstatus und hält alle anderen geplanten Sicherungen an.

Upgrade der Infrastruktur auf Agenten

1. Stellen Sie eine Verbindung mit jedem Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Führen Sie den folgenden Befehl aus:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

Ausführen des Rests des Upgrades auf dem primären Server

1. Stellen Sie eine Verbindung mit dem primären Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Entfernen Sie den Abschnitt redis in der Patch-JSON-Datei.
   Aufgrund eines bekannten Problems beim Upgrade müssen wir die /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json -Datei manuell bearbeiten. Dies ist in Version 2022.4 behoben.
   Öffnen Sie dazu die Datei mit einem Texteditor und entfernen Sie die Zeilen 22 bis 25 und die Endung , in Zeile 21:

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Nach den Änderungen sollten die Dateien wie folgt aussehen:

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Aktualisieren Sie das Fabric, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

5. Führen Sie das Software-Installationsprogramm mit dem folgenden Befehl aus.

   Zuerst müssen Sie eine Verbindung mit dem Identitätsserver herstellen und ein Installationstoken abrufen. Kopieren Sie dann dieses Token und fügen Sie es in den Platzhalter aus der Datei „cluster_config.json“ ein.

   Sobald das Token vorhanden ist, können Sie die AI Center-Installation ausführen.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   Hinweis: Dieser Befehl deaktiviert den Wartungsmodus, den Sie vor dem Upgrade aktiviert haben, da alle Dienste während des Upgrades aktiv sein müssen.
6. Setzen Sie nach dem erfolgreichen Upgrade und der Verifizierung die Sicherungsplanung auf dem Knoten fort, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Rollback bei Fehler

Vorbereitung

1. Erstellen Sie einen separaten Ordner, um die alten Bundles zu speichern und die folgenden Vorgänge innerhalb dieses Ordners durchzuführen.
2. Laden Sie die alte Version des Installationsprogramms (installer.zip) auf alle Knoten herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
3. Erstellen Sie die restore.json-Datei und kopieren Sie sie auf alle Knoten.
4. Stellen Sie sicher, dass die etcd-Sicherungsdaten auf dem primären Knoten am folgenden Speicherort vorhanden sind: /mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots.
   • etcdBackupPath – Dies ist derselbe wie der beim Aktivieren des node-name der Sicherung in backup.json angegeben;
5. node-name – der Hostname der VM des primären Servers.

Bereinigung des Clusters

1. Kopieren Sie das dedizierte Skript und führen Sie es aus, um alles von diesem Knoten zu deinstallieren. Tun Sie dies für alle Knoten. Weitere Informationen finden Sie im Abschnitt Deinstallieren des Clusters auf der Seite Fehlerbehebung.
2. Stellen Sie alle UiPath-Datenbanken in der älteren Sicherung wieder her, die vor dem Upgrade erstellt wurde.

Wiederherstellen der Infrastruktur auf Serverknoten

1. Stellen Sie eine Verbindung mit dem primären Server her. Dies sollte der gleiche Serverknoten sein, den Sie während des Upgrades ausgewählt haben.
2. Stellen Sie die Infrastruktur wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

3. Verbinden Sie die restlichen Serverknoten nacheinander über SSH.
4. Stellen Sie die Infrastruktur auf diesen Knoten wieder her, indem Sie den folgenden Befehl nacheinander auf den Serverknoten ausführen. Das parallele Ausführen wird nicht unterstützt.

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j server --accept-license-agreement --install-type online

Wiederherstellen der Infrastruktur auf Agentenknoten

1. Stellen Sie eine Verbindung mit jeder Agenten-VM über SSH her.
2. Stellen Sie die Infrastruktur auf diesen Knoten wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j agent --accept-license-agreement --install-type online

Wiederherstellen von Volume-Daten

1. Stellen Sie mit SSH eine Verbindung mit dem primären Server her.
2. Wechseln Sie zum neueren Installationsordner.
   Hinweis: Die vorherigen Infrastruktur-Wiederherstellungsbefehle wurden mit dem alten Installationsprogramm ausgeführt. Die folgenden Befehle werden mit dem neuen Installationspaket ausgeführt.
3. Deaktivieren Sie den Wartungsmodus im Cluster, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. Stellen Sie sicher, dass der Wartungsmodus deaktiviert ist, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. Kopieren Sie die Datei restore.json, die in der Phase der Infrastrukturwiederherstellung verwendet wurde, in den neuen Installationspaketordner.
6. Stellen Sie Volumes vom dem neuen Installationspaket aus wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. Überprüfen Sie nach Abschluss der Wiederherstellung, ob alles wiederhergestellt ist und ordnungsgemäß funktioniert.
8. Während des Upgrades wurden geplante Sicherungen auf dem primären Knoten deaktiviert. Führen Sie den folgenden Befehl aus, um sie wieder zu aktivieren:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

HA-fähiger Offline-Produktionsmodus mit mehreren Knoten

Vorbereitung

1. Suchen Sie einen Server (kein Agent), der die Anforderungen an die Festplatte für eine Offlineinstallation erfüllt. Dieser wird im gesamten Dokument primärer Server genannt.

   Wenn Sie ein selbstsigniertes Zertifikat verwenden, führen Sie den folgenden Befehl aus:

   <h3>Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   ### Update the trust store
   sudo update-ca-trust</h3>

2. Laden Sie das vollständige Offlinepaket (sf.tar.gz) auf den ausgewählten Server herunter.
3. Laden Sie das reine Infrastruktur-Offlinepaket (sf-infra.tar.gz) auf alle anderen Knoten herunter.
4. Laden Sie das neue Installationsprogramm (installer.zip) auf alle Knoten herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
5. Stellen Sie die ursprüngliche cluster_config.json-Datei auf dem primären Server zur Verfügung.
6. Generieren Sie die neue cluster_config.json-Datei wie folgt:
   • Wenn Sie die alte Datei „cluster_config.json“ haben, verwenden Sie den folgenden Befehl, um die Konfigurationsdatei aus dem Cluster zu generieren:

     cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

   • Wenn Sie nicht über die alte cluster config-Datei verfügen, führen Sie den folgenden Befehl aus:

     cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

7. Kopieren Sie diese Datei cluster_config.json auf allen Knoten in den Installationsordner.

Ausführung

Wartung und Sicherung

1. Stellen Sie sicher, dass Sie die Sicherung im Cluster aktiviert haben.
2. Stellen Sie eine Verbindung mit einem der Serverknoten über SSH her.
3. Stellen Sie sicher, dass alle gewünschten Volumes Sicherungen im Cluster haben, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup

   Hinweis: Die Sicherung kann einige Zeit in Anspruch nehmen. Warten Sie etwa 15–20 Minuten und überprüfen Sie die Sicherung des Volumes erneut.
4. Versetzen Sie den Cluster wie folgt in den Wartungsmodus:
5. Führen Sie den folgenden Befehl aus:

   /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

6. Stellen Sie sicher, dass sich der Cluster im Wartungsmodus befindet, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

7. Erstellen Sie eine Sicherung der SQL-Datenbank.

Upgrade der Infrastruktur auf Servern

1. Stellen Sie eine Verbindung mit jedem Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Führen Sie den folgenden Befehl auf allen Serverknoten aus:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

   Hinweis: Dieser Befehl erstellt auch eine Sicherung des Clusterstatus und hält alle anderen geplanten Sicherungen an.

Upgrade der Infrastruktur auf Agenten

1. Stellen Sie eine Verbindung mit jedem Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Führen Sie den folgenden Befehl aus:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

Ausführen des Rests des Upgrades auf dem primären Server

1. Stellen Sie eine Verbindung mit dem primären Server über SSH her.
2. Führen Sie sudo su - aus, um zum Stammverzeichnis zu werden.
3. Entfernen Sie den Abschnitt redis in der Patch-JSON-Datei.
   Aufgrund eines bekannten Problems beim Upgrade müssen wir die /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json -Datei manuell bearbeiten. Dies ist in Version 2022.4 behoben.
   Öffnen Sie dazu die Datei mit einem Texteditor und entfernen Sie die Zeilen 22 bis 25 und die Endung , in Zeile 21:

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Nach den Änderungen sollten die Dateien wie folgt aussehen:

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Aktualisieren Sie das Fabric, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

5. Führen Sie das Software-Installationsprogramm mit dem folgenden Befehl aus.

   Zuerst müssen Sie eine Verbindung mit dem Identitätsserver herstellen und ein Installationstoken abrufen. Kopieren Sie dann dieses Token und fügen Sie es in den Platzhalter aus der Datei „cluster_config.json“ ein.

   Sobald das Token vorhanden ist, können Sie die AI Center-Installation ausführen.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -s -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

   Hinweis: Dieser Befehl deaktiviert den Wartungsmodus, den Sie vor dem Upgrade aktiviert haben, da alle Dienste während des Upgrades aktiv sein müssen.
6. Setzen Sie nach dem erfolgreichen Upgrade und der Verifizierung die Sicherungsplanung auf dem Knoten fort, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Rollback bei Fehler

Vorbereitung

1. Erstellen Sie einen separaten Ordner, um die alten Bundles zu speichern und die folgenden Vorgänge innerhalb dieses Ordners durchzuführen.
2. Laden Sie die ältere Version des Installationsprogramms (installer.zip) auf alle Knoten herunter und entpacken Sie es.
   Hinweis: Erteilen Sie dem Ordner die richtigen Berechtigungen, indem Sie sudo chmod 755 -R <installer-folder> ausführen.
3. Erstellen Sie eine restore.json-Datei und kopieren Sie sie auf alle Knoten.
4. Stellen Sie sicher, dass die etcd-Sicherungsdaten auf dem primären Server am folgenden Speicherort vorhanden sind: /mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots.
   • etcdBackupPath – Dies ist derselbe wie der beim Aktivieren des node-name der Sicherung in backup.json angegeben;
   • node-name – der Hostname der VM des primären Servers.

Bereinigung des Clusters

1. Kopieren Sie das dedizierte Skript und führen Sie es aus, um alles von diesem Knoten zu deinstallieren. Tun Sie dies für alle Knoten. Weitere Informationen finden Sie im Abschnitt Deinstallieren des Clusters auf der Seite Fehlerbehebung.
2. Stellen Sie alle UiPath-Datenbanken in der älteren Sicherung wieder her, die vor dem Upgrade erstellt wurde.

Wiederherstellen der Infrastruktur auf Serverknoten

1. Stellen Sie eine Verbindung mit dem primären Server her (dieser ist derselbe wie der, der beim Upgrade ausgewählt wurde).
2. Stellen Sie die Infrastruktur wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

3. Verbinden Sie die restlichen Serverknoten nacheinander über SSH.
4. Stellen Sie die Infrastruktur auf diesen Knoten wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j server --accept-license-agreement --install-type online

   Hinweis: Führen Sie diesen Befehl nacheinander auf den Serverknoten aus. Das parallele Ausführen wird nicht unterstützt.

Wiederherstellen der Infrastruktur auf Agentenknoten

1. Stellen Sie eine Verbindung mit jeder Agenten-VM über SSH her.
2. Stellen Sie die Infrastruktur auf diesen Knoten wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j agent --accept-license-agreement --install-type online

Wiederherstellen von Volume-Daten

1. Stellen Sie mit SSH eine Verbindung mit dem primären Server her.
2. Wechseln Sie zum neuen Installationsordner.
   Hinweis: Die vorherigen Infrastruktur-Wiederherstellungsbefehle wurden mit dem älteren Installationsprogramm ausgeführt. Die folgenden Befehle werden mit dem neueren Installationspaket ausgeführt.
3. Deaktivieren Sie den Wartungsmodus im Cluster, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. Stellen Sie sicher, dass der Wartungsmodus deaktiviert ist, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. Kopieren Sie die Datei restore.jsonfile, die in der Phase der Infrastrukturwiederherstellung verwendet wurde, in den neuen Installationspaketordner.
6. Stellen Sie Volumes vom dem neueren Installationspaket aus wieder her, indem Sie den folgenden Befehl ausführen:

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. Überprüfen Sie nach Abschluss der Wiederherstellung, ob alles wiederhergestellt ist und ordnungsgemäß funktioniert.
8. Während des Upgrades wurden geplante Sicherungen auf dem primären Knoten deaktiviert. Führen Sie den folgenden Befehl aus, um sie wieder zu aktivieren:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Herabstufen von Ceph von 16.2.6 auf 15.2.9

Weitere Informationen zum Downgrade von Ceph finden Sie unter Downgrade von Ceph von 16.2.6 auf 15.2.9 im Handbuch zur Automation Suite .