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 [-format {text|xml}] 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.
Subcommands
Creates and registers an address set resource in the address pool.
Displays a list of address set resources.
The following detailed information is displayed:
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 |
If the -verbose option is specified, in addition to the above information, the following information is displayed:
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 |
Displays details of address set resources.
The following detailed information is displayed:
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 |
Moves an address pool to the specified resource folder.
Deletes an address pool. Address set resources contained in the address pool will also be deleted.
Options
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 ("/").
Specify when displaying detailed information.
Specify WWN or MAC address.
For file, specify the WWN in the CD-ROM enclosed in the I/O Virtualization Option, or the list file of the MAC address.
[Xen/KVM]
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.
Specifiable MAC address ranges may differ depending on server virtualization software. For details, refer to the server virtualization software manual.
An example of the list file, in which MAC addresses ("12 34 56 78 00 00" to "12 34 56 78 ff ff") are specified, is as follows:
Example
12 34 56 78 00 00 12 34 56 78 ff ff |
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.
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 ("/").
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.
In label, specify the label for the address set resource.
In comment, specify any comments for the address set resource.
Specify the destination address pool in pool. If omitted, address set resources will not be moved.
Specify the display format. You can specify text or xml format.
When -format is omitted, it is displayed in text format.
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 |