Upgrading or Downgrading Deadline


This will guide you through the process of upgrading or downgrading an existing Deadline installation.


Check whether your license file needs to be updated BEFORE installing the new version of Deadline, as there may be a delay before you receive your new license file from Thinkbox Sales. Our release notes and forum build announcements always contain the license information, confirming what FEATURE version of Deadline, Draft and Balancer you require to run this specific version. Plan ahead!

Major Upgrades or Downgrades

If upgrading to a new major version (for example, Deadline 9 to 10), or downgrading from a new major version (for example, Deadline 10 to 9), you will need to install a NEW Repository and Database, and you will need to reinstall the Client software. This is necessary because there are often breaking changes between MAJOR releases. MINOR releases (including beta releases) such as Deadline or can happily be installed over the top of an existing Deadline 9.0 installation, but NOT Deadline 10.0.

Please note we do NOT officially support the archiving/importing workflow to transfer Deadline jobs from one MAJOR version to another. The reason for this is that MAJOR versions of Deadline allow us to carry out ‘breaking’ changes to our DB backend, so the dev team make no promises that the Deadline “job object” may or may not get touched. So, the official recommendation is always to let all jobs finish up rendering in one MAJOR version before moving over to the next. MINOR versions of Deadline are typically supported.

You should also reinstall your integrated submission scripts on your workstations, since it’s possible these were changed between major releases. If upgrading to Deadline 8 or later, it is absolutely necessary to reinstall these scripts. See the Application Plug-ins documentation for more information on how to set up the integrated submission scripts (where applicable).

The license server should also be upgraded to ensure it will work with newer releases in case there are incompatibilities with the previous version of the license server.

Please refer to the following documentation for more information:

Minor Upgrades or Downgrades

If upgrading or downgrading to a minor version that is part of the same major release cycle (for example, Deadline 10.0 to, or Deadline to, you can simply install over the existing installation. If you have Automatic Upgrades / Downgrades enabled, you can have the Clients automatically upgrade or downgrade themselves after upgrading or downgrading the Database and Repository. Automatic Upgrades / Downgrades can be enabled in the Client Setup section of the Repository Configuration.


Due to compatibility issues, Linux Client versions 10.0.21 or higher cannot automatically downgrade to versions 10.0.20 or lower. Also note that installing a Linux Client version of 10.0.20 or lower over an existing installation of version 10.0.21 or higher may cause unexpected behaviour. If you need to downgrade a Linux Client from 10.0.21 or higher to 10.0.20 or lower, please follow the Client Installation guide to uninstall the newer version and reinstall the older version.

You can also enable Remote Administration in the Client Setup section of the Repository Configuration. This will make it easier to upgrade or downgrade your render nodes remotely.


Note that this upgrade/downgrade method is only supported when upgrading or downgrading an existing Repository installation. For example, it is NOT recommended to install the Deadline Repository to a new location and then have your 10.0 Clients upgrade by pointing them to the new Repository path. Instead, you should first move your Repository installation and then do the upgrade once your 10.0 Clients are connected to the new Repository.

To ensure Deadline’s Automatic Upgrade/Downgrade system works correctly; make sure the service account used to run Deadline Launcher has the ability to start and stop the service. This permission on Windows for example can be added to the service account by an Administrator user as follows:

setacl.exe \\computername\deadline<VERSION>launcherservice /service /grant <serviceaccount> /start_stop


<VERSION> is the Deadline major version, such as: 10.

Upgrading or Downgrading the Database and Repository

Launch the new Repository installer, and choose the existing Repository folder for the Installation Directory. Then choose the option to connect to an existing MongoDB database, and use the same Database Settings you used when installing the previous version (they should be pre-populated for you).

upgrade_repo_installer_01 upgrade_repo_installer_02 upgrade_repo_installer_03

During the installation, all binaries, plug-ins, and scripts from the previous version will be backed up. You can find them in the backup folder in the Repository after the installation is complete. Note that any scripts or plugins in the ‘custom’ folder will not be affected when upgrading the Repository.

After upgrading or downgrading the Database and Repository, you can then upgrade or downgrade the Clients.

Upgrading or Downgrading Non-Render Nodes and Non-Workstations First

Before upgrading or downgrading all of your Client machines, you should first upgrade or downgrade the following applications if you are running them on your render farm.

  • Remote Connection Server
  • Pulse
  • Balancer
  • Forwarder
  • Web Service

If you don’t have Automatic Upgrades / Downgrades enabled, you will have to upgrade or downgrade these applications manually, which involves running the Client Installer on the appropriate machines. See the Client Installation Guide for more information.

If you have Automatic Upgrades / Downgrades enabled, all you have to do is restart the applications from the Launcher (which will execute an automatic Launcher bootstrap process based on the client recognising a version change in the repository). Additionally, if you have Remote Administration enabled in the Repository configuration, you can easily execute a remote command to restart the Slaves/Pulses/etc from the Monitor.


Due to the removal of the Proxy Server in version 10.0.25, if doing a fresh install of versions 10.0.25 or higher, automatically downgrading to a version lower than 10.0.25 can cause issues with the Proxy Server. While it is recommended to use the Remote Connection Server instead of the Proxy Server, you can mitigate the issues in the following ways:


  • The DeadlineProxyServer10.app will not exist if downgrading from a fresh install of 10.0.25 or greater, and therefore will not be able to run. If you must use the Proxy Server, you will need to run the Deadline Client intaller for a previous version.


  • The deadlineproxyserver file will not have run permissions by default. You will need to add run permissions to it before it can run.

Windows & Linux

  • The Deadline Launcher menu will not show the option to launch a Proxy Server. If you want to re-enable that option, add IncludeProxyServerInLauncherMenu=true in a new line in your local deadline.ini file.

This process is actually identical for the Pulse, Balancer, and Forwarder, so let’s use the Pulse panel as an example. Right-click on the Pulse instance in the list and select Remote Control Pulse -> Pulse Commands -> Restart Pulse. Note that if you don’t see the Remote Control menu, you will have to enter Super User Mode from the Tools menu. This sends a remote command to the Launcher running on the remote machine to restart Pulse, which will trigger the upgrade. After Pulse has been restarted, you can check the Version column in the Pulse panel to confirm that it’s now running the new version.


You can repeat this process for the Balancer, and Forwarder as necessary. For the Web Service though, you’ll notice that there isn’t a panel in the Monitor for it. Currently, the only way to update the Web Service is to run the Client Installer on the machine that it’s running on.

See the Remote Control documentation for more information about the remote commands that are available.

Upgrading or Downgrading the Render Nodes

If you don’t have Automatic Upgrades / Downgrades enabled, you will have to upgrade or downgrade the Clients manually, which involves running the Client Installers on the machines. See the Client Installation Guide for more information.

If you have Automatic Upgrades / Downgrades enabled, all you have to do is restart the Slave application on each render node through the Launcher. The Client will notice that the Repository has been upgraded or downgraded, and will automatically upgrade or downgrade itself. In addition, the next time artists launch the Monitor on their workstations through the Launcher, their installation will also be upgraded or downgraded.

To restart the Slaves remotely, Remote Administration must be enabled. Select the Slaves you want to upgrade or downgrade in the Monitor while in Super User mode, then right click and select Remote Control -> Restart Slaves. If the Slaves are currently rendering and you don’t want to disrupt them, you can choose the option to Restart Slaves After Current Task instead. This option will allow the Slaves to upgrade or downgrade after they finish rendering their current task to prevent the loss of any render time. See the Remote Control documentation for more information.


After restarting the Slaves, several Slaves may appear offline or a message may pop up saying the certain Slaves did not respond. This may occur because all the Slaves are trying to upgrade or downgrade at once. Wait a little bit and eventually all the Slaves should come back online. After the Slaves have been restarted, you can check the Version column in the Slave panel to confirm that they’re all now running the new version.

Upgrading or Downgrading Workstations

This is a somewhat manual process, so it’s recommended that you send out a notification to your staff to let them know the upgrade is in place. The next time any of the artists or wranglers launch their Monitor (or any Deadline application) through their Launcher, the upgrade will take place automatically before launching the chosen application.

Upgrading or Downgrading Draft

It’s not uncommon for a new version of Draft to be included with a minor release of Deadline. However, there might be situations where you want to upgrade or downgrade Deadline, but stick with the current version of Draft that you are using. To do so, simply follow these steps:

  1. Run the Repository Installer as explained above to upgrade or downgrade Deadline. During installation, the Repository installer will back up the previous version of Draft to the “backup” folder in your Repository directory.
  2. Note the location where you installed the Repository. This will be referred to as [REPOSITORY] for the remaining steps.
  3. After the Repository installation has finished, navigate to [REPOSITORY]/backup/mostRecent. This folder contains everything that was backed up from the previous installation.
  4. Copy the contents of [REPOSITORY]/backup/mostRecent/draft to [REPOSITORY]/draft, and overwrite the existing files. This will update the Draft libraries that are used.
  5. Copy the contents of [REPOSITORY]/backup/mostRecent/submission/Draft to [REPOSITORY]/submission/Draft, and overwrite the existing files. This will update the Quick Draft options so that they match the version of Draft you’re using.

Upgrading or Downgrading AWS Portal

Typically, upgrading or downgrading AWS Portal will require you to cancel any running Spot Fleet requests and stop any running Infrastructures.

New features of AWS Portal may require new permissions to be added to your AWS user. To add (or remove) them, login to the AWS Console, click on ‘Services’ and search for ‘IAM’. In IAM, click on Policies on the left dashboard. Find the policy called AWSPortal and click on it’s name. Then click the Edit policy button.

Then switch to the JSON Editor and copy the policy text into the textbox.

Finally, click Review policy and Save changes. You might see a pop up indicating that your policy has hit it’s maximum saved versions. By default, you can choose to delete the oldest non-default policy version. Alternatively, you can select which version to delete. Either way, choose Delete version and save.