Validierung der Voraussetzungen in einer HA-fähigen Produktionseinrichtung mit mehreren Knoten

Überblick

Vor der Installation der Automation Suite empfiehlt es sich, die Installationsvoraussetzungen und die Bereitschaft der Infrastruktur zu überprüfen. Sie können das Skript validateUiPathASReadiness.sh verwenden, um Ihre Umgebung zu bewerten und eine Zusammenfassung zu generieren, bevor Sie die Installation durchführen.

Validierung	Beschreibung
Hardwareanforderungen	Überprüft, ob jede Maschine im Cluster die Hardwareanforderungen erfüllt. Die Prüfung berücksichtigt die folgenden Aspekte: Server-, Agent- oder markierter Knoten; Online- oder Offline-System; Evaluierungsprofil mit einem einzelnen Knoten oder HA-fähiges Produktionsprofil mit mehreren Knoten.
Festplattenpartitionierung und -konfiguration	Überprüft, ob Sie den Datenträger ordnungsgemäß partitioniert und konfiguriert haben. Die Prüfung berücksichtigt die folgenden Aspekte: Server- oder Agentknoten; Online- oder Offline-System; Primärer oder sekundärer Serverknoten.
SQL Server-Konnektivität	Validiert die Konnektivität zum konfigurierten SQL-Server und zur Datenbank. Die Prüfung berücksichtigt die folgenden Aspekte: Konnektivität mit dem SQL Server-Host (Endpunkt) auf einem bestimmten Endpunkt; Konnektivität zur Prinzipaldatenbank, wenn create_db auf true festgelegt ist; Berechtigungen für die Datenbank erstellen (dbcreator), wenn create_db auf true festgelegt ist; Schema erstellen (db_ddladmin), Lese- (db_datareader) und Schreibberechtigungen (db_datawriter); Konnektivität zur Datenbank, wenn create_db auf false festgelegt ist; Spezielle Anforderungen für jeden Dienst. Für Insights überprüft das Skript beispielsweise den Columnstore-Index, die json-Unterstützung und ob der SQL Server-Kompatibilitätsgrad >= 130 ist; Konnektivität zur Datenbank und zum SQL-Server mit integrierter Authentifizierung.
Serverzertifikat	Überprüft, ob das von Ihnen angegebene Serverzertifikat gültig ist. Die Prüfung berücksichtigt die folgenden Aspekte: Das Dateiformat des Zertifikats ist .pem, d. h. Base64-codiertes DER-Zertifikat; Die Länge des privaten Schlüssels beträgt mindestens 2048; Erweiterte Schlüsselnutzung und TLS-Webserver-Authentifizierung, erforderlich für den Zugriff auf die Automation Suite auf iOS-Geräten; Alternativer Antragstellername für alle erforderlichen DNS-Einträge; Serverzertifikat und privater Schlüssel stimmen überein; Das von Ihnen bereitgestellte Zertifizierungsstellenpaket ist tatsächlich der Aussteller des Serverzertifikats; Die Gültigkeit des Zertifikats beträgt mehr als 30 Tage.
Tokensignaturzertifikat	Überprüft, ob das von Ihnen angegebene Tokensignaturzertifikat gültig ist. Die Prüfung berücksichtigt die folgenden Aspekte: Das Zertifikat hat das Format pfx; Das Kennwort zum Entschlüsseln des Zertifikats ist gültig; Die Gültigkeit des Zertifikats beträgt mehr als 30 Tage.
Proxy	Überprüft, ob Sie den Proxy ordnungsgemäß konfigurieren. Die Prüfung berücksichtigt die folgenden Aspekte: https_proxy, http_proxy und no_proxy werden als Umgebungsvariablen auf der Maschine festgelegt; Der Proxyserver ist erreichbar.
Konnektivität	Überprüft, ob sich alle Maschinen miteinander verbinden können, dass sich alle erforderlichen URLs auf der Firewall-Zulassungsliste befinden und vieles mehr. Die Prüfung berücksichtigt die folgenden Aspekte: Der FQDN der Automation Suite und der FQDN aller anderen Unterdomänen sind von der Maschine aus auflösbar; In einer Online-Einrichtung sind alle externen URLs von der Maschine aus erreichbar; Alle Server-, Agent- und markierten Knoten können sich über die erforderlichen Ports miteinander verbinden; Die ausgehenden Verbindungen (URLs) können über alle Nameserver aufgelöst werden, die in /etc/resolve.conf vorhanden sind; Wenn eine der URLs nicht über alle Nameserver auflösbar ist, dann kann mindestens ein Nameserver alle URLs auflösen; Entweder das TCP- oder das UDP-Protokoll ist zulässig; fixed_rke_address ist auf Port 9345 und 6443 festgelegt; Beim Abruf des FQDN an Port 443 wird eine Antwort ausgegeben.
Systemdienste	Überprüft, ob die Systemdienste ordnungsgemäß konfiguriert sind. Die Prüfung berücksichtigt die folgenden Aspekte: nm-cloud-setup.service, nm-cloud-setup.timer, firewalld sind deaktiviert; iscsi-initiator-utils ist installiert und aktiviert; auditd ist ordnungsgemäß für --backlog_wait_time konfiguriert und als 1 festgelegt; logrotate ist ordnungsgemäß konfiguriert; net.ipv4.conf.all.rp_filter ist deaktiviert (auf 0 festgelegt).
Softwareanforderungen	Überprüft, ob die gesamte erforderliche Software installiert ist. Wenn Software nicht installiert ist, versucht das install-uipath.sh -Installationsprogramm, sie zu installieren.

Verwenden des Skripts zum Überprüfen der Installationsvoraussetzungen

Herunterladen des Skripts

Hinweis: Bei Offlineinstallationen müssen Sie diesen Schritt auf einer Maschine mit Internetzugang und zu den Air-Gap-Maschinen ausführen, auf denen die Automation Suite bereitgestellt wird. Kopieren Sie die Datei von der Onlinemaschine auf die erste Zielmaschine.

Das vorausgesetzte Skript wird zusammen mit dem Installationsprogramm in einem Archiv mit dem Namen sf-installer.zip verpackt, und unterstützende Tools sind als sf-infra.tar.gz nur für den Offline-Modus gebündelt. Sie benötigen diese Dateien, um einen Bericht über alle Maschinen zu generieren, auf denen Sie die Automation Suite installieren möchten.

Installationstyp	Herunterzuladende Dateien
Online	sf-installer.zip ‑ Obligatorisch. Anweisungen zum Herunterladen finden Sie unter sf-installer.zip.
Offline	sf-installer.zip ‑ Obligatorisch. Anweisungen zum Herunterladen finden Sie unter sf-installer.zip. sf-infra.tar.gz ‑ Obligatorisch. Anweisungen zum Herunterladen finden Sie unter sf-infra.tar.gz.

Vorbereiten der Verwendung des Skripts

1. Werden Sie Root, indem Sie den folgenden Befehl ausführen:

   sudo su -

2. Kopieren Sie die Dateien in den Ordner /opt/UiPathAutomationSuite/{version} , indem Sie den folgenden Befehl ausführen:

   VERSION="" #add the version number you are trying to install. Ex: for 2022.4.0 Set VERSION="2022.4.0"
   mkdir -p /opt/UiPathAutomationSuite/${VERSION}
   # For below command replace the /path/to where actually the files are present.
   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/${VERSION}
   # Additionally for offline, copy sf-infra.tar.gz as well to /opt/UiPathAutomationSuite/{VERSION} folder
   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/${VERSION}
   cd /opt/UiPathAutomationSuite/${VERSION}

3. Entpacken Sie das Paket, indem Sie den folgenden Befehl ausführen:

   unzip sf-installer.zip -d installer

4. Weisen Sie die erforderlichen Berechtigungen zu und navigieren Sie zum Skriptordner, indem Sie den folgenden Befehl ausführen:

   chmod -R 755 installer
   cd installer

Skriptparameter

Führen Sie den folgenden Befehl aus, um den Hilfeabschnitt und unterstützte Flags anzuzeigen:

./validateUiPathASReadiness.sh --help

Ausgabe:

***************************************************************************************
validateUiPathASReadiness.sh Runs pre-install validation checks
Usage:
  validateUiPathASReadiness.sh [command]
  validateUiPathASReadiness.sh [flags]
Available Commands:
  validate-packages                                     Validate that required packages are installed
  install-packages                                      Install required packages. If --install-type offline, this will also install offline required packages
Arguments:
 -i|--input                                             Specify cluster config json file. Defaults to /opt/UiPathAutomationSuite/cluster_config.json
 -d|--debug                                             Debug mode to get additional details helpful for debugging
 -m|--machines                                          Comma separated IP address / hostnames of all the machines
 -n|--node-type                                         Possible values [server|agent|taskmining|asrobots|gpu]. Defaults to server
 --install-type                                         Possible values [online|offline]. Defaults to online
 --prereq-bundle </uipath/offline_bundle.tar.gz>        Specify the path to the prereq bundle
 --prereq-tmp-folder </uipath>                          Specify parent directory for the temporary install folder
 --kubeconfig                                           Specify path to the kubeconfig file
 -h|--help                                              Display help
***************************************************************************************

In der folgenden Tabelle werden die Parameter beschrieben, die Sie beim Ausführen des Skripts verwenden können:

Parameter	Beschreibung
-i|--input	Akzeptiert die cluster_config.json -Datei als Eingabe. Diese Datei definiert die Parameter, Einstellungen und Präferenzen, die auf die über die Automation Suite bereitgestellten UiPath-Dienste angewendet werden. Weitere Informationen finden Sie unter Erweiterte Installation. Wenn Sie diese Datei nicht bereitstellen, löst das Skript die interaktive Erfahrung aus, um diese Eingaben zu sammeln. Die Datei wird dann in Ihrem Namen generiert.
-d|--debug	Debugmodus, um zusätzliche Details zu erhalten, die für das Debuggen hilfreich sind.
-m|--machines	Akzeptiert durch Kommas getrennte IP-Adressen/Hostnamen aller Maschinen. Dies ist erforderlich, um die Konnektivität zwischen allen Knoten am erforderlichen Port zu überprüfen. Der Parameter ist für HA-fähige Produktionsinstallationen mit mehreren Knoten obligatorisch. Darüber hinaus ist der Parameter auch erforderlich, wenn Sie einen Task Mining-, GPU- oder Automation Suite-Roboterknoten in einem Auswertungscluster mit einem einzelnen Knoten hinzufügen möchten.
-n|--node-type	Akzeptiert den Typ des aktuellen Knotens. Mögliche Werte sind: server , agent , task-mining , gpu und asrobots . Der Standardwert ist server.
--install-type	Akzeptiert die Installationsmethode: online oder offline . Der Standardwert ist online.
--prereq-bundle	Akzeptiert den absoluten Pfad, in dem sich sf-infra.tar.gz befindet.
--prereq-tmp-folder	Akzeptiert den absoluten Pfad, in den das sf-infra.tar.gz -Paket vorübergehend extrahiert wird. Wenn dieser Pfad nicht angegeben wird, wählt das Installationsprogramm den Ordner /tmp aus.
--kubeconfig	Geben Sie den Pfad zur kubeconfig-Datei an.
validate-packages	Validiert die erforderlichen RPM-Pakete.
install-packages	Installiert die erforderlichen RPM-Pakete für die Online-Installation.
install-packages --install-type offline	Installiert die für die Offlineinstallation erforderlichen RPM-Pakete.

Validierung einer HA-fähigen Produktionseinrichtung mit mehreren Knoten

Auf der ersten Servermaschine

1. Führen Sie den folgenden Befehl aus, um die erste Servermaschine zu validieren:

Online

./validateUiPathASReadiness.sh \
  --node-type server \ 
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IPs of all the nodes in cluster

Offline

./validateUiPathASReadiness.sh \
  --node-type server \ 
  --install-type offline \
  --prereq-bundle ../sf-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IPs of all the nodes in cluster

Sobald dieses Skript ausgeführt wird, generiert es eine cluster_config.json -Datei im Ordner /opt/UiPathAutomationSuite . Diese Datei ist auf allen anderen Maschinen erforderlich.

2. Um die Datei cluster_config.json auf die anderen Maschinen zu kopieren, führen Sie den folgenden Befehl aus:

scp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node dns>:/opt/UiPathAutomationSuite

Hinweis:

Wenn Sie die Datei aufgrund von Berechtigungsfehlern nicht in den Ordner /opt/UiPathAutomationSuite kopieren können, können Sie sie vorübergehend nach /var/tmp auf den neuen Maschinen kopieren und dann nach /opt/UiPathAutomationSuite verschieben.

Alternativ können Sie auch Vollzugriffsberechtigungen ( 777 ) für den Ordner /opt/UiPathAutomationSuite auf den neuen Maschinen erteilen, indem Sie den folgenden Befehl ausführen: chmod -R 777 /opt/UiPathAutomationSuite .

Auf den anderen Servermaschinen

Führen Sie den folgenden Befehl aus, um die anderen Servermaschinen zu validieren:

Online

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type server \
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster

Offline

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type server \
  --install-type offline \
  --prereq-bundle ../sf-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" #replace with actual machine IP of all the nodes in cluster

Auf Agent-Maschinen

Führen Sie den folgenden Befehl aus, um die Agent-Maschinen zu validieren:

Online

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type agent \
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

Offline

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type agent \
  --install-type offline \ #replace with offline for airgap
  --prereq-bundle ../sf-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

Auf spezialisierten Agentmaschinen

Führen Sie den folgenden Befehl aus, um die Task Mining-, GPU- oder Automation Suite-Robotermaschinen zu validieren:

Hinweis:

Stellen Sie sicher, dass Sie den geeigneten Parameter verwenden, um Ihren spezialisierten Agent-Knoten zu identifizieren:

• für Task Mining-Maschinen verwenden --node-type task-mining
• für GPU-Maschinen verwenden --node-type gpu
• Verwenden Sie für Automation Suite-Roboter-Maschinen --node-type asrobots .

Online

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type task-mining \ #replace with gpu for GPU node or asrobots for Automation Suite Robots node
  --install-type online \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster

Offline

./validateUiPathASReadiness.sh \
  --input /opt/UiPathAutomationSuite/cluster_config.json \
  --node-type task-mining \ #replace with gpu for GPU node or asrobots for Automation Suite Robots node
  --install-type offline \ 
  --prereq-bundle ../sf-infra.tar.gz \
  --prereq-tmp-folder /opt/UiPathAutomationSuite/tmp \
  --machines "10.0.1.8, 10.0.1.9" # replace with actual machine IP of all the nodes in cluster