- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Text | 596.30 KB |
display fc name-service database
domain auto-reconfigure enable
fc name-service auto-discovery
snmp-agent trap enable fc-fabric
snmp-agent trap enable fc-name-service
FC routing and forwarding commands
fspf graceful-restart interval
snmp-agent trap enable fc-zone
display fip-snooping flushing-rules
FCoE commands
FCoE require a license to run on the switch.
The switch supports FCoE only when it operates in advanced mode. For an operating mode change to take effect, you must perform the following tasks:
1. Save the running configuration to the next-startup configuration file.
2. Delete the .mdb file for the next-startup configuration file.
3. Reboot the switch.
For more information about licensing and system operating modes, see Fundamentals Configuration Guide.
FCoE mode commands
display fcoe-mode
Use display fcoe-mode to display the FCoE mode of the switch.
Syntax
display fcoe-mode
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display the FCoE mode of the switch.
<Sysname> display fcoe-mode
The FCoE mode is FCF.
<Sysname> display fcoe-mode
The FCoE mode is TRANSIT.
<Sysname> display fcoe-mode
The FCoE mode is NONE.
Related commands
fcoe-mode
fcoe-mode
Use fcoe-mode to configure an FCoE mode for the switch.
Use undo fcoe-mode to restore the default.
Syntax
fcoe-mode { fcf | transit }
undo fcoe-mode
Default
A switch operates in non-FCoE mode and does not provide any FCoE capabilities.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
fcf: Specifies the FCF mode.
transit: Specifies the Transit mode.
Usage guidelines
The switch supports the following FCoE modes:
· FCF mode—A switch operating in this mode is called an FCF switch. Its VFC interfaces support E mode (E_Port) and F mode (F_Port).
· Transit mode—A switch operating in this mode is called a Transit switch. Its Ethernet interfaces can operate in ENode mode or FCF mode.
An FCoE-capable switch can operate in the following modes:
· FCF mode—When the switch is operating in this mode, it can perform one of the following operations:
¡ Connect to the E_Port on another FCF switch through its E_Port.
¡ Connect to the N_Port on a node through its F_Port.
· Transit mode—When the switch is operating in this mode, you can perform one of the following tasks:
¡ Configure an Ethernet interface to operate in ENode mode, so that the Ethernet interface can receive traffic from only an ENode.
¡ Configure an Ethernet interface to operate in FCF mode, so that the Ethernet interface can receive traffic from only an FCF switch.
· Non-FCoE mode—When the switch is operating in this mode, it is a standard switch and does not provide any FCoE capabilities.
The switch can only convert from non-FCoE mode to one FCoE mode, or vice versa. It cannot convert directly among FCoE modes. To convert among FCoE modes, first convert the switch to non-FCoE mode. Converting the switch to non-FCoE mode also clears FCoE-related configurations in the original FCoE mode.
Examples
# Configure the switch to operate in FCF mode.
<Sysname> system-view
[Sysname] fcoe-mode fcf
# Convert the switch operating in FCF mode to Transit mode.
[Sysname] undo fcoe-mode
All current FC configuration will be lost. Continue? [Y/N]:y
[Sysname] fcoe-mode transit
Related commands
display fcoe-mode
VFC interface commands
bandwidth
Use bandwidth to set the expected bandwidth for a VFC interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) of a VFC interface is the interface baud rate divided by 1000.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
The expected bandwidth determines the cost of the interface, which is used for route calculation.
By default, the baud rate of a VFC interface is 10 Gbps.
Examples
# Set the expected bandwidth to 50 kbps for interface VFC 1.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] bandwidth 50
bind interface
Use bind interface to bind a VFC interface to an Ethernet interface. Ethernet interfaces in this command refer to Layer 2 Ethernet interfaces and Layer 2 aggregate interfaces.
Use undo bind interface to delete a VFC-to-Ethernet interface binding.
Syntax
bind interface interface-type interface-number [ mac mac-address ]
undo bind interface
Default
A VFC interface is not bound to any Ethernet interfaces.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
interface-type interface-number: Specifies an interface by its type and number. The interface type can be one of the following:
· Layer 2 Ethernet interface.
· Layer 2 aggregate interface.
mac mac-address: Specifies the peer FCoE MAC address, six bytes in the format of XXXX-XXXX-XXXX.
To make a VFC interface work, bind it to a physical Ethernet interface. The VFC interface then sends and receives packets through the Ethernet interface.
To use one physical link to carry multiple VFC interfaces, you must bind these VFC interfaces to different peer FCoE MAC addresses. However, you can bind them to one Ethernet interface. The FCoE MAC address identifies the device that communicates with a VFC interface. For a point-to-multipoint network, the FCoE MAC address is required. For a point-to-point network, the FCoE MAC address is optional.
You can use the display fcoe command to display the FCoE MAC address of a switch. You can display the FCoE MAC address of an ENode through some software or the NMS.
A VFC interface can be bound to only one Ethernet interface and to only one FCoE MAC address.
An Ethernet interface can be bound to multiple VFC interfaces, but an FCoE MAC address can be bound to only one VFC interface.
To successfully bind a VFC interface to a Layer 2 Ethernet interface, make sure the Layer 2 Ethernet interface is FCoE capable.
When you bind a VFC interface to a Layer 2 aggregate interface, follow these restrictions and guidelines:
· To successfully bind a VFC interface to a Layer 2 aggregate interface, make sure all member ports of the Layer 2 aggregate interface are FCoE capable. Also, make sure new member ports of the Layer 2 aggregate interface are FCoE capable.
· The binding to a Layer 2 aggregate interface does not take effect when you perform the following tasks:
¡ Bind one VFC interface to a Layer 2 aggregate interface.
¡ Bind another VFC interface to a Layer 2 Ethernet interface that is a member port of the Layer 2 aggregate interface.
Examples
# Bind interface VFC 4 to interface FortyGigE 1/0/1 and FCoE MAC address 000c-2999-eacd.
<Sysname> system-view
[Sysname] interface vfc 4
[Sysname-Vfc4] bind interface fortygige 1/0/1 mac 000c-2999-eacd
# Bind interface VFC 5 to interface Bridge-aggregation 1 and FCoE MAC address 000c-2888-eacd.
<Sysname> system-view
[Sysname] interface vfc 5
[Sysname-Vfc5] bind interface bridge-aggregation 1 mac 000c-2888-eacd
· display fcoe
· display interface vfc
default
Use default to restore the default settings for a VFC interface.
Syntax
default
Views
VFC interface view
Predefined user roles
network-admin
mdc-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 interface VFC 1.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] default
This command will restore the default settings. Continue? [Y/N]:y
description
Use description to set a description for a VFC interface.
Use undo description to restore the default.
Syntax
description text
undo description
Default
The description of a VFC interface is interface name Interface, for example, Vfc 1 Interface.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
text: Specifies an interface description, a case-sensitive string of 1 to 255 characters.
Usage guidelines
The description helps users identify the role of an interface.
Examples
# Set the description to Vfcport1 for interface VFC 1.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] description Vfcport1
Related commands
display interface vfc
display interface vfc
Use display interface vfc to display VFC interface information.
Syntax
display interface [ vfc [ interface-number ] ] [ brief [ description | down ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface-number: Specifies a VFC interface by its number in the range of 1 to 1024.
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.
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.
Usage guidelines
If you do not specify the vfc keyword, this command displays information about all interfaces supported by the switch.
If you specify the vfc keyword, this command displays information about all VFC interfaces.
If you specify a VFC interface, this command displays information about the specified VFC interface.
Examples
# Display detailed information about interface VFC 1.
<Sysname> display interface vfc 1
Vfc1
Current state: UP
Line protocol state: UP
Description: Vfc1 Interface
Bandwidth: 10000000kbps
Maximum Transmit Unit: 2112
Internet protocol processing: Disabled
Link layer protocol is FC
Port WWN is 66:66:66:63:66:64:61:30
FC mode is E, state is E
Support the VSAN protocol
VSAN tagging mode is Tagging
EVFP common VSAN: 1
Bound interface is FortyGigE1/0/1, Bound MAC is 000c-2933-eacd
VSAN of physical-UP state: 1
Last clearing of counters: Never
Table 1 Command output
Field |
Description |
Current state |
Physical state and administrative state of the VFC interface: · DOWN (Administratively)—The interface is administratively shut down by using the shutdown command. · DOWN—The interface is administratively up but physically down. · UP—The interface is up both administratively and physically. |
Line protocol state |
Link layer protocol state of the VFC interface: DOWN or UP. |
Bandwidth |
Expected bandwidth of the VFC interface. |
Internet protocol processing |
IP packet processing capability. If the VFC interface is not assigned an IP address, this field displays Disabled. |
FC mode |
Mode of the VFC interface. |
state |
Operating mode of the VFC interface through negotiation. |
Support the VSAN protocol |
Indicates the VFC interface supports the VSAN protocol. |
VSAN tagging mode |
Link type of the interface: Trunk (Tagging) or Access (Non tagging). VFC interfaces support only Tagging. |
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. |
Bound interface |
Physical interface bound to the VFC interface. |
Bound MAC |
FCoE MAC address bound to the VFC interface. |
VSAN of physical-UP state |
List of VSANs that are physically up. |
Last clearing of counters |
Time when the interface statistics were last cleared by using the reset counters interface command. Never indicates that the interface statistics have never been cleared since switch startup. |
# Display brief information about interface VFC 1.
<Sysname> display interface vfc 1 brief
Brief information on VFC 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 Admin Admin Oper Status Bind
Mode Trunk Mode Interface
Mode
Vfc1 F on TF UP FGE1/0/1 0102-0304-0506
Table 2 Command output
Field |
Description |
Interface |
Name of the VFC interface. |
Admin Mode |
User-configured VFC interface mode: · E. · F. |
Admin Trunk Mode |
User-configured trunk mode for the VFC interface: on. |
Oper Mode |
Negotiated mode (link layer negotiation) in which the VFC interface is operating: · E—The VFC interface is operating in E mode as an access port. · F—The VFC interface is operating in F mode as an access port. · TE—The VFC interface is operating in E mode as a trunk port. · TF—The VFC interface is operating in F mode as a trunk port. If negotiation is not initiated or fails, this field displays two hyphens (--). |
Status |
Negotiated state (link layer negotiation) for the VFC interface: · UP. · DOWN. |
Ethernet interface and FCoE MAC address bound to the VFC interface. This field is empty when the VFC interface does not have bound Ethernet interface and FCoE MAC address. |
# Display the descriptions of VFC interfaces.
<sysname> display interface vfc brief description
Brief information on VFC interface(s):
Interface Description
Vfc1 Vfc1 Interface
Vfc2 Vfc2 Interface
# Display information about and the causes of the VFC interfaces in physically down state.
<Sysname> display interface vfc brief down
Brief information on interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
Vfc1 ADM Administratively
Table 3 Command output
Field |
Description |
Brief information on interface(s) under bridge mode |
Brief information about Layer 2 interfaces. |
Link: ADM - administratively down; Stby - standby |
Link status: · ADM—The interface has been shut down by the network administrator. To bring up the interface, execute the undo shutdown command. · Stby—The interface is a standby interface. |
Interface |
Interface name. |
Link |
Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been administratively shut down. To bring up the interface, execute the undo shutdown command. · Stby—The interface is a standby interface. |
Cause |
Causes for the physical state of the VFC interface to be Down: · Not connected—Physical connections do not exist (possibly because the network cable is disconnected or faulty). · Administratively—The interface was shut down by using the shutdown command. To bring up the interface, use the undo shutdown command. |
fc mode (VFC interface view)
Use fc mode to set the mode of a VFC interface.
Use undo fc mode to restore the default.
Syntax
fc mode { e | f }
undo fc mode
Default
The mode of a VFC interface is F.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
e: Specifies the E mode.
f: Specifies the F mode.
Examples
# Set the mode to E for interface VFC 1.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fc mode e
interface vfc
Use interface vfc to create a VFC interface and enter its view. If the VFC interface already exists, this command leads you to VFC interface view directly.
Use undo interface vfc to delete a VFC interface.
Syntax
interface vfc interface-number
undo interface vfc interface-number
Default
No VFC interface exists.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interface-number: Specifies the number of the VFC interface, in the range of 1 to 1024.
Usage guidelines
A VFC interface is a logical interface manually created on the FCF switch to simulate the functionality of a physical FC interface.
Examples
# Create interface VFC 1 and enter its view.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1]
Related commands
display interface vfc
reset counters interface
Use reset counters interface to clear statistics for VFC interfaces.
Syntax
reset counters interface [ vfc [ number ] ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
number: Specifies a VFC interface by its number in the range of 1 to 1024.
Usage guidelines
Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.
If you do not specify the vfc keyword, this command clears statistics for all interfaces.
If you specify the vfc keyword, this command clears statistics for all VFC interfaces.
If you specify a VFC interface, this command clears statistics for the specified VFC interface.
Examples
# Clear statistics for interface VFC 1.
<Sysname> reset counters interface vfc 1
Related commands
display interface vfc
shutdown
Use shutdown to shut down a VFC interface.
Use undo shutdown to bring up a VFC interface.
Syntax
shutdown
undo shutdown
Default
A VFC interface is up.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Examples
# Bring up interface VFC 1.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] undo shutdown
FCoE commands
display fcoe
Use display fcoe to display global FCoE configuration.
Syntax
display fcoe
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display global FCoE configuration.
<Sysname> display fcoe
FCoE MAC : 0000-1234-0202
FC-MAP : 0efc25
FCF Priority: 128
FKA period : 8 seconds
Table 4 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 FCoE in a VLAN and map the VLAN to a VSAN.
Use undo fcoe enable to disable FCoE in a VLAN.
Syntax
fcoe enable [ vsan vsan-id ]
undo fcoe enable
Default
FCoE is disabled in a VLAN.
Views
VLAN view
Predefined user roles
network-admin
mdc-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.
Usage guidelines
FCoE cannot be enabled in VLAN 1.
Do not enable FCoE in a reserved VLAN. If you enable FCoE in a reserved VLAN, the VFC interfaces assigned to the mapped VSAN as trunk ports cannot come up. For more information about reserved VLANs, see Layer 2—LAN Switching Command Reference.
VSANs are mapped to VLANs on a one-to-one basis.
An FCoE-capable VLAN allows only FCoE traffic. All member ports in an FCoE-capable VLAN are isolated and will not form loops. To prevent FCoE links from being blocked, do not enable STP or other loop detection protocols in an FCoE-enabled VLAN. A Layer 2 protocol enabled in an FCoE-capable VLAN runs based on the topology where all member ports in the FCoE-capable VLAN are isolated at Layer 2.
When you use a VFC interface to transmit packets, the Ethernet interface bound to the VFC interface might allow multiple VLANs. You must enable FCoE in the same VLAN and map the VLAN to the same VSAN on both ends. Then, the packets from the VSAN are tagged with the VLAN tag and transmitted within the VLAN.
Examples
# Enable FCoE in VLAN 4 and map VLAN 4 to VSAN 6.
<Sysname> system-view
[Sysname] vlan 4
[Sysname-vlan4] fcoe enable vsan 6
fcoe fcf-priority
Use fcoe fcf-priority to set the FCF priority for a VFC interface.
Use undo fcoe fcf-priority to restore the default.
Syntax
fcoe fcf-priority priority
undo fcoe fcf-priority
Default
The FCF priority of a VFC interface is 128.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
priority: Specifies the FCF priority for the VFC interface, in the range of 0 to 255. The smaller the value, the higher the priority.
Usage guidelines
This command takes effect on only VFC interfaces operating in F mode. You can configure this command on VFC interfaces operating in E mode, but it does not take effect.
The VFC interface FCF priority is used in the fcf priority field in an unsolicited Discovery Advertisement.
An ENode selects the FCF switch with the highest priority from the FCF switches sending Discovery Advertisements and sends a FLOGI request to it for login.
Examples
# Set the FCF priority to 12 for interface VFC 1.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fcoe fcf-priority 12
fcoe fcmap
Use fcoe fcmap to set an FC-MAP value.
Use undo fcoe fcmap to restore the default.
Syntax
fcoe fcmap fc-map
undo fcoe fcmap
Default
The FC-MAP value is 0x0EFC00.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
fc-map: Specifies an FC-MAP value in the range of 0x0EFC00 to 0x0EFCFF.
Usage guidelines
An FC-MAP value identifies an FCoE network. Switches in the same FCoE network must have the same FC-MAP value.
After an FC-MAP value is set, VFC interfaces perform an FIP renegotiation.
Examples
# Set the FC-MAP value to 0x0EFCFF.
<Sysname> system-view
[Sysname] fcoe fcmap 0efcff
Changing the FC-MAP will flap all VFC interfaces. Continue? [Y/N]:
fcoe fka-adv-period
Use fcoe fka-adv-period to set an FKA advertisement interval.
Use undo fcoe fka-adv-period to restore the default.
Syntax
fcoe fka-adv-period fka-adv-period
undo fcoe fka-adv-period
Default
The FKA advertisement interval is 8 seconds.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
fka-adv-period: Specifies an FKA advertisement interval value in the range of 4 to 600 seconds.
Usage guidelines
The FKA advertisement interval determines the length of time the switch takes to detect the disconnection of a virtual link.
A switch uses the following process to maintain the virtual link established with a peer switch:
1. The switch sends unsolicited Discovery Advertisements every FKA advertisement interval out of its VFC interfaces in E mode.
The FKA advertisement interval value is carried in unsolicited Discovery Advertisements.
2. After receiving an unsolicited Discovery Advertisement, the peer switch maintains the status of the virtual link and records the FKA advertisement interval value.
If the peer switch fails to receive an unsolicited Discovery Advertisement within 2.5 FKA advertisement intervals, it deletes the virtual link.
A switch uses the following process to maintain the virtual link established with a peer ENode:
3. The switch sends unsolicited Discovery Advertisements every FKA advertisement interval out of its VFC interfaces in F mode.
The FKA advertisement interval value is carried in unsolicited Discovery Advertisements.
4. After receiving an unsolicited Discovery Advertisement, the peer ENode maintains the status of the virtual link and records the FKA advertisement interval value.
If the peer ENode fails to receive an unsolicited Discovery Advertisement within 2.5 FKA advertisement intervals, it deletes the virtual link.
In addition, the ENode sends keepalive frames to the switch every FKA advertisement interval value. This value is obtained from unsolicited Discovery Advertisements received from the switch. After receiving a keepalive frame, the switch maintains the status of the virtual link. If the switch fails to receive a keepalive frame within 2.5 FKA advertisement intervals, it deletes the virtual link.
When setting the FKA advertisement interval value on an FCF switch, use Table 5 as a reference to avoid service disruption.
Table 5 Recommended values for different application scenarios
Recommended value |
Application scenarios |
Remarks |
Less than 90 seconds |
Connected to servers, storage devices, or third-party switches. |
According to FC-BB-5, the upper limit of the FKA advertisement interval value is 90 seconds. In this scenario, a single-MPU FCF switch will experience FCoE traffic disruption during an ISSU reboot for the following reasons: · The ISSU reboot takes more than 225 (2.5*90) seconds. · The peer deletes the virtual link for failing to receive unsolicited Discovery Advertisements within 225 seconds. |
60–90 seconds |
Active/standby switchover on the switch takes more than 2.5 x 60 seconds because of the amount of FCoE configuration. ISSU reboot on a dual-MPU switch takes more than 2.5 x 60 seconds because of the amount of FCoE configuration. |
For more information about ISSU, see Fundamentals Configuration Guide. |
300–600 seconds |
ISSU reboot on a single-MPU switch to which no nodes are attached. |
During an ISSU reboot on a single-MPU switch, the switch cannot send unsolicited Discovery Advertisements or keepalive frames. |
Examples
# Set the FKA advertisement interval to 20 seconds.
<Sysname> system-view
[Sysname] fcoe fka-adv-period 20
fcoe global fcf-priority
Use fcoe global fcf-priority to set the system FCF priority.
Use undo fcoe global fcf-priority to restore the default.
Syntax
fcoe global fcf-priority priority
undo fcoe global fcf-priority
Default
The system FCF priority is 128.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
priority: Specifies the system FCF priority in the range of 0 to 255. The smaller the value, the higher the priority.
Usage guidelines
This command takes effect on all VFC interfaces operating in F mode.
The system FCF priority is used in the fcf priority field in an unsolicited Discovery Advertisement.
An ENode selects the FCF switch with the highest priority from the FCF switches sending Discovery Advertisements and sends a FLOGI request to it for login.
Examples
# Set the system FCF priority to 12.
<Sysname> system-view
[Sysname] fcoe global fcf-priority 12
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
mdc-admin
mdc-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:
Trunk Ports:
Vfc1
VSAN 2:
Access Ports:
Trunk Ports:
Vfc4
VSAN 10:
Access Ports:
Trunk Ports:
VSAN 100:
Access Ports:
Trunk Ports:
Vfc4 Vfc5 Vfc6
port trunk vsan
Use port trunk vsan to assign a VFC interface to a list of VSANs as a trunk port.
Use undo port trunk vsan to remove a VFC interface from a list of VSANs as a trunk port.
Syntax
port trunk vsan vsan-id-list
undo port trunk vsan vsan-id-list
Default
A VFC interface is not assigned to any VSANs as a trunk port.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
vsan-id-list: Specifies a space-separated list of up to 10 VSAN items. Each item specifies a VSAN or a range of VSANs in the form of vsan-id1 to vsan-id2. The value for vsan-id2 must be greater than or equal to the value for vsan-id1.
Examples
# Assign interface VFC 1 to VSANs 1, 2, 10, and 20 through 100.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] port trunk vsan 1 to 2 10 20 to 100
vsan
Use vsan to create a VSAN and enter VSAN view. If the VSAN already exists, this command directly leads you to VSAN view.
Use undo vsan to delete a VSAN.
Syntax
vsan vsan-id
undo vsan vsan-id
Default
Only the default VSAN (VSAN 1) exists.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.
Usage guidelines
You cannot create or delete VSAN 1, because it is the system-default VSAN. You can create VSANs 2 to 3839.
The maximum number of VSANs (including VSAN 1) that can be created is 256.
Examples
# Create VSAN 10 and enter its view.
<Sysname> system-view
[Sysname] vsan 10
[Sysname-vsan10]
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 restore the default.
Syntax
allowed-domain-id domain-id-list
undo allowed-domain-id domain-id-list
Default
The allowed domain ID list includes domain IDs 1 to 239.
Views
VSAN view
Predefined user roles
network-admin
mdc-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 form 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
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 for 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 of a VSAN.
Syntax
display fc domain [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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 of all VSANs.
Usage guidelines
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 of 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 Vfc1
Downstream Vfc2
Downstream Vfc4
Table 6 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 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 VFC interface. |
display fc domain-list
Use display fc domain-list to display the list of domain IDs dynamically assigned in a VSAN.
Syntax
display fc domain-list [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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.
Usage guidelines
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 7 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
mdc-admin
mdc-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 of all VSANs.
Examples
# Display the ESS negotiation result in VSAN 2.
<Sysname> display fc ess vsan 2
ESS info of VSAN 2:
Domain: 210
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 8 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. |
display fc login
Use display fc login to display the node login information of VSANs.
Syntax
display fc login [ vsan vsan-id ] [ count ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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 of all VSANs.
count: Displays the total number of logged-in nodes.
Examples
# Display the node login information of VSAN 1.
<Sysname> display fc login vsan 1
Interface VSAN FCID Node WWN Port WWN
Vfc1 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 9 Command output
Field |
Description |
Interface |
Interface on the switch connected to the node. |
VSAN |
VSAN ID. |
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 server database.
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
mdc-admin
mdc-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 server database information of all VSANs.
fcid fcid: Specifies an FC address in the range of 0x010000 to 0xEFFFFF (hexadecimal). If you do not specify an FC address, this command displays the name server database 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 server database.
count: Displays the number of name service entries.
Examples
# Display brief information about the name server database in 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
Table 10 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, and NPV. · Feature—Includes supporting Initiator, Target, or Initiator/Target. |
# 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:6
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.6.171
FC4-types(FC4_features): NPV
Symbolic-port-name: NPV-Sysname:Vfc1
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 11 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, and NPV. · Feature—Includes supporting Initiator, Target, or Initiator/Target. |
Symbolic-port-name |
Symbolic name, which is used for describing the N_Port. |
Symbolic-node-name |
Symbolic name, which is used for describing the node. |
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.
Syntax
display fc scr-table [ vsan vsan-id ] [ count ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vsan vsan-id: Displays the SCR list in the specified VSAN. The vsan-id argument is in the range of 1 to 3839. If you do not specify a VSAN, this command displays the SCR lists of all VSANs.
count: Displays the number of SCR entries.
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
--- Total 2 entries ---
# Display the number of SCR entries.
<Sysname> display fc scr-table vsan 1 count
Total entries: 2
Table 12 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: · 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. · full detected 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 switch WWN.
Syntax
display fc switch-wwn
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display the 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
mdc-admin
mdc-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
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
mdc-admin
Usage guidelines
This command takes effect only when the fabric configuration feature is enabled.
A fabric reconfiguration triggers a principal switch selection process.
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
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
mdc-admin
Usage guidelines
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 configure 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
mdc-admin
Parameters
disruptive: Initiates a disruptive reconfiguration. If you do not specify this keyword, the command initiates a nondisruptive reconfiguration.
Usage guidelines
This command takes effect only when the fabric configuration feature is enabled.
A fabric reconfiguration triggers a principal switch selection process.
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, and data transmission in the fabric is disrupted.
· 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 configure a domain ID for the switch 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
mdc-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
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 switches. 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
Non-disruptive reconfiguration or isolating the switch may be performed. Continue? [Y/N]:
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
mdc-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
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 in a VSAN on all switches in the fabric. 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 a VFC interface to reject the RCF requests received in a VSAN.
Use undo fc domain rcf-reject to restore the default.
Syntax
fc domain rcf-reject vsan vsan-id
undo fc domain rcf-reject vsan vsan-id
Default
A VFC interface does not reject the RCF requests received in a VSAN.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.
Usage guidelines
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 VFC interface.
Examples
# Configure interface VFC 1 to reject the RCF requests received in VSAN 1.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fc domain rcf-reject vsan 1
fc name-service auto-discovery
Use fc name-service auto-discovery to enable SCSI-FCP information autodiscovery in a VSAN.
Use undo fc name-service auto-discovery to disable SCSI-FCP information autodiscovery in a VSAN.
Syntax
fc name-service auto-discovery
undo fc name-service auto-discovery
Default
SCSI-FCP information autodiscovery is enabled in a VSAN.
Views
VSAN view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
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 feature enables the switch to automatically obtain SCSI-FCP support and the Feature value by sending a PRLI packet to the node that is logging in. Then, the switch stores the SCSI-FCP information in the name service database.
|
NOTE: After this feature is enabled, 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-server 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
mdc-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
mdc-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
mdc-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.
Views
System view
Predefined user roles
network-admin
mdc-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
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 configure only one combination of FC4-Type and Feature at a time.
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
priority
Use priority to set the switch priority in a VSAN.
Use undo priority to restore the default.
Syntax
priority value
undo priority
Default
The switch priority is 128 in a VSAN.
Views
VSAN view
Predefined user roles
network-admin
mdc-admin
Parameters
value: Specifies the switch priority in the range of 1 to 254. A smaller value indicates a higher priority.
Usage guidelines
The priority is set on a per-VSAN basis, and one FCF switch can have different priorities in different VSANs. The FCF switch with the highest priority in a VSAN will become the principal switch in that VSAN.
To make the switch 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
rscn aggregation enable
Use rscn aggregation enable to enable RSCN aggregation in a VSAN.
Use undo rscn aggregation enable to disable RSCN aggregation in a VSAN.
Syntax
rscn aggregation enable
undo rscn aggregation enable
Default
RSCN aggregation is disabled in a VSAN.
Views
VSAN view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
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
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 time
undo rscn aggregation timer
Default
The RSCN aggregation timer is 2000 milliseconds.
Views
VSAN view
Predefined user roles
network-admin
mdc-admin
Parameters
time: Specifies the RSCN aggregation timer value in the range of 100 to 2000 milliseconds.
Usage guidelines
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 to 1500 milliseconds for VSAN 1.
<Sysname> system-view
[Sysname] vsan 1
[Sysname-vsan1] rscn aggregation timer 1500
Related commands
rscn aggregation enable
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
mdc-admin
Parameters
domain-id-change: Specifies domain ID changes.
fabric-change: Specifies fabric changes.
Usage guidelines
If you do not specify any keywords, 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.
Generated notifications are sent to the SNMP module. For more information about SNMP notifications, see Network Management and Monitoring Configuration Guide.
Examples
# Enable SNMP notifications for domain ID changes.
[Sysname] snmp-agent trap enable fc-fabric domain-id-change
# Enable SNMP notifications for fabric changes.
<Sysname> system-view
[Sysname] snmp-agent trap enable fc-fabric fabric-change
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
mdc-admin
Parameters
login: Specifies node login.
logout: Specifies node logout.
Usage guidelines
If you do not specify any keywords, 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.
Generated notifications are sent to the SNMP module. For more information about SNMP notifications, see Network Management and Monitoring Configuration Guide.
Examples
# Enable SNMP notifications for node login.
<Sysname> system-view
[Sysname] snmp-agent trap enable fc-name-service login
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.
Views
VSAN view
Predefined user roles
network-admin
mdc-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.
Views
VSAN view
Predefined user roles
network-admin
mdc-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.
Views
VSAN view
Predefined user roles
network-admin
mdc-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 area-port-id
Use wwn area-port-id to bind the WWN of an N_Port to an FC address in a VSAN.
Use undo wwn area-port-id to delete a WWN-to-FC address binding.
Syntax
wwn wwn-value area-port-id area-port-id-value
undo wwn wwn-value area-port-id
Default
The WWN of an N_Port is not bound to any FC address.
Views
VSAN view
Predefined user roles
network-admin
mdc-admin
Parameters
wwn-value: Specifies the WWN of the N_Port, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal number.
area-port-id-value: Specifies the area ID and port ID in the format of xxxx, where x is a hexadecimal number. The first two digits indicate the area ID, and the last two digits indicate the port ID.
Usage guidelines
The switch assigns the FC address bound to an N_Port when the N_Port requests an FC address. However, if the N_Port has been assigned another FC address or the FC address has been assigned to another N_Port, the binding fails.
The WWN of an N_Port can be bound to only one FC address and vice versa.
Examples
# In VSAN 1, bind the N_Port (WWN is 33:e8:00:05:30:00:16:df) to an FC address (area ID is ab and port ID is 12).
<Sysname> system-view
[Sysname] vsan 1
[Sysname-vsan1] wwn 33:e8:00:05:30:00:16:df area-port-id ab12
FC routing and forwarding commands
display fc exchange
Use display fc exchange to display the FC exchange entries.
Syntax
In standalone mode:
display fc exchange { link | protocol } [ slot slot-number ]
display fc exchange link verbose [ slot slot-number [ exid exid ] ]
In IRF mode:
display fc exchange { link | protocol } [ chassis chassis-number slot slot-number ]
display fc exchange link verbose [ chassis chassis-number slot slot-number [ exid exid ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
link: Displays link exchange entries.
protocol: Displays 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. If you do not specify an exchange ID, this command displays all link exchange entries.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays exchange entries for the MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays exchange entries for the global active MPU. (In IRF mode.)
Usage guidelines
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 to monitor connection establishment.
· Link exchange—Created at both ends based on the exchange ID and used for packet exchange.
Examples
# (In standalone mode.) Display the protocol exchange entries.
<Sysname> display fc exchange protocol slot 1
Local_ID:EXID Remote_ID:EXID State Slot Protocol
0x000000:65535 0x000000:65535 LISTEN 1 6
# (In IRF mode.) Display the protocol exchange entries.
<Sysname> display fc exchange protocol chassis 1 slot 2
Local_ID:EXID Remote_ID:EXID State Chassis Slot Protocol
0x000000:65535 0x000000:65535 LISTEN 1 2 13
# (In standalone mode.) Display the link exchange entries.
<Sysname> display fc exchange link slot 2
Local_ID:EXID Remote_ID:EXID State Slot Protocol
0x060501:1024 0x010001:1025 ESTABLISHED 2 8
# (In IRF mode.) Display the link exchange entries.
<Sysname> display fc exchange link chassis 3 slot 5
Local_ID:EXID Remote_ID:EXID State Chassis Slot Protocol
0x060501:1024 0x010001:1025 ESTABLISHED 3 5 11
# Display detailed information about the link exchange entries.
<Sysname> display fc exchange link verbose slot 1
slot: 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 13 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
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
fcid: Specifies a destination FC address in the range of 0x000000 to 0xFFFFFF (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
The switch looks up the VSAN ID and FC address in the FC FIB for the outgoing interface.
If you specify both a destination FC address and the mask length, this command displays FC FIB entries for the specified FC address and mask length.
If you specify only a destination FC address, this command displays FC FIB entries for the specified FC address according to the longest matching rule.
If you do not specify a destination FC address or the mask length, 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 Vfc1
0x030100/16 Vfc2
0x030100/24 Vfc3
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 Vfc3
# 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 Vfc1
0x030100/16 Vfc2
Table 14 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 ]
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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 static FC routes, in the range of 0x010000 to 0xFFFFFF (hexadecimal).
mask: Specifies a hexadecimal mask for the FC address. This argument is used together with the fcid argument. The value of this argument can be 0xFF0000, 0xFFFF00, or 0xFFFFFF. 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 the mask length for 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 the mask length, this command displays the routing information for the FC address fcid with mask length values 8, 16, and 24.
statistics: Displays the statistics for the FC routing table.
verbose: Displays detailed information about the FC routing table.
Usage guidelines
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.
If you 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 Vfc10
0x040000/8 FSPF 20 100 Vfc20
0x040000/8 FSPF 20 100 Vfc30
0x040000/8 FSPF 20 100 Vfc40
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: Vfc1
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 15 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 16 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
mdc-admin
mdc-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.
Usage guidelines
The SPF GR status information includes the following details:
· 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 switch.
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 17 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
mdc-admin
mdc-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.
Usage guidelines
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 18 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
mdc-admin
mdc-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.
Usage guidelines
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
Vfc1 2 0x68 0x68 00:01:06 Full
Table 19 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
mdc-admin
mdc-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.
Usage guidelines
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 Vfc1 statistics:
Type Input Output
HELLO 50 50
LSU 5 5
LSA 4 4
Table 20 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 route exists.
Views
VSAN view
Predefined user roles
network-admin
mdc-admin
Parameters
fcid: Specifies the destination FC address of the static FC route, in the range of 0x010000 to 0xFFFFFF (hexadecimal).
mask: Specifies a hexadecimal mask for the FC address. This argument is used together with the fcid argument. The value of this argument can only be 0xFF0000.
mask-length: Specifies the mask length for the FC address. This argument is used together with the fcid argument. The value of this argument can only be 8.
interface-type interface-number: Specifies the outgoing interface of the static FC route, which must be an existing VFC 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.
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 with the following parameters:
· The destination FC address is 0x010000.
· The mask length is 8.
· The outgoing interface is VFC 4.
· The cost is 20.
<Sysname> system-view
[Sysname] vsan 5
[Sysname-vsan5] fc route-static 010000 8 vfc 4 cost 20
Related commands
display fc routing-table
fspf cost
Use fspf cost to set the FSPF cost for a VFC interface in a VSAN.
Use undo fspf cost to restore the default.
Syntax
fspf cost value vsan vsan-id
undo fspf cost vsan vsan-id
Default
The FSPF cost for a VFC interface in a VSAN is 100.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
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
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 interface VFC 1 in VSAN 4.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fspf cost 1000 vsan 4
fspf dead-interval
Use fspf dead-interval to set the dead interval for a VFC interface in a VSAN.
Use undo fspf dead-interval to restore the default.
Syntax
fspf dead-interval value vsan vsan-id
undo fspf dead-interval vsan vsan-id
Default
The dead interval for a VFC interface in a VSAN is 80 seconds.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
value: 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
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 interface VFC 1 in VSAN 4.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] 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 after a VSAN is created.
Views
VSAN view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
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
mdc-admin
Usage guidelines
FSPF graceful restart (GR) ensures nonstop forwarding of traffic by backing up FSPF configuration information in one of the following situations:
· A protocol restart (for example, the FSPF process restart triggered by the process command).
· An 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
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
mdc-admin
Usage guidelines
The switch can assist the GR restarter in completing the GR process only after FSPF GR helper is enabled on the switch.
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-value
undo fspf graceful-restart interval
Default
The maximum FSPF GR interval is 120 seconds.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interval-value: Specifies the maximum FSPF GR interval in the range of 40 to 1800 seconds.
Usage guidelines
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 a VFC interface in a VSAN.
Use undo fspf hello-interval to restore the default.
Syntax
fspf hello-interval value vsan vsan-id
undo fspf hello-interval vsan vsan-id
Default
The hello interval for a VFC interface in a VSAN is 20 seconds.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
value: 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
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 a link.
Examples
# Set the hello interval to 10 seconds for interface VFC 1 in VSAN 4.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] 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
mdc-admin
Parameters
value: Specifies the minimum LSR arrival interval in the range of 0 to 60 seconds.
Usage guidelines
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 value
undo fspf min-ls-interval
Default
The minimum LSR refresh interval for a VSAN is 5 seconds.
Views
VSAN view
Predefined user roles
network-admin
mdc-admin
Parameters
value: Specifies the minimum LSR refresh interval in the range of 1 to 60 seconds.
Usage guidelines
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 cannot 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 a VFC interface in a VSAN.
Use undo fspf retransmit-interval to restore the default.
Syntax
fspf retransmit-interval value vsan vsan-id
undo fspf retransmit-interval vsan vsan-id
Default
The LSR retransmission interval for a VFC interface in a VSAN is 5 seconds.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
value: 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
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 interface VFC 1 in VSAN 4.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fspf retransmit-interval 10 vsan 4
fspf silent
Use fspf silent to disable FSPF for a VFC interface in a VSAN.
Use undo fspf silent to enable FSPF for a VFC interface in a VSAN.
Syntax
fspf silent vsan vsan-id
undo fspf silent vsan vsan-id
Default
FSPF is enabled on a VFC interface in a VSAN.
Views
VFC interface view
Predefined user roles
network-admin
mdc-admin
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.
Usage guidelines
With FSPF enabled, a VFC interface can participate in the SPF calculation. To avoid SPF calculations on an interface, disable FSPF on the interface.
Examples
# Disable FSPF for interface VFC 1 in VSAN 4.
<Sysname> system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fspf silent vsan 4
fspf spf-hold-time
Use fspf spf-hold-time to set the shortest SPF calculation interval in 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
mdc-admin
Parameters
value: Specifies the shortest SPF calculation interval in the range of 0 to 60 seconds.
Usage guidelines
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 in 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
mdc-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.
Examples
# Clear FSPF statistics for 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
mdc-admin
Usage guidelines
You can delete the zone database for the specified VSAN, including all zone sets, zones, and zone aliases, but not the active zone set.
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]:
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
mdc-admin
mdc-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 characters (see Table 21). It must start with a letter.
Table 21 Special characters
Field |
Description |
Caret |
^ |
Dollar sign |
$ |
Minus sign |
- |
Underscore |
_ |
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.
Usage guidelines
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
VSAN 2:
VSAN 3:
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 the 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
mdc-admin
mdc-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 characters (see Table 21). 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.
Usage guidelines
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 a zone alias named za1 in VSAN 1.
<Sysname> display zone member zone-alias za1 vsan 1
zone-alias za1
VSAN 1:
zone z1
zone z2
Table 23 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 zone packet statistics.
Syntax
display zone statistics [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
mdc-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 zone packet statistics for all VSANs.
Examples
# Display zone packet statistics for VSAN 2.
<Sysname>display zone statistics vsan 2
Zone statistics of 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 24 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
mdc-admin
mdc-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 in all VSANs.
Usage guidelines
The zoning configuration and status include the following information:
· Zoning mode.
· Default zone policy.
· Distribution and merge type.
· 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 25 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. |
Indicates whether hard zoning is enabled or disabled: · 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—Zone merge is in progress. · distributing—Zone distribution is in progress. · Free—Neither zone merge nor zone distribution is in progress. |
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
mdc-admin
mdc-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 characters (see Table 21). It must start with a letter.
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.
Usage guidelines
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 26 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 the 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
mdc-admin
mdc-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 characters (see Table 21). It must start with a letter.
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.
Usage guidelines
If you specify both a zone set and a VSAN, this command displays information about the specified zoneset in the specified VSAN.
If you specify only a VSAN, this command displays information about all zonesets 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 27 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
mdc-admin
mdc-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 in all VSANs.
Usage guidelines
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 11:11:11:11:11:11:11:11]
zone name z2
*fcid 0x111111 [pwwn 11:11:11:11:11:11:11:11]
pwwn 11:11:11:11:11:11:11:12
*fcid 0x333333 [pwwn 33:33:33:33:33:33:33:33]
zone name #default-zone#
*fcid 0x20abcd
*fcid 0xabcdef
VSAN 2:
VSAN 3:
zoneset name zs1
zone name z1
fcid 0x123456
*fcid 0x111111 [pwwn 11:11:11:11:11:11:11:11]
pwwn 11:11:11:11:11:11:11:12
*fcid 0x333333 [pwwn 33:33:33:33:33:33:33:33]
*fcid 0x222221 [fwwn 22:22:22:22:22:22:22:22]
*fcid 0x222222 [fwwn 22:22:22:22:22:22:22:22]
*fcid 0x222223 [fwwn 22:22:22:22:22:22:22:22]
fwwn aa:bb:cc:dd:ee:ff:00:11
# Display information about the active zoneset in VSAN 1.
<Sysname> display zoneset active vsan 1
VSAN 1:
zoneset name zs1
zone name z1
*fcid 0x222222
*fcid 0x111111 [pwwn 11:11:11:11:11:11:11:11]
zone name z2
fcid 0x123456
*fcid 0x111111 [pwwn 11:11:11:11:11:11:11:11]
pwwn 11:11:11:11:11:11:11:12
*fcid 0x333333 [pwwn 33:33:33:33:33:33:33:33]
zone name #default_zone#
*fcid 0x20abcd
*fcid 0xabcdef
Table 28 Command output
Field |
Description |
*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 view)
Use member to add a member to a zone.
Use undo member to remove 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 member exists in a new zone.
Views
Zone view
Predefined user roles
network-admin
mdc-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 characters (see Table 21). It must start with a letter.
Usage guidelines
You can also use this command to change the role (initiator, target, or both) 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.
The role of a member can be configured only in enhanced zoning mode and takes effect only when the Pairwise feature is enabled.
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
· zone name
· zone-alias name
member (zone alias view)
Use member to add a member to a zone alias.
Use undo member to remove 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 member exists in a new zone alias.
Views
Zone alias view
Predefined user roles
network-admin
mdc-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
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.
The role of a member can be configured only in enhanced zoning mode and takes effect only when the Pairwise feature is enabled.
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
· 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 zone exists in a zone set.
Views
Zone set view
Predefined user roles
network-admin
mdc-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 characters (see Table 21). It must start with a letter.
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] 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
pairwise-zoning enable
Use pairwise-zoning enable to enable the Pairwise feature for a zone.
Use undo pairwise-zoning enable to restore the default.
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
mdc-admin
Usage guidelines
This feature is supported 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)
reset zone statistics
Use reset zone statistics to clear zone packet statistics.
Syntax
reset zone statistics [ vsan vsan-id ]
Views
User view
Predefined user roles
network-admin
mdc-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 zone packet statistics for zones in all VSANs.
Examples
# Clear zone 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 zone module.
Use undo snmp-agent trap enable fc-zone to disable SNMP notifications for the zone 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 zone module are disabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
activation-completed: Enables SNMP notifications for zone set activation or deactivation.
defaultzone-change: Enables SNMP notifications for default zone policy changes.
hardzone-change: Enables SNMP notifications for hard zoning status changes.
merge-failed: Enables SNMP notifications for merge failures.
merge-succeeded: Enables SNMP notifications for merge successes.
Usage guidelines
If you do not specify any keywords, this command enables all SNMP notifications for the zone module.
After you enable SNMP notifications for the zone module, the switch generates notifications for important events of the zone module and sends the notifications to the SNMP module. For more information about SNMP notifications, see Network Management and Monitoring Configuration Guide.
Examples
# Enable SNMP notifications for default zone policy changes.
<Sysname> system-view
[Sysname] snmp-agent trap enable fc-zone defaultzone-change
zone clone
Use zone clone to create a zone by copying an existing zone.
Syntax
zone clone src-name dest-name
Views
VSAN view
Predefined user roles
network-admin
mdc-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 characters (see Table 21). 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 characters (see Table 21). It must start with a letter.
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 deny members in the default zone from accessing each other.
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
mdc-admin
Usage guidelines
In enhanced zoning mode, the switch distributes the default zone policy with other zone data. 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
mdc-admin
Usage guidelines
Soft zoning is always in effect. Hard zoning takes effect only when the hardware resources are sufficient for deploying zone rules.
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 in VSAN 2.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[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
mdc-admin
Usage guidelines
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 FCoE Configuration Guide.
In enhanced zoning mode, the merge control mode affects the result of a merge operation. Also, 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] 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
mdc-admin
Usage guidelines
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 of 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] 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. If the zone has been created, this command leads you to the zone view directly.
Use undo zone name to delete a zone.
Syntax
zone name zone-name
undo zone name zone-name
Views
VSAN view
Predefined user roles
network-admin
mdc-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 characters (see Table 21). It must start with a letter.
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
mdc-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 characters (see Table 21). 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 characters (see Table 21). It must start with a letter.
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
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
mdc-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 characters (see Table 21). 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 characters (see Table 21). It must start with a letter.
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
zone-alias name
Use zone-alias name to create a zone alias and enter its view. If the zone alias has been created, this command leads you to the zone alias view directly.
Use undo zone-alias name to delete a zone alias.
Syntax
zone-alias name zone-alias-name
undo zone-alias name zone-alias-name
Views
VSAN view
Predefined user roles
network-admin
mdc-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 characters (see Table 21). It must start with a letter.
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
mdc-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 characters (see Table 21). 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 characters (see Table 21). It must start with a letter.
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 the 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
mdc-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 characters (see Table 21). It must start with a letter.
Usage guidelines
Each VSAN can have multiple zone sets. However, only one zone set can be effective 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.
In basic zoning mode, if the size of the zone set to be activated exceeds the system limit, the activation fails. In either basic or enhanced zoning mode, the system prints a log message if the activation fails. To ensure a consistent active zone set across the fabric, reactivate the zone set.
In basic zoning mode, the distribution type specified by using the zoneset distribute full command applies to distribution operations triggered by the zoneset activate command.
Examples
# Create a zone named z1.
<Sysname> system-view
[Sysname] vsan 1
[Sysname-vsan1] zone name z1
# Add an N_Port with the FC address as 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
mdc-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 characters (see Table 21). 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 characters (see Table 21). It must start with a letter.
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
mdc-admin
Usage guidelines
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
mdc-admin
Usage guidelines
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. If the zone set has been created, this command leads you to the zone set view directly.
Use undo zoneset name to delete a zone set.
Syntax
zoneset name zoneset-name
undo zoneset name zoneset-name
Views
VSAN view
Predefined user roles
network-admin
mdc-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 characters (see Table 21). It must start with a letter.
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
mdc-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 characters (see Table 21). 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 characters (see Table 21). It must start with a letter.
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
FIP snooping commands
display fip-snooping enode
Use display fip-snooping enode to display ENode information obtained by the Transit switch.
Syntax
display fip-snooping enode [ vlan vlan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays ENode information for all VLANs.
Examples
# Display ENode information obtained by the Transit switch.
<Sysname> display fip-snooping enode
VLAN 2:
Interface ENode WWN ENode MAC
FGE1/0/1 21:01:00:1b:32:a0:fa:18 000c-2999-eacd
Table 29 Command output
Field |
Description |
Interface |
Ethernet interface connecting the Transit switch to the ENode. |
ENode MAC |
FCoE MAC address of the ENode. |
display fip-snooping fcf
Use display fip-snooping fcf to display FCF switch information obtained by the Transit switch.
Syntax
display fip-snooping fcf [ vlan vlan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays FCF switch information for all VLANs.
Examples
# Display FCF switch information obtained by the Transit switch.
<Sysname> display fip-snooping fcf
VLAN 3:
Interface FCF MAC FCF WWN Fabric Name ENode
FGE1/0/1 000c-2999-eacd 66:66:66:63:66:64:61:30 41:6e:64:69:61:6d:6f:21 1
FGE1/0/2 000c-2999-eaad 66:66:66:63:66:64:61:31 41:6e:64:69:61:6d:6f:22 2
Table 30 Command output
Field |
Description |
Interface |
Ethernet interface connecting the Transit switch to the FCF switch. |
FCF MAC |
FCoE MAC address of the FCF switch. |
ENode |
Number of ENodes attached to an FCF switch. |
display fip-snooping flushing-rules
Use display fip-snooping flushing-rules to display the FIP snooping rules that are being flushed.
Syntax
display fip-snooping flushing-rules [ enode | fcf ] [ vlan vlan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
enode: Displays the ENode FIP snooping rules that are being flushed.
fcf: Displays the FCF FIP snooping rules that are being flushed.
vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays the FIP snooping rules that are being flushed for all VLANs.
Usage guidelines
Only the FIP snooping rules that have been flushed can filter FCoE frames. FIP snooping rules that are being flushed cannot filter FCoE frames.
If you do not specify either enode or fcf, this command displays both ENode and FCF FIP snooping rules that are being flushed.
Examples
# Display the FIP snooping rules that are being flushed.
<Sysname> display fip-snooping flushing-rules
VLAN 2:
FCF flushing-rules information:
Interface Source MAC/Mask Destination MAC/Mask
FGE1/0/1 0000-1234-0212/48 0efc-0034-0111/24
ENode flushing-rules information:
Interface Source MAC/Mask Destination MAC/Mask
FGE1/0/2 0efc-0034-0202/48 0000-1234-0101/48
VLAN 5:
FCF flushing-rules information:
Interface Source MAC/Mask Destination MAC/Mask
FGE1/0/3 0000-1234-2212/48 0efc-0034-2111/24
Table 31 Command output
Field |
Description |
Interface |
Ethernet interface on the Transit switch. |
Related commands
display fip-snooping rules
display fip-snooping rules
Use display fip-snooping rules to display the FIP snooping rules that have been flushed.
Syntax
In standalone mode:
display fip-snooping rules [ enode | fcf ] [ vlan vlan-id ] [ slot slot-number ]
In IRF mode:
display fip-snooping rules [ enode | fcf ] [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
enode: Displays the ENode FIP snooping rules that have been flushed.
fcf: Displays the FCF FIP snooping rules that have been flushed.
vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays the FIP snooping rules that have been flushed for all VLANs.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the FIP snooping rules that have been flushed on all cards. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays the FIP snooping rules that have been flushed on all cards of all IRF member devices. (In IRF mode.)
Usage guidelines
Only the FIP snooping rules that have been flushed can filter FCoE frames. FIP snooping rules that are being flushed cannot filter FCoE frames.
If you do not specify the enode or fcf keyword, this command displays both ENode and FCF FIP snooping rules that have been flushed.
Examples
# Display the FIP snooping rules that have been flushed.
<Sysname> display fip-snooping rules slot 1
Slot 1:
VLAN 2:
FCF rules information:
Interface Source MAC/Mask Destination MAC/Mask Context
FGE1/0/1 0000-1234-0202/48 0efc-0034-0101/24 ffffffff
ENode rules information:
Interface Source MAC/Mask Destination MAC/Mask Context
FGE1/0/2 0efc-0034-0102/48 0000-1234-0201/48 ffffffff
VLAN 4:
FCF rules information:
Interface Source MAC/Mask Destination MAC/Mask Context
FGE1/0/3 0000-1234-1202/48 0efc-0034-1101/24 ffffffff
Table 32 Command output
Field |
Description |
Interface |
Ethernet interface on the Transit switch. |
Context |
Driver context. |
Related commands
display fip-snooping flushing-rules
display fip-snooping sessions
Use display fip-snooping sessions to display information about FIP snooping sessions (connections between ENodes and FCF switches).
Syntax
display fip-snooping sessions [ vlan vlan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays information about FIP snooping sessions for all VLANs.
Examples
# Display information about FIP snooping sessions.
<Sysname> display fip-snooping sessions
VLAN 2:
FCF MAC ENode MAC VN_Port MAC VN_Port WWN
0000-1234-0202 0000-1234-0100 0efc-00ae-0002 41:6e:64:69:61:6d:6f:21
Table 33 Command output
Field |
Description |
FCF MAC |
FCoE MAC address of the FCF switch. |
ENode MAC |
FCoE MAC address of the ENode. |
VN_Port MAC |
MAC address of a VN_Port. |
fip-snooping enable
Use fip-snooping enable to enable FIP snooping in a VLAN.
Use undo fip-snooping enable to disable FIP snooping in a VLAN.
Syntax
fip-snooping enable
undo fip-snooping enable
Default
FIP snooping is disabled in a VLAN.
Views
VLAN view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
To enable a VLAN on a Transit switch to process FCoE frames and FIP frames, enable FIP snooping for the VLAN.
Examples
# Enable FIP snooping in VLAN 10.
<Sysname> system-view
[Sysname] vlan 10
[Sysname-vlan10] fip-snooping enable
fip-snooping fc-map
Use fip-snooping fc-map to set an FC-MAP value for a VLAN.
Use undo fip-snooping fc-map to restore the default.
Syntax
fip-snooping fc-map fc-map
undo fip-snooping fc-map
Default
The FC-MAP value for a VLAN is 0x0EFC00.
Views
VLAN view
Predefined user roles
network-admin
mdc-admin
Parameters
fc-map: Specifies an FC-MAP value in the range of 0x0EFC00 to 0x0EFCFF.
Usage guidelines
You can use the fcoe fcmap command to set the FC-MAP value in a frame sent out of an FCF switch. You can use the fip-snooping fc-map command to set an FC-MAP value for a VLAN on a Transit switch.
When an Ethernet interface in the FIP snooping VLAN receives a frame from the FCF switch, the following rules apply:
· If the FC-MAP value in the incoming frame is the same as the value set for the FIP snooping VLAN, the Ethernet interface forwards the frame.
· If the FC-MAP value in the incoming frame is different from the value set for the FIP snooping VLAN, the Ethernet interface drops the frame.
Examples
# Set the FC-MAP value to 0x0EFCFF for VLAN 10.
<Sysname> system-view
[Sysname] vlan 10
[Sysname-vlan 10] fip-snooping fc-map 0efcff
Changing the FC-MAP will flap all interfaces. Continue[Y/N]?
Related commands
fcoe fcmap
fip-snooping port-mode
Use fip-snooping port-mode to configure the mode of an Ethernet interface.
Use undo fip-snooping port-mode to restore the default.
Syntax
fip-snooping port-mode { enode | fcf }
undo fip-snooping port-mode
Default
An Ethernet interface operates in ENode mode.
Views
Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles
network-admin
mdc-admin
Parameters
enode: Specifies the ENode mode.
fcf: Specifies the FCF mode.
Usage guidelines
Ethernet interfaces on a Transit switch can operate in ENode mode or FCF mode.
· An Ethernet interface connected to an ENode must be configured to operate in ENode mode.
· An Ethernet interface connected to an FCF switch must be configured to operate in FCF mode.
Examples
# Configure interface FortyGigE 1/0/2 to operate in FCF mode.
<Sysname> system-view
[Sysname] interface fortygige 1/0/2
[Sysname-FortyGigE1/0/2] fip-snooping port-mode fcf
FCS 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
mdc-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-id to vsan-id. The value range for the vsan-id argument is 1 to 3839.
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 the topology discovery in VSANs.
Syntax
fcs discovery stop vsan vsan-list
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
vsan vsan-list: Specifies a VSAN by its ID or a range of VSANs in the form of vsan-id to vsan-id. The value range for the vsan-id argument is 1 to 3839.
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
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
mdc-admin
mdc-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 display the topology discovery status in all VSANs.
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 database
Use display fcs database to display the local FCS database information, including IE attributes and port attributes.
Syntax
display fcs database [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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 display the FCS database information in all VSANs.
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:01:00:11:22:00:01:01
Logical name : IE-Sysname1
Information list : H3C#H3C S12510-X#Version 7.1.045, Ess 1133
IE ports:
Interface Port WWN Port type Attached port WWNs
Vfc2 2f:15:01:11:22:00:01:01 F_Port 2f:15:01:11:22:00:01:02
2f:15:01:11:22:00:01:03
2f:15:01:11:22:00:01:04
Vfc1 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:01:00:11:22:00:01:01
Logical name : IE-Sysname2
Information list : H3C#H3C S12510-X#Version 7.1.045, Ess 1133
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:02:00:11:22:00:01:01
Logical name : IE-Sysname
Information list : H3C#H3C S12510-X#Version 7.1.045, Ess 1133
IE ports:
Interface Port WWN Port type Attached port WWNs
Table 34 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 ie
Use display fcs ie to display the IE information.
Syntax
display fcs ie [ vsan vsan-id ] [ nwwn wwn ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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.
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 the nodes in a VSAN.
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:01: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 S12510-X
Release code : Version 7.1.045, Ess 1133
# 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:01: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 S12510-X
Release code : Version 7.1.045, Ess 1133
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:02: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 S12510-X
Release code : Version 7.1.045, Ess 1133
Total 1 IEs in Fabric.
Table 35 Command output
Field |
Description |
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. |
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
mdc-admin
mdc-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 display the port information in all VSANs.
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 command displays information about all ports in a VSAN.
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 36 Command output
Field |
Description |
Port type |
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. |
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. |
Port number |
Port index. |
Attached port WWNs |
WWNs of connected ports. If the port does not connect to any ports, this field displays NA. |
Port state |
Current port state: · Online—The port link is connected. · Offline—The port link is not connected. · Unknown—Port state other than Online and Offline. |
Port speed capability |
The supported speed can be one or more of the following options: · 1 Gbps. · 2 Gbps. · 4 Gbps. · 8 Gbps. · 10 Gbps. · 16 Gbps. · 20 Gbps. Unknown is displayed for speeds other than the preceding ones. |
Port speed operation |
The current speed can only be one of the following options: · 1 Gbps. · 2 Gbps. · 4 Gbps. · 8 Gbps. · 10 Gbps. · 16 Gbps. · 20 Gbps. Unknown is displayed for speeds other than the preceding ones. 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
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
mdc-admin
mdc-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.
hba-id hba-id: Specifies an HBA by its ID in the format of xx:xx:xx:xx:xx:xx:xx:xx (hexadecimal).
verbose: Displays detailed FDMI database information. If you do not specify this keyword, the command displays brief FDMI database information.
Examples
# Display the brief FDMI database information for all VSANs.
<Sysname> display fdmi database
Registered HBA List for VSAN 1:
HBA ID Port WWNs
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 WWNs
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 37 Command output
Field |
Description |
Port WWNs |
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 WWNs
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 VSAN 1.
<Sysname> display fdmi database vsan 1 verbose
Registered HBA List for VSAN 1:
HBA ID: 38:00:00:11:22:00:01:01
Node WWN: 20:00:00:c0:dd:13:cc:d5
Manufacturer: QLogic Corporation
Serial num: RFC1001S63347
Model: QLE8152
Model description: QLogic QLE8152 Fibre Channel Adapter
Hardware version: 2.1
Driver version: 9.1.9.17
ROM version: 3.00
Firmware version: 5.04.01
OS name/version: Microsoft Windows Server 2003 R2 for x86
CT payload len: 2112
Port WWN: 21:00:00:c0:dd:13:cc:d5
Supported FC4 types: FCP
Supported speed: 10Gbps
Current speed: 10Gbps
Maximum frame size: 2048
OS device name: S05131F
Host name: S05131F
Table 38 Command output
Field |
Description |
Node WWN |
WWN of the node where the HBA resides. |
OS name/version |
Operating system name and version number of the HBA. |
CT payload len |
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. |
Port WWN |
WWN of the port on the HBA. |
Supported FC4 types |
The supported FC4 types include: · FCP—Fibre Channel Protocol. · GS3. · IP. · LLC/SNAP. · NPV. · SNMP. · SW-ILS. · VI. |
Supported speed |
The supported speed can be one or more of the following options: · 1 Gbps. · 2 Gbps. · 4 Gbps. · 8 Gbps. · 10 Gbps. · 16 Gbps. · 20 Gbps. · 32 Gbps. · 40 Gbps. Unknown is displayed for speeds other than the preceding ones. Speed not established is displayed when the supported speed cannot be determined. |
Current speed |
The current speed can only be one of the following options: · 1 Gbps. · 2 Gbps. · 4 Gbps. · 8 Gbps. · 10 Gbps. · 16 Gbps. · 20 Gbps. · 32 Gbps. · 40 Gbps. Unknown is displayed for speeds other than the preceding ones. Speed not established is displayed when the current speed cannot be determined. |
OS device name |
Operating system name of the port. |
FC ping commands
fcping
Use fcping to FCping an address.
Syntax
fcping [ -c count | -t timeout ] * fcid fcid vsan vsan-id
Views
Any view
Predefined user roles
network-admin
mdc-admin
Parameters
-c count: Specifies the number of echo requests to be sent, in the range of 0 to 2147483647 and defaulting to 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 considers the echo reply timed 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 FCF 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
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: 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 39 Command output
Field |
Description |
FCPING fcid 0xfffc02 |
Identify whether the device with destination address FFFC02 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
mdc-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.
· If the destination is an FCF 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 an existing VSAN by its ID in the range of 1 to 3839.
Usage guidelines
The bidirectional routing information includes WWNs and domain controller addresses of all switches on a round trip. The switch supports a maximum of 255 hops for a round trip.
To abort the FC tracert operation during the execution of this 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:05:30:00:18:db(0xfffcd7)
20:00:00:0b:46:00:02:82(0xfffcd5)
Fctracert completed.
Table 40 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 FFFCxx 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. |
allowed-domain-id,19
bandwidth,3
bind interface,3
default,5
delete zone database all,66
description,5
display fc domain,20
display fc domain-list,21
display fc ess,22
display fc exchange,45
display fc fib,47
display fc login,24
display fc name-service database,25
display fc routing-table,48
display fc scr-table,27
display fc switch-wwn,28
display fc timer,29
display fcoe,11
display fcoe-mode,1
display fcs database,102
display fcs discovery status,101
display fcs ie,104
display fcs port,106
display fdmi database,109
display fip-snooping enode,94
display fip-snooping fcf,94
display fip-snooping flushing-rules,95
display fip-snooping rules,96
display fip-snooping sessions,97
display fspf graceful-restart,51
display fspf lsdb,52
display fspf neighbor,54
display fspf statistics,55
display interface vfc,6
display vsan port-member,17
display zone,66
display zone member,68
display zone statistics,69
display zone status,70
display zone-alias,72
display zoneset,73
display zoneset active,74
domain auto-reconfigure enable,29
domain configure enable,30
domain restart,31
domain-id,32
fabric-name,33
fc domain rcf-reject,33
fc mode (VFC interface view),9
fc name-service auto-discovery,34
fc route-static,56
fc timer distributed-services,35
fc timer error-detect,35
fc timer resource-allocation,36
fc wwn default-fc4-type,37
fcoe enable,12
fcoe fcf-priority,13
fcoe fcmap,14
fcoe fka-adv-period,14
fcoe global fcf-priority,16
fcoe-mode,1
fcping,113
fcs discovery start,100
fcs discovery stop,101
fctracert,114
fip-snooping enable,98
fip-snooping fc-map,99
fip-snooping port-mode,99
fspf cost,57
fspf dead-interval,58
fspf enable,59
fspf graceful-restart,59
fspf graceful-restart helper,60
fspf graceful-restart interval,61
fspf hello-interval,61
fspf min-ls-arrival,62
fspf min-ls-interval,63
fspf retransmit-interval,63
fspf silent,64
fspf spf-hold-time,64
interface vfc,10
member (zone alias view),78
member (zone set view),79
member (zone view),76
pairwise-zoning enable,80
port trunk vsan,18
priority,38
reset counters interface,10
reset fspf counters,65
reset zone statistics,81
rscn aggregation enable,39
rscn aggregation timer,39
shutdown,11
snmp-agent trap enable fc-fabric,40
snmp-agent trap enable fc-name-service,41
snmp-agent trap enable fc-zone,81
timer distributed-services,42
timer error-detect,42
timer resource-allocation,43
vsan,18
wwn area-port-id,44
zone clone,82
zone default-zone permit,83
zone hard-zoning enable,84
zone merge-control restrict,84
zone mode enhanced,85
zone name,86
zone rename,87
zone-alias clone,87
zone-alias name,88
zone-alias rename,89
zoneset activate,89
zoneset clone,90
zoneset distribute,91
zoneset distribute full,92
zoneset name,92
zoneset rename,93