Deadline Scripting Reference  10.4.1.8
Deadline.Slaves.SlaveSettings Class Reference

Contains settings for the Worker. In contrast to SlaveInfo, this class contains information usually set by the user or external source meant for the worker. It's not meant to change often. More...

Inherits LastWriteDocument, and ICloneable.

Public Member Functions

string[] GetSlaveExtraInfoKeys ()
 Gets the keys for the Worker's extra info entries. More...
 
string GetSlaveExtraInfoKeyValue (string key)
 Gets the extra info value for the given key. More...
 
string GetSlaveExtraInfoKeyValueWithDefault (string key, string defaultValue)
 Gets the extra info value for the given key. More...
 
void SetSlaveGroups (object groups)
 Sets the groups that the Worker has been assigned to. More...
 
void SetSlaveIdleProcessNames (object processNames)
 The Worker will not start when the machine is idle if any processes in this list are currently running on the machine. More...
 
void SetSlaveIdleUserNames (object userNames)
 If user checking is enabled, the Worker will not start when the machine is idle if the launcher is running as this user. More...
 
void SetSlavePools (object pools)
 Sets the pools that the Worker has been assigned to. More...
 
void SetSlaveUserJobsModeNames (object userNames)
 If SlaveSchedulingMode is set to SlaveSchedulingMode.UserJobs, it will only render jobs for users in this list. More...
 

Properties

string SlaveComment [get, set]
 Brief comment regarding the Worker. More...
 
int SlaveConcurrentTasksLimit [get, set]
 Limit the number of concurrent tasks the Worker can dequeue. The value must be between 0 and 16 inclusive. Set to 0 to use the Worker's processor count. More...
 
int[] SlaveCpuAffinity [get, set]
 The list of specific CPUs to use if SlaveOverrideCpuAffinity is True. More...
 
string SlaveDescription [get, set]
 A description of the Worker. More...
 
bool SlaveEnabled [get, set]
 If the Worker is enabled. More...
 
bool SlaveEnableIdleCpuThreshold [get, set]
 If enabled, the Worker will not start when the machine is idle unless the current CPU usage of the machine is lower than the value in SlaveIdleCpuThreshold. More...
 
bool SlaveEnableIdleProcessCheck [get, set]
 If enabled, the Worker will not start when the machine is idle if any processes in SlaveIdleProcessNames are currently running on the machine. More...
 
bool SlaveEnableIdleRamMBThreshold [get, set]
 If enabled, the Worker will not start when the machine is idle unless the current RAM usage of the machine is lower than the value (in Megabytes) in SlaveEnableIdleRamMBThreshold. More...
 
bool SlaveEnableIdleRamPercentThreshold [get, set]
 If enabled, the Worker will not start when the machine is idle unless the current RAM usage of the machine is lower than the value (as a percentage) in SlaveEnableRamPercentThreshold. More...
 
bool SlaveEnableIdleUserCheck [get, set]
 If enabled, the Worker will not start when the machine is idle if the launcher is running as one of the users in SlaveIdleUserNames. More...
 
string SlaveExtraInfo0 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo1 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo2 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo3 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo4 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo5 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo6 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo7 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo8 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
string SlaveExtraInfo9 [get, set]
 One of the Worker's ten Extra Info fields. More...
 
Dictionary< string, string > SlaveExtraInfoDictionary [get, set]
 A dictionary of Extra Info KVPs. More...
 
bool SlaveFinishTaskWhenStoppingIfNotIdle [get, set]
 If a Worker should finish its current task before shutting down when the machine is no longer idle. More...
 
int[] SlaveGpuAffinity [get, set]
 The list of specific GPUs to use if SlaveOverrideGpuAffinity is True. More...
 
string[] SlaveGroups [get]
 The groups that the Worker has been assigned to. More...
 
string SlaveHostMachineIPAddressOverride [get, set]
 If non-empty, this host name or IP address will be used for remote communication with the Worker. More...
 
int SlaveIdleCpuThreshold [get, set]
 If CPU threshold checking is enabled, the Worker will not start when the machine is idle unless the current CPU usage of the machine is lower than this value. More...
 
int SlaveIdleMinutes [get, set]
 The number of minutes a Worker must be idle for. More...
 
string[] SlaveIdleProcessNames [get]
 The Worker will not start when the machine is idle if any processes in this list are currently running on the machine. More...
 
long SlaveIdleRamMBThreshold [get, set]
 If RAM MB threshold checking is enabled, the Worker will not start when the machine is idle unless the current RAM usage of the machine is lower than this value (in Megabytes). More...
 
int SlaveIdleRamPercentThreshold [get, set]
 If RAM Percent threshold checking is enabled, the Worker will not start when the machine is idle unless the current RAM usage of the machine is lower than this value (as a percentage). More...
 
string[] SlaveIdleUserNames [get]
 If user checking is enabled, the Worker will not start when the machine is idle if the launcher is running as this user. More...
 
int SlaveListeningPort [get, set]
 The port to use listen on if SlaveOverridePort is enabled. More...
 
string SlaveMacAddressOverride [get, set]
 If non-empty, this is used to override the MAC address for the Worker. More...
 
string SlaveName [get, set]
 The Worker name. More...
 
float SlaveNormalizedRenderTimeMultiplier [get, set]
 Used to calculate the normalized render time of the Worker. The value must be between 0.01 and 100.0 inclusive. More...
 
float SlaveNormalizedTimeoutMultiplier [get, set]
 Used to calculate the normalized timeout for the Worker. The value must be between 0.01 and 100.0 inclusive. More...
 
bool SlaveOnlyStopSlaveIfStartedByIdleDetection [get, set]
 Only stops the slWorkerave if it was started by idle detection. More...
 
bool SlaveOverrideCpuAffinity [get, set]
 Enable to override the Worker's CPU affinity (Windows and Linux only). More...
 
bool SlaveOverrideGpuAffinity [get, set]
 Enable to override the Worker's GPU affinity. More...
 
bool SlaveOverrideListeningPort [get, set]
 If Worker should listen on a specific port. More...
 
bool SlaveOverrideSlaveScheduling [get, set]
 If the Worker settings should override the global Worker Scheduling settings. More...
 
string[] SlavePools [get]
 The pools that the Worker has been assigned to. More...
 
SlaveSchedulingMode SlaveSchedulingMode [get, set]
 Scheduling modes for a Worker, which affects how it dequeues jobs. If set to SlaveSchedulingMode.UserJobs, it will only render jobs for users in the SlaveUserJobsModeNames list. More...
 
bool SlaveStartSlaveIfIdle [get, set]
 Starts the Worker if the machine has been idle for the number of minutes specified in SlaveIdleMinutes. More...
 
bool SlaveStopSlaveIfNotIdle [get, set]
 Stops the Worker if the machine is no longer idle. More...
 
string[] SlaveUserJobsModeNames [get]
 If SlaveSchedulingMode is set to SlaveSchedulingMode.UserJobs, it will only render jobs for users in this list. More...
 

Detailed Description

Contains settings for the Worker. In contrast to SlaveInfo, this class contains information usually set by the user or external source meant for the worker. It's not meant to change often.

Member Function Documentation

◆ GetSlaveExtraInfoKeys()

string [] Deadline.Slaves.SlaveSettings.GetSlaveExtraInfoKeys ( )

Gets the keys for the Worker's extra info entries.

Returns
The keys, as a list of strings.

◆ GetSlaveExtraInfoKeyValue()

string Deadline.Slaves.SlaveSettings.GetSlaveExtraInfoKeyValue ( string  key)

Gets the extra info value for the given key.

Parameters
keyThe key.
Returns
The value as a string. If the key isn't found, an empty string is returned.

◆ GetSlaveExtraInfoKeyValueWithDefault()

string Deadline.Slaves.SlaveSettings.GetSlaveExtraInfoKeyValueWithDefault ( string  key,
string  defaultValue 
)

Gets the extra info value for the given key.

Parameters
keyThe key.
defaultValueThe default value
Returns
The value, as a string. If the key isn't found, an empty string is returned.

◆ SetSlaveGroups()

void Deadline.Slaves.SlaveSettings.SetSlaveGroups ( object  groups)

Sets the groups that the Worker has been assigned to.

Parameters
groupsThe groups. This should be a list of strings.

◆ SetSlaveIdleProcessNames()

void Deadline.Slaves.SlaveSettings.SetSlaveIdleProcessNames ( object  processNames)

The Worker will not start when the machine is idle if any processes in this list are currently running on the machine.

Parameters
processNamesThe process names. This should be a list of strings.

◆ SetSlaveIdleUserNames()

void Deadline.Slaves.SlaveSettings.SetSlaveIdleUserNames ( object  userNames)

If user checking is enabled, the Worker will not start when the machine is idle if the launcher is running as this user.

Parameters
userNamesThe user names. This should be a list of strings.

◆ SetSlavePools()

void Deadline.Slaves.SlaveSettings.SetSlavePools ( object  pools)

Sets the pools that the Worker has been assigned to.

Parameters
poolsThe pools. This should be a list of strings.

◆ SetSlaveUserJobsModeNames()

void Deadline.Slaves.SlaveSettings.SetSlaveUserJobsModeNames ( object  userNames)

If SlaveSchedulingMode is set to SlaveSchedulingMode.UserJobs, it will only render jobs for users in this list.

Parameters
userNamesThe user names. This should be a list of strings.

Property Documentation

◆ SlaveComment

string Deadline.Slaves.SlaveSettings.SlaveComment
getset

Brief comment regarding the Worker.

◆ SlaveConcurrentTasksLimit

int Deadline.Slaves.SlaveSettings.SlaveConcurrentTasksLimit
getset

Limit the number of concurrent tasks the Worker can dequeue. The value must be between 0 and 16 inclusive. Set to 0 to use the Worker's processor count.

◆ SlaveCpuAffinity

int [] Deadline.Slaves.SlaveSettings.SlaveCpuAffinity
getset

The list of specific CPUs to use if SlaveOverrideCpuAffinity is True.

◆ SlaveDescription

string Deadline.Slaves.SlaveSettings.SlaveDescription
getset

A description of the Worker.

◆ SlaveEnabled

bool Deadline.Slaves.SlaveSettings.SlaveEnabled
getset

If the Worker is enabled.

◆ SlaveEnableIdleCpuThreshold

bool Deadline.Slaves.SlaveSettings.SlaveEnableIdleCpuThreshold
getset

If enabled, the Worker will not start when the machine is idle unless the current CPU usage of the machine is lower than the value in SlaveIdleCpuThreshold.

◆ SlaveEnableIdleProcessCheck

bool Deadline.Slaves.SlaveSettings.SlaveEnableIdleProcessCheck
getset

If enabled, the Worker will not start when the machine is idle if any processes in SlaveIdleProcessNames are currently running on the machine.

◆ SlaveEnableIdleRamMBThreshold

bool Deadline.Slaves.SlaveSettings.SlaveEnableIdleRamMBThreshold
getset

If enabled, the Worker will not start when the machine is idle unless the current RAM usage of the machine is lower than the value (in Megabytes) in SlaveEnableIdleRamMBThreshold.

◆ SlaveEnableIdleRamPercentThreshold

bool Deadline.Slaves.SlaveSettings.SlaveEnableIdleRamPercentThreshold
getset

If enabled, the Worker will not start when the machine is idle unless the current RAM usage of the machine is lower than the value (as a percentage) in SlaveEnableRamPercentThreshold.

◆ SlaveEnableIdleUserCheck

bool Deadline.Slaves.SlaveSettings.SlaveEnableIdleUserCheck
getset

If enabled, the Worker will not start when the machine is idle if the launcher is running as one of the users in SlaveIdleUserNames.

◆ SlaveExtraInfo0

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo0
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo1

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo1
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo2

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo2
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo3

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo3
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo4

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo4
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo5

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo5
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo6

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo6
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo7

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo7
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo8

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo8
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfo9

string Deadline.Slaves.SlaveSettings.SlaveExtraInfo9
getset

One of the Worker's ten Extra Info fields.

◆ SlaveExtraInfoDictionary

Dictionary<string, string> Deadline.Slaves.SlaveSettings.SlaveExtraInfoDictionary
getset

A dictionary of Extra Info KVPs.

◆ SlaveFinishTaskWhenStoppingIfNotIdle

bool Deadline.Slaves.SlaveSettings.SlaveFinishTaskWhenStoppingIfNotIdle
getset

If a Worker should finish its current task before shutting down when the machine is no longer idle.

◆ SlaveGpuAffinity

int [] Deadline.Slaves.SlaveSettings.SlaveGpuAffinity
getset

The list of specific GPUs to use if SlaveOverrideGpuAffinity is True.

◆ SlaveGroups

string [] Deadline.Slaves.SlaveSettings.SlaveGroups
get

The groups that the Worker has been assigned to.

◆ SlaveHostMachineIPAddressOverride

string Deadline.Slaves.SlaveSettings.SlaveHostMachineIPAddressOverride
getset

If non-empty, this host name or IP address will be used for remote communication with the Worker.

◆ SlaveIdleCpuThreshold

int Deadline.Slaves.SlaveSettings.SlaveIdleCpuThreshold
getset

If CPU threshold checking is enabled, the Worker will not start when the machine is idle unless the current CPU usage of the machine is lower than this value.

◆ SlaveIdleMinutes

int Deadline.Slaves.SlaveSettings.SlaveIdleMinutes
getset

The number of minutes a Worker must be idle for.

◆ SlaveIdleProcessNames

string [] Deadline.Slaves.SlaveSettings.SlaveIdleProcessNames
get

The Worker will not start when the machine is idle if any processes in this list are currently running on the machine.

◆ SlaveIdleRamMBThreshold

long Deadline.Slaves.SlaveSettings.SlaveIdleRamMBThreshold
getset

If RAM MB threshold checking is enabled, the Worker will not start when the machine is idle unless the current RAM usage of the machine is lower than this value (in Megabytes).

◆ SlaveIdleRamPercentThreshold

int Deadline.Slaves.SlaveSettings.SlaveIdleRamPercentThreshold
getset

If RAM Percent threshold checking is enabled, the Worker will not start when the machine is idle unless the current RAM usage of the machine is lower than this value (as a percentage).

◆ SlaveIdleUserNames

string [] Deadline.Slaves.SlaveSettings.SlaveIdleUserNames
get

If user checking is enabled, the Worker will not start when the machine is idle if the launcher is running as this user.

◆ SlaveListeningPort

int Deadline.Slaves.SlaveSettings.SlaveListeningPort
getset

The port to use listen on if SlaveOverridePort is enabled.

◆ SlaveMacAddressOverride

string Deadline.Slaves.SlaveSettings.SlaveMacAddressOverride
getset

If non-empty, this is used to override the MAC address for the Worker.

◆ SlaveName

string Deadline.Slaves.SlaveSettings.SlaveName
getset

The Worker name.

◆ SlaveNormalizedRenderTimeMultiplier

float Deadline.Slaves.SlaveSettings.SlaveNormalizedRenderTimeMultiplier
getset

Used to calculate the normalized render time of the Worker. The value must be between 0.01 and 100.0 inclusive.

◆ SlaveNormalizedTimeoutMultiplier

float Deadline.Slaves.SlaveSettings.SlaveNormalizedTimeoutMultiplier
getset

Used to calculate the normalized timeout for the Worker. The value must be between 0.01 and 100.0 inclusive.

◆ SlaveOnlyStopSlaveIfStartedByIdleDetection

bool Deadline.Slaves.SlaveSettings.SlaveOnlyStopSlaveIfStartedByIdleDetection
getset

Only stops the slWorkerave if it was started by idle detection.

◆ SlaveOverrideCpuAffinity

bool Deadline.Slaves.SlaveSettings.SlaveOverrideCpuAffinity
getset

Enable to override the Worker's CPU affinity (Windows and Linux only).

◆ SlaveOverrideGpuAffinity

bool Deadline.Slaves.SlaveSettings.SlaveOverrideGpuAffinity
getset

Enable to override the Worker's GPU affinity.

◆ SlaveOverrideListeningPort

bool Deadline.Slaves.SlaveSettings.SlaveOverrideListeningPort
getset

If Worker should listen on a specific port.

◆ SlaveOverrideSlaveScheduling

bool Deadline.Slaves.SlaveSettings.SlaveOverrideSlaveScheduling
getset

If the Worker settings should override the global Worker Scheduling settings.

◆ SlavePools

string [] Deadline.Slaves.SlaveSettings.SlavePools
get

The pools that the Worker has been assigned to.

◆ SlaveSchedulingMode

SlaveSchedulingMode Deadline.Slaves.SlaveSettings.SlaveSchedulingMode
getset

Scheduling modes for a Worker, which affects how it dequeues jobs. If set to SlaveSchedulingMode.UserJobs, it will only render jobs for users in the SlaveUserJobsModeNames list.

◆ SlaveStartSlaveIfIdle

bool Deadline.Slaves.SlaveSettings.SlaveStartSlaveIfIdle
getset

Starts the Worker if the machine has been idle for the number of minutes specified in SlaveIdleMinutes.

◆ SlaveStopSlaveIfNotIdle

bool Deadline.Slaves.SlaveSettings.SlaveStopSlaveIfNotIdle
getset

Stops the Worker if the machine is no longer idle.

◆ SlaveUserJobsModeNames

string [] Deadline.Slaves.SlaveSettings.SlaveUserJobsModeNames
get

If SlaveSchedulingMode is set to SlaveSchedulingMode.UserJobs, it will only render jobs for users in this list.