1.3.5 rcxadm network

Name

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

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

Format

rcxadm network create -file file.xml [-nowait]
rcxadm network list
rcxadm network show -name name [-format {text|xml}]
rcxadm network move -name name -to pool [-nowait]
rcxadm network delete -name name [-nowait]
rcxadm network modify -name name -file file.xml [-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 1.11 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.

show

Displays the details for a network resource.

The following detailed information is displayed:

Table 1.12 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 VLAN 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]	Exclusion range of IP addresses for auto-configuration 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 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 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 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".
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".

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

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 "2.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 ("/").

Examples

To display the list of network resource information:

>rcxadm network list <RETURN>
NAME                  VLAN_ID SUBNET             LABEL       TYPE
----                  ------- ------             -----       ----
net_aa1               -       20.10.10.0         net_label   admin
net_aa2               -       20.10.11.0         -

To display the detailed information for a network resource:

>rcxadm network show -name net_aa1 <RETURN>
name: net_aa1
type: admin
label: net_label
auto: true
comment: net_comment
vlan_id: 1234
physical_lan_segment: A
auto_switch_configuration: true
ruleset_name: rule1
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.1 - 20.10.10.10
exclude_address_range[1]: 20.10.10.51 - 20.10.10.55
default_gateway: 20.10.10.1
vlan_auto_setting: true
external_port_chassis[0]: chassis
external_port_switch[0]: switch_aa
external_port_lag[0]: linkaggregation1
external_port_chassis[1]: chassis
external_port_switch[1]: switch_bb
external_port_number[1]: 41
external_port_chassis[2]: chassis2
external_port_switch[2]: switch_cc
external_port_lag[2]: linkaggregation2 [changed]
l_server[0]: a (20.10.10.2)