3.3 rcxadm netdevice

Name

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

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

Format

rcxadm netdevice create -file file.xml [-nowait]
rcxadm netdevice delete -name name [-nowait]
rcxadm netdevice list
rcxadm netdevice modify -name name -file file.xml [-nowait]
rcxadm netdevice set -name name -attr mode={active [-with_va]|maintenance} [-nowait]
rcxadm netdevice show -name name
rcxadm netdevice refresh -name name [-recreate] [-nowait]

Description

rcxadm netdevice is the command used to operate network devices.

Subcommands

create

Creates a network device.

Information

If two or more pieces of network device information are defined in the network configuration information definition file, the resource creation process is terminated and device registration fails.
When registering two or more network devices for resources in one operation, use the rcxadm netconfig command.

delete: Deletes a network device.

list

Displays a list of network devices.

The following detailed information is displayed:

Table 3.1 Network Device Information
Item Name	Description
NAME	Network device name
IPADDRESS	Admin IP address for the network device
NETDEVICE_TYPES	Network device type When there is more than one, they are displayed separated by commas. For virtual appliances, the type is displayed with "(virtual)" added.
STATUS	Network device operation status One of the following is displayed: For normal status "normal" is displayed. For error status "error" is displayed. For warning status "Warning" is displayed. For unknown status "unknown" is displayed.
MAINTENANCE	Maintenance mode setting status for the network device One of the following is displayed: When maintenance mode is set "ON" is displayed. When maintenance mode is not set "OFF" is displayed.

modify: Modifies a network device.

set: Perform switchover of the maintenance mode of the network device.

show

Displays the detailed information for a network device.

The following information is displayed:

Table 3.2 Detailed Information for Network Devices
Item Name	Description
Name	Network device name
SystemName	System name
IPAddress	Admin IP address
ProductName	Device name (product name)
ModelName	Model name
VendorName	Vendor name
Firmware	Firmware version
Location	The location of the device is displayed.
Status	Network device operation status One of the following is displayed: For normal status "normal" is displayed. For error status "error" is displayed. For warning status "Warning" is displayed. For unknown status "unknown" is displayed.
StatusCause	If the operational status of the network device is one other than "normal" One of the following is displayed: When there is no response for ping "Ping unreachable" is displayed. When there is no response for SNMP "SNMP unreachable" is displayed. When there is no response for NETCONF "NETCONF unreachable" is displayed. When automatic configuration failed "auto configuration failed" is displayed. When an error is detected in a switch in the domain of the Ethernet Fabric "Domain status error" is displayed. If the operational status is normal, "-" is displayed.
NetdeviceTypes	Network device type When there is more than one, they are displayed separated by commas. When the type is omitted, only the item name is displayed and the type is not displayed.
FabricType	Fabric type One of the following is displayed: When using Converged Fabric "C-Fabric" is displayed. When using VCS "VCS" is displayed. This is displayed only when the type of network device is "Fabric".
Maintenance	Maintenance mode setting status for the network device One of the following is displayed: When maintenance mode is set "ON" is displayed. When maintenance mode is not set "OFF" is displayed.
FabricId	Fabric ID This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric".
VCSId	VCS ID This is only displayed when the network device type is "Fabric" and the fabric type is "VCS".
ManagementHost	Management Host The IP address and resource name of the management host (the physical server on which the IPCOM VX or NS Appliance operates) are displayed. They are only displayed for virtual appliances.
Redundancy	Group ID
Redundancy[GroupDevice]	Group device name When there is more than one, they are displayed separated by commas.
Port[num]	Port name In num, the index number of a port element is displayed. The number is an integer starting from "0".
Port[num][Link]	Port link status One of the following is displayed: For link-up status "up" is displayed. For link-down status "down" is displayed. For unknown status "unknown" is displayed. In num, the index number of a port element is displayed. The number is an integer starting from "0".
Port[num][PhysicalState]	Port communication status This is displayed in the format of line speed/communication mode. The unit of line speed is in Mbps. For the communication mode, one of the following is displayed: For full duplex line "F" is displayed. For half duplex lines "H" is displayed. For unknown status A hyphen ("-") is displayed. In num, the index number of a port element is displayed. The number is an integer starting from "0".
Port[num][Type]	Port type When the fabric type is "C-Fabric", one of the following is displayed: For the port connected to a server "EP" is displayed. For the port connected to another network device "CIR" is displayed. When the fabric type is "VCS", one of the following is displayed: For the port connected to something other than VCS "Edge" is displayed. For the port connecting VDXs in a VCS "ISL" is displayed. In num, the index number of a port element is displayed. The number is an integer starting from "0". This is displayed only when the type of network device is "Fabric".
Port[num][DistributionMode]	Packet distribution mode One of the following is displayed: When performing distribution of S-TAG(TPID=88a8) "VLAN(S-TAG)" is displayed. When performing distribution of MAC addresses "MAC" is displayed. When performing distribution of C-TAG(TPID=8100) "VLAN(C-TAG)" is displayed. When not performing distribution "no-distribution" is displayed. When performing distribution of VLANs other than S-TAG(TPID=88a8) and C-TAG(TPID=8100) "VLAN(other)" is displayed. In num, the index number of a port element is displayed. The number is an integer starting from "0". This is only displayed for IPCOM VA.
Port[num][Stag]	S-TAG ID The ID of the S-TAG used for IPCOM VA port distribution is displayed. In num, the index number of a port element is displayed. The number is an integer starting from "0". It is only displayed when the packet distribution mode for IPCOM VA is "VLAN(S-TAG)".
Port[num][Ctag]	C-TAG ID The ID of the C-TAG used for the IPCOM VA port distribution is displayed. In num, the index number of a port element is displayed. The number is an integer starting from "0". It is only displayed when the packet distribution mode for IPCOM VA is "VLAN(C-TAG)".
Port[num][OtherVlan]	VLAN IDs other than S-TAG and C-TAG VLAN IDs other than the S-TAG and C-TAG used for IPCOM VA port distribution are displayed. In num, the index number of a port element is displayed. The number is an integer starting from "0". It is only displayed when the packet distribution mode for IPCOM VA is "VLAN(other)".
Vlan[num]	VLAN ID In num, the index number of a VLAN element is displayed. The number is an integer starting from "0".
Vlan[num][UntaggedPort]	Name of the port belonging to an Untagged port of VLAN ID In num, the index number of a VLAN element is displayed. The number is an integer starting from "0". When there is more than one, they are displayed separated by commas. Some VLANs which have been configured with an AMPP function for VCS fabrics may not be displayed.
Vlan[num][TaggedPort]	Name of the port belonging to a Tagged port of VLAN ID In num, the index number of a VLAN element is displayed. The number is an integer starting from "0". When there is more than one, they are displayed separated by commas.
Link[num][NeighborResourceName]	Name of the resource linked to the port number [num] In num, the index number of a port element is displayed. The number is an integer starting from "0".
Link[num][NeighborPort]	Name of the port of the resource linked to the port number [num] In num, the index number of a port element is displayed. The number is an integer starting from "0".
Link[num][NeighborNicIndex]	Name of the port of the resource linked to the port number [num] When the connection destination is a rack mount server and the port for display (NicIndex) is specified, the name of the port of the resource linked to the port number [num] is output. In num, the index number of a port element is displayed. The number is an integer starting from "0".
LoginInfo[num][User]	User name of the account In num, the index number of an account element is displayed. The number is an integer starting from "0".
LoginInfo[num][IPAddress]	Destination IP address of the account In num, the index number of an account element is displayed. The number is an integer starting from "0".
LoginInfo[num][Port]	Destination port number of the account In num, the index number of an account element is displayed. The number is an integer starting from "0".
LoginInfo[num][Protocol]	Protocol name used by the account In num, the index number of an account element is displayed. The number is an integer starting from "0".
LoginInfo[num][Authority]	Account privileges One of the following is displayed: For administrator authority "administrator" is displayed. For user authority "user" is displayed. In num, the index number of an account element is displayed. The number is an integer starting from "0".
LoginInfo[num][AuthType]	Management method of account authentication information One of the following is displayed: When the information is managed within a network device "local password" is displayed. When the information is managed within an external server "external server" is displayed. In num, the index number of an account element is displayed. The number is an integer starting from "0".
LoginInfo[num][LoginCheck]	Check results of account availability One of the following is displayed: When the account can be used "Successful" is displayed. When the account cannot be used "Failed" is displayed. When the account has not been checked "Unchecked" is displayed. In num, the index number of an account element is displayed. The number is an integer starting from "0".
SnmpCommunityName	SNMP community name
FaultMonitoringMethod	Method of fault monitoring One of the following is displayed: When alive monitoring is performed using ping "ping" is displayed. When the status is monitored using SNMP "SNMP" is displayed. When the status is monitored using NETCONF "NETCONF" is displayed. When there are multiple monitoring methods employed, they are displayed separated by commas.
FaultMonitoringInterval(s)	Fault monitoring interval (unit: seconds)
FaultMonitoringRetry	Fault monitoring retry count
FaultMonitoringTimeout(s)	Fault monitoring timeout (unit: seconds)
RestoreHistory[Env][RestoreFileDate]	Time when the network device environment file was backed up If restoration has not been performed or the target file has been already deleted, "-" is displayed.
RestoreHistory[Env][RestoreExecDate]	Date when the network device environment file was backed up If restoration has not been performed, "-" is displayed.
RestoreHistory[Config][GenerationNumber]	Generation number of the network device configuration file If restoration has not been performed or the target file has been already deleted, "-" is displayed.
RestoreHistory[Config][RestoreFileDate]	Time when the restore network device configuration file to restore was backed up If restoration has not been performed, "-" is displayed.
RestoreHistory[Config][RestoreExecDate]	Date when the network device configuration file was backed up If restoration has not been performed, "-" is displayed.
VFAB[num][name]	VFAB name This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". In num, the index number of a VFAB element is displayed. The number is an integer starting from "0".
VFAB[num][id]	VFAB ID This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". In num, the index number of a VFAB element is displayed. The number is an integer starting from "0".
VFAB[num][Stag]	S-TAG of VFAB This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". In num, the index number of a VFAB element is displayed. The number is an integer starting from "0".
VFAB[num][mode]	VFAB operation mode This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". One of the following is displayed: For host mode "host" is displayed. For network mode "network" is displayed. In num, the index number of a VFAB element is displayed. The number is an integer starting from "0".
VFAB[num1][Port][num2]	Name of the port belonging to VFAB This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". In num1, the index number of a VFAB element is displayed. The number is an integer starting from "0". In num2, the index number of a port element is displayed. The number is an integer starting from "0".
VFAB[num1][Port][num2][Link]	Link status of the port belonging to VFAB This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". Displays one of the following: For link-up status "up" is displayed. For link-down status "down" is displayed. For unknown status "unknown" is displayed. In num1, the index number of a VFAB element is displayed. The number is an integer starting from "0". In num2, the index number of a port element is displayed. The number is an integer starting from "0".
VFAB[num1][Port][num2][PhysicalState]	Communication status of the port belonging to VFAB This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". This is displayed in the format of line speed/communication mode. The unit of line speed is in Mbps. For the communication mode, one of the following is displayed: For full duplex line "F" is displayed. For half duplex lines "H" is displayed. For unknown status A hyphen ("-") is displayed. In num1, the index number of a VFAB element is displayed. The number is an integer starting from "0". In num2, the index number of a port element is displayed. The number is an integer starting from "0".
VFAB[num1][Port][num2][Type]	Type of the port belonging to VFAB This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". For the port connected to a server "EP" is displayed. For the port connected to another network device "CIR" is displayed. For the port sending and receiving using the IEEEdot1ad frame "CIR(dot1ad)" or "EP(dot1ad)" is displayed. In num1, the index number of a VFAB element is displayed. The number is an integer starting from "0". In num2, the index number of a port element is displayed. The number is an integer starting from "0".
VFAB[num1][Vlan][num2]	VLAN(C-TAG) ID in VFAB This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". In num1, the index number of a VFAB element is displayed. The number is an integer starting from "0". In num2, the index number of a VFAB element in VFAB is displayed. The number is an integer starting from "0".
VFAB[num1][Vlan][num2][UntaggedPort]	Name of the port belonging to an Untagged port of a VLAN ID in VFAB This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". In num1, the index number of a VFAB element is displayed. The number is an integer starting from "0". In num2, the index number of a VFAB element in VFAB is displayed. The number is an integer starting from "0". When there are multiple index numbers, they are displayed separated by commas.
VFAB[num1][Vlan][num2][TaggedPort]	Name of the port belonging to a Tagged port of a VLAN ID in VFAB This is only displayed when the network device type is "Fabric" and the fabric type is "C-Fabric". In num1, the index number of a VFAB element is displayed. The number is an integer starting from "0". In num2, the index number of a VFAB element in VFAB is displayed. The number is an integer starting from "0". When there are multiple index numbers, they are displayed separated by commas.

refresh: Updates the configuration information of the network device.

Options

-attr {mode={active [-with_va]|maintenance}

For a network device, switch the maintenance mode settings or the .

-attr mode=active

Checks the status of the device. If the device is in the normal state, this option will change the operational status to "normal" and release maintenance mode.
If an error is detected during the status check of the device, failure to release maintenance mode is notified as the command execution result. In this case, it is necessary to take corrective action according to the message that is output, and perform release of maintenance mode again.

-with_va: Specify this to release the virtual appliances on the management host (IPCOM VX) when releasing the management host from maintenance mode.

-attr mode=maintenance: Places into maintenance mode.

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

-name name: In name, specify the name of a network device.
If an unregistered network device name is specified for name, an error will occur.

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

-recreate

Update the port information and link information of the network device specified in name.

When it is necessary to update the port information specifying this option
- When the number of ports of network devices is increased or decreased
- When fabric IDs, domain IDs, switch IDs, or port types for Ethernet Fabric (Converged Fabric) are modified
- When VCS IDs or RBridge IDs for Ethernet Fabric (VCS) are modified
When it is necessary to update the link information specifying this option
- When logical linkage between IPCOM VX and IPCOM VA is modified

If communication with the network device of the operation target is not possible, an error will occur.

Examples

To display a list of network device information:

>rcxadm netdevice list <RETURN>
NAME                           IPADDRESS        NETDEVICE_TYPES        STATUS   MAINTENANCE
----                           ---------        --------               ------   -----------
cat4503.network.com            192.168.5.17     L2-Switch              normal   OFF
Firewall1                      192.168.5.1      Firewall               normal   OFF
Firewall2                      192.168.5.2      Firewall(virtual)      normal   OFF
NSappliance1                   192.168.5.3      Firewall(virtual)      normal   OFF
SLB1                           192.168.5.4      SLB                    normal   OFF
SLB2                           192.168.5.5      SLB                    normal   OFF
ipcomex1                       192.168.5.10     Firewall,SLB           normal   OFF
ipcomex2                       192.168.5.11     Firewall,SLB           normal   OFF
fabric1                        192.168.5.100    Fabric                 normal   OFF

To display the detailed information for a network device (server load balancer):

>rcxadm netdevice show -name SLB1 <RETURN>
Name: SLB1
SystemName: SLB1
IPAddress: 192.168.5.4
ProductName: IPCOMEXIN
ModelName: IPCOM EX2000 IN
VendorName: Fujitsu
Firmware: E20L10
Location: NUMAZU_B1
Status: normal
StatusCause: -
NetdeviceTypes: SLB
Maintenance: OFF
Redundancy: 2
Redundancy[GroupDevice]: SLB1,SLB2
Port[0]: LAN0.0
Port[0][Link]: up
Port[0][PhysicalState]: 1000M / F
Vlan[0]: 1
Vlan[0][UntaggedPort]: LAN0.1,LAN0.2
Vlan[0][TaggedPort]: LAN0.3
Link[0][NeighborResourceName]: SLB2
Link[0][NeighborPort]: LAN0.0
LoginInfo[0][User]: admin
LoginInfo[0][IPAddress]: 192.168.5.4
LoginInfo[0][Port]: 8080
LoginInfo[0][Protocol]: remote_login
LoginInfo[0][Authority]: administrator
LoginInfo[0][AuthType]: local password
LoginInfo[0][LoginCheck]: Successful
SnmpCommunityName: public
FaultMonitoringMethod: SNMP
FaultMonitoringInterval(s): 300
FaultMonitoringRetry: 3
FaultMonitoringTimeout(s): 10

To display the detailed information for a network device (Ethernet Fabric switch (Converged Fabric)):

>rcxadm netdevice show -name fabric1 <RETURN>
Name: fabric1
SystemName: fabric_1
IPAddress: 192.168.5.100
ProductName: Converged Fabric
ModelName: Converged Fabric
VendorName: Fujitsu
Firmware:V01.00
Location: NUMAZU_B1
Status: normal
StatusCause: -
NetdeviceTypes: Fabric
FabricType: C-Fabric
Maintenance: OFF
FabricId: 1
Redundancy: 
Redundancy[GroupDevice]: 
Port[0]: 3/1/0/2
Port[0][Link]: up
Port[0][PhysicalState]: 10G / F
Port[0][Type]: CIR
Port[1]: 3/1/0/4
Port[1][Link]: up
Port[1][PhysicalState]: 10G / F
Port[1][Type]: CIR
Link[0][NeighborResourceName]: ipcomex2500in-1
Link[0][NeighborPort]: LAN0.1
LoginInfo[0][User]: user1
LoginInfo[0][IPAddress]: 192.168.5.100
LoginInfo[0][Port]: 22
LoginInfo[0][Protocol]: ssh
LoginInfo[0][Authority]: user
LoginInfo[0][AuthType]: local password
LoginInfo[0][LoginCheck]: Successful
SnmpCommunityName: public
FaultMonitoringMethod: SNMP
FaultMonitoringInterval(s): 300
FaultMonitoringRetry: 3
FaultMonitoringTimeout(s): 10
VFAB[0][name]: defaultVFAB
VFAB[0][id]: default
VFAB[0][Stag]: 2
VFAB[0][mode]: network
VFAB[0][Port][0]: 3/1/0/2
VFAB[0][Port][0][Link]: up
VFAB[0][Port][0][PhysicalState]: 10G/F
VFAB[0][Port][0][Type]: CIR
VFAB[0][Vlan][0]: 10
VFAB[0][Vlan][0][UntaggedPort]: 5/1/0/1
VFAB[0][Vlan][0][TaggedPort]: 3/1/0/1, 5/1/0/2
VFAB[1][name]: VFAB1
VFAB[1][id]: 1
VFAB[1][Stag]: 101
VFAB[1][mode]: host
VFAB[1][Tenant][0]: tenantG
VFAB[1][Tenant][1]: tenantH
VFAB[1][Port][0]: 3/1/0/4
VFAB[1][Port][0][Link]: up
VFAB[1][Port][0][PhysicalState]: 10G/F
VFAB[1][Port][0][Type]: CIR
VFAB[1][Vlan][0]: 40
VFAB[1][Vlan][0][UntaggedPort]: 5/1/0/3
VFAB[1][Vlan][0][TaggedPort]: 3/1/0/3, 5/1/0/4

To display the detailed information for a network device (Management host (IPCOM VX)):

>rcxadm netdevice show -name ipcom_vx <RETURN>
Name: ipcom_vx
SystemName: vx2700-1
IPAddress: 192.168.1.74
ProductName: IPCOMVXHV
ModelName: IPCOMVX2700_HV
VendorName: Fujitsu
Firmware: E10L11 NF0001
Location: NUMAZU_B1
Status: normal
StatusCause: -
NetdeviceTypes: ManagementHost
Maintenance: OFF
Redundancy:
Redundancy[GroupDevice]:
Port[0]: LAN0.0
Port[0][Link]: up
Port[0][PhysicalState]: 1G / -
Link[0][NeighborResourceName]: fabric1
Link[0][NeighborPort]: 3/2/0/11
Link[0][NeighborResourceName]: ipcomva1
Link[0][NeighborPort]: LAN0.0
LoginInfo[0][User]: user1
LoginInfo[0][IPAddress]: 192.168.1.74
LoginInfo[0][Port]: 23
LoginInfo[0][Protocol]: telnet
LoginInfo[0][Authority]: user
LoginInfo[0][AuthType]: local password
LoginInfo[0][LoginCheck]: Successful
SnmpCommunityName: public
FaultMonitoringMethod: SNMP
FaultMonitoringInterval(s): 300
FaultMonitoringRetry: 3
FaultMonitoringTimeout(s): 30

Note

This command can only be executed when expanding the scope of network device support. For the procedure for expanding the scope of network device support, refer to "7.5.1 Enabling the Network Device Management Function" in the "User's Guide VE".