View a markdown version of this page

Automatische Downloads - AWS Deadline Cloud

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.

Automatische Downloads

Die Deadline-CLI bietet einen Befehl zum Herunterladen der Ausgabe aller Aufgaben in einer Warteschlange, die seit der letzten Ausführung desselben Befehls abgeschlossen wurden. Sie können dies als Cron-Job oder als geplante Aufgabe so konfigurieren, dass sie wiederholt ausgeführt wird. Diese Konfiguration richtet das automatische Herunterladen der Ausgabe auf kontinuierlicher Basis ein.

Bevor Sie automatische Downloads einrichten, folgen Sie den Schritten unter Speicherprofile für Auftragsanhänge, um alle Pfade der Asset-Daten für das Hoch- und Herunterladen zu konfigurieren. Wenn ein Job einen Ausgabepfad verwendet, der nicht in seinem Speicherprofil enthalten ist, überspringt der automatische Download das Herunterladen dieser Ausgabe und gibt Warnmeldungen aus, um die Dateien zusammenzufassen, die er nicht heruntergeladen hat. Ebenso überspringt der automatische Download den Auftrag, wenn ein Auftrag ohne Speicherprofil eingereicht wird, und es wird eine Warnmeldung ausgegeben. Standardmäßig zeigen Deadline Cloud-Absender Warnmeldungen für Pfade an, die außerhalb der Speicherprofile liegen, um die korrekte Konfiguration sicherzustellen.

Konfigurieren AWS Anmeldedaten

Automatische Downloads verwenden die Deadline-CLI, um kontinuierlich Jobausgaben herunterzuladen. Um diese Downloads zu authentifizieren, benötigen Sie langfristige IAM-Anmeldeinformationen. Deadline Cloud-Monitor-Anmeldeinformationen laufen ab, sodass Sie sie nicht für diesen Zweck verwenden können.

Gehen Sie wie folgt vor, um langfristige Anmeldedaten einzurichten.

Wichtig

Beachten Sie die folgenden Warnungen:

  • Verwenden Sie NICHT die Root-Anmeldeinformationen Ihres Kontos, um auf AWS Ressourcen zuzugreifen. Diese Anmeldeinformationen bieten uneingeschränkten Zugriff auf Konten und können nur schwer widerrufen werden.

  • Fügen Sie KEINE tatsächlichen Zugriffsschlüssel oder Anmeldeinformationen in Ihre Anwendungsdateien ein. Wenn Sie dies tun, riskieren Sie damit, dass Ihre Kontodaten versehentlich offengelegt werden, falls Sie z. B. das Projekt in ein öffentliches Repository hochladen.

  • Fügen Sie KEINE Dateien in Ihrem Projektbereich hinzu, die Anmeldeinformationen enthalten.

  • Sichere deine Zugangsschlüssel. Geben Sie Ihre Zugangsschlüssel nicht an Unbefugte weiter, auch nicht, um Ihre Kontokennungen zu finden. Dadurch kann eine Person permanenten Zugriff auf Ihr Konto erlangen.

  • Beachten Sie, dass alle in der Datei mit den gemeinsam genutzten AWS Anmeldeinformationen gespeicherten Anmeldeinformationen im Klartext gespeichert werden.

Weitere Informationen finden Sie unter Bewährte Methoden für die Verwaltung von AWS Zugriffsschlüsseln in der AWS Allgemeinen Referenz.

Erstellen eines IAM-Benutzers
  1. Öffnen Sie unter https://console.aws.amazon.com/iam/ die IAM-Konsole.

  2. Wählen Sie im Navigationsbereich Benutzer und dann Benutzer erstellen aus.

  3. Nennen Sie den Benutzerdeadline-output-downloader. Deaktivieren Sie das Kontrollkästchen Benutzerzugriff auf gewähren AWS-Managementkonsole und wählen Sie dann Weiter.

  4. Wählen Sie Richtlinien direkt anhängen aus.

  5. Wählen Sie Richtlinie erstellen, um eine benutzerdefinierte Richtlinie mit den erforderlichen Mindestberechtigungen zu erstellen.

  6. Geben Sie im JSON-Editor die folgenden Berechtigungen an:

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "DeadlineCloudOutputDownload", "Effect": "Allow", "Action": [ "deadline:AssumeQueueRoleForUser", "deadline:ListQueueEnvironments", "deadline:ListSessions", "deadline:ListSessionActions", "deadline:SearchJobs", "deadline:GetJob", "deadline:GetQueue", "deadline:GetStorageProfileForQueue" ], "Resource": "*" } ] }
  7. Benennen Sie die Richtlinie DeadlineCloudOutputDownloadPolicy und wählen Sie Create policy aus.

  8. Kehren Sie zur Seite zur Benutzererstellung zurück, aktualisieren Sie die Richtlinienliste, wählen DeadlineCloudOutputDownloadPolicy Sie die gerade erstellte Richtlinie aus, und klicken Sie dann auf Weiter.

  9. Überprüfen Sie die Benutzerdetails und wählen Sie dann Benutzer erstellen aus.

Erstellen eines Zugriffsschlüssels
  1. Wählen Sie auf der Seite mit den Benutzerdetails die Registerkarte Sicherheitsanmeldeinformationen aus. Wählen Sie im Abschnitt Zugriffsschlüssel die Option Zugriffsschlüssel erstellen aus.

  2. Geben Sie an, dass Sie den Schlüssel für „Andere“ verwenden möchten, wählen Sie dann „Weiter“ und anschließend „Zugriffsschlüssel erstellen“.

  3. Wählen Sie auf der Seite „Zugriffsschlüssel abrufen“ die Option „Anzeigen“ aus, um den Wert des geheimen Zugriffsschlüssels Ihres Benutzers anzuzeigen. Sie können die Anmeldeinformationen kopieren oder eine CSV-Datei herunterladen.

Speichern Sie die Benutzerzugriffsschlüssel
  • Speichern Sie die Benutzerzugriffsschlüssel in der Datei mit den AWS Anmeldeinformationen auf Ihrem System:

    • AnLinux, die Datei befindet sich unter ~/.aws/credentials

    • AnWindows, die Datei befindet sich unter %USERPROFILE%\.aws\credentials

    Ersetzen Sie die folgenden Schlüssel:

    [deadline-downloader] aws_access_key_id=ACCESS_KEY_ID aws_secret_access_key=SECRET_ACCESS_KEY region=YOUR_AWS_REGION
Wichtig

Wenn Sie diesen IAM-Benutzer nicht mehr benötigen, empfehlen wir, ihn aus AWS Sicherheitsgründen zu entfernen. Wir empfehlen, dass Sie von Ihren menschlichen Benutzern verlangen, dass sie AWS IAM Identity Center beim Zugriff AWS temporäre Anmeldeinformationen verwenden.

Voraussetzungen

Führen Sie die folgenden Schritte aus, bevor Sie einen Cron-Job oder eine geplante Aufgabe für den automatischen Download erstellen.

  1. Falls Sie es noch nicht getan haben, installieren Sie Python von der Python-Website.

  2. Installieren Sie die Deadline-CLI, indem Sie Folgendes ausführen:

    python -m pip install deadline
  3. Bestätigen Sie mit dem folgenden Befehl, dass die Version der Deadline-CLI 0.52.1 oder neuer ist.

    $ deadline --version deadline, version 0.52.1

    Verwenden Sie Version 0.60.4 oder neuer, um den Download-Status im Deadline Cloud-Monitor anzuzeigen. Diese Version begann mit der Aufzeichnung des Download-Status, den der Monitor anzeigt. Weitere Informationen finden Sie unter Download-Status der Ausgabe in Deadline Cloud anzeigen.

Testen Sie den Befehl zum Herunterladen der Ausgabe

Um zu überprüfen, ob der Befehl in Ihrer Umgebung funktioniert
  1. Rufen Sie den Pfad zu Deadline ab

    Linux and macOS
    $ which deadline
    Windows
    C:\> where deadline
    PowerShell
    PS C:\> Get-Command deadline
  2. Führen Sie den Befehl sync-output für den Bootstrap-Vorgang aus.

    /path/to/deadline queue sync-output \ --profile deadline-downloader \ --farm-id YOUR_FARM_ID \ --queue-id YOUR_QUEUE_ID \ --storage-profile-id YOUR_PROFILE_ID \ --checkpoint-dir /path/to/checkpoint/directory \
  3. Sie müssen diesen Schritt nur ausführen, wenn Ihr herunterladender Computer mit dem Computer identisch ist, der das Gerät sendet. Ersetzen Sie --storage-profile-id YOUR_PROFILE_ID \ oben durch--ignore-storage-profiles.

  4. Reichen Sie einen Testjob ein.

    1. Laden Sie die ZIP-Datei von GitHub herunter.

      1. Öffnen Sie das Deadline-Cloud-Samples-Repository auf der Website. GitHub

      2. Wählen Sie Code und wählen Sie dann im Drop-down-Menü die Option ZIP herunterladen aus.

      3. Entpacken Sie das heruntergeladene Archiv in ein lokales Verzeichnis.

    2. Ausführen

      cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output
    3. Ausführen

      deadline bundle submit .
      1. Wenn Sie nicht über die standardmäßige Deadline-Konfiguration verfügen, müssen Sie möglicherweise Folgendes in der Befehlszeile angeben.

        --farm-id YOUR-FARM-ID --queue-id YOUR-QUEUE-ID
    4. Warten Sie, bis der Job abgeschlossen ist, bevor Sie mit dem nächsten Schritt fortfahren.

  5. Führen Sie den Befehl sync-output erneut aus.

    /path/to/deadline queue sync-output \ --profile deadline-downloader \ --farm-id YOUR_FARM_ID \ --queue-id YOUR_QUEUE_ID \ --storage-profile-id YOUR_PROFILE_ID \ --checkpoint-dir /path/to/checkpoint/directory
  6. Überprüfen Sie Folgendes:

    • Die Ausgaben Ihres Testauftrags werden im Zielverzeichnis angezeigt.

    • Eine Checkpoint-Datei wird in Ihrem angegebenen Checkpoint-Verzeichnis erstellt.

Richten Sie geplante Downloads ein

Wählen Sie den Tab für Ihr Betriebssystem aus, um zu erfahren, wie Sie automatische Downloads für alle 5 Minuten konfigurieren.

Linux
  1. Überprüfen Sie die Deadline CLI-Installation

    Ermitteln Sie den genauen Pfad zu Ihrer ausführbaren Deadline-Datei:

    $ which deadline

    Notieren Sie sich diesen Pfad (z. B./opt/homebrew/bin/deadline) zur Verwendung in der Plist-Datei.

  2. Checkpoint-Verzeichnis erstellen

    Erstellen Sie das Verzeichnis, in dem Checkpoint-Dateien gespeichert werden. Stellen Sie sicher, dass Ihr Benutzer die richtigen Berechtigungen hat, um den Befehl auszuführen.

    $ mkdir -p /path/to/checkpoint/directory
  3. Protokollverzeichnis erstellen

    Erstellen Sie ein Verzeichnis für Cron-Job-Logs:

    $ mkdir -p /path/to/logs

    Erwägen Sie, Log Rotate in der Logdatei einzurichten mit https://www.redhat.com/en/blog/setting-logrotate

  4. Überprüfen Sie Current Crontab

    Sehen Sie sich Ihr aktuelles Crontab an, um bestehende Jobs zu sehen:

    $ crontab -l
  5. Crontab bearbeiten

    Öffnen Sie Ihre Crontab-Datei zur Bearbeitung:

    $ crontab -e

    Wenn Sie den Befehl zum ersten Mal ausführen, werden Sie möglicherweise aufgefordert, einen Editor auszuwählen (nano, vim usw.).

  6. Fügen Sie einen Cron-Job-Eintrag hinzu

    Fügen Sie die folgende Zeile hinzu, um den Job alle 5 Minuten auszuführen (ersetzen Sie die Pfade durch die tatsächlichen Werte aus den Schritten 1 und 2):

    */5 * * * * /path/to/deadline queue sync-output --profile deadline-downloader --farm-id YOUR_FARM_ID --queue-id YOUR_QUEUE_ID --storage-profile-id YOUR_PROFILE_ID --checkpoint-dir /path/to/checkpoint/directory >> /path/to/logs/deadline_sync.log 2>&1
  7. Überprüfen Sie die Cron-Job-Installation

    Stellen Sie nach dem Speichern und Beenden des Editors sicher, dass der Cron-Job hinzugefügt wurde:

    $ crontab -l

    Ihr neuer Job sollte in der Liste aufgeführt sein.

  8. Überprüfen Sie den Cron-Dienststatus

    Stellen Sie sicher, dass der Cron-Dienst läuft:

    # For systemd systems (most modern Linux distributions) $ sudo systemctl status cron # or $ sudo systemctl status crond # For older systems $ sudo service cron status

    Wenn er nicht läuft, starte ihn:

    $ sudo systemctl start cron $ sudo systemctl enable cron # Enable auto-start on boot
macOS
  1. Überprüfen Sie die Deadline CLI-Installation

    Ermitteln Sie den genauen Pfad zu Ihrer ausführbaren Deadline-Datei:

    $ which deadline

    Notieren Sie sich diesen Pfad (z. B./opt/homebrew/bin/deadline) zur Verwendung in der Plist-Datei.

  2. Erstellen Sie das Checkpoint-Verzeichnis und das Protokollverzeichnis

    Erstellen Sie das Verzeichnis, in dem Checkpoint-Dateien gespeichert werden:

    $ mkdir -p /path/to/checkpoint/directory $ mkdir -p /path/to/logs

    Erwägen Sie, Log Rotate für die Protokolldatei einzurichten, indem Sie https://formulae.brew.sh/formula/logrotate

  3. Erstellen Sie eine Plist-Datei

    Erstellen Sie eine Konfigurationsdatei unter ~/Library/LaunchAgents/com.user.deadlinesync.plist mit dem folgenden Inhalt (ersetzen Sie sie durch /path/to/deadline den tatsächlichen Pfad aus Schritt 1):

    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.user.deadlinesync</string> <key>ProgramArguments</key> <array> <string>/path/to/deadline</string> <string>queue</string> <string>sync-output</string> <string>--profile</string> <string>deadline-downloader</string> <string>--farm-id</string> <string>YOUR_FARM_ID</string> <string>--queue-id</string> <string>YOUR_QUEUE_ID</string> <string>--storage-profile-id</string> <string>YOUR STORAGE PROFILE ID</string> <string>--checkpoint-dir</string> <string>/path/to/checkpoint/dir</string> </array> <key>RunAtLoad</key> <true/> <key>UserName</key> <string>YOUR_USER_NAME</string> <key>StandardOutPath</key> <string>/path/to/logs/deadline_sync.log</string> <key>StartInterval</key> <integer>300</integer> </dict> </plist>

    Ersetzen Sie die --storage-profile-id YOUR_PROFILE_ID obigen Angaben durch--ignore-storage-profiles, wenn Ihr herunterladender Computer mit dem Computer identisch ist, der das Gerät sendet.

  4. Plist-Datei validieren

    Validieren Sie die XML-Syntax Ihrer Plist-Datei:

    $ plutil -lint ~/Library/LaunchAgents/com.user.deadlinesync.plist

    Der Befehl gibt „OK“ zurück, wenn die Datei gültig ist.

  5. Suchen Sie nach vorhandenen Launch Agents oder Launch Daemons

    Prüfen Sie, ob ein Launch Agent bereits geladen ist:

    $ launchctl list | grep deadlinesync OR $ sudo launchctl list | grep deadlinesync

    Falls einer existiert, entladen Sie ihn zuerst:

    $ launchctl bootout gui/$(id -u)/com.user.deadlinesync OR $ sudo launchctl bootout system/com.user.deadlinesync
  6. Erstellen und Bootstrappen

    Um diese Aufgabe auszuführen, während der Benutzer angemeldet ist, führen Sie sie als LaunchAgent aus. Um diese Aufgabe auszuführen, ohne dass bei jeder Ausführung des Computers ein Benutzer angemeldet ist, führen Sie sie als aus LaunchDaemon.

    1. Um es auszuführen als LaunchAgent:

      1. Verwenden Sie die Konfiguration, die unter erstellt wurde ~/Library/LaunchAgents/com.user.deadlinesync.plist

      2. Laden Sie dann die Konfiguration mit dem Bootstrap-Befehl:

        $ launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.user.deadlinesync.plist
    2. Um es auszuführen als LaunchDaemon:

      1. Verschieben Sie die Pilst-Datei und ändern Sie die Berechtigungen, indem Sie Folgendes ausführen:

        $ sudo mv ~/Library/LaunchAgents/com.user.deadlinesync.plist /Library/LaunchDaemons/ $ sudo chown root:wheel /Library/LaunchDaemons/com.user.deadlinesync.plist $ sudo chmod 644 /Library/LaunchDaemons/com.user.deadlinesync.plist
      2. Laden Sie den Launch-Agent mit dem modernen Bootstrap-Befehl:

        $ sudo launchctl bootstrap system /Library/LaunchDaemons/com.user.deadlinesync.plist
  7. Status überprüfen

    Wenn Sie einen Bootstrap LaunchAgent ausgeführt haben, führen Sie Folgendes aus, um zu bestätigen, dass es geladen ist:

    $ launchctl list | grep deadlinesync

    Wenn Sie einen Bootstrapping durchgeführt haben LaunchDaemon, überprüfen Sie, ob er geladen ist, indem Sie Folgendes ausführen:

    $ sudo launchctl list | grep deadlinesync

    Die Ausgabe sollte wie folgt aussehen

    SOME_PID_NUMBER 0 com.user.deadlinesync

    Für detaillierte Statusinformationen:

    $ launchctl print gui/$(id -u)/com.user.deadlinesync

    Hier werden der aktuelle Status, Programmargumente, Umgebungsvariablen, das Ausführungsintervall und der Ausführungsverlauf angezeigt.

Windows
Anmerkung

Die mit diesen Anweisungen erstellte geplante Aufgabe funktioniert nur, wenn der Benutzer angemeldet ist.

Informationen zur Einrichtung beim Systemstart, ohne dass eine Benutzeranmeldung erforderlich ist, finden Sie in der offiziellen Windows Dokumentation auf der Microsoft-Website.

Verwenden Sie für alle folgenden Schritte die Eingabeaufforderung — als Administrator ausführen:

  1. Überprüfen Sie die Deadline CLI-Installation

    Suchen Sie nach der ausführbaren Deadline-Datei:

    C:\> where deadline

    Notieren Sie sich den vollständigen Pfad (z. B.C:\Program Files\Amazon\DeadlineCloud\deadline.exe) zur Verwendung in der Aufgabe.

  2. Checkpoint-Verzeichnis erstellen

    Erstellen Sie das Verzeichnis, in dem Checkpoint-Dateien gespeichert werden:

    C:\> mkdir "path\to\checkpoint\directory"
  3. Protokollverzeichnis erstellen

    Erstellen Sie ein Verzeichnis für Aufgabenprotokolle:

    C:\> mkdir "path\to\logs"
  4. Erstellen Sie einen Batch File Wrapper

    Erstellen Sie die Batch-Datei mit dem folgenden Inhalt:

    C:\> notepad C:\path\to\deadline_sync.bat
    YOUR_PATH_TO_DEADLINE.EXE queue sync-output --profile deadline-downloader --farm-id YOUR_FARM_ID --queue-id YOUR_QUEUE_ID --storage-profile-id YOUR_PROFILE_ID --checkpoint-dir path\to\checkpoint\checkpoints > path\to\logs\deadline.log 2>&1
  5. Batch-Datei testen

    Testen Sie die Batch-Datei manuell:

    C:\> .\path\to\deadline_sync.bat

    Überprüfen Sie, ob die Protokolldatei erstellt wurde:

    C:\> notepad path\to\logs\deadline_sync.log
  6. Überprüfen Sie den Taskplaner-Dienst

    Stellen Sie sicher, dass der Taskplaner-Dienst ausgeführt wird:

    C:\> sc query "Schedule"

    Wenn der Dienst nicht existiert, versuchen Sie es mit alternativen Namen:

    C:\> sc query "TaskScheduler" C:\> sc query "Task Scheduler"

    Wenn er nicht läuft, starte ihn:

    C:\> sc start "Schedule"
  7. Geplante Aufgabe erstellen

    Erstellen Sie die Aufgabe, die alle 5 Minuten ausgeführt wird.

    C:\> schtasks /create /tn "DeadlineOutputSync" /tr "C:\path\to\deadline_sync.bat" /sc minute /mo 5

    Aufschlüsselung der Befehle:

    • /tn- Name der Aufgabe

    • /tr- Auszuführende Aufgabe (Ihre Batch-Datei)

    • /sc minute /mo 5- Zeitplan: alle 5 Minuten

  8. Überprüfen Sie die Aufgabenerstellung

    Prüfen Sie, ob die Aufgabe erfolgreich erstellt wurde:

    schtasks /query /tn "DeadlineOutputSync" /v /fo LIST

    Suchen Sie nach:

    • Auszuführende Aufgabe: Sollte Ihren Batch-Dateipfad anzeigen

    • Nächste Laufzeit: Sollte eine Zeit innerhalb von 5 Minuten anzeigen

  9. Ausführung der Testaufgabe

    Führen Sie die Aufgabe manuell aus, um Folgendes zu testen:

    schtasks /run /tn "DeadlineOutputSync"

    Überprüfen Sie den Aufgabenstatus:

    schtasks /query /tn "DeadlineOutputSync"
Überprüfen Sie das Setup

Gehen Sie wie folgt vor, um zu überprüfen, ob die Einrichtung der automatischen Downloads erfolgreich war.

  1. Reichen Sie einen neuen Testjob ein.

  2. Warten Sie, bis ein Scheduler-Intervall abgeschlossen ist. In diesem Fall sind es 5 Minuten.

  3. Stellen Sie sicher, dass neue Ausgaben automatisch heruntergeladen werden.

Wenn die Ausgaben nicht heruntergeladen werden, finden Sie im Abschnitt zur Problembehandlung die Prozessprotokolle.

Problembehandlung bei automatischen Downloads

Wenn Sie Probleme mit den automatischen Downloads haben, überprüfen Sie Folgendes:

Laden Sie die Fehlercodes herunter

Wenn ein Download fehlschlägt, wird in der Spalte Download-Status im Deadline Cloud-Monitor der Grund angegeben, und der deadline queue sync-output Befehl zeichnet einen der folgenden Fehlercodes auf. Die meisten dieser Fehler werden auf dem Computer behoben, auf dem der Download-Befehl ausgeführt wird. Dabei handelt es sich häufig um einen anderen Computer als den, auf dem Sie den Monitor anzeigen.

PERMISSION_DENIED(Erlaubnis verweigert)

Der Downloader darf nicht in das Ausgabeverzeichnis schreiben, oder seinen AWS Anmeldeinformationen wurde der Zugriff verweigert. Gewähren Sie dem Benutzer, der den Download-Befehl ausführt, Schreibzugriff auf das Ausgabeverzeichnis, stellen Sie sicher, dass das AWS Befehlsprofil Zugriff auf die Warteschlange hat, und führen Sie den Befehl erneut aus.

DISK_FULL(Festplatte voll)

Auf dem Computer, auf dem der Download ausgeführt wurde, ging der Speicherplatz aus. Geben Sie Speicherplatz auf dem Laufwerk frei, auf dem sich das Ausgabeverzeichnis befindet, und führen Sie den Befehl erneut aus.

PATH_NOT_FOUND(Pfad nicht gefunden)

Das Ausgabeziel existiert nicht oder ist nicht auf dem Computer gemountet, auf dem der Download ausgeführt wird. Erstellen Sie das Verzeichnis oder mounten Sie das gemeinsam genutzte Laufwerk und führen Sie den Befehl dann erneut aus.

NETWORK_ERROR(Netzwerkfehler)

Eine Netzwerkunterbrechung hat die Übertragung gestoppt. Netzwerkfehler sind in der Regel vorübergehend. Führen Sie den Befehl erneut aus und überprüfen Sie die Konnektivität des Geräts, falls sich der Fehler wiederholt.

UNKNOWN(Fehlgeschlagen)

Der Downloader konnte keine bestimmte Ursache identifizieren. Auf dem Monitor wird für diesen Code und für jeden Code, den er nicht erkennt, die Meldung Fehlgeschlagen angezeigt. Überprüfen Sie die Protokollausgabe des deadline queue sync-output Befehls auf den zugrunde liegenden Fehler.

Ein Auftrag, dessen Download fehlschlägt, wird bei jeder späteren Ausführung automatisch erneut versucht. Nach fünf fehlgeschlagenen Versuchen stoppt der Downloader die Wiederholung des Auftrags und gibt eine Warnung aus. Nachdem Sie die Ursache behoben haben, stellen Sie den Auftrag wieder her, indem Sie den Download-Befehl mit einem Lookback-Fenster ausführen, das anzeigt, wann der Auftrag abgeschlossen ist:

deadline queue sync-output --farm-id FARM_ID --queue-id QUEUE_ID \ --storage-profile-id STORAGE_PROFILE_ID \ --force-bootstrap --bootstrap-lookback-minutes 1440

Übergeben Sie beide Flaggen zusammen. Die --bootstrap-lookback-minutes Option ist standardmäßig --force-bootstrap auf 0 gesetzt, sodass für sich genommen nichts wiederhergestellt wird.

Warum wurde mein Job übersprungen?

Wenn der Downloader einen Job überspringt, wird in der Spalte Download-Status der Grund direkt in der Zelle angegeben:

Keine Anlagen () no_attachments

Der Job wurde nicht mit Anhängen zum Job eingereicht, daher gibt es keine aufgezeichneten Ausgabedateien zum Herunterladen. Bei einigen Aufträgen wird nie eine herunterladbare Ausgabe erzeugt, sodass bei einem übersprungenen Auftrag ohne Anlagen in der Regel keine Aktion erforderlich ist.

Speicherprofil () missing_storage_profile fehlt

Der Job wurde ohne Speicherprofil übermittelt, obwohl der Download-Befehl eines verwendet, sodass der Downloader nicht weiß, wo die Dateien des Jobs auf jedem Computer hingehören. Für den Job wird nichts heruntergeladen, bis ein Speicherprofil dafür konfiguriert ist. Das Speicherprofil eines Jobs wird festgelegt, wenn der Job gesendet wird. Senden Sie den Job also mit einem Speicherprofil und übergeben Sie dasselbe Profil an den Download-Befehl. In der Aufgabentabelle ist der Status Fehlendes Speicherprofil ein Link, der eine Erklärung, einen Link zur Dokumentation und eine Schaltfläche zur Problembehandlung mit KI öffnet. Weitere Informationen finden Sie unter Speicherprofile für Jobanhänge.

Ein Auftrag, der ohne Angabe eines Grundes übersprungen wurde, wurde vor der Produktion storniert oder gestoppt. Es muss nichts unternommen werden.

Ist es ein Download-Problem oder ein Renderproblem?

Ein Problem in der Download-Status-Spalte einer Aufgabe kann zwei verschiedene Dinge bedeuten, und es gibt unterschiedliche Lösungen. Der Statustext sagt Ihnen, welchen Sie haben:

  • Keine Ausgaben für eine Aufgabe, deren Ausführungsstatus lautet, FAILED bedeutet, dass die Aufgabe in der Farm nicht gerendert werden konnte. Es wurde nie eine Datei produziert, es gab also nichts zum Herunterladen. Ihr Laufwerk und Ihr Netzwerk sind in Ordnung. Suchen Sie in den Protokollen der Aufgabe nach dem Renderfehler, beheben Sie ihn und stellen Sie die Aufgabe erneut in die Warteschlange. Eine Aufgabe kann auch nach erfolgreichem Abschluss ohne das Schreiben von Dateien die Meldung Keine Ausgaben anzeigen. Das ist normal und erfordert keine Aktion.

  • Ein Fehlername wie Permission denied bedeutet, dass die Aufgabe gerendert wurde und ihre Ausgabe existiert und das Kopieren der Dateien in Ihr Dateisystem fehlgeschlagen ist. Beheben Sie den Fehler mitLaden Sie die Fehlercodes herunter.

In der Jobtabelle werden beide Probleme als rotes Segment in der Fortschrittsleiste für das Herunterladen des Jobs angezeigt. Öffnen Sie die Aufgabentabelle des Jobs, um sie voneinander zu unterscheiden. Bei einem Job, bei dem jede Aufgabe fehlgeschlagen ist, wird anstelle eines Download-Fehlers ein Bindestrich angezeigt, da der Job nie eine Ausgabe generiert hat. In der eigenen Statusspalte des Jobs wird dieser Fehler gemeldet. Die Diagnose des Downloads in diesen Fällen, in denen das Rendern fehlschlägt, verschwendet Zeit. Überprüfen Sie daher immer zuerst den Ausführungsstatus der Aufgabe.

Beheben Sie Probleme mit KI

Die Download-Fehlermeldungen im Deadline Cloud-Monitor, einschließlich der roten Anzeige für Output-Synchronisierung nicht erfolgreich, enthalten eine Schaltfläche „Problembehandlung mit KI“. Die Schaltfläche öffnet den Deadline Cloud-Assistenten, der den Download-Statusdatensatz für Ihre Warteschlange liest und Sie durch Ihren spezifischen Fehler führt, einschließlich der Befehle, die zur Behebung des Fehlers ausgeführt werden müssen.

Greifen Sie darauf zu, wenn ein Download immer wieder fehlschlägt, nachdem Sie versucht haben, seinen Fehlercode zu beheben, wenn Sie einen Fehler sehen, den Sie nicht erkennen, oder wenn Sie sich nicht sicher sind, auf welchem Computer das Problem liegt. Die Schaltfläche erscheint, wenn der Deadline Cloud-Assistent für Ihren Monitor aktiviert ist. Weitere Informationen finden Sie unter Deadline Cloud-Assistent.

Probleme mit dem Speicherprofil

  • Ein Fehler wie [Errno 2] No such file or directory oder [Errno 13] Permission denied in der Protokolldatei könnte mit fehlenden oder falsch konfigurierten Speicherprofilen zusammenhängen.

  • Unter Speicherprofile finden Sie Informationen darüber, wie Sie Ihre Speicherprofile einrichten, wenn sich der herunterladende Computer vom sendenden Computer unterscheidet.

  • Für Downloads auf demselben Computer versuchen Sie es mit der --ignore-storage-profiles Flagge.

Verzeichnisberechtigungen

  • Stellen Sie sicher, dass der Benutzer des Scheduler-Service über Folgendes verfügt:

    • Read/write Zugriff auf das Checkpoint-Verzeichnis

    • Schreibzugriff auf das Ausgabe-Zielverzeichnis

  • Verwenden Sie für Linux undmacOS, ls -la um die Berechtigungen zu überprüfen.

  • Überprüfen Sie zum Windows Beispiel die Sicherheitseinstellungen im Eigenschaftenordner.

Die Scheduler-Protokolle werden überprüft

Linux
  1. Prüfen Sie, ob der Cron-Dienst läuft:

    # For systemd systems $ sudo systemctl status cron # or $ sudo systemctl status crond # Check if your user has cron job correctly configured $ crontab -l
  2. Cron-Ausführungsprotokolle anzeigen:

    # Check system logs for cron activity (most common locations) $ sudo tail -f /var/log/syslog | grep CRON $ sudo tail -f /var/log/cron.log | grep deadline # View recent cron logs $ sudo journalctl -u cron -f $ sudo journalctl -u crond -f # On some systems
  3. Überprüfen Sie Ihre spezifischen Cron-Job-Protokolle:

    # View the log file specified in your cron job $ tail -100f /path/to/logs/deadline_sync.log
  4. Suchen Sie in den Systemprotokollen nach der Ausführung von Cron-Jobs:

    # Look for your specific cron job executions $ sudo grep "deadline.*sync-output" /var/log/syslog # Check for cron job starts and completions $ sudo grep "$(whoami).*CMD.*deadline" /var/log/syslog
  5. Überprüfen Sie die Aktualisierungen der Checkpoint-Dateien:

    # List checkpoint files with timestamps $ ls -la /path/to/checkpoint/directory/ # Check when checkpoint was last modified $ stat /path/to/checkpoint/directory/queue-*_download_checkpoint.json
  6. Überprüfen Sie die Protokolldatei:

    $ ls -la /path/to/log/deadline_sync.log
macOS

Ausführungsprotokolle des Launch Agents anzeigen:

  1. Prüfen Sie, ob der Launch Agent läuft:

    $ sudo launchctl list | grep deadlinesync

    Die Ausgabe zeigt: PID Status Label (Die PID wird angezeigt, - wenn sie gerade nicht ausgeführt wird, was bei Intervalljobs normal ist)

  2. Detaillierten Status des Launch-Agents anzeigen:

    $ sudo launchctl print system/com.user.deadlinesync

    Hier werden der Ausführungsverlauf, der letzte Exit-Code, die Anzahl der Läufe und der aktuelle Status angezeigt.

  3. Sehen Sie sich die Ausführungsprotokolle des Launch Agents an:

    # View recent logs (last hour) log show --predicate 'subsystem contains "com.user.deadlinesync"' --last 1h # View logs from a specific time period log show --predicate 'subsystem contains "com.user.deadlinesync"' --start '2024-08-27 09:00:00'
  4. Erzwingen Sie die Ausführung des Launch-Agenten zum sofortigen Testen:

    $ sudo launchctl kickstart gui/$(id -u)/com.user.deadlinesync

    Dadurch wird der Job unabhängig vom Zeitplan sofort ausgelöst, was für Tests nützlich ist.

  5. Überprüfen Sie die Aktualisierungen der Checkpoint-Dateien:

    # List checkpoint files with timestamps $ ls -la /path/to/checkpoint/directory/
  6. Überprüfen Sie die Protokolldatei:

    $ ls -la /path/to/log/deadline_sync.log
Windows
  1. Prüfen Sie, ob der Taskplaner-Dienst läuft:

    C:\> sc query "Schedule"

    Wenn der Dienst nicht existiert, versuchen Sie es mit alternativen Namen:

    C:\> sc query "TaskScheduler" C:\> sc query "Task Scheduler"
  2. Sehen Sie sich Ihre geplanten Aufgaben an:

    C:> schtasks /query /tn "DeadlineOutputSync"
  3. Überprüfe die Logdatei deiner Aufgabe:

    # View the log file created by your batch script C:> notepad C:\path\to\logs\deadline_sync.log
  4. Überprüfen Sie die Aktualisierungen der Checkpoint-Datei:

    # List checkpoint files with timestamps C:> dir "C:\path\to\checkpoint\directory" /od