E.3.6 rcxadm pool

Name

[Windows]
Installation_folder\Manager\bin\rcxadm pool - resource pool operations

[Linux]
/opt/FJSVrcvmr/bin/rcxadm pool - resource pool operations

Format

rcxadm pool create -name name -type type [-priority priority] [-label label] [-comment comment] [-nowait]
rcxadm pool list [-name name] [-template template_name]
rcxadm pool show -name name
rcxadm pool register -name name -resource resource_name -type resource_type  [-nowait]
rcxadm pool unregister -name name -resource resource_name -type resource_type  [-nowait]
rcxadm pool modify -name name {[-new_name new_name] [-priority priority] [-label label] [-comment comment]} [-nowait]
rcxadm pool move -name name [-to folder] [-nowait]
rcxadm pool delete -name name [-force] [-nowait]

Description

rcxadm pool is the command used to manage resource pools. A resource pool is a type of resource folder in the orchestration tree, which stores the resources to select when creating or adding an L-Server. A resource pool type is specified when creating a resource pool, and only resources of a specific type are stored in each type of resource pool.

The following types of resource pools exist:

vm
VM pool
A resource pool that stores VM hosts used when creating VM guests.
server
Server pool
A resource pool that stores the physical servers assigned to L-Servers.
storage
Storage pool
A resource pool that stores the disks assigned to L-Servers.
network
Network pool
A resource pool that stores the networks assigned to L-Servers.
address
Address pool
Stores the IP addresses, MAC addresses, and WWNs for assignment to L-Servers.
image
Image pool
A resource pool that stores the cloning images to deploy to L-Servers.

The following types of resources exist:

vm_host
VM host resource
Stored in VM pools.
physical_server
Physical server resource
Stored in server pools.
storage
Virtual storage resource
Stored in storage pools.
disk
Disk resource
Stored in storage pools.
network
Network resource
Stored in network pools.
address_set
Address set resource
Stored in address pools.
vm_image
Virtual image resource
Stored in image pools.
cloning_image
Physical image resource
Stored in image pools.

Resource pools enable you to manage all the resources assigned when creating an L-Server.

Subcommands

create: Creates a resource pool.

list: Displays a list of resource pools. If you specify the -name argument, the specified resource pool and a list of the resources included in the resource pool are displayed. If you do not specify the -name argument, the information for all the resource pools that can be accessed is displayed.

show: Displays the detailed information for a resource pool.

register: Registers a resource to a resource pool.

unregister: Deletes a resource from a resource pool.

modify: Modifies the name, label, comment, and priority of a resource pool.

move: Moves a resource pool to the specified resource folder.
If the destination resource folder is not specified, the pool is moved to the home folder.

delete: Deletes a resource pool.

Options

-name name: In name, specify the name of the target resource pool to perform an operation with.

-type type: In type, specify the resource pool type.

-priority priority: In priority, specify a priority between 1 and 10. If omitted, "5" is set. You can specify the same priority as another pool, but it is not recommended as the order for retrieving resources will not be guaranteed.

-label label: In label, specify the label for the resource pool.

-comment comment: In comment, specify any comments for the resource pool.

-nowait: Use this option to return directly to the command prompt without waiting for the operation of the resource pool specified in the subcommand to complete its execution.

-template template_name: In template_name, specify the name of an L-Server template that can be created.

-resource resource_name: In resource_name, specify the resource name.

-type resource_type: In resource_type, specify a type for the resource.

-new_name new_name: In new_name, specify a new name for the target resource pool.

-to folder: Specify the destination resource folder in folder.
If the destination resource folder is not specified, the pool is moved to the home folder.

-force: Use this option to forcibly delete a resource pool that includes resources. When the resource pool is deleted, the resources that belong to the resource pool are unregistered.

Examples

To display the list of resource pools:

>rcxadm pool list <RETURN>
NAME                TYPE    PRIORITY CPU(max.)             MEMORY(max.)
----                ----    -------- ---------             ------------
/VMPool             VM      5        2.2/3.2(1.1GHz x 2)   6.7/7.7(6.7GB)

NAME                TYPE    PRIORITY CAPACITY(max.)
----                ----    -------- --------------
/StoragePool        Storage 5        0.0/0.0(-)

NAME                TYPE    PRIORITY VLANID
----                ----    -------- ------
/NetworkPool        Network 5        -/-

NAME                TYPE    PRIORITY IMAGE
----                ----    -------- -----
/ImagePool          Image   5        3
/ImgPool            Image   5        -

To display the specified resource pool and a list of the resources included in the resource pool:

>rcxadm pool list -name /VMPool <RETURN>
NAME                TYPE    PRIORITY CPU(max.)             MEMORY(max.)
----                ----    -------- ---------             ------------
/VMPool             VM      5        2.2/3.2(1.1GHz x 2)   6.7/7.7(6.7GB)

NAME           TYPE     CPU(FREE)            MEMORY(FREE)   STATUS  MAINTENANCE
----           ----     ---------            ------------   ------  -----------
192.168.10.10  VMHost   1.6GHz x 2 (2.2GHz)  7.7GB (6.7GB)  unknown OFF

To display the detailed information for a resource pool:

>rcxadm pool show -name /VMPool <RETURN>
Name: VMPool
Type: VM
Priority: 5
CPU: 3.2GHz(1.1GHz x 2)
FreeCPU: 2.2GHz
MemorySize: 7.7GB(6.7GB)
FreeMemorySize: 6.7GB