Configure credentials Prerequisites Test the output download command Set up scheduled downloads Troubleshooting

Automatic downloads

The Deadline CLI provides a command to download the output of all tasks in a queue that completed since the last time the same command ran. You can configure this as a cron job or scheduled task to run repeatedly. This creates automatic downloading of output on a continuous basis.

Before setting up automatic downloads, follow the steps in Storage profiles for job attachments to configure all paths of asset data for upload and download. If a job uses an output path that is not in its storage profile, then the automatic download skips downloading that output and prints warning messages to summarize the files it did not download. Similarly, if a job is submitted without a storage profile, the automatic download skips that job and prints a warning message. By default, Deadline Cloud submitters display warning messages for paths that are outside of storage profiles to help ensure correct configuration.

Configuring AWS credentials

If you want to run the output synchronization command manually, or to understand how it works before configuring it as a cron job, you can use the credentials from logging in to the Deadline Cloud monitor desktop application.

On-premises AWS credentials

Your on-premises workers use credentials to access Deadline Cloud job attachments output. For the most secure access, we recommend using IAM Roles Anywhere to authenticate your workers. For more information, see IAM Roles Anywhere.

For testing, you can use IAM user access keys for AWS credentials. We recommend that you set an expiration for the IAM user by including a restrictive inline policy.

Important

Heed the following warnings:

Do NOT use your account's root credentials to access AWS resources. These credentials provide unrestricted account access and are difficult to revoke.
Do NOT put literal access keys or credential information in your application files. If you do, you create a risk of accidentally exposing your credentials if, for example, you upload the project to a public repository.
Do NOT include files that contain credentials in your project area.
Secure your access keys. Do not provide your access keys to unauthorized parties, even to help find your account identifiers. By doing this, you might give someone permanent access to your account.
Be aware that any credentials stored in the shared AWS credentials file are stored in plain text.

For more details, see Best practices for managing AWS access keys in the AWS General Reference.

Create an IAM user

Open the IAM console at https://console.aws.amazon.com/iam/.
In the navigation pane, select Users and then select Create user.
Name the user deadline-output-downloader. Clear the checkbox for Provide user access to the AWS Management Console, then choose Next.
Choose Attach policies directly.
Choose Create policy to create a custom policy with minimum required permissions.

In the JSON editor, specify the following permissions:

Name the policy DeadlineCloudOutputDownloadPolicy and choose Create policy.
Return to the user creation page, refresh the policy list, and select the DeadlineCloudOutputDownloadPolicy you just created, then choose Next.
Review the user details and then choose Create user.

Restrict user access to a limited time window

Any IAM user access keys that you create are long-term credentials. To ensure that these credentials expire in case they are mishandled, you can make these credentials time-bound by creating an inline policy that specifies a date after which the keys will no longer be valid.

Open the IAM user that you just created. In the Permissions tab, choose Add permissions and then choose Create inline policy.

In the JSON editor, specify the following permissions. To use this policy, replace the aws:CurrentTime timestamp value in the example policy with your own time and date.

Create an access key

From the user details page, select the Security credentials tab. In the Access keys section, choose Create access key.
Indicate that you want to use the key for Other, then choose Next, then choose Create access key.
On the Retrieve access keys page, choose Show to reveal the value of your user's secret access key. You can copy the credentials or download a .csv file.

Store the user access keys

Store the user access keys in the AWS credentials file on your system:
- On Linux, the file is located at ~/.aws/credentials
- On Windows, the file is located at %USERPROFILE\.aws\credentials
Replace the following keys:
```
[deadline-downloader]
aws_access_key_id=ACCESS_KEY_ID
aws_secret_access_key=SECRET_ACCESS_KEY
region=YOUR_AWS_REGION
```
To use these credentials at all times, set the env variables AWS_PROFILE to deadline-downloader.

Important

When you no longer need this IAM user, we recommend that you remove it to align with the AWS security best practice. We recommend that you require your human users to use temporary credentials through AWS IAM Identity Center when accessing AWS.

Prerequisites

Complete the following steps before creating a cron job or scheduled task for automatic download.

If you haven't already, install Python.
Install the Deadline CLI by running:
```
python -m pip install deadline
```
Confirm the version of the Deadline CLI is 0.52.1 or newer with the following command.
```
$ deadline --version
deadline, version 0.52.1
```

Test the output download command

To verify the command works in your environment

Get the path to Deadline

Run the sync-output command to bootstrap.


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

You only need to do this step if your downloading machine is the same as submitting machine. Replace --storage-profile-id YOUR_PROFILE_ID \ above with --ignore-storage-profiles.
Submit a test job.
1. Download the .zip file from GitHub.
  1. Open the deadline-cloud-samples GitHub repository.
  2. Choose Code and then, from the dropdown menu, select Download ZIP.
  3. Unzip the downloaded archive to a local directory.
2. Run
```
 cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output
```
3. Run
```
deadline bundle submit .
```
  1. If you don’t have the default deadline config setup, you might need to supply the following in the command line.
```
--farm-id YOUR-FARM-ID --queue-id YOUR-QUEUE-ID
```
4. Wait for the job to complete before going to the next step.

Run the sync-output command again.


 /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

Verify the following:
- Your test job's outputs appear in the destination directory.
- A checkpoint file is created in your specified checkpoint directory.

Set up scheduled downloads

Select the tab for your operating system to learn how to configure automatic downloads for every 5 minutes.

Linux

Verify Deadline CLI Installation

Get the exact path to your deadline executable:
```
$ which deadline
```
Note this path (e.g., /opt/homebrew/bin/deadline) for use in the plist file.
Create Checkpoint Directory

Create the directory where checkpoint files will be stored. Ensure proper permissions for your user to run the command.
```
$ mkdir -p /path/to/checkpoint/directory
```
Create Log Directory

Create a directory for cron job logs:
```
$ mkdir -p /path/to/logs
```
Consider setting up log rotate on the log file using https://www.redhat.com/en/blog/setting-logrotate
Check Current Crontab

View your current crontab to see existing jobs:
```
$ crontab -l
```
Edit Crontab

Open your crontab file for editing:
```
$ crontab -e
```
If this is your first time, you may be prompted to choose an editor (nano, vim, etc.).

Add Cron Job Entry

Add the following line to run the job every 5 minutes (replace paths with actual values from steps 1 and 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

Verify Cron Job Installation

After saving and exiting the editor, verify the cron job was added:
```
$ crontab -l
```
You should see your new job listed.

Check Cron Service Status

Ensure the cron service is running:


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

# For older systems
$ sudo service cron status

If not running, start it:


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

macOS

Verify Deadline CLI Installation

Get the exact path to your deadline executable:
```
$ which deadline
```
Note this path (e.g., /opt/homebrew/bin/deadline) for use in the plist file.
Create Checkpoint Directory and Log Directory

Create the directory where checkpoint files will be stored:
```
$ mkdir -p /path/to/checkpoint/directory
$ mkdir -p /path/to/logs
```
Consider setting up log rotate on the log file using https://formulae.brew.sh/formula/logrotate

Create a Plist file

Create a configuration file at ~/Library/LaunchAgents/com.user.deadlinesync.plist with the following content (replace /path/to/deadline with the actual path from step 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>

Replace --storage-profile-id YOUR_PROFILE_ID above with --ignore-storage-profiles if your downloading machine is the same as submitting machine

Validate Plist File

Validate the XML syntax of your plist file:
```
$ plutil -lint ~/Library/LaunchAgents/com.user.deadlinesync.plist
```
This should return "OK" if the file is valid.

Check for Existing Launch Agents or Launch Daemons

Check if a launch agent is already loaded:


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

If one exists, unload it first:


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

Create and bootstrap

To run this task while the user is logged in, run it as LaunchAgent. To run this task without a user being logged in every time the machine is running, run it as a LaunchDaemon.
1. To run as LaunchAgent:
  1. Use the configuration created under ~/Library/LaunchAgents/com.user.deadlinesync.plist
  2. Then load the configuration using the bootstrap command:
```
$ launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.user.deadlinesync.plist
```
2. To run as LaunchDaemon:
  1. Move the Pilst file and change permissions by running the following:
```
$ 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. Load the launch agent using the modern bootstrap command:
```
$ sudo launchctl bootstrap system /Library/LaunchDaemons/com.user.deadlinesync.plist
```
Verify Status

If you bootstrapped a LaunchAgent run the following to confirm it's loaded:
```
$ launchctl list | grep deadlinesync
```
If you bootstrapped a LaunchDaemon, confirm it is loaded by running:
```
$ sudo launchctl list | grep deadlinesync
```
The output should look like
```
SOME_PID_NUMBER 0 com.user.deadlinesync
```
For detailed status information:
```
$ launchctl print gui/$(id -u)/com.user.deadlinesync
```
This shows the current state, program arguments, environment variables, run interval, and execution history.

Windows

Note

The scheduled task created using these instructions only work when the user is logged in.

To set it up at system startup without requiring user login, see the official Windows documentation.

For all steps below use Command Prompt - run as Administrator:

Verify Deadline CLI Installation

Find the deadline executable:
```
C:\> where deadline
```
Note the full path (e.g., C:\Program Files\Amazon\DeadlineCloud\deadline.exe) for use in the task.
Create Checkpoint Directory

Create the directory where checkpoint files will be stored:
```
C:\> mkdir "path\to\checkpoint\directory"
```
Create Log Directory

Create a directory for task logs:
```
C:\> mkdir "path\to\logs"
```

Create Batch File Wrapper

Create the batch file with the following content:


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

Test Batch File

Test the batch file manually:


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

Check the log file was created:


C:\> notepad path\to\logs\deadline_sync.log

Check Task Scheduler Service

Ensure Task Scheduler service is running:
```
C:\> sc query "Schedule"
```
If the service doesn't exist, try alternative names:
```
C:\> sc query "TaskScheduler"
C:\> sc query "Task Scheduler"
```
If not running, start it:
```
C:\> sc start "Schedule"
```
Create Scheduled Task

Create the task to run every 5 minutes.
```
C:\> schtasks /create /tn "DeadlineOutputSync" /tr "C:\path\to\deadline_sync.bat" /sc minute /mo 5
```
Command breakdown:
- /tn - Task name
- /tr - Task to run (your batch file)
- /sc minute /mo 5 - Schedule: every 5 minutes
Verify Task Creation

Check that the task was created successfully:
```
schtasks /query /tn "DeadlineOutputSync" /v /fo LIST
```
Look for:
- Task To Run: Should show your batch file path
- Next Run Time: Should show a time within 5 minutes

Test Task Execution

Run the task manually to test:


schtasks /run /tn "DeadlineOutputSync"

Check task status:


schtasks /query /tn "DeadlineOutputSync"

Verify the setup

To verify the automatic downloads setup was successful, complete the following steps.

Submit a new test job.
Wait for one scheduler interval to complete, which in this case is 5 minutes.
Verify that new outputs are downloaded automatically.

If the outputs do not download, check the Troubleshooting section for the process logs.

Troubleshooting automatic downloads

If you encounter issues with the automatic downloads, check the following:

Storage Profile Issues

An error like [Errno 2] No such file or directory or [Errno 13] Permission denied in the log file could be related to missing or misconfigured storage profiles.
See Storage profiles for information about how to set up your storage profiles when the downloading machine is different from the submitting machine.
For same-machine downloads, try the --ignore-storage-profiles flag.

Directory Permissions

Ensure the scheduler service user has:
- Read/write access to the checkpoint directory
- Write access to the output destination directory
For Linux and macOS, use ls -la to check permissions.
For Windows, review Security settings in the Properties folder.

Checking Scheduler Logs

Linux

Check if cron service is running:



# For systemd systems
$ sudo systemctl status cron
# or
$ sudo systemctl status crond

# Check if your user has cron job correctly configured
$ crontab -l

View cron execution logs:



# 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

Check your specific cron job logs:



# View the log file specified in your cron job
$ tail -100f /path/to/logs/deadline_sync.log

Search for cron job execution in system logs:



# 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

Check checkpoint file updates:



# 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

Check the log file:



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

macOS

Viewing Launch Agent Execution Logs:

Check if the launch agent is running:
```
$ sudo launchctl list | grep deadlinesync
       
```
Output shows: PID Status Label (PID will be - when not currently running, which is normal for interval jobs)
View detailed launch agent status:
```
$ sudo launchctl print system/com.user.deadlinesync
       
```
This shows execution history, last exit code, number of runs, and current state.

View launch agent execution logs:



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

Force run the launch agent for immediate testing:
```
$ sudo launchctl kickstart gui/$(id -u)/com.user.deadlinesync
       
```
This immediately triggers the job regardless of the schedule, useful for testing.

Check checkpoint file updates:



# List checkpoint files with timestamps
$ ls -la /path/to/checkpoint/directory/

Check the log file:



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

Windows

Check if Task Scheduler service is running:
```
C:\> sc query "Schedule"
```
If the service doesn't exist, try alternative names:
```
C:\> sc query "TaskScheduler"
C:\> sc query "Task Scheduler"
```

View your scheduled tasks:



C:> schtasks /query /tn "DeadlineOutputSync"

Check your task's log file:



# View the log file created by your batch script
C:> notepad C:\path\to\logs\deadline_sync.log

Check checkpoint file updates:



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

Warning Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

Virtual file system

Track spending and usage