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

Instructions for Updating Deadline when using AWS Portal

Users running AWS Portal must follow these specific instructions in order to upgrade to the latest version of Deadline.

Note

These steps are still required if you use Deadline’s “Auto Upgrade” feature.

Note

The ordering of the steps is important and cannot be done out of order.

Step 1: Download Deadline

Step 2: Shut down any running AWS Portal Infrastructures using the following steps:

  • Open the Deadline Monitor.
  • Enable super-user mode by going to ToolsSuper User Mode.
  • Open the AWS Portal panel by going to ViewNew PanelAWS Portal
  • Log in with your AWS credentials if prompted.
  • If there are any entries in the the “Deadline Infrastructure” list, you must shut them down by right clicking on the entries and selecting “Stop Infrastructure”. Wait until they have successfully terminated are are removed from the list. This may take a few minutes.

Step 3: Shut down the “AWS Portal Server” services/daemons:

  • Log in to the machine running the “AWS Portal Server” software. This machine has two services running called AWS Portal Link and AWS Portal Asset Server. These two are typically installed on the same machine, but may have been installed on two separate machines.

  • On Windows: shut down the services:
    • Open Task manager and select Services tab.
    • Right-click on AWSPortalAssetServer, and select “Stop”.
    • Right-click on AWSPortalLinkService, and select “Stop”.
  • On Linux: Shut down the daemons:
    • Open a terminal and perform the following two commands:

      sudo service awsportalassetservershellscript stop
      sudo service awsportallinkservice stop
      
  • Close all Deadline processes running on this machine.
    • Examples of Deadline processes that may be running are:
      • Deadline Monitor
      • Deadline RCS
      • Deadline Proxy Server
      • Deadline License Forwarder
      • Deadline Worker
      • Pulse
      • Deadline Webservice
      • any processes named dpython[.exe].

Step 4: Update the permissions on your AWSPortal IAM User:

If you are updating from Deadline 10.1.7 or earlier, then you will need to update the permissions on your AWSPortal IAM User. To do so:

  1. Log into the AWS Console.

  2. Click on Services at the top of the AWS Console, and click on IAM under “Security, Identity and Compliance”.

  3. Click Users.

  4. Click the AWSPortal user that you created previously in Creating an AWSPortal IAM User.

  5. Under “Permissions”, see the list of “Permissions policies” that you have attached to the AWSPortal user. Look for the following policies in the list:

    • AWSThinkboxAWSPortalAdminPolicy
    • AWSThinkboxDeadlineResourceTrackerAdminPolicy
    ../_images/update-awsportal-iam-user-1.png

    If you already have these policies attached, then you’re done this step. Otherwise, attach these policies now:

    1. Click the Add permissions button.

      ../_images/update-awsportal-iam-user-2.png
    2. In the “Add permissions” page that appears, choose Attach existing policies directly.

    3. Search for the AWSThinkboxAWSPortalAdminPolicy and AWSThinkboxDeadlineResourceTrackerAdminPolicy policies in the list, and check both of them.

    4. Press the Next: Review button.

    5. On the “Permissions summary” page that appears, verify that the information is correct, and press the Add permission button.

Step 5: Reinstall the updated version of the “Deadline Repository” software:

  • Log into your machine running the Deadline Repository software.
  • Reinstall the latest version of the Deadline Repository by running the "DeadlineRepository-[version]-[platform]-installer" executable provided in the download.

Step 6: Reinstall the updated version of the “Deadline Client” and “AWS Portal Server” software:

  • Log into the machine running the “AWS Portal Server” software.
  • Reinstall the latest version of the DeadlineClient by running the "DeadlineClient-[version]-[platform]-installer" executable provided in the download.
  • Reinstall the latest version of the AWS Portal Server by running the "AWSPortalLink-[version]-[platform]-installer" executable provided in the download. This step reinstalls the “AWS Portal Link” and “AWS Portal Asset Server” services/daemons. Optionally, these two services/daemons can be installed on two separate machines.

For more information or assistance please contact support@thinkboxsoftware.com.