alloc

alloc block [-reclaim] -a alloc_ID host_name ...

Blocks hosts from being assigned to the specified allocation. Workload running on the host is allowed to complete before the host is blocked.

This is an administrative command. You must be either a cluster administrator or consumer administrator of the corresponding consumer to issue this command.

-reclaim

EGO reclaims the hosts and stops the corresponding containers on the hosts. Running workload terminates as per the configured grace period. The hosts can be allocated to other consumers.

-a alloc_ID

Specifies the ID of the allocation.

host_name

Specifies the name of the host to which the allocation was made.

To specify multiple hosts, separate the hosts with a space.

alloc free -a alloc_ID | -p consumer_name | -c client_name

Frees all allocations for the specified consumer or client, returning resources to the cluster and removing the allocation names.

-a alloc_ID

Specifies the ID of the allocation to free.

-p consumer_name

Frees all activities for the specified consumer.

Specify the unique consumer name, or the full path to the consumer name. Specify as many levels within the consumer tree as required to uniquely identify the consumer, as follows:

/first-level_consumer_name/. . . /leaf_consumer_name

-c client_name

Specifies the name of the client to which the allocation was made.

alloc list [-l] [-ll] [-a alloc_ID] [-p consumer_name] [-c client_name] | [-r resource_name] [-t activity_ID]

Lists all allocations in the cluster, listing the allocation ID, consumer, client, resource groups and resources used by each allocation.

-l

Provides the same information with a longer name field, if some are truncated when -l is not specified.

-ll

Provides the same information as the -l option, and in comma-separated values (CSV) format.

-a alloc _ID

Lists the allocated resources for the specified allocation.

-p consumer_name

Lists all activities for the specified consumer.

Specify the unique consumer name, or the full path to the consumer name. Specify as many levels within the consumer tree as required to uniquely identify the consumer, as follows:

/first-level_consumer_name/. . . /leaf_consumer_name

-c client_name

Lists the resources allocated to the specified client.

-r resource_name

Lists all allocations that include the specified resource.

-t activity_ID

Lists all allocations that include the specified activity.

alloc modify -a alloc_ID [-m min_slots] -M max_slots [-delta]

Requests an increased number of resources for an existing allocation. This subcommand and options apply only to the slot-based scheduling policy.

-a alloc_ID

Specifies the ID of the allocation to change.

-m min_slots

Specifies the minimum number of slots to be allocated, or the minimum additional slots to be allocated, depending on if -delta is specified.

-M max_slots

Specifies the maximum number of slots to be allocated, or the maximum additional slots to be allocated, depending on if -delta is specified.

-delta

Specifies that the minimum and maximum slots requested are in addition to the existing allocation for this consumer.

alloc modify -a alloc_ID -M max_units [-o priority] [-h share] [-D sub_demand_number]

Requests an increased number of resources for an existing allocation.

-a alloc_ID

Specifies the ID of the allocation to change.

-M max_units

Specifies the maximum number of units to be allocated.

-o priority

Specifies share priority.

-h share

Specifies sharing relative to other allocations under the same consumer; the default is 10.

-D sub_demand_number

Specifies the number of sub-demands.

alloc new -p consumer_name -M max_slots [-m min_slots] [ -a alloc_name] [-exclusive] [-g resource_group] [-s slots_per_host] [-R res_req]

Requests a new resource allocation for the specified consumer from the specified resource group. This subcommand and options apply only to the slot-based scheduling policy.

-p consumer_name

Specifies the consumer to allocate the resources to.

Specify the unique consumer name, or the full path to the consumer name. Specify as many levels within the consumer tree as required to uniquely identify the consumer, as follows:

/first-level_consumer_name/. . . /leaf_consumer_name

-M max_slots

Specifies the maximum number of slots to be allocated.

-m min_slots

Specifies the minimum number of slots to be allocated.

-a alloc_name

Specifies a name to identify the new allocation request.

Specify a name that is unique within the cluster. Specify up to 40 alphanumeric characters.

-exclusive

Specifies that this allocation request is for the exclusive use of these resources by this consumer.

Note that a host may still be distributed to several allocations if it appears in multiple host groups, despite indicating exclusive usage.

-g resource_group

Specifies the resource group from which to allocate resources.

-s slots_per_host

Specifies the number of slots per host required (on both single- and multi-CPU hosts).

-R res_req

Specifies the resource requirement to use to select the most appropriate host for this allocation.

Specify name value pairs for the resource requirement(s). Multiple resource requirements are separated with the characters &&.

Important: If the command is issued in whole from the shell console or the requirement has white space in it , enclose the requirement in double quotation marks. For example:

>egosh resource list -R select(mem>100 && it>1)

If the command is issued from the egosh console, do not use quotation marks. For example:

>egosh

>resource list -R select(mem>100)

alloc release -a alloc_ID [-block] [-autoadjust] [-modify] host_name:nslots …

Reduces an allocation by the specified number of hosts or slots. This subcommand and options apply only to the slot-based scheduling policy.

-a alloc_ID

Specifies the ID of the allocation from which to release the slots.

-block

Releases the slots and prevents this host from being allocated to this consumer again.

Use this option if a host is not behaving properly. You can reverse this option later using the alloc unblock subcommand.

-autoadjust

Automatically adjusts the allocation request to match the current number of slots. This prevents the resources from being assigned back to the current allocation.

Issuing this command without specifying a number of slots removes any unfulfilled slot requests for this allocation, and modifies the request to the current number of slots.

Use this option when you do not expect to need the slots anymore.

-modify

Automatically decrements the allocation request by the number of slots being released. The -autoadjust option takes precedence over the -modify option.

host_name:nslots …

Releases the specified number of slots from the specified hosts.

Specify the name of the host followed by the number of slots to release from that host.

To specify multiple hosts and numbers of slots, separate the host and slot combinations with a space.

alloc release -a alloc_ID [-modify] [-d decision_ID […]] [-block] [-replace]

Reduces an allocation by the specified number of hosts or partial hosts.

-a alloc_ID

Specifies the ID of the allocation from which to release the slots.

-modify

Automatically decrements the allocation request by the number of slots being released. The -autoadjust option takes precedence over the -modify option.

-d decision_ID

Releases the specified decision.

-block

Releases the units and prevents this host from being allocated to this consumer again.

Use this option if a host is not behaving properly. You can reverse this option later using the alloc unblock subcommand.

-replace

Specifies that the same number of released units should be added immediately to a subdemand of the allocation that released the units.

alloc unblock -a alloc_ID -n nhosts host_name …

Specifies to allow blocked hosts to be allocated to this consumer again. Use this command to undo a previous alloc release -block subcommand.

-a alloc_ID

Specifies the ID of the allocation from which to unblock the host.

-n nhosts

Specifies the number of hosts to unblock, allowing the hosts to be allocated to this consumer again.

host_name …

Specifies the host names to unblock.

To specify multiple hosts, separate the hosts with a space.

alloc view [alloc_ID …]

Displays detailed information about all allocations, including the allocation ID, current users, consumer, resource groups, resource requirements, minimum and maximum slots requested, whether it has exclusive use of the host, names of the allocated hosts, and any blocked hosts.

If global standby services are enabled, the command also displays the short tag of the global standby service (specified as globalStandbyServiceTag in the Service section of the application profile).

alloc_ID …

Displays information about the specified allocation.