HP 5920 Command Reference Manual
Read Online
Read the HP 5920 Command Reference Manual online using the built-in PDF viewer.
Text of the manual
HP 5920 & 5900 Switch Series
FC and FCoE
Command Reference
Part number: 5998-6629
Software version: Release 2416
Document version: 6W100-20150130
Legal and notice information
© Copyright 2015 Hewlett-Packard Development Company, L.P.
No part of this documentation may be reproduced or transmitted in any form or by any means without
prior written consent of Hewlett-Packard Development Company, L.P.
The information contained herein is subject to change without notice.
HEWLETT-PACKARD COMPANY MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained
herein or for incidental or consequential damages in connection with the furnishing, performance, or
use of this material.
The only warranties for HP products and services are set forth in the express warranty statements
accompanying such products and services. Nothing herein should be construed as constituting an
additional warranty. HP shall not be liable for technical or editorial errors or omissions contained
herein.
FC and FCoE commands ············································································································································· 1
FCoE mode commands ····················································································································································· 1
display fcoe-mode ···················································································································································· 1
fcoe-mode ·································································································································································· 1
FC interface commands ···················································································································································· 3
bandwidth ································································································································································· 3
default ········································································································································································ 3
description ································································································································································· 4
display interface fc ··················································································································································· 5
fc mode (FC interface view) ································································································································· 12
fcb2bcredit ····························································································································································· 13
fill-word ··································································································································································· 13
interface fc ····························································································································································· 14
port-type ·································································································································································· 15
reset counters interface ········································································································································· 15
shutdown ································································································································································ 16
speed ······································································································································································ 16
VFC interface commands ·············································································································································· 17
bandwidth ······························································································································································ 17
bind interface ························································································································································· 18
default ····································································································································································· 20
description ······························································································································································ 21
display interface vfc ·············································································································································· 21
fc mode (VFC interface view) ······························································································································· 25
interface vfc ···························································································································································· 25
reset counters interface ········································································································································· 26
shutdown ································································································································································ 27
FC link aggregation commands ··································································································································· 27
bandwidth ······························································································································································ 27
default ····································································································································································· 28
description ······························································································································································ 28
display interface san-aggregation ······················································································································· 29
display san-aggregation ······································································································································· 32
fc mode (FC aggregate interface view) ·············································································································· 35
interface san-aggregation····································································································································· 36
reset counters interface ········································································································································· 36
san-aggregation group ········································································································································· 37
san-aggregation load-sharing mode local-first ··································································································· 38
shutdown ································································································································································ 38
FCoE commands ···························································································································································· 39
display fcoe ···························································································································································· 39
fcoe enable ···························································································································································· 40
fcoe fcf-priority ······················································································································································· 41
fcoe fcmap ····························································································································································· 42
fcoe fka-adv-period ··············································································································································· 42
fcoe global fcf-priority ··········································································································································· 44
VSAN commands ··························································································································································· 45
display vsan port-member ···································································································································· 45
port ·········································································································································································· 46
port access vsan ···················································································································································· 46
port trunk mode ····················································································································································· 47
port trunk vsan ······················································································································································· 48
vsan ········································································································································································· 49
Fabric building commands ············································································································································ 49
allowed-domain-id ················································································································································· 49
display fc domain ·················································································································································· 50
display fc domain-list ············································································································································ 52
display fc ess ························································································································································· 53
display fc login ······················································································································································ 54
display fc name-service database ······················································································································· 55
display fc scr-table ················································································································································· 58
display fc switch-wwn ··········································································································································· 59
display fc timer ······················································································································································ 59
domain auto-reconfigure enable ·························································································································· 60
domain configure enable ····································································································································· 61
domain restart ························································································································································ 61
domain-id ······························································································································································· 62
fabric-name ···························································································································································· 63
fc domain rcf-reject ················································································································································ 64
fc name-service auto-discovery ···························································································································· 64
fc timer distributed-services ··································································································································· 65
fc timer error-detect ··············································································································································· 66
fc timer resource-allocation··································································································································· 67
fc wwn default-fc4-type ········································································································································· 67
priority ···································································································································································· 68
rscn aggregation enable ······································································································································ 69
rscn aggregation timer ·········································································································································· 70
snmp-agent trap enable fc-fabric ························································································································· 71
snmp-agent trap enable fc-name-service ············································································································· 71
timer distributed-services ······································································································································· 72
timer error-detect···················································································································································· 73
timer resource-allocation ······································································································································· 74
wwn area-port-id ··················································································································································· 74
FC routing and forwarding commands························································································································ 75
display fc exchange ·············································································································································· 75
display fc fib ·························································································································································· 77
display fc routing-table ········································································································································· 79
display fspf graceful-restart ·································································································································· 82
display fspf lsdb ····················································································································································· 83
display fspf neighbor ············································································································································ 84
display fspf statistics ·············································································································································· 85
fc route-static ·························································································································································· 87
fspf cost··································································································································································· 88
fspf dead-interval ··················································································································································· 89
fspf enable ····························································································································································· 90
fspf graceful-restart ················································································································································ 90
fspf graceful-restart helper ···································································································································· 91
fspf graceful-restart interval ·································································································································· 91
fspf hello-interval ···················································································································································· 92
fspf min-ls-arrival ···················································································································································· 93
fspf min-ls-interval ·················································································································································· 94
fspf retransmit-interval ··········································································································································· 94
fspf silent ································································································································································· 95
fspf spf-hold-time ···················································································································································· 96
reset fspf counters ·················································································································································· 96
FC zone commands ······················································································································································· 97
delete zone database all ······································································································································ 97
display zone ·························································································································································· 97
display zone member ··········································································································································· 99
display zone statistics ········································································································································· 101
display zone status ·············································································································································· 102
display zone-alias················································································································································ 103
display zoneset ···················································································································································· 104
display zoneset active ········································································································································· 106
member (zone view) ············································································································································ 108
member (zone alias view) ·································································································································· 109
member (zone set view) ······································································································································ 111
pairwise-zoning enable ······································································································································ 111
reset zone statistics ·············································································································································· 112
snmp-agent trap enable fc-zone ························································································································· 113
zone clone ···························································································································································· 114
zone default-zone permit ···································································································································· 114
zone hard-zoning enable ··································································································································· 115
zone merge-control restrict ································································································································· 116
zone mode enhanced ········································································································································· 117
zone name ··························································································································································· 118
zone rename ························································································································································ 118
zone-alias clone ··················································································································································· 119
zone-alias name ·················································································································································· 120
zone-alias rename ··············································································································································· 120
zoneset activate ··················································································································································· 121
zoneset clone ······················································································································································· 122
zoneset distribute ················································································································································· 123
zoneset distribute full ··········································································································································· 123
zoneset name ······················································································································································· 124
zoneset rename ··················································································································································· 125
NPV commands ···························································································································································· 125
display fc nport ···················································································································································· 125
display npv login ················································································································································· 127
display npv status ················································································································································ 128
display npv traffic-map ······································································································································· 130
npv load-balance disruptive ······························································································································· 131
npv traffic-map ····················································································································································· 131
FIP snooping commands ·············································································································································· 132
display fip-snooping enode ································································································································ 132
display fip-snooping fcf ······································································································································· 133
display fip-snooping flushing-rules ····················································································································· 133
display fip-snooping rules ··································································································································· 134
display fip-snooping sessions ····························································································································· 135
fip-snooping enable ············································································································································ 136
fip-snooping fc-map ············································································································································· 137
fip-snooping port-mode ······································································································································· 137
FCS commands ····························································································································································· 138
fcs discovery start ················································································································································ 138
fcs discovery stop ················································································································································ 139
display fcs discovery status ································································································································ 139
display fcs database ··········································································································································· 140
display fcs ie ························································································································································ 142
display fcs port ···················································································································································· 144
FDMI commands ·························································································································································· 147
display fdmi database ········································································································································ 147
FC ping commands ······················································································································································ 151
fcping ···································································································································································· 151
FC tracert commands ··················································································································································· 152
fctracert ································································································································································· 152
Support and other resources ·································································································································· 155
Contacting HP ······························································································································································ 155
Subscription service ············································································································································ 155
Related information ······················································································································································ 155
Documents ···························································································································································· 155
Websites ······························································································································································· 155
Conventions ·································································································································································· 156
Index ········································································································································································ 158
FC and FCoE commands
Only the HP FlexFabric 5900CP-48XG-4QSFP+ Switches (JG838A) and HP StoreFabric
5900CP-48XG-4QSFP+8Gb FC B-fan Trays Converged Switches (E7W29A) support FC commands.
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
Examples
# Display the FCoE mode of the switch.
display fcoe-mode
The FCoE mode is FCF.
display fcoe-mode
The FCoE mode is NPV.
display fcoe-mode
The FCoE mode is TRANSIT.
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 | npv | transit }
undo fcoe-mode
A switch operates in non-FCoE mode and does not provide any FC or FCoE capabilities.
Views
System view
Predefined user roles
network-admin
Parameters
fcf: Specifies the FCF mode.
npv: Specifies the NPV 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).
•
NPV mode—A switch operating in this mode is called an NPV switch. Its VFC interfaces support F
mode (F_Port) and NP mode (NP_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 FC and 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 or the NP_Port on an NPV switch through its F_Port.
•
NPV mode—When the switch is operating in this mode, it can perform one of the following
operations:
�
Connect to the N_Port on a node through its F_Port.
�
Connect to the F_Port on an FCF switch through its NP_Port.
•
Transit mode—When the switch is operating in this mode, you can do perform one of the following
tasks:
�
Restrict its Ethernet interface to receiving traffic only from an ENode by configuring the interface
to operate in ENode mode.
�
Restrict its Ethernet interface to receiving traffic only from an FCF switch by configuring the
interface to operate in FCF mode.
•
Non-FCoE mode—When the switch is operating in this mode, it is a standard switch and does not
provide any FC or 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.
After converting the switch to non-FCoE mode, FC and FCoE-related configurations in the original FCoE
mode are cleared.
Examples
# Configure the switch to operate in FCF mode.
[Sysname] fcoe-mode fcf
# Convert the switch operating in FCF mode to NPV mode.
[Sysname] undo fcoe-mode
All current FC configuration will be lost. Continue? [Y/N]:y
[Sysname] fcoe-mode npv
Related commands
display fcoe-mode
FC interface commands
bandwidth
Use bandwidth to configure the expected bandwidth of an FC interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views
FC interface view
Predefined user roles
network-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
The expected bandwidth of an interface affects the link costs in FSPF. You can control the route selection
by configuring the expected bandwidth.
Examples
# Configure the expected bandwidth of interface FC 1/0/1 as 50 kbps.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] bandwidth 50
default
Use default to restore the default settings for an FC interface.
Syntax
default
FC interface view
Predefined user roles
network-admin
Usage guidelines
CAUTION:
The default command might interrupt ongoing network services. Make sure you are fully aware of the
impacts of this command when you perform 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 FC 1/0/1.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] default
description
Use description to configure a description for an FC interface.
Use undo description to restore the default.
Syntax
description text
undo description
Default
The description of an FC interface is interface name Interface, for example, Fc1/0/1 Interface.
Views
FC interface view
Predefined user roles
network-admin
Parameters
text: Specifies an interface description, a case-sensitive string of 1 to 255 characters.
Examples
# Configure the description as Fcport1 for interface FC 1/0/1.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] description Fcport1
display interface fc
Use display interface fc to display FC interface information.
Syntax
display interface [ fc ] [ brief [ down ] ]
display interface [ fc [ interface-number ] ] [ brief [ description ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-number: Specifies an FC interface by its number.
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 fc interface-number option, this command displays information about all
interfaces supported by the device.
If you specify the fc keyword but not the interface-number argument, this command displays information
about all FC interfaces.
Examples
# Display detailed information about interface FC 1/0/1.
display interface fc 1/0/1
Fc1/0/1
Current state: UP
Line protocol state: UP
Description: Fc1/0/1 Interface
Bandwidth: 4000000kbps
Maximum Transmit Unit: 2112
4000Mbps-speed mode
Internet protocol processing: disabled
Link layer protocol is FC
Fill word is idle-idle
Port WWN is 66:66:66:62:65:34:30:39
FC mode is Auto, state is E
Transmit B2B Credit is 64
Receive B2B Credit is 64
Support the VSAN protocol
VSAN tagging mode is Non tagging
EVFP common VSAN : 1
Media type is optical fiber,Port hardware type is 16G_FC_SW_SFP
Port priority: 0
4Gbps-speed mode, Link speed type is autonegotiation, Flow-control is enabled
The Maximum Frame Length is 10000
Last clearing of counters: Never
Peak value of input: 32 bytes/sec, at 2014-12-12 12:26:02
Peak value of output: 32 bytes/sec, at 2014-12-12 12:25:41
Last 300 seconds input: 0 packets/sec 9 bytes/sec 0%
Last 300 seconds output: 0 packets/sec 9 bytes/sec 0%
Input (total): 142 packets, 13596 bytes
142 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input (normal): 142 packets, - bytes
142 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, - overruns, 0 aborts
- ignored, - parity errors
Output (total): 139 packets, 13748 bytes
139 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output (normal): 139 packets, - bytes
139 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
0 lost carrier, - no carrier
Table 1 Command output
Field
Description
Current state
Physical state and administrative state of the FC interface:
• Administratively Down—The interface is administratively shut down by
using the shutdown command.
• DOWN—The interface is administratively up but physically down.
• DOWN (NPV uplink port not available)—The interface is
administratively up but physically down, because its uplink interface is
down or no uplink interface is created.
• DOWN (SAN Aggregation interface down)—The interface is
administratively up but physically down, because its FC aggregate
interface is down.
• UP—The interface is up both administratively and physically.
Line protocol state
Link layer protocol state of the FC interface: DOWN or UP.
Description
Description of the FC interface.
Bandwidth
Expected bandwidth of the FC interface.
Maximum Transmit Unit
MTU of the FC interface.
4000Mbps-speed mode
Rate of the FC interface.
Internet protocol processing
IP packet processing capability. If the FC interface is not configured with
an IP address, this field displays disabled.
Link layer protocol
Link layer protocol of the FC interface.
Fill word mode of the FC interface:
• idle-idle.
• idle-arbff.
FC mode
Mode of the FC interface.
state
Operating mode of the FC interface through negotiation.
Transmit B2B Credit
BB_Credit value of the local end.
This field is displayed only after the link comes up.
Receive B2B Credit
BB_Credit value of the remote end. This field is displayed only after the
link comes up.
Support VSAN Protocol
The FC interface supports the VSAN protocol after negotiation.
This field is displayed only after the link comes up.
VSAN tagging mode
VSAN tagging mode of the FC interface after the Exchange Virtual
Fabrics Protocol (EVFP) negotiation: Tagging or Non tagging.
This field is displayed only after the link comes up.
EVFP common VSAN
Common VSANs in up state through the EVFP negotiation.
This field is displayed only after the link comes up.
Link speed type is autonegotiation
This field is displayed if the speed auto command is configured.
Link speed type is force link
This field is displayed if a specific rate is configured by using the speed
command.
Flow-control
Flow control function status of the FC interface:
• enabled.
• not enabled.
The Maximum Frame Length
Maximum allowed frame size on the FC interface.
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.
Peak value of input
Peak incoming traffic rate on the FC interface.
Peak value of output
Peak outgoing traffic rate on the FC interface.
Last 300 seconds input: 0
packets/sec 9 bytes/sec 0%
Average incoming traffic rate on the FC interface in the last 300 seconds
and the percentage of the actual rate to the maximum interface rate
(configured by using the speed command).
A hyphen (-) indicates that the statistics item is not supported.
Last 300 seconds output: 0
packets/sec 9 bytes/sec 0%
Average outgoing traffic rate on the FC interface in the last 300 seconds
and the percentage of the actual rate to the maximum interface rate
(configured by using the speed command).
A hyphen (-) indicates that a statistics item is not supported.
Input (total): 142 packets, 13596
bytes
142 unicasts, 0
broadcasts, 0 multicasts, 0
pauses
Total numbers of frames and bytes received on the FC interface, including
normal frames, error frames, and pause frames.
• unicasts—Number of frames received that are destined to unicast
addresses.
• broadcasts—Number of frames received that are destined to
broadcast addresses.
• multicasts—Number of frames received that are destined to multicast
addresses.
• pauses—Number of pause frames received.
A hyphen (-) indicates that a statistics item is not supported.
Input (normal): 142 packets, -
bytes
142 unicasts, 0
broadcasts, 0 multicasts, 0 pauses
Total number of normal frames received on the FC interface and total
number of bytes of these frames, including normal frames and pause
frames.
• unicasts—Number of normal frames received that are destined to
unicast addresses.
• broadcasts—Number of normal frames received that are destined to
broadcast addresses.
• multicasts—Number of normal frames received that are destined to
multicast addresses.
• pauses—Number of pause frames received.
A hyphen (-) indicates that a statistics item is not supported.
input errors
Total number of error frames received on the FC interface.
runts
Number of frames received that meet the following requirements:
• Smaller than 64 bytes.
• In correct format.
• Have valid CRC values.
giants
Number of jumbo frames received. Jumbo frames are frames larger than
the maximum allowed frame size.
For an FC interface that does not permit jumbo frames, the maximum
frame length is as follows:
• 1518 bytes (without VLAN tags).
• 1522 bytes (with VLAN tags).
For an FC interface that permits jumbo frames, the maximum Ethernet
frame length is configured when you configure jumbo frame support on
the interface.
throttles
Number of times the switch shuts down the FC interface due to buffer or
CPU overload.
CRC
Number of incoming frames that had a valid length but contained CRC
errors.
frame
Number of incoming frames that contained CRC errors and a non-integer
number of bytes.
overruns
Number of incoming frames dropped because the input rate of the FC
interface exceeded the queuing capability.
Total number of illegal incoming frames:
• Fragment frames—CRC error frames shorter than 64 bytes. The length
(in bytes) can be an integral or non-integral value.
• Jabber frames—CRC error frames larger than the maximum frame
allowed size on the FC interface (with an integral or non-integral
length).
� For an FC interface that does not permit jumbo frames, the
maximum allowed frame size is 1518 bytes (without VLAN tags) or
1522 bytes (with VLAN tags).
� For an FC interface that permits jumbo frames, the maximum
allowed frame size is configured when you configure jumbo frame
support on the interface.
• Symbol error frames—Frames that contained at least one undefined
symbol.
• Unknown operation code frames—Non-pause MAC control frames.
• Length error frames—Frames whose 802.3 length fields did not match
the actual frame length (46 to 1500 bytes).
ignored
Number of incoming frames dropped because the receiving buffer of the
port ran low.
parity errors
Number of incoming frames with parity errors.
Output (total): 139 packets,
13748 bytes
139 unicasts, 0
broadcasts, 0 multicasts, 0
pauses
Total numbers of frames and bytes sent on the FC interface, including
normal frames, error frames, and pause frames.
• unicasts—Number of frames sent that are destined to unicast
addresses.
• broadcasts—Number of frames sent that are destined to broadcast
addresses.
• multicasts—Number of frames sent that are destined to multicast
addresses.
• pauses—Number of pause frames sent.
A hyphen (-) indicates that a statistics item is not supported.
Output (normal): 139 packets, -
bytes
139 unicasts, 0
broadcasts, 0 multicasts, 0 pauses
Total number of normal frames sent on the FC interface and total number
of bytes of these frames, including normal frames and pause frames.
• unicasts—Number of normal frames sent that are destined to unicast
addresses.
• broadcasts—Number of normal frames sent that are destined to
broadcast addresses.
• multicasts—Number of normal frames sent that are destined to
multicast addresses.
• pauses—Number of pause frames sent.
A hyphen (-) indicates that a statistics item is not supported.
output errors
Total number of error frames sent on the FC interface.
underruns
Number of outgoing frames dropped because the output rate of the FC
interface exceeded the queuing capability. This is a low-probability
hardware anomaly.
buffer failures
Number of frames dropped due to insufficient transmitting buffer
resources.
Total number of frames that are not successfully sent for various reasons,
for example, collisions.
deferred
Number of frames that are delayed for transmission because collisions are
detected before they are sent.
collisions
Number of frames that the FC interface stopped transmitting because
collisions were detected during transmission.
late collisions
Number of frames that the FC interface deferred to transmit after
transmitting their first 512 bits because of detected collisions.
lost carrier
Number of carrier losses during transmission. This counter increases by
one when a carrier is lost, and applies to serial WAN interfaces.
no carrier
Number of times that the FC interface failed to detect the carrier when
attempting to send frames. This counter increases by one each time the FC
interface failed to detect the carrier, and applies to serial WAN
interfaces.
# Display brief information about interface FC 1/0/1.
display interface fc 1/0/1 brief
Brief information on FC interface(s):
Admin Mode: auto - auto; E - e port; F - f port; NP - n port proxy
Oper Mode: E - e port; F - f port; NP - n port proxy;
TE - trunking e port; TF - trunking f port;
TNP - trunking n port proxy
Interface VSAN Admin Admin Oper Oper Status SAN-Aggregation
Mode Trunk Mode Speed
Mode
Fc1/0/1 2 auto off E 4G UP SAGG23
Table 2 Command output
Field
Description
Interface
Name of the FC interface.
VSAN
Access VSAN of the FC interface.
Admin Mode
User-configured FC interface mode:
• auto.
• E.
• F.
• NP.
Admin Trunk Mode
User-configured trunk mode for the FC interface:
• auto.
• on.
• off.
Negotiated mode (link layer negotiation) in which the FC interface is
operating:
• E—The FC interface is operating in E mode as an access port.
• F—The FC interface is operating in F mode as an access port.
• NP—The FC interface is operating in NP mode as an access port.
• TE—The FC interface is operating in E mode as a trunk port.
• TF—The FC interface is operating in F mode as a trunk port.
• TNP—The FC interface is operating in NP mode as a trunk port.
If no negotiation is initiated or negotiation fails, this field displays two
hyphens (--).
Oper Speed
Negotiated rate in bps (physical layer negotiation) for the FC interface.
If no negotiation is initiated or negotiation fails, this field displays two
hyphens (--).
Status
Negotiated state (link layer negotiation) for the FC interface:
• UP.
• DOWN.
SAN-Aggregation
FC aggregate group to which the FC interface belongs.
This field is empty when the FC interface is not assigned to any FC
aggregation group.
# Display the descriptions of FC interfaces.
display interface fc brief description
Brief information on FC interface(s):
Interface Description
Fc1/0/2 Fc1/0/2 Interface
Fc1/0/3 Fc1/0/3 Interface
# Display information about and the causes of the FC interfaces in physically down state.
display interface fc brief down
Brief information on interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
Fc1/0/1 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
• 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.
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 FC interface to be Down:
• Not connected—No physical connection exists (possibly because the
network cable is disconnected or faulty).
• Administratively—The port was shut down by using the shutdown
command. To bring up the interface, use the undo shutdown
command.
fc mode (FC interface view)
Use fc mode to configure the mode of an FC interface.
Use undo fc mode to restore the default.
Syntax
fc mode { auto | e | f | np }
undo fc mode
Default
On an FCF switch, the mode of an FC interface is auto.
On an NPV switch, the mode of an FC interface is F.
Views
FC interface view
Predefined user roles
network-admin
Parameters
auto: Specifies the auto mode, so that the FC interface can operate in F mode or E mode through
dynamic negotiation.
e: Specifies the E mode.
f: Specifies the F mode.
np: Specifies the NP mode.
Usage guidelines
An FC switch supports E, F, and auto modes. An NPV switch supports F and NP modes.
Examples
# Configure the mode of interface FC 1/0/1 as E.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] fc mode e
fcb2bcredit
Use fcb2bcredit to configure the Buffer-to-Buffer Credit (BB_ Credit) value for an FC interface.
Use undo fcb2bcredit to restore the default.
Syntax
fcb2bcredit credit-value
undo fcb2bcredit
Default
The BB_Credit value for an FC interface is 15.
Views
FC interface view
Predefined user roles
network-admin
Parameters
credit-value: Specifies the number of packets that the FC interface can continuously receive, in the range
of 1 to 15.
Usage guidelines
The BB_ Credit is a flow control mechanism used to ensure that an FC interface does not drop packets.
The BB_Credit value is configurable. Typically, you do not need to change the default value.
Examples
# Set the BB_Credit value to 10 for interface FC 1/0/1.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] fcb2bcredit 10
fill-word
Use fill-word to configure the fill word mode of an FC interface operating at 8 Gbps.
Use undo fill-word to restore the default.
Syntax
fill-word { idle-arbff | idle-idle }
undo fill-word
Default
The fill word mode is idle-arbff for an FC interface operating at 8 Gbps.
Views
FC interface view
Predefined user roles
network-admin
Parameters
idle-arbff: Specifies the idle-arbff mode. This mode uses the idle primitive signal in the link initialization
phase and uses the ARBff primitive signal as the fill word.
idle-idle: Specifies the idle-idle mode. This mode uses the idle primitive signal in the link initialization
phase and uses the idle primitive signal as the fill word.
Usage guidelines
This command is available on only FC interfaces operating at 8 Gbps. This command does not take
effect on FC interface operating at 2 Gbps or 4 Gbps, and these FC interfaces supports only the fill word
mode idle-idle.
When FC interfaces operating at 8 Gbps fail to communicate, you can use this command to adjust the
fill word of these FC interfaces.
To make the fill word mode configuration take effect, you must re-enable the FC interface by using the
shutdown command and then the undo shutdown command.
Examples
# Configure the fill word mode as idle-idle for FC 1/0/1 operating at 8 Gbps.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] speed 8000
[Sysname-Fc1/0/1] fill-word idle-idle
Related commands
speed
interface fc
Use interface fc to enter FC interface view.
Syntax
interface fc interface-number
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies an FC interface by its number.
Examples
# Enter the view of interface FC 1/0/1.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1]
Use port-type to change a Layer 2 Ethernet interface to an FC interface or change an FC interface back
to a Layer 2 Ethernet interface.
Syntax
In Layer 2 Ethernet interface view:
port-type fc
In FC interface view:
port-type ethernet
Default
A Layer 2 Ethernet interface is not changed to an FC interface.
Views
Layer 2 Ethernet interface view, FC interface view
Predefined user roles
network-admin
Parameters
ethernet: Changes an FC interface back to a Layer 2 Ethernet interface.
fc: Changes a Layer 2 Ethernet interface to an FC interface.
Usage guidelines
Layer 2 Ethernet interfaces can be changed to FC interfaces.
To change a Layer 2 Ethernet interface to an FC interface, use the port-type fc command in Layer 2
Ethernet interface view. To change an FC interface back to a Layer 2 Ethernet interface, use the port-type
ethernet command in FC interface view.
When the port type of an interface is changed, the following events occur:
•
The original interface is deleted.
•
A new interface is created with the same interface number as the original interface.
Examples
# Change interface Ten-GigabitEthernet 1/0/1 to interface FC 1/0/1.
system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] port-type fc
[Sysname-Fc1/0/1]
reset counters interface
Use reset counters interface to clear statistics for FC interfaces.
Syntax
reset counters interface [ fc [ interface-number ] ]
Predefined user roles
network-admin
Parameters
interface-number: Specifies an FC interface by its number.
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 fc keyword, this command clears statistics for all interfaces.
If you specify the fc keyword, this command clears statistics for all FC interfaces.
If you specify an FC interface, this command clears statistics for the specified FC interface.
Examples
# Clear statistics for interface FC 1/0/1.
reset counters interface fc 1/0/1
Related commands
display interface fc
shutdown
Use shutdown to shut down an FC interface.
Use undo shutdown to bring up an FC interface.
Syntax
shutdown
undo shutdown
Default
An FC interface is up.
Views
FC interface view
Predefined user roles
network-admin
Examples
# Shut down interface FC 1/0/1.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] shutdown
speed
Use speed to configure the rate for an FC interface.
Use undo speed to restore the default.
Syntax
speed { 1000 | 2000 | 4000 | 8000 | 16000 | auto }
undo speed
Default
The rate of an FC interface is autonegotiated.
Views
FC interface view
Predefined user roles
network-admin
Parameters
1000: Configures the interface rate as 1000 Mbps.
2000: Configures the interface rate as 2000 Mbps.
4000: Configures the interface rate as 4000 Mbps.
8000: Configures the interface rate as 8000 Mbps.
16000: Configures the interface rate as 16000 Mbps.
auto: Configures the interface to negotiate its rate with the peer.
Usage guidelines
The switch series does not support the 1000 and 16000 keywords of the command. When you configure
the 1000 or 16000 keyword for the command, the system prompts that "Such configuration is not
supported."
Examples
# Set the rate to 8000 Mbps for interface FC 1/0/1.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] speed 8000
VFC interface commands
bandwidth
Use bandwidth to configure the expected bandwidth of a VFC interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
VFC interface view
Predefined user roles
network-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
The expected bandwidth 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 of interface VFC 1 to 50 kbps.
system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] bandwidth 50
bind interface
Use bind interface to bind a VFC interface to an Ethernet interface.
Use undo bind interface to remove 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 interface.
Views
VFC interface view
Predefined user roles
network-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.
•
S-channel interface.
•
S-channel aggregate interface.
mac mac-address: Specifies the bound peer FCoE MAC address, in the format of XXXX-XXXX-XXXX and
six bytes in length.
To make a VFC interface work, bind it to a physical Ethernet interface. The VFC interface sends and
receives packets through the Ethernet interface bound to it.
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.
You must change the switch to the expert mode before binding a VFC interface to an S-channel interface
or S-channel aggregate interface. Otherwise, the binding will fail. The switch supports FCoE over
S-channel capabilities only when it is operating in expert mode. For information about system operating
modes, see Fundamentals Configuration Guide. For information about S-channel interfaces and
S-channel aggregate interfaces, see EVB Configuration Guide.
To successfully bind a VFC interface to a Layer 2 Ethernet interface, make sure the Layer 2 Ethernet
interface is FCoE capable. 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. New member ports of the
Layer 2 aggregate interface must also be FCoE capable. To successfully bind a VFC interface to an
S-channel interface, make sure the Layer 2 Ethernet interface associated with the S-channel interface has
FCoE over S-channel capabilities. To successfully bind a VFC interface to an S-channel aggregate
interface, make sure all member ports of the Layer 2 Ethernet aggregate interface associated with the
S-channel aggregate interface have FCoE over S-channel capabilities. New member ports of the Layer
2 Ethernet aggregate interface must also have FCoE over S-channel capabilities. Otherwise, FCoE traffic
might be blocked. For FCoE-capable cards and cards that have FCoE over S-channel capabilities, see
the specific product manual.
The binding to the 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.
The binding to an S-channel aggregate interface does not take effect when you perform the following
tasks:
•
Bind one VFC interface to the S-channel aggregate interface.
•
Bind another VFC interface to a member port of the Layer 2 aggregate interface associated with the
S-channel aggregate interface.
Enabling EVB on a Layer 2 Ethernet interface or Layer 2 aggregate interface disables the interface from
forwarding FCoE traffic. To enable such an interface to forward FCoE traffic, you must create an
S-channel interface or S-channel aggregate interface and bind a VFC interface to the created interface.
FCoE over S-channel can be used only between an EVB-capable switch and a server.
Examples
# Bind interface VFC 4 to interface Ten-GigabitEthernet 1/0/1 and FCoE MAC address
000c-2999-eacd.
[Sysname] interface vfc 4
[Sysname-Vfc4] bind interface ten-gigabitethernet 1/0/1 mac 000c-2999-eacd
# Bind interface VFC 5 to interface Bridge-aggregation 1 and FCoE MAC address 000c-2888-eacd.
system-view
[Sysname] interface vfc 5
[Sysname-Vfc5] bind interface bridge-aggregation 1 mac 000c-2888-eacd
# Bind interface VFC 6 to interface S-Channel 1/0/1:10 and FCoE MAC address 000c-2999-eacd.
system-view
[Sysname]interface vfc 6
[Sysname-Vfc6] bind interface s-channel 1/0/1:10 mac 000c-2999-eacd
# Bind interface VFC 7 to interface Schannel-Aggregation 1:10 and FCoE MAC address
000c-2666-eacd.
system-view
[Sysname]interface vfc 7
[Sysname-Vfc7] bind interface schannel-aggregation 1:10 mac 000c-2666-eacd
Related commands
•
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
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.
system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] default
This command will restore the default settings. Continue? [Y/N]:y
description
Use description to configure a description for a VFC interface.
Use undo description to restore the default.
Syntax
description text
undo description
Default
The description of an interface is interface name Interface, for example, Vfc 1 Interface.
Views
VFC interface view
Predefined user roles
network-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
# Configure the description as Vfcport1 for interface VFC 1.
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 ] [ brief [ down ] ]
display interface [ vfc [ interface-number ] ] [ brief [ description ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
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.
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 Ten-GigabitEthernet1/0/1, Bound MAC is 000c-2933-eacd
VSAN of physical-UP state: 1
Last clearing of counters: Never
Table 4 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
configured with an IP address, this field displays disabled.
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 goes 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.
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 XGE1/0/1 0102-0304-0506
Table 5 Command output
Field
Description
Interface
Name of the VFC interface.
Admin Mode
User-configured VFC interface mode:
• E.
• F.
• NP.
Admin Trunk Mode
User-configured trunk mode for the VFC interface: on.
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.
• NP—The VFC interface is operating in NP 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.
• TNP—The VFC interface is operating in NP mode as a trunk port.
If no negotiation is initiated or negotiation fails, this field displays two
hyphens (--).
Status
Negotiated state (link layer negotiation) for the VFC interface:
• UP.
• DOWN.
Bind Interface
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.
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.
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 6 Command output
Field
Description
Brief information on interface(s)
under bridge mode
Brief information about Layer 2 interfaces.
Link: ADM - administratively
down; Stby - standby
• 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.
Causes for the physical state of the VFC interface to be Down:
• Not connected—No physical connection exists (possibly because the
network cable is disconnected or faulty).
• Administratively—The port 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 configure the mode of a VFC interface.
Use undo fc mode to restore the default.
Syntax
fc mode { e | f | np }
undo fc mode
Default
The mode of a VFC interface is F.
Views
VFC interface view
Predefined user roles
network-admin
Parameters
e: Specifies the E mode.
f: Specifies the F mode.
np: Specifies the NP mode.
Usage guidelines
An FCF switch supports E and F modes. An NPV switch supports F and NP modes.
Examples
# Configure the mode of interface VFC 1 as E.
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
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 function of a
physical FC interface.
Examples
# Create interface VFC 1 and enter its view.
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
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.
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
Examples
# Bring up interface VFC 1.
system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] undo shutdown
FC link aggregation commands
bandwidth
Use bandwidth to configure the expected bandwidth of an FC aggregate interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views
FC aggregate interface view
Predefined user roles
network-admin
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
The baud rate of an FC aggregate interface is the sum of the speed of each Selected member interface
in the FC aggregation group.
The expected bandwidth of an FC aggregate interface affects the link costs in FSPF. You can control the
route selection by configuring the expected bandwidth.
Examples
# Set the expected bandwidth of FC aggregate interface 3 to 1000 kbps.
system-view
[Sysname] interface san-aggregation 3
[Sysname-SAN-Aggregation3] bandwidth 1000
default
Use default to restore the default settings for an FC aggregate interface.
Syntax
default
Views
FC aggregate interface view
Predefined user roles
network-admin
Usage guidelines
CAUTION:
The default command might interrupt ongoing network services. Make sure you are fully aware of the
impacts of this command when you execute it on a live network.
This command might fail to restore the default settings for some commands for reasons such as command
dependencies and system restrictions. Use the display this command in interface view to identify these
commands. Then use their undo forms or follow the command reference to restore their default settings.
If your restoration attempt still fails, follow the error message instructions to resolve the problem.
Examples
# Restore the default settings for FC aggregate interface 3.
system-view
[Sysname] interface san-aggregation 3
[Sysname-SAN-Aggregation3] default
This command will restore the default settings. Continue? [Y/N]:y
description
Use description to configure a description for an FC aggregate interface.
Use undo description to restore the default.
The description of an FC aggregate interface is interface name Interface, for example,
SAN-Aggregation3 Interface.
Views
FC aggregate interface view
Predefined user roles
network-admin
Parameters
text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.
Examples
# Configure the description as SAGG-interface for FC aggregate interface 3.
system-view
[Sysname] interface san-aggregation 3
[Sysname-SAN-Aggregation3] description SAGG-interface
Related commands
display interface san-aggregation
display interface san-aggregation
Use display interface san-aggregation to display FC aggregate interface information.
Syntax
display interface [ san-aggregation ] [ brief [ down ] ]
display interface [ san-aggregation [ interface-number ] ] [ brief [ description ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-number: Specifies an FC aggregate 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 the interfaces in all states.
If you do not specify the san-aggregation keyword, this command displays information about all
interfaces supported by the switch.
If you specify the san-aggregation keyword, this command displays information about all FC aggregate
interfaces.
If you specify an FC aggregate interface, this command displays information about the specified FC
aggregate interface.
Examples
# Display detailed information about FC aggregate interface 3.
display interface san-aggregation 3
SAN-Aggregation3
Current state: UP
Line protocol state: UP
Description: SAN-Aggregation3 Interface
Bandwidth: 0kbps
Maximum Transmit Unit: 2112
Internet protocol processing: disabled
Link layer protocol is FC
Port WWN is 00:00:00:00:00:00:00:00
FC mode is Auto, state is Init
Last clearing of counters: Never
Table 7 Command output
Field
Description
Current state
Physical state and administrative state of the FC aggregate interface:
• DOWN (Administratively)—The interface is administratively shut
down by using the shutdown command.
• DOWN—The interface is administratively up but physically down.
• DOWN (NPV uplink port not available)—The interface is
administratively up but physically down, because its uplink interface is
down or no uplink interface is created.
• UP—The interface is up both administratively and physically.
Line protocol state
Link layer protocol state of the FC aggregate interface: DOWN or UP.
Bandwidth
Expected bandwidth of the FC aggregate interface.
Internet protocol processing
IP packet processing capability. If the FC aggregate interface is not
configured with an IP address, this field displays disabled.
FC mode
Mode of the FC aggregate interface.
state
Operating state of the FC aggregate interface through negotiation.
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 FC aggregate interface 3.
display interface san-aggregation 3 brief
Brief information on SAN-Aggregation interface(s):
Admin Mode: auto - auto; E - e port; F - f port; NP - n port proxy
Oper Mode: E - e port; F - f port; NP - n port proxy;
TE - trunking e port; TF - trunking f port;
TNP - trunking n port proxy
Interface VSAN Admin Admin Oper Oper Status
Mode Trunk Mode Speed
Mode
SAGG3 37 NP auto NP 4G UP
Table 8 Command output
Field
Description
Interface
Name of the FC aggregate interface.
VSAN
Access VSAN of the FC aggregate interface.
Admin Mode
User-configured FC aggregate interface mode:
• auto.
• E.
• F.
• NP.
Admin Trunk Mode
User-configured trunk mode for the FC aggregate interface:
• auto.
• on.
• off.
Oper Mode
Negotiated mode (link layer negotiation) in which the FC aggregate
interface is operating:
• E—The FC aggregate interface is operating in E mode as an access
port.
• F—The FC aggregate interface is operating in F mode as an access
port.
• NP—The FC aggregate interface is operating in NP mode as an
access port.
• TE—The FC aggregate interface is operating in E mode as a trunk port.
• TF—The FC aggregate interface is operating in F mode as a trunk port.
• TNP—The FC aggregate interface is operating in NP mode as a trunk
port.
If no negotiation is initiated or negotiation fails, this field displays two
hyphens (--).
Oper Speed
Negotiated rate in bps (physical layer negotiation) for the FC aggregate
interface.
If no negotiation is initiated or negotiation fails, this field displays two
hyphens (--).
Status
Negotiated state (link layer negotiation) for the FC aggregate interface:
• UP.
• DOWN.
# Display the descriptions of FC aggregate interfaces.
display interface san-aggregation brief description
Brief information on SAN-Aggregation interface(s):
SAGG1 SAN-Aggregation1 Interface
SAGG2 SAN-Aggregation2 Interface
# Display information about the FC aggregate interfaces in physically down state and the causes.
display interface san-aggregation brief down
Brief information on interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
SAGG3 ADM Administratively
Table 9 Command output
Field
Description
Brief information on interface(s)
under bridge mode
Brief information about Layer 2 FC aggregate interfaces.
Link: ADM - administratively
down; Stby - standby
• 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 FC aggregate 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 FC aggregate interface to be Down:
• Not connected—No physical connection exists (possibly because the
network cable is disconnected or faulty).
• Administratively—The port was shut down by using the shutdown
command. To bring up the interface, use the undo shutdown
command.
display san-aggregation
Use display san-aggregation to display information about FC aggregation groups corresponding to
existing FC aggregate interfaces.
Syntax
display san-aggregation [ verbose ] [ interface san-aggregation interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
verbose: Displays detailed information about FC aggregation groups. If you do not specify this keyword,
the command displays brief information about the FC aggregation groups.
interface san-aggregation interface-number: Specifies an FC aggregate interface by its number. The
value range for the interface-number argument is 1 to 1024. If you do not specify an FC aggregate
interface, this command displays information about all FC aggregation groups corresponding to existing
FC aggregate interfaces.
Examples
# Display brief information about all FC aggregation groups corresponding to existing FC aggregate
interfaces.
display san-aggregation
* indicates the member port is selected.
Interface State Mode Speed Member port
SAGG1 UP E 8Gbps *Fc1/0/1
Fc1/0/2
SAGG2 DOWN - - -
Table 10 Command output
Match criteria
Description
Interface
Abbreviated FC aggregate interface name.
State
Physical state of the FC aggregate interface:
• DOWN—The physical state of the interface is down and the FC aggregate
interface contains no Selected member interface.
• UP—The physical state of the interface is up and the FC aggregate interface
contains Selected member interfaces.
Mode
Operating mode of the FC aggregate interface:
• E—E mode.
• F—F mode.
• NP—NP mode.
When the physical state of the FC aggregate interface is down, a hyphen (-) is
displayed for this field.
Speed
Speed of the FC aggregate interface. It is the sum of the speed of each Selected
member interface. When the physical state of the FC aggregate interface is down,
a hyphen (-) is displayed for this field.
Member port
Member interfaces of the FC aggregation group corresponding to the FC
aggregate interface. A member interface marked with an asterisk (*) is a Selected
member interface. When the FC aggregation group does not contain any member
interface, a hyphen (-) is displayed for this field.
# Display detailed information about all FC aggregation groups corresponding to existing FC aggregate
interfaces.
display san-aggregation verbose
Interface SAN-Aggregation1:
State : UP
Mode : E
Speed : 2Gbps
Member port number : 2
Selected port number : 1
Member port State Mode Speed Selected
Fc1/0/1 UP E 2Gbps Y
Fc1/0/2 UP E 1Gbps N
Interface SAN-Aggregation2:
State : DOWN
Mode : N/A
Speed : N/A
Member port number : 2
Selected port number : 0
Member port State Mode Speed Selected
Fc1/0/3 DOWN - - N
Fc1/0/4 DOWN - - N
Table 11 Command output
Match criteria
Description
Interface
FC aggregate interface name.
State
Physical state of the FC aggregate interface:
• DOWN—The physical state of the interface is down and the FC aggregate
interface contains no Selected member interface.
• UP—The physical state of the interface is up and the FC aggregate interface
contains Selected member interfaces.
Mode
Operating mode of the FC aggregate interface:
• E—E mode.
• F—F mode.
• NP—NP mode.
When the physical state of the FC aggregate interface is down, N/A is displayed
for this field.
Speed
Speed of the FC aggregate interface. It is the sum of the speed of each Selected
member interface. When the physical state of the FC aggregate interface is down,
N/A is displayed for this field.
Member port number
Number of member interfaces in the FC aggregation group corresponding to the
FC aggregate interface.
Selected port number
Number of Selected member interfaces in the FC aggregation group corresponding
to the FC aggregate interface.
Member port
Member interfaces of the FC aggregation group corresponding to the FC
aggregate interface. When the FC aggregation group does not contain any
member interface, this field is blank.
State
Link layer state of the FC aggregate interface:
• DOWN—The link layer protocol of the interface is down.
• UP—The link layer protocol of the interface is up.
Operating mode of the member interface:
• E—E mode.
• F—F mode.
• NP—NP mode.
When the member interface is down at the link layer, a hyphen (-) is displayed for
this field.
Speed
Speed of the member interface. When the member interface is down at the link
layer, a hyphen (-) is displayed for this field.
Selected
Selected state of the member interface:
• N—Unselected.
• Y—Selected.
fc mode (FC aggregate interface view)
Use fc mode to configure the mode of an FC aggregate interface.
Use undo fc mode to restore the default.
Syntax
fc mode { auto | e | f | np }
undo fc mode
Default
On an FCF switch, the mode of an FC aggregate interface is auto.
On an NPV switch, the mode of an FC aggregate interface is F.
Views
FC aggregate interface view
Predefined user roles
network-admin
Parameters
auto: Specifies the auto mode, so that the FC aggregate interface can operate in F mode or E mode
through dynamic negotiation.
e: Specifies the E mode.
f: Specifies the F mode.
np: Specifies the NP mode.
Usage guidelines
An FCF switch supports E, F, and auto modes. An NPV switch supports F and NP modes.
Examples
# Configure the mode of FC aggregate interface 3 as E.
system-view
[Sysname] interface san-aggregation 3
[Sysname-SAN-Aggregation3] fc mode e
interface san-aggregation
Use interface san-aggregation to create an FC aggregate interface and enter its view. If the FC
aggregate interface already exists, this command leads you to the FC aggregate interface view directly.
Syntax
interface san-aggregation interface-number
undo interface san-aggregation interface-number
Default
No FC aggregate interfaces exist.
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies the number of the FC aggregate interface. The value range for this argument
is 1 to 1024.
Examples
# Enter the view of FC aggregate interface 3.
system-view
[Sysname] interface san-aggregation 3
[Sysname-SAN-Aggregation3]
Related commands
display interface san-aggregation
reset counters interface
Use reset counters interface to clear statistics for FC aggregate interfaces.
Syntax
reset counters interface [ san-aggregation [ number ] ]
Views
User view
Predefined user roles
network-admin
Parameters
number: Specifies an FC aggregate interface by its number. The value range for this argument is 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 san-aggregation keyword, this command clears statistics for all interfaces.
If you specify the san-aggregation keyword, this command clears statistics for all FC aggregate
interfaces.
If you specify an FC aggregate interface, this command clears statistics for the specified FC aggregate
interface.
Examples
# Clear statistics for FC aggregate interface 3.
reset counters interface san-aggregation 3
Related commands
display interface san-aggregation
san-aggregation group
Use san-aggregation group to assign an FC interface to an FC aggregation group.
Use undo san-aggregation group to remove an FC interface from an FC aggregation group.
Syntax
san-aggregation group group-number
undo san-aggregation group
Default
An FC interface is not assigned to any FC aggregation group.
Views
FC interface view
Predefined user roles
network-admin
Parameters
group-number: Specifies an FC aggregation group by its group number. An FC aggregation group
uniquely corresponds to an FC aggregate interface, and they are numbered the same.
Usage guidelines
An FC interface can be assigned to only one FC aggregation group.
After an FC interface is assigned to an FC aggregation group, its operating mode, trunk mode, trunk
VSAN, and access VSAN configurations are cleared. Also, you cannot configure these configurations for
a member interface. After the FC interface is removed from the FC aggregation group, these
configurations are not restored, and the default settings of these configurations are used.
An FC aggregation group can have a maximum of eight member interfaces.
Examples
# Assign FC interface FC 1/0/1 to FC aggregation group 2.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] san-aggregation group 2
Current FC mode, trunk mode, trunk VSAN, and access VSAN configuration of the in
terface will be lost. Continue? [Y/N]:y
Related commands
display san-aggregation
san-aggregation load-sharing mode local-first
Use san-aggregation load-sharing mode local-first to enable local-first load sharing.
Use undo san-aggregation load-sharing mode local-first to disable local-first load sharing.
Syntax
san-aggregation load-sharing mode local-first
undo san-aggregation load-sharing mode local-first
Default
Local-first load sharing is enabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
Local-first load sharing reduces the influence of traffic on the links between physical IRF ports. For
example, in an IRF fabric, an IRF member device forwards traffic out of an FC aggregate interface with
the member interfaces distributed on multiple IRF member devices. The system processes the traffic as
follows based on the configurations on IRF member device.
•
When local-first load sharing is enabled on the IRF member device, the following rules apply:
�
If the IRF member device has Selected member interfaces, traffic is load-shared among the
Selected interfaces of the IRF member device.
�
If the IRF member device does not have Selected member interface, traffic is load-shared among
all Selected member interfaces on all IRF member devices.
•
When local-first load sharing is disabled on the IRF member device, the traffic is load-shared
among all Selected member interfaces on all IRF member devices.
For more information about IRF, see IRF Configuration Guide.
Local-first load sharing takes effect immediately after it is configured, and it might cause traffic loss.
Examples
# Enable local-first load sharing.
system-view
[Sysname] san-aggregation load-sharing mode local-first
shutdown
Use shutdown to shut down an FC aggregate interface.
Use undo shutdown to bring up an FC aggregate interface.
An FC aggregate interface is up.
Views
FC aggregate interface view
Predefined user roles
network-admin
Examples
# Bring up FC aggregate interface 3.
system-view
[Sysname] interface san-aggregation 3
[Sysname-SAN-Aggregation3] 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
Examples
# Display global FCoE configuration.
display fcoe
FCoE MAC : 0000-1234-0202
FC-MAP : 0efc25
FCF Priority: 128
FKA period : 8 seconds
Table 12 Command output
Field
Description
FCoE MAC
FCoE MAC address of the switch.
FC-MAP
FC-MAP value.
FCF Priority
System FCF priority.
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 for a VLAN and map the VLAN to a VSAN.
Use undo fcoe enable to disable FCoE for the VLAN.
Syntax
fcoe enable [ vsan vsan-id ]
undo fcoe enable
Default
FCoE is disabled for a VLAN.
Views
VLAN view
Predefined user roles
network-admin
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this
command maps the VLAN to a VSAN with the same ID as the VLAN. For VLANs 3840 to 4094, you must
specify VSANs to be mapped.
Usage guidelines
To use an FC or VFC interface to transmit packets, you must enable FCoE.
When you use an FC interface to transmit packets, you must map its access VSAN and trunk VSANs to
VLANs and enable FCoE for the VLANs. This allows the switch to correctly run FC and FCoE features.
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 for a VLAN and map the VLAN to a VSAN. This
allows the packets from the VSAN to be tagged with the VLAN tag and transmitted within the VLAN.
FCoE cannot be enabled for VLAN 1.
VSANs are mapped to VLANs on a one-to-one basis.
When you use an FC interface to transmit packets, the VSAN used on the two ends can be mapped to
the same VLAN or different VLANs. When you use a VFC interface to transmit packets, enable FCoE for
the same VLAN and map this VLAN to the same VSAN on the two ends.
After you enable FCoE for a VLAN, the following changes occur to the VLAN:
•
An FCoE-capable VLAN allows only FCoE traffic.
All member ports in an FCoE-capable VLAN are isolated and will not form loops. For this reason,
you do not need to enable STP or other loop detection protocols in an FCoE-capable VLAN.
Otherwise, FCoE links might be blocked.
•
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.
Examples
# Enable FCoE on VLAN 4 and map VLAN 4 to VSAN 6.
system-view
[Sysname] vlan 4
[Sysname-vlan4] fcoe enable vsan 6
fcoe fcf-priority
Use fcoe fcf-priority to configure 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
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
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.
This command is 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.
Examples
# Configure the FCF priority as 12 for interface VFC 1.
system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fcoe fcf-priority 12
Use fcoe fcmap to configure 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
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 configured, VFC interfaces perform an FIP renegotiation.
Examples
# Configure the FC-MAP value as 0x0EFCFF.
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 configure 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
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.
The FKA advertisement interval defines the interval for a switch to send unsolicited Discovery
Advertisements to its peer switches or ENodes. If the peer switch or ENode fails to receive unsolicited
Discovery Advertisements within 2.5 FKA advertisement intervals, it deletes the virtual link. The FKA
advertisement interval is carried in received unsolicited Discovery Advertisements instead of being
configured on the local switch. If the switch fails to receive keepalive frames from the peer ENode within
2.5 FKA advertisement intervals, it also deletes the virtual link.
When configuring the FKA advertisement interval value on an FCF or NPV switch, use Table 13 as a
reference to avoid service disruption.
Table 13 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, an FCF switch or NPV switch operating in
standalone mode or in IRF mode but without subordinate
switches 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.
You must adjust the FKA advertisement interval value on
the upstream FCF switch to ensure service continuity in
either of the following situations:
• An active/standby switchover on an NPV switch
• An ISSU reboot on an IRF member NPV switch with
subordinate switches.
The preceding steps are required for the following
reasons:
• The FKA advertisement interval value configured on
the NPV switch affects only its VFC interfaces in F
mode and connected ENodes.
• The VFC interfaces in NP mode of the NPV switch use
the FKA advertisement interval value learned from
the upstream FCF switch.
Active/standby switchover on
the switch takes more than 2.5 x
60 seconds because of the
amount of FCoE configuration.
ISSU reboot on an IRF member
switch with subordinate
switches 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 switch
operating in standalone mode
or in IRF mode but without
subordinate switches and
connecting to no nodes.
During an ISSU reboot on a switch operating in
standalone mode or in IRF mode but without subordinate
switches, the switch cannot send unsolicited Discovery
Advertisements or keepalive frames.
Examples
# Configure the FKA advertisement interval as 20 seconds.
system-view
[Sysname] fcoe fka-adv-period 20
fcoe global fcf-priority
Use fcoe global fcf-priority to configure 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
Parameters
priority: Specifies the system FCF priority in the range of 0 to 255. The smaller the value, the higher the
priority.
Usage guidelines
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.
This command takes effect on all VFC interfaces operating in F mode.
# Configure the system FCF priority as 12.
Fc1/0/4 Fc1/0/5 Fc1/0/6
port
Use port to assign the specified interfaces to a VSAN as access ports in batch.
Use undo port to remove the specified interfaces from a VSAN in batch.
Syntax
port interface-list
undo port interface-list
Default
All interfaces belong to VSAN 1 as access ports.
Views
VSAN view
Predefined user roles
network-admin
Parameters
interface-list: Specifies a space-separated list of up to 10 interface items. Each item specifies an interface
or a range of interfaces in the form of interface-type interface-number1 to interface-type
interface-number2. The value for interface-number2 must be greater than or equal to the value for
interface-number1. The interface type can only be FC interface.
Usage guidelines
This command has the same effect as configuring the port access vsan command in interface view of
each interface in the interface list.
Examples
# Assign interfaces FC 1/0/1 through FC 1/0/10 to VSAN 10 as access ports in batch.
system-view
[Sysname] vsan 10
[Sysname-vsan10] port fc 1/0/1 to fc 1/0/10
Related commands
port access vsan
port access vsan
Use port access vsan to assign an interface to a VSAN as an access port.
Use undo port access vsan to restore the default.
Syntax
port access vsan vsan-id
undo port access vsan
Default
The access VSAN of each interface is VSAN 1.
FC interface view, FC aggregate interface view
Predefined user roles
network-admin
Parameters
vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. Make sure the VSAN already exists on the
switch. Otherwise, this command fails.
Usage guidelines
To assign multiple interfaces to a VSAN as access ports in batch, use the port command.
Examples
# Assign interface FC 1/0/1 to VSAN 10 as an access port.
system-view
[Sysname] vsan 10
[Sysname-vsan10] quit
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] port access vsan 10
Related commands
port
port trunk mode
Use port trunk mode to configure the trunk mode of an interface.
Use undo port trunk mode to restore the default.
Syntax
port trunk mode { auto | off | on }
undo port trunk mode
Default
On an FCF switch, the trunk mode of an interface is auto.
On an NPV switch, the trunk mode of an interface is off.
Views
FC interface view, FC aggregate interface view
Predefined user roles
network-admin
Parameters
auto: Specifies the auto mode.
off: Specifies the off mode.
on: Specifies the on mode.
Usage guidelines
The trunk mode of an interface can be auto, on, or off.
When the switch is operating in FCF mode, its FC interfaces and FC aggregate interfaces support
all these modes.
•
When the switch is operating in NPV mode, its FC interfaces and FC aggregate interfaces support
only on and off modes.
The two interfaces of a link use the Exchange Virtual Fabrics Parameters (EVFP) protocol to negotiate
whether to support VSAN tagging according to the trunk modes.
Only FC interfaces and FC aggregate interfaces support the trunk mode.
Examples
# Configure the trunk mode of interface FC 1/0/1 as On.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] port trunk mode on
port trunk vsan
Use port trunk vsan to assign an interface to the specified VSANs as a trunk port.
Use undo port trunk vsan to remove an interface from the specified VSANs.
Syntax
port trunk vsan vsan-id-list
undo port trunk vsan vsan-id-list
Default
An interface is not assigned to any VSAN as a trunk port.
Views
FC interface view, VFC interface view, FC aggregate interface view
Predefined user roles
network-admin
Parameters
vsan-id-list: Specifies a space-separated list of up to 10 VSAN items. Each item specifies a VSAN 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 FC 1/0/1 to VSANs 1, 2, 10, and 20 through 100.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] port trunk vsan 1 to 2 10 20 to 100
# Assign interface VFC 1 to VSANs 1, 2, 10, and 20 through 100.
system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] port trunk vsan 1 to 2 10 20 to 100
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
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 16.
Examples
# Create VSAN 10 and enter its view.
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.
Predefined user roles
network-admin
Parameters
domain-id-list: Specifies a space-separated list of up to 8 domain items. Each item specifies a domain ID
or a range of domain IDs in the 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
Each FC switch is assigned a domain ID. You can configure an allowed domain ID list.
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.
HP recommends that you configure the same allowed domain ID list for all switches in a VSAN.
Examples
# Configure VSAN 1 to allow domains 3 through 10.
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
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.
display fc domain vsan 1
Domain Information of VSAN 1:
Running time information:
State: Stable
Switch WWN: 41:6e:64:69:61:6d:6f:21
Fabric name: 41:6e:64:69:61:6d:6f:21
Priority: 2
Domain ID: 100
Configuration information:
Domain configure: Enabled
Domain auto-reconfigure: Disabled
Fabric name: 41:6e:64:69:61:6d:6f:21
Priority: 128
Domain ID: 100 (static)
Principal switch running time information:
Priority: 2
Path Interface
Downstream Fc1/0/1
Downstream Fc1/0/2
Downstream Fc1/0/4
Table 14 Command output
Field
Description
State
Running status:
• Stable—The configuration is finished.
• Unstable—The configuration is not finished.
Switch WWN
WWN of the local switch.
Fabric name
Name of the fabric.
Priority
Running priority of the local switch.
Domain ID
Runtime domain ID of the local switch.
Configuration information
Configuration information of the local switch.
Domain configure
State of the fabric configuration function:
• Enabled—The fabric configuration function is enabled.
• Disabled—The fabric configuration function is disabled.
State of the automatic reconfiguration function:
• Enabled—The automatic reconfiguration function is enabled on the switch.
• Disabled—The automatic reconfiguration function is disabled on the
switch.
Fabric name
Fabric name configured on the switch.
Priority
Locally configured priority of the switch.
Domain ID
Locally configured domain ID. The field in the parentheses can be one of the
following:
• static—The domain ID is static type.
• preferred—The domain ID is preferred type.
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 FC or 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
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.
display fc domain-list vsan 1
Domain list of VSAN 1:
Number of domains: 3
Domain ID WWN
0xc8(200) 20:01:00:05:30:00:47:df [Principal]
0x63(99) 20:01:00:0d:ec:08:60:c1 [Local]
0x61(97) 50:00:53:0f:ff:f0:10:06
Table 15 Command output
Field
Description
Domain list of VSAN
Domain ID list of the VSAN.
Number of domains
Total number of domains.
WWN
WWN of the switch. Principal indicates a principal switch, and Local
indicates a local switch.
Related commands
domain configure enable
display fc ess
Use display fc ess to display the Exchange Switch Support (ESS) negotiation result, including the
following information:
•
The capabilities of the local switch after the ESS negotiation.
•
The capabilities of the remote switch after the ESS negotiation.
Syntax
display fc ess [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this
command displays the ESS negotiation results of all VSANs.
Examples
# Display the ESS negotiation result in VSAN 2.
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 16 Command output
Field
Description
Domain
Domain ID of the switch.
Directory Server Capability
List of directory server capabilities.
Accept large name server objects
Indicates whether the switch supports accepting large name server
objects.
A large name server object contains the symbolic name of the
N_Port and the symbolic name of the node in addition to the
information of a small name server object.
Accept small name server objects
Indicates whether the switch supports accepting small name server
objects.
A small name server object contains only the basic information,
and does not contain the symbolic name of the N_Port, the
symbolic name of the node, or information about supported FC-4
features.
Accept large + FC-4 Features name server
objects
Indicates whether the switch supports accepting large +
FC-4-feature name server objects.
Accept small + FC-4 Features name server
objects
Indicates whether the switch supports accepting small +
FC-4-feature name server objects.
Support receiving ACCept with 0 length
Indicates whether the switch supports accepting an ACCEPT reply
whose payload is 0.
Fabric Controller Capability
List of fabric controller capabilities.
Support receiving the SW_RSCN Request
Indicates whether the switch supports accepting an SW_RSCN
(Registered State Change Notification) request.
display fc login
Use display fc login to display the node login information of the specified VSANs.
Syntax
display fc login [ vsan vsan-id ] [ count ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this
command displays the node login information of all VSANs.
count: Displays the total number of logged-in nodes.
Examples
# Display the node login information of VSAN 1.
display fc login vsan 1
Interface VSAN FCID Node WWN Port WWN
Fc1/0/1 1 0x010000 21:01:00:1b:32:a0:fa:18 21:01:00:1b:32:a0:fa:17
# Display the number of logged-in nodes for VSAN 1.
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.
display fc login count
VSAN Entries
1 1
2 1
Total entries: 2
Table 17 Command output
Field
Description
Interface
Interface on the switch connected to the node.
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
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.
display fc name-service database vsan 1
VSAN 1:
FCID Type PWWN(vendor) FC4-type:feature
0x030001 0x01(N) 20:00:00:05:30:00:25:a3 SCSI-FCP
0x030200 0x01(N) 20:00:00:49:c9:28:c7:01 NPV
# Display the number of name service entries for VSAN 1.
display fc name-service database vsan 1 count
Total entries: 2
Table 18 Command output
Field
Description
FCID
FC address of the N_Port.
Type
Link type of the N_Port, which can be N representing point-to-point.
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.
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)
--- Total 2 entries ---
Table 19 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.
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 an N_Port. For an
NP_Port on an HP NPV switch, it is in the form of
system-name:port-name.
Symbolic name, which is used for describing a node. For an HP NPV
switch, it is the system-name.
Port-type
Link type of the N_Port, which can be N representing point-to-point.
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
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.
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.
display fc scr-table vsan 1 count
Total entries: 2
Table 20 Command output
Field
Description
SCR table for VSAN
SCR list in a VSAN.
FCID
FC address of the N_Port.
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 WWN of the local switch.
Syntax
display fc switch-wwn
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the WWN of the local switch.
display fc switch-wwn
Switch WWN is 10:00:00:0d:ec:ff:a3:25
display fc timer
Use display fc timer to display fabric timers.
Syntax
display fc timer [ distributed-services | error-detect | resource-allocation ] [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
distributed-services: Displays the distributed service timeout period, in milliseconds.
error-detect: Displays the error detection timeout period, in milliseconds.
resource-allocation: Displays the resource allocation timeout period, in milliseconds.
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this
command displays global fabric timer information.
If you do not specify the distributed-services, error-detect, or resource-allocation keyword, this
command displays all the fabric timers.
Examples
# Display all the fabric timers for VSAN 1.
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 each VSAN.
Views
VSAN view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only when the fabric configuration function is enabled.
A fabric reconfiguration triggers a principal switch selection phase.
A disruptive reconfiguration is automatically performed if the domain ID lists overlap when two fabrics
are merged.
A nondisruptive reconfiguration is automatically performed when one of the following conditions exists:
•
When two fabrics are merged, the principal switch information of the two fabrics is different, and
the domain ID lists are not empty and do not overlap.
•
A principal link in a fabric goes down.
Examples
# Enable the automatic reconfiguration function in VSAN 1.
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 function for the switch in a VSAN.
Use undo domain configure enable to disable the fabric configuration function for the switch in a VSAN.
Syntax
domain configure enable
undo domain configure enable
Default
The fabric configuration function is enabled in a VSAN.
Views
VSAN view
Predefined user roles
network-admin
Usage guidelines
After you enable the fabric configuration function on FC switches, the switches exchange messages to
select the principal switch. Then, the principal switch dynamically assigns domain IDs to all switches in
the fabric. After you disable the fabric configuration function on FC switches, the switches will not select
a principal switch and cannot obtain domain IDs dynamically. You must configure a unique domain ID
for each switch.
•
To dynamically build a fabric, you must enable the fabric configuration function on switches.
•
To statically build a fabric, you must disable the fabric configuration function on switches and
manually configure domain IDs for the switches.
Examples
# Enable the fabric configuration function for the switch in VSAN 1.
system-view
[Sysname] vsan 1
[Sysname-vsan1] domain configure enable
domain restart
Use domain restart to manually initiate a fabric reconfiguration in a VSAN.
Syntax
domain restart [ disruptive ]
Views
VSAN view
Predefined user roles
network-admin
Parameters
disruptive: Initiates a disruptive reconfiguration. If you do not specify this keyword, the command initiates
a nondisruptive reconfiguration.
This command takes effect only when the fabric configuration function is enabled.
A fabric reconfiguration triggers a principal switch selection phase.
A fabric reconfiguration can be disruptive or nondisruptive.
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.
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
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 WWN, but FC 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 FC
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 member switch fails to get a preferred domain ID from the principal switch, it accepts
any other domain ID assigned by the principal switch. If the member switch fails to get a static domain
ID, it does not accept any other domain ID and isolates the upstream principal link.
HP recommends that you configure domain IDs of the same type for all switches in a VSAN.
Examples
# Configure static domain ID 55 in VSAN 1.
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 configure a fabric name in a VSAN.
Use undo fabric-name to restore the default.
Syntax
fabric-name name
undo fabric-name
Default
The fabric name is the WWN of the switch.
Views
VSAN view
Predefined user roles
network-admin
Parameters
name: Specifies a fabric name, in the format of xx:xx:xx:xx:xx:xx:xx:xx, where x is a hexadecimal
number.
Usage guidelines
An FC switch supports assigning a fabric name to each VSAN, in the same format as the WWN (a 64-bit
address).
You need to configure fabric names only when you build a fabric statically. You must configure the same
fabric name on all switches in a VSAN. In a dynamically built fabric, each VSAN uses the WWN of the
principal switch as the fabric name.
Examples
# Configure a fabric name of 10:11:12:13:14:15:16:17 in VSAN 1.
system-view
[Sysname] vsan 1
[Sysname-vsan1] fabric-name 10:11:12:13:14:15:16:17
fc domain rcf-reject
Use fc domain rcf-reject to configure an interface to reject the ReConfigure Fabric (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
An interface does not reject the received RCF requests.
Views
FC interface view, FC aggregate interface view, VFC interface view
Predefined user roles
network-admin
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839.
Usage guidelines
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, the switch replies with a reject message
and isolates the interface that receives an RCF request.
Examples
# Configure interface FC 1/0/1 to reject the RCF requests received in VSAN 1.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] fc domain rcf-reject vsan 1
# Configure interface VFC 1 to reject the RCF requests received in VSAN 1.
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.
Use undo fc name-service auto-discovery to disable SCSI-FCP information autodiscovery.
Syntax
fc name-service auto-discovery
undo fc name-service auto-discovery
Default
Auto discovery of SCSI-FCP information is enabled.
Views
VSAN view
Predefined user roles
network-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. Therefore, 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.
system-view
[Sysname] vsan 2
[Sysname-vsan2] fc name-server auto-discovery
fc timer distributed-services
Use fc timer distributed-services to specify 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
value: Specifies the distributed service timeout period in the range of 5000 to 10000 milliseconds.
Usage guidelines
The distributed service timeout period can be configured in system view or VSAN view.
•
The configuration in system view takes effect on all VSANs. The configuration in VSAN view takes
effect only on the current VSAN.
•
If you configure the distributed service timeout period both globally and for a VSAN, the
configuration for the VSAN is given priority.
Examples
# Set the global distributed service timeout period to 6000 milliseconds.
system-view
[Sysname] fc timer distributed-services 6000
Related commands
timer distributed-services
fc timer error-detect
Use fc timer error-detect to specify the global error detection timeout period.
Use undo fc timer error-detect to restore the default.
Syntax
fc timer error-detect value
undo fc timer error-detect
Default
The global error detection timeout period is 2000 milliseconds.
Views
System view
Predefined user roles
network-admin
Parameters
value: Specifies the error detection timeout period in the range of 1000 to 10000 milliseconds.
Usage guidelines
The error detection timeout period can be configured in system view or VSAN view.
•
The configuration in system view takes effect on all VSANs. The configuration in VSAN view takes
effect only on the current VSAN.
•
If you configure the error detection timeout period both globally and for a VSAN, the configuration
for the VSAN is given priority.
Examples
# Set the global error detection timeout period to 6000 milliseconds.
system-view
[Sysname] fc timer error-detect 6000
fc timer resource-allocation
Use fc timer resource-allocation to specify the global resource allocation timeout period.
Use undo fc timer resource-allocation to restore the default.
Syntax
fc timer resource-allocation value
undo fc timer resource-allocation
Default
The global resource allocation timeout period is 10000 milliseconds.
Views
System view
Predefined user roles
network-admin
Parameters
value: Specifies the resource allocation timeout period in the range of 5000 to 10000 milliseconds.
Usage guidelines
The resource allocation timeout period can be configured in system view or VSAN view.
•
The configuration in system view takes effect on all VSANs. The configuration in VSAN view takes
effect only on the current VSAN.
•
If you configure the resource allocation timeout period both globally and for a VSAN, the
configuration for the VSAN is given priority.
Examples
# Set the global resource allocation timeout period to 6000 milliseconds.
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 }
No default FC4 information is configured.
Views
System view
Predefined user roles
network-admin
Parameters
wwn-value: Specifies an N_Port by its WWN in the format of xx:xx:xx:xx:xx:xx:xx:xx (hexadecimal).
type-value: Specifies a supported FC4-Type by its value in the range of 0 to 255. The FC4-Type field is
256 bits, each of which represents an FC4-Type. If a bit is set to 1, the FC4-Type that the bit represents
is supported. Only one bit can be set to 1 at the same time.
scsi-fcp: Specifies the supported FC4-Type as SCSI-FCP, which has a type-value of 8.
feature feature-map: Specifies the Feature value for the supported FC4-Type. The value range for
feature-map is 0 to 15. The Feature field is 4 bits, each of which represents a Feature. If a bit is set to 1,
the Feature that the bit represents is supported. Multiple bits can be set to 1 at the same time. For example,
if the value is set to 15, the node supports four Features of the FC4-Type. If the value is set to 0, the node
supports none of the four Features. When you specify supported FC4-Type as SCSI-FCP, you can
configure the following keywords:
•
initiator: Specifies support for the initiator Feature, which has a feature-map of 2.
•
target: Specifies support for the target Feature, which has a feature-map of 1.
•
both: Specifies support for both initiator and target Features, which has a feature-map of 3.
Usage guidelines
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.
This command 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.
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 configure the switch priority in a VSAN.
Use undo priority to restore the default.
The switch priority is 128 in a VSAN.
Views
VSAN view
Predefined user roles
network-admin
Parameters
value: Specifies the switch priority in the range of 1 to 254.
Usage guidelines
The priority value for FC switches is in the range of 1 to 254. The smaller the value, the higher the priority.
The FC switch with the highest priority will become the principal switch.
The priority is configured on a per-VSAN basis, and one FC switch can have different priorities in
different VSANs.
The priority configuration for the switch does not take effect until a disruptive reconfiguration is performed
by using the domain restart disruptive command.
Examples
# Configure the switch priority as 64 in VSAN 1.
system-view
[Sysname] vsan 1
[Sysname-vsan1] priority 64
Related commands
domain restart
rscn aggregation enable
Use rscn aggregation enable to enable RSCN aggregation.
Use undo rscn aggregation enable to disable RSCN aggregation.
Syntax
rscn aggregation enable
undo rscn aggregation enable
Default
RSCN aggregation is disabled.
Views
VSAN view
Predefined user roles
network-admin
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 reduces the number
of RSCNs sent to the concerned registered nodes.
HP recommends that you enable RSCN aggregation and set the same timer value on all switches in a
VSAN.
Examples
# Enable RSCN aggregation in VSAN 1.
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
Parameters
time: Specifies a value for the RSCN aggregation timer, in the range of 100 to 2000 milliseconds.
Usage guidelines
The RSCN aggregation timer takes effect only when RSCN aggregation is enabled.
HP recommends that you enable RSCN aggregation and set the same timer value on all switches in a
VSAN.
Examples
# Set the RSCN aggregation timer of VSAN 1 to 1500 milliseconds.
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
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.
system-view
[Sysname] snmp-agent trap enable fc-fabric domain-id-change
# Enable SNMP notifications for fabric changes.
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.
snmp-agent trap enable fc-name-service [ login| logout ] *
undo snmp-agent trap enable fc-name-service [ login| logout ] *
Default
All SNMP notifications for the name service module are disabled.
Views
System view
Predefined user roles
network-admin
Parameters
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.
system-view
[Sysname] snmp-agent trap enable fc-name-service login
timer distributed-services
Use timer distributed-services to specify 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
value: Specifies the distributed service timeout period in the range of 5000 to 10000 milliseconds.
Usage guidelines
The distributed service timeout period can be configured in system view or VSAN view.
•
The configuration in system view takes effect on all VSANs. The configuration in VSAN view takes
effect only on the current VSAN.
•
If you configure the distributed service timeout period both globally and for a VSAN, the
configuration for the VSAN is given priority.
Examples
# Set the distributed service timeout period to 6000 milliseconds for VSAN 1.
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 specify 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
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 configured in system view or VSAN view.
•
The configuration in system view takes effect on all VSANs. The configuration in VSAN view takes
effect only on the current VSAN.
•
If you configure the error detection timeout period both globally and for a VSAN, the configuration
for the VSAN is given priority.
Examples
# Set the error detection timeout period to 6000 milliseconds for VSAN 1.
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 specify 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
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 configured in system view or VSAN view.
•
The configuration in system view takes effect on all VSANs. The configuration in VSAN view takes
effect only on the current VSAN.
•
If you configure the resource allocation timeout period both globally and for a VSAN, the
configuration for the VSAN is given priority.
Examples
# Set the resource allocation timeout period to 6000 milliseconds for VSAN 1.
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 remove 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
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 N_Port here indicates an N_Port on a node or an NP_Port on an NPV switch.
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).
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
display fc exchange { link | protocol } [ slot slot-number ]
display fc exchange link verbose [ slot slot-number [ exid exid ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
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 an IRF member device by its member ID (slot number). If you do not specify an
IRF member device, this command displays exchange entries for the master device.
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
# Display the protocol exchange entries.
display fc exchange protocol slot 1
Local_ID:EXID Remote_ID:EXID State Slot Protocol
0x000000:65535 0x000000:65535 LISTEN 1 6
# Display the link exchange entries.
display fc exchange link slot 2
Local_ID:EXID Remote_ID:EXID State Slot Protocol
0x060501:1024 0x010001:1025 ESTABLISHED 2 8
# Display detailed information about the link exchange entries.
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 21 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.
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
IRF member device where the FC exchange is created.
Protocol/protocol
FC protocol number.
PCB flags
FC exchange state flags:
• 0x1—The value 0 indicates the sending end, and 1 indicates the
replying end.
• 0x2—The value 0 means there is no initiative, and 1 means there is
initiative.
• 0x4—The value 1 indicates the first packet of the exchange.
• 0x8—The value 1 indicates that the exchange is waiting to be aged.
FC Class
FC connection service level (FC_CLASS_3 requires no ACK):
• FC_CLASS_1.
• FC_CLASS_2.
• FC_CLASS_3.
• FC_CLASS_F.
• FC_CLASS_6.
display fc fib
Use display fc fib to display the FC FIB entries.
Syntax
display fc fib [ fcid [ mask-length ] ] vsan vsan-id
Views
Any view
Predefined user roles
network-admin
network-operator
fcid: Specifies a destination FC address in the range of 0x000000 to 0xFFFFFF (hexadecimal).
mask-length: Specifies a 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 device looks up the VSAN ID and FC address in the FC FIB for the outgoing interface.
If you specify both the fcid and mask-length arguments, this command displays FC FIB entries for the
specified FC address and mask length.
If you specify the fcid argument but not the mask-length argument, this command displays FC FIB entries
for the specified FC address according to the longest matching rule.
If you do not specify the fcid argument or the mask-length argument, this command displays all FC FIB
entries.
Examples
# Display all the FC FIB entries in VSAN 18.
display fc fib vsan 18
FC FIB information in VSAN 18:
Destination count: 6
FIB entry count: 7
Destination/Mask Interface
0x030100/16 Fc1/0/1
0x030100/16 Fc1/0/2
0x030100/24 Fc1/0/3
0xfffc01/24 InLoop0
0xfffffa/24 InLoop0
0xfffffc/24 InLoop0
0xfffffd/24 InLoop0
# Display the FC FIB entries for the specified FC address according to the longest matching rule.
display fc fib 030100 vsan 18
FC FIB information in VSAN 18:
Destination count: 1
FIB entry count: 1
Destination/Mask Interface
0x030100/24 Fc1/0/3
# Display the FC FIB entries for the specified FC address and mask length.
display fc fib 030100 16 vsan 18
FC FIB information in VSAN 18:
Destination count: 1
FIB entry count: 2
Destination/Mask Interface
0x030100/16 Fc1/0/1
0x030100/16 Fc1/0/2
Table 22 Command output
Field
Description
Destination count
Number of destination addresses.
FIB entry count
Number of FIB entries, including equal-cost routes.
Destination/Mask
Destination address/mask length.
Interface
Outgoing interface.
display fc routing-table
Use display fc routing-table to display the FC routing table.
Syntax
display fc routing-table [ vsan vsan-id ] [ statistics | verbose ]
display fc routing-table vsan vsan-id fcid [ mask | mask-length ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 4095. If you do not specify a VSAN, this
command displays routing information of all VSANs.
fcid: Specifies the destination FC address for static FC routes, in the range of 0x010000 to 0xFFFFFF
(hexadecimal).
mask: Specifies a hexadecimal mask of the FC address. This argument is used together with the fcid
argument. The value of this argument can be 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 a decimal mask of the FC address. This argument is used together with the fcid
argument. The value of this argument can be 8, 16, or 24. If you do not specify a decimal mask, this
command displays the routing information for the FC address fcid with masks 8, 16, and 24.
statistics: Displays the statistics for the FC routing table.
verbose: Displays detailed information about the FC routing table.
Usage guidelines
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.
# Display brief information about all the routes in VSAN 5.
Table 23 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.
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 24 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.
Number of deleted routes of the specified protocol type.
Total
Total number of routes.
Related commands
fc route-static
display fspf graceful-restart
Use display fspf graceful-restart to display FSPF GR status information.
Syntax
display fspf graceful-restart [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this
command displays FSPF GR status information for all VSANs.
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 device.
Examples
# Display FSPF GR status information.
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 25 Command output
Field
Description
Graceful-restart capability
Indicates whether GR restarter capability is enabled: Enable or Disable.
Helper capability
Indicates whether GR helper capability is enabled: Enable or Disable.
Number of neighbors under
helper
Number of neighbors acting as GR helpers.
Number of restarting
neighbors
Number of neighbors acting as GR restarters.
Related commands
•
fspf graceful-restart
•
fspf graceful-restart helper
•
fspf graceful-restart interval
display fspf lsdb
Use display fspf lsdb to display FSPF link state database (LSDB) information.
Syntax
display fspf lsdb [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this
command displays LSDB information for all VSANs.
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.
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 26 Command output
Field
Description
FSPF LSDB information of
VSAN
LSDB information for a VSAN. The value in parentheses is the domain ID in
decimal of the local switch.
FSPF Link State Database for
Domain
LSDB information for a domain ID (switch).
LSR Type
LSR type, which can only be Switch Link Record (0x01).
LSR Incarnation number
LSR instance number.
NbrDomainID
Neighbor domain ID.
IfIndex
Outgoing interface index of the local switch.
NbrIfIndex
Neighbor interface index.
Link Type
Link type:
• 0x01—Point-to-point.
• 0xF0-FF—Vendor-defined.
Cost
Link cost.
display fspf neighbor
Use display fspf neighbor to display FSPF neighbor information.
Syntax
display fspf neighbor [ vsan vsan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsan vsan-id: Specifies a VSAN by its ID in the range of 1 to 3839. If you do not specify a VSAN, this
command displays information about all FSPF neighbors.
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.
display fspf neighbor
FSPF neighbor information of VSAN 1(01):
Interface NbrDomain IfIndex NbrIfIndex Dead Time State
Fc1/0/1 2 0x68 0x68 00:01:06 Full
Table 27 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
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.
display fspf statistics
FSPF statistics of VSAN 1(01):
SPF computing count: 6
Statistics counters:
Bad packet : 0 Neighbor unknown : 0
Timer mismatch : 0 Neighbor state low : 0
Bad LSR : 0
Packet statistics:
Type Input Output
HELLO 50 50
LSU 5 5
LSA 4 4
Interface Fc1/0/1 statistics:
Type Input Output
HELLO 50 50
LSU 5 5
LSA 4 4
Table 28 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.
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
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 of the FC address. This argument is used together with the fcid
argument. The value of this argument can be 0xFF0000, 0xFFFF00, or 0xFFFFFF.
mask-length: Specifies a decimal mask of the FC address. This argument is used together with the fcid
argument. The value of this argument can be 8, 16, or 24.
interface-type interface-number: Specifies the outgoing interface of the static FC route, which must be an
existing FC interface or VFC interface on the FC switch.
cost cost-value: Specifies the cost of the route, in the range of 0 to 65535 and defaulting to 0.
Usage guidelines
Static routes are routes that 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:
•
The destination FC address is 0x010000.
The mask length is 8.
•
The outgoing interface is FC 1/0/1.
•
The cost is 20.
system-view
[Sysname] vsan 5
[Sysname-vsan5] fc route-static 010000 8 fc 1/0/1 cost 20
# Add a static FC route:
•
The destination FC address is 0x010000.
•
The mask length is 8.
•
The outgoing interface is VFC 4.
•
The cost is 20.
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 configure the FSPF cost for the 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 of FC interfaces is calculated by using this formula: 1.0*1.062e12/baud rate.
The default FSPF costs for VFC interfaces and FC aggregate interfaces are both 100.
Views
FC interface view, VFC interface view, FC aggregate interface view
Predefined user roles
network-admin
Parameters
value: Specifies the FSPF cost of the interface, in the range of 1 to 65535.
vsan vsan-id: Specifies the VSAN to which the interface belongs, 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
# Configure the FSPF cost of interface FC 1/0/1 in VSAN 4 as 1000.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] fspf cost 1000 vsan 4
# Configure the FSPF cost of interface VFC 1 in VSAN 4 as 1000.
system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fspf cost 1000 vsan 4
fspf dead-interval
Use fspf dead-interval to configure the dead interval for the 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 is 80 seconds.
Views
FC interface view, VFC interface view, FC aggregate interface view
Predefined user roles
network-admin
Parameters
value: Specifies the dead interval of the interface in seconds, in the range of 2 to 65535.
vsan vsan-id: Specifies the VSAN to which the interface belongs, 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 interval during which at least
one hello packet must be received from a neighbor before the neighbor is considered nonexistent and is
removed.
The configured dead interval must be greater than the hello interval and must be the same at the two
ends of the link.
Examples
# Configure the dead interval for interface FC 1/0/1 in VSAN 4 as 100 seconds.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] fspf dead-interval 100 vsan 4
# Configure the dead interval for interface VFC 1 in VSAN 4 as 100 seconds.
system-view
[Sysname] interface vfc 1
[Sysname-Vfc1] fspf dead-interval 100 vsan 4
Related commands
fspf hello-interval
Use fspf enable to enable FSPF for a VSAN.
Use undo fspf enable to disable FSPF for 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
Usage guidelines
FSPF-related functions work in a VSAN only after you enable FSPF for the VSAN.
Examples
# Enable FSPF for VSAN 4.
system-view
[Sysname] vsan 4
[Sysname-vsan4] fspf enable
fspf graceful-restart
Use fspf graceful-restart to enable FSPF GR.
Use undo fspf graceful-restart to disable FSPF GR.
Syntax
fspf graceful-restart
undo fspf graceful-restart
Default
FSPF GR is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
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.
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 configure a device to act as an FSPF GR helper.
Use undo fspf graceful-restart helper to cancel the configuration.
Syntax
fspf graceful-restart helper
undo fspf graceful-restart helper
Default
A device acts as an FSPF GR helper.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The switch can assist the GR restarter in completing the GR process only after it is configured as an FSPF
GR helper.
Examples
# Configure the device to act as an FSPF GR helper.
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 configure 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
Parameters
interval-value: Specifies the maximum FSPF GR interval in seconds, in the range of 40 to 1800.
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
# Configure the maximum FSPF GR interval as 100 seconds.
system-view
[Sysname] fspf graceful-restart interval 100
Related commands
display fspf graceful-restart
fspf hello-interval
Use fspf hello-interval to configure the hello interval for the 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 is 20 seconds.
Views
FC interface view, VFC interface view, FC aggregate interface view
Predefined user roles
network-admin
Parameters
value: Specifies the hello interval in the range of 1 to 65534 seconds.
vsan vsan-id: Specifies the VSAN to which the interface belongs, in the range of 1 to 3839.
The hello interval specifies the time between the hello packets sent periodically by the switch to discover
and maintain neighbor relationships.
The configured hello interval must be smaller than the dead interval and must be the same at the two
ends of the link.
Examples
# Configure the hello interval for interface FC 1/0/1 in VSAN 4 as 10 seconds.
system-view
[Sysname] interface fc 1/0/1
[Sysname-Fc1/0/1] fspf hello-interval 10 vsan 4
# Configure the hello interval for interface VFC 1 in VSAN 4 as 10 seconds.
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 configure 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 is 1 second.
Views
VSAN view
Predefined user roles
network-admin
Parameters
value: Specifies the minimum LSR arrival interval in the range of 0 to 60 seconds.
Usage guidelines
The minimum LSR arrival interval specifies the time between receiving LSRs in a VSAN. Any LSR instances
of the same LSR received within this time are dropped. This helps avoid frequent SPF calculations caused
by LSDB updating.
Examples
# Configure the minimum LSR arrival interval as 10 seconds for VSAN 2.
system-view
[Sysname] vsan 2
[Sysname-vsan2] fspf min-ls-arrival 10
Use fspf min-ls-interval to configure 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 is 5 seconds.
Views
VSAN view
Predefined user roles
network-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
# Configure the minimum LSR refresh interval as 10 seconds for VSAN 2.
system-view
[Sysname] vsan 2
[Sysname-vsan2] fspf min-ls-interval 10
fspf retransmit-interval
Use fspf retransmit-interval to configure the LSR retransmission interval for the 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 is 5 seconds.
Views
FC interface view, VFC interface view, FC aggregate interface view
Predefined user roles
network-admin