Fehlersuche und ‑behebung

Wenn bei der Installation oder beim Upgrade Probleme auftreten, ziehen Sie die folgenden Problembehandlungsszenarien in Betracht.

Problem im Zusammenhang mit der zwischengespeicherten Uipcli-Legacy-Version

Plattform: CloudBees

Beschreibung: Das Problem betrifft das CloudBees Software-Upgrade. Nach dem Upgrade kann die intern zwischengespeicherte uipcli -Version nicht aktualisiert werden, was dazu führt, dass eine alte uipcli zwischengespeichert bleibt. Dies führt dazu, dass der Ordner tools nach der Extraktion nicht gefunden wird.

Remedy:

Um dieses Problem zu beheben, müssen Sie die Installation von UiPath.CLI.Windows.nupkg oder UiPath.CLI.nupkg erzwingen. Sie können dies mit einem Snippet ähnlich dem im folgenden Beispiel tun:

UiPathInstallPlatform(                        cliNupkgPath: 'C:\\Users\\uipathadmin\\CLIVersions\\UiPath.CLI.Windows.23.10.8894.39673.nupkg',                        cliVersion: 'X_23.10.8753.32995',                        forceInstall: true,                        traceLevel: 'Information'                    )

Beachten Sie, dass sich cliNupkgPath auf den Speicherort der zwischengespeicherten uipcli auf Ihrer Agent-Maschine bezieht.

Außerdem wird im obigen Beispiel cliVersion auf X_23.10.8753.32995 gesetzt, um zu erzwingen, dass UiPathInstallPlatform aus cliNupkgPath extrahiert wird, um die Extraktion einer Legacy-Version aus einer internen Datei .jar zu vermeiden.

Stellen Sie schließlich sicher, dass Sie mindestens die Version 3.1 des Plugins uipath-automation-package haben (3.2 wird empfohlen). Wenn Sie ein Windows- uipcli extrahieren, muss der Agent eine Windows-Maschine sein.

Nicht autorisierter Fehler

Beschreibung: Nicht autorisierter Fehler.

Remedy:

• Wenn Sie die einfache Authentifizierung verwenden : Stellen Sie sicher, dass die Benutzername-Kennwort-Kombination bei der Webanmeldung korrekt ist. Wenn die Verbundauthentifizierung aktiviert ist, stellen Sie sicher, dass Sie den Benutzernamen als „DOMAIN\user“ in die Aufgabe schreiben.
• Wenn Sie die Tokenauthentifizierung verwenden :
  • Widerrufen Sie das Token im API-Zugriffsbereich und generieren Sie ein neues.
  • Stellen Sie sicher, dass der Benutzer, der den Schlüssel generiert hat, auf den Orchestrator zugreifen kann und über ein Benutzerkonto auf der Orchestrator-Instanz verfügt.
• Wenn Sie sich bei einem lokalen Orchestrator authentifizieren: Stellen Sie sicher, dass das Orchestrator-Zertifikat gültig ist und dass die Maschine, auf der der Auftrag ausgeführt wird, dem Orchestrator-Zertifikat vertraut, falls Sie ein selbstsigniertes Zertifikat verwenden. Dieser Fehler wird möglicherweise angezeigt, da das für den Orchestrator verwendete Zertifikat ungültig ist. Dies kann bedeuten, dass sie den falschen CN oder andere Validierungsprobleme hat.

Verbotener Fehler

Lösung: Der Benutzer ist nicht berechtigt, die Aktion auszuführen. Stellen Sie sicher, dass der Benutzer über Berechtigungen zum Lesen von Ordnern, zum Hochladen von Paketen, zum Erstellen und Aktualisieren von Prozessen, zum Lesen von Testsätzen und Testfällen, zum Lesen von Hintergrundaufgaben sowie zum Erstellen und Ausführen von Testsätzen verfügt.

Ordner/Umgebung nicht gefunden

Lösung: Stellen Sie sicher, dass der von CI/CD-Plugins verwendete authentifizierte Benutzer über die Berechtigungen Folders.View und BackgroundTask.View (nur für 20.4) verfügt.

Paket ist bereits vorhanden (Konflikt)

Lösung: Stellen Sie sicher, dass das Paket, das Sie bereitstellen möchten, nicht bereits mit derselben Version vorhanden ist. Wenn sie existiert, sollten Sie die automatische Paketversionierung verwenden, um die neue Version bei jeder Bereitstellung zu verwenden.

Fehler beim Ausführen des Befehls (generischer Fehler)

Lösung: Wenn sich der Jenkins-Arbeitsbereich an einem Speicherort auf der Festplatte befindet (z. B. C:\Windows or C:\Program Files), für den der Benutzer keine Berechtigungen hat, stellen Sie sicher, dass der Arbeitsbereich auf einem Pfad platziert wird, auf den der Benutzer zugreifen kann.

Jenkins kann keine Pfade verarbeiten, die nicht-lateinische Zeichen enthalten

Lösung: Jenkins ist beim Aufrufen des UiPath-Plugins nicht in der Lage, nicht standardmäßige codierte Zeichen korrekt zu übergeben. Die unbekannten Zeichen werden durch ??? ersetzt.

Die Lösung hängt davon ab, wie Jenkins sowohl auf der Server- als auch auf der Agent-Hostmaschine bereitgestellt wird, beinhaltet jedoch die Einstellung von file.encoding auf UTF-8 in den Java- Optionen:

Windows

Beim Ausführen von Jenkins unter Windows als Dienst: Fügen Sie in der Dienstkonfigurationsdatei die Argumente innerhalb des Tags hinzu. Folgen Sie dem folgenden Beispielskript.

<arguments>-Xrs -Xmx512m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -jar "%BASE%\)\)jenkins.war" --httpPort=8080 --webroot="%BASE%\)\)war"</arguments>

Beim Ausführen von Jenkins in Docker: Übergeben Sie JAVA\_OPTS an den Container über --env JAVA_OPTS="..." gemäß dem Beispielskript unten.

docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS=-Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 jenkins/jenkins:lts

Beim Ausführen von Jenkins in Tomcat: Verwenden Sie die Umgebungsvariable CATALINA_OPTS . Folgen Sie dem folgenden Beispielskript.

export CATALINA_OPTS="-DJENKINS_HOME=/path/to/jenkins_home/ -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -Xmx512m"

Linux

Bei Ausführung auf Debian- oder Ubuntu-basierten Linux-Distributionen: Suchen Sie in der Konfigurationsdatei nach dem Argument JAVA_ARGS und fügen Sie die Dateicodierung hinzu. Folgen Sie dem folgenden Beispielskript:

JAVA_ARGS="-Dfile.encoding=UTF-8 -Xmx512m"

Bei der Ausführung auf RedHat Linux-basierten Verteilungen: Suchen Sie in der Konfigurationsdatei nach dem Argument JENKINS\_JAVA\_OPTIONS und fügen Sie die Dateicodierung hinzu. Folgen Sie dem Beispielskript unten.

JENKINS_JAVA_OPTIONS="-Dfile.encoding=UTF-8 -Xmx512m"