Automatische Downloads

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

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

   $ which deadline

   Notieren Sie sich diesen Pfad (z. B./opt/homebrew/bin/deadline) für die 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 über die erforderlichen Berechtigungen verfügt, 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 Rotation für die Protokolldatei mit https://www.redhat.com/en/ blog/setting-logrotate einzurichten

4. Überprüfen Sie den aktuellen Crontab

   Sehen Sie sich Ihren aktuellen Crontab an, um bestehende Jobs zu sehen:

   $ crontab -l

5. Bearbeiten Sie Crontab

   Öffnen Sie Ihre Crontab-Datei zur Bearbeitung:

   $ crontab -e

   Wenn dies Ihr erstes Mal ist, werden Sie möglicherweise aufgefordert, einen Editor (Nano, Vim usw.) auszuwählen.

6. Cron-Jobeintrag hinzufügen

   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 * * * * AWS_PROFILE=deadline-downloader /path/to/deadline queue sync-output --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 Cronjob hinzugefügt wurde:

   $ crontab -l

   Ihr neuer Job sollte 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 es nicht läuft, starte es:

   $ sudo systemctl start cron
   $ sudo systemctl enable cron  # Enable auto-start on boot

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

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

   $ which deadline

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

2. Erstellen Sie ein Checkpoint-Verzeichnis und ein 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 die Einrichtung von Log Rotation für die Protokolldatei mithilfe von 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>--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>EnvironmentVariables</key>
       <dict>
       <key>AWS_PROFILE</key>
       <string>deadline-downloader</string>
       </dict>
       <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 derselbe ist wie Ihr sendender Computer.

4. Plist-Datei validieren

   Überprüfen Sie die XML-Syntax Ihrer Plist-Datei:

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

   Dies sollte „OK“ zurückgeben, 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 booten

   Um diese Aufgabe auszuführen, während der Benutzer angemeldet ist, führen Sie sie als LaunchAgentaus. Um diese Aufgabe auszuführen, ohne dass ein Benutzer jedes Mal angemeldet ist, wenn der Computer ausgeführt wird, 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. Zum Ausführen als LaunchDaemon:

      1. Verschieben Sie die Datei Pilst und ändern Sie die Berechtigungen, indem Sie den folgenden Befehl 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 ein Bootstrapping durchgeführt haben, LaunchAgent führen Sie Folgendes aus, um zu überprüfen, ob es geladen ist:

   $ launchctl list | grep deadlinesync

   Wenn Sie einen Bootstrapping ausgeführt haben, vergewissern Sie sich, dass er geladen ist LaunchDaemon, 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, die Programmargumente, die Umgebungsvariablen, das Ausführungsintervall und der Ausführungsverlauf angezeigt.

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

   Suchen Sie nach der ausführbaren Deadline:

   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 Task-Logs:

   C:\> mkdir "path\to\logs"

4. Batch-Datei-Wrapper erstellen

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

   Prü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

   Überprü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 Uhrzeit 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 Status der Aufgabe:

   schtasks /query /tn "DeadlineOutputSync"

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.*incremental-output-download" /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
          

Ausführungsprotokolle für den Launch Agent 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-Agenten 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. Ausführungsprotokolle des Launch-Agents anzeigen:

   
   # 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 für sofortige Tests:

   
   $ 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
          

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. Prüfen Sie die Protokolldatei Ihrer 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-Dateien:

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