3.1 rcxadm addrset

Name

[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxadm addrset - address set resource operations

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm addrset - address set resource operations

Format

rcxadm addrset create -name name -type {MAC|WWN} -file file -pool pool [-exclude address[,address]...] [-label label] [-comment comment] [-nowait]
rcxadm addrset list [-verbose [-extend lock]]
rcxadm addrset show -name name [-format {text|xml}] [-extend lock]
rcxadm addrset move -name name [-to pool] [-nowait]
rcxadm addrset delete -name name [-nowait]

Description

rcxadm addrset is the command used to manage WWNs and MAC addresses.

For details on the conditions under which it is necessary to create address set resources and register them in address pools, refer to "14.6 Address Set Resources" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

Subcommands

create: Creates and registers an address set resource in the address pool.

list

Displays a list of address set resources.

The following detailed information is displayed:

Table 3.1 List of Address Set Resource Information
Item Name	Description
NAME	Name of the address set resource
TYPE	Type of the address set resource (MAC or WWN)
START-END	Start and end addresses of the address set resource
ATTRIBUTES (*)	Information when resources are locked during DR execution One of the following is displayed: When resources are locked "locked(DR)" is displayed. When resources are not locked "unlocked(DR)" is displayed.

* Note: This is displayed when -extend lock is specified for the option.

If the -verbose option is specified, in addition to the above information, the following information is displayed:

Table 3.2 List of Address Set Resource Information (verbose)
Item Name	Description
FREE	Number of unused addresses of the address set resource
USED	Number of the addresses of the address set resource in use
LABEL	Label of the address set resource

show

Displays details of address set resources.

The following detailed information is displayed:

Table 3.3 Detailed Information for Address Set Resources
Item Name	Description
NAME	Name of the address set resource
TYPE	Type of the address set resource (MAC or WWN)
LABEL	Label of the address set resource
COMMENT	Comment on the address set resource information
START-END	Start and end addresses of the address set resource
EXCLUDE_ADDRESS	Excluded-addresses of the address set resource
RESERVE_ADDRESS	Addresses of the address set resource in use
FREE	Number of unused addresses of the address set resource
USED	Number of the addresses in use of the address set resource
ATTRIBUTES (*)	Information when resources are locked during DR execution One of the following is displayed: When resources are locked "locked(DR)" is displayed. When resources are not locked "unlocked(DR)" is displayed.

* Note: This is displayed when -extend lock is specified for the option.

move: Moves an address pool to the specified resource folder.

delete: Deletes an address pool. Address set resources contained in the address pool will also be deleted.

Options

-name name

In name, specify the name of the target address set resource to perform an operation with.

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

-verbose: Specify when displaying detailed information.

-type: Specify WWN or MAC address.

-file file

When using the I/O Virtualization Option, specify the WWN in the enclosed CD-ROM, or the list file of the MAC address. When specifying a unique address, describe the following in the file, and specify the address.

The first line is the starting point and the last line is the end point of the addresses managed by Resource Orchestrator.
Enter the addresses in the following format:
- Specify the MAC addresses in hexadecimal form, separated by blank spaces (" ").
  Example
  A list file in which MAC addresses are "12 34 56 78 00 00" to "12 34 56 78 00 ff"
  12 34 56 78 00 00
  12 34 56 78 00 ff
- Specify the WWN addresses in hexadecimal form, separated by blank spaces (" "). [Physical Servers]
  Example
  A list file in which WWN addresses are "20 00 00 17 42 50 00 00" to "20 00 00 17 42 50 00 ff"
  20 00 00 17 42 50 00 00
  20 00 00 17 42 50 00 ff
Specifiable MAC address ranges may differ depending on server virtualization software. For details, refer to the server virtualization software manual. [Xen] [KVM] [Citrix Xen] [OVM for x86 3.2]

-exclude: Of the WWNs and MAC addresses given in the list file on the CD-ROM enclosed with the I/O Virtualization Option, specify an address that has been allocated using ROR VE or VIOM and is not used in management by Resource Orchestrator.

-pool pool

For pool, specify the name of the resource pool to register an address set resource in.

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

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

-label label: In label, specify the label for the address set resource.

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

-to pool: Specify the destination address pool in pool. If omitted, address set resources will not be moved.

-format text|xml

Specify the display format. You can specify text or xml format.

When -format is omitted, it is displayed in text format.

-extend lock: Specify when displaying additional information.

Examples

To display the list of address set resource information:

>rcxadm addrset list <RETURN>
NAME       TYPE  START                    END
----       ----  -----                    ---
macdata1   WWN   20:00:00:17:42:00:00:20  20:00:00:17:42:00:10:ff
wwndata1   MAC   00:e5:35:0c:34:50        00:e5:35:0c:44:ff

To display the detailed information of address set resources (WWNs):

>rcxadm addrset show -name wwndata <RETURN>
name: wwndata1
type: WWN
label: wwn1
comment: wwn-test-data-1
start-end:20: 01:00:17:42:50:00:00 - 20:01:00:17:42:50:00:0f
exclude_address:
reserve_address: 20:01:00:17:42:50:00:00
free: 15
used: 1

To display the detailed information of address set resources (MAC addresses):

>rcxadm addrset show -name macdata1 <RETURN>
name: macdata1
type: MAC
label: mac1
comment: mac-test-data1
start-end: 00:17:42:4f:00:00 - 00:17:42:4f:00:f0
exclude_address:
reserve_address: 00:17:42:4f:00+00
free: 240
used: 1

To display the list of locked address set resource information:

>rcxadm addrset list -extend lock <RETURN>
NAME                       TYPE START                   END                     ATTRIBUTES
----                       ---- -----                   ---                     ----------
macdata1                   MAC  00:e5:35:0c:34:50       00:e5:35:0c:44:ff       locked(DR)
wwndata1                   WWN  20:00:00:17:42:00:00:20 20:00:00:17:42:00:10:ff locked(DR)

To display the list of locked address set resource (WWN) detailed information:

>rcxadm addrset show -name wwndata1 -extend lock <RETURN>
name: wwndata1
type: WWN
label: wwn1
comment: wwn-data1
start-end: 20:00:00:17:42:00:00:20 - 20:00:00:17:42:00:10:ff
exclude_address:
reserve_address: 8:00:00 PM:5:42:00 PM:12:20 AM
free: 4319
used: 1
attributes: locked(DR)

To display the list of locked address set resource (MAC address) detailed information:

>rcxadm addrset show -name macdata1 -extend lock <RETURN>
name: macdata1
type: MAC
label: mac1
comment: mac-data1
start-end: 00:e5:35:0c:34:50 - 00:e5:35:0c:44:ff
exclude_address:
reserve_address: 00:E5:35:0C:34:50
free: 4271
used: 1
attributes: locked(DR)