Linux setup

1. Stop the Backburner Manager service: /bin/systemctl stop adsk_backburner. The Backburner Manager service on the workstation is stopped, if it was running previously. If it was not running previously, a “Failed” error message is displayed. If starting Backburner Manager for the first time, configure the Manager before starting it. Otherwise, start the Manager.
2. The Backburner configuration file is at /opt/Autodesk/backburner/Network/backburner.xml
3. Start Backburner Manager: /bin/systemctl start adsk_backburner. Events are logged in /opt/Autodesk/backburner/Network/backburner.log.

MacOS setup

1. In the Terminal run /opt/Autodesk/backburner/backburner stop
2. Edit /opt/Autodesk/backburner/Network/backburner.xml and configure the Backburner Manager settings as desired.
3. Save and close the edited backburner.xml file.
4. Start the Backburner Manager with: /opt/Autodesk/backburner/backburner start. All Backburner Manager events are recorded in log files in /opt/Autodesk/backburner/Log.

General configuration

TCP/IP settings

Manager Port

<ManagerPort> The port used by the Backburner Manager. Default: 3234.

Server Port

<ServerPort> The port used by the render node(s). Default: 3233.

N/A

<NetworkMask> The default subnet mask used for the network. Default: 255.255.255.0.

General settings

Max Concurrent Assignment

<MaxConcurrentAssignments> The number of jobs the Manager sends out simultaneously. This number depends on the processor speed of the Manager workstation, general job size, and overall network speed. Generally, the default value of four is adequate. Too high a value may cause an increased number of node timeouts because the jobs are sent faster than the nodes can handle them. In such cases, decrease the value.

Use Server Limit

<UseServerLimit> and <ServerLimit> The maximum number of render nodes allocated for a job. This can override the server limit settings in some applications. For information, see the application's Advanced Settings Dialog.

Use Task Error Limit

<UseTaskErrorLimit> and <TaskErrorLimit> The number of times a render node retries a task before suspending it.

Default Mail Server

<DefaultMailServer> The default mail server used for email notification. This mail server is used only for jobs that do not already have a mail server associated with them.

Failed node behaviour

Restart Failed Servers

<RetryFailedServers> Activate to enable automatic render node restarting. If this option is disabled, the render node does not attempt to render the job again after the first failure. This option is enabled by default.

Number of Retries

<RetryCount> The number of times the Manager attempts to restart a failed render node. The range is between 1 and 1024, default is 3.

Seconds Between Retries

<TimeBetweenRetries> The time between each retry in milliseconds. Default: 30000 milliseconds.

The state of a render node is recorded on a per-job basis. The Backburner Manager regularly goes through the list of render nodes for a job, checking for failures. If Restarts Failed Servers is enabled (set as 1 in the backburner.xml file), the Manager keeps track of the following:

• The time a render node fails on a particular job.
• The time elapsed since the node failed on a particular job.

If the time elapsed is greater than the specified seconds between retries, the Backburner Manager decreases the number of retries by one and resets the Failed flag for the render node. Once the failure count reaches the specified Number of Retries, the Manager stops trying to restart the render node for that particular job.

Once a restarted render node completes a frame, it is flagged as active and resumes processing until the job is complete.

Configure the Backburner Manager to access jobs on specified system or network drives by modifying either fields in the Direct Access to Job Path group of the Backburner Manager General Properties dialog, or elements of the ManagerSettings sub-element of the AppDetails element of the backburner.xml file.

Use these fields/elements when you do not want to have jobs kept on the drive or workstation where the Backburner Manager is installed. Examples of such situations are:

• There is very little space on the system drive where the Backburner Manager is installed. If another system drive has plenty of space, share a folder on this drive called MyJobs, where jobs are placed when submitted. In this case, you would direct jobs to \\\computername\\MyJobs.
• The workstation is used simultaneously as a Backburner Manager and creative workstation. To reduce the overhead on the workstation from the Backburner Manager, set up a shared job folder on a network file server, called backburnerJobs. The Win32 job path would be set to \\fileserver\backburnerJobs and jobs you submit placed on the file server.

Job path settings

Use Jobs Path

<RetryFailedServers> When enabled, defines job location using the Win32 or Linux paths. This tells the render nodes to get the job files from this location, minimizing the file I/O traffic on the Manager workstation.

Unix Path

<UnixPath> The path where jobs are located. Click the Browse button in the General Properties dialog to search the system for the job location.

These settings can be overridden from the Advanced Settings dialog accessed from the Network Job Assignment dialog.

Default job handling behaviour

• 0 State: Do Nothing. When enabled, a completed job is left in the queue.
• 1 State: Delete it. When enabled, the job is deleted from the queue upon completion.
• 2 State: Delete After. XML element: <DeleteDays>. When enabled: the job is kept in the queue for the specified number of days upon completion. Once the number of days has been exceeded, the job is deleted from the queue.
• 3 State: Archive it. When enabled, the job is archived upon completion.
• 4 State: Archive After. XML Element: <ArchiveDays>. When enabled, the job is kept in the queue for the specified number of days upon completion. Once the number of days has been exceeded, the job is deleted from the queue.

These settings can be overridden from the Advanced Settings dialog accessed from the Network Job Assignment dialog.