Automatisierungen können sich auf verschiedenen Maschinen unterschiedlich verhalten. Wenn die Maschine, auf der eine Automatisierung in der Produktion ausgeführt wird, eine andere Konfiguration als die Maschine hat, auf der sie entworfen wurde (z. B. hat die Maschine unterschiedliche Hardware oder Software, unterschiedliche Berechtigungen oder befindet sich in einem isolierten Netzwerk), dann sollte der Prozess mit dem Roboter auf dieser Maschine getestet und debuggt werden.

Remote debugging enables you to run and debug attended and unattended processes on robots deployed to remote machines, including on Linux robots that can run cross-platform projects.

Sie können sich mit dem Remote-Roboter über einen der folgenden Verbindungstypen verbinden:

• Remote Machine - Establish a TCP/IP connection to the robot on the remote machine.
• Unattended Robot - Connect to an unattended robot in the same tenant using Orchestrator.

Using remote debugging requires that the project is open in Studio. If you are using source control, to make sure you are working with the latest project version, we recommend enabling the Enforce Check-In before Publish design setting.

Remote-Maschinenverbindung

Ausführen oder Debuggen eines Projekts mit einer Remote-Maschinenverbindung:

1. Stellen Sie sicher, dass alle Voraussetzungen erfüllt sind.
2. Konfigurieren Sie auf der Remote-Maschine den Roboter so, dass Remote-Debugging-Anforderungen akzeptiert werden.
3. Wenn die interaktive Authentifizierung im Orchestrator erzwungen wird und Sie einen Unattended-Prozess ausführen oder debuggen möchten, stellen Sie sicher, dass der Remote-Roboter eine der folgenden Bedingungen erfüllt:
   • Verbindung mit dem Orchestrator über die interaktive Anmeldung.
   • Verbunden über Client-Anmeldeinformationen oder Maschinenschlüssel und gleichzeitige Anmeldung eines Benutzers über den Assistant.
   • Connected using client credentials or machine key, no user is signed in from the Assistant, and a troubleshooting session is enabled in Orchestrator for the machine. For more information, see Debugging Unattended Processes.
4. In Studio:
   1. Stellen Sie eine Verbindung mit dem Remote-Roboter her.
   2. Stellen Sie sicher, dass die Remote-Ausführung aktiviert ist.
   3. Führen Sie Ihr Projekt aus oder debuggen Sie es.

Voraussetzungen

• TCP/IP-Konnektivität ist zwischen der Studio-Maschine und der Remote-Maschine vorhanden.
• Der Remote-Roboter ist dieselbe Version wie Studio.

Konfigurieren des Roboters auf der Remote-Maschine

Bevor der Remote-Roboter für das Debuggen verwendet werden kann, muss das Dienstprogramm UiPath.RemoteDebu debugging.Agent auf dieser Maschine so konfiguriert werden, dass Remote-Debugging-Anforderungen von Studio akzeptiert werden:

1. Navigieren Sie zum Installationsverzeichnis:

   • Für einen Windows-Roboter – Öffnen Sie eine Eingabeaufforderung im UiPath-Installationsordner (standardmäßig %PROGRAMFILES%\UiPath\Studio für Installationen pro Maschine, %localappdata%\Programs\UiPath\Studio für Installationen pro Benutzer).
   • Für einen Linux-Roboter – Navigieren Sie von einem Befehlszeilenterminal aus zu /root/application.
   • macOS-Roboter – Navigieren Sie mit zsh zu /Applications/UiPath Assistant.app/Contents/Robot.

2. Führen Sie den folgenden Befehl aus:

   • Für einen Windows-Roboter – UiPath.RemoteDebugging.Agent.exe enable --port <port_number> --password <pasword> --verbose
   • Für einen Linux-Roboter – ~/application # dotnet ./UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose
   • macOS-Roboter – dotnet UiPath.RemoteDebugging.Agent.dll --port <port_number> --password <pasword> --verbose

   Die Argumente im Befehl sind alle optional:

   • --port <port_number> – Geben Sie den Port ein, der zum Empfangen von Remote-Debugging-Befehlen von Studio verwendet werden soll. Wenn kein Port angegeben ist, wird standardmäßig der Port 8573 verwendet.
     Der Port muss in der Firewall geöffnet und nicht bereits an eine andere Anwendung gebunden sein.
   • --password <password> – Geben Sie ein Kennwort ein, das dann in Studio beim Einrichten einer Verbindung mit dem Remote-Debugging-Agenten angegeben werden muss.
   • --verbose – Protokollieren Sie zusätzliche Informationen auf der Konsole.

3. Die folgende Meldung wird angezeigt:
   Robot on machine <hostname> is waiting for remote debugging instructions on port <port_number>

4. Notieren Sie sich die Werte von hostname und port_number – diese müssen beim Einrichten der Verbindung in Studio angegeben werden.

Während sich der Roboter im Remote-Debugging-Status befindet, können keine Attended- oder Unattended-Aufträge über den Orchestrator oder den lokalen UiPath Assistant ausgeführt werden. Sie können Remote-Debugging-Befehle auch an Maschinen senden, auf denen die Roboterinstallation nicht lizenziert ist.

Einrichten einer Remote-Maschinenverbindung

1. Wählen Sie in Studio die Registerkarte Debuggen aus.
2. Wählen Sie im Menüband den Pfeil unter Remote-Debugging und dann Remote-Debugging konfigurieren aus, um das Fenster Remote-Debugging-Einstellungen zu öffnen.
3. Wählen Sie im Dropdownmenü Verbindungstyp die Option Remote-Maschine aus.
4. Geben Sie die folgenden Informationen in den entsprechenden Feldern an:
   • Host – Der Hostname oder die IP-Adresse der Remote-Maschine.
   • Port – Der zu verwendende Port. Der Standardport ist 8573.
   • Kennwort – Das Kennwort, das bei der Konfiguration des Remote-Debugging-Agenten auf der Robotermaschine angegeben wurde, falls zutreffend.
5. (Optional) Um sicherzustellen, dass mit der aktuellen Einrichtung eine Verbindung hergestellt werden kann, klicken Sie auf Testverbindung.
6. Klicken Sie auf Speichern (Save).

Unattended-Roboterverbindung

So funktioniert das Remote-Ausführen oder -Debuggen mithilfe eines Unattended-Roboters, der mit dem Orchestrator verbunden ist:

1. Stellen Sie sicher, dass alle Voraussetzungen erfüllt sind.
2. Stellen Sie eine Verbindung mit dem Remote-Roboter her.
3. Stellen Sie sicher, dass die Remote-Ausführung aktiviert ist.
4. Führen Sie Ihr Projekt aus oder debuggen Sie es.

Voraussetzungen

• Studio und der Zielroboter sind mit demselben Orchestrator-Mandanten verbunden.
• Studio, der Zielroboter und der Orchestrator führen Version 2021.10 oder höher aus. Für den Roboter ist 2021.10.6 die mindestens erforderliche Version zum Ausführen von Projekten aus Studio-Versionen ab 2021.10.6.
• Der bei Studio angemeldete Benutzer verfügt über Berechtigungen zum Starten von Aufträgen sowie zum Erstellen und Löschen von Speicher-Buckets und Speicherdateien im selben Ordnerkontext wie der Zielroboter. Darüber hinaus muss das Roboterkonto über Anzeigeberechtigungen für Speicher-Buckets und Speicherdateien verfügen.
• Der Unattended-Roboter ist konfiguriert und die Maschine verfügt über eine der folgenden Laufzeitlizenzen: Unattended, NonProduction, Testing.
  Note: Testing runtimes for remote debugging are supported in Orchestrator 2022.4 and later.
• Zum Debuggen von Vordergrundprozessen ist die Option Vordergrundautomatisierungen ausführen für den Roboter im Orchestrator aktiviert.
• Wenn eine Fehlerbehebungssitzung verwendet wird, darf sie erst aktiviert werden, nachdem der Roboter mit dem Orchestrator verbunden wurde.

Einrichten einer Unattended-Roboterverbindung

1. Wählen Sie in Studio die Registerkarte Debuggen aus.

2. Wählen Sie im Menüband den Pfeil unter Remote-Debugging und dann Remote-Debugging-Einstellungen aus.

3. Wählen Sie in der Dropdownliste Verbindungstyp die Option Unattended-Roboter aus.

4. Um eine verbundene Maschine zu verwenden, die im Orchestrator-Ordner verfügbar ist, der aus der Studio-Statusleiste ausgewählt wurde, klicken Sie auf Speichern. Wenn Sie die Maschine auswählen möchten, mit der eine Verbindung hergestellt werden soll, verwenden Sie die folgenden Optionen:

   • Benutzer – Wählen Sie ein Konto mit einem Unattended-Roboter aus, der dem Orchestrator-Ordner zugewiesen ist.
   • Maschine – Wählen Sie eine Maschine oder Vorlage aus dem Orchestrator-Ordner aus.
   • Hostname – Wählen Sie eine Maschine aus der Liste der verbundenen Maschinen aus.

   Hinweis: Wenn Änderungen an der Kontoeinrichtung im Orchestrator vorgenommen werden, aktualisieren Sie die Orchestrator-Verbindung über die Schaltfläche in der Studio-Statusleiste, damit sie in diesem Fenster angezeigt werden.

Remote-Ausführung

Wenn eine Remote-Debugging-Verbindung hergestellt wird, wird durch Klicken auf die Schaltfläche Remote-Debugging im Menüband zwischen Remote- und lokaler Ausführung umgeschaltet. Bevor Sie einen Ausführungs- oder Debugging-Vorgang auswählen, stellen Sie sicher, dass die gewünschte Option aktiviert ist (remote oder lokal).

• Solange die Schaltfläche grau hervorgehoben ist, werden alle Ausführungs- und Debugging-Vorgänge (Datei debuggen, Datei ausführen, Projekt debuggen, Projekt ausführen, Einzelschritt, Prozedurschritt, Rückschritt, Aktivität testen, Bis zu/Ab dieser Aktivität ausführen) auf dem Remote-Roboter ausgeführt.

• Solange die Schaltfläche nicht grau hervorgehoben ist, werden alle Ausführungs- und Debug-Vorgänge auf dem lokalen Roboter ausgeführt.

Das Remote-Debugging ähnelt dem lokalen Debugging und alle Funktionen, die für das lokale Debugging verfügbar sind, sind auch für das Remote-Debugging verfügbar. Wenn die über die Registerkarte „Debuggen“ ausgelöste Remote-Ausführung in Bearbeitung ist, dann ist die Studio-Statusleiste grün eingefärbt.

Je nach dem für das Remote-Debugging verwendeten Verbindungstyp ruft der Remote-Roboter die für die Ausführung eines Projekts erforderlichen Aktivitätspakete wie folgt ab:

• Remote-Maschinenverbindung – Studio sendet die Liste der Projektabhängigkeiten und Aktivitätsfeeds (Paketquellen) an den Remote-Roboter, der die von Studio bereitgestellten Feeds zum Herunterladen der erforderlichen Pakete verwendet.
• Unattended-Roboterverbindung – Studio sendet nur die Liste mit Projektabhängigkeiten an den Remote-Roboter, der die Orchestrator-Feeds und die auf dem Remote-Roboter konfigurierten Aktivitätsfeeds zum Herunterladen der erforderlichen Pakete verwendet.

Bekannte Einschränkungen

• Wenn Sie eine Remote-Maschinenverbindung verwenden und das Debuggen für einen längeren Zeitraum anhalten, kann in Studio der Fehler Verbindung geschlossen auftreten, auch wenn die Verbindung auf der Remote-Maschine weiterhin aktiv zu sein scheint. Um dieses Problem zu vermeiden, können Sie die TCP-Inaktivitätszeitüberschreitung in Ihrer Cloud oder im lokalen Lastausgleich erhöhen.
• Remote-Debugging von Workflows mit langer Ausführungszeit wird nur für Unattended-Roboterverbindungen unterstützt.
• Wenn Sie eine Unattended-Roboterverbindung verwenden, startet die Auswahl der Option Bild in Bild die Ausführung nicht in einer separaten Sitzung.

Schließen einer Remote-Debugging-Verbindung

Um die Remote-Debugging-Verbindung zu deaktivieren, öffnen Sie das Fenster Remote-Debugging-Einstellungen, wenn keine Debugging-Ausführung läuft. Legen Sie dann den Verbindungstyp auf Deaktiviert fest und klicken Sie auf Speichern.