1.3.8 rcxadm addrset

Name

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

[Linux]
/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]
rcxadm addrset show -name name
rcxadm addrset move -name name [-to folder] [-nowait]
rcxadm addrset delete -name name [-nowait]

Description

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

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 1.42 Address Set Resource Information
Item Name	Description
ADDRESSSET NAME	Address set resource name (for WWNs and MAC addresses)
LABEL	Address set resource label (for WWNs and MAC addresses)

show

To display details of address set resources.

The following detailed information is displayed:

Table 1.43 Detailed Information for Address Set Resources
Item Name	Description
NAME	Address set resource name (for WWNs and MAC addresses)
LABEL	Address set resource label (for WWNs and MAC addresses)
SUBNET	Not displayed
MASK	Not displayed
START - END	START Start WWNs and start MAC addresses given in the list file on the CD-ROM enclosed with the I/O Virtualization Option END End WWNs and end MAC addresses given in the list file on the CD-ROM enclosed with the I/O Virtualization Option
COMMENT	Address set resource comment (for WWNs and MAC addresses)
EXCLUDE	An address that has been allocated using RCVE or VIOM, and is not used by Resource Orchestrator in management of the WWNs and MAC addresses given in the list on the CD-ROM enclosed with the I/O Virtualization Option
RESERVE	Address set resource (in use or for MAC addresses)

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: Use this option to increase the items displayed in the list of information.

-type: Specify WWN or MAC address.

-file file

Specify the WWN in the CD-ROM enclosed in the I/O Virtualization Option, or the list file of the MAC address.

[Xen]

Specify the MAC addresses in hexadecimal form, separated by blank spaces (" ").
The first line is the starting point and the last line is the end point of the MAC addresses managed by Resource Orchestrator.
An example of the list file, in which 65536 MAC addresses ("02 17 42 2f 00 00" to "02 17 42 2f ff ff") are specified, is as follows:
Example
02 17 42 2f 00 00 ... 02 17 42 2f ff ff

-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 RCVE or VIOM and is not used in management by Resource Orchestrator.

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

-comment comment: In comment, specify the new comments.

-to folder: Specify the destination resource folder. When omitted, the server is moved to the home folder.

Examples

To display the list of address set resource information:

>rcxadm addrset list <RETURN>
<?xml version="1.0" encoding="utf-8"?>

<AddressSets>
  <AddressSet name="macdata1" id="543" label="mac1" />
  <AddressSet name="wwndata1" id="540" label="wwn1" />
</AddressSets>

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

>rcxadm addrset show -name wwndata1 <RETURN>
<?xml version="1.0" encoding="utf-8"?>

<AddressSet name="wwndata1" id="540" label="wwn1" subnet="" mask="" start="20:01:00:17:42:50:00:00" end="20:01:00:17:42:50:00:0f">
  <Comment>wwn-test-data-1</Comment>
  <Exclude>
  </Exclude>
  <Reserve>
  </Reserve>
</AddressSet>

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

>rcxadm addrset show -name macdata1 <RETURN>
<?xml version="1.0" encoding="utf-8"?>

<AddressSet name="macdata1" id="543" label="mac1" subnet="" mask="" start="00:17:42:4f:00:00" end="00:17:42:4f:00:f0">
  <Comment>mac-test-data-1</Comment>
  <Exclude>
  </Exclude>
  <Reserve>
  </Reserve>
</AddressSet>