View a markdown version of this page

Fehlerbehebung - AWS Deadline Cloud
Warum kann ein Benutzer meine Farm, Flotte oder Warteschlange nicht sehen?Warum nehmen die Arbeiter meine Jobs nicht an?Warum läuft mein Worker nicht weiter?Fehlerbehebung bei AufträgenDeadline Cloud überwacht die Protokolle der Desktop-AnwendungenWeitere Ressourcen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Fehlerbehebung

Die folgenden Verfahren und Tipps können Ihnen bei der Behebung von Problemen mit Ihren AWS Deadline Cloud-Farmen und -Ressourcen helfen.

Warum kann ein Benutzer meine Farm, Flotte oder Warteschlange nicht sehen?

Benutzerzugriff

Wenn Ihre Benutzer Ihre Farmen, Flotten oder Warteschlangen nicht im Deadline Cloud-Monitor sehen, liegt möglicherweise ein Problem mit ihrem Zugriff auf Ihre Farm und Ressourcen vor.

Benutzer ohne Zugriff auf Farmen erhalten im Deadline Cloud-Monitor die Meldung „Keine Farmen verfügbar“.

Um zu bestätigen, dass Sie Ihrer Farm, Flotte oder Warteschlange den richtigen Benutzer oder die richtige Gruppe zugewiesen haben

  1. Suchen Sie in der AWS Deadline Cloud-Konsole nach Ihrer Farm, Flotte oder Warteschlange und wählen Sie dann Zugriffsverwaltung aus.

  2. Die Registerkarte „Gruppen“ ist standardmäßig ausgewählt. Wenn Sie Berechtigungen nach Gruppen zuweisen, was empfohlen wird, sollte Ihre Gruppe in der Liste angezeigt werden und über eine zugewiesene Zugriffsebene verfügen.

    Wenn die Gruppe nicht in der Liste enthalten ist, wählen Sie Gruppe hinzufügen aus, um der Gruppe Berechtigungen zuzuweisen.

  3. Wenn Sie Berechtigungen nach Benutzern zuweisen, wählen Sie den Tab Benutzer aus. Ihr Benutzer sollte in der Liste angezeigt werden und eine zugewiesene Zugriffsebene haben.

    Wenn Ihr Benutzer nicht in der Liste enthalten ist, wählen Sie Benutzer hinzufügen, um dem Benutzer die Berechtigung zuzuweisen.

Um zu bestätigen, dass Sie den Benutzer Ihrer Gruppe zugewiesen haben

  1. Suchen Sie in der AWS Deadline Cloud-Konsole nach Ihrer Farm, Flotte oder Warteschlange und wählen Sie dann Zugriffsverwaltung aus.

  2. Die Registerkarte „Gruppen“ ist standardmäßig ausgewählt. Wählen Sie den Gruppennamen aus, um die Mitglieder der Gruppe anzuzeigen.

  3. Wenn der Benutzer nicht in der Gruppe aufgeführt ist, muss er hinzugefügt werden.

    Wenn Sie das Standard-Identitäts-Setup verwenden, können Sie den Benutzer direkt in der Identity Center-Konsole zur Gruppe hinzufügen. Wenn Sie mit einem externen Identitätsanbieter wie Okta oder verbunden sindGoogle Workspace, können Sie Ihren Benutzer der Gruppe in Ihrem Identitätsanbieter hinzufügen.

    Anmerkung

    Einige externe Identitätsanbieter synchronisieren Benutzer, aber keine Gruppen, mit dem Identity Center. In diesem Fall sollten Sie erwägen, einem Benutzer Berechtigungen direkt und nicht nach Gruppen zuzuweisen.

Weitere Informationen zur Verwaltung des Benutzerzugriffs auf Deadline Cloud finden Sie unterBenutzer in Deadline Cloud verwalten.

Warum nehmen die Arbeiter meine Jobs nicht an?

Konfiguration der Flottenrollen

Wenn Mitarbeiter erstellt werden, die Initialisierung aber nicht abschließen und nicht mit der Arbeit an Aufträgen beginnen, liegt das manchmal daran, dass die Flottenrolle nicht richtig konfiguriert wurde.

Um diese Ursache zu überprüfen, überprüfen Sie Ihre CloudTrail Protokolle auf Fehler, die den Zugriff verweigert haben. Nachdem Sie das Problem mit der Zugriffsverweigerung bestätigt haben, wechseln Sie zu Ihrer Flotte und aktualisieren Sie die Rollenkonfiguration auf die richtigen Berechtigungen. Weitere Informationen finden Sie unter CloudTrail Logs im Deadline Cloud-Entwicklerhandbuch.

Warum läuft mein Worker nicht weiter?

Der Arbeiter steckt beim Verlassen der OpenJD-Umgebung fest

Mitarbeiter können bei lang andauernden envExit Sitzungsaktionen stecken bleiben. Dieses Problem kann auftreten, wenn Sie eine Jobvorlage verwenden, die die OpenJD-Vorlage überschreibt und das Timeout für das Beenden der Umgebung auf mehr als 5 Minuten festlegt. Der Deadline Cloud-Monitor bietet einen gewissen Überblick über Mitarbeiter, die in dieser Situation feststecken, erfordert jedoch einen Abgleich der RUNNING Mitarbeiter mit der verfügbaren Arbeit in den zugehörigen Warteschlangen.

Um festsitzende Mitarbeiter zu finden, gehen Sie im Deadline Cloud-Monitor alle Flotten durch und führen Sie die folgenden Schritte durch:

  1. Suchen Sie in der Spalte mit dem Arbeiterstatus nach RUNNING Arbeitern.

  2. Navigiere im Abschnitt Flottendetails zu jeder zugehörigen Warteschlange.

  3. Suchen Sie in jeder zugehörigen Warteschlange nach Jobs, die RUNNINGREADY, oder sindPENDING. Wenn in allen zugehörigen Warteschlangen keine Jobs in diesen Zuständen vorhanden sind, führt der Worker einen Exit der Umgebung durch.

Um zu verhindern, dass ein Worker in diesem Zustand feststeckt, verwenden Sie den folgenden AWS CLI Befehl:

aws deadline update-worker \
    --farm-id $FARM_ID     \
    --fleet-id $FLEET_ID   \
    --worker-id $WORKER_ID \
    --status STOPPED

Nach dem Ausführen des Befehls wird der Worker Agent neu gestartet, wenn das Programm beendet wird. Die Mitarbeiter sind dann wieder online und führen weitere Jobs aus den zugehörigen Warteschlangen aus. Wenn die Warteschlange mehr Jobs mit Zeitüberschreitungen beim Beenden der Umgebung von mehr als 5 Minuten enthält, bleibt der Arbeiter erneut stecken. In diesem Fall müssen Sie diesen Vorgang wiederholen, bis keine Mitarbeiter mehr beim Verlassen feststecken.

Um dieses Problem zu vermeiden, setzen Sie die Timeout-Option auf nicht mehr als 5 Minuten, wenn Sie eine Jobvorlage verwenden.

Fehlerbehebung bei Deadline Cloud-Aufträgen

Informationen zu häufig auftretenden Problemen mit Jobs in AWS Deadline Cloud finden Sie in den folgenden Themen.

Warum ist die Erstellung meines Jobs fehlgeschlagen?

Validierung des Kontingents

Zu den möglichen Gründen, warum ein Job die Validierungsprüfungen nicht bestehen kann, gehören die folgenden:

  • Die Jobvorlage entspricht nicht der OpenJD-Spezifikation.

  • Der Job enthält zu viele Schritte.

  • Der Job enthält insgesamt zu viele Aufgaben.

  • Es ist ein interner Servicefehler aufgetreten, der verhindert, dass der Job erstellt wurde.

Um die Kontingente für die maximale Anzahl von Schritten und Aufgaben in einem Job anzuzeigen, verwenden Sie die Service Contingents-Konsole. Weitere Informationen finden Sie unter Servicekontingente und Drosselung für Deadline Cloud.

CHUNK [INT] -Aufgabenparameterfehler

Wenn die Auftragserstellung mit der folgenden Fehlermeldung fehlschlägt, müssen Sie die TASK_CHUNKING Erweiterung zu Ihrer Jobvorlage hinzufügen.

The CHUNK[INT] task parameter requires the TASK_CHUNKING extension.

Um dieses Problem zu beheben, fügen Sie Ihrer Jobvorlage Folgendes hinzu:

extensions:
  - TASK_CHUNKING

Weitere Informationen finden Sie im AWS Deadline Cloud-Entwicklerhandbuch unter Hinzufügen von Aufgabenblöcken zu einer Jobvorlage.

Warum ist mein Job nicht kompatibel?

Zu den häufigsten Gründen, warum Jobs nicht mit Warteschlangen kompatibel sind, gehören die folgenden:

Deadline Cloud überprüft die Kompatibilität, wenn Sie den Job einreichen. Wenn Sie der Warteschlange später eine kompatible Flotte zuordnen, werden bestehende NOT_COMPATIBLE Jobs nicht automatisch neu gestartet. Um diese Jobs auszuführen, stellen Sie sie in die Warteschlange. Weitere Informationen finden Sie unter Einen Job in die Warteschlange stellen.

Warum steckt mein Job in Ready fest?

Zu den möglichen Gründen, warum Ihr Job im READY Bundesstaat festgefahren zu sein scheint, gehören die folgenden:

Warum ist mein Job gescheitert?

Ein Job kann aus vielen Gründen scheitern. Um nach dem Problem zu suchen, öffnen Sie den Deadline Cloud-Monitor und wählen Sie den fehlgeschlagenen Job aus. Wählen Sie eine Aufgabe aus, die fehlgeschlagen ist, und sehen Sie sich dann die Protokolle für die Aufgabe an. Detaillierte Anweisungen finden Sie unter Sehen Sie sich Sitzungs- und Worker-Logs in Deadline Cloud an.

  • Wenn Lizenzfehler angezeigt werden oder ein Wasserzeichen angezeigt wird, weil die Software keine gültige Lizenz hat, stellen Sie sicher, dass der Worker eine Verbindung zum erforderlichen Lizenzserver herstellen kann. Weitere Informationen finden Sie im Deadline Cloud Developer Guide unter Vom Kunden verwaltete Flotten mit einem Lizenzendpunkt https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/cmf-ubl.html verbinden.

  • Die Aktionsmeldung der letzten Sitzung oder der Prozess-Exit-Code können Informationen darüber enthalten, warum Ihr Job fehlgeschlagen ist. Wenn Sie Folgendes verwenden Windows und Ihr Exit-Code negativ ist, versuchen Sie, nach der unsignierten Version Ihres Exit-Codes zu suchen:

    2,147,483,647 - |your exit code|

Warum scheitert mein Job am Windows wenn meine Dateipfade lang sind?

Jobs können bei Windows Workern fehlschlagen, wenn Ihr Projekt lange Pfade verwendet, obwohl dieselben Dateien auf Ihrer Workstation gerendert werden. Die Dateien werden korrekt übertragen, und der Fehler tritt auf, wenn die Rendering-Anwendung eine öffnet. Zu den Symptomen gehören die folgenden:

  • Die Rendering-Anwendung kann die Szenendatei oder eine ihrer Abhängigkeiten nicht finden, obwohl die Datei zusammen mit dem Job hochgeladen wurde.

  • Ein Aufgabenprotokoll enthält oder eine [WinError 3] The system cannot find the path specified MeldungFileNotFoundError, die einen langen Pfad benennt.

  • Der Job ist erfolgreich, wenn Sie den Namen der Szenendatei kürzen und nichts anderes ändern.

Windowsbegrenzt die meisten Dateipfade auf 260 Zeichen. Zwei Dinge machen es einfacher, dieses Limit auf einer Renderfarm zu erreichen als auf einer Workstation:

  • Die Unterstützung langer Pfade erfolgt pro Anwendung, nicht pro Computer. Windowsberücksichtigt die LongPathsEnabled Registrierungseinstellung nur für Anwendungen, die longPathAware in ihrem Anwendungsmanifest deklariert sind. Wenn Sie sie also auf einem Worker-Host aktivieren, wird das Limit für eine Anwendung, die sie nicht deklariert, nicht erhöht.

  • macOSund Linux erlaubt bis zu 1.024 Zeichen. Wenn Sie also von einer dieser Workstations an eine Windows Flotte senden, können Pfade entstehen, die dort gültig sind, wo Sie sie erstellt haben, und zu lang, wo sie gerendert werden.

Deadline Cloud wendet das Pfadpräfix mit Windows erweiterter Länge auf seine eigenen Dateioperationen an, sodass Übertragung und Upload nicht beeinträchtigt werden. Es kann dieses Präfix nicht in einer Rendering-Anwendung anwenden, die Dateien mit ihrem eigenen Code öffnet, weshalb der Fehler beim Rendern auftritt. Die Verzeichnisnamen für Sitzungen und Auftragsanhänge verwenden ebenfalls einen Teil der 260 Zeichen.

Verwenden Sie eine oder mehrere der folgenden Methoden, um den Fehler zu beheben, und beginnen Sie mit der zuverlässigsten:

  1. Verkürzen Sie die Pfade in Ihrem Projekt. Dieser Ansatz ist der einzige, der für jede Anwendung funktioniert, da er das Limit umgeht, anstatt es zu umgehen.

  2. Verwenden Sie eine Warteschlangenumgebung, die den Pfad, den die Anwendung sieht, verkürzt. Deadline Cloud veröffentlicht ein Beispiel, das das Verzeichnis der Jobanhänge mit einem kurzen Pfad verknüpft und die entsprechenden Pfadzuordnungsregeln bereitstellt. Siehe windows_path_limit_junction_fix.yaml im Repository auf der Website. deadline-cloud-samples GitHub Es wird nur für Integrationen wirksam, die diese Regeln lesen.

  3. Rendern Sie auf einer Linux Flotte, wenn Ihre Software dort verfügbar ist. Linuxunterliegt nicht dem Limit.

Anmerkung

Bei diesen Ansätzen wird das für Ihr Projekt verfügbare Pfadbudget vergrößert, anstatt das Limit von 260 Zeichen aufzuheben. Ein Pfad, der lang genug ist, schlägt immer noch fehl.

Warum steht mein Schritt noch aus?

Schritte können in dem PENDING Zustand bleiben, in dem eine oder mehrere ihrer Abhängigkeiten nicht abgeschlossen sind. Sie können den Status der Abhängigkeiten mithilfe des Deadline Cloud-Monitors überprüfen. Detaillierte Anweisungen finden Sie unter Sehen Sie sich einen Schritt in Deadline Cloud an.

Deadline Cloud überwacht die Protokolle der Desktop-Anwendungen

Die Deadline Cloud Monitor-Desktop-Anwendung schreibt Diagnoseprotokolle, anhand derer Sie Abstürze oder anderes unerwartetes Verhalten untersuchen können. Wenn Sie ein Problem mit der Desktop-Anwendung melden, fügen Sie die entsprechenden Protokolldateien hinzu, um die Diagnose zu erleichtern.

Der Speicherort der Protokolldateien hängt von Ihrem Betriebssystem ab:

Windows
%APPDATA%\com.amazonaws.deadline.monitor\logs
macOS
~/Library/Logs/com.amazonaws.deadline.monitor/
Linux
~/.config/com.amazonaws.deadline.monitor/logs

Weitere Ressourcen

Weitere Informationen und Ressourcen finden Sie in den AWS-Deadline-Repositorys auf der Website. GitHub