For FC to work, the device must operate in advanced or expert mode. For more information about system operating modes, see device management in Fundamentals Configuration Guide.

FC mode commands

display fcoe-mode

Use display fcoe-mode to display the FC mode of the switch.

Syntax

display fcoe-mode

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the FC mode of the switch.

<Sysname> display fcoe-mode

The FCoE mode is NONE.

Table 1 Command output

Field	Description
The FCoE mode is mode.	The mode can be one of the following: · FCF. · FCF-NPV. · NPV. · TRANSIT. · NONE (non-FC mode).

Field

Description

The FCoE mode is mode.

The mode can be one of the following:

· FCF.

· FCF-NPV.

· NPV.

· TRANSIT.

· NONE (non-FC mode).

Related commands

fcoe-mode

Use fcoe-mode to configure an FC mode for the switch.

Use undo fcoe-mode to restore the default.

Syntax

fcoe-mode { fcf | fcf-npv | npv }

undo fcoe-mode

Default

A switch operates in non-FC mode.

Views

System view

Predefined user roles

network-admin

Parameters

fcf: Specifies the FCF mode.

fcf-npv: Specifies the FCF-NPV mode.

npv: Specifies the NPV mode.

Usage guidelines

An FC-capable switch can operate in non-FC mode or in one of the following FC modes:

· FCF mode—When the switch operates in this mode, it is an FCF switch and supports E_Ports and F_Ports. An FCF switch can connect to the following elements:

¡ An E_Port on another FCF switch through its E_Port.

¡ An N_Port or NP_Port through its F_Port.

· NPV mode—When the switch operates in this mode, it is an NPV switch and supports F_Ports and NP_Ports. An NPV switch can connect to the following elements:

¡ An N_Port or NP_Port through its F_Port.

¡ An F_Port through its NP_Port.

· FCF-NPV mode—When the switch operates in this mode, it is an FCF-NPV switch. A VSAN on an FCF-NPV switch can operate in either of the following modes:

¡ FCF mode—When a VSAN operates in this mode, the VSAN acts as an FCF switch.

¡ NPV mode—When a VSAN operates in this mode, the VSAN acts as an NPV switch.

The switch can only convert from non-FC mode to one FC mode, or vice versa. It cannot convert directly among FC modes. To convert among FC modes, first convert the switch to non-FC mode. Converting the switch to non-FC mode also clears all FC-related settings in the original FC mode except FC interfaces and FC aggregate interfaces.

Examples

# Configure the switch to operate in FCF mode.

<Sysname> system-view

[Sysname] fcoe-mode fcf

# Convert the switch operating in FCF mode to NPV mode.

<Sysname> system-view

[Sysname] undo fcoe-mode

All current FC configuration will be lost. Continue? [Y/N]:y

[Sysname] fcoe-mode npv

Related commands

display fcoe-mode

FC interface commands

The commands in this section are supported only on FCF, FCF-NPV, and NPV switches.

bandwidth (FC interface view)

Use bandwidth to set the expected bandwidth for an FC interface.

Use undo bandwidth to restore the default.

Syntax

bandwidth bandwidth-value

undo bandwidth

Default

The expected bandwidth (in kbps) of an FC interface is the interface baud rate divided by 1000.

Views

FC interface view

Predefined user roles

network-admin

Parameters

bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.

Usage guidelines

The expected bandwidth of an interface affects the link costs in FSPF. You can control the route selection by setting the expected bandwidth.

Examples

# Set the expected bandwidth to 50 kbps for FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] bandwidth 50

default (FC interface view)

Use default to restore the default settings for an FC interface.

Syntax

default

Views

FC interface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you execute it on a live network.

This command might fail to restore the default settings for some commands for reasons such as command dependencies or system restrictions. Use the display this command in interface view to identify these commands. Then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.

Examples

# Restore the default settings for FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] default

This command will restore the default settings. Continue? [Y/N]:y

description (FC interface view)

Use description to configure the description of an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description of an FC interface is interface name Interface, for example, Fc1/1/1 Interface.

Views

FC interface view

Predefined user roles

network-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 255 characters.

Usage guidelines

The description helps users identify the role of an interface.

Examples

# Configure the description of FC 1/1/1 as FCport1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] description FCport1

display interface fc

Use display interface fc to display FC interface information.

Syntax

display interface [ fc [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

fc [ interface-number ]: Specifies FC interfaces. If you do not specify the fc keyword, this command displays information about all interfaces supported by the device. If you specify the fc keyword but not the interface-number argument, this command displays information about all FC interfaces.

brief: Displays brief information about interfaces. If you do not specify this keyword, the command displays detailed information about interfaces.

description: Displays complete interface descriptions. If you do not specify this keyword, the command does not display interface descriptions.

down: Displays information about the interfaces in physically down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.

Examples

# Display detailed information about FC 1/1/1.

<Sysname> display interface fc 1/1/1

Fc1/1/1

Current state: UP

Line protocol state: UP

Description: Fc1/1/1 Interface

Bandwidth: 4000000kbps

Maximum transmission unit: 2112

4000Mbps-speed mode

Internet protocol processing: Disabled

Link layer protocol is FC

Fill word is idle-idle

Port WWN is 66:66:66:62:65:34:30:39

FC mode is F, state is F

BB_Credit Recovery is enabled

Transmit B2B Credit is 15

Receive B2B Credit is 15

Support the VSAN protocol

VSAN tagging mode is Non tagging

EVFP common VSAN : 1

Media type is not sure,port hardware type is UNKNOWN_SFP

Port priority: 0

4Gbps-speed mode, Link speed type is autonegotiation, Flow-control is enabled

The maximum frame length is 10000

Last link flapping: 1 hours 12 minutes 25 seconds

Last clearing of counters: Never

Peak input rate: 0 bytes/sec, at 2016-12-06 00:31:08

Peak output rate: 0 bytes/sec, at 2016-12-06 00:31:08

Last 300 second input: 0 packets/sec 0 bytes/sec 0%

Last 300 second output: 0 packets/sec 0 bytes/sec 0%

Input (total): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Input (normal): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Input: 0 input errors, 0 runts, 0 giants, 0 throttles

0 CRC, 0 frame, - overruns, 0 aborts

- ignored, - parity errors

Output (total): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Output (normal): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Output: 0 output errors, - underruns, - buffer failures

0 aborts, 0 deferred, 0 collisions, 0 late collisions

0 lost carrier, - no carrier

Table 2 Command output

Field	Description
Current state	Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up.
Line protocol state	Data link layer state of the interface. The state is determined through automatic parameter negotiation at the data link layer. · UP—The data link layer protocol is up. · DOWN—The data link layer protocol is down.
Description	Description of the interface.
Bandwidth	Expected bandwidth of the interface.
4000Mbps-speed mode	The interface is operating at 4000 Mbps.
Internet protocol processing: Disabled	The interface is not assigned an IP address and cannot process IP packets.
Fill word	Fill word mode of the interface: · idle-idle. · idle-arbff.
FC mode	Mode of the interface.
state	Operating mode of the interface through negotiation.
Transmit B2B Credit	Buffer-to-buffer credit (BB_Credit) value of the local end. This field is displayed only after the link comes up.
Receive B2B Credit	BB_Credit value of the remote end. This field is displayed only after the link comes up.
Support VSAN Protocol	The interface supports the VSAN protocol after negotiation. This field is displayed only after the link comes up.
VSAN tagging mode	VSAN tagging mode of the interface after the Exchange Virtual Fabrics Protocol (EVFP) negotiation: Tagging or Non tagging. This field is displayed only after the link comes up.
EVFP common VSAN	Common VSANs in up state through the EVFP negotiation. This field is displayed only after the link comes up.
Link speed type is autonegotiation	This field is displayed if the speed auto command is configured.
Link speed type is force link	This field is displayed if a specific rate is configured by using the speed command.
Flow-control	Flow control function status of the FC interface: · enabled. · not enabled.
The maximum frame length is	MTU of the FC interface.
Last link flapping	The amount of time that has elapsed since the most recent physical state change of the interface. This field displays Never if the interface has been physically down since device startup.
Last clearing of counters	Time when the interface statistics were last cleared by using the reset counters interface fc command. Never indicates that the interface statistics have never been cleared since switch startup.
Peak value of input	Peak incoming traffic rate on the FC interface.
Peak value of output	Peak outgoing traffic rate on the FC interface.
Last 300 seconds input: 0 packets/sec 9 bytes/sec 0%	Average incoming traffic rate on the FC interface in the last 300 seconds and the percentage of the actual rate to the maximum interface rate (configured by using the speed command). A hyphen (-) indicates that the statistics item is not supported.
Last 300 seconds output: 0 packets/sec 9 bytes/sec 0%	Average outgoing traffic rate on the FC interface in the last 300 seconds and the percentage of the actual rate to the maximum interface rate (configured by using the speed command). A hyphen (-) indicates that a statistics item is not supported.
Input (total): 142 packets, 13596 bytes 142 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	Total numbers of frames and bytes received on the FC interface, including normal frames, error frames, and pause frames. · unicasts—Number of frames received that are destined to unicast addresses. · broadcasts—Number of frames received that are destined to broadcast addresses. · multicasts—Number of frames received that are destined to multicast addresses. · pauses—Number of pause frames received. A hyphen (-) indicates that a statistics item is not supported.
Input (normal): 142 packets, - bytes 142 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	Total number of normal frames received on the FC interface and total number of bytes of these frames, including normal frames and pause frames. · unicasts—Number of normal frames received that are destined to unicast addresses. · broadcasts—Number of normal frames received that are destined to broadcast addresses. · multicasts—Number of normal frames received that are destined to multicast addresses. · pauses—Number of pause frames received. A hyphen (-) indicates that a statistics item is not supported.
input errors	Total number of error frames received on the FC interface.
runts	Number of frames received that meet the following requirements: · Smaller than 64 bytes. · In correct format. · Have valid CRC values.
giants	Number of jumbo frames received. Jumbo frames are frames larger than the maximum allowed frame size. For an FC interface that does not permit jumbo frames, the maximum frame length is as follows: · 1518 bytes (without VLAN tags). · 1522 bytes (with VLAN tags). For an FC interface that permits jumbo frames, the maximum Ethernet frame length is configured when you configure jumbo frame support on the interface.
throttles	Number of times the switch shuts down the FC interface due to buffer or CPU overload.
CRC	Number of incoming frames that had a valid length but contained CRC errors.
frame	Number of incoming frames that contained CRC errors and a non-integer number of bytes.
overruns	Number of incoming frames dropped because the input rate of the FC interface exceeded the queuing capability.
aborts	Total number of illegal incoming frames: · Fragment frames—CRC error frames shorter than 64 bytes. The length (in bytes) can be an integral or non-integral value. · Jabber frames—CRC error frames larger than the maximum frame allowed size on the FC interface (with an integral or non-integral length). ¡ For an FC interface that does not permit jumbo frames, the maximum allowed frame size is 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags). ¡ For an FC interface that permits jumbo frames, the maximum allowed frame size is configured when you configure jumbo frame support on the interface. · Symbol error frames—Frames that contained at least one undefined symbol. · Unknown operation code frames—Non-pause MAC control frames. · Length error frames—Frames whose 802.3 length fields did not match the actual frame length (46 to 1500 bytes).
ignored	Number of incoming frames dropped because the receiving buffer of the port ran low.
parity errors	Number of incoming frames with parity errors.
Output (total): 139 packets, 13748 bytes 139 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	Total numbers of frames and bytes sent on the FC interface, including normal frames, error frames, and pause frames. · unicasts—Number of frames sent that are destined to unicast addresses. · broadcasts—Number of frames sent that are destined to broadcast addresses. · multicasts—Number of frames sent that are destined to multicast addresses. · pauses—Number of pause frames sent. A hyphen (-) indicates that a statistics item is not supported.
Output (normal): 139 packets, - bytes 139 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	Total number of normal frames sent on the FC interface and total number of bytes of these frames, including normal frames and pause frames. · unicasts—Number of normal frames sent that are destined to unicast addresses. · broadcasts—Number of normal frames sent that are destined to broadcast addresses. · multicasts—Number of normal frames sent that are destined to multicast addresses. · pauses—Number of pause frames sent. A hyphen (-) indicates that a statistics item is not supported.
output errors	Total number of error frames sent on the FC interface.
underruns	Number of outgoing frames dropped because the output rate of the FC interface exceeded the queuing capability. This is a low-probability hardware anomaly.
buffer failures	Number of frames dropped due to insufficient transmitting buffer resources.
aborts	Total number of frames that are not successfully sent for various reasons, for example, collisions.
deferred	Number of frames that are delayed for transmission because collisions are detected before they are sent.
collisions	Number of frames that the FC interface stopped transmitting because collisions were detected during transmission.
late collisions	Number of frames that the FC interface deferred to transmit after transmitting their first 512 bits because of detected collisions.
lost carrier	Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces.
no carrier	Number of times that the FC interface failed to detect the carrier when attempting to send frames. This counter increases by one each time the FC interface failed to detect the carrier, and applies to serial WAN interfaces.

# Display brief information about FC 1/1/1.

<Sysname> display interface fc 1/1/1 brief

Brief information on FC interface(s):

Admin Mode: auto - auto; E - e port; F - f port; NP - n port proxy

Oper Mode: E - e port; F - f port; NP - n port proxy;

TE - trunking e port; TF - trunking f port;

TNP - trunking n port proxy

Interface VSAN Admin Admin Oper Oper Status SAN-Aggregation

Mode Trunk Mode Speed

Mode

Fc1/1/1 2 F off F 4G UP SAGG23

Table 3 Command output

Field	Description
Interface	Name of the interface.
VSAN	Access VSAN of the interface.
Admin Mode	User-configured interface mode: · auto. · E. · F. · NP.
Admin Trunk Mode	User-configured trunk mode for the interface: · auto. · on. · off.
Oper Mode	Negotiated mode (link layer negotiation) in which the interface is operating: · E—The interface is operating in E mode as an access port. · F—The interface is operating in F mode as an access port. · NP—The interface is operating in NP mode as an access port. · TE—The interface is operating in E mode as a trunk port. · TF—The interface is operating in F mode as a trunk port. · TNP—The interface is operating in NP mode as a trunk port. If negotiation is not initiated or fails, this field displays two hyphens (--).
Oper Speed	Interface rate in bps after physical layer negotiation is performed and the data link layer comes up. If negotiation is not initiated or fails, this field displays two hyphens (--).
Status	Negotiated state (link layer negotiation) for the interface: · UP. · DOWN.
SAN-Aggregation	FC aggregation group to which the interface belongs. This field is empty when the interface is not assigned to an FC aggregation group.

# Display the descriptions of FC interfaces.

<Sysname> display interface fc brief description

Brief information on FC interface(s):

Interface Description

Fc1/1/2 Fc1/1/2 Interface

Fc1/1/3 Fc1/1/3 Interface

# Display brief information about the FC interfaces in physically down state.

<Sysname> display interface fc brief down

Brief information on interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

Fc1/1/1 ADM Administratively

Table 4 Command output

Field	Description
Brief information on interface(s) under bridge mode	Brief information about Layer 2 interfaces.
Interface	Interface name.
Link	Physical link state of the interface: · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. To see the primary interface, use the display interface-backup state command.
Cause	Cause for the physical link state of an interface to be DOWN: · Not connected—No physical connection exists (possibly because the optical fiber is disconnected or faulty). · Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

Related commands

reset counters interface fc

fc mode (FC interface view)

Use fc mode to set the mode of an FC interface.

Use undo fc mode to restore the default.

Syntax

fc mode { auto | e | f | np }

undo fc mode

Default

On an FCF switch, the mode of an FC interface is auto.

On an NPV or FCF-NPV switch, the mode of an FC interface is F.

Views

FC interface view

Predefined user roles

network-admin

Parameters

auto: Specifies the auto mode, so that the FC interface can operate in F mode or E mode through dynamic negotiation.

e: Specifies the E mode.

f: Specifies the F mode.

np: Specifies the NP mode.

Usage guidelines

FC interfaces on an FCF switch support only auto, E, and F modes. FC interfaces on an NPV switch support only F and NP modes. FC interfaces on an FCF-NPV switch support only E, F, and NP modes.

On an FCF-NPV switch, if the mode of an FC interface does not match the mode of a VSAN of the interface, the mode does not take effect in the VSAN.

Examples

# Set the mode to F for FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fc mode f

Related commands

working-mode

fcb2bcredit

Use fcb2bcredit to set the BB_Credit value for an FC interface.

Use undo fcb2bcredit to restore the default.

Syntax

fcb2bcredit credit-value

undo fcb2bcredit

Default

The BB_Credit value for an FC interface is 15.

Views

FC interface view

Predefined user roles

network-admin

Parameters

credit-value: Specifies the number of packets that the FC interface can continuously receive, in the range of 1 to 299.

Usage guidelines

The BB_Credit is a flow control mechanism used to ensure that an FC interface does not drop packets.

The minimum BB_Credit value that can be configured depends on the FC interface speed and the transmission distance of the transceiver module. For more information, see Table 5.

Table 5 Command output

FC interface speed	Transmission distance of the transceiver module	Minimum BB_Credit value
8 Gbps	10 km	104
8 Gbps	25 km	251
16 Gbps	10 km	202
32 Gbps	300 m	32

Examples

# Set the BB_Credit value to 10 for FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fcb2bcredit 10

fcb2bcredit recovery enable

Use fcb2bcredit recovery enable to enable BB_Credit recovery for an FC interface.

Use undo fcb2bcredit recovery enable to disable BB_Credit recovery for an FC interface.

Syntax

fcb2bcredit recovery enable

undo fcb2bcredit recovery enable

Default

BB_Credit recovery is disabled for an FC interface.

Views

FC interface view

Predefined user roles

network-admin

Usage guidelines

This command allows two FC interfaces to recover the connection when BB_Credits are lost.

For the feature to take effect, you must configure the command on both FC interfaces.

Examples

# Enable BB_Credit recovery for FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fcb2bcredit recovery enable

fill-word

Use fill-word to set the fill word mode for an FC interface.

Use undo fill-word to restore the default.

Syntax

fill-word { idle-arbff | idle-idle }

undo fill-word

Default

An FC interface uses the idle-arbff mode.

Views

FC interface view

Predefined user roles

network-admin

Parameters

idle-arbff: Specifies the idle-arbff mode. This mode uses the idle primitive signal in the link initialization phase and uses the ARBff primitive signal as the fill word.

idle-idle: Specifies the idle-idle mode. This mode uses the idle primitive signal in the link initialization phase and uses the idle primitive signal as the fill word.

Usage guidelines

For two FC interfaces to communicate correctly, make sure the fill word is the same on them.

To make the fill word mode setting take effect, execute the shutdown and undo shutdown commands on the FC interface.

Examples

# Set the fill word mode to idle-idle for FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] speed 8000

[Sysname-Fc1/1/1] fill-word idle-idle

Related commands

speed

interface fc

Use interface fc to enter FC interface view.

Syntax

interface fc interface-number

Views

System view

Predefined user roles

network-admin

Parameters

interface-number: Specifies an FC interface by its number.

Examples

# Enter the view of FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1]

reset counters interface fc

Use reset counters interface fc to clear statistics for FC interfaces.

Syntax

reset counters interface [ fc [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

fc [ interface-number ]: Specifies FC interfaces. If you do not specify the fc keyword, this command clears statistics for all interfaces. If you specify the fc keyword but not the interface-number argument, this command clears statistics for all FC interfaces.

Usage guidelines

Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.

Examples

# Clear statistics for FC 1/1/1.

<Sysname> reset counters interface fc 1/1/1

Related commands

display interface fc

shutdown (FC interface view)

Use shutdown to shut down an FC interface.

Use undo shutdown to bring up an FC interface.

Syntax

shutdown

undo shutdown

Default

An FC interface is up.

Views

FC interface view

Predefined user roles

network-admin

Examples

# Shut down FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] shutdown

speed

Use speed to set the rate for an FC interface.

Use undo speed to restore the default.

Syntax

speed { 4000 | 8000 | 16000 | auto }

undo speed

Default

The rate of an FC interface is autonegotiated.

Views

FC interface view

Predefined user roles

network-admin

Parameters

4000: Specifies 4000 Mbps.

8000: Specifies 8000 Mbps.

16000: Specifies 16000 Mbps.

auto: Configures the interface to negotiate its rate with the peer.

Examples

# Set the rate to 8000 Mbps for FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] speed 8000

FC link aggregation commands

bandwidth (FC aggregate interface view)

Use bandwidth to set the expected bandwidth for an FC aggregate interface.

Use undo bandwidth to restore the default.

Syntax

bandwidth bandwidth-value

undo bandwidth

Default

The expected bandwidth (in kbps) of an FC aggregate interface is the interface baud rate divided by 1000.

Views

FC aggregate interface view

Predefined user roles

network-admin

Parameters

bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.

Usage guidelines

The baud rate of an FC aggregate interface is the sum of the speed of each Selected member interface in the FC aggregation group.

The expected bandwidth of an FC aggregate interface affects the link costs in FSPF. You can control the route selection by setting the expected bandwidth.

Examples

# Set the expected bandwidth to 1000 kbps for FC aggregate interface 1.

<Sysname> system-view

[Sysname] interface san-aggregation 1

[Sysname-SAN-Aggregation1] bandwidth 1000

default (FC aggregate interface view)

Use default to restore the default settings for an FC aggregate interface.

Syntax

default

Views

FC aggregate interface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you execute it on a live network.

This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. Use the display this command in interface view to identify these commands, and then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.

Examples

# Restore the default settings for FC aggregate interface 1.

<Sysname> system-view

[Sysname] interface san-aggregation 1

[Sysname-SAN-Aggregation1] default

This command will restore the default settings. Continue? [Y/N]:y

description (FC aggregate interface view)

Use description to configure the description of an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description of an FC aggregate interface is interface name Interface, for example, SAN-Aggregation1 Interface.

Views

FC aggregate interface view

Predefined user roles

network-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 255 characters.

Usage guidelines

The description helps users identify the role of an interface.

Examples

# Configure the description of FC aggregate interface 1 as SAGG-interface.

<Sysname> system-view

[Sysname] interface san-aggregation 1

[Sysname-SAN-Aggregation1] description SAGG-interface

display interface san-aggregation

Use display interface san-aggregation to display FC aggregate interface information.

Syntax

display interface [ san-aggregation [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

san-aggregation [ interface-number ]: Specifies FC aggregate interfaces. If you do not specify the san-aggregation keyword, this command displays information about all interfaces supported by the device. If you specify the san-aggregation keyword but not the interface-number argument, this command displays information about all FC aggregate interfaces.

brief: Displays brief information about interfaces. If you do not specify this keyword, the command displays detailed information about interfaces.

description: Displays complete interface descriptions. If you do not specify this keyword, the command does not display interface descriptions.

down: Displays information about the interfaces in physically down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.

Examples

# Display detailed information about FC aggregate interface 1.

<Sysname> display interface san-aggregation 1

SAN-Aggregation1

Current state: UP

Line protocol state: UP

Description: SAN-Aggregation1 Interface

Bandwidth: 1000kbps

Maximum transmission unit: 2112

Internet protocol processing: Disabled

Link layer protocol is FC

Port WWN is 24:01:70:ba:ef:6c:e0:15

FC mode is F, state is F

Support the VSAN protocol

VSAN tagging mode is Non tagging

EVFP common VSAN: 100

Last clearing of counters: Never

Table 6 Command output

Field	Description
Current state	Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up.
Line protocol state	Data link layer state of the interface. The state is determined through automatic parameter negotiation at the data link layer. · UP—The data link layer protocol is up. · DOWN—The data link layer protocol is down.
Bandwidth	Expected bandwidth of the interface. This field is not displayed when its value is 0.
Internet protocol processing: Disabled	The interface is not assigned an IP address and cannot process IP packets.
FC mode	Mode of the interface.
state	Operating state of the interface through negotiation.
Support the VSAN protocol	Indicates the interface supports the VSAN protocol.
VSAN tagging mode	Link type of the interface: Trunk (Tagging) or Access (Non tagging). This field is displayed only after the link comes up.
EVFP common VSAN	Indicates that the common VSANs are in up state through the EVFP negotiation. This field is displayed only after the link comes up.
Last clearing of counters	Time when the interface statistics were last cleared by using the reset counters interface san-aggregation command. Never indicates that the interface statistics have never been cleared since device startup.

# Display brief information about FC aggregate interface 1.

<Sysname> display interface san-aggregation 1 brief

Brief information on SAN-Aggregation interface(s):

Admin Mode: auto - auto; E - e port; F - f port; NP - n port proxy

Oper Mode: E - e port; F - f port; NP - n port proxy;

TE - trunking e port; TF - trunking f port;

TNP - trunking n port proxy

Interface VSAN Admin Admin Oper Oper Status

Mode Trunk Mode Speed

Mode

SAGG1 37 F auto F 4G UP

Table 7 Command output

Field	Description
Interface	Name of the interface.
VSAN	Access VSAN of the interface.
Admin Mode	User-configured interface mode: · auto. · E. · F. · NP.
Admin Trunk Mode	User-configured trunk mode for the interface: · auto. · on. · off.
Oper Mode	Negotiated mode (link layer negotiation) in which the interface is operating: · E—The interface is operating in E mode as an access port. · F—The interface is operating in F mode as an access port. · NP—The interface is operating in NP mode as an access port. · TE—The interface is operating in E mode as a trunk port. · TF—The interface is operating in F mode as a trunk port. · TNP—The interface is operating in NP mode as a trunk port. If negotiation is not initiated or fails, this field displays two hyphens (--).
Oper Speed	Interface rate in bps after physical layer negotiation is performed and the data link layer comes up. If negotiation is not initiated or fails, this field displays two hyphens (--).
Status	Negotiated state (link layer negotiation) for the interface: · UP. · DOWN.

# Display the descriptions of FC aggregate interfaces.

<sysname> display interface san-aggregation brief description

Brief information on SAN-Aggregation interface(s):

Interface Description

SAGG1 SAGG1 Interface

SAGG2 SAGG2 Interface

# Display brief information about the FC aggregate interfaces in physically down state.

<Sysname> display interface san-aggregation brief down

Brief information on interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

SAGG1 ADM Administratively

Table 8 Command output

Field	Description
Brief information on interface(s) under bridge mode	Brief information about Layer 2 FC aggregate interfaces.
Interface	Interface name.
Link	Physical link state of the interface: · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. To see the primary interface, use the display interface-backup state command.
Cause	Cause for the physical link state of an interface to be DOWN: · Not connected—No physical connection exists (possibly because the optical fiber is disconnected or faulty). · Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

Related commands

reset counters interface san-aggregation

display san-aggregation

Use display san-aggregation to display information about FC aggregation groups corresponding to existing FC aggregate interfaces.

Syntax

display san-aggregation [ verbose ] [ interface san-aggregation interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed information about FC aggregation groups. If you do not specify this keyword, the command displays brief information about FC aggregation groups.

interface san-aggregation interface-number: Specifies an FC aggregate interface by its number. The specified FC aggregate interface must already exist. If you do not specify an FC aggregate interface, this command displays information about all FC aggregation groups corresponding to existing FC aggregate interfaces.

Examples

# Display brief information about all FC aggregation groups corresponding to existing FC aggregate interfaces.

<Sysname> display san-aggregation

* indicates the member port is selected.

Interface State Mode Speed Member port

SAGG1 UP F 8Gbps *Fc1/1/1

Fc1/1/2

SAGG2 DOWN - - -

Table 9 Command output

Match criteria	Description
Interface	Abbreviated FC aggregate interface name.
State	Physical state of the FC aggregate interface: · DOWN—The physical state of the interface is down and the FC aggregate interface contains no Selected member interface. · UP—The physical state of the interface is up and the FC aggregate interface contains Selected member interfaces.
Mode	Operating mode of the FC aggregate interface: · E—E mode. · F—F mode. · NP—NP mode. When the physical state of the FC aggregate interface is down, a hyphen (-) is displayed for this field.
Speed	Speed of the FC aggregate interface. It is the sum of the speed of each Selected member interface. When the physical state of the FC aggregate interface is down, a hyphen (-) is displayed for this field.
Member port	Member interfaces of the FC aggregation group corresponding to the FC aggregate interface. A member interface marked with an asterisk (*) is a Selected member interface. When the FC aggregation group does not contain any member interfaces, a hyphen (-) is displayed for this field.

# Display detailed information about all FC aggregation groups corresponding to existing FC aggregate interfaces.

<Sysname> display san-aggregation verbose

Interface SAN-Aggregation1:

State : UP

Mode : F

Speed : 8Gbps

Member port number : 2

Selected port number : 1

Member port State Mode Speed Selected

Fc1/1/1 UP F 8Gbps Y

Fc1/1/2 UP F 4Gbps N

Interface SAN-Aggregation2:

State : DOWN

Mode : N/A

Speed : N/A

Member port number : 2

Selected port number : 0

Member port State Mode Speed Selected

Fc1/1/3 DOWN - - N

Fc1/1/4 DOWN - - N

Table 10 Command output

Match criteria	Description
Interface	FC aggregate interface name.
State	Physical state of the FC aggregate interface: · DOWN—The physical state of the interface is down and the FC aggregate interface contains no Selected member interface. · UP—The physical state of the interface is up and the FC aggregate interface contains Selected member interfaces.
Mode	Operating mode of the FC aggregate interface: · E—E mode. · F—F mode. · NP—NP mode. When the physical state of the FC aggregate interface is down, N/A is displayed for this field.
Speed	Speed of the FC aggregate interface. It is the sum of the speed of each Selected member interface. When the physical state of the FC aggregate interface is down, N/A is displayed for this field.
Member port number	Number of member interfaces in the FC aggregation group corresponding to the FC aggregate interface.
Selected port number	Number of Selected member interfaces in the FC aggregation group corresponding to the FC aggregate interface.
Member port	Member interfaces of the FC aggregation group corresponding to the FC aggregate interface. When the FC aggregation group does not contain any member interfaces, this field is empty.
State	Link layer state of the FC aggregate interface: · DOWN—The link layer protocol of the interface is down. · UP—The link layer protocol of the interface is up.
Mode	Operating mode of the member interface: · E—E mode. · F—F mode. · NP—NP mode. When the member interface is down at the link layer, a hyphen (-) is displayed for this field.
Speed	Speed of the member interface. When the member interface is down at the link layer, a hyphen (-) is displayed for this field.
Selected	Selected state of the member interface: · N—Unselected. · Y—Selected.

fc mode (FC aggregate interface view)

Use fc mode to set the mode of an FC aggregate interface.

Use undo fc mode to restore the default.

Syntax

fc mode { auto | e | f | np }

undo fc mode

Default

On an FCF switch, the mode of an FC aggregate interface is auto.

On an NPV or FCF-NPV switch, the mode of an FC aggregate interface is F.

Views

FC aggregate interface view

Predefined user roles

network-admin

Parameters

auto: Specifies the auto mode, so that the FC aggregate interface can operate in F mode or E mode through dynamic negotiation.

e: Specifies the E mode.

f: Specifies the F mode.

np: Specifies the NP mode.

Usage guidelines

FC aggregate interfaces on an FCF switch support only auto, E, and F modes. FC aggregate interfaces on an NPV switch support only F and NP modes. FC aggregate interfaces on an FCF-NPV switch support only E, F, and NP modes.

On an FCF-NPV switch, if the mode of an FC aggregate interface does not match the mode of a VSAN of the interface, the mode does not take effect in the VSAN.

Examples

# Set the mode to F for FC aggregate interface 1.

<Sysname> system-view

[Sysname] interface san-aggregation 1

[Sysname-SAN-Aggregation1] fc mode f

Related commands

working-mode

interface san-aggregation

Use interface san-aggregation to create an FC aggregate interface and enter its view, or enter the view of an existing FC aggregate interface.

Syntax

interface san-aggregation interface-number

undo interface san-aggregation interface-number

Default

No FC aggregate interfaces exist.

Views

System view

Predefined user roles

network-admin

Parameters

interface-number: Specifies the number of the FC aggregate interface. The value range for this argument varies by device model.

Usage guidelines

The device supports creating a maximum of 128 FC aggregate interfaces.

Examples

# Create FC aggregate interface 1 and enter its view.

<Sysname> system-view

[Sysname] interface san-aggregation 1

[Sysname-SAN-Aggregation1]

Related commands

display interface san-aggregation

reset counters interface san-aggregation

Use reset counters interface san-aggregation to clear statistics for FC aggregate interfaces.

Syntax

reset counters interface [ san-aggregation [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

san-aggregation [ interface-number ]: Specifies FC aggregate interfaces. If you do not specify the san-aggregation keyword, this command clears statistics for all interfaces. If you specify the san-aggregation keyword but not the interface-number argument, this command clears statistics for all FC aggregate interfaces.

Usage guidelines

Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.

Examples

# Clear statistics for FC aggregate interface 1.

<Sysname> reset counters interface san-aggregation 1

Related commands

display interface san-aggregation

san-aggregation group

Use san-aggregation group to assign an FC interface to an FC aggregation group.

Use undo san-aggregation group to remove an FC interface from an FC aggregation group.

Syntax

san-aggregation group group-id

undo san-aggregation group

Default

An FC interface is not assigned to any FC aggregation group.

Views

FC interface view

Predefined user roles

network-admin

Parameters

group-id: Specifies an FC aggregation group by its group number. An FC aggregation group uniquely corresponds to an FC aggregate interface, and they are numbered the same. The value range for this argument is 1 to 1024.

Usage guidelines

An FC interface can be assigned to only one FC aggregation group.

After an FC interface is assigned to an FC aggregation group, its operating mode, trunk mode, trunk VSAN, and access VSAN settings are cleared. Also, you cannot configure these settings for a member port. After the FC interface is removed from the FC aggregation group, these settings are not restored, and the default settings are used.

An FC aggregation group can contain a maximum of eight member interfaces.

Examples

# Assign FC 1/1/1 to FC aggregation group 1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] san-aggregation group 1

The FC mode, trunk mode, trunk VSAN, and access VSAN settings of the FC interface will be lost. Continue? [Y/N]:y

Related commands

display san-aggregation

san-aggregation load-sharing mode local-first

Use san-aggregation load-sharing mode local-first to enable local-first load sharing.

Use undo san-aggregation load-sharing mode local-first to disable local-first load sharing.

Syntax

san-aggregation load-sharing mode local-first

undo san-aggregation load-sharing mode local-first

Default

Local-first load sharing is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Local-first load sharing takes effect immediately after it is enabled, and it might cause traffic loss.

Examples

# Enable local-first load sharing.

<Sysname> system-view

[Sysname] san-aggregation load-sharing mode local-first

shutdown (FC aggregate interface view)

Use shutdown to shut down an FC aggregate interface.

Use undo shutdown to bring up an FC aggregate interface.

Syntax

shutdown

undo shutdown

Default

An FC aggregate interface is up.

Views

FC aggregate interface view

Predefined user roles

network-admin

Examples

# Shut down FC aggregate interface 1.

<Sysname> system-view

[Sysname] interface san-aggregation 1

[Sysname-SAN-Aggregation1] shutdown

FC commands

display fcoe

Use display fcoe to display global FCoE settings.

Syntax

display fcoe

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

Only FCF and NPV switches support this command.

Examples

# Display global FCoE settings.

<Sysname> display fcoe

Global FCoE information:

FCoE MAC : 0000-1234-0202

FC-MAP : 0x0efc25

FCF Priority: 128

FKA period : 8 seconds

Table 11 Command output

Field	Description
FCoE MAC	FCoE MAC address of the switch.
FC-MAP	· FC-MAP value.
FCF Priority	System FCF priority.
FKA period	Interval at which a VFC interface sends Discovery Solicitations and unsolicited Discovery Advertisements.

Related commands

fcoe fcmap

fcoe fka-adv-period

fcoe global fcf-priority

display fcoe vlan

Use display fcoe vlan to display the FCoE settings of a VLAN.

Syntax

display fcoe vlan vlan-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.

Usage guidelines

Only FCF-NPV switches support this command.

Examples

# Display the FCoE settings of VLAN 10.

<Sysname> display fcoe vlan 10

FCoE information of VLAN 10:

FCoE MAC : 0000-2345-0202

FC-MAP : 0x0efc01

FCF Priority: 128

FKA period : 8 seconds

Table 12 Command output

Field	Description
FCoE MAC	FCoE MAC address of the switch.
FC-MAP	FC-MAP value.
FCF Priority	System FCF priority.
FKA period	Interval at which a VFC interface sends Discovery Solicitations and unsolicited Discovery Advertisements.

Related commands

fcoe fcmap

fcoe fka-adv-period

fcoe global fcf-priority

fcoe enable

Use fcoe enable to enable FC in a VLAN and map the VLAN to a VSAN.

Use undo fcoe enable to disable FC in a VLAN.

Syntax

fcoe enable [ vsan vsan-id ]

undo fcoe enable

Default

FC is disabled in a VLAN.

Views

VLAN view

Predefined user roles

network-admin

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command maps the VLAN to a VSAN with the same ID as the VLAN. For VLANs 3840 to 4094, you must specify VSANs to be mapped. Otherwise, an error message appears.

Usage guidelines

FC cannot be enabled in VLAN 1.

VSANs are mapped to VLANs on a one-to-one basis.

After FC is enabled in a VLAN, the following rules apply:

· The VLAN allows only FC traffic.

· All member ports in the VLAN are isolated and will not form loops.

When you use an FC interface to transmit packets, you must map used VSANs to VLANs and enable FC for the VLANs. The VSAN used on the two ends can be mapped to the same VLAN or different VLANs.

Examples

# Enable FC in VLAN 4 and map VLAN 4 to VSAN 6.

<Sysname> system-view

[Sysname] vlan 4

[Sysname-vlan4] fcoe enable vsan 6

VSAN commands

display vsan port-member

Use display vsan port-member to display the member interfaces of a VSAN.

Syntax

display vsan [ vsan-id ] port-member

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the member interfaces of each VSAN.

Examples

# Display the member interfaces of each VSAN.

<Sysname> display vsan port-member

VSAN 1:

Access Ports:

Fc1/1/1 Fc1/1/2

Trunk Ports:

Fc1/1/1 Fc1/1/2 Fc1/1/3

VSAN 2:

Access Ports:

Trunk Ports:

Fc1/1/1

VSAN 10:

Access Ports:

Trunk Ports:

VSAN 100:

Access Ports:

Trunk Ports:

Fc1/1/1 Fc1/1/2 Fc1/1/1

display vsan status

Use display vsan status to display the operating modes of VSANs.

Syntax

display vsan [ vsan-id ] status

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the operating mode of each VSAN.

Usage guidelines

Only FCF-NPV switches support this command.

Examples

# Display the operating mode of each VSAN.

<Sysname> display vsan status

VSAN 1:

Name: VSAN0001

Working mode: FCF

VSAN 10:

Name: VSAN0010

Working mode: NPV

Related commands

vsan

working-mode

port

Use port to assign a list of interfaces to a VSAN as access ports in batch.

Use undo port to remove a list of access ports from a VSAN in batch.

Syntax

port interface-list

undo port interface-list

Default

An interface belongs to VSAN 1 as an access port.

Views

VSAN view

Predefined user roles

network-admin

Parameters

interface-list: Specifies a space-separated list of up to 10 interface items. Each item specifies an interface or a range of interfaces in the form of interface-type interface-number1 to interface-type interface-number2. The value for interface-number2 must be greater than or equal to the value for interface-number1. The interface type can be FC interface or FC aggregate interface.

Usage guidelines

To assign a single interface to a VSAN, use the port access vsan command. If you assign one interface to different VSANs by using the port command and the port access vsan command, the new configuration for the interface overwrites the previous configuration.

Examples

# Assign FC 1/1/1 through FC 1/1/5 to VSAN 10 as access ports in batch.

<Sysname> system-view

[Sysname] vsan 10

[Sysname-vsan10] port fc 1/1/1 to fc 1/1/5

Related commands

port access vsan

Use port access vsan to assign an interface to a VSAN as an access port.

Use undo port access vsan to restore the default.

Syntax

port access vsan vsan-id

undo port access vsan

Default

An interface belongs to VSAN 1 as an access port.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. Make sure the VSAN already exists on the device. Otherwise, this command fails.

Usage guidelines

To assign multiple interfaces to a VSAN as access ports in batch, use the port command. If you assign one interface to different VSANs by using the port command and the port access vsan command, the new configuration for the interface overwrites the previous configuration.

Examples

# Create VSAN 10, and assign FC 1/1/1 to VSAN 10 as an access port.

<Sysname> system-view

[Sysname] vsan 10

[Sysname-vsan10] quit

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] port access vsan 10

Related commands

port

port trunk mode

Use port trunk mode to set the trunk mode for an interface.

Use undo port trunk mode to restore the default.

Syntax

port trunk mode { auto | off | on }

undo port trunk mode

Default

The trunk mode is auto for interfaces on an FCF switch. The trunk mode is off for interfaces on an NPV switch or FCF-NPV switch.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

auto: Specifies the auto mode.

off: Specifies the off mode.

on: Specifies the on mode.

Usage guidelines

The two interfaces of a link use the EVFP protocol to negotiate whether to support VSAN tagging according to their trunk modes.

An FCF switch supports three trunk modes: auto (default), off, and on. An NPV switch or FCF-NPV switch supports two trunk modes: off (default) and on.

If the switch connects to a node through an FC interface or FC aggregate interface, as a best practice, assign the interface to a VSAN as an access port. If you assign the interface to a VSAN as a trunk port, node login might be affected.

Examples

# Set the trunk mode to on for FC 1/1/1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] port trunk mode on

port trunk vsan

Use port trunk vsan to assign an interface to the specified VSANs as a trunk port.

Use undo port trunk vsan to remove an interface from the specified VSANs.

Syntax

port trunk vsan vsan-id-list

undo port trunk vsan vsan-id-list

Default

An interface is not assigned to any VSANs as a trunk port.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

vsan-id-list: Specifies a space-separated list of up to 10 VSAN items. Each item specifies a VSAN ID or a range of VSAN IDs in the format of vsan-id1 to vsan-id2. The value range for the vsan-id argument is 1 to 3839. The value for vsan-id2 must be greater than or equal to the value for vsan-id1.

Usage guidelines

As a best practice, do not include both FCF-mode VSANs and NPV-mode VSANs on an FCF-NPV switch in a VSAN list. If you do so, the following events occur during trunk mode negotiation:

· An E_Port selects only FCF-mode VSANs.

· An NP_Port selects only NPV-mode VSANs.

An FC interface or FC aggregate interface exchanges messages with the peer interface in the access VSAN to perform VSAN mode negotiation. Therefore, you must map the access VSAN to a VLAN in addition to configuring the trunk VSAN. By default, the access VSAN of an FC interface or FC aggregate interface is VSAN 1.

Examples

# Assign FC 1/1/1 to VSANs 1, 2, 10, and 20 through 100.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] port trunk vsan 1 to 2 10 20 to 100

Related commands

working-mode

vsan

Use vsan to create a VSAN and enter its view, or enter the view of an existing VSAN.

Use undo vsan to restore the name of a VSAN to the default or delete a VSAN.

Syntax

vsan vsan-id [ name vsan-name ]

undo vsan vsan-id [ name ]

Default

Only the default VSAN (VSAN 1) exists, and the name of VSAN 1 is VSAN0001.

Views

System view

Predefined user roles

network-admin

Parameters

vsan vsan-id: Specifies a VSAN ID in the range of 1 to 3839.

name vsan-name: Specifies a name for the VSAN, a case-sensitive string of 1 to 32 characters. The name must start with a letter and can contain letters, numbers, and special symbols in Table 13.

Table 13 Special symbols

Name	Symbol
Caret	^
Dollar sign	$
Minus sign	-
Underscore	_

If you do not specify a VSAN name, the default VSAN name is VSAN plus a four-digit VSAN ID. For example, the default name of VSAN 10 is VSAN0010.

Usage guidelines

You cannot delete the default VSAN (VSAN 1).

You can create a maximum of 16 VSANs (including VSAN 1) on the device.

If you specify the name keyword, the undo vsan command restores the VSAN name to its default. If you do not specify the name keyword, the undo vsan command deletes the VSAN.

Examples

# Create VSAN 10 and enter its view.

<Sysname> system-view

[Sysname] vsan 10

[Sysname-vsan10]

# Change the name of VSAN 10 from its default to FCF-VSAN.

<Sysname> system-view

[Sysname] vsan 10 name FCF-VSAN

[Sysname-vsan10]

# Create VSAN 11 with a name of FCF-VSAN, and enter the view of VSAN 11.

<Sysname> system-view

[Sysname] vsan 11 name FCF-VSAN

[Sysname-vsan11]

# Restore the name of VSAN 11 to its default.

<Sysname> system-view

[Sysname] undo vsan 11 name

# Delete VSAN 11.

<Sysname> system-view

[Sysname] undo vsan 11

Related commands

display vsan status

working-mode

Use working-mode to set the operating mode for a VSAN.

Use undo working-mode to restore the default.

Syntax

working-mode { fcf | npv }

undo working-mode

Default

The operating mode of a VSAN is NPV.

Views

VSAN view

Predefined user roles

network-admin

Parameters

fcf: Specifies the FCF mode.

npv: Specifies the NPV mode

Usage guidelines

Only FCF-NPV switches support this command.

A VSAN operating in FCF mode acts as an FCF switch. A VSAN operating in NPV mode acts as an NPV switch.

The access VSAN and trunk VSANs of an FC interface or FC aggregate interface must be configured with the same operating mode.

Examples

# Set the operating mode to FCF for VSAN 10.

<Sysname> system-view

[Sysname] vsan 10

[Sysname-vsan10] working-mode fcf

Related commands

display vsan status

fc mode

Fabric building commands

allowed-domain-id

Use allowed-domain-id to configure an allowed domain ID list for a VSAN.

Use undo allowed-domain-id to delete an allowed domain ID list of a VSAN.

Syntax

allowed-domain-id domain-id-list

undo allowed-domain-id domain-id-list

Default

The allowed domain ID list for a VSAN includes domain IDs 1 to 239.

Views

VSAN view

Predefined user roles

network-admin

Parameters

domain-id-list: Specifies a space-separated list of up to 8 domain items. Each item specifies a domain ID or a range of domain IDs in the format of domain-id1 to domain-id2. The value for domain-id2 must be greater than or equal to the value for domain-id1. The value range for the domain-id argument is 1 to 239.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

To successfully configure an allowed domain ID list on the principal switch, make sure all assigned and locally configured domain IDs are included in the list. After you configure an allowed domain ID list, the principal switch assigns only domain IDs available in the allowed list.

To successfully configure an allowed domain ID list on a non-principal switch, make sure the runtime domain ID of the switch is included in the allowed list. After you configure an allowed domain ID list on a non-principal switch, the following rules apply:

· The locally configured domain ID must be included in the allowed list. Otherwise, the domain ID configuration fails.

· The principal switch must assign a domain ID that is included in the allowed list of the non-principal switch. Otherwise, the non-principal switch refuses the assigned domain ID and isolates its interface connected to the principal switch.

As a best practice, configure the same allowed domain ID list on all switches in a VSAN.

Examples

# Configure VSAN 1 to allow domains 3 through 10.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] allowed-domain-id 3 to 10

display fc domain

Use display fc domain to display the domain information for VSANs.

Syntax

display fc domain [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the domain information for all VSANs. On an FCF-NPV switch, this command displays the domain information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The displayed domain information includes runtime and configuration information of the local switch and runtime information of the principal switch.

Examples

# Display the domain information for VSAN 1.

<Sysname> display fc domain vsan 1

Domain Information of VSAN 1:

Running time information:

State: Stable

Switch WWN: 41:6e:64:69:61:6d:6f:21

Fabric name: 41:6e:64:69:61:6d:6f:21

Priority: 2

Domain ID: 100

Configuration information:

Domain configure: Enabled

Domain auto-reconfigure: Disabled

Fabric name: 41:6e:64:69:61:6d:6f:21

Priority: 128

Domain ID: 100 (static)

Principal switch running time information:

Priority: 2

Path Interface

Downstream Fc1/1/1

Downstream Fc1/1/2

Downstream Fc1/1/3

Table 14 Command output

Field	Description
State	Running status: · Stable—The configuration is finished. · Unstable—The configuration is not finished.
Switch WWN	WWN of the local switch.
Fabric name	Name of the fabric.
Priority	Running priority of the local switch.
Domain ID	Runtime domain ID of the local switch.
Configuration information	Configuration of the local switch.
Domain configure	State of the fabric configuration feature: · Enabled. · Disabled.
Domain auto-reconfigure	State of the automatic reconfiguration feature: · Enabled. · Disabled.
Fabric name	Fabric name configured on the switch.
Priority	Locally configured priority of the switch.
Domain ID	Locally configured domain ID. The field in the parentheses can be one of the following: · static. · preferred.
Principal switch running time information	Runtime information of the principal switch.
Priority	Running priority of the principal switch.
Path	Path type of the interface: · Upstream—Upstream principal link. · Downstream—Downstream principal link.
Interface	Local interface.

display fc domain-list

Use display fc domain-list to display the list of domain IDs dynamically assigned in VSANs.

Syntax

display fc domain-list [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the lists of domain IDs dynamically assigned in all VSANs. On an FCF-NPV switch, this command displays the lists of domain IDs dynamically assigned in only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

For a dynamically built fabric, this command displays the list of domain IDs dynamically assigned in a VSAN and includes the following information:

· The total number of domains.

· Mappings between domain IDs and switch WWNs.

Examples

# Display the list of domain IDs dynamically assigned in VSAN 1.

<Sysname> display fc domain-list vsan 1

Domain list of VSAN 1:

Number of domains: 3

Domain ID WWN

0xc8(200) 20:01:00:05:30:00:47:df [Principal]

0x63(99) 20:01:00:0d:ec:08:60:c1 [Local]

0x61(97) 50:00:53:0f:ff:f0:10:06

Table 15 Command output

Field	Description
Domain list of VSAN	Domain ID list of the VSAN.
Number of domains	Total number of domains.
WWN	WWN of the switch. Principal indicates a principal switch, and Local indicates a local switch.

Related commands

domain configure enable

display fc ess

Use display fc ess to display the Exchange Switch Support (ESS) negotiation result, including the following information:

· The capabilities of the local switch after the ESS negotiation.

· The capabilities of the remote switch after the ESS negotiation.

Syntax

display fc ess [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the ESS negotiation results for all VSANs. On an FCF-NPV switch, this command displays the ESS negotiation results for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display the ESS negotiation result for VSAN 2.

<Sysname> display fc ess vsan 2

ESS info of VSAN 2:

Domain: 57

Directory Server Capability:

Accept large name server objects: Yes

Accept small name server objects: No

Accept large + FC-4 Features name server objects: No

Accept small + FC-4 Features name server objects: No

Support receiving ACCept with 0 length: Yes

Fabric Controller Capability:

Support receiving the SW_RSCN Request: Yes

Fabric Configuration Server Capability:

Support basic configuration services: Yes

Support platform configuration services: No

Support topology discovery configuration services: Yes

Support enhanced configuration services: Yes

Enhanced Zone Server Capability:

Support enhanced zoning management: Yes

Domain: 224

Directory Server Capability:

Accept large name server objects: Yes

Accept small name server objects: No

Accept large + FC-4 Features name server objects: No

Accept small + FC-4 Features name server objects: No

Support receiving ACCept with 0 length: Yes

Fabric Controller Capability:

Support receiving the SW_RSCN Request: Yes

Fabric Configuration Server Capability:

Support basic configuration services: Yes

Support platform configuration services: No

Support topology discovery configuration services: Yes

Support enhanced configuration services: Yes

Enhanced Zone Server Capability:

Support enhanced zoning management: Yes

Table 16 Command output

Field	Description
Domain	Domain ID of the switch.
Directory Server Capability	List of directory server capabilities.
Accept large name server objects	Indicates whether the switch supports accepting large name server objects. A large name server object contains the symbolic name of the N_Port and the symbolic name of the node in addition to the information of a small name server object.
Accept small name server objects	Indicates whether the switch supports accepting small name server objects. A small name server object contains only the basic information, and does not contain the symbolic name of the N_Port, the symbolic name of the node, or information about supported FC-4 features.
Accept large + FC-4 Features name server objects	Indicates whether the switch supports accepting large + FC-4-feature name server objects.
Accept small + FC-4 Features name server objects	Indicates whether the switch supports accepting small + FC-4-feature name server objects.
Support receiving ACCept with 0 length	Indicates whether the switch supports accepting an ACCEPT reply whose payload is 0.
Fabric Controller Capability	List of fabric controller capabilities.
Support receiving the SW_RSCN Request	Indicates whether the switch supports accepting an SW_RSCN (Registered State Change Notification) request.
Support enhanced zoning management	Indicates whether the switch supports enhanced zoning.

display fc login

Use display fc login to display the node login information for VSANs.

Syntax

display fc login [ vsan vsan-id ] [ count ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the node login information for all VSANs. On an FCF-NPV switch, this command displays the node login information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display the node login information for VSAN 1.

<Sysname> display fc login vsan 1

Interface VSAN FCID Node WWN Port WWN

Fc1/1/1 1 0x010000 21:01:00:1b:32:a0:fa:18 21:01:00:1b:32:a0:fa:17

# Display the number of logged-in nodes for VSAN 1.

<Sysname> display fc login vsan 1 count

Total entries: 1

# Display the number of logged-in nodes for each VSAN and the total number of logged-in nodes.

<Sysname> display fc login count

VSAN Entries

1 1

2 1

Total entries: 2

Table 17 Command output

Field	Description
Interface	Interface on the switch connected to the node.
FCID	FC address assigned by the switch to the node.
Port WWN	WWN of the port connecting the node to the switch.
Entries	Number of logged-in nodes for a VSAN.
Total Entries	Total number of logged-in nodes.

display fc name-service database

Use display fc name-service database to display the name service database information.

Syntax

display fc name-service database [ vsan vsan-id [ fcid fcid ] ] [ verbose ]

display fc name-service database [ vsan vsan-id ] count

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the name service database information for all VSANs. On an FCF-NPV switch, this command displays the name service database information for only VSANs operating in FCF mode.

fcid fcid: Specifies an FC address in the range of 0x010000 to efffff (hexadecimal). If you do not specify an FC address, this command displays the name service entries of all FC addresses.

verbose: Displays detailed information about the name service database. If you do not specify this keyword, the command displays brief information about the name service database.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display brief information about the name service database for VSAN 1.

<Sysname> display fc name-service database vsan 1

VSAN 1:

FCID Type PWWN(vendor) FC4-type:feature

0x030001 0x01(N) 20:00:00:05:30:00:25:a3 SCSI-FCP

0x030200 0x01(N) 20:00:00:49:c9:28:c7:01 NPV

0x030300 0x01(N) 21:01:00:1b:32:a0:fa:00 NVMeoFC:Initiato

r/Target/Discovery

Table 18 Command output

Field	Description
FCID	FC address of the N_Port.
Type	Port type registered by the node with the switch: · 0x00(Unidentified)—No port type is registered. · 0x01(N)—N_Port, which directly connects to the fabric. · 0x02(NL)—NL_Port, which connects to the fabric through an arbitrated loop. · 0x03(F/NL)—F_Port or NL_Port. · 0x7f(Nx)—N_Port, NL_Port, or F_Port, or NL_Port. · 0x81(F)—F_Port, which connects to an N_Port. · 0x82(FL)—FL_Port, which connects to an NL_Port. · 0x84(E)—E_Port, which connects to an E_Port or B_Port. · 0x85(B)—B_Port. The ports on a bridge that connect two E_Ports are called B_Ports. · 0xXX(Unknown)—Port types other than the preceding ones. NOTE: Typically, only N_Ports and NL_Ports will be registered by a node.
PWWN(vendor)	WWN of the N_Port (name of vendor).
FC4-type:feature	FC4 type feature entry (when this command displays brief information, up to two FC4 type feature entries are displayed): · FC4 type—Includes SCSI-FCP, LLC/SNAP, SW_ILS, SNMP, GS3, VI, NPV, and NVMeoFC. · Feature—Includes supporting Initiator, Target, Discovery, or any combination of the three features.

# Display detailed information about the name service database.

<Sysname> display fc name-service database verbose

VSAN:1 FCID:0x030001

Port-WWN(vendor): 20:00:00:05:30:00:25:a3

Node-WWN: 20:00:00:05:30:00:25:9e

Class: 2,3

Node-IP-addr: 192.168.0.52

FC4-types(FC4_features): SCSI-FCP

Symbolic-port-name:

Symbolic-node-name:

Port-type: 0x01(N)

Fabric-port-WWN: 30:30:30:30:65:33:64:6b

Hard-addr: 0x000000

VSAN:1 FCID:0x030200

Port-WWN(vendor): 20:00:00:5a:c9:28:c7:01

Node-WWN: 10:00:00:5a:c9:28:c7:01

Class: 3

Node-IP-addr: 192.168.0.52

FC4-types(FC4_features): NPV

Symbolic-port-name: NPV-Sysname: Fc1/1/1

Symbolic-node-name: NPV-Sysname

Port-type: 0x01(N)

Fabric-port-WWN: 22:0a:00:05:30:00:26:1e

Hard-addr: 0x000000

--- Total 2 entries ---

# Display the number of name service entries for VSAN 1.

<Sysname> display fc name-service database vsan 1 count

Total entries: 2

Table 19 Command output

Field	Description
FCID	FC address of the N_Port.
Port-WWN(vendor)	WWN of the N_Port (name of vendor).
Node-WWN	WWN of the node.
Class	Class of service.
Node-IP-addr	IP address of the node.
FC4-types(FC4 features)	FC4 type (feature) entries: · FC4 type—Includes SCSI-FCP, LLC/SNAP, SW_ILS, SNMP, GS3, VI, NPV, and NVMeoFC. · Feature—Includes supporting Initiator, Target, Discovery, or any combination of the three features.
Symbolic-port-name	Symbolic name, which is used for describing an N_Port. For an NP_Port on an H3C NPV switch, it is in the form of system-name:port-name.
Symbolic-node-name	Symbolic name, which is used for describing a node. For an H3C NPV switch, it is the system-name.
Port-type	Port type registered by the node with the switch: · 0x00(Unidentified)—No port type is registered. · 0x01(N)—N_Port, which directly connects to the fabric. · 0x02(NL)—NL_Port, which connects to the fabric through an arbitrated loop. · 0x03(F/NL)—F_Port or NL_Port. · 0x7f(Nx)—N_Port, NL_Port, or F_Port, or NL_Port. · 0x81(F)—F_Port, which connects to an N_Port. · 0x82(FL)—FL_Port, which connects to an NL_Port. · 0x84(E)—E_Port, which connects to an E_Port or B_Port. · 0x85(B)—B_Port. The ports on a bridge that connect two E_Ports are called B_Ports. · 0xXX(Unknown)—Port types other than the preceding ones. NOTE: Typically, only N_Ports and NL_Ports will be registered by a node.
Fabric-port-WWN	WWN of the F_Port.
Hard-addr	Hardware address of the N_Port.
Total entries	Number of entries in the VSAN.

display fc scr-table

Use display fc scr-table to display the State Change Registration (SCR) list of N_Ports in VSANs.

Syntax

display fc scr-table [ vsan vsan-id ] [ count ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the SCR lists for all VSANs. On an FCF-NPV switch, this command displays the SCR lists for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display the SCR list.

<Sysname> display fc scr-table

SCR table for VSAN 1:

FCID REGISTERED FOR

0x1b0300 fabric detected rscns

0x010121 nx_port detected rscns

fabric name change rscns

peer zone change rscns

--- Total 2 entries ---

# Display the number of SCR entries in VSAN 1.

<Sysname> display fc scr-table vsan 1 count

Total entries: 2

Table 20 Command output

Field	Description
SCR table for VSAN	SCR list in a VSAN.
FCID	FC address of the N_Port.
REGISTERED FOR	Type of Registered State Change Notification (RSCN) messages to accept: · fabric detected rscns—Accepts all RSCN messages sent by the switches in the fabric. · nx_port detected rscns—Accepts all RSCN messages sent by N_Ports. · fabric name change rscns—Accepts all RSCN messages sent for fabric name changes. · peer zone change rscns—Accepts all RSCN messages sent for peer zone changes. · full rscns—Accepts all RSCN messages.
Total entries	Number of SCR entries in the VSAN.

display fc switch-wwn

Use display fc switch-wwn to display the local switch WWN.

Syntax

display fc switch-wwn

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the local switch WWN.

<Sysname> display fc switch-wwn

Switch WWN is 10:00:00:0d:ec:ff:a3:25

display fc timer

Use display fc timer to display fabric timers.

Syntax

display fc timer [ distributed-services | error-detect | resource-allocation ] [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

distributed-services: Displays the distributed service timeout period, in milliseconds.

error-detect: Displays the error detection timeout period, in milliseconds.

resource-allocation: Displays the resource allocation timeout period, in milliseconds.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays global fabric timer information.

Usage guidelines

If you do not specify the distributed-services, error-detect, or resource-allocation keyword, this command displays all fabric timers.

Examples

# Display all the fabric timers for VSAN 1.

<Sysname> display fc timer vsan 1

Timer of VSAN 1:

Distributed-services timer: 5000 ms

Error-detect timer: 2000 ms

Resource-allocation timer: 10000 ms

display fcid allocation

Use display fcid allocation to display FC address assignment information.

Syntax

display fcid allocation [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays FC address assignment information for all VSANs. On an FCF-NPV switch, this command displays the FC address assignment information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display FC address assignment information for VSAN 1.

<Sysname> display fcid allocation vsan 1

VSAN 1:

Free FCIDs: 0xef0000 to 0xef06ff

0xef0701 to 0xef08ff

0xef0901 to 0xefffff

Assigned FCIDs: 0xef0700

0xef0900

Number of free FCIDs: 65534

Number of assigned FCIDs: 2

display fcid persistent

Use display fcid persistent to display persistent FC address entries.

Syntax

display fcid persistent [ unused ] [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

unused: Specifies unused persistent FC address entries. If the bound WWN in a persistent FC address entry is not online, the persistent FC address entry is called an unused persistent FC address entry. If you do not specify this keyword, the command displays all persistent FC address entries.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays persistent FC address entries for all VSANs. On an FCF-NPV switch, this command displays the FC address entries for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display persistent FC address entries for all VSANs.

<Sysname> display fcid persistent

VSAN 1:

FCID persistence: Enabled

Total entries: 3

WWN FCID Used Assignment

10:00:00:00:c9:ef:39:5f 0x1e0002 Yes Dynamic

10:00:00:00:c9:ef:39:60 0x1e1000 Yes Static

10:00:00:00:c9:ef:39:68 0x1e000a Yes Dynamic

VSAN 2:

FCID persistence: Disabled

Total entries: 0

Table 21 Command output

Field	Description
Used	Indicates whether the FC address is used: · Yes—The FC address is used and the WWN is online. · No—The FC address is not used and the WWN is offline.
Assignment	FC address type: · Dynamic. · Static.

Field

Description

Used

Indicates whether the FC address is used:

· Yes—The FC address is used and the WWN is online.

· No—The FC address is not used and the WWN is offline.

Assignment

FC address type:

· Dynamic.

· Static.

display rdp database

Use display rdp database to display RDP database information.

Syntax

display rdp database [ port-name port-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

port-name port-name: Specifies a port by its name, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number. The port can be any port in the FC SAN. If you do not specify a port, this command displays RDP database information for all ports in the FC SAN.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

RDP database information can be displayed only after Smart SAN is enabled for FC.

The RDP database includes the RDP database information of the following ports:

· N_Ports directly connected to the switch.

· Ports on the switch.

· N_Ports not directly connected to the switch and ports on other switches in the FC SAN.

For N_Ports, the RDP database includes information about only N_Ports that have registered with the device.

Examples

# Display the RDP database information for all ports in the FC SAN.

<Sysname> display rdp database port-name 10:00:00:00:c9:88:a4:9e

Port Name: 28:05:00:e0:fc:f1:58:2a

Node Name: -

Port Speed:

Port Speed Capabilities: 2 Gbps, 4Gbps, 8Gbps, 16Gbps

Port Operating Speed: 4 Gbps

Link Error Status (FC):

Link Failure Count: 1

Loss-of-Synchronization Count: 2

Loss-of-Signal Count: 3

Primitive Sequence Protocol Errors: 2

Invalid Transmission Words: 1

Invalid CRC Count: 1

SFP Diagnostics:

Temperature:

High Alarm: 127.99C Low Alarm: -128.00C

High Warning: 120.00C Low Warning: -120.00C

Current: 40C

State: Normal

Voltage:

High Alarm: 6.3000V Low Alarm: 3.7000V

High Warning: 5.5000V Low Warning: 4.5000V

Current: 5.0000V

State: Normal

Bias Current:

High Alarm: 120.0000mA Low Alarm: 70.0000mA

High Warning: 110.0000mA Low Warning: 80.0000mA

Current: 110.9000mA

State: High Warning

Tx Power:

High Alarm: 6.5000mW Low Alarm: 5.0000mW

High Warning: 6.3000mW Low Warning: 5.3000mW

Current: 6.0000mW

State: Normal

Rx Power:

High Alarm: 6.5000mW Low Alarm: 5.0000mW

High Warning: 6.3000mW Low Warning: 5.3000mW

Current: 6.0000mW

State: Normal

Tx Type: Short Wave Laser

Optical Port: Yes

Connector Type: SFP+

FEC Active: No

Buffer Credit:

Receive B2B Credit: 15

Transmit B2B Credit: 15

Nominal Port RTT: 10000ns

Optical Product Data:

Vendor Name: H3C

Part Number: SFP-XG-LX-SM1310

Serial Number: AA05011023

Revision: N

Date: -

Port Name: 28:05:00:e0:fc:f1:58:2a

Node Name: -

Table 22 Command output

Field	Description
Port Name	Port WWN.
Node Name	This field displays the node WWN for an Nx_Port, a hyphen (-) for an F_Port or E_Port, and the WWN of the NPV switch for an NP_Port.
Fabric Port Name	WWN of the F_Port or NP_Port directly connected to the Nx_Port.
Fabric Node Name	WWN of the switch where the F_Port or NP_Port directly connected to the Nx_Port resides.
Port Speed Capabilities	The supported speed can be one or more of the following options: · 4 Gbps. · 8 Gbps. · 16 Gbps. This field displays Unknown for speeds other than the preceding ones.
Port Operating Speed	The current speed can only be one of the following options: · 4 Gbps. · 8 Gbps. · 16 Gbps. This field displays Unknown for speeds other than the preceding ones.
Link Error Status	Link error state: · Link Error Status (FC) —Link error state for the FC interface directly connected to the Nx_Port.
Link Failure Count	Number of link failures detected through physical link transition detection.
Virtual Link Failure Count	Number of link failures detected by the virtual link maintenance protocol.
Missing FIP Keep Alive or Discovery Advertisement Count	Number of missing virtual link maintenance protocol frames.
Symbol Error During Carrier Count	Number of reception errors at the PHY layer that occur during frame reception.
Error Block Count	Cumulative count of the events counted by the 8-bit errored blocks counter.
Frame Check Sequence Error Count	Number of Ethernet frames received that are an integral number of octets in length and do not pass the FCS check.
Temperature	Internally measured transceiver temperature.
Voltage	Internally measured supply voltage.
Bias Current	Measured transmitter laser bias current.
Tx Power	Measured coupled TX output power.
Rx Power	Measured received optical power.
Lane	This field is displayed only when a multi-channel QSFP transceiver module is used.
Tx Type	Transmitter type of the Nx_Port: · Short Wave Laser. · Long Wave Laser LC 1310nm. · Long Wave Laser LL 1550nm.
Optical Port	Indicates whether the Nx_Port is an optical port: Yes or No.
FEC Active	Indicates whether Forward Error Correction (FEC) is active: Yes or No.
Corrected blocks	Number of FEC blocks corrected by hardware.
Uncorrected blocks	Number of FEC blocks not corrected by hardware.
Receive B2B Credit	B2B credit information of the local end.
Transmit B2B Credit	B2B credit information of the remote end.
Nominal Port RTT	Roundtrip time for the port to receiving and sending packets. Unknown means that the roundtrip time is not obtained.
Revision	Vendor's revision level for the part number provided.
Date	Date when the product was manufactured.

display rdp request-polling-interval

Use display rdp request-polling-interval to display the interval for sending RDP request packets.

Syntax

display rdp request-polling-interval

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The interval for sending RDP request packets can be displayed only after Smart SAN is enabled for FC.

Examples

# Display the interval for sending RDP request packets.

<Sysname> display rdp request-polling-interval

RDP request-polling-interval: 30 minutes

display smartsan status

Use display smartsan status to display the Smart SAN status.

Syntax

display smartsan status

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display the Smart SAN status.

<Sysname> display smartsan status

Smart SAN Status:

FC: Enabled

iSCSI: Disabled

domain auto-reconfigure enable

Use domain auto-reconfigure enable to enable automatic reconfiguration in a VSAN.

Use undo domain auto-reconfigure enable to disable automatic reconfiguration in a VSAN.

Syntax

domain auto-reconfigure enable

undo domain auto-reconfigure enable

Default

Automatic reconfiguration is disabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

This command takes effect only when the fabric configuration feature is enabled.

A fabric reconfiguration triggers a principal switch selection phase.

A disruptive reconfiguration is automatically performed if the domain ID lists overlap when two fabrics are merged.

A nondisruptive reconfiguration is automatically performed when one of the following conditions exists:

· When two fabrics are merged, the principal switch information of the two fabrics is different, and the domain ID lists are not empty and do not overlap.

· A principal link in a fabric goes down.

Examples

# Enable the automatic reconfiguration feature in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] domain auto-reconfigure enable

Related commands

domain configure enable

Use domain configure enable to enable the fabric configuration feature in a VSAN.

Use undo domain configure enable to disable the fabric configuration feature in a VSAN.

Syntax

domain configure enable

undo domain configure enable

Default

The fabric configuration feature is enabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

To dynamically build a fabric, you must enable the fabric configuration feature on switches. After you enable the fabric configuration feature on FCF switches, the switches exchange messages to select the principal switch. Then, the principal switch dynamically assigns domain IDs to all switches in the fabric.

To statically build a fabric, you must disable the fabric configuration feature on switches and manually set a unique domain ID for each switch. After you disable the fabric configuration feature on FCF switches, the switches will not select a principal switch and cannot obtain domain IDs dynamically.

Examples

# Enable the fabric configuration feature in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] domain configure enable

domain restart

Use domain restart to manually initiate a fabric reconfiguration in a VSAN.

Syntax

domain restart [ disruptive ]

Views

VSAN view

Predefined user roles

network-admin

Parameters

disruptive: Initiates a disruptive reconfiguration. If you do not specify this keyword, the command initiates a nondisruptive reconfiguration.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

This command takes effect only when the fabric configuration feature is enabled.

A fabric reconfiguration triggers a principal switch selection phase.

A fabric reconfiguration can be disruptive or nondisruptive.

· Disruptive reconfiguration—Floods Reconfigure Fabric (RCF) frames throughout the fabric and notifies all switches to perform a disruptive reconfiguration. During the reconfiguration procedure, each switch clears all data and performs renegotiation, which will interrupt data transmission in the entire fabric.

· Nondisruptive reconfiguration—Floods Build Fabric (BF) frames throughout the fabric and notifies all switches to perform a nondisruptive reconfiguration. During the reconfiguration procedure, each switch tries to save the last running data for its domain ID to remain unchanged. Thus, data transmission in the fabric is not disrupted.

For fabric settings that do not take effect immediately (for example, switch priority), you can perform a disruptive reconfiguration to make them take effect.

Examples

# Manually initiate a disruptive reconfiguration in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] domain restart disruptive

The command may cause traffic interruption. Continue? [Y/N]:y

Related commands

domain configure enable

domain-id

Use domain-id to set a domain ID in a VSAN.

Use undo domain-id to restore the default.

Syntax

domain-id domain-id { preferred | static }

undo domain-id

Default

The domain ID is 0 preferred in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

domain-id: Specifies a domain ID in the range of 1 to 239.

preferred: Specifies the domain ID as preferred.

static: Specifies the domain ID as static.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

The upper-layer protocol identifies only the WWNs, but FCF switches use domain IDs to route and forward packets. Domain IDs are assigned on a per-VSAN basis and have a default value of 0, which cannot distinguish devices. Therefore, you must statically configure or dynamically assign domain IDs for FCF switches.

In the static domain ID assignment method, the ID type configuration does not affect the assignment result.

In the dynamic domain ID assignment method, the principal switch assigns a domain ID to each switch in the fabric.

· If a non-principal switch fails to get the configured preferred domain ID from the principal switch, it accepts any other domain ID assigned by the principal switch.

· If a non-principal switch fails to get the configured static domain ID, it does not accept any other domain ID and isolates the upstream principal link.

As a best practice, configure domain IDs of the same type for all switches in a VSAN.

Examples

# Configure static domain ID 55 in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] domain-id 55 static

Nondisruptive reconfiguration might be performed or the switch might be isolated. Continue? [Y/N]:y

fabric-name

Use fabric-name to set a fabric name in a VSAN.

Use undo fabric-name to restore the default.

Syntax

fabric-name name

undo fabric-name

Default

The fabric name is the WWN of the switch.

Views

VSAN view

Predefined user roles

network-admin

Parameters

name: Specifies a fabric name, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

An FCF switch supports assigning a fabric name to each VSAN, in the same format as the WWN (a 64-bit address).

Set fabric names only when you build a fabric statically. You must set the same fabric name on all switches in a VSAN. In a dynamically built fabric, each VSAN uses the WWN of the principal switch as the fabric name.

Examples

# Set the fabric name to 10:11:12:13:14:15:16:17 in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] fabric-name 10:11:12:13:14:15:16:17

fc domain rcf-reject

Use fc domain rcf-reject to configure an interface to reject the RCF requests received in a VSAN.

Use undo fc domain rcf-reject to configure an interface to accept the RCF requests received in a VSAN.

Syntax

fc domain rcf-reject vsan vsan-id

undo fc domain rcf-reject vsan vsan-id

Default

An interface does not reject the RCF requests received in a VSAN.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

In a stable fabric, to avoid unnecessary disruptive reconfigurations, you can configure an interface to reject the RCF requests received in a VSAN. With this feature, when the interface receives an RCF request in the VSAN, the switch replies with a reject message and isolates the interface.

Examples

# Configure FC 1/1/1 to reject the RCF requests received in VSAN 1.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fc domain rcf-reject vsan 1

fc login-limit

Use fc login-limit to set the maximum number of logged-in nodes allowed in a VSAN.

Use undo fc login-limit to restore the default.

Syntax

fc login-limit max-number

undo fc login-limit

Default

The number of logged-in nodes allowed in a VSAN is not limited.

Views

VSAN view

Predefined user roles

network-admin

Parameters

max-number: Specifies the maximum number of logged-in nodes, in the range of 1 to 65535.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

If the number of nodes that have logged in exceeds the maximum number, no logged-in nodes will be logged out. However, any new nodes cannot log in. You can log out nodes by shutting down interfaces connected to these nodes.

Examples

# Configure VSAN 2 to allow up to 256 nodes to log in.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] fc login-limit 256

fc name-service auto-discovery

Use fc name-service auto-discovery to enable SCSI-FCP information autodiscovery.

Use undo fc name-service auto-discovery to disable SCSI-FCP information autodiscovery.

Syntax

fc name-service auto-discovery

undo fc name-service auto-discovery

Default

SCSI-FCP information autodiscovery is enabled.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

In some situations, for example, when a node logs out and then logs back in, the node does not register SCSI-FCP support. As a result, the node does not have a Feature value. This might cause communication failure between the node and other nodes.

This command enables the switch to automatically obtain SCSI-FCP support and the Feature value by sending a PRLI packet to the node logging in. Then, the switch stores the SCSI-FCP information in the name service database.

NOTE:

After this command is configured, nodes with older-model HBAs might not actively register name service information with the switch.

Examples

# Enable SCSI-FCP information autodiscovery in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] fc name-service auto-discovery

fc timer distributed-services

Use fc timer distributed-services to set the global distributed service timeout period.

Use undo fc timer distributed-services to restore the default.

Syntax

fc timer distributed-services value

undo fc timer distributed-services

Default

The global distributed service timeout period is 5000 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the distributed service timeout period in the range of 5000 to 10000 milliseconds.

Usage guidelines

The distributed service timeout period can be set in system view or VSAN view.

The setting in system view takes effect on all VSANs. The setting in VSAN view takes effect only on the current VSAN.

If you set the distributed service timeout period both globally and for a VSAN, the setting for the VSAN takes precedence.

Examples

# Set the global distributed service timeout period to 6000 milliseconds.

<Sysname> system-view

[Sysname] fc timer distributed-services 6000

Related commands

timer distributed-services

fc timer error-detect

Use fc timer error-detect to set the global error detection timeout period.

Use undo fc timer error-detect to restore the default.

Syntax

fc timer error-detect value

undo fc timer error-detect

Default

The global error detection timeout period is 2000 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the error detection timeout period in the range of 1000 to 10000 milliseconds.

Usage guidelines

The error detection timeout period can be set in system view or VSAN view.

The setting in system view takes effect on all VSANs. The setting in VSAN view takes effect only on the current VSAN.

If you set the error detection timeout period both globally and for a VSAN, the setting for the VSAN takes precedence.

Examples

# Set the global error detection timeout period to 6000 milliseconds.

<Sysname> system-view

[Sysname] fc timer error-detect 6000

Related commands

timer error-detect

fc timer resource-allocation

Use fc timer resource-allocation to set the global resource allocation timeout period.

Use undo fc timer resource-allocation to restore the default.

Syntax

fc timer resource-allocation value

undo fc timer resource-allocation

Default

The global resource allocation timeout period is 10000 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the resource allocation timeout period in the range of 5000 to 10000 milliseconds.

Usage guidelines

The resource allocation timeout period can be set in system view or VSAN view.

The setting in system view takes effect on all VSANs. The setting in VSAN view takes effect only on the current VSAN.

If you set the resource allocation timeout period both globally and for a VSAN, the setting for the VSAN takes precedence.

Examples

# Set the global resource allocation timeout period to 6000 milliseconds.

<Sysname> system-view

[Sysname] fc timer resource-allocation 6000

Related commands

timer resource-allocation

fc wwn default-fc4-type

Use fc wwn default-fc4-type to configure the default FC4 information for a node.

Use undo fc wwn default-fc4-type to delete the default FC4 information of a node.

Syntax

fc wwn wwn-value default-fc4-type { type-value feature feature-map | scsi-fcp feature { feature-map | both | initiator | target } }

undo fc wwn wwn-value default-fc4-type { type-value | scsi-fcp }

Default

The default FC4 information for a node is not configured for a node.

Views

System view

Predefined user roles

network-admin

Parameters

wwn-value: Specifies an N_Port by its WWN in the format of xx:xx:xx:xx:xx:xx:xx:xx (hexadecimal).

type-value: Specifies a supported FC4-Type by its value in the range of 0 to 255. The FC4-Type field is 256 bits, each of which represents an FC4-Type. If a bit is set to 1, the FC4-Type that the bit represents is supported. Only one bit can be set to 1 at the same time.

scsi-fcp: Specifies the supported FC4-Type as SCSI-FCP, which has a type-value of 8.

feature feature-map: Specifies the Feature value for the supported FC4-Type. The value range for feature-map is 0 to 15. The Feature field is 4 bits, each of which represents a Feature. If a bit is set to 1, the Feature that the bit represents is supported. Multiple bits can be set to 1 at the same time. For example, if the value is set to 15, the node supports four Features of the FC4-Type. If the value is set to 0, the node supports none of the four Features. When you specify supported FC4-Type as SCSI-FCP, you can configure the following keywords:

· initiator: Specifies support for the initiator Feature, which has a feature-map of 2.

· target: Specifies support for the target Feature, which has a feature-map of 1.

· both: Specifies support for both initiator and target Features, which has a feature-map of 3.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The switch records the default FC4 information in the name service database for a node when the following conditions exist:

· The node does not register FC4 information.

· The switch fails to obtain SCSI-FCP information from the node.

The switch replaces the default FC4 information with the registered FC4 information or obtained SCSI-FCP information when one of the following events occurs:

· A node registers FC4 information.

· The switch obtains the SCSI-FCP information.

You can execute this command multiple times to configure different FC4-Types for one N_Port.

Examples

# Configure the default FC4 information for the node with WWN 00:00:00:11:22:33:44:55.

<Sysname> system-view

[Sysname] fc wwn 00:00:00:11:22:33:44:55 default-fc4-type scsi-fcp feature target

[Sysname] fc wwn 00:00:00:11:22:33:44:55 default-fc4-type 9 feature 7

fcid persistent enable

Use fcid persistent enable to enable the persistent FC address feature in a VSAN.

Use undo fcid persistent enable to disable the persistent FC address feature in a VSAN.

Syntax

fcid persistent enable

undo fcid persistent enable

Default

The persistent FC address feature is enabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Manually configured persistent FC address entries take effect only when the persistent FC address feature is enabled. After you disable the persistent FC address feature, all static and dynamic persistent FC address entries are deleted.

An association between a WWN and its assigned FC address is recorded when the WWN logs in. When you re-enable the persistent FC address feature after you disable it, the system generates dynamic persistent FC address entries for the associations.

The system can store up to 40000 persistent FC address entries. When this limit is reached, the system deletes dynamic persistent FC address entries for all offline WWNs before generating new ones.

Examples

# Disable the persistent FC address feature in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] undo fcid persistent enable

Related commands

wwn fcid

priority

Use priority to set the switch priority in a VSAN.

Use undo priority to restore the default.

Syntax

priority priority

undo priority

Default

The switch priority is 128 in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

priority: Specifies the switch priority in the range of 1 to 254. A smaller value indicates a higher priority.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

One FC switch can have different priorities in different VSANs. The FC switch with the highest priority in a VSAN will be selected as the principal switch in that VSAN.

To make the priority setting take effect, perform a disruptive reconfiguration by using the domain restart disruptive command.

Examples

# Set the switch priority to 64 in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] priority 64

Related commands

domain restart

rdp request-polling-interval

Use rdp request-polling-interval to set the interval for sending RDP request packets.

Use undo rdp request-polling-interval to restore the default.

Syntax

rdp request-polling-interval interval

undo rdp request-polling-interval

Default

The interval for sending RDP request packets is 30 minutes.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for sending RDP request packets, in the range of 5 to 1440 minutes.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The interval for sending RDP request packets can be set only after Smart SAN is enabled for FC.

Examples

# Set the interval for sending RDP request packets to 5 minutes.

<Sysname> system-view

[Sysname] rdp request-polling-interval 5

Related commands

display rdp request-polling-interval

reset fcid persistent

Use reset fcid persistent to clear persistent FC address entries for offline WWNs.

Syntax

reset fcid persistent [ static ] [ vsan vsan-id ]

Views

User view

Predefined user roles

network-admin

Parameters

static: Specifies static persistent FC address entries. If you do not specify this keyword, the command clears dynamic persistent FC address entries.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command clears persistent FC address entries for offline WWNs in all VSANs. On an FCF-NPV switch, this command clears the FC address entries for offline WWNs in only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Clear all dynamic persistent FC address entries in VSAN 1.

<Sysname> reset fcid persistent vsan 1

rscn aggregation enable

Use rscn aggregation enable to enable RSCN aggregation.

Use undo rscn aggregation enable to disable RSCN aggregation.

Syntax

rscn aggregation enable

undo rscn aggregation enable

Default

RSCN aggregation is disabled.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

For multiple change events occurring within the RSCN aggregation timer interval, RSCN aggregation places the FC addressees of multiple nodes with changes into a single RSCN. This feature reduces the number of RSCNs sent to the concerned registered nodes.

As a best practice, enable RSCN aggregation and set the same RSCN aggregation timer value on all switches in a VSAN.

Examples

# Enable RSCN aggregation in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] rscn aggregation enable

Related commands

rscn aggregation timer

Use rscn aggregation timer to set the RSCN aggregation timer.

Use undo rscn aggregation timer to restore the default.

Syntax

rscn aggregation timer value

undo rscn aggregation timer

Default

The RSCN aggregation timer is 2000 milliseconds.

Views

VSAN view

Predefined user roles

network-admin

Parameters

value: Specifies the RSCN aggregation timer value in the range of 100 to 2000 milliseconds.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

The RSCN aggregation timer takes effect only when RSCN aggregation is enabled.

As a best practice, enable RSCN aggregation and set the same RSCN aggregation timer value on all switches in a VSAN.

Examples

# Set the RSCN aggregation timer of VSAN 1 to 1500 milliseconds.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] rscn aggregation timer 1500

Related commands

rscn aggregation enable

smartsan enable

Use smartsan enable to enable Smart SAN.

Use undo smartsan enable to disable Smart SAN.

Syntax

smartsan enable [ fcoe | iscsi ]

undo smartsan enable [ fcoe | iscsi ]

Default

Smart SAN is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

fcoe: Specifies Smart SAN for FC.

iscsi: Specifies Smart SAN for iSCSI. This keyword is not supported in the current software version.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

If you do not specify the fcoe or iscsi keyword, Smart SAN is enabled or disabled for both FC and iSCSI.

The undo smartsan enable command deletes local peer zone information, but not peer zone information received from other switches. For more information about peer zones, see FC Configuration Guide.

Examples

# Enable Smart SAN for FC.

<Sysname> system-view

[Sysname] smartsan enable fcoe

Related commands

display smartsan status

snmp-agent trap enable fc-fabric

Use snmp-agent trap enable fc-fabric to enable SNMP notifications for the fabric module.

Use undo snmp-agent trap enable fc-fabric to disable SNMP notifications for the fabric module.

Syntax

snmp-agent trap enable fc-fabric [ domain-id-change | fabric-change ] *

undo snmp-agent trap enable fc-fabric [ domain-id-change | fabric-change ] *

Default

All SNMP notifications for the fabric module are disabled.

Views

System view

Predefined user roles

network-admin

Parameters

domain-id-change: Specifies notifications about domain ID changes.

fabric-change: Specifies notifications about fabric changes.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

To report critical fabric module events to an NMS, enable SNMP notifications for the fabric module. For fabric module event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

If you do not specify a notification, this command enables all SNMP notifications for the fabric module.

After you enable SNMP notifications for domain ID changes, the switch generates a notification when its domain ID changes in a VSAN. The notification includes the VSAN ID, the switch WWN, and the new domain ID.

After you enable SNMP notifications for fabric changes, the switch generates a notification when it sends or receives a BF or RCF frame for fabric reconfiguration. The notification includes the VSAN ID for fabric reconfiguration.

Examples

# Enable all SNMP notifications for the fabric module.

<Sysname> system-view

[Sysname] snmp-agent trap enable fc-fabric

snmp-agent trap enable fc-name-service

Use snmp-agent trap enable fc-name-service to enable SNMP notifications for the name service module.

Use undo snmp-agent trap enable fc-name-service to disable SNMP notifications for the name service module.

Syntax

snmp-agent trap enable fc-name-service [ login| logout ] *

undo snmp-agent trap enable fc-name-service [ login| logout ] *

Default

All SNMP notifications for the name service module are disabled.

Views

System view

Predefined user roles

network-admin

Parameters

logout: Specifies notifications about node logout.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

To report critical name service module events to an NMS, enable SNMP notifications for the name service module. For name service event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

If you do not specify a notification, this command enables all SNMP notifications for the name service module.

After you enable SNMP notifications for node login or logout, the switch generates a notification when a node registers or deregisters its name service information with the switch. The notification includes the VSAN ID, the switch WWN, and the WWN of the N_Port.

Examples

# Enable all SNMP notifications for the name service module.

<Sysname> system-view

[Sysname] snmp-agent trap enable fc-name-service

timer distributed-services

Use timer distributed-services to set the distributed service timeout period for a VSAN.

Use undo timer distributed-services to restore the default.

Syntax

timer distributed-services value

undo timer distributed-services

Default

The distributed service timeout period is 5000 milliseconds for a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

value: Specifies the distributed service timeout period in the range of 5000 to 10000 milliseconds.

Usage guidelines

The distributed service timeout period can be set in system view or VSAN view.

The setting in system view takes effect on all VSANs. The setting in VSAN view takes effect only on the current VSAN.

If you set the distributed service timeout period both globally and for a VSAN, the setting for the VSAN takes precedence.

Examples

# Set the distributed service timeout period to 6000 milliseconds for VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] timer distributed-services 6000

Related commands

fc timer distributed-services

timer error-detect

Use timer error-detect to set the error detection timeout period for a VSAN.

Use undo timer error-detect to restore the default.

Syntax

timer error-detect value

undo timer error-detect

Default

The error detection timeout period is 2000 milliseconds for a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

value: Specifies the error detection timeout period in the range of 1000 to 10000 milliseconds.

Usage guidelines

The error detection timeout period can be set in system view or VSAN view.

The setting in system view takes effect on all VSANs. The setting in VSAN view takes effect only on the current VSAN.

If you set the error detection timeout period both globally and for a VSAN, the setting for the VSAN takes precedence.

Examples

# Set the error detection timeout period to 6000 milliseconds for VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] timer error-detect 6000

Related commands

fc timer error-detect

timer resource-allocation

Use timer resource-allocation to set the resource allocation timeout period for a VSAN.

Use undo timer resource-allocation to restore the default.

Syntax

timer resource-allocation value

undo timer resource-allocation

Default

The resource allocation timeout period is 10000 milliseconds for a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

value: Specifies the resource allocation timeout period in the range of 5000 to 10000 milliseconds.

Usage guidelines

The resource allocation timeout period can be set in system view or VSAN view.

The setting in system view takes effect on all VSANs. The setting in VSAN view takes effect only on the current VSAN.

If you set the resource allocation timeout period both globally and for a VSAN, the setting for the VSAN takes precedence.

Examples

# Set the resource allocation timeout period to 6000 milliseconds for VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] timer resource-allocation 6000

Related commands

fc timer resource-allocation

wwn fcid

Use wwn fcid to configure a persistent FC address entry.

Use undo wwn fcid to delete a persistent FC address entry.

Syntax

wwn wwn-value fcid fcid-value [ dynamic ]

undo wwn wwn-value fcid

Default

No manually configured persistent FC address entries exist.

Views

VSAN view

Predefined user roles

network-admin

Parameters

wwn-value: Specifies the WWN of an N_Port or NP_Port, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

fcid-value: Specifies an FC address in the format of xxxxxx, where x is a hexadecimal number. The first two digits indicate the domain ID, the next two digits indicate the area ID, and the remaining two digits indicate the port ID. The domain ID must be a runtime domain ID in the VSAN.

dynamic: Specifies the persistent FC address entry as dynamic. If you do not specify this keyword, the configured persistent FC address entry is static.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

A WWN can be bound to only one FC address and vice versa. If a WWN has been assigned another FC address or the FC address has been assigned to another WWN, the persistent FC address entry cannot be configured.

Manually configured persistent FC address entries take effect only when the persistent FC address feature is enabled.

When the entry limit (40000) is reached, the system deletes dynamic persistent FC address entries for all offline WWNs before adding new entries. If all persistent FC address entries are static or all WWNs are online, the system denies all new FLOGI requests.

Examples

# In VSAN 1, configure a static persistent FC address entry (WWN is 33:e8:00:05:30:00:16:df and FC address is 010312).

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] wwn 33:e8:00:05:30:00:16:df fcid 010312

Related commands

fcid persistent enable

FC routing and forwarding commands

display fc exchange

Use display fc exchange to display FC exchange entries.

Syntax

display fc exchange { link | protocol }

display fc exchange link verbose exid exid

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

link: Specifies link exchange entries.

protocol: Specifies protocol exchange entries.

verbose: Displays detailed information about link exchange entries.

exid exid: Displays link exchange entries for an exchange ID in the range of 0 to 65534.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The exchange is a basic concept of FC. All data frames and control frames are transmitted based on the exchange. An exchange indicates one data exchange between communication entities and can contain multiple bidirectional packet exchanges.

An exchange pair (initiating exchange and responding exchange) must be created for each data exchange. Service classes that provide reliable transmission services (classes 1, 2, and 6) perform packet acknowledgment, error detection, and packet retransmission based on the exchange pair.

Exchanges include the following categories:

· Protocol exchange—Created only at the server end based on the protocol number and VSAN ID and used for monitoring connection establishment.

· Link exchange—Created at both ends based on the exchange ID and used for packet exchange.

Examples

# Display the protocol exchange entries.

<Sysname> display fc exchange protocol

Local_ID:EXID Remote_ID:EXID State Protocol

0x000000:65535 0x000000:65535 LISTEN 5

# Display the link exchange entries.

<Sysname> display fc exchange link

Local_ID:EXID Remote_ID:EXID State Protocol

0x060501:1024 0x010001:1025 ESTABLISHED 7

# Display detailed information about the link exchange entry with exchange ID 1.

<Sysname> display fc exchange link verbose exid 1

protocol: 8

connection info: Local = 0x090801:1155 , Remote = 0x050001:1089

PCB flags: 0x2

FC Class: FC_CLASS_F

connection state: ESTABLISHED

VSAN ID: 25

Table 23 Command output

Field	Description
Local_ID:EXID/Local	FC address and exchange ID of the local end. This field is ignored for a protocol exchange.
Remote_ID:EXID/Remote	FC address and exchange ID of the peer end. This field is ignored for a protocol exchange.
State/connection state	Connection state of the FC exchange: · PREPARE—The protocol exchange is successfully bound, or the link exchange is waiting for the response packet. · LISTEN—The protocol exchange is monitoring the connection. · ESTABLISHED—The connection has been established. · ABTS—An ABTS was sent due to a connection timeout or error, and the ABTS ACK is being expected. · BA_ACC—An ABTS was received, an BA_ACC is replied, and an ACC ACK is being expected. · ABTS_ACK—An ABTS ACK was received, and a BA_ACC is being expected. · CLOSED—The connection is closed.
Slot/slot	Card where the FC exchange is created.
Protocol/protocol	FC protocol number.
PCB flags	FC exchange state flags: · 0x1—The value 0 indicates the sending end, and 1 indicates the replying end. · 0x2—The value 0 means there is no initiative, and 1 means there is initiative. · 0x4—The value 1 indicates the first packet of the exchange. · 0x8—The value 1 indicates that the exchange is waiting to be aged.
FC Class	FC connection service level (FC_CLASS_3 requires no ACK): · FC_CLASS_1. · FC_CLASS_2. · FC_CLASS_3. · FC_CLASS_F. · FC_CLASS_6.

display fc fib

Use display fc fib to display the FC FIB entries.

Syntax

display fc fib [ fcid [ mask-length ] ] vsan vsan-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

fcid: Specifies a destination FC address in the range of 000000 to ffffff (hexadecimal).

mask-length: Specifies the mask length for the destination address, in the range of 0 to 24.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 4095.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The device looks up the VSAN ID and FC address in the FC FIB for the outgoing interface.

If you specify both the fcid and mask-length arguments, this command displays FC FIB entries for the specified FC address and mask length.

If you specify the fcid argument but not the mask-length argument, this command displays FC FIB entries for the specified FC address according to the longest matching rule.

If you do not specify the fcid argument or the mask-length argument, this command displays all FC FIB entries.

Examples

# Display all the FC FIB entries in VSAN 18.

<Sysname> display fc fib vsan 18

FC FIB information in VSAN 18:

Destination count: 6

FIB entry count: 7

Destination/Mask Interface

0x030100/16 Fc1/1/1

0x030100/16 Fc1/1/2

0x030100/24 Fc1/1/3

0xfffc01/24 InLoop0

0xfffffa/24 InLoop0

0xfffffc/24 InLoop0

0xfffffd/24 InLoop0

# Display the FC FIB entries for the specified FC address according to the longest matching rule.

<Sysname> display fc fib 030100 vsan 18

FC FIB information in VSAN 18:

Destination count: 1

FIB entry count: 1

Destination/Mask Interface

0x030100/24 Fc1/1/3

# Display the FC FIB entries for the specified FC address and mask length.

<Sysname> display fc fib 030100 16 vsan 18

FC FIB information in VSAN 18:

Destination count: 1

FIB entry count: 2

Destination/Mask Interface

0x030100/16 Fc1/1/1

0x030100/16 Fc1/1/2

Table 24 Command output

Field	Description
Destination count	Number of destination addresses.
FIB entry count	Number of FIB entries, including equal-cost routes.
Destination/Mask	Destination address/mask length.
Interface	Outgoing interface.

display fc routing-table

Use display fc routing-table to display the FC routing table.

Syntax

display fc routing-table [ vsan vsan-id ] [ statistics | verbose ]

display fc routing-table vsan vsan-id fcid [ mask | mask-length ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 4095. If you do not specify a VSAN, this command displays routing information of all VSANs.

fcid: Specifies the destination FC address for FC routes, in the range of 010000 to efffff (hexadecimal).

mask: Specifies a hexadecimal mask of the FC address. This argument is used together with the fcid argument. The value of this argument can be ff0000, ffff00, or ffffff. If you do not specify a hexadecimal mask, this command displays the routing information for the FC address fcid with masks 0xff0000, 0xffff00, and 0xffffff.

mask-length: Specifies a decimal mask of the FC address. This argument is used together with the fcid argument. The value of this argument can be 8, 16, or 24. If you do not specify a decimal mask, this command displays the routing information for the FC address fcid with masks 8, 16, and 24.

statistics: Displays the statistics for the FC routing table.

verbose: Displays detailed information about the FC routing table.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The routing table stores routes discovered by various routing protocols. You can use this command to display brief information, detailed information, and statistics about the routing table.

The display fc routing-table [ vsan vsan-id ] [ statistics | verbose ] command displays all routes in a VSAN or in all VSANs. The display fc routing-table vsan vsan-id fcid [ mask | mask-length ] [ verbose ] command displays one route in a VSAN.

If you specify do not specify the statistics or verbose keyword, this command displays brief information about the FC routing table.

The brief information contains information about only active routes. The detailed information contains information about both active and inactive routes.

Examples

# Display brief information about all the routes in VSAN 5.

<Sysname> display fc routing-table vsan 5

Routing Table: VSAN 5

Destinations : 5 Routes : 8

Destination/mask Protocol Preference Cost Interface

0x040000/8 FSPF 20 100 Fc1/1/1

0x040000/8 FSPF 20 100 Fc1/1/2

0x040000/8 FSPF 20 100 Fc1/1/3

0x040000/8 FSPF 20 100 Fc1/1/4

0xfffc01/24 DIRECT 0 0 InLoop0

0xfffffa/24 DIRECT 0 0 InLoop0

0xfffffc/24 DIRECT 0 0 InLoop0

0xfffffd/24 DIRECT 0 0 InLoop0

# Display detailed information about all the routes in VSAN 5.

<Sysname> display fc routing-table vsan 5 verbose

Routing Table: VSAN 5

Destinations : 5 Routes : 5

Destination/mask: 0x120000/8

Protocol: STATIC

Preference: 10

Cost: 0

Interface: Fc1/1/1

State: Active

Age: 0h21m36s

Destination/mask: 0xfffc01/24

Protocol: DIRECT

Preference: 0

Cost: 0

Interface: InLoop0

State: Active

Age: 0h21m36s

Destination/mask: 0xfffffa/24

Protocol: DIRECT

Preference: 0

Cost: 0

Interface: InLoop0

State: Active

Age: 0h21m36s

Destination/mask: 0xfffffc/24

Protocol: DIRECT

Preference: 0

Cost: 0

Interface: InLoop0

State: Active

Age: 0h21m36s

Destination/mask: 0xfffffd/24

Protocol: DIRECT

Preference: 0

Cost: 0

Interface: InLoop0

State: Active

Age: 0h21m36s

Table 25 Command output

Field	Description
VSAN	VSAN number.
Destination/mask	FC address/mask.
Protocol	Protocol type: · DIRECT—Direct routes. · STATIC—Static routes. · FSPF—FSPF routes.
Preference	Route preference.
Cost	Route cost.
Interface	Outgoing interface.
State	Route state: Active or Inactive.
Age	Lifetime of the route in the routing table, in the format of XXhXXmXXs.

# Display the statistics for all the routes in VSAN 5.

<Sysname> display fc routing-table vsan 5 statistics

Routing Table: VSAN 5

Protocol route active added deleted

DIRECT 4 4 4 0

STATIC 1 1 1 0

FSPF 0 0 0 0

Total 5 5 5 0

Table 26 Command output

Field	Description
VSAN	VSAN number.
Protocol	Protocol type: · DIRECT—Direct routes. · STATIC—Static routes. · FSPF—FSPF routes.
route	Number of routes of the specified protocol type.
active	Number of active routes of the specified protocol type.
added	Number of added routes of the specified protocol type.
deleted	Number of deleted routes of the specified protocol type.
Total	Total number of routes.

Related commands

fc route-static

display fspf graceful-restart

Use display fspf graceful-restart to display FSPF GR status information.

Syntax

display fspf graceful-restart [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays FSPF GR status information for all VSANs. On an FCF-NPV switch, this command displays the FSPF GR status information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The FSPF GR status information includes the following:

· Whether GR restarter is enabled.

· Whether GR helper is enabled.

· Number of GR restarters being restarted.

· Number of GR helpers assisting in restarting the local device.

Examples

# Display FSPF GR status information.

<Sysname> display fspf graceful-restart

Graceful-restart capability : Disable

Helper capability : Enable

Graceful-restart period : 120 seconds

FSPF graceful restart information of VSAN 1:

Number of neighbors under helper : 0

Number of restarting neighbors : 0

FSPF graceful restart information of VSAN 2:

Number of neighbors under helper : 0

Number of restarting neighbors : 0

Table 27 Command output

Field	Description
Graceful-restart capability	Indicates whether GR restarter capability is enabled: Enable or Disable.
Helper capability	Indicates whether GR helper capability is enabled: Enable or Disable.
Number of neighbors under helper	Number of neighbors acting as GR helpers.
Number of restarting neighbors	Number of neighbors acting as GR restarters.

Related commands

fspf graceful-restart

fspf graceful-restart helper

fspf graceful-restart interval

display fspf lsdb

Use display fspf lsdb to display FSPF link state database (LSDB) information.

Syntax

display fspf lsdb [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays LSDB information for all VSANs. On an FCF-NPV switch, this command displays the LSDB information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The FSPF LSDB information includes the total number of link state records (LSRs) and information about each LSR.

Examples

# Display FSPF LSDB information.

<Sysname> display fspf lsdb

FSPF LSDB information of VSAN 1(01):

Total LSR count: 2

FSPF Link State Database for Domain 01

LSR Type : 1

LSR Age : 0

LSR Incarnation number : 0x80000008

LSR Checksum : 0x7deb

Number of links : 1

NbrDomainID IfIndex NbrIfIndex LinkType Cost

--------------------------------------------------------

2 0x68 0x68 1 265

FSPF Link State Database for Domain 02

LSR Type : 1

LSR Age : 6

LSR Incarnation number : 0x80000008

LSR Checksum : 0x7dea

Number of links : 1

NbrDomainID IfIndex NbrIfIndex LinkType Cost

--------------------------------------------------------

1 0x68 0x68 1 265

Table 28 Command output

Field	Description
FSPF LSDB information of VSAN	LSDB information for a VSAN. The value in parentheses is the domain ID in decimal of the local switch.
FSPF Link State Database for Domain	LSDB information for a domain ID (switch).
LSR Type	LSR type, which can only be Switch Link Record (0x01).
LSR Incarnation number	LSR instance number.
NbrDomainID	Neighbor domain ID.
IfIndex	Outgoing interface index of the local switch.
NbrIfIndex	Neighbor interface index.
Link Type	Link type: · 0x01—Point-to-point. · 0xF0-FF—Vendor-defined.
Cost	Link cost.

display fspf neighbor

Use display fspf neighbor to display FSPF neighbor information.

Syntax

display fspf neighbor [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays information about all FSPF neighbors. On an FCF-NPV switch, this command displays the FSPF neighbor information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The FSPF neighbor information includes the following details:

· Neighbor domain ID.

· Neighbor interface index.

· Outgoing interface index of the local switch.

· Remaining dead interval of the neighbor.

· Neighbor state.

Examples

# Display FSPF neighbor information.

<Sysname> display fspf neighbor

FSPF neighbor information of VSAN 1(01):

Interface NbrDomain IfIndex NbrIfIndex Dead Time State

Fc1/1/1 2 0x68 0x68 00:01:06 Full

Table 29 Command output

Field	Description
FSPF neighbor information of VSAN	FSPF neighbor information for a VSAN. The value in parentheses is the domain ID in decimal of the local switch.
Interface	Interface name of the local switch.
NbrDomain	Neighbor domain ID in decimal.
IfIndex	Outgoing interface index of the local switch.
NbrIfIndex	Neighbor interface index.
Dead Time	Remaining dead interval of the neighbor. If no hello packet is received from the neighbor after this interval, the neighbor state changes to Init.
State	Neighbor state: · Down—The neighbor does not start negotiation. · Init—The neighbor has started negotiation. · DB_Exchange—The neighbor has been discovered. · DB_Wait—The local switch has sent the LSR. · DB_Ack_Wait—The neighbor has sent the LSR. · Full—Synchronization is complete.

display fspf statistics

Use display fspf statistics to display FSPF statistics.

Syntax

display fspf statistics [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the FSPF statistics for all VSANs. On an FCF-NPV switch, this command displays the FSPF statistics for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

FSPF statistics contain global statistics and interface statistics.

· Global statistics—Contain the current number of SPF calculations, number of error packets, total number of packets received and sent.

· Interface statistics—Contain the total number of packets received and sent on each interface.

Examples

# Display FSPF statistics.

<Sysname> display fspf statistics

FSPF statistics of VSAN 1(01):

SPF computing count: 6

Statistics counters:

Bad packet : 0 Neighbor unknown : 0

Timer mismatch : 0 Neighbor state low : 0

Bad LSR : 0

Packet statistics:

Type Input Output

HELLO 50 50

LSU 5 5

LSA 4 4

Interface Fc1/1/1 statistics:

Type Input Output

HELLO 50 50

LSU 5 5

LSA 4 4

Table 30 Command output

Field	Description
FSPF statistics of VSAN	FSPF statistics for a VSAN. The value in parentheses is the domain ID in decimal of the local switch.
SPF computing count	Number of SPF calculations.
Interface statistics	Packet statistics on the interface.
Bad packet	Number of error packets.
Timer mismatch	Number of packets whose hello or dead interval does not match that of the neighbor.
Bad LSR	Number of error LSRs.
Neighbor unknown	Number of packets received from unknown neighbors.
Neighbor state low	Number of LSUs and LSAs received in Init state.
Type	Packet type: Hello, LSU, or LSA.
Input	Number of packets received.
Output	Number of packets sent.

Related commands

reset fspf counters

fc route-static

Use fc route-static to configure a static FC route.

Use undo fc route-static to delete a static FC route.

Syntax

fc route-static fcid { mask | mask-length } interface-type interface-number [ cost cost-value ]

undo fc route-static fcid { mask | mask-length } interface-type interface-number

Default

No static FC routes exist.

Views

VSAN view

Predefined user roles

network-admin

Parameters

fcid: Specifies the destination FC address of the static FC route, in the range of 010000 to efffff (hexadecimal).

mask: Specifies a hexadecimal mask of the FC address. This argument is used together with the fcid argument. The value of this argument can be ff0000, ffff00, or ffffff.

mask-length: Specifies the mask length of the FC address. This argument is used together with the fcid argument. The value of this argument can be 8, 16, or 24.

interface-type interface-number: Specifies the outgoing interface of the static FC route, which must be an existing FC interface or FC aggregate interface on the FCF switch.

cost cost-value: Specifies the cost of the route, in the range of 0 to 65535. The default is 0.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Static routes are manually configured by an administrator. After an administrator configures a static route, an FC frame to the specified destination is forwarded along the static route.

In a simple network, static routes are enough for implementing network connectivity. When the network fails or the network topology changes, you must manually modify the static routes.

Static routes support equal-cost routes. When you configure multiple equal-cost static routes to the same destination but with different outgoing interfaces, equal-cost routes are generated.

Examples

# Add a static FC route, whose destination FC address is 0x010000, mask is 8, outgoing interface is FC 1/1/1, and cost is 20.

<Sysname> system-view

[Sysname] vsan 5

[Sysname-vsan5] fc route-static 010000 8 fc 1/1/1 cost 20

Related commands

display fc routing-table

fspf cost

Use fspf cost to set the FSPF cost for an interface in a VSAN.

Use undo fspf cost to delete the FSPF cost setting of an interface in a VSAN.

Syntax

fspf cost cost-value vsan vsan-id

undo fspf cost vsan vsan-id

Default

The FSPF cost of an interface is calculated by using the formula 1.0e12/baud rate.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

cost-value: Specifies the FSPF cost in the range of 1 to 65535.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Each link has a cost. The route selection algorithm uses this value to determine the best route. The smaller the interface FSPF cost, the smaller the link cost.

Examples

# Set the FSPF cost to 1000 for FC 1/1/1 in VSAN 4.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fspf cost 1000 vsan 4

fspf dead-interval

Use fspf dead-interval to set the dead interval for an interface in a VSAN.

Use undo fspf dead-interval to delete the dead interval setting of an interface in a VSAN.

Syntax

fspf dead-interval interval vsan vsan-id

undo fspf dead-interval vsan vsan-id

Default

The dead interval for an interface in a VSAN is 80 seconds.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

interval: Specifies the dead interval in the range of 2 to 65535 seconds.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

After two switches establish a neighbor relationship, they send hello packets at the hello interval to each other to maintain the neighbor relationship. The dead interval specifies the time during which at least one hello packet must be received from a neighbor before the neighbor is considered nonexistent and is removed.

The dead interval must be greater than the hello interval and must be the same at the two ends of a link.

Examples

# Set the dead interval to 100 seconds for FC 1/1/1 in VSAN 4.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fspf dead-interval 100 vsan 4

Related commands

fspf hello-interval

fspf enable

Use fspf enable to enable FSPF in a VSAN.

Use undo fspf enable to disable FSPF in a VSAN.

Syntax

fspf enable

undo fspf enable

Default

FSPF is enabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

FSPF-related features work in a VSAN only after you enable FSPF in the VSAN.

Examples

# Enable FSPF in VSAN 4.

<Sysname> system-view

[Sysname] vsan 4

[Sysname-vsan4] fspf enable

fspf graceful-restart

Use fspf graceful-restart to enable FSPF GR.

Use undo fspf graceful-restart to disable FSPF GR.

Syntax

fspf graceful-restart

undo fspf graceful-restart

Default

FSPF GR is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Only FCF and FCF-NPV switches support this command.

FSPF Graceful Restart (GR) ensures nonstop forwarding of traffic by backing up FSPF configuration information in the following situations:

· Protocol restart.

· Active/standby switchover.

GR involves the following roles:

· GR restarter—GR-capable device where a protocol restart or active/standby switchover occurs.

· GR helper—The GR restarter's neighboring device that assists in the GR process.

Examples

# Enable FSPF GR.

<Sysname> system-view

[Sysname] fspf graceful-restart

Related commands

display fspf graceful-restart

fspf graceful-restart helper

Use fspf graceful-restart helper to enable FSPF GR helper.

Use undo fspf graceful-restart helper to disable FSPF GR helper.

Syntax

fspf graceful-restart helper

undo fspf graceful-restart helper

Default

FSPF GR helper is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The switch can assist the GR restarter in completing the GR process only after it is enabled with FSPF GR helper.

Examples

# Enable FSPF GR helper.

<Sysname> system-view

[Sysname] fspf graceful-restart helper

Related commands

display fspf graceful-restart

fspf graceful-restart

fspf graceful-restart interval

Use fspf graceful-restart interval to set the maximum FSPF GR interval.

Use undo fspf graceful-restart interval to restore the default.

Syntax

fspf graceful-restart interval interval

undo fspf graceful-restart interval

Default

The maximum FSPF GR interval is 120 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the maximum FSPF GR interval in the range of 40 to 1800 seconds.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

If the GR restarter fails to complete the GR process within the maximum FSPF GR interval, it immediately exits the GR process.

Examples

# Set the maximum FSPF GR interval to 100 seconds.

<Sysname> system-view

[Sysname] fspf graceful-restart interval 100

Related commands

display fspf graceful-restart

fspf hello-interval

Use fspf hello-interval to set the hello interval for an interface in a VSAN.

Use undo fspf hello-interval to delete the hello interval setting of an interface in a VSAN.

Syntax

fspf hello-interval interval vsan vsan-id

undo fspf hello-interval vsan vsan-id

Default

The hello interval for an interface in a VSAN is 20 seconds.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

interval: Specifies the hello interval in the range of 1 to 65534 seconds.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The hello interval specifies the time between the hello packets sent periodically by the switch to discover and maintain neighbor relationships.

The hello interval must be smaller than the dead interval and must be the same at the two ends of the link.

Examples

# Set the hello interval to 10 seconds for FC 1/1/1 in VSAN 4.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fspf hello-interval 10 vsan 4

Related commands

fspf dead-interval

fspf min-ls-arrival

Use fspf min-ls-arrival to set the minimum LSR arrival interval for a VSAN.

Use undo fspf min-ls-arrival to restore the default.

Syntax

fspf min-ls-arrival value

undo fspf min-ls-arrival

Default

The minimum LSR arrival interval for a VSAN is 1 second.

Views

VSAN view

Predefined user roles

network-admin

Parameters

value: Specifies the minimum LSR arrival interval in the range of 0 to 60 seconds.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

The minimum LSR arrival interval specifies the interval between received LSR updates in a VSAN. Any LSR updates that arrive before this interval expires are dropped. This helps avoid frequent SPF calculations caused by LSDB updating.

Examples

# Set the minimum LSR arrival interval to 10 seconds for VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] fspf min-ls-arrival 10

fspf min-ls-interval

Use fspf min-ls-interval to set the minimum LSR refresh interval for a VSAN.

Use undo fspf min-ls-interval to restore the default.

Syntax

fspf min-ls-interval interval

undo fspf min-ls-interval

Default

The minimum LSR refresh interval is 5 seconds for a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

interval: Specifies the minimum LSR refresh interval in the range of 1 to 60 seconds.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

The minimum LSR refresh interval specifies the interval at which LSRs are refreshed. To reduce SPF calculations and LSR flooding in a fabric caused by frequent LSR refreshing, the switch will not refresh local LSRs within this interval.

Examples

# Set the minimum LSR refresh interval to 10 seconds for VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] fspf min-ls-interval 10

fspf retransmit-interval

Use fspf retransmit-interval to set the LSR retransmission interval for an interface in a VSAN.

Use undo fspf retransmit-interval to delete the LSR retransmission interval setting of an interface in a VSAN.

Syntax

fspf retransmit-interval interval vsan vsan-id

undo fspf retransmit-interval vsan vsan-id

Default

The LSR retransmission interval for an interface in a VSAN is 5 seconds.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

interval: Specifies the LSR retransmission interval in the range of 1 to 65535 seconds.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The LSR retransmission interval specifies the time to wait for an LSR acknowledgment from the neighbor before retransmitting the LSR.

Examples

# Set the LSR retransmission interval to 10 seconds for FC 1/1/1 in VSAN 4.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fspf retransmit-interval 10 vsan 4

fspf silent

Use fspf silent to disable FSPF for an interface in a VSAN.

Use undo fspf silent to enable FSPF for an interface in a VSAN.

Syntax

fspf silent vsan vsan-id

undo fspf silent vsan vsan-id

Default

FSPF is enabled for all interfaces in a VSAN.

Views

FC interface view

FC aggregate interface view

Predefined user roles

network-admin

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

With FSPF enabled, an interface can participate in the SPF calculation. To avoid SPF calculations on an interface, disable FSPF on the interface.

Examples

# Disable FSPF for FC 1/1/1 in VSAN 4.

<Sysname> system-view

[Sysname] interface fc 1/1/1

[Sysname-Fc1/1/1] fspf silent vsan 4

fspf spf-hold-time

Use fspf spf-hold-time to set the shortest SPF calculation interval for a VSAN.

Use undo fspf spf-hold-time to restore the default.

Syntax

fspf spf-hold-time value

undo fspf spf-hold-time

Default

The shortest SPF calculation interval is 0 seconds in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

value: Specifies the shortest SPF calculation interval in the range of 0 to 60 seconds.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

When the LSDB changes, SPF calculations occur, which consume CPU resources. To prevent frequent SPF calculations from consuming too many CPU resources, you can set the shortest SPF calculation interval.

The shortest SPF calculation interval defines the minimum interval between two consecutive SPF calculations. Setting a small value means that FSPF responds quickly to fabric changes by recalculating routes in a VSAN. A small value consumes more CPU resources.

Examples

# Set the shortest SPF calculation interval to 10 seconds for VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] fspf spf-hold-time 10

reset fspf counters

Use reset fspf counters to clear FSPF statistics.

Syntax

reset fspf counters [ vsan vsan-id ]

Views

User view

Predefined user roles

network-admin

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command clears the FSPF statistics for all VSANs. On an FCF-NPV switch, this command clears the FSPF statistics for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Clear FSPF statistics in VSAN 2.

<Sysname> reset fspf counters vsan 2

Related commands

display fspf statistics

FC zone commands

delete zone database all

Use delete zone database all to delete zone database information.

Syntax

delete zone database all

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

This command deletes all zone sets, zones, and zone aliases in the zone database, but not the active zone set.

This command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you execute it on a live network.

Examples

# Delete zone database information for VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] delete zone database all

This operation will delete all information of the zone database except active zone set. Continue? [Y/N]:y

display zone

Use display zone to display zone information.

Syntax

display zone [ [ name zone-name ] vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

name zone-name: Specifies a zone by its name, a case-sensitive string of 1 to 64 characters. The name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Table 31 Special symbols

Name	Symbol
Caret	^
Dollar sign	$
Minus sign	-
Underscore	_

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. On an FCF-NPV switch, this command displays the zone information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

If you specify both a zone and a VSAN, this command displays information about the specified zone in the specified VSAN.

If you specify only a VSAN, this command displays information about all zones in the specified VSAN.

If you do not specify a zone or a VSAN, this command displays information about all zones in all VSANs.

Examples

# Display information about all zones in all VSANs.

<Sysname> display zone

VSAN 1:

zone name z1

fcid 0x111111 initiator

fcid 0x222222 target

pwwn 11:11:11:11:22:22:22:22

fwwn 02:0e:30:30:33:33:32:35

zone name z2

fcid 0x111111

zone-alias name za1

fcid 0x333333 initiator

Table 32 Command output

Field	Description
fcid	FC address of the zone member.
pwwn	pWWN of the zone member.
fwwn	fWWN of the zone member.
initiator target	Role of a zone member. If no role is indicated, the member has both roles.

Related commands

member (zone view)

zone clone

zone name

zone rename

display zone member

Use display zone member to display parent information for a zone member.

Syntax

display zone member { fcid fcid | fwwn fwwn | pwwn pwwn | zone-alias zone-alias-name } [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

fcid fcid: Specifies a zone member by its FC address, in the format of xxxxxx, where x is a hexadecimal number.

fwwn fwwn: Specifies a zone member by its fWWN, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

pwwn pwwn: Specifies a zone member by its pWWN, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

zone-alias zone-alias-name: Specifies a zone alias name, a case-sensitive string of 1 to 64 characters. A zone alias name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays parent information for zone members in all VSANs. On an FCF-NPV switch, this command displays the parent information for zone members for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

You can use this command to display parent information for a zone member specified by its FC address, pWWN, fWWN, or zone alias.

Parent information contains the following:

· Zones and zone aliases to which the specified zone member belongs.

· Zones to which the zone aliases belong.

· VSANs to which the zones and zone aliases belong.

If a zone alias is not assigned to any zones, only the parent VSANs are displayed for the zone alias.

Examples

# Display parent information for zone member with FC address 010000 in VSAN 1.

<Sysname> display zone member fcid 010000 vsan 1

fcid 0x010000

VSAN 1:

zone z1

zone z2

zone z3

zone-alias a1

zone z2

zone z3

# Display parent information for zone member with pWWN 11:22:33:44:55:66:77:88 in all VSANs.

<Sysname> display zone member pwwn 11:22:33:44:55:66:77:88

pwwn 11:22:33:44:55:66:77:88

VSAN 1:

zone z1

zone z2

zone z3

zone-alias a1

zone z2

zone z3

VSAN 3:

zone z1

# Display parent information for zone member with fWWN 12:22:33:44:55:66:77:88 in all VSANs.

<Sysname> display zone member fwwn 12:22:33:44:55:66:77:88

fwwn 12:22:33:44:55:66:77:88

VSAN 1:

zone z1

zone z2

zone z3

zone-alias a1

zone z2

zone z3

VSAN 3:

zone z1

# Display parent information for the zone alias za1 in VSAN 1.

<Sysname> display zone member zone-alias za1 vsan 1

zone-alias za1

VSAN 1:

zone z1

zone z2

Table 33 Command output

Field	Description
fcid	FC address of the zone member for which parent information is displayed.
pwwn	pWWN of the zone member for which parent information is displayed.
fwwn	fWWN of the zone member for which parent information is displayed.

Related commands

member (zone view)

member (zone alias view)

display zone statistics

Use display zone statistics to display zoning packet statistics.

Syntax

display zone statistics [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays zoning packet statistics for all VSANs. On an FCF-NPV switch, this command displays the zoning packet statistics for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display zoning packet statistics in VSAN 2.

<Sysname> display zone statistics vsan 2

VSAN 2:

Message type Sent Received

Merge Request 19 23

Merge Accept 17 18

Merge Reject 6 1

Change Request 144 18

Change Accept 0 0

Change Reject 0 0

Table 34 Command output

Field	Description
Merge Request	Number of Merge Request packets.
Merge Accept	Number of Merge Accept packets.
Merge Reject	Number of Merge Reject packets.
Change Request	Number of Distribution Request packets.
Change Accept	Number of Distribution Accept packets.
Change Reject	Number of Distribution Reject packets.

Related commands

reset zone statistics

display zone status

Use display zone status to display the zoning configuration and status.

Syntax

display zone status [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the zoning configuration and status for all VSANs. On an FCF-NPV switch, this command displays the zoning configuration and status for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The zoning configuration and status include the following:

· Zoning mode.

· Default zone policy.

· Distribution and merge type (not displayed in enhanced zoning mode).

· Zone database information (numbers of existing zone sets, zones, and zone aliases).

· Zoning status.

Examples

# Display the zoning configuration and status in all VSANs.

<Sysname> display zone status

VSAN 1:

Mode: basic

Default zone: deny

Distribute: active only

Hard-zoning: enabled

Full zoning database:

Zonesets: 10, Zones: 20, Zone-aliases: 0

Status: merging

VSAN 2:

Mode: enhanced

Default zone: permit

Hard-zoning: enabled

Full zoning database:

Zonesets: 10, Zones: 20, Zone-aliases: 0

Status: distributing

Table 35 Command output

Field	Description
Mode	Zoning mode: basic or enhanced.
Default zone	Default zone policy: · deny—Deny members in the default zone from accessing each other. · permit—Allow members in the default zone to access each other.
Distribute	Distribution and merge type: · active only—Incomplete distribution and merge. · full—Complete distribution and merge. In enhanced zoning mode, zone distribution and merge are not affected by the distribution and merge type. The distribution and merge type is not displayed for the enhanced zoning mode.
Hard-zoning	Hard zoning status: · enabled—Hard zoning is in effect. · disabled (Administratively)—Hard zoning is not in effect because it is manually disabled. · disabled (No enough hardware resource)—Hard zoning is not in effect because hardware resources are insufficient.
Full Zoning Database	Zone database information, including the numbers of zone sets, zones, and zone aliases in a VSAN.
Status	Zoning status: · merging—A zone merge is in progress. · distributing—A zone distribution is in progress. · Free—Neither zone merge nor zone distribution is in progress. In the merging or distributing state, zoning configuration is not allowed in the VSAN.

Related commands

zone default-zone permit

zoneset distribute full

display zone-alias

Use display zone-alias to display zone alias information.

Syntax

display zone-alias [ [ name zone-alias-name ] vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

name zone-alias-name: Specifies a zone alias by its name, a case-sensitive string of 1 to 64 characters. The name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. On an FCF-NPV switch, this command displays the zone alias information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

If you specify both a zone alias and a VSAN, this command displays information about the specified zone alias in the specified VSAN.

If you specify only a VSAN, this command displays information about all zone aliases in the specified VSAN.

If you do not specify a zone alias or a VSAN, this command displays information about all zone aliases in all VSANs.

Examples

# Display information about all zone aliases in all VSANs.

<Sysname> display zone-alias

VSAN 1:

zone-alias name za1

fcid 0x111111 initiator

fcid 0x222222 target

pwwn 11:11:11:11:22:22:22:22

zone-alias name za2

fcid 0x111111

fwwn 12:11:11:11:22:22:22:22

VSAN 2:

zone-alias name za1

Table 36 Command output

Field	Description
fcid	FC address of a zone member.
pwwn	pWWN of a zone member.
fwwn	fWWN of a zone member.
initiator target	Role of a zone member. If no role is indicated, the member has both roles.

Related commands

member (zone alias view)

zone-alias clone

zone-alias name

zone-alias rename

display zoneset

Use display zoneset to display zone set information.

Syntax

display zoneset [ [ name zoneset-name ] vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

name zoneset-name: Specifies a zone set by its name, a case-sensitive string of 1 to 64 characters. The name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. On an FCF-NPV switch, this command displays the zone information for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

If you specify both a zone set and a VSAN, this command displays information about the specified zone set in the specified VSAN.

If you specify only a VSAN, this command displays information about all zone sets in the specified VSAN.

If you do not specify a zone set or a VSAN, this command displays information about all zone sets in all VSANs.

Examples

# Display information about all zone sets in all VSANs.

<Sysname> display zoneset

VSAN 1:

zoneset name zs1

zone name z1

fcid 0x111111

fcid 0x222222

pwwn 11:11:11:11:22:22:22:22

zone name z2

fcid 0x111111

zone-alias name za1

fcid 0x111112

zoneset name zs2

zone name z1

VSAN 2:

VSAN 3:

zoneset name zs1

zone name z1

Table 37 Command output

Field	Description
fcid	FC address of a zone member.
pwwn	pWWN of a zone member.

Related commands

member (zone set view)

zoneset clone

zoneset name

zoneset rename

display zoneset active

Use display zoneset active to display information about the active zone set.

Syntax

display zoneset active [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays information about active zone sets for all VSANs. On an FCF-NPV switch, this command displays information about active zone sets for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

A VSAN can have only one active zone set.

The following rules apply to the command output:

· Zone members are displayed in the order of FC address, pWWN, and fWWN. Zone members specified by the same identifier are displayed in ascending order of ASCII codes corresponding to the identifier values.

· For a zone member that exists in the local name service database, this command prefixes an asterisk (*) to the related line.

¡ If a zone member is specified by its pWWN, the switch performs the following operations:

- Queries the associated FC address of the zone member from the name service database and displays the FC address.

- Appends the pWWN enclosed in brackets ([]) to the FC address.

¡ If a zone member is specified by its fWWN, the switch displays FC addresses of all N_Ports that log in through the F_Port. Each FC address is followed by the fWWN enclosed in brackets ([]).

· For a zone member that does not exist in the local name service database, only the configuration content is displayed.

· Zone members cannot be displayed by zone alias in the active zone set. If a zone in the activated zone set has members with a zone alias, the non-overlapping N_Port members in the zone alias are added to the zone.

· If members of the default zone are allowed to access each other, this command displays valid members in the default zone by FC address. Valid members in the default zone are members that have registered with the name service database and are not part of the active zone set.

Examples

# Display information about the active zone sets in all VSANs.

<Sysname> display zoneset active

VSAN 1:

zoneset name zs1

zone name z1

*fcid 0x222222

*fcid 0x111111 [pwwn 20:00:00:05:30:00:25:a3]

zone name z2

fcid 0x123456

*fcid 0x111111 [pwwn 20:00:00:05:30:00:25:a3]

pwwn 20:00:00:05:30:00:25:a4

*fcid 0x333333 [pwwn 38:00:00:11:22:00:01:01]

zone name #default-zone#

*fcid 0x20abcd

*fcid 0xabcdef

zone name pz1

type: peer-zoning

*fcid 0x0a000c [pwwn 22:00:06:18:3a:73:ba:73] [principal]

*fcid 0x0b0001 [pwwn 21:00:03:41:ab:24:f3:00]

*fcid 0x010000

*fcid 0x690001 [fwwn 28:00:0e:28:3f:79:1a:20]

zone name pz2

type: peer-zoning

*fcid 0x0a0001 [pwwn 22:00:06:18:3a:1f:00:29] [principal]

*fcid 0x020012

VSAN 2:

VSAN 3:

zoneset name zs1

zone name z1

fcid 0x123456

*fcid 0x111111 [pwwn 20:00:00:05:30:00:25:a3]

pwwn 20:00:00:05:30:00:25:a4

*fcid 0x333333 [pwwn 38:00:00:11:22:00:01:01]

*fcid 0x222221 [fwwn 02:0e:30:30:33:33:32:35]

*fcid 0x222222 [fwwn 02:0e:30:30:33:33:32:35]

*fcid 0x222223 [fwwn 02:0e:30:30:33:33:32:35]

fwwn aa:bb:cc:dd:ee:ff:00:11

# Display information about the active zone set in VSAN 1.

<Sysname> display zoneset active vsan 1

VSAN 1:

zoneset name zs1

zone name z1

*fcid 0x222222

*fcid 0x111111 [pwwn 20:00:00:05:30:00:25:a3]

zone name z2

fcid 0x123456

*fcid 0x111111 [pwwn 20:00:00:05:30:00:25:a3]

pwwn 20:00:00:05:30:00:25:a4

*fcid 0x333333 [pwwn 38:00:00:11:22:00:01:01]

zone name #default_zone#

*fcid 0x20abcd

*fcid 0xabcdef

zone name pz1

type: peer-zoning

*fcid 0x0a000c [pwwn 22:00:06:18:3a:73:ba:73] [principal]

*fcid 0x0b0001 [pwwn 21:00:03:41:ab:24:f3:00]

*fcid 0x010000

*fcid 0x690001 [fwwn 28:00:0e:28:3f:79:1a:20]

zone name pz2

type: peer-zoning

*fcid 0x0a0001 [pwwn 22:00:06:18:3a:1f:00:29] [principal]

*fcid 0x020012

Table 38 Command output

Field	Description
type	Zoning type. Only peer zones support this field. This field displays peer-zoning for peer zones.
principal	Principal member in a peer zone. All other members are peer members.
*fcid	FC address of a zone member that exists in the local name service database.
fcid	FC address of a zone member that does not exist in the local name service database.
pwwn	pWWN of a zone member.
fwwn	fWWN of a zone member.

Related commands

zoneset activate name

member (zone alias view)

Use member to add a member to a zone alias.

Use undo member to delete a member from a zone alias.

Syntax

member { fcid fcid | fwwn fwwn | pwwn pwwn } [ initiator | target ]

undo member { fcid fcid | fwwn fwwn | pwwn pwwn }

Default

No members exist in a zone alias.

Views

Zone alias view

Predefined user roles

network-admin

Parameters

fcid fcid: Specifies a member by its FC address, in the format of xxxxxx, where x is a hexadecimal number.

fwwn fwwn: Specifies a member F_Port by its fWWN, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number. Adding an F_Port to a zone alias adds all N_Ports that log in through the F_Port to that zone alias.

pwwn pwwn: Specifies a member by its pWWN, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

initiator: Specifies a member as an initiator. If you do not specify the initiator or target keyword, the member acts as both an initiator and a target.

target: Specifies a member as a target. If you do not specify the initiator or target keyword, the member acts as both an initiator and a target.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

The role of a member can be configured only in enhanced zoning mode and takes effect only when the Pairwise feature is enabled.

You can also use this command to change the role of a member.

If the role of a member is specified by using the same identifier (FC address, pWWN, fWWN, or zone alias) multiple times, the role of the member is the role most recently specified.

If the role of a member is specified by using different identifiers multiple times, the role of the member is the union of the specified roles. For example, if a member is specified as an initiator by using its FC address and specified as a target by using its pWWN, the member acts as both an initiator and a target.

Examples

# Create a zone alias named za1 and enter its view.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone-alias name za1

[Sysname-vsan1-zone-alias-za1]

# Add an N_Port with FC address 010000 to zone alias za1 as an initiator.

[Sysname-vsan1-zone-alias-za1] member fcid 010000 initiator

# Add an N_Port with pWWN 01:02:03:04:05:06:07:08 to zone alias za1 as a target.

[Sysname-vsan1-zone-alias-za1] member pwwn 01:02:03:04:05:06:07:08 target

# Add an F_Port with fWWN 08:07:06:05:04:03:02:01 to zone alias za1 as both an initiator and a target.

[Sysname-vsan2-zone-alias-za1] member fwwn 08:07:06:05:04:03:02:01

Related commands

display zone-alias

pairwise-zoning enable

zone-alias name

member (zone set view)

Use member to add a zone to a zone set.

Use undo member to remove a zone from a zone set.

Syntax

member zone-name

undo member zone-name

Default

No zones exist in a zone set.

Views

Zone set view

Predefined user roles

network-admin

Parameters

zone-name: Specifies an existing zone by its name, a case-sensitive string of 1 to 64 characters. The name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone named z1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone name z1

[Sysname-vsan1-zone-z1] quit

# Create a zone set named zs1 and enter its view.

[Sysname-vsan1] zoneset name zs1

[Sysname-vsan1-zoneset-zs1]

# Add zone z1 to zone set zs1.

[Sysname-vsan1-zoneset-zs1] member z1

Related commands

display zoneset

zone name

zoneset name

member (zone view)

Use member to add a member to a zone.

Use undo member to delete a member from a zone.

Syntax

member { { fcid fcid | fwwn fwwn | pwwn pwwn } [ initiator | target ] | zone-alias zone-alias-name }

undo member { fcid fcid | fwwn fwwn | pwwn pwwn | zone-alias zone-alias-name }

Default

No members exist in a user-created zone.

Views

Zone view

Predefined user roles

network-admin

Parameters

fcid fcid: Specifies a member by its FC address, in the format of xxxxxx, where x is a hexadecimal number.

fwwn fwwn: Specifies a member F_Port by its fWWN, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number. Adding an F_Port to a zone adds all N_Ports that log in through the F_Port to that zone.

pwwn pwwn: Specifies a member by its pWWN, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

initiator: Specifies a member as an initiator. If you do not specify the initiator or target keyword, the member acts as both an initiator and a target.

target: Specifies a member as a target. If you do not specify the initiator or target keyword, the member acts as both an initiator and a target.

zone-alias zone-alias-name: Specifies an existing zone alias by its name, a case-sensitive string of 1 to 64 characters. The name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

The role of a member can be configured only in enhanced zoning mode and takes effect only when the Pairwise feature is enabled.

You can also use this command to change the role (initiator, target, or both) of a member.

You cannot use the undo member command to delete the primary member of a peer zone.

As a best practice, add one server HBA and one storage HBA to a zone. If a zone has one server HBA and multiple storage HBAs, you must enable the Pairwise feature for the zone.

If the role of a member is specified by using the same identifier (FC address, pWWN, fWWN, or zone alias) multiple times, the role of the member is the role most recently specified.

Examples

# Create a zone named z1 and enter its view.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone name z1

[Sysname-vsan1-zone-z1]

# Add an N_Port with FC address 010000 to zone z1 as an initiator.

[Sysname-vsan1-zone-z1] member fcid 010000 initiator

# Add an N_Port with pWWN 01:02:03:04:05:06:07:08 to zone z1 as a target.

[Sysname-vsan1-zone-z1] member pwwn 01:02:03:04:05:06:07:08 target

# Change the role of N_Port with pWWN 01:02:03:04:05:06:07:08 back to both initiator and target.

[Sysname-vsan1-zone-z1] member pwwn 01:02:03:04:05:06:07:08

# Add an F_Port with fWWN 08:07:06:05:04:03:02:01 to zone z1 as both an initiator and a target.

[Sysname-vsan2-zone-z1] member fwwn 08:07:06:05:04:03:02:01

# Add zone alias za1 (existing) to zone z1.

[Sysname-vsan1-zone-z1] member zone-alias za1

Related commands

display zone

display zone member

pairwise-zoning enable

zone name

zone-alias name

pairwise-zoning enable

Use pairwise-zoning enable to enable the Pairwise feature for a zone.

Use undo pairwise-zoning enable to disable the Pairwise feature for a zone.

Syntax

pairwise-zoning enable

undo pairwise-zoning enable

Default

The Pairwise feature is disabled for a zone.

Views

Zone view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

This command can be configured only in enhanced zoning mode.

The Pairwise feature runs on a per-zone basis. For the Pairwise feature to take effect, you must reactivate the active zone set after enabling the Pairwise feature.

The following roles are defined for zone members:

· Initiator—Typically a server.

· Target—Typically a storage device.

You can specify the role of a member as an initiator, a target, or both when adding the member. A member can have different roles in different zones.

When the Pairwise feature is disabled for a zone, member roles do not take effect in that zone.

When the Pairwise feature is enabled for a zone:

· An initiator member can access target members.

· A target member can access initiator members.

· A member acting as both an initiator and a target can access both target members and initiator members.

The Pairwise feature status is distributed to the entire fabric when you configure the zoneset activate or zoneset distribute command.

Examples

# Enable the Pairwise feature for zone z1.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] zone name z1

[Sysname-vsan2-zone-z1] pairwise-zoning enable

Related commands

member (zone view)

member (zone alias view)

zoneset activate

zoneset distribute

reset zone statistics

Use reset zone statistics to clear zoning packet statistics.

Syntax

reset zone statistics [ vsan vsan-id ]

Views

User view

Predefined user roles

network-admin

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command clears zoning packet statistics for all VSANs.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Clear zoning packet statistics for VSAN 2.

<Sysname> reset zone statistics vsan 2

Related commands

display zone statistics

snmp-agent trap enable fc-zone

Use snmp-agent trap enable fc-zone to enable SNMP notifications for the zoning module.

Use undo snmp-agent trap enable fc-zone to disable SNMP notifications for the zoning module.

Syntax

snmp-agent trap enable fc-zone [ activation-completed | defaultzone-change | hardzone-change | merge-failed | merge-succeeded ] *

undo snmp-agent trap enable fc-zone [ activation-completed | defaultzone-change | hardzone-change | merge-failed | merge-succeeded ] *

Default

All SNMP notifications for the zoning module are disabled.

Views

System view

Predefined user roles

network-admin

Parameters

activation-completed: Specifies notifications about zone set activation or deactivation.

defaultzone-change: Specifies notifications about default zone policy changes.

hardzone-change: Specifies notifications about hard zoning status changes.

merge-failed: Specifies notifications about for merge failures.

merge-succeeded: Specifies notifications about for merge successes.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

To report critical zoning events to an NMS, enable SNMP notifications for the zoning module. For zoning event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

If you do not specify a notification, this command enables all SNMP notifications for the zoning module.

Examples

# Enable all SNMP notifications for the zoning module.

<Sysname> system-view

[Sysname] snmp-agent trap enable fc-zone

zone clone

Use zone clone to copy a zone.

Syntax

zone clone src-name dest-name

Views

VSAN view

Predefined user roles

network-admin

Parameters

src-name: Specifies the name of the source zone to be copied, a case-sensitive string of 1 to 64 characters. A source zone name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

dest-name: Specifies the name of the destination zone, a case-sensitive string of 1 to 64 characters. A destination zone name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone named z1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone name z1

[Sysname-vsan1-zone-z1] quit

# Create a zone named z2 by copying z1.

[Sysname-vsan1] zone clone z1 z2

Related commands

display zone

zone name

zone default-zone permit

Use zone default-zone permit to allow members in the default zone to access each other.

Use undo zone default-zone permit to restore the default.

Syntax

zone default-zone permit

undo zone default-zone permit

Default

Members in the default zone cannot access each other.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

In enhanced zoning mode, the switch distributes the default zone policy with other zone data during a distribution process. In basic zoning mode, you must manually configure a consistent default zone policy across the fabric.

When the switch performs a zoning mode switchover, it also distributes the default zone policy with other zone data.

In enhanced zoning mode, a zone merge requires that the default zone policy is the same on all participating switches. Otherwise, the merge fails, and the links between the switches are isolated.

Examples

# Allow members in the default zone to access each other.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone default-zone permit

Related commands

display zone status

zone mode enhanced

zoneset activate

zoneset distribute

zone hard-zoning enable

Use zone hard-zoning enable to enable hard zoning in a VSAN.

Use undo zone hard-zoning enable to disable hard zoning in a VSAN.

Syntax

zone hard-zoning enable

undo zone hard-zoning enable

Default

Hard zoning is enabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Soft zoning is always in effect. Hard zoning takes effect only when the hardware resources are sufficient for deploying zone rules of the current VSAN. When the hardware resources are insufficient, the system performs the following operations:

· Clears all deployed hardware zone rules to keep the integrity of rules.

· Automatically disables hard zoning.

To improve the security for a VSAN, you can enable hard zoning for the VSAN. After hard zoning is enabled for a VSAN, the system begins to deploy all zone rules of the VSAN.

When soft zoning can meet the access control requirements of a VSAN, you can disable hard zoning for the VSAN to save the hardware resources. After hard zoning is disabled for a VSAN, the system clears the hardware zone rules already deployed for the VSAN and stops deploying new zone rules.

In enhanced zoning mode, the switch distributes hard zoning status with other zone data. In basic zoning mode, you must manually configure hard zoning to ensure consistency across the fabric.

To view the hard zoning status, use the display zone status command.

Do not configure this command when the switch is merging or distributing zones.

Examples

# Disable hard zoning for VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] undo zone hard-zoning enable

Related commands

display zone status

zone merge-control restrict

Use zone merge-control restrict to set the merge control mode to Restrict.

Use undo zone merge-control restrict to restore the default.

Syntax

zone merge-control restrict

undo zone merge-control restrict

Default

The merge control mode is Allow.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

This command is supported only in enhanced zoning mode.

Two merge control modes are available: Restrict and Allow. For more information about the Restrict and Allow merge control modes, see FC Configuration Guide.

In enhanced zoning mode, the merge control mode affects the result of a merge operation. A merge operation can succeed only when the merge control mode is the same on both participating switches. If the merge operation fails, the link connecting the participating switches is isolated.

To ensure a consistent merge control mode across the fabric, use the zone activate or zone distribute command after you configure this command.

Examples

# Set the merge control mode to Restrict for VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] zone merge-control restrict

# Set the merge control mode to Allow for VSAN 2.

[Sysname-vsan2] undo zone merge-control restrict

Related commands

zone mode enhanced

zoneset activate

zoneset distribute

zone mode enhanced

Use zone mode enhanced to enable the enhanced zoning mode in a VSAN.

Use undo zone mode enhanced to restore the default.

Syntax

zone mode enhanced

undo zone mode enhanced

Default

The basic zoning mode is enabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

A zoning mode switchover causes a zone distribution to ensure zoning mode consistency across the fabric. You can switch from basic zoning to enhanced zoning only if the following conditions are met:

· All switches in the fabric support the enhanced zoning mode.

· No invalid static routes exist in the fabric.

After enhanced zoning is enabled on a switch, the switch checks ESS negotiation results for enhanced zoning support on other switches.

The switch performs ESS negotiation with all switches that appear in its routing table as destinations, including unreachable destinations in invalid static routes. The switch assumes that unreachable destinations do not support enhanced zoning.

After you change the zoning mode, the switch distributes the change to the entire fabric. If the distribution fails, the system prints a log message, and the change takes effect only on the local switch. In this case, to ensure zoning mode consistency across the fabric, manually trigger a complete distribution.

For a switchover from enhanced zoning to basic zoning, if the size of the active zone set exceeds the system limit in basic zoning mode, the switchover fails.

Examples

# Enable the enhanced zoning mode in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] zone mode enhanced

The zoning database in this switch would be distributed throughout the fabric. Continue? [Y/N]:y

Related commands

display zone status

zoneset distribute

zone name

Use zone name to create a zone and enter its view, or enter the view of an existing zone.

Use undo zone name to delete a zone.

Syntax

zone name zone-name

undo zone name zone-name

Default

No zones exist.

Views

VSAN view

Predefined user roles

network-admin

Parameters

zone-name: Specifies a zone name, a case-sensitive string of 1 to 64 characters. A zone name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone named z1 and enter its view.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone name z1

[Sysname-vsan1-zone-z1]

Related commands

display zone

zone rename

Use zone rename to rename a zone.

Syntax

zone rename old-name new-name

Views

VSAN view

Predefined user roles

network-admin

Parameters

old-name: Specifies the name of the zone to be renamed, a case-sensitive string of 1 to 64 characters. This name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

new-name: Specifies the new zone name, a case-sensitive string of 1 to 64 characters. This name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

After renaming a peer zone on the switch, you must modify the peer zone name on nodes to the same name.

Examples

# Create a zone named z1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone name z1

[Sysname-vsan1-zone-z1] quit

# Rename zone z1 as z2.

[Sysname-vsan1] zone rename z1 z2

The command will cause inconsistency of peer zone information between the switch and nodes. Continue? [Y/N]:y

Related commands

display zone

zone name

zone-alias clone

Use zone-alias clone to copy a zone alias.

Syntax

zone-alias clone src-name dest-name

Views

VSAN view

Predefined user roles

network-admin

Parameters

src-name: Specifies the name of the source zone alias to be copied, a case-sensitive string of 1 to 64 characters. A source zone alias name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

dest-name: Specifies the name of the destination zone alias, a case-sensitive string of 1 to 64 characters. A destination zone alias name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone alias named za1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone-alias name za1

[Sysname-vsan1-zone-alias-za1] quit

# Create a zone alias named za2 by copying zone alias za1.

[Sysname-vsan1] zone-alias clone za1 za2

Related commands

display zone-alias

zone-alias name

Use zone-alias name to create a zone alias and enter its view, or enter the view of an existing zone alias.

Use undo zone-alias name to delete a zone alias.

Syntax

zone-alias name zone-alias-name

undo zone-alias name zone-alias-name

Default

No zone aliases exist.

Views

VSAN view

Predefined user roles

network-admin

Parameters

zone-alias-name: Specifies the zone alias name, a case-sensitive string of 1 to 64 characters. A zone alias name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone alias named za1 and enter its view.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone-alias name za1

[Sysname-vsan1-zone-alias-za1]

Related commands

display zone-alias

zone-alias rename

Use zone-alias rename to rename a zone alias.

Syntax

zone-alias rename old-name new-name

Views

VSAN view

Predefined user roles

network-admin

Parameters

old-name: Specifies the name of the zone alias to be renamed, a case-sensitive string of 1 to 64 characters. This name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

new-name: Specifies the new zone alias name, a case-sensitive string of 1 to 64 characters. This name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone alias named za1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone-alias name za1

[Sysname-vsan1-zone-alias-za1] quit

# Rename zone alias za1 as za2.

[Sysname-vsan1] zone-alias rename za1 za2

Related commands

display zone-alias

zone-alias name

zoneset activate

Use zoneset activate to activate a zone set and distribute it to the entire fabric.

Use undo zoneset activate to delete an active zone set and distribute the deletion to the entire fabric.

Syntax

zoneset activate name zoneset-name

undo zoneset activate

Views

VSAN view

Predefined user roles

network-admin

Parameters

name zoneset-name: Specifies the zone set to be activated by its name, a case-sensitive string of 1 to 64 characters. This name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Each VSAN can have multiple zone sets. However, only one zone set can be active at a time. It is called the active zone set. The active zone set must contain at least one N_Port member and determines access control over N_Ports.

The system prints a log message if the distribution fails because of a network fault. To ensure a consistent active zone set across the fabric, reactivate the zone set after the network fault is fixed.

The distribution type specified by using the zoneset distribute full command applies to distribution operations triggered by the zoneset activate command.

In basic zoning mode, if the size of the zone set to be activated exceeds the system limit, the activation fails.

Examples

# Create a zone named z1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zone name z1

# Add an N_Port with FC address 010000 to zone z1.

[Sysname-vsan1-zone-z1] member fcid 010000

[Sysname-vsan1-zone-z1] quit

# Create a zone set named zs1.

[Sysname-vsan1] zoneset name zs1

# Add zone z1 to zone set zs1.

[Sysname-vsan1-zoneset-zs1] member z1

[Sysname-vsan1-zoneset-zs1] quit

# Activate zone set zs1 and distribute it to the entire fabric.

[Sysname-vsan1] zoneset activate name zs1

Related commands

display zoneset active

zoneset distribute full

zoneset clone

Use zoneset clone to create a zone set by copying an existing zone set.

Syntax

zoneset clone src-name dest-name

Views

VSAN view

Predefined user roles

network-admin

Parameters

src-name: Specifies the name of the source zone set to be copied, a case-sensitive string of 1 to 64 characters. A source zone set name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

dest-name: Specifies the name of the destination zone set, a case-sensitive string of 1 to 64 characters. A destination zone set name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone set named zs1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zoneset name zs1

[Sysname-vsan1-zoneset-zs1] quit

# Create a zone set named zs1 by copying zone set zs2.

[Sysname-vsan1] zoneset clone zs1 zs2

Related commands

display zoneset

zoneset name

zoneset distribute

Use zoneset distribute to trigger a one-time complete distribution, distributing both the active zone set and zone database.

Syntax

zoneset distribute

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

After activating a zone set by using the zoneset activate command, you can modify the zone database configuration. The zoneset distribute command distributes the active zone set and the modified zone database to the entire fabric without changing the active zone set.

If the distribution fails, the system prints a log message. To ensure zone data consistency across the fabric, perform a new distribution.

Examples

# Trigger a complete distribution.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zoneset distribute

zoneset distribute full

Use zoneset distribute full to set the zone distribution and merge type to complete.

Use undo zoneset distribute full to restore the default.

Syntax

zoneset distribute full

undo zoneset distribute full

Default

The zone distribution and merge type is incomplete.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

This command can be configured only in basic zoning mode. In enhanced zoning mode, the zone distribution and merge type is always complete, and this command is not supported.

Complete distribution (or merge) distributes (or merges) both the active zone set and zone database. Incomplete distribution (or merge) distributes (or merges) only the active zone set.

The set distribution type applies to distribution operations triggered by the zoneset activate command instead of the zoneset distribute command.

The set merge type applies to all merge operations.

Examples

# Set the zone distribution and merge type to complete.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zoneset distribute full

Related commands

display zone status

zoneset activate

zoneset name

Use zoneset name to create a zone set and enter its view, or enter the view of an existing zone set.

Use undo zoneset name to delete a zone set.

Syntax

zoneset name zoneset-name

undo zoneset name zoneset-name

Default

No zone sets exist.

Views

VSAN view

Predefined user roles

network-admin

Parameters

zoneset-name: Specifies the zone set name, a case-sensitive string of 1 to 64 characters. A zone set name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone set named zs1 and enter its view.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zoneset name zs1

[Sysname-vsan1-zoneset-zs1]

Related commands

display zoneset

zoneset rename

Use zoneset rename to rename a zone set.

Syntax

zoneset rename old-name new-name

Views

VSAN view

Predefined user roles

network-admin

Parameters

old-name: Specifies the name of the zone set to be renamed, a case-sensitive string of 1 to 64 characters. This name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

new-name: Specifies the new zone set name, a case-sensitive string of 1 to 64 characters. This name can contain letters (uppercase and lowercase), numbers, and special symbols (see Table 31). It must start with a letter.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Create a zone set named zs1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] zoneset name zs1

[Sysname-vsan1-zoneset-zs1] quit

# Rename zone set zs1 as zs2.

[Sysname-vsan1] zoneset rename zs1 zs2

Related commands

display zoneset

zoneset name

zone-type peer-zone

Use zone-type peer-zone to convert a common zone to a peer zone and specify the principal member for the peer zone.

Use undo zone-type peer-zone to restore the default.

Syntax

zone-type peer-zone principal-member wwn

undo zone-type peer-zone

Default

A zone is a common zone.

Views

Zone view

Predefined user roles

network-admin

Parameters

wwn: Specifies the principal member by its WWN, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number. The principal member must be a port on a node.

Usage guidelines

Before configuring this command, you must first enable Smart SAN for FC.

A zone enabled with the Pairwise feature cannot be converted to a peer zone.

This command sets the principal member to a target.

This command deletes the settings for the common zone.

Only FCF switches and VSANs operating in FCF mode support this command.

Examples

# Convert a common zone named z1 to a peer zone and specify the port with WWN 20:00:10:00:00:ef:94:00 as the principal member for the peer zone.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] zone name z1

[Sysname-vsan2-zone-z1] zone-type peer-zone principal-member 20:00:10:00:00:ef:94:00

# Convert a peer zone named z1 to a common zone.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] zone name z1

[Sysname-vsan2-zone-z1] undo zone-type peer-zone

Related commands

zone name

member (zone view)

smartsan enable

NPV commands

display fc nport

Use display fc nport to display the login information of interfaces.

Syntax

display fc nport [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. The interface must be an FC interface or FC aggregate interface operating in NP mode. If you do not specify an interface, this command displays the login information of all interfaces.

Usage guidelines

Only NPV and FCF-NPV switches support this command.

This command displays the login information sent by interfaces operating in NP mode to the FCF switch and management addresses obtained from the FCF switch.

This command displays the information only if the NPV switch successfully registers with the FCF switch.

Examples

# Display the login information of interfaces.

<Sysname> display fc nport

NP port: Fc1/1/1

Port-WWN: 20:00:00:41:22:a8:00:05

FC4-types(FC4_features): NPV

Symbolic-node-name: NPV-Sysname

Symbolic-port-name: NPV-Sysname: Fc1/1/1

Node-IP-addr: 192.168.0.153

Peer management address: snmp://192.168.0.151

snmp://192.168.0.152

NP port: Fc1/1/2

Port-WWN: 20:00:00:49:c9:28:c7:01

FC4-types(FC4_features): NPV

Symbolic-node-name: NPV-Sysname

Symbolic-port-name: NPV-Sysname:Fc1/1/2

Node-IP-addr: 192.168.0.153

Peer management address: snmp://192.168.0.151

snmp://192.168.0.152

Table 39 Command output

Field	Description
FC4-types(FC4 features)	An interface operating in NP mode always registers NPV as its FC4 type and has no FC4 feature.
Symbolic-node-name	Symbolic name in the form of system-name, which is used for describing the N_Port connected to the interface.
Symbolic-port-name	Symbolic name in the form of system-name:port-name, which is used for describing the interface.
Node-IP-addr	IP address of the NPV switch.
Peer management address	List of management addresses obtained by the interface from the FCF switch. For example, snmp://192.168.6.151 indicates that SNMP is used as the management protocol and the management address is 192.168.6.151. If nothing is displayed, the FCF switch is not configured with management addresses.

display npv login

Use display npv login to display the nodes on downlink interfaces and their mapped uplink interfaces.

Syntax

display npv login [ vsan vsan-id ] [ interface interface-type interface-number ]

display npv login [ vsan vsan-id ] count

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays information for all VSANs. On an FCF-NPV switch, this command displays the node login information for only VSANs operating in NPV mode.

interface interface-type interface-number: Specifies a downlink interface by its type and number. If you do not specify a downlink interface, this command displays information for all downlink interfaces.

Usage guidelines

Only NPV and FCF-NPV switches support this command.

Examples

# Display the nodes on downlink interfaces and their mapped uplink interfaces.

<Sysname> display npv login

Server External

Interface VSAN FCID Node WWN Port WWN Interface

Fc1/1/2 1 0xae0002 20:00:00:23:89:c9:fc:02 20:00:00:23:89:c9:fc:02 Fc1/1/1

Fc1/1/3 1 0xae0003 10:00:00:00:c9:66:6b:60 20:00:00:00:c9:66:6b:60 Fc1/1/1

# Display the number of logged-in nodes for VSAN 1.

<Sysname> display npv login vsan 1 count

Total entries: 2

# Display the number of logged-in nodes for each VSAN and the total number of logged-in nodes.

<Sysname> display npv login count

VSAN Entries

1 2

2 1

Total entries: 3

Table 40 Command output

Field	Description
Server Interface	Name of the downlink interface.
External interface	Name of the uplink interface mapped by the downlink interface.
FCID	FC address of the node.
Port WWN	Port WWN of the node.
Entries	Number of logged-in nodes for a VSAN.
Total entries	Total number of logged-in nodes.

display npv status

Use display npv status to display the status information of interfaces in VSANs.

Syntax

display npv status [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the status information of interfaces in all VSANs. On an FCF-NPV switch, this command displays the status information of interfaces in only VSANs operating in NPV mode.

Usage guidelines

Only NPV and FCF-NPV switches support this command.

The status information of each interface includes the VSAN tagging mode, interface state, and FC address.

Examples

# Display the status information of interfaces in VSAN 1.

<Sysname> display npv status vsan 1

External Interfaces:

Interface: Fc1/1/2 VSAN tagging mode: Tagging

VSAN State FCID

1 Up 0x010002

Interface: Fc1/1/3 VSAN tagging mode: Tagging

VSAN State FCID

1 Up 0x010001

Number of External Interfaces: 2

Server Interfaces:

Interface: Fc1/1/5 VSAN tagging mode: Tagging

VSAN State

1 Down

Number of Server Interfaces: 1

# Display the status information of interfaces in all VSANs.

<Sysname> display npv status

External Interfaces:

Interface: Fc1/1/1 VSAN tagging mode: Tagging

VSAN State FCID

2 Up 0x010003

Interface: Fc1/1/2 VSAN tagging mode: Tagging

VSAN State FCID

1 Up 0x010002

2 Up 0x010003(Unavailable)

2 Down

Interface: Fc1/1/3 VSAN tagging mode: Tagging

VSAN State FCID

1 Up 0x010001

Number of External Interfaces: 3

Server Interfaces:

Interface: Fc1/1/4 VSAN tagging mode: Tagging

VSAN State

2 Up

Interface: Fc1/1/5 VSAN tagging mode: Tagging

VSAN State

1 Down

2 Up

3 Down

Number of Server Interfaces: 2

Table 41 Command output

Field	Description
External Interfaces	List of uplink interfaces.
Server Interfaces	List of downlink interfaces.
Interface	Interface name.
State	State of the interface: Up or Down.
FCID	After an uplink interface comes up, the FC address allocated by the core switch is displayed. A downlink interface does not have an FC address. One uplink interface can be up but it cannot work as an uplink interface when the following conditions exist: · An NPV switch is connected to two fabrics. · The two uplink interfaces of the NPV switch are assigned the same FC address in a VSAN. In this case, Unavailable in parentheses is displayed after the FCID field. NOTE: Multiple fabrics can exist in an FC SAN. For example, in an FC SAN, if two FCF switches are not interconnected, each FCF switch forms a fabric.

display npv traffic-map

Use display npv traffic-map to display the traffic mapping information (downlink-to-uplink interface mappings).

Syntax

display npv traffic-map [ vsan vsan-id ] [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the traffic mapping information for all VSANs. On an FCF-NPV switch, this command displays the traffic mapping information for only VSANs operating in NPV mode.

interface interface-type interface-number: Specifies a downlink interface by its type and number. If you do not specify a downlink interface, this command displays the traffic mapping information of all downlink interfaces.

Usage guidelines

Only NPV and FCF-NPV switches support this command.

Examples

# Display traffic mapping information.

<Sysname> display npv traffic-map

NPV traffic map information of VSAN 1:

Server interface External interface

Fc1/1/2 Fc1/1/1

Fc1/1/3 Fc1/1/1

Fc1/1/2 Fc1/1/4

npv auto-load-balance enable

Use npv auto-load-balance enable to enable automatic load balancing in a VSAN.

Use undo npv auto-load-balance enable to disable automatic load balancing in a VSAN.

Syntax

npv auto-load-balance enable

undo npv auto-load-balance enable

Default

Automatic load balancing is disabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only NPV switches and VSANs operating in NPV mode support this command.

The automatic load-balancing process is as follows:

1. The system starts a delay timer when it detects a new operational uplink interface.

2. The system automatically redistributes downlink interfaces across all uplink interfaces when the timer expires.

If another uplink interface becomes operational before the timer expires, the system resets the timer.

The automatic load balancing feature might trigger a load-balancing process when a new uplink interface becomes operational, which causes traffic disruption. When this feature is disabled, downlink-to-uplink interface mappings are not affected.

Examples

# Enable automatic load balancing in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] npv auto-load-balance enable

npv auto-load-balance-interval

Use npv auto-load-balance-interval to set the delay timer for automatic load balancing in a VSAN.

Use undo npv auto-load-balance-interval to restore the default.

Syntax

npv auto-load-balance-interval interval

undo npv auto-load-balance-interval

Default

The delay timer is 30 seconds for automatic load balancing in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

interval: Specifies a value for the delay timer, in the range of 1 to 300 seconds.

Usage guidelines

Only NPV switches and VSANs operating in NPV mode support this command.

The delay timer helps reduce network flapping caused by up/down events of uplink interfaces. If the link layer state of uplink interfaces is stable, set the delay timer to a smaller value. Otherwise, set the delay timer to a greater value.

Examples

# Set the delay timer for automatic load balancing to 20 seconds in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] npv auto-load-balance-interval 20

npv load-balance disruptive

Use npv load-balance disruptive to manually initiate a disruptive load-balancing process in a VSAN.

Syntax

npv load-balance disruptive

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only NPV switches and VSANs operating in NPV mode support this command.

If the traffic load is not distributed evenly across the interfaces in a VSAN, you can use this command to manually initiate a disruptive load-balancing process. Then, some of the downlink interfaces mapped to the uplink interfaces that exceed the average uplink interface load are redistributed, and the nodes connected to the redistributed downlink interfaces log in again to the core switch. The average uplink interface load is calculated by using the following formula: total number of downlink interfaces/ total number of uplink interfaces. If the average uplink interface load is not an integer, it is rounded down to the nearest integer.

This feature redistributes downlink traffic across uplink interfaces for better load balancing. However, it causes traffic interruption on the nodes connected to all downlink interfaces.

Examples

# Manually initiate a disruptive load-balancing process in VSAN 1.

<Sysname> system-view

[Sysname] vsan 1

[Sysname-vsan1] npv load-balance disruptive

The command may cause traffic interruption. Continue? [Y/N]:y

npv traffic-map

Use npv traffic-map to configure an uplink-to-downlink interface mapping.

Use undo npv traffic-map to delete an uplink-to-downlink interface mapping.

Syntax

npv traffic-map server-interface interface-type interface-number external-interface interface-type interface-number

undo npv traffic-map server-interface interface-type interface-number external-interface interface-type interface-number

Default

No uplink-to-downlink interface mappings exist.

Views

VSAN view

Predefined user roles

network-admin

Parameters

server-interface interface-type interface-number: Specifies a downlink interface by its type and number, which can only be an FC interface or FC aggregate interface.

external-interface interface-type interface-number: Specifies an uplink interface by its type and number, which can only be an FC interface or FC aggregate interface.

Usage guidelines

Only NPV switches and VSANs operating in NPV mode support this command.

A downlink interface selects an uplink interface to map as follows:

· When uplink-to-downlink interface mappings are configured for the downlink interface, the downlink interface can select an uplink interface from only the configured mappings.

· When no uplink-to-downlink interface mapping is configured for the downlink interface, the downlink interface can select an uplink interface from all uplink interfaces in the same VSAN.

Examples

# Configure a mapping between FC 1/1/1 (downlink interface) and FC 1/1/2 (uplink interface).

<Sysname> system-view

[Sysname] vsan 10

[Sysname-vsan10] npv traffic-map server-interface fc 1/1/1 external-interface fc 1/1/2

Port security commands

any-wwn

Use any-wwn to allow any WWN to log in through the specified interfaces.

Use undo any-wwn to delete the configuration.

Syntax

any-wwn interface interface-list

undo any-wwn interface interface-list

Default

WWNs are not allowed to log in through an interface.

Views

VSAN view

Predefined user roles

network-admin

Parameters

interface interface-list: Specifies a space-separated list of up to 10 interface items. Each item specifies an interface or a range of interfaces in the form of interface-type interface-number1 to interface-type interface-number2. The value for interface-number2 must be greater than or equal to the value for interface-number1. The two interfaces that define an interface range must be the same type and on the same card. The interface type can only be FC interface (cannot be a member port of an FC aggregate interface) or FC aggregate interface.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Enable port security before configuring this command.

After you add (or delete) a binding entry to (or from) the port security database, the switch performs authorization checks on devices already logged in. If a device on an interface specified in the binding entry passes authorization checks, the device is not logged out. Otherwise, the device is logged out.

Examples

# Allow any WWN to log in through FC 1/1/1 in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] any-wwn interface fc 1/1/1

Related commands

display fc-port-security database

Use display fc-port-security database to display binding entries in the port security database.

Syntax

display fc-port-security database { all | auto-learn | smartsan-learn | smartsan-static | static } [ interface interface-type interface-number ] [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all binding entries, including static entries, learned entries, learning entries, Smart SAN learning entries, and Smart SAN static entries.

auto-learn: Specifies learned and learning entries.

smartsan-learn: Specifies Smart SAN learning entries.

smartsan-static: Specifies Smart SAN static entries.

static: Specifies static entries.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays binding entries for all interfaces.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays binding entries for all VSANs. On an FCF-NPV switch, this command displays the binding entries for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display all binding entries in the port security database for VSAN 2.

<Sysname> display fc-port-security database all vsan 2

Total entries: 9

Database for VSAN 2:

Logging-in entity Interface Type

Any WWN Fc1/1/3 Static

20:33:44:78:66:77:ab:97(pWWN) Any interface Static

20:36:44:78:66:77:ab:97(pWWN) Fc1/1/2 Static

20:36:44:78:66:77:ab:9e(pWWN) Fc1/1/5 Learned

20:86:44:65:90:2a:ab:36(pWWN) Fc1/1/2 SmartSAN-Static

20:86:44:65:90:2a:ab:3a(pWWN) Fc1/1/1 Learning

20:86:44:65:90:2a:ab:3c(pWWN) Fc1/1/6 SmartSAN-Learning

10:83:45:78:66:77:ab:93(nWWN) Fc1/1/3 Static

10:36:44:78:66:77:ab:96(sWWN) Fc1/1/4 Static

Table 42 Command output

Field	Description
Logging-in entity	WWN of the device permitted by an entry. The WWN type is displayed in the parenthesis and can be one of the following: · pWWN—WWN of an N_Port or NP_Port. · sWWN—WWN of an FCF switch. · nWWN—WWN of a node or an NPV switch. Any WWN indicates a WWN of any device.
Interface	Interface through which a device logs in. Any Interface indicates the device can log in through any interface.
Type	Entry type: · Static—Manually configured entries. · Learned—Entries converted from existing learning entries when auto learning is disabled. A learned entry is not deleted when the corresponding device logs out. · Learning—Entries automatically learned by the auto learning feature. A learning entry is deleted when the corresponding device logs out. · SmartSAN-Learning—Entries automatically learned by the Smart SAN auto learning feature for Smart SAN-capable nodes whose Smart SAN Security Support field is not 0x00. A Smart SAN learning entry is deleted when the corresponding device logs out. · SmartSAN-Static—Entries manually configured for Smart SAN-capable nodes whose Smart SAN Security Support field is not 0x00. A Smart SAN static entry is not deleted when the corresponding device logs out. Smart SAN learning entries are converted to Smart SAN static entries when Smart SAN auto learning is disabled.

Related commands

reset fc-port-security database

display fc-port-security statistics

Use display fc-port-security statistics to display port security statistics.

Syntax

display fc-port-security statistics [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays port security statistics for all VSANs. On an FCF-NPV switch, this command displays the port security statistics for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display port security statistics for VSAN 2.

<Sysname> display fc-port-security statistics vsan 2

Statistics for VSAN 2:

Number of permitted pWWN logins: 2

Number of permitted nWWN logins: 2

Number of permitted sWWN logins: 2

Number of denied pWWN logins : 0

Number of denied nWWN logins : 0

Number of denied sWWN logins : 0

Total logins permitted : 6

Total logins denied : 0

Related commands

reset fc-port-security statistics

display fc-port-security status

Use display fc-port-security status to display the port security status.

Syntax

display fc-port-security status [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the port security status in all VSANs. On an FCF-NPV switch, this command displays the port security status in only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

This command also displays the configuration of the fc-port-security command.

Examples

# Display the port security status in all VSANs.

<Sysname> display fc-port-security status

Status for VSAN 1:

FC port security: Disabled

Auto learn: Disabled

SmartSAN auto learn: Disabled

Status for VSAN 2:

FC port security: Enabled

Auto learn: Enabled

SmartSAN auto learn: Enabled

Table 43 Command output

Field	Description
FC port security	Status of port security: · Enabled. · Disabled.
Auto learn	Status of auto learning: · Enabled. · Disabled.
SmartSAN auto learn	Status of auto learning for Smart SAN-capable nodes whose Smart SAN Security Support field is not 0x00: · Enabled. · Disabled.

Related commands

fc-port-security

fc-port-security enable

display fc-port-security violation

Use display fc-port-security violation to display security violation entries.

Syntax

display fc-port-security violation [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays security violation entries for all VSANs. On an FCF-NPV switch, this command displays the security violation entries for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Display security violation entries for VSAN 2.

<Sysname> display fc-port-security violation vsan 2

Total entries: 3

Violations for VSAN 2:

Interface Logging-in entity Last time Repeat count

Fc1/1/1 20:36:44:78:66:77:ab:97(pWWN) 2013/10/30 12:29:23 2

20:00:00:e0:8b:06:d9:1d(nWWN)

Fc1/1/2 20:42:78:66:77:ab:98:12(pWWN) 2013/10/29 17:29:23 3

20:00:00:e0:8b:06:d9:1d(nWWN)

Fc1/1/3 10:36:44:78:66:77:ab:96(sWWN) 2013/10/28 11:30:23 12

Table 44 Command output

Field	Description
Interface	Interface through which a violating device attempted to log in.
Logging-in entity	WWN of a violating device. The WWN type is displayed in the parenthesis and can be one of the following: · pWWN—WWN of an N_Port or NP_Port. · sWWN—WWN of an FCF switch. · nWWN—WWN of a node or an NPV switch.
Last time	Time when a violating device last attempted to log in.
Repeat count	Number of times that a violating device attempted to log in.

fc-port-security

Use fc-port-security to enable auto learning or Smart SAN auto learning in a VSAN.

Use undo fc-port-security to disable auto learning or Smart SAN auto learning in a VSAN.

Syntax

fc-port-security { auto-learn | smartsan-learn }

undo fc-port-security { auto-learn | smartsan-learn }

Default

Auto learning and Smart SAN auto learning are disabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

auto-learn: Enables auto learning for nodes and switches.

smartsan-learn: Enables Smart SAN auto learning for Smart SAN-capable nodes whose Smart SAN Security Support field is not 0x00.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

You can enable auto learning only after you enable port security. You can specify the smartsan-learn keyword only after you enable Smart SAN for FC.

After you enable auto learning, all devices that are newly logged in are added to the port security database as learning entries. A learning entry does not affect device login and is deleted when the corresponding device logs out. When you disable auto learning, learning entries are converted to learned entries. A learned entry affects device login and is not deleted when the corresponding device logs out.

After you enable Smart SAN auto learning, the switch performs the following operations:

· Learns binding entries for newly logged in nodes that are Smart SAN-capable and whose Smart SAN Security Support field is not 0x00.

· Adds the entries to the port security database as Smart SAN learning entries.

A Smart SAN learning entry does not affect device login and is deleted when the corresponding device logs out. When you disable Smart SAN auto learning, Smart SAN learning entries are converted to Smart SAN static entries. A Smart SAN static entry affects device login and is not deleted when the corresponding device logs out.

Examples

# Enable auto learning in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] fc-port-security enable

[Sysname-vsan2] fc-port-security auto-learn

# Disable auto learning in VSAN 2 to convert learning entries to learned entries.

[Sysname-vsan2] undo fc-port-security auto-learn

Related commands

display fc-port-security status

fc-port-security database copy

Use fc-port-security database copy to convert learned entries to static entries in a VSAN.

Syntax

fc-port-security database copy

Views

VSAN view

Predefined user roles

network-admin

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Enable port security before configuring this command.

Learned entries do not survive a reboot. To make learned entries survive reboots, convert the learned entries to static entries.

Examples

# Convert learned entries to static entries in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] fc-port-security database copy

Related commands

display fc-port-security database

fc-port-security enable

Use fc-port-security enable to enable port security and auto learning or Smart SAN auto learning in a VSAN.

Use undo fc-port-security enable to disable port security in a VSAN.

Syntax

fc-port-security enable [ all | auto-learn | smartsan-learn ]

undo fc-port-security enable

Default

Port security, auto learning, and Smart SAN auto learning are disabled in a VSAN.

Views

VSAN view

Predefined user roles

network-admin

Parameters

all: Enables both auto learning and Smart SAN auto learning.

auto-learn: Enables auto learning.

smartsan-learn: Enables Smart SAN auto learning.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

You can configure other port security settings only after you enable port security.

You can specify the all or smartsan-learn keyword only after you enable Smart SAN for FC.

If you enable auto learning while enabling port security, the switch learns binding entries for both devices already logged in and devices newly logged in. If you enable port security without enabling auto learning, the switch logs out devices already logged in.

When you enable port security, you can also enable Smart SAN auto learning. Smart SAN auto learning takes effect only when Smart SAN is enabled. If you enable Smart SAN auto learning when enabling port security, the switch performs the following operations:

· Learns binding entries for both already logged in and newly logged in nodes that are Smart SAN-capable and whose Smart SAN Security Support field is not 0x00.

· Adds the entries to the port security database as Smart SAN learning entries.

If you do not enable auto learning or Smart SAN auto learning, devices already logged in are logged out.

If you do not enable auto learning but enable Smart SAN auto learning, the switch adds Smart SAN learning entries for only Smart SAN-capable nodes whose Smart SAN Security Support field is not 0x00. Smart SAN-incapable nodes and switches are logged out.

Examples

# Enable port security and auto learning in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] fc-port-security enable auto-learn

Related commands

display fc-port-security status

nwwn

Use nwwn to allow an nWWN to log in through the specified interfaces.

Use undo nwwn to delete the configuration.

Syntax

nwwn nwwn [ interface interface-list ]

undo nwwn nwwn [ interface interface-list ]

Default

An nWWN is not allowed to log in through the specified interfaces.

Views

VSAN view

Predefined user roles

network-admin

Parameters

nwwn: Specifies the nWWN (WWN of a node or an NPV switch) in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Enable port security before configuring this command.

After you add (or delete) a binding entry to (or from) the port security database, the switch performs authorization checks on devices already logged in. If the device specified in the binding entry or a device on a specified interface passes authorization checks, the device is not logged out. Otherwise, the device is logged out.

Examples

# Allow nWWN 20:36:44:78:66:77:ab:9e to log in through FC 1/1/1 in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] nwwn 20:36:44:78:66:77:ab:9e interface fc 1/1/1

Related commands

display fc-port-security database

pwwn

Use pwwn to allow a pWWN to log in through the specified interfaces.

Use undo pwwn to delete the configuration.

Syntax

pwwn pwwn [ interface interface-list ] [ smartsan-static ]

undo pwwn pwwn [ interface interface-list ] [ smartsan-static ]

Default

A pWWN is not allowed to log in through the specified interfaces.

Views

VSAN view

Predefined user roles

network-admin

Parameters

nwwn: Specifies the pWWN (WWN of an N_Port or NP_Port) in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

smartsan-static: Allows Smart SAN-capable N_Ports or NP_Ports whose Smart SAN Security Support field is not 0x00 to log in through the specified interfaces. The configured entry is a Smart SAN static entry. If you do not specify this keyword, the configured entry is a static entry.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Enable port security before configuring this command. You can specify the smartsan-static keyword only after you enable Smart SAN for FC.

Examples

# Allow pWWN 20:36:44:78:66:77:ab:9e to log in through FC 1/1/1 in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] pwwn 20:36:44:78:66:77:ab:9e interface fc 1/1/1

Related commands

display fc-port-security database

reset fc-port-security database

Use reset fc-port-security database to clear binding entries in the port security database.

Syntax

reset fc-port-security database { all | auto-learn | smartsan-static | static } [ interface interface-type interface-number ] vsan vsan-id

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all binding entries, including static entries, learned entries, learning entries, and Smart SAN static entries.

auto-learn: Specifies learned and learning entries.

static: Specifies static entries.

smartsan-static: Specifies Smart SAN static entries.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command clears binding entries for all interfaces.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. On an FCF-NPV switch, this command clears the binding entries for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

After you execute this command, the switch performs authorization checks on devices already logged in. Therefore, the switch might log out devices already logged in.

Examples

# Clear static binding entries in the port security database for VSAN 2.

<Sysname> reset fc-port-security database static vsan 2

Related commands

display fc-port-security database

reset fc-port-security statistics

Use reset fc-port-security statistics to clear port security statistics for a VSAN.

Syntax

reset fc-port-security statistics vsan vsan-id

Views

User view

Predefined user roles

network-admin

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. On an FCF-NPV switch, this command clears the port security statistics for only VSANs operating in FCF mode.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

Examples

# Clear port security statistics for VSAN 2.

<Sysname> reset fc-port-security statistics vsan 2

Related commands

display fc-port-security statistics

snmp-agent trap enable fc-port-security

Use snmp-agent trap enable fc-port-security to enable SNMP notifications for port security.

Use undo snmp-agent trap enable fc-fabric to disable SNMP notifications for port security.

Syntax

snmp-agent trap enable fc-port-security [ violation-happen ]

undo snmp-agent trap enable fc-port-security [ violation-happen ]

Default

All SNMP notifications for port security are disabled.

Views

System view

Predefined user roles

network-admin

Parameters

violation-happen: Specifies notifications about only security violations. This keyword enables the switch to generate a notification when the switch detects a security violation. The notification includes the WWN of the violating device, the interface through which the violating device attempted to log in, and login time. If you do not specify this keyword, the command enables all SNMP notifications for port security.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

To report critical port security events to an NMS, enable SNMP notifications for port security. For port security event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

Examples

# Enable all SNMP notifications for port security.

<Sysname> system-view

[Sysname] snmp-agent trap enable fc-port-security

swwn

Use swwn to allow an sWWN to log in through the specified interfaces.

Use undo swwn to delete the configuration.

Syntax

swwn swwn [ interface interface-list ]

undo swwn swwn [ interface interface-list ]

Default

An sWWN is not allowed to log in through the specified interfaces.

Views

VSAN view

Predefined user roles

network-admin

Parameters

swwn: Specifies the sWWN (WWN of an FCF switch) in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.

Usage guidelines

Only FCF switches and VSANs operating in FCF mode support this command.

Enable port security before configuring this command.

Examples

# Allow sWWN 20:36:44:78:66:77:ab:9e to log in through FC 1/1/1 in VSAN 2.

<Sysname> system-view

[Sysname] vsan 2

[Sysname-vsan2] swwn 20:36:44:78:66:77:ab:9e interface fc 1/1/1

Related commands

display fc-port-security database

FCS commands

The commands in this section are supported only on FCF and FCF-NPV switches.

display fcs database

Use display fcs database to display the local FCS database information, including IE and port information.

Syntax

display fcs database [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the FCS database information in all VSANs. On an FCF-NPV switch, this command displays the FCS database information in only VSANs operating in FCF mode.

Examples

# Display the FCS database information in all VSANs.

<Sysname> display fcs database

FCS Local Database in VSAN 1:

IE WWN : 10:00:00:11:22:00:01:01

Domain ID : 0x01

Management address list : snmp://192.168.6.100

snmp://192.168.0.100

Fabric name : 10:00:00:11:22:00:01:01

Logical name : Sysname

Information list : H3C#H3C BX720EF #Version 7.1.070, UIS-SWITCH_SYS 1.0

IE_Ports:

Interface Port WWN Port type Attached port WWNs

Fc1/1/2 2f:12:01:11:22:00:01:01 F_Port 2f:12:01:11:22:00:01:02

2f:12:01:11:22:00:01:03

2f:12:01:11:22:00:01:04

Fc1/1/1 38:00:00:11:22:00:01:01 E_Port 38:00:00:11:22:00:01:02

IE WWN : 10:00:00:11:22:00:01:02

Domain ID : 0x02

Management address list : snmp://192.168.6.101

Fabric name : 10:00:00:11:22:00:01:01

Logical name : Sysname

Information list : H3C#H3C BX720EF #Version 7.1.070, UIS-SWITCH_SYS 1.0

IE_Ports:

Interface Port WWN Port type Attached port WWNs

- 2f:15:01:11:22:00:01:01 F_Port 2f:15:01:11:22:00:01:02

- 38:00:00:11:22:00:01:01 E_Port 38:00:00:11:22:00:01:02

FCS Local Database in VSAN 2:

IE WWN : 10:00:00:11:22:00:01:01

Domain ID : 0x01

Management address list : snmp://192.168.6.100

snmp://192.168.0.100

Fabric name : 10:00:00:11:22:00:01:01

Logical name : Sysname

Information list : H3C#H3C BX720EF #Version 7.1.070, UIS-SWITCH_SYS 1.0

IE_Ports:

Interface Port WWN Port type Attached port WWNs

Table 45 Command output

Field	Description
Management address list	· snmp://192.168.6.100—SNMP is supported by the IE, and the management IP address is 192.168.6.100. · Unknown—No management IP address is obtained from the IE. · NA—No management IP address is configured on the IE.
Fabric name	Name of the fabric where the IE resides. Unknown indicates that the fabric name is not obtained from the IE.
Logical name	Device name of the IE. Unknown indicates that the device name is not obtained from the IE.
Information list	Includes vendor name, model name/number, and release code. Unknown indicates that the information list is not obtained from the IE.
Interface	Interface name. The interface name is displayed for only interfaces on the local IE. For interfaces on non-local IEs, a hyphen (-) is displayed.
Port type	Port mode: E_Port or F_Port. Unknown is displayed for port modes other than E_Port and F_Port.
Attached port WWNs	WWNs of connected ports. NA indicates that the port does not connect to any ports.

Related commands

fcs discovery start

display fcs discovery status

Use display fcs discovery status to display the topology discovery status.

Syntax

display fcs discovery status [ vsan vsan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the topology discovery status in all VSANs. On an FCF-NPV switch, this command displays the topology discovery status in only VSANs operating in FCF mode.

Examples

# Display the topology discovery status in all VSANs.

<Sysname> display fcs discovery status

VSAN Discovery Status

1 inProgress

2 completed

3 localOnly

Related commands

fcs discovery start

fcs discovery stop

display fcs ie

Use display fcs ie to display IE information.

Syntax

display fcs ie [ vsan vsan-id ] [ nwwn wwn ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the IE information in all VSANs. On an FCF-NPV switch, this command displays the IE information in only VSANs operating in FCF mode.

nwwn wwn: Specifies a node by its WWN in the format of xx:xx:xx:xx:xx:xx:xx:xx (hexadecimal). If you do not specify a node, this command displays the IE information for all nodes.

verbose: Displays detailed IE information. If you do not specify this keyword, the command displays brief IE information.

Examples

# Display the IE information in all VSANs.

<Sysname> display fcs ie

IE List for VSAN 1:

IE WWN Domain ID Mgmt addr list Logical name

10:00:00:11:22:00:01:01 0x01 snmp://192.168.6.100 Sysname

snmp://192.168.0.100

10:00:00:11:22:00:01:02 0x02 snmp://192.168.6.101 Sysname

Total 2 IEs in Fabric.

IE List for VSAN 2:

IE WWN Domain ID Mgmt addr list Logical name

10:00:00:11:22:00:01:01 0x01 snmp://192.168.6.100 Sysname

Total 1 IEs in Fabric.

# Display the IE information in VSAN 1.

<Sysname> display fcs ie vsan 1

IE List for VSAN 1:

IE WWN Domain ID Mgmt addr list Logical name

10:00:00:11:22:00:01:01 0x01 snmp://192.168.6.100 Sysname

snmp://192.168.0.100

10:00:00:11:22:00:01:02 0x02 snmp://192.168.6.101 Sysname

Total 2 IEs in Fabric.

# Display the brief IE information for the node with WWN 10:00:00:11:22:00:01:01 in VSAN 1.

<Sysname> display fcs ie vsan 1 nwwn 10:00:00:11:22:00:01:01

IE WWN Domain ID Mgmt addr list Logical name

10:00:00:11:22:00:01:01 0x01 snmp://192.168.6.100 Sysname

snmp://192.168.0.100

# Display the detailed IE information for the node with WWN 10:00:00:11:22:00:01:01 in VSAN 1.

<Sysname> display fcs ie vsan 1 nwwn 10:00:00:11:22:00:01:01 verbose

IE Attributes:

IE WWN : 10:00:00:11:22:00:01:01

IE type : Switch

Domain ID : 0x01

Fabric name : 10:00:00:11:22:00:01:01

Logical name : Sysname

Management address list: snmp://192.168.6.100

snmp://192.168.0.100

Information list :

Vendor name : H3C

Model name/number: H3C BX720EF

Release code : Version 7.1.070, UIS-SWITCH_SYS 1.00.05

# Display the detailed IE information in all VSANs.

<Sysname> display fcs ie verbose

IE List for VSAN 1:

IE Attributes:

IE WWN : 10:00:00:11:22:00:01:01

IE type : Switch

Domain ID : 0x01

Fabric name : 10:00:00:11:22:00:01:01

Logical name : Sysname

Management address list: snmp://192.168.6.100

snmp://192.168.0.100

Information list :

Vendor name : H3C

Model name/number: H3C BX720EF

Release code : Version 7.1.070, UIS-SWITCH_SYS 1.00.05

Total 1 IEs in Fabric.

IE List for VSAN 2:

IE Attributes:

IE WWN : 10:00:00:11:22:00:01:01

IE type : Switch

Domain ID : 0x01

Fabric name : 10:00:00:11:22:00:01:01

Logical name : Sysname

Management address list: snmp://192.168.6.100

snmp://192.168.0.100

Information list :

Vendor name : H3C

Model name/number: H3C BX720EF

Release code : Version 7.1.070, UIS-SWITCH_SYS 1.00.05

Total 1 IEs in Fabric.

Table 46 Command output

Field	Description
IE type	The IE type can only be Switch. Unknown is displayed for all other types.
Fabric name	Name of the fabric where the IE resides. Unknown indicates that the fabric name is not obtained from the IE.
Logical name	Device name of the IE. Unknown indicates that the device name is not obtained from the IE.
Mgmt addr list Management address list	· snmp://192.168.6.100—SNMP is supported by the IE, and the management IP address is 192.168.6.100. · Unknown—No management IP address is obtained from the IE. · NA—No management IP address is configured on the IE.
Information list	Includes vendor name, model name/number, and release code. Unknown indicates that the information list is not obtained from the IE.

Related commands

fcs discovery start

display fcs port

Use display fcs port to display port information.

Syntax

display fcs port [ vsan vsan-id ] [ pwwn wwn ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the port information in all VSANs. On an FCF-NPV switch, this command displays the port information in only VSANs operating in FCF mode.

pwwn wwn: Specifies a port by its WWN in the format of xx:xx:xx:xx:xx:xx:xx:xx (hexadecimal). If you do not specify a port, this commands displays information about all ports.

verbose: Displays detailed port information. If you do not specify this keyword, the command displays brief port information.

Examples

# Display the port information for all VSANs.

<Sysname> display fcs port

Port List for VSAN 1:

IE WWN: 10:00:00:11:22:00:01:01

Port WWN Port type Tx type Module type

2f:15:01:11:22:00:01:01 Unknown Shortwave Laser SFP with Serial ID

38:00:00:11:22:00:01:01 E_Port Shortwave Laser SFP with Serial ID

Total 2 switch-ports in IE.

IE WWN: 10:00:00:11:22:00:01:02

Port WWN Port type Tx type Module type

38:00:00:11:22:00:01:02 E_Port Shortwave Laser SFP with Serial ID

Total 1 switch-ports in IE.

Port List for VSAN 2:

IE WWN: 10:00:00:11:22:00:01:01

Port WWN Port type Tx type Module type

2f:15:01:11:22:00:01:01 Unknown Shortwave Laser SFP with Serial ID

38:00:00:11:22:00:01:01 E_Port Shortwave Laser SFP with Serial ID

Total 2 switch-ports in IE.

# Display the brief port information for the port with WWN 38:00:00:11:22:00:01:01 in VSAN 1.

<Sysname> display fcs port vsan 1 pwwn 38:00:00:11:22:00:01:01

Port WWN Port type Tx type Module type

38:00:00:11:22:00:01:01 E_Port Shortwave Laser SFP with Serial ID

# Display the detailed port information for the port with WWN 38:00:00:11:22:00:01:01 in VSAN 1.

<Sysname> display fcs port vsan 1 pwwn 38:00:00:11:22:00:01:01 verbose

Port Attributes:

Port WWN : 38:00:00:11:22:00:01:01

Port type : E_Port

Tx type : Shortwave Laser

Module type : SFP with Serial ID

Port number : 465

Attached port WWNs : 2f:15:01:11:22:00:01:02

Port state : Offline

Port speed capability : 10Gbps, 16Gbps

Port speed operation : 10Gbps

Port zoning enforcement status : Soft, Hard

Table 47 Command output

Field	Description
Port type	Port mode: E_Port or F_Port. Unknown is displayed for port modes other than E_Port and F_Port.
Tx type	Transmitter type of the port: · 10GBASE-CX4. · 10GBASE-ER 1550nm laser. · 10GBASE-EW 1550nm laser. · 10GBASE-LR 1310nm laser. · 10GBASE-LW 1310nm laser. · 10GBASE-LX4 WWDM 1300nm laser. · 10GBASE-SR 850nm laser. · 10GBASE-SW 850nm laser. · Electrical-EL. · Long wave laser cost reduced-LC(1310nm). · Long wave laser-LL(1550nm). · Short wave laser-SN(850nm). Unknown is displayed for cable types other than the preceding ones or for a VN interface.
Module type	Transceiver module type of the port: · GBIC with serial ID. · GBIC without serial ID. · GLM. · QSFP. · SFP-DWDM. · SFP with serial ID. · SFP without serial ID. · X2-DWDM. · X2 Medium. · X2 short. · X2 Tall. · XENPAK. · XFP. · XPAX Medium. · XPAX short. · XPAX Tall. Other is displayed for transceiver module types other than the preceding ones. Unknown is displayed when the transceiver module type cannot be obtained or when the port is a VN interface.
Port number	Port index.
Attached port WWNs	WWNs of connected ports. If the nodes are registered through an NPV switch, there might be multiple connected ports.
Port state	Current port state: · Online—The port link is connected. · Offline—The port link is not connected. · Unknown—Port state other than Online or Offline.
Port speed capability	The supported speed can be one or more of the following options: · 4 Gbps. · 8 Gbps. · 16 Gbps. Unknown is displayed for speeds other than the preceding ones or for a VN interface.
Port speed operation	The current speed can only be one of the following options: · 4 Gbps. · 8 Gbps. · 16 Gbps. Unknown is displayed for speeds other than the preceding ones or for a VN interface. Speed not established is displayed when the current port state is Offline.
Port zoning enforcement status	Zoning type supported by the port: soft zoning or hard zoning. Soft zoning and hard zoning can be both supported. NA is displayed when neither of them is supported.

Related commands

fcs discovery start

Use fcs discovery start to start a topology discovery in VSANs.

Syntax

fcs discovery start [ age interval ] vsan vsan-list

Views

System view

Predefined user roles

network-admin

Parameters

age interval: Specifies the aging time for the topology discovery information, in the range of 300 to 86400 seconds. The default is 900 seconds.

vsan vsan-list: Specifies a VSAN by its ID or a range of VSANs in the form of vsan-id1 to vsan-id2. The value range for the vsan-id argument is 1 to 3839. The value for vsan-id2 must be greater than or equal to the value for vsan-id1.

Examples

# Start a topology discovery in VSAN 1 through VSAN 100.

<Sysname> system-view

[Sysname] fcs discovery start vsan 1 to 100

Related commands

display fcs database

display fcs discovery status

display fcs ie

display fcs port

fcs discovery stop

Use fcs discovery stop to stop a topology discovery in VSANs.

Syntax

fcs discovery stop vsan vsan-list

Views

System view

Predefined user roles

network-admin

Parameters

Examples

# Stop the topology discovery in VSAN 1 through VSAN 100.

<Sysname> system-view

[Sysname] fcs discovery stop vsan 1 to 100

Related commands

fcs discovery start

FDMI commands

display fdmi database

Use display fdmi database to display the FDMI database information.

Syntax

display fdmi database [ vsan vsan-id ] [ hba-id hba-id ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this command displays the FDMI database information for all VSANs. On an FCF-NPV switch, this command displays the FDMI database information in only VSANs operating in FCF mode.

hba-id hba-id: Specifies an HBA by its ID in the format of xx:xx:xx:xx:xx:xx:xx:xx (hexadecimal). If you do not specify an HBA, this command displays the FDMI database information for all HBAs.

verbose: Displays detailed FDMI database information. If you do not specify this keyword, the command displays brief FDMI database information.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The FDMI database includes information about only ports on HBAs that have successfully registered with the device.

Examples

# Display the brief FDMI database information for all VSANs.

<Sysname> display fdmi database

Registered HBA List for VSAN 1:

HBA ID Port Name

21:00:00:11:22:00:01:02 21:00:00:11:22:00:01:02

21:00:00:c0:dd:13:cc:d6

21:00:00:c0:dd:13:cc:d7

38:00:00:11:22:00:01:01 21:00:00:c0:dd:13:cc:d4

21:00:00:c0:dd:13:cc:d5

38:00:00:11:22:00:01:01

Registered HBA List for VSAN 2:

HBA ID Port Name

38:00:00:11:22:00:01:01 21:00:00:c0:dd:13:cc:d4

21:00:00:c0:dd:13:cc:d5

38:00:00:11:22:00:01:01

Table 48 Command output

Field	Description
Port Name	WWNs of the ports on the HBA.

# Display brief information about the HBA 38:00:00:11:22:00:01:01 in the FDMI database for VSAN 1.

<Sysname> display fdmi database vsan 1 hba-id 38:00:00:11:22:00:01:01

HBA ID Port Name

38:00:00:11:22:00:01:01 21:00:00:c0:dd:13:cc:d4

21:00:00:c0:dd:13:cc:d5

38:00:00:11:22:00:01:01

# Display the detailed FDMI database information for the HBA 50:01:43:80:12:09:54:f4 in VSAN 1 when Smart SAN is disabled.

<Sysname> display fdmi database vsan 1 hba-id 50:01:43:80:12:09:54:f4 verbose

Registered HBA List for VSAN 1:

HBA ID: 50:01:43:80:12:09:54:f4

Manufacturer: QLogic Corporation

Serial Number: MY5140209J

Model: HPAK344A

Model Description: QLogic HPAK344A Fibre Channel Adapter

Node Name: 50:01:43:80:12:09:54:f5

Node Symbolic Name: HPAK344A FW:v7.04.00 DVR:v9.1.14.22

Hardware Version: PX2810403-21 G

Driver Version: 9.1.14.22

Option ROM Version: 3.28

Firmware Version: 7.04.00

OS Name and Version: Windows Server 2008 R2 Datacenter Service Pack 1

Maximum CT Payload: 2048

Vendor Identifier: QLOGIC

Vendor Specific Information: 0x327A0941

Number of Ports: 1

Fabric Name: 20:01:00:e0:fc:a1:58:00

Boot BIOS Version: 3.28

Boot BIOS State: Enabled

Port Name: 50:01:43:80:12:09:54:f4

Port Symbolic Name: HPAK344A FW:v7.04.00 DVR:v9.1.14.22

Port Identifier: 0x020000

Port Type: 0x01(N)

Supported Class of Service: 3

Supported FC-4 Types: FCP

Port Active FC-4 Types: FCP

Supported Speed: 2 Gbps, 4 Gbps, 8 Gbps

Current Speed: 8Gbps

Maximum Frame Size: 2048

OS Device Name: QLogic Adapter

Host Name: WIN-NGCFD7VQUA2

Port Fabric Name: 20:01:00:e0:fc:a1:58:00

Port State: 0x00000001

Number of Discovered Ports: 2

# Display the detailed FDMI database information for the HBA 50:01:43:80:12:09:54:f4 in VSAN 1 when Smart SAN is enabled and incoming packets include Smart SAN attributes.

<Sysname> display fdmi database vsan 1 hba-id 50:01:43:80:12:09:54:f4 verbose

Registered HBA List for VSAN 1:

HBA ID: 50:01:43:80:12:09:54:f4

Manufacturer: QLogic Corporation

Serial Number: MY5140209J

Model: HPAK344A

Model Description: QLogic HPAK344A Fibre Channel Adapter

Node Name: 50:01:43:80:12:09:54:f5

Node Symbolic Name: HPAK344A FW:v7.04.00 DVR:v9.1.14.22

Hardware Version: PX2810403-21 G

Driver Version: 9.1.14.22

Option ROM Version: 3.28

Firmware Version: 7.04.00

OS Name and Version: Windows Server 2008 R2 Datacenter Service Pack 1

Maximum CT Payload: 2048

Vendor Identifier: QLOGIC

Vendor Specific Information: 0x327A0941

Number of Ports: 1

Fabric Name: 20:01:00:e0:fc:a1:58:00

Boot BIOS Version: 3.28

Boot BIOS State: Enabled

Port Name: 50:01:43:80:12:09:54:f4

Port Symbolic Name: HPAK344A FW:v7.04.00 DVR:v9.1.14.22

Port Identifier: 0x020000

Port Type: 0x01(N)

Supported Class of Service: 3

Supported FC-4 Types: FCP

Port Active FC-4 Types: FCP

Supported Speed: 2 Gbps, 4 Gbps, 8 Gbps

Current Speed: 8Gbps

Maximum Frame Size: 2048

OS Device Name: QLogic Adapter

Host Name: WIN-NGCFD7VQUA2

Port Fabric Name: 20:01:00:e0:fc:a1:58:00

Port State: 0x00000001

Number of Discovered Ports: 0

Smart SAN Service Category: Smart SAN Initiator

Smart SAN GUID: 50014380-1209-54f5-5001-4380120954f4

Smart SAN Version: Smart SAN Version 1.0

Smart SAN Product Name(Model): HPAK344A

Smart SAN Port info: 0x01(Physical)

Smart SAN QoS Support: 0x00(Not Supported)

Smart SAN Security Support: 0x01(Tier-1)

Smart SAN Connected Ports: 20:01:00:e0:fc:a1:58:03

Table 49 Command output

Field	Description
Manufacturer	Manufacturer of the HBA.
Serial Number	Serial number of the HBA.
Model	Model of the HBA.
Model Description	Model description for the HBA.
Node Name	WWN of the node where the HBA resides.
Node Symbolic Name	Symbolic name of the node where the HBA resides.
Hardware Version	Hardware version of the HBA.
Driver Version	Driver version of the HBA.
Option ROM Version	ROM version of the HBA.
Firmware Version	Firmware version of the HBA.
OS Name and Version	Operating system name and version number of the HBA.
Maximum CT Payload	Maximum length of CT payload allowed by the HBA. The CT payload includes the basic header and extended header of CT packets, but not the FC header.
Vendor Identifier	T10 code of the manufacturer or OEM for the HBA.
Vendor Specific Information	Vendor-defined information, which is hexadecimal.
Number of Ports	Number of ports on the HBA.
Fabric Name	Name of the fabric where the HBA resides.
Boot BIOS Version	Boot BIOS version of the HBA.
Boot BIOS State	Boot BIOS state for the HBA: Enabled or Disabled.
Port Name	WWN of the port on the HBA.
Port Symbolic Name	Symbolic name of the port on the HBA.
Port Identifier	FC address of the port
Supported Class of Service	Class of service supported by the port: Class 2 or Class 3.
Supported FC-4 Types	FC-4 types supported by the port: · FCP. · GS3. · IP. · LLC/SNAP. · NPV. · SNMP. · SW-ILS. · VI.
Port Active FC-4 Types	FC-4 types active on the port, which can be one or more of the following options: · FCP. · GS3. · IP. · LLC/SNAP. · NPV. · SNMP. · SW-ILS. · VI.
Supported Speed	Speeds supported by the port: · 4 Gbps · 8 Gbps · 16 Gbps This field displays Unknown for speeds other than the preceding ones. This field displays Speed not obtained when the supported speeds cannot be determined.
Current Speed	The current speed can only be one of the following options: · 4 Gbps · 8 Gbps · 16 Gbps This field displays Unknown for speeds other than the preceding ones. This field displays Speed not obtained when the current speed cannot be determined.
OS Device Name	Operating system name for the port.
Host Name	Name of the node where the port resides.
Node Name	WWN of the node where the port resides.
Port Fabric Name	Name of the fabric where the port resides.
Smart SAN Service Category	Smart SAN service category: Smart SAN Initiator or Smart SAN Target.
Smart SAN GUID	Smart SAN globally unique identifier.
Smart SAN Port Info	Port information: · 0x01 (Physical)—The port is a physical port. · 0x02 (NPIV)—The port supports NPIV. · 0x03 (SRIOV)—The port supports SRIOV.
Smart SAN QoS Support	This field is not supported in the current software version. QoS support of the port: 0x00 (Not supported) and 0x01 (Supported).
Smart SAN Security Support	Security types supported by the port: · 0x00 (Not Supported). · 0x01 (Tier-1). · 0x02 (Tier-2). · 0x03 (Tier-3).
Smart SAN Connected Ports	This field displays ports on remote nodes discovered by the port.

FC ping commands

fcping

Use fcping to FCping a node or an FCF switch.

Syntax

fcping [ -c count | -t timeout ] * fcid fcid vsan vsan-id

Views

Any view

Predefined user roles

network-admin

Parameters

-c count: Specifies the number of echo requests to be sent, in the range of 0 to 2147483647. The default is 5. The value of 0 indicates that echo requests are continuously sent until you manually stop sending them.

-t timeout: Specifies the timeout value for an echo reply, in the range of 1 to 10 seconds. The default is 5 seconds. If the source does not receive an echo reply within the timeout period, it determines that the echo reply times out.

fcid fcid: Specifies the destination address.

· If the destination is a node, the fcid argument indicates the FC address of the node.

· If the destination is an FC switch, the fcid argument indicates the switch's domain controller address fffcxx (xx is the domain ID of the switch). For example, if the domain ID of the destination switch is 3, its domain controller address is fffc03.

vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

To abort the FC ping operation during the execution of this command, press Ctrl+C.

Examples

# FCping the address fffc02 in VSAN 1.

<Sysname> fcping fcid fffc02 vsan 1

FCPING fcid 0xfffc02: 128 data bytes, press CTRL+C to break.

Reply from 0xfffc02: bytes = 128 time = 1.281 ms

Reply from 0xfffc02: bytes = 128 time = 0.890 ms

Reply from 0xfffc02: bytes = 128 time = 0.889 ms

Reply from 0xfffc02: bytes = 128 time = 0.892 ms

Reply from 0xfffc02: bytes = 128 time = 0.894 ms

--- 0xfffc02 fcping statistics ---

5 packet(s) transmitted

5 packet(s) received

0.00% packet loss

round-trip min/avg/max = 0.889/0.969/1.281 ms

The output shows that all FC ping packets were successfully received.

# FCping the address FFFC01 in VSAN 1.

<Sysname> fcping fcid fffc01 vsan 1

FCPING fcid 0xfffc01: 128 data bytes, press CTRL+C to break.

fcping: sendto: No route to host

fcping: sendto: ^C

--- 0xfffc01 fcping statistics ---

3 packet(s) transmitted

0 packet(s) received

100.00% packet loss

The output shows that FC ping packets were not received.

Table 50 Command output

Field	Description
FCPING fcid 0xfffc02	Identify whether the device with destination address 0xfffc02 is reachable.
128 data bytes	Number of data bytes in each echo request.
press CTRL+C to break	During the execution of the command, press Ctrl+C to abort the FC ping operation.
Reply from 0xfffc02: bytes = 128 time = 0.892 ms	The echo reply was received from the device whose destination address is 0xfffc02. · bytes—Number of data bytes in the echo reply. · time—Response time.
Request time out	No echo reply was received within the timeout period.
fcping: sendto: No route to host	Echo requests failed to be delivered.
--- 0xfffc02 fcping statistics ---	Statistics on the data received and sent in the FC ping operation.
5 packet(s) transmitted	Number of echo requests sent.
5 packet(s) received	Number of echo replies received.
0.00% packet loss	Percentage of packets not responded to the total number of packets sent.
round-trip min/avg/max = 0.889/0.969/1.281 ms	Minimum/average/maximum response time, in milliseconds.

FC tracert commands

fctracert

Use fctracert to detect bidirectional routing information between the local end and a destination. The destination can be a node or FCF switch.

Syntax

fctracert [ -t timeout ] fcid fcid vsan vsan-id

Views

Any view

Predefined user roles

network-admin

Parameters

-t timeout: Specifies the timeout value for the entire FC tracert process, in the range of 1 to 10 seconds. The default is 5 seconds.

fcid fcid: Specifies the destination address.

· If the destination is a node, the fcid argument indicates the FC address of the node.

vsan vsan-id: Specifies an existing VSAN by its ID in the range of 1 to 3839.

Usage guidelines

Only FCF and FCF-NPV switches support this command.

The bidirectional routing information includes WWNs and domain controller addresses of all switches on a round trip. The device supports a maximum of 255 hops for a round trip.

To abort the FC tracert operation during the execution of the command, press Ctrl+C.

Examples

# Detect bidirectional routing information between the local end and a node with FC address 0xd70000 in VSAN 1.

<Sysname> fctracert fcid d70000 vsan 1

Route present for: 0xd70000, press CTRL+C to break.

20:00:00:0b:46:00:02:82(0xfffcd5)

20:00:00:05:30:00:18:db(0xfffcd7)

20:00:00:0b:46:00:02:82(0xfffcd5)

Fctracert completed.

Table 51 Command output

Field	Description
Route present for	Path from a source to a destination.
press CTRL+C to break	During the execution of the command, press Ctrl+C to abort the FC tracert operation.
20:00:00:0b:46:00:02:82	WWN value.
0xfffcd5	Domain controller address 0xfffcxx of the switch, where xx is the domain ID of the switch.
Fctracert uncompleted.	The FC tracert operation fails to be completed for the following possible reasons: · Resource is not enough. · Max hops reached. · Fabric is being built. · No route to destination port. · Destination port is not in fabric. · Destination port and source port are not in the same zone.
Service is unavailable.	The FC tracert service is not started, or internal processing fails.

09-FC Command Reference

FC commands

reset counters interface fc

default (FC aggregate interface view)

description (FC aggregate interface view)

reset counters interface san-aggregation

shutdown (FC aggregate interface view)