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] [-resource] [-info lserver]] [-reserve] rcxadm pool show -name name rcxadm pool register -name name {-resource resource_name|-from vstorage} -type resource_type [-force] [-nowait] rcxadm pool unregister -name name {-resource resource_name|-from vstorage} -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.
Resource pools enable you to manage all the resources allocated when creating an L-Server.
Note
When using a LUN that has been created in advance as a disk resource, if the L-Server is deleted or disks are deleted from L-Servers, the content of disks will remain (is not deleted).
When using disk resources that are registered in global pools, perform operation carefully, as the disk resources will be allocated to other users.
When using a LUN that has been created in advance as a disk resource, it is recommended to operate the LUN in a local pool, and delete data on the disk during deletion of L-Servers or detachment of disks.
For details on the method for deleting the data on a disk, refer to cautionary notes in "5.3.3 Storage Resources" of the "ServerView Resource Orchestrator User's Guide".
To operate disk resources used for iSCSI boot, use the iSCSI boot information operation command (rcxadm iscsictl).
When deleting disk resources using this command, they are unregistered from the resource pools, but the disk resource information will remain.
To delete the disk resource information, register the disk resources to resource pools again, and then delete them by executing the rcxadm iscsictl command.
Subcommands
Creates a resource pool.
Displays a list of resource pools.
If you specify -name for the option, the specified resource pool and a list of the resources included in the resource pool are displayed.
If you do not specify -name for the option, the information for all the resource pools that can be accessed is displayed.
The following detailed information is displayed:
When not specifying -name for the option
For VM pools
When a calculation for the available space for the VM pool used for overcommit is set with a reservation value, it will be reflected on the information output in the following item names:
- CPU(max)
- MEMORY(max)
Item Name | Description |
---|---|
NAME | VM pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
CPU(max) | The free size and the total size of the VM host CPUs In max, the maximum number of CPUs which can be allocated to a VM guest is displayed in "PerformanceGHz * Cores" format. |
RESERVE-CPU (*1) | The CPU reservation size of the VM host For VM hosts for which the HA function provided by server virtualization software is available, the reserved capacity for a failover is displayed. For VM hosts for which the HA function is unavailable, or for operations with no reservation for failover, a hyphen ("-") is displayed. |
MEMORY(max) | The free size and the total size of the VM host memory In max, the maximum memory which can be allocated to a VM host is displayed in "SpaceGB" format. |
RESERVE-MEMORY (*1) | The memory reservation capacity of the VM host For VM hosts for which the HA function provided by server virtualization software is available, the reserved capacity for a failover is displayed. For VM hosts for which the HA function is unavailable, or for operations with no reservation for failover, a hyphen ("-") is displayed. |
*1: When specifying -reserve for the option, this is displayed.
For server pools
Item Name | Description |
---|---|
NAME | Server pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
SERVER | The total and unused number of physical servers |
For storage pools
Item Name | Description |
---|---|
NAME | Storage pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
CAPACITY(max) | The total size and the free size of the virtual storage memory [Oracle VM] The total size of virtual storage resources will not be displayed when the virtual storage resource is an Oracle VM storage repository. In max, the maximum disk space which can be allocated to a VM host is displayed in "SpaceGB" format. [Oracle VM] |
For network pools
Item Name | Description |
---|---|
NAME | Network pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
VLAN ID | Total number and unused number of VLAN IDs |
For address pools
Item Name | Description |
---|---|
NAME | Address pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
ADDRESS | Total number and unused number of addresses |
For image pools
Item Name | Description |
---|---|
NAME | Image pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
IMAGE | Image number |
When specifying -name for the option
For VM pools
When a calculation for the available space for the VM pool used for overcommit is set with a reservation value, it will be reflected on the information output in the following item names:
- CPU(max)
- MEMORY(max)
- CPU(FREE)
- MEMORY(FREE)
Item Name | Description |
---|---|
NAME | VM pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
CPU(max) | The free size and the total size of the VM host CPUs In max, the maximum number of CPUs which can be allocated to a VM guest is displayed in "PerformanceGHz * Cores" format. |
RESERVE-CPU (*1) | The CPU reservation size of the VM host For VM hosts for which the HA function provided by server virtualization software is available, the reserved capacity for a failover is displayed. For VM hosts for which the HA function is unavailable, or for operations with no reservation for failover, a hyphen ("-") is displayed. |
MEMORY(max) | The free size and the total size of the VM host memory In max, the maximum memory which can be allocated to a VM host is displayed in "SpaceGB" format. |
RESERVE-MEMORY (*1) | The memory reservation capacity of the VM host For VM hosts for which the HA function provided by server virtualization software is available, the reserved capacity for a failover is displayed. For VM hosts for which the HA function is unavailable, or for operations with no reservation for failover, a hyphen ("-") is displayed. |
PER-TEMPLATE (*2) | Number of L-Servers which can be created in the specified L-Server template definition |
*1: When specifying -reserve for the option, this is displayed.
*2: When specifying -template for the option, this is displayed.
Item Name | Description |
---|---|
NAME | Resource name included in the resource pool |
TYPE | Type of resources included in the resource pools |
CPU(FREE) | The free size and the total size of the VM host CPUs Free space is displayed in FREE: |
RESERVE-CPU (*1) | The CPU reservation size of the VM host For VM hosts for which the HA function provided by server virtualization software is available, the reserved capacity for a failover is displayed. For VM hosts for which the HA function is unavailable, or for operations with no reservation for failover, a hyphen ("-") is displayed. |
MEMORY(FREE) | The free size and the total size of the VM host memory Free space is displayed in FREE: |
RESERVE-MEMORY (*1) | The memory reservation capacity of the VM host For VM hosts for which the HA function provided by server virtualization software is available, the reserved capacity for a failover is displayed. For VM hosts for which the HA function is unavailable, or for operations with no reservation for failover, a hyphen ("-") is displayed. |
STATUS | Resource status |
CLUSTER (*1) | The name of a cluster that the VM host belongs to For the VM hosts not belonging to a cluster, a hyphen ("-") is displayed. |
MAINTENANCE | Maintenance mode |
PER-TEMPLATE (*2) | Number of L-Servers which can be created in the specified L-Server template definition |
*1: When specifying -reserve for the option, this is displayed.
*2: When specifying -template for the option, this is displayed.
The following information is output when -resource is specified for the option.
Item Name | Description |
---|---|
NAME | Virtual machine name |
TYPE | Resource types |
VM_HOST | VM host |
L-SERVER (*1) | The linked L-Server name |
*1: When specifying -info lserver for the option, this is displayed.
Note
When calculating the number of L-Servers using reservation values, if an L-Server template for which the CPU reservation performance and the memory reservation capacity of 0 is specified, O will be displayed for the number of possible L-Servers for creation.
For server pools
Item Name | Description |
---|---|
NAME | Server pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
SERVER | The total and unused number of physical servers |
PER-TEMPLATE (*1) | Number of L-Servers which can be created in the specified L-Server template definition |
*1: When specifying -info lserver for the option, this is displayed.
Item Name | Description |
---|---|
NAME | Resource name included in the resource pool |
TYPE | Type of resources included in the resource pools |
MODEL | Physical server model name |
CPU | Physical server CPU size |
MEMORY | Memory size of a physical server |
STATUS | Resource status |
MAINTENANCE | Maintenance mode |
L-SERVER (*1) | The linked L-Server name |
PER-TEMPLATE (*2) | Number of L-Servers which can be created in the specified L-Server template definition |
*1: When specifying -info lserver for the option, this is displayed.
*2: When specifying -template for the option, this is displayed.
For storage pools
Item Name | Description |
---|---|
NAME | Storage pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
CAPACITY(max) | The total size and the free size of the virtual storage memory [Oracle VM] The total size of virtual storage resources will not be displayed when the virtual storage resource is an Oracle VM storage repository. In max, the maximum disk space which can be allocated to a VM host is displayed in "SpaceGB" format. [Oracle VM] |
PER-TEMPLATE (*1) | Number of L-Servers which can be created in the specified L-Server template definition |
*1: When specifying -template for the option, this is displayed.
Item Name | Description |
---|---|
NAME | Resource name included in the resource pool |
TYPE | Type of resources included in the resource pools |
CAPACITY(FREE) | The total size and the free size of the virtual storage memory [Oracle VM] The total size of virtual storage resources will not be displayed when the virtual storage resource is an Oracle VM storage repository. Free space is displayed in FREE: [Oracle VM] |
STATUS | Resource status |
PER-TEMPLATE (*1) | Number of L-Servers which can be created in the specified L-Server template definition |
*1: When specifying -template for the option, this is displayed.
For network pools
Item Name | Description |
---|---|
NAME | Network pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
VLANID | Total number and unused number of VLAN IDs |
Item Name | Description |
---|---|
NAME | Resource name included in the resource pool |
TYPE | Type of resources included in the resource pools |
VLANID(FREE) | Total and unused number of VLAN IDs Unused numbers are displayed in FREE: |
ADDRESS(FREE) | Total number and unused number of addresses Unused numbers are displayed in FREE: |
For address pools
Item Name | Description |
---|---|
NAME | Address pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
ADDRESS | Total number and unused number of addresses |
NAME | Resource name included in the resource pool |
TYPE | Type of resources included in the resource pools |
ADDRESS(FREE) | Total number and unused number of addresses Unused numbers are displayed in FREE: |
For image pools
Item Name | Description |
---|---|
NAME | Image pool name |
TYPE | Resource Pool Types |
PRIORITY | Priority |
IMAGE | Image number |
NAME | Resource name included in the resource pool |
VERSION | Version of the image |
TYPE | Type of resources included in the resource pools |
IMAGE_TYPE | Type of image |
VM_TYPE | Virtual image VM type |
OS | OS type of the image |
To display the detailed information for a resource pool.
The following detailed information is displayed:
For VM pools
When a calculation for the available space for the VM pool used for overcommit is set with a reservation value, it will be reflected on the information output in the following item names:
- FreeCPU
- FreeMemorySize
Item Name | Description |
---|---|
Name | VM pool name |
Type | Resource Pool Types |
Priority | Priority |
Label | Label |
Comment | Comment |
CPU(max) | The total size of the VM host CPUs In max, the maximum number of CPUs which can be allocated to a machine is displayed in "PerformanceGHz * Cores" format. |
FreeCPU | The free size of VM host CPUs |
ReserveCPU | The CPU reservation size of the VM host For VM hosts for which the HA function provided by server virtualization software is available, the reserved capacity for a failover is displayed. For VM hosts for which the HA function is unavailable, or for operations with no reservation for failover, a hyphen ("-") is displayed. |
MemorySize(max) | The total size of the VM host memory In max, the maximum memory which can be allocated to a VM host is displayed in "SpaceGB" format. |
FreeMemorySize | The free size of the VM host memory |
ReserveMemorySize | The memory reservation capacity of the VM host For VM hosts for which the HA function provided by server virtualization software is available, the reserved capacity for a failover is displayed. For VM hosts for which the HA function is unavailable, or for operations with no reservation for failover, a hyphen ("-") is displayed. |
For server pools
Item Name | Description |
---|---|
Name | Server pool name |
Type | Resource Pool Types |
Priority | Priority |
Label | Label |
Comment | Comment |
Server | Total number of physical servers |
FreeServer | Number of unused physical servers |
For storage pools
Item Name | Description |
---|---|
Name | Storage pool name |
Type | Resource Pool Types |
Priority | Priority |
Label | Label |
Comment | Comment |
DiskSize(max) | Total virtual storage size [Oracle VM] In max, the maximum disk space which can be allocated to a VM host is displayed in "SpaceGB" format. [Oracle VM] |
FreeDiskSize | Virtual storage free space [Oracle VM] |
For network pools
Item Name | Description |
---|---|
Name | Network pool name |
Type | Resource Pool Types |
Priority | Priority |
Label | Label |
Comment | Comment |
VLANId | Total number of VLANIDs |
FreeVLANId | Number of unused VLAN IDs |
For address pools
Item Name | Description |
---|---|
Name | Address pool name |
Type | Resource Pool Types |
Priority | Priority |
Label | Label |
Comment | Comment |
Address | Total number of addresses |
FreeAddress | Number of unused addresses |
For image pools
Item Name | Description |
---|---|
Name | Image pool name |
Type | Resource Pool Types |
Priority | Priority |
Label | Label |
Comment | Comment |
ImageCount | Image number |
Registers a resource to a resource pool.
Deletes a resource from a resource pool.
Modifies the name, label, comment, and priority of a resource pool.
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.
Deletes a resource pool.
Options
In name, specify the name of the target resource pool to perform an operation with.
For the resource pool allocated in the resource folder, specify the resource folder name using slashes ("/").
In type, specify the resource pool type.
The following values can be specified:
type | Resource Pool Types |
---|---|
vm | VM pool |
server | Server pool |
storage | Storage pool |
network | Network pool |
address | Address pool |
image | Image pool |
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.
For the priority order, 1 is the highest and 10 is the lowest.
In label, specify the label for the resource pool.
In comment, specify any comments for the resource pool.
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.
In template_name, specify the name of an L-Server template that can be created.
In resource_name, specify the resource name.
In vstorage, specify the resource name of a virtual storage.
Specify when adding the all disk resources in the specified virtual storage resource, to a resource pool.
In resource_type, specify a type for the resource.
The following values can be specified:
resource_type | Resource Types |
---|---|
vm_host | VM host |
physical_server | Physical server |
storage | Virtual storage |
disk | LUN (disk) created in advance |
network | Network |
address_set | MAC address, WWN |
cloning_image | Cloning images (physical) |
vm_image | Cloning images (virtual) |
In new_name, specify a new name for the target resource pool.
Specify the destination resource folder in folder.
If the destination resource folder is not specified, the pool is moved to the home folder.
When executed by a user who has multiple access scopes specified, it cannot be omitted. Specify a resource folder.
For the hierarchized resource folder, specify the resource folder name using slashes ("/").
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.
Specify when registering a physical server with an operating system installed to a server pool.
In other cases, do not specify.
Specify this option to display the elements of the resources registered in a resource pool.
This is valid when a VM pool is specified for the -name option.
Use this option to display the link between an L-Server and the resources or the elements of the resources registered in a resource pool.
This is valid when a VM pool or a server pool specified for the -name option.
Specify this option to display the CPU and memory reservation capacities when the HA function is enabled on the VM host in a VM pool.
This is valid for VM pools when the -name option is specified with this option.
Examples
To display the list of resource pools:
>rcxadm pool list <RETURN>
NAME TYPE PRIORITY CPU(max.) MEMORY(max.)
---- ---- -------- --------- ------------
/VMHostPool VM 5 37.6/39.9(1.8GHz x 8) 23.3/26.6(8.0GB)
NAME TYPE PRIORITY SERVER
---- ---- -------- --------------
/ServerPool Server 5 0/3
NAME TYPE PRIORITY CAPACITY(max.)
---- ---- -------- --------------
/StoragePool Storage 5 449.7/3061.8(351.7GB)
NAME TYPE PRIORITY VLANID
---- ---- -------- ------
/NetworkPool Network 5 0/0
NAME TYPE PRIORITY ADDRESS
---- ---- -------- -------
/AddressPool Address 5 249/257
NAME TYPE PRIORITY IMAGE
---- ---- -------- -----
/ImagePool Image 5 10 |
To display the specified resource pool and a list of the resources included in the resource pool:
>rcxadm pool list -name /VMHostPool <RETURN> NAME TYPE PRIORITY CPU(max.) MEMORY(max.) ---- ---- -------- --------- ------------ /VMHostPool VM 5 37.6/39.9(1.8GHz x 8) 23.3/26.6(8.0GB) NAME TYPE CPU(FREE) MEMORY(FREE) STATUS MAINTENANCE ---- ---- --------- ------------ ------ ----------- vmhost1 VMHost 1.9GHz x 4 (7.9GHz) 6.4GB (6.4GB) normal OFF vmhost2 VMHost 1.9GHz x 8 (14.6GHz) 10.0GB (8.7GB) normal OFF vmhost3 VMHost 1.9GHz x 8 (14.9GHz) 10.0GB (8.0GB) normal OFF |
To display the detailed information for a resource pool:
>rcxadm pool show -name /VMHostPool <RETURN> Name: VMHostPool Type: VM Priority: 5 CPU: 3.2GHz(1.1GHz x 2) FreeCPU: 2.2GHz MemorySize: 7.7GB(6.7GB) FreeMemorySize: 6.7GB |
To display the specified VM pool, and the CPU and memory reservation capacities of the VM hosts in the pool:
Cluster configuration and admission control are enabled (policy: share (10%))
>rcxadm pool list -name VMHostPool -reserve <RETURN>
NAME TYPE PRIORITY CPU(max.) RESERVE-CPU MEMORY(max.) RESERVE-MEMORY
---- ---- -------- --------- ----------- ------------ --------------
/VMHostPool VM 5 5.4/11.1(1.2GHz x 2) 0.9GHz 19.2/27.4(8.4GB) 2.6GB
NAME TYPE CPU(FREE) RESERVE-CPU MEMORY(FREE) RESERVE-MEMORY STATUS CLUSTER MAINTENANCE
---- ---- --------- ----------- ------------ -------------- ------ ------- -----------
vmhost1 VMHost 1.8GHz x 2 (1.2GHz) 0.3GHz 6.6GB (3.7GB) 0.6GB normal Cluster2 OFF
vmhost2 VMHost 1.8GHz x 2 (2.4GHz) 0.3GHz 10.4GB (8.4GB) 1.0GB normal Cluster2 OFF
vmhost3 VMHost 1.8GHz x 2 (1.8GHz) 0.3GHz 10.4GB (7.1GB) 1.0GB normal Cluster2 OFF |
Cluster configuration and admission control are enabled (policy: spare server (vmhost1))
>rcxadm pool list -name VMHostPool -reserve <RETURN>
NAME TYPE PRIORITY CPU(max.) RESERVE-CPU MEMORY(max.) RESERVE-MEMORY
---- ---- -------- --------- ----------- ------------ --------------
/VMHostPool VM 5 5.0/11.1(1.4GHz x 2) 3.7GHz 17.5/27.4(9.4GB) 6.6GB
NAME TYPE CPU(FREE) RESERVE-CPU MEMORY(FREE) RESERVE-MEMORY STATUS CLUSTER MAINTENANCE
---- ---- --------- ----------- ------------ -------------- ------ ------- -----------
vmhost1 VMHost 1.8GHz x 2 (0.0GHz) 3.7GHz 6.6GB (0.0GB) 6.6GB normal Cluster2 OFF
vmhost2 VMHost 1.8GHz x 2 (2.8GHz) 0.0GHz 10.4GB (9.4GB) 0.0GB normal Cluster2 OFF
vmhost3 VMHost 1.8GHz x 2 (2.2GHz) 0.0GHz 10.4GB (8.1GB) 0.0GB normal Cluster2 OFF |
Cluster configuration and admission control are enabled (policy: slot)
>rcxadm pool list -name VMHostPool -reserve <RETURN>
NAME TYPE PRIORITY CPU(max.) RESERVE-CPU MEMORY(max.) RESERVE-MEMORY
---- ---- -------- --------- ----------- ------------ --------------
/VMHostPool VM 5 6.6/11.1(1.4GHz x 2) 0.0GHz 21.8/27.4(9.4GB) 0.0GB
NAME TYPE CPU(FREE) RESERVE-CPU MEMORY(FREE) RESERVE-MEMORY STATUS CLUSTER MAINTENANCE
---- ---- --------- ----------- ------------ -------------- ------ ------- -----------
vmhost1 VMHost 1.8GHz x 2 (1.6GHz) 0.0GHz 6.6GB (4.3GB) 0.0GB normal Cluster2 OFF
vmhost2 VMHost 1.8GHz x 2 (2.8GHz) 0.0GHz 10.4GB (9.4GB) 0.0GB normal Cluster2 OFF
vmhost3 VMHost 1.8GHz x 2 (2.2GHz) 0.0GHz 10.4GB (8.1GB) 0.0GB normal Cluster2 OFF |
Cluster configuration and admission control are disabled
>rcxadm pool list -name VMHostPool -reserve <RETURN>
NAME TYPE PRIORITY CPU(max.) RESERVE-CPU MEMORY(max.) RESERVE-MEMORY
---- ---- -------- --------- ----------- ------------ --------------
/VMHostPool VM 5 6.6/11.1(1.4GHz x 2) - 21.8/27.4(9.4GB) -
NAME TYPE CPU(FREE) RESERVE-CPU MEMORY(FREE) RESERVE-MEMORY STATUS CLUSTER MAINTENANCE
---- ---- --------- ----------- ------------ -------------- ------ ------- -----------
vmhost1 VMHost 1.8GHz x 2 (1.6GHz) - 6.6GB (4.3GB) - normal Cluster2 OFF
vmhost2 VMHost 1.8GHz x 2 (2.8GHz) - 10.4GB (9.4GB) - normal Cluster2 OFF
vmhost3 VMHost 1.8GHz x 2 (2.2GHz) - 10.4GB (8.1GB) - normal Cluster2 OFF |
To display the specified VM pool, and a list of the VM hosts and virtual machines included in the pool:
>rcxadm pool list -name /VMHostPool -resource -info lserver <RETURN>
NAME TYPE PRIORITY CPU(max.) MEMORY(max.)
---- ---- -------- --------- ------------
/VMHostPool VM 5 5.4/7.4(1.4GHz x 2) 5.3/9.5(4.6GB)
NAME TYPE CPU(FREE) MEMORY(FREE) STATUS MAINTENANCE
---- ---- --------- ------------ ------ -----------
VMHost1 VMHost 1.8GHz x 2 (2.5GHz) 2.9GB (0.7GB) normal OFF
VMHost2 VMHost 1.8GHz x 2 (2.9GHz) 6.6GB (4.6GB) normal OFF
NAME TYPE VM_HOST L-SERVER
---- ---- ------- --------
Guest1 VirtualMachine VMHost1 /L-Server1
Guest2 VirtualMachine VMHost1 /folder/L-Server2
Guest3 VirtualMachine VMHost1 -
Guest4 VirtualMachine VMHost2 -
Guest5 VirtualMachine VMHost2 - |