3.9 rcxadm network

Name

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

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

Format

rcxadm network create -file file.xml [-nowait]
rcxadm network list [-extend lock]
rcxadm network show -name name [-format {text|xml}] [-verbose] [-extend lock]
rcxadm network move -name name -to pool [-nowait]
rcxadm network delete -name name [-nowait]
rcxadm network modify -name name -file file.xml [-nowait]
rcxadm network setup -name name -vmhost vmhost[,vmhost[,・・・]] [-nowait]

Description

rcxadm network is the command used to operate network resources.
Define network resources in the network used for a communication path using this command. IP address ranges to be allocated and subnet mask information can be managed.

Subcommands

create

Creates a network resource.

When the network device auto-configuration function is used, the script deployed for the configuration is executed and the network devices are automatically configured (network device definitions are added).

modify

Changes a network resource.

When the network device auto-configuration function is used, the script deployed for the configuration modification is executed and the network devices are automatically configured (network devices definitions are modified).

list

Displays a list of network resources.

The following detailed information is displayed:

Table 3.21 Network Resource Information
Item Name	Description
NAME	Network resource name
VLAN_ID	Network resource VLAN ID
SUBNET	Network resource subnet
LABEL	Network resource label
TYPE	Network resource type One of the following is displayed: For an admin LAN "admin" is displayed. For a public LAN or iSCSI LAN A blank space is displayed.
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.

show

Displays the details for a network resource.

The following detailed information is displayed:

Table 3.22 Detailed Information for Network Resources
Item Name	Description
NAME	Network resource name
TYPE	Network resource type One of the following is displayed: For an admin LAN "admin" is displayed. For a public LAN or iSCSI LAN A blank space is displayed.
LABEL	Network resource label
AUTO	Automatic configuration for network resources One of the following is displayed: When a network environment configured automatically is used "true" is displayed. When a network environment configured manually is used "false" is displayed.
COMMENT	Network resource comment
VLAN_ID	Network resource VLAN ID
PHYSICAL_LAN_SEGMENT	Network resource physical LAN segment name If no physical LAN segment is set, no content is displayed.
AUTO_SWITCH_CONFIGURATION	Automatic configuration for network devices (L2 switches) One of the following is displayed: When performing automatic configuration for network devices (L2 switches) "true" is displayed. When not performing automatic configuration for network devices (L2 switches) "false" is displayed. When auto-configuration of network devices (L2 switches) is not configured, only the item name is displayed and the content of auto-configuration is not displayed.
RULESET_NAME	Name of the ruleset used for network resources When there is no ruleset registered, only the item name is displayed and the ruleset name is not displayed.
SUBNET	Network resource subnet
MASK	Network resource subnet mask
START - END	IP address range auto-configuration
EXCLUDE_ADDRESS_RANGE [num] (*1)	Exclusion range of IP addresses for auto-configuration For the scope of IP addresses automatically generated by DR switchover or failback, "DR" is displayed. In num, the index number of an IP address range to be excluded is displayed. The number is an integer starting from "0".
DEFAULT_GATEWAY	Default gateway If no default gateway is set, this item is not displayed.
VLAN_AUTO_SETTING	Automatic VLAN configuration for external connection ports One of the following is displayed: When automatically performing VLAN configuration for external connection ports "true" is displayed. When not automatically performing VLAN configuration for external connection ports "false" is displayed.
EXTERNAL_PORT_CHASSIS [num]	External port chassis name This item is displayed when a port of an LAN switch blade is specified. In num, the index number of an external connection port element is displayed. The number is an integer starting from "0".
EXTERNAL_PORT_SWITCH [num]	External port switch name In num, the index number of an external connection port element is displayed. The number is an integer starting from "0".
EXTERNAL_PORT_NUMBER [num]	External port port number This item is displayed when a physical port of an LAN switch blade is specified. In num, the index number of an external connection port element is displayed. The number is an integer starting from "0".
EXTERNAL_PORT_LAG [num]	Link aggregation port name of the external port This item is displayed when a port that is part of a link aggregation configuration, of an LAN switch blade, is specified. [changed] is displayed if the link aggregation group that was specified when the network resource was created or changed is removed. In num, the index number of an external connection port element is displayed. The number is an integer starting from "0".
EXTERNAL_PORT_NAME [num]	External Connection Port Name This item is displayed when a port of an Ethernet fabric switch is specified. In num, the index number of an external connection port element is displayed. The number is an integer starting from "0".
L_SERVER [num]	Name of the L-Server connected to the network resource, and the IP address being used In num, the index number of an L-Server connected to the network resource is displayed. The number is an integer starting from "0".
VM_HOST [num] (*2)	Resource name of the VM host the network resource is deployed on In num, the index number of the VM host is displayed. The number is an integer starting from "0".
ATTRIBUTES (*3)	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.

*1: "DR" is displayed when -extend lock is specified for the option.
*2: This is displayed when -verbose is specified for the option.
*3: This is displayed when -extend lock is specified for the option.

move: Moves a network resource to the specified resource pool.

delete

Deletes a network resource.

When the network device auto-configuration function is used, the script deployed for the configuration deletion is executed and the network devices are automatically configured (network devices definitions are deleted).

setup: Performs auto-configuration of the network resource on the specified VM host.

Options

-file file.xml: In file.xml, specify the XML file that defines the network resource.
For details on the XML file definition, refer to "15.5.1 Creation".

-format text|xml

Specify the display format.

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

text: The information is displayed in text format.

xml: The information is displayed in XML format with XML tags.

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

-name name: In name, specify the name of the target network resource to perform an operation with.

-to pool

Specify the destination resource folder in pool.

For the hierarchized resource folder, specify the resource folder name using slashes ("/").

-verbose: Specify when displaying detailed information.

-vmhost vmhost[,vmhost[,・・・]]

Specify the network resource that is the target of auto-configuration using the resource name of a registered VM host.

When specifying multiple targets, separate the resource names of VM hosts using commas (",").

-extend lock: Specify when displaying additional information.

Examples

To display the list of network resource information:

>rcxadm network list -extend lock <RETURN>
NAME                             VLAN_ID SUBNET          LABEL                   TYPE  ATTRIBUTES
----                             ------- ------          -----                   ----  ----------
net_aa1                          1234    20.10.10.0      net_label               admin locked(DR)
net_aa2                          1235    20.10.11.0      -                       -     locked(DR)

To display the detailed information for a network resource:

>rcxadm network show -name net_aa1 -extend lock <RETURN>
name: net_aa1
type: admin
label: net_label
auto: true
comment: net_comment
vlan_id: 1234
physical_lan_segment:
auto_switch_configuration: true
ruleset_name: rule1
attributes: unlocked(DR)
subnet: 20.10.10.0
mask: 255.255.255.0
start - end: 20.10.10.1 - 20.10.10.254
exclude_address_range[0]: 20.10.10.51 - 20.10.10.55
exclude_address_range[1]: 20.10.10.1 - 20.10.10.10
exclude_address_range[2]: 20.10.10.15 - 20.10.10.17 (DR)
exclude_address_range[3]: 20.10.10.20 - 20.10.10.20 (DR)
default_gateway[0]: 20.10.10.1
vlan_auto_setting: true
external_port_chassis[0]: bx900
external_port_switch[0]: bx900-lan1
external_port_number[0]: 41
external_port_chassis[1]: bx900
external_port_switch[1]: bx900-lan2
external_port_number[1]: 41
external_port_switch[2]: CFAB1
external_port_name[2]: EthernetPort(1/2/0/60)
l_server[0]: a (20.10.10.11)