If you’re new to AWS Portal we recommend starting here. If you’re new to Deadline we recommend starting here.

AWS Portal Configuration Reference

This section contains a reference for all of the configuration options for the AWS Portal.

Configure AWS Portal Settings dialog

The Configure AWS Portal Settings dialog allows you to control settings related to the AWS Portal.

To access this dialog:

  1. Open the Deadline Monitor.

  2. Enter Super User mode (‘Tools’ menu → ‘Super User Mode’).

  3. Open the AWS Portal panel (‘View’ menu → ‘New Panel’ → ‘AWS Portal’).

    The first time you open the AWS Portal panel, it will show an AWS Login screen, which prompts you for your AWS Access Key and Secret Access Key. Enter the keys that you saved during the AWSPortal IAM User Setup steps that you followed earlier(In the background, this will also also trigger Asset Transfer S3 bucket creation, if one doesn’t already exist in your account).

    The login controls also include a drop-down box to select your default AWS Region. Note that you can choose any supported region when starting your infrastructure, regardless of your selection here. For more information on AWS regions, please see AWS Global Infrastructure.

    After you have entered your credentials, press the ‘Login’ button.

  4. Click the Gear button in the AWS Portal dialog. This button is adjacent to “Deadline Infrastructure”.

    ../_images/aws-portal-gear-button-hilite.png

Basic tab

../_images/configure-aws-portal-settings-basic.png

Connection Server

Choose the Remote Connection Server that AWS Portal will use to communicate with your Deadline Repository.

Advanced tab

../_images/configure-aws-portal-settings-advanced.png

Usage-Based Licensing Certificate Directory

Specify a directory that contains pfx certificate files for Usage-Based Licensing.

These certificate files will be automatically copied to new Deadline Infrastructures. To update the certificates on an existing infrastructure, open the AWS Portal panel in the Deadline Monitor, right-click on the infrastructure, and choose “Upload Certificates”.

Please see here for more information on Usage-Based Licensing.

Servers

This enables you to specify ports that will be forwarded from the gateway instance in your AWS infrastructure to a server on your local network.

Note that the gateway instance always has private IP address 10.128.2.4.

This also allows you to use your own on-premesis license server for certain applications. For more information, please see Bring Your Own License Setup.

Environment Variables

Here you can specify environment variables that will be set on your Deadline Workers that are running on AWS.

Management Settings

AWS Portal Pulse Instances Can Be Primary

Enable this setting to allow the Deadline Pulse running on your AWS Infrastructure to act as the primary pulse.

AWS Portal Workers Can Perform House Cleaning Operations

Enable this setting to allow AWS Portal Deadline Workers to perform house cleaning.

Note

In Deadline 10.0.21 and later, client applications (Pulse, Worker, etc.) that are connected to the Remote Connection Server will not be able to perform house cleaning operations. Instead, the Remote Connection Server has adopted this responsibility and will perform House Cleaning, Repository Repair, and Pending Job Scan periodically.

Client applications that use a direct Repository connection can still perform house cleaning operations as normal.

Remove Orphaned AWS Entities

This is meant for use if you change to use a different AWS account. This will remove any spot fleets, infrastructures, and S3 buckets not owned by the account you are currently signed in from the Deadline database. It will not stop or delete these entities in AWS itself. If any spot fleets, infrastructures, or S3 buckets are not deleted from the old AWS account charges will apply.

Asset Server Settings dialog

The Asset Server Settings dialog allows you to control settings related to the AWS Portal Asset Server.

To access the dialog:

  1. Open the Deadline Monitor.

  2. Enter Super User mode (“Tools” menu > “Super User Mode”).

  3. Choose the “Tools” menu → “Configure Asset Server…”

    ../_images/asset-server-settings.png

Asset Server Local IP Address

This must be set to the private IP address of the machine that is running the AWS Portal Asset Server. You should use an IP address that is accessible to all of your machines that are running the Deadline Client. This machine should be behind your firewall so that it is not accessible to the public Internet. This machine must have access to the “Root Directories” specified below.

To determine the IP address, follow the instructions in “How to Find Your Local IP Address” on the machine that is running the AWS Portal Asset Server.

If you will only submit Deadline jobs from the same machine that is running the AWS Portal Asset Server, then you can use the IP address 127.0.0.1.

Asset Server Port

Should be left as the default 4000.

S3 Bucket

This is the S3 bucket that your assets will be transferred to for AWS Portal.

Create New Bucket

When you login to AWS Portal the first time within the Deadline Monitor, a default bucket will automatically be created in your account. You can also create a new bucket using the “Create New Bucket” button.

Warning

The AWS Portal will not allow you to create/change the S3 bucket if there are running infrastructures. You should stop your infrastructure before performing this step.

Clear Bucket

This will empty the bucket by deleting all its content. Please note that once deleted, the contents of the bucket cannot be restored.

Root Directories

A list of filesystem directories that you want to share with the Deadline Workers running on AWS.

This is a list of directories that the Asset Server can access files in. This includes sub-directories, and their sub-directories, and so on, so it is only necessary to specify the root directories of the directory structures where you store your assets.

For instance, if you have a file server accessible from the UNC path \\fs-01\assets\, but you have assets located in \\fs-01\assets\textures\ and \\fs-01\assets\particles\, you would only need to register \\fs-01\assets\ as a file transfer directory.

In the case that you store your assets in multiple locations, for instance, two different file servers, you can specify more than one directory. For example, if you have assets divided between two file servers \\fs-team-a\assets\, and \\fs-team-b\assets\, you would need to specify both as file transfer directories.

The paths set for each file transfer directory should be paths that are accessible from the machine you are running Asset Server on, not necessarily the machine you’re configuring the File Transfer Directories from. For instance, if your asset server is installed on a machine running Linux with your file server mounted as /mnt/assets/ and you’re configuring the Asset Server from a Windows machine with the file server mounted as X:\, you would specify only /mnt/assets/ as a file transfer directory.

Output File Extensions

This setting controls which file types will be transferred from your AWS Worker instances back to your on-premesis filesystem.

By default, AWS Portal attempts to detect which output files will be created by your job, and it will transfer them automatically. However, this may fail in some cases. For example, the automatic detection does not work for jobs submitted through the Deadline Monitor. In such cases, you can have AWS Portal transfer your output files back to you by adding their filename extension here.

How to Find Your Local IP Address

Several controls in the AWS Portal configuration require a machine’s local IP address. How you find this depends on your computer’s operating system.

Windows

  1. Open a Command Prompt window on the machine for which you need the local IP address.

  2. Run the ipconfig command, and look for your IPv4 Address:

    ../_images/windows_ipconfig_hilight_ipv4_address.png

Linux

  1. Open a command-line window on the machine for which you need the local IP address.

  2. Run the ip address command, and look for your inet address:

    ../_images/linux_ip_address_hilight_inet.png

    Note

    The output of ip address may include the address of multiple devices. Normally you will want the address from your first ethernet adapter, called eth0.

    You do not want the address from the lo device, 127.0.0.1.