Abonnieren

UiPath Automation Suite

Die Anleitung für die UiPath Automation Suite

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

Überprüfen Sie, ob Ihre HA-fähige Produktionsumgebung mit mehreren Knoten die Anforderungen erfüllt, bevor Sie die Automation Suite mithilfe der dedizierten Skripts installieren.

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

ValidationDescription
Hardware requirementsValidates that each machine in the cluster meets the hardware requirements. The check takes into account the following aspects:
server, agent, or tainted node;
online or offline system;
single-node evaluation profile or multi-node HA-ready production profile.
Disk partitioning and configurationValidates that you properly partitioned and configured the disk. The check takes into account the following aspects:
server or agent node;
online or offline system;
primary or secondary server node.
SQL Server connectivityValidates the connectivity to the configured SQL Server and database. The check takes into account the following aspects:
connectivity to the SQL Server host (endpoint) on a given endpoint;
connectivity to the principal database if create_db is set to true;
create database (dbcreator) permissions if create_db is set to true;
create schema (db_ddladmin), read (db_datareader), and write (db_datawriter) permissions;
connectivity to the database when create_db is set to false;
special requirements for each service. For instance, for Insights, the script checks the columnstore index, json support, and whether SQL Server compatibility level is >= 130;
connectivity to the database and SQL Server with integrated authentication.
Server certificateChecks that the server certificate you provided is valid. The check takes into account the following aspects:
the certificate file format is .pem, i.e. Base64-encoded DER certificate;
the private key length is at least 2048;
Extended Key Usage and TLS Web Server Authentication, required for accessing Automation Suite on iOS devices;
Subject Alternative Name for all the required DNS entries;
server certificate and private key match;
the CA bundle you provided is actually the issuer of the server certificate;
the certificate validity is more than 30 days.
Token-signing certificateChecks that the token-signing certificate you provided is valid. The check takes into account the following aspects:
the certificate is in pfx format;
the password for decrypting the certificate is valid;
the certificate validity is more than 30 days.
ProxyValidates that you properly configure the proxy. The check takes into account the following aspects:
https_proxy, http_proxy, and no_proxy are set as environment variables on the machine;
the proxy server is reachable.
ConnectivityValidates that all machines can connect to each other, that all the required URLs are on the firewall allowlist, and more. The check takes into account the following aspects:
the FQDN of Automation Suite and the FQDN of all the other subdomains are resolvable from the machine;
in an online setup, all the external URLs are reachable from the machine;
all servers, agents, and tainted nodes can connect to each other on the required ports;
the outbound connections (URLs) are resolvable via all the nameservers present in /etc/resolve.conf;
if any of the URLs is not resolvable via all the nameservers, then at least one nameserver can resolve all the URLs;
either the TCP or UDP protocol is allowed;
fixed_rke_address is set to port 9345 and 6443;
a response is issued when a call is made to the FQDN on port 443.
System servicesValidates that system services are properly configured. The check takes into account the following aspects:
nm-cloud-setup.service, nm-cloud-setup.timer, firewalld are disabled;
iscsi-initiator-utils is installed and enabled;
auditd is properly configured for --backlog_wait_time set as 1;
logrotate is properly configured.
Software requirementsValidates that all the required software is installed. If some software is not installed, the install-uipath.sh installer attempts to install it.

 

Verwenden des Skripts zum Überprüfen der Installationsvoraussetzungen

Herunterladen des Skripts

📘

Offlineinstallationen

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.

Installation typeFiles to download
Onlinesf-installer.zip – Mandatory. For download instructions, see sf-installer.zip.
Offlinesf-installer.zip – Mandatory. For download instructions, see sf-installer.zip.
sf-infra.tar.gz – Mandatory. For download instructions, see sf-infra.tar.gz.

Vorbereitung auf die Verwendung des Skripts

  1. Werden Sie Root, indem Sie den folgenden Befehl ausführen:
sudo su -
  1. 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}
  1. Entpacken Sie das Paket, indem Sie den folgenden Befehl ausführen:
unzip sf-installer.zip -d installer
  1. Weisen Sie die erforderlichen Berechtigungen zu und navigieren Sie zum Skriptordner, indem Sie den folgenden Befehl ausführen:
chmod -R 755 installer
cd installer

Script parameters

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

./validateUiPathASReadiness.sh --help
Klicken Sie hier, um die Ausgabe anzuzeigen. 
***************************************************************************************

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:

ParameterDescription
-i|--inputAccepts the cluster_config.json file as input. This file defines the parameters, settings, and preferences applied to the UiPath services deployed via Automation Suite. For details, see Advanced Installation Experience.

If you do not provide this file, the script will trigger the interactive experience to collect these inputs. The file will then be generated on your behalf.
-d|--debugDebug mode to get additional details helpful for debugging.
-m|--machinesAccepts comma-separated IP address / hostnames of all the machines. This is required to check the connectivity between all the nodes on the required port.

The parameter is mandatory for multi-node HA-ready production installations. In addition to that, the parameter is also required if you plan to add a Task Mining, GPU, or Automation Suite Robots node in a single-node evaluation cluster.
-n|--node-typeAccepts the type of the current node. Possible values are: server, agent, task-mining, gpu, and asrobots.
The default value is server.
--install-typeAccepts the installation method: online or offline.
The default value is online.
--prereq-bundleAccepts the absolute path where the sf-infra.tar.gz is located.
--prereq-tmp-folderAccepts the absolute path where sf-infra.tar.gz bundle will be temporarily extracted. If this path is not provided, the installer will select the /tmp folder.
--kubeconfigSpecify the path to the kubeconfig file.
validate-packagesValidates the required RPM packages.
install-packagesInstalls the required RPM packages for online installation.
install-packages --install-type offlineInstalls the RPM required packages for offline installation.

 

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.

  1. Führen Sie den folgenden Befehl aus, um die Datei cluster_config.json auf die anderen Maschinen zu kopieren:
scp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node dns>:/opt/UiPathAutomationSuite

📘

Tipp

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 Agent-Maschinen

To validate the Task Mining, GPU, or Automation Suite Robots machines, run the following command:

📘

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

Aktualisiert vor 4 Monaten

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

Überprüfen Sie, ob Ihre HA-fähige Produktionsumgebung mit mehreren Knoten die Anforderungen erfüllt, bevor Sie die Automation Suite mithilfe der dedizierten Skripts installieren.

Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.