3.10 rcxadm pool

Name

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

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

Format

rcxadm pool create -name name -type type [-priority priority] [-label label] [-comment comment] [-attr {over_commit={true|false},[calculated_using={reserve|limit}]|thin={true|false}}] [-nowait]
rcxadm pool list [-reserve] [-extend attributes]
rcxadm pool list -name name [-template template_name] [-resource] [-info lserver] [-reserve] [-extend {attributes|disksize}]
rcxadm pool show -name name
rcxadm pool register -name name {-resource resource_name|-from vstorage} -type resource_type [-force] [-setup_network] [-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]} [-attr {over_commit={true|false},calculated_using={reserve|limit}}] [-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 the disk resource is a LUN that has been created in advance, a LUN for iSCSI boot, or a disk resource for a virtual L-Server, deleting L-Servers or removing disks from an L-Server does not delete the content of disks.
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, a LUN for iSCSI boot, or a disk resource for a virtual L-Server, 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 "14.5 Storage Resources" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
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

create: Creates a resource pool.

list

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:

- CPU(max)

- MEMORY(max)

Table 3.23 VM Pool Information
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 which 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: When calculating the free space with a reservation value, while overcommit is enabled "OverCommit=true,CalculatedUsing=reserve" is displayed. When calculating the free space with the upper limit value, while overcommit is enabled "OverCommit=true,CalculatedUsing=limit" is displayed. When overcommit is disabled "OverCommit=false" 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 "G.1.2 Definition Files for Display Control of VM Pool Attribute Information" in the "Setup Guide CE".

For server pools
Table 3.24 Server Pool Information
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

Table 3.25 Storage Pool Information
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: Virtual storage free space When the allocated size exceeds the total size of the virtual storage resource, the excess is displayed with a minus sign ("-"). max In max, the maximum value is displayed. If free space values of all of registered virtual storage are negative values, the lowest value (the highest number with a minus sign) will be displayed. [OVM for x86 2.2] For the free space of virtual storage resources, refer to "C.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. In max, the maximum disk space which can be allocated to a virtual storage resource is displayed in "SpaceGB" format. [OVM for x86 2.2] For the maximum disk space which can be allocated to a virtual storage resource, refer to "Virtual Storage Resource Free Space" in "C.5.9 Advisory Notes for OVM for x86 2.2 Usage" in the "Setup Guide CE".
ATTRIBUTES (*)	One of the following is displayed: For a storage pool to which the thin provisioning attribute is applied "Thin=true" is displayed. For a storage pool to which the thin provisioning attribute is not applied "Thin=false" is displayed.

* Note: When specifying -extend attributes for the option, this is displayed.

For Network Pools

Table 3.26 Network Pool Information
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
Table 3.27 Address Pool Information
Item Name
Description
NAME
Address pool name
TYPE
Resource pool type
PRIORITY
Priority
ADDRESS
Total number and unused number of addresses
For image pools
Table 3.28 Image Pool Information
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)

Table 3.29 VM Pool Information
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 which 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.
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: When calculating the free space with a reservation value, while overcommit is enabled "OverCommit=true,CalculatedUsing=reserve" is displayed. When calculating the free space with the upper limit value, while overcommit is enabled "OverCommit=true,CalculatedUsing=limit" is displayed. When overcommit is disabled "OverCommit=false" 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.

Table 3.30 Resource Information Included in VM Pools
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

When specifying -resource for the option
Table 3.31 Resource Information Included in VM Hosts
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.

Table 3.31 Resource Information Included in VM Hosts
Item Name	Description
NAME	Virtual machine name
TYPE	Resource types
VM_HOST	VM host
L-SERVER (*)	The linked L-Server name

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

Table 3.32 Server Pool Information
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.

Table 3.33 Resource Information Included in Server Pools
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

Table 3.34 Storage Pool Information
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: Virtual storage free space When the allocated size exceeds the total size of the virtual storage resource, the excess is displayed with a minus sign ("-"). max In max, the maximum value is displayed. If free space values of all of registered virtual storage are negative values, the lowest value (the highest number with a minus sign) will be displayed. [OVM for x86 2.2] For the free space of virtual storage resources, refer to "C.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. In max, the maximum disk space which can be allocated to a virtual storage resource is displayed in "SpaceGB" format. [OVM for x86 2.2] For the maximum disk space which can be allocated to a virtual storage resource, refer to "Virtual Storage Resource Free Space" in "C.5.9 Advisory Notes for OVM for x86 2.2 Usage" in the "Setup Guide CE".
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: For a storage pool to which the thin provisioning attribute is applied "Thin=true" is displayed. For a storage pool to which the thin provisioning attribute is not applied "Thin=false" 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.

Table 3.35 Resource Information Included in Storage Pools
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 "C.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

Table 3.36 Network Pool Information
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

Table 3.37 Resource Information Included in Network Pools
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.

For Address Pools

Table 3.38 Address Pool Information
Item Name	Description
NAME	Address pool name
TYPE	Resource pool type
PRIORITY	Priority
ADDRESS	Total number and unused number of addresses

Table 3.39 Resource Information Included in Address Pools
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

Table 3.40 Image Pool Information
Item Name	Description
NAME	Image pool name
TYPE	Resource pool type
PRIORITY	Priority
IMAGE	Number of images

Table 3.41 Resource Information Included in Image Pools
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 [Citrix Xen] Citrix-Xen [OVM for x86 2.2] ovmm-x86
OS	OS type of the image
DISKS (*)	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: A physical L-Server image Images with the VM type of Xen, KVM, or Oracle VM

* Note: This is displayed when specifying the -extend disksize option. 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 "Chapter 18 Disaster Recovery" in the "Operation Guide CE".

show

To display the detailed information for a resource pool.

The following detailed information is displayed: The displayed information varies depending on the attributes configured for the resource pool, and the status (existence, type) of resources in the resource pool.

Note

The number and display order of the items may be changed by enhancement of Resource Orchestrator.

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

Table 3.42 Detailed Information for VM Pools
Item Name	Description
Name	VM pool name
Type	Resource pool type
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 "Space GB" 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.
OverCommit	It is displayed as follows: When overcommit is enabled "true" is displayed. When overcommit is disabled "false" is displayed.
CalculatedUsing	It is displayed as follows: When calculating the free space using a reservation value "reserve" is displayed. When calculating the free space using the upper limit value "limit" is displayed. Only displayed when overcommit is enabled.

For Server Pools

Table 3.43 Detailed Information for Server Pools
Item Name	Description
Name	Server pool name
Type	Resource pool type
Priority	Priority
Label	Label
Comment	Comment
Server	Total number of physical servers
FreeServer	Number of unused physical servers

For Storage Pools

Table 3.44 Detailed Information for Storage Pools
Item Name	Description
Name	Storage pool name
Type	Resource pool type
Priority	Priority
Label	Label
Comment	Comment
DiskSize(max)	Total virtual storage size For a storage pool to which the thin provisioning attribute is applied, it is displayed as follows: max In max, the maximum value is displayed. [OVM for x86 2.2] If the virtual storage resource is a storage repository of OVM for x86 2.2, it is not displayed. In max, the maximum disk space which can be allocated to a virtual storage resource is displayed in "SpaceGB" format. [OVM for x86 2.2] For the maximum disk space which can be allocated to a virtual storage resource, refer to "Virtual Storage Resource Free Space" in "C.5.9 Advisory Notes for OVM for x86 2.2 Usage" in the "Setup Guide CE".
FreeDiskSize	Virtual storage free space For a storage pool to which the thin provisioning attribute is applied, it is displayed as follows: Virtual storage free space When the allocated size exceeds the total size of the virtual storage resource, the excess is displayed with a minus sign ("-"). [OVM for x86 2.2] For the free space of virtual storage resources, refer to "C.5.9 Advisory Notes for OVM for x86 2.2 Usage" in the "Setup Guide CE".
Thin	It is displayed as follows: For a storage pool to which the thin provisioning attribute is applied "true" is displayed. For a storage pool to which the thin provisioning attribute is not applied "false" is displayed.

For Network Pools

Table 3.45 Detailed Information for Network Pools
Item Name	Description
Name	Network pool name
Type	Resource pool type
Priority	Priority
Label	Label
Comment	Comment
VLANId	Total number of VLANIDs
FreeVLANId	Number of unused VLAN IDs
NetworkDevice	Total number of network devices
InUseNetworkDevice	Total number of network devices in use

For Address Pools

Table 3.46 Detailed Information for Address Pools
Item Name	Description
Name	Address pool name
Type	Resource pool type
Priority	Priority
Label	Label
Comment	Comment
Address	Total number of addresses
FreeAddress	Number of unused addresses

For Image Pools
Table 3.47 Detailed Information for Image Pools
Item Name
Description
Name
Image pool name
Type
Resource pool type
Priority
Priority
Label
Label
Comment
Comment
ImageCount
Image number

Table 3.47 Detailed Information for Image Pools
Item Name	Description
Name	Image pool name
Type	Resource pool type
Priority	Priority
Label	Label
Comment	Comment
ImageCount	Image number

register: Registers a resource to a resource pool.

unregister: Unregisters resources from resource pools.

modify: Modifies the name, label, comment, and priority of a resource pool.
Modifies the calculation method for overcommit attributes and free space for VM pools.

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.

For the resource pool allocated in the resource folder, specify the resource folder name using slashes ("/").

-type type

In type, specify the resource pool type.

The following values can be specified:

Table 3.48 List of Resource Pool Types
type	Resource Pool Types
vm	VM pool
server	Server pool
storage	Storage pool
network	Network pool
address	Address pool
image	Image pool

-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.

For the priority order, "1" is the highest and "10" is the lowest.

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

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

-attr attr

Specify the attributes for the resource pool. When specifying multiple attributes, separate them using commas.

For VM Pools
over_commit={true|false}
Specify enabling/disabling of overcommit.
- When enabling overcommit
  Specify "true".
- When disabling overcommit
  Specify "false".
calculated_using={reserve|limit}
Specify the calculation method for free space for the VM pools for which overcommit is enabled.
- When calculating the free space using a reservation value
  Specify "reserve".
- When calculating the free space using the upper limit value
  Specify "limit".
For Storage Pools
thin={true|false}
Specify one of following items.
- When configuring Thin Provisioning attributes
  Specify "true".
- When not configuring Thin Provisioning attributes
  Specify "false".

Note

When performing upgrade of an admin server from ROR V2.2.0 or V3.0.0, this option cannot be specified if the migration procedure given in the configuration methods for the overcommit functions is not performed. Edit the definition files separately. For details, refer to "G.1.1 Overcommit Definition Files" in the "Setup Guide CE".

-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.

-extend attributes: Specify when displaying additional information.

-extend 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.

-from vstorage

In vstorage, specify the name of a virtual storage resource.

Specify when adding the all disk resources in the specified virtual storage resource, to a resource pool.

-type resource_type

In resource_type, specify a type for the resource.

The following values can be specified:

Table 3.49 List of Resource Types
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 image (physical)
vm_image	Cloning image (virtual)
netdevice	Network device

-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.

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 ("/").

-force

When deleting a resource pool
Use this option to forcibly delete a resource pool that includes resources.
The operation is the same as for deleting the resources in a resource pool.
The following resources registered in the resource pool will be unregistered:
- VM Host Resources
- Physical Server Resources
- Virtual Storage Resources
- Disk Resources
- Network Devices
- Physical Image Resources
When registering resources in a resource pool
Specify when registering a physical server with an operating system installed to a server pool.
In other cases, do not specify.

-resource

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.

-info lserver

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.

-reserve

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.

-setup_network

Specify this option when using the same network configuration as the other servers in a cluster.

This is valid when a VM pool is specified for the -name option.

Examples

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

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.7 GB(6.7 GB)
FreeMemorySize: 6.7 GB

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: Host failures the cluster tolerates)

>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              -