Installation_folder\SVROR\Manager\bin\rcxadm pool - resource pool operation
rcxadm pool list [-reserve] [-extend attributes] rcxadm pool list -name name [-template template_name] [-resource] [-info lserver] [-reserve] [-extend attr[,attr[,...]]]
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.
Displays a list of resource pools.
The following detailed information is displayed:
When specifying -extend attributes for the option
Additional information is displayed.
When not specifying -name for the option
The information for all the resource pools that can be accessed 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:
|
Item Name |
Description |
|---|---|
|
NAME |
VM pool name |
|
TYPE |
Resource pool type |
|
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 "Performance GHz * 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 that can be allocated to a VM host is displayed in "Space GB" 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. |
|
ATTRIBUTES (*2) |
The calculation method for overcommit attributes and free space for VM pools. One of the following is displayed:
|
*1: When specifying -reserve for the option, this is displayed.
*2: When specifying -extend attributes for the option, this is displayed. Immediately after performing upgrade of an admin server from ROR V2.2.0 or V3.0.0, this item cannot be displayed even if the -extend attributes option is specified. To display this item, delete the definition file explained in "2.3.1.2 Definition Files for Display Control of VM Pool Attribute Information" in the "Release Notes".
For Server Pools
|
Item Name |
Description |
|---|---|
|
NAME |
Server pool name |
|
TYPE |
Resource pool type |
|
PRIORITY |
Priority |
|
SERVER |
The total and unused number of physical servers |
For storage pools
|
Item Name |
Description |
|---|---|
|
NAME |
Storage pool name |
|
TYPE |
Resource pool type |
|
PRIORITY |
Priority |
|
CAPACITY(max) |
The total size and the free size of the virtual storage memory For a storage pool to which the thin provisioning attribute is applied, it is displayed as follows:
|
|
ATTRIBUTES (*) |
One of the following is displayed:
|
* Note: When specifying -extend attributes for the option, this is displayed.
For Network Pools
|
Item Name |
Description |
|---|---|
|
NAME |
Network pool name |
|
TYPE |
Resource pool type |
|
PRIORITY |
Priority |
|
VLANID |
Total number and unused number of VLAN IDs |
|
NETWORKDEVICE(in use) |
Total number of network devices, and the number of in use network devices |
For address pools
|
Item Name |
Description |
|---|---|
|
NAME |
Address pool name |
|
TYPE |
Resource pool type |
|
PRIORITY |
Priority |
|
ADDRESS |
Total number and unused number of addresses |
For image pools
|
Item Name |
Description |
|---|---|
|
NAME |
Image pool name |
|
TYPE |
Resource pool type |
|
PRIORITY |
Priority |
|
IMAGE |
Number of images |
When specifying -name for the option
The specified resource pool and a list of the resources included in the resource pool are 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:
CPU(max)
MEMORY(max)
CPU(FREE)
MEMORY(FREE)
|
Item Name |
Description |
|---|---|
|
NAME |
VM pool name |
|
TYPE |
Resource pool type |
|
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 "Performance GHz * 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 that can be allocated to a VM host is displayed in "Space GB" 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. |
|
PER-TEMPLATE (*2) |
Number of L-Servers which can be created in the specified L-Server template definition |
|
ATTRIBUTES (*3) |
The calculation method for overcommit attributes and free space for VM pools. One of the following is displayed:
|
*1: When specifying -reserve for the option, this is displayed.
*2: When specifying -template for the option, this is displayed.
The number of possible L-Servers is displayed based on the VM type (VMtype) of the virtual L-Server template and the specified CPU architecture (CPUArch).
For details, refer to "20.6 Viewing" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
*3: When specifying -extend attributes 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 number of possible L-Servers is displayed based on the VM type (VMtype) of the virtual L-Server template and the specified CPU architecture (CPUArch).
For details, refer to "20.6 Viewing" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
When specifying -resource for the option
|
Item Name |
Description |
|---|---|
|
NAME |
Virtual machine name |
|
TYPE |
Resource types |
|
VM_HOST |
VM host |
|
L-SERVER (*) |
The linked L-Server name |
* Note: 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, "0" 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 type |
|
PRIORITY |
Priority |
|
SERVER |
The total and unused number of physical servers |
|
PER-TEMPLATE (*) |
Number of L-Servers which can be created in the specified L-Server template definition |
* Note: 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 |
|
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.
|
Item Name |
Description |
|---|---|
|
NAME |
Storage pool name |
|
TYPE |
Resource pool type |
|
PRIORITY |
Priority |
|
CAPACITY(max) |
The total size and the free size of the virtual storage memory For a storage pool to which the thin provisioning attribute is applied, it is displayed as follows:
|
|
PER-TEMPLATE (*1) |
Number of L-Servers which can be created in the specified L-Server template definition |
|
ATTRIBUTES (*2) |
One of the following is displayed:
|
*1: When specifying -template for the option, this is displayed.
Regarding the resources that can be used on the virtual L-Server, the number of possible L-Servers is displayed based on the VM type (VMtype) of the virtual L-Server template and the specified CPU architecture (CPUArch).
For details, refer to "20.6 Viewing" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
*2: When specifying -extend attributes 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 [OVM for x86 2.2] For the free space of virtual storage resources, refer to "8.5.9 Advisory Notes for OVM for x86 2.2 Usage" in the "Setup Guide CE". The total size of virtual storage resources will not be displayed when the virtual storage resource is an OVM for x86 2.2 storage repository. Free space is displayed in FREE: |
|
STATUS |
Resource status |
|
PER-TEMPLATE (*) |
Number of L-Servers which can be created in the specified L-Server template definition |
* Note: When specifying -template for the option, this is displayed.
Regarding the resources that can be used on the virtual L-Server, the number of possible L-Servers is displayed based on the VM type (VMtype) of the virtual L-Server template and the specified CPU architecture (CPUArch).
For details, refer to "20.6 Viewing" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
For Network Pools
|
Item Name |
Description |
|---|---|
|
NAME |
Network pool name |
|
TYPE |
Resource pool type |
|
PRIORITY |
Priority |
|
VLANID |
Total number and unused number of VLAN IDs |
|
NETWORKDEVICE(in use) |
Total number of network devices, and the number of in use network devices |
|
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: |
|
STATUS |
Network device status |
|
NETDEVICE_TYPE |
Network device type |
|
RULESET |
Ruleset name set for the network device When there is more than one, they are displayed separated by commas. |
|
RESOURCE |
Name of the resource that is using network devices When there is more than one, they are displayed separated by commas. |
|
DEPLOYABLE_L-PLATFORM_NUMBER (FREE) |
The number of L-Platforms which can be deployed (unused number and total number) The unused number is displayed in FREE: |
For Address Pools
|
Item Name |
Description |
|---|---|
|
NAME |
Address pool name |
|
TYPE |
Resource pool type |
|
PRIORITY |
Priority |
|
ADDRESS |
Total number and unused number of addresses |
|
Item Name |
Description |
|---|---|
|
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 type |
|
PRIORITY |
Priority |
|
IMAGE |
Number of images |
|
Item Name |
Description |
|---|---|
|
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 identifier information [VMware] vmware-vc [Hyper-V] ms-scvmm [KVM] RHEL-KVM [Solaris Zones] SolarisContainer [OVM for SPARC] OVM-SPARC [Citrix Xen] Citrix-Xen [OVM for x86 3.x] ovmm-x86 |
|
OS |
OS type of the image |
|
DISKS (*1) |
The disk sizes of the cloning image are displayed, with the system disk size first, then data disk size. Hyphens("-") are displayed for the following cloning images:
|
|
RELATION (*2) |
Name of server management software linked to cloning images When VM type identifier information is something other than "Solaris Container" or "OVM-SPARC", a hyphen ("-") is displayed. [Solaris Zones] [OVM for SPARC]
|
*1: When -extend disksize is specified for an option, the item is displayed. Disk size may not be displayed immediately after updating Resource Orchestrator from V3.0 or an earlier version or immediately after performing recovery operations using Disaster Recovery. Wait for a short while and then perform the operation again.
For details on Disaster Recovery, refer to the "DR Option Instruction".
*2: The item is displayed only when -extend relation is specified for an option.
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 template_name, specify the name of an L-Server template that can be created.
Specify when displaying additional information. When specifying multiple attributes, separate them using commas.
attributes
Specify when displaying additional information. When using with the -name option, only storage pools or VM pools can be specified for the -name option.
disksize
Specify this option to display the disk size of the cloning image. This option can only be specified when an image pool is selected for the -name option.
relation
Specify when displaying the name of the server management software linked to the cloning image. This option can only be specified when an image pool is selected for the -name option.
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.
Refer to "5.1.2 Roles and Available Operations" in the "Design Guide CE".
Admin server
To display the list of resource pools:
>rcxadm pool list -extend attributes <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.) ATTRIBUTES ---- ---- -------- -------------- ------------ /StoragePool Storage 5 449.7/3061.8(351.7GB) Thin=false /ThinStoragePool Storage 5 449.7/3061.8(351.7GB) Thin=true NAME TYPE PRIORITY VLANID NETWORKDEVICE(in use) ---- ---- -------- ------ ------ /NetworkPool Network 5 0/0 10(5) NAME TYPE PRIORITY ADDRESS ---- ---- -------- ------- /AddressPool Address 5 249/257 NAME TYPE PRIORITY IMAGE ---- ---- -------- ----- /ImagePool Image 5 10
When the calculation for the available space for a VM pool used for overcommit is set with a reservation value, in the case of the output example above, the following values will be the values calculated using the reservation value:
37.6 and (1.8 GHz x 8), which are displayed for CPU(max.)
23.3 and (8.0 GB), which are displayed for MEMORY(max.)
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
When the calculation for the available space for a VM pool used for overcommit is set with a reservation value, in the case of the output example above, the following values will be the values calculated using the reservation value:
37.6 and (1.8 GHz x 8), which are displayed for CPU(max.)
23.3 and (8.0 GB), which are displayed for MEMORY(max.)
(7.9 GHz), (14.6 GHz), and (14.9 GHz), which are displayed for CPU(FREE)
(6.4 GB), (8.7 GB), and (8.0 GB), which are displayed for MEMORY(FREE)
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: Percentage of cluster resources reserved as failover spare capacity (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: Specify failover hosts (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: The cluster tolerates host failures)
>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 -
To display a list of address set resources contained in the specified address pool
>rcxadm pool list -name /AddressPool <RETURN> NAME TYPE PRIORITY ADDRESS ---- ---- -------- ------- /AddressPool Address 5 8872/8879 NAME TYPE ADDRESS(FREE) ---- ---- ------------- AAA MacAddressSet 15(15) AppLAN1 WwnAddressSet 17(17) macset1 MacAddressSet 4272(4270) name MacAddressSet 255(251) wwnset1 WwnAddressSet 4320(4319) gip GipAddressSet 15(15)
This command returns the following values:
The command executed successfully.
An error has occurred.
