Top
ServerView Resource Orchestrator Cloud Edition V3.4.0 Reference Guide (Command/XML)
FUJITSU Software

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|GIP} -file file -pool pool [-exclude address[,address[,...]]] [-label label] [-comment comment] [-nowait]
rcxadm addrset modify -name name -file file.xml [-nowait]
rcxadm addrset list [-verbose] [-format {text|xml}] [-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, MAC addresses, and global IP 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".

GIP address set resources are used for handling the global IP addresses. For a GIP address set resource, configure a unicast global IP address which can be configured for firewalls and SLBs.

Configure an IP between 1.0.0.0 and 255.255.255.254, excluding the loopback addresses (127.0.0.0 - 127.255.255.255) and the multicast addresses (224.0.0.0 - 239.255.255.255).


Subcommands

create

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

modify

Modifies GIP address set resources. WWN or MAC address set resources cannot be used.

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, WWN, or GIP)

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, WWN, or GIP)

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
  • When the subcommand is "create"

    In name, specify the name of the target address set resource to perform an operation with.
    Specify a name that is different from the resource name (address set name) of the network resource or the other address set resource name.

  • When the subcommand is something other than "create"

    In name, specify the name of the target address set resource to perform an operation with.
    To specify an address set resource that is stored in a tenant or a resource folder, it is also necessary to specify the tenant name or the resource folder name connected with a slash ("/").

-verbose

Specify when displaying detailed information.

-type

Specify WWN, MAC address, or GIP address.

-file file
To create WWN and MAC address set resources

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" - "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" - "20 00 00 17 42 50 00 ff"

    20 00 00 17 42 50 00 00
    20 00 00 17 42 50 00 ff

  • The number of MAC/WWN addresses that can be specified within the range from the starting point to the end point of the address is 1-65536.

  • 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.x]

To create GIP address set resources

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:

    Global IP addresses: specify in decimal format, separated by periods (".").

    Example

    A list file in which global IP addresses are "192.168.10.1" - "192.168.10.5"

    192.168.10.1
    192.168.10.5

-file file.xml

In file.xml, specify the XML file that defines the global IP address set resources.

For details on the XML file definition, refer to "15.5 Address Set Resources".

-exclude
MAC address, WWN address

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

Global IP Address

Specify the IP addresses to exclude in decimal format, separated by periods (".").

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


Requirements

Permissions

Refer to "5.1.2 Roles and Available Operations" in the "Design Guide CE".

Location

Admin server


Examples

Exit Status

This command returns the following values:

0

The command executed successfully.

non-zero

An error has occurred.