(Click to open topic with navigation)
See the associated Policies resource section for more information on how to use this resource and supported operations.
Additional references
Type | Value | Additional information |
---|---|---|
Permissions resource | policies | Permissions |
Hooks filename | policies.groovy | Pre- and Post-Processing Hooks |
Distinct query-supported | Yes | Distinct |
A Moab Workload Manager policy which can affect scheduling decisions such as resource allocation. A policy contains state, identifying information, a priority, and metadata about the policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
description | String | No |
The user friendly description of the policy. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
The Moab policy used to enabled and configure policy-based VM migration. Using information about data center applications and server load, Moab can aim to keep VMs in the data center optimally distributed across all hypervisors.
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
description | String | No |
The user friendly description of the policy. |
genericMetricThresholds | Map<String, Double> | Yes |
A map of generic metric pairings where each value must be greater than or equal to 0 such as: METRIC1 => 5.6 METRIC2 => 0.0 METRIC3 => 102.4 |
memoryUtilizationThreshold | Double | Yes |
Defines the utilization threshold for memory. This must be greater than 0 and less than or equal to 1. A value of 1 effectively disables the threshold. |
migrationAlgorithmType | AutoVMMigrationPolicyType | Yes |
Configures the VM migration algorithm utilized when the policy is active. Defaults to NONE. When ENABLED, this must not be set to NONE. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
processorUtilizationThreshold | Double | Yes |
Defines the load utilization threshold for processors. This must be greater than 0 and less than or equal to 1. A value of 1 effectively disables the threshold. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
Represents the algorithm used to migrate VMs when the AutoVMMigrationPolicy is used.
Value | Description |
---|---|
NONE | Used when the Auto VM Migration policy is currently disabled in Moab and before any settings are saved the first time. For example, if the policy is disabled on the first read of Moab policies, the AutoVMMigrationPolicy.migrationAlgorithmType will be set to NONE. If the policy is enabled and the type is set to OVERCOMMIT, followed by a disabling of the policy, it will then be represented as having a state of DISABLED with a migrationAlgorithmType of OVERCOMMIT. |
OVERCOMMIT | Use the "overcommit" algorithm for migration. The goal of this algorithm is to equalize loads across hypervisors as migrations are queued due to overcommit conditions. This places VMs to be migrated on the least-loaded hypervisor available. |
CONSOLIDATION | Use the "consolidation" algorithm for migration. The goal of this algorithm is to load hypervisors as close to thresholds as possible, without exceeding them. This policy places VMs to be migrated on the most loaded hypervisor possible, within these constraints. A second loop of this policy will select lightly-loaded hypervisors to be evacuated completely. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
The Hypervisor Allocation Overcommit policy controls how many virtual machines can be placed on a hypervisor. By enabling this policy, you are allowing Moab to allocate more resoures to a set of virtual machines than a hypervisor may actually have. This is possible due to virtualization. In other words, this policy allows you to set the high-water mark for virtual machine allocation for hypervisors. At least one of these limits must be greater than 1.0, or the policy will not be able to set to a state of PolicyState.ENABLED.
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
description | String | No |
The user friendly description of the policy. |
memoryAllocationLimit | Double | Yes |
Setting this to 1 effectively disables the allocation overcommit based on memory. If this and processorAllocationLimit are both set to 1.0 (the default), the policy state cannot be set to PolicyState.ENABLED. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
processorAllocationLimit | Double | Yes |
The Allocation Limit defines the upper bound or maximum amount of VCPUs that can be created on any given hypervisor (HV). For example, if you have a hypervisor with 12 processors or cores (Moab sees them as 12 processors), and have an Allocation Limit of 2.0 for procs, then Moab will not allow, under any condition, more than 24 VCPU's to be allocated on this hypervisor. Remember: a VM can have one or more VCPU's. So, in this example, the HV could only support 8 VM's if they all had 3 VPCU's each. It could support 4 VM's if they had 6 VPCU's each, and so forth From http://www.adaptivecomputing.com/resources/docs/mwm/7-1-1/Content/topics/vm/allocation_limits_and_utilization_threshold.htmlSetting this to 1 effectively disables the allocation overcommit based on processors. If this and memoryAllocationLimit are both set to 1.0 (the default), the policy state cannot be set to PolicyState.ENABLED. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
Node allocation is the process of selecting the best resources to allocate to a job from a list of available resources. Moab contains a number of allocation algorithms that address this in the NodeAllocationPolicy.
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
customPriorityFunction | String | Yes |
Defines the priority function when the CustomPriority algorithm is used. |
description | String | No |
The user friendly description of the policy. |
name | String | No |
The user friendly name of the policy. |
nodeAllocationAlgorithm | NodeAllocationAlgorithm | Yes |
Configures the node allocation algorithm utilized when the policy is active. Defaults to NONE. When ENABLED, this must not be set to NONE. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
Represents the algorithm used to allocate Nodes when the NodeAllocationPolicy is used.
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
Specify which virtual machines and hypervisors to exclude from automatic migration operations.
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
description | String | No |
The user friendly description of the policy. |
hvExclusionList | List<String> | Yes |
The list of hypervisor IDs on the exclusion list. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
vmExclusionList | List<String> | Yes |
The list of VM IDs on the exclusion list. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
Fairshare allows historical resource utilization information to be incorporated into job feasibility and priority decisions. This feature allows site administrators to set system utilization targets for users, groups, accounts, classes, and QoS levels. Administrators can also specify the time frame over which resource utilization is evaluated in determining whether the goal is being reached. Parameters allow sites to specify the utilization metric, how historical information is aggregated, and the effect of fairshare state on scheduling behavior. You can specify fairshare targets for any credentials (such as user, group, and class) that administrators want such information to affect. http://docs.adaptivecomputing.com/mwm/archive/6-0-4/6.3fairshare.php
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
decayFactor | Double | Yes |
Specifies decay rate applied to past fairshare interval when computing effective fairshare usage. Values may be in the range of 0.01 to 1.0. A smaller value causes more rapid decay causing aged usage to contribute less to the overall effective fairshare usage. A value of 1.0 indicates that no decay will occur and all fairshare intervals will be weighted equally when determining effective fairshare usage. |
depth | Integer | Yes |
Number of fairshare windows factored into current fairshare utilization. Note: The number of available fairshare windows is bounded by the MAX_FSDEPTH value (32 in Moab). |
description | String | No |
The user friendly description of the policy. |
intervalSeconds | Long | Yes |
Specifies the length of each fairshare window in seconds. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
usageMetric | FairshareUsageMetric | Yes |
As Moab runs, it records how available resources are used. Each iteration it updates fairshare resource utilization statistics. Resource utilization is tracked in accordance with the usage metric allowing various aspects of resource consumption information to be measured. The usage metric allows selection of both the types of resources to be tracked as well as the method of tracking. It provides the option of tracking usage by dedicated or consumed resources, where dedicated usage tracks what the scheduler assigns to the job and consumed usage tracks what the job actually uses. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
Specifies the unit of tracking FairsharePolicy usage. http://docs.adaptivecomputing.com/mwm/archive/6-0-4/6.3fairshare.php#fspolicy
A Moab Workload Manager policy which can affect scheduling decisions such as resource allocation. A policy contains state, identifying information, a priority, and metadata about the policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
description | String | No |
The user friendly description of the policy. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
The Moab policy used to enabled and configure policy-based VM migration. Using information about data center applications and server load, Moab can aim to keep VMs in the data center optimally distributed across all hypervisors.
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
description | String | No |
The user friendly description of the policy. |
genericMetricThresholds | Map<String, Double> | Yes |
A map of generic metric pairings where each value must be greater than or equal to 0 such as: METRIC1 => 5.6 METRIC2 => 0.0 METRIC3 => 102.4 |
memoryUtilizationThreshold | Double | Yes |
Defines the utilization threshold for memory. This must be greater than 0 and less than or equal to 1. A value of 1 effectively disables the threshold. |
migrationAlgorithmType | AutoVMMigrationPolicyType | Yes |
Configures the VM migration algorithm utilized when the policy is active. Defaults to NONE. When ENABLED, this must not be set to NONE. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
processorUtilizationThreshold | Double | Yes |
Defines the load utilization threshold for processors. This must be greater than 0 and less than or equal to 1. A value of 1 effectively disables the threshold. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
Represents the algorithm used to migrate VMs when the AutoVMMigrationPolicy is used.
Value | Description |
---|---|
NONE | Used when the Auto VM Migration policy is currently disabled in Moab and before any settings are saved the first time. For example, if the policy is disabled on the first read of Moab policies, the AutoVMMigrationPolicy.migrationAlgorithmType will be set to NONE. If the policy is enabled and the type is set to OVERCOMMIT, followed by a disabling of the policy, it will then be represented as having a state of DISABLED with a migrationAlgorithmType of OVERCOMMIT. |
OVERCOMMIT | Use the "overcommit" algorithm for migration. The goal of this algorithm is to equalize loads across hypervisors as migrations are queued due to overcommit conditions. This places VMs to be migrated on the least-loaded hypervisor available. |
CONSOLIDATION | Use the "consolidation" algorithm for migration. The goal of this algorithm is to load hypervisors as close to thresholds as possible, without exceeding them. This policy places VMs to be migrated on the most loaded hypervisor possible, within these constraints. A second loop of this policy will select lightly-loaded hypervisors to be evacuated completely. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
The Hypervisor Allocation Overcommit policy controls how many virtual machines can be placed on a hypervisor. By enabling this policy, you are allowing Moab to allocate more resoures to a set of virtual machines than a hypervisor may actually have. This is possible due to virtualization. In other words, this policy allows you to set the high-water mark for virtual machine allocation for hypervisors. At least one of these limits must be greater than 1.0, or the policy will not be able to set to a state of PolicyState.ENABLED.
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
description | String | No |
The user friendly description of the policy. |
memoryAllocationLimit | Double | Yes |
Setting this to 1 effectively disables the allocation overcommit based on memory. If this and processorAllocationLimit are both set to 1.0 (the default), the policy state cannot be set to PolicyState.ENABLED. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
processorAllocationLimit | Double | Yes |
The Allocation Limit defines the upper bound or maximum amount of VCPUs that can be created on any given hypervisor (HV). For example, if you have a hypervisor with 12 processors or cores (Moab sees them as 12 processors), and have an Allocation Limit of 2.0 for procs, then Moab will not allow, under any condition, more than 24 VCPU's to be allocated on this hypervisor. Remember: a VM can have one or more VCPU's. So, in this example, the HV could only support 8 VM's if they all had 3 VPCU's each. It could support 4 VM's if they had 6 VPCU's each, and so forth From http://www.adaptivecomputing.com/resources/docs/mwm/7-1-1/Content/topics/vm/allocation_limits_and_utilization_threshold.htmlSetting this to 1 effectively disables the allocation overcommit based on processors. If this and memoryAllocationLimit are both set to 1.0 (the default), the policy state cannot be set to PolicyState.ENABLED. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
Node allocation is the process of selecting the best resources to allocate to a job from a list of available resources. Moab contains a number of allocation algorithms that address this in the NodeAllocationPolicy.
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
customPriorityFunction | String | Yes |
Defines the priority function when the CustomPriority algorithm is used. |
description | String | No |
The user friendly description of the policy. |
name | String | No |
The user friendly name of the policy. |
nodeAllocationAlgorithm | NodeAllocationAlgorithm | Yes |
Configures the node allocation algorithm utilized when the policy is active. Defaults to NONE. When ENABLED, this must not be set to NONE. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
Represents the algorithm used to allocate Nodes when the NodeAllocationPolicy is used.
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
Specify which virtual machines and hypervisors to exclude from automatic migration operations.
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
description | String | No |
The user friendly description of the policy. |
hvExclusionList | List<String> | Yes |
The list of hypervisor IDs on the exclusion list. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
vmExclusionList | List<String> | Yes |
The list of VM IDs on the exclusion list. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
Fairshare allows historical resource utilization information to be incorporated into job feasibility and priority decisions. This feature allows site administrators to set system utilization targets for users, groups, accounts, classes, and QoS levels. Administrators can also specify the time frame over which resource utilization is evaluated in determining whether the goal is being reached. Parameters allow sites to specify the utilization metric, how historical information is aggregated, and the effect of fairshare state on scheduling behavior. You can specify fairshare targets for any credentials (such as user, group, and class) that administrators want such information to affect. http://docs.adaptivecomputing.com/mwm/archive/6-0-4/6.3fairshare.php
This class inherits fields from Policy.
Field Name | Type | PUT | Description |
---|---|---|---|
id | String | No |
The unique identifier for the policy. Must contain only lowercase letters and dashes, such as 'auto-vm-migration'. |
conflicted | Boolean | No |
Signifies whether any other policies are currently activated that potentially conflict with this policy. If true, it signifies a potential conflict. |
decayFactor | Double | Yes |
Specifies decay rate applied to past fairshare interval when computing effective fairshare usage. Values may be in the range of 0.01 to 1.0. A smaller value causes more rapid decay causing aged usage to contribute less to the overall effective fairshare usage. A value of 1.0 indicates that no decay will occur and all fairshare intervals will be weighted equally when determining effective fairshare usage. |
depth | Integer | Yes |
Number of fairshare windows factored into current fairshare utilization. Note: The number of available fairshare windows is bounded by the MAX_FSDEPTH value (32 in Moab). |
description | String | No |
The user friendly description of the policy. |
intervalSeconds | Long | Yes |
Specifies the length of each fairshare window in seconds. |
name | String | No |
The user friendly name of the policy. |
potentialConflicts | Set<String> | No |
A set of policy IDs that may potentially conflict with this policy. |
priority | Integer | No |
Indicates the absolute priority of the policy with respect to others. It is possible that more than one policy has the same priority. |
state | PolicyState | Yes |
Defines the current state of the policy: enabled or disabled. Defaults to PolicyState.DISABLED. |
tags | Set<String> | No |
A set of strings that can be used to aid in filtering or querying policies. |
types | Set<String> | No |
A set of categories or types that the policy is included in. This may be used to filter or query on groups of policies. |
usageMetric | FairshareUsageMetric | Yes |
As Moab runs, it records how available resources are used. Each iteration it updates fairshare resource utilization statistics. Resource utilization is tracked in accordance with the usage metric allowing various aspects of resource consumption information to be measured. The usage metric allows selection of both the types of resources to be tracked as well as the method of tracking. It provides the option of tracking usage by dedicated or consumed resources, where dedicated usage tracks what the scheduler assigns to the job and consumed usage tracks what the job actually uses. |
Represents the state of a policy. A policy may only be enabled or disabled.
Value | Description |
---|---|
ENABLED | The policy is enabled or active. |
DISABLED | The policy is disabled or inactive. |
Specifies the unit of tracking FairsharePolicy usage. http://docs.adaptivecomputing.com/mwm/archive/6-0-4/6.3fairshare.php#fspolicy
Related Topics