N Commands
The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See "About the CLI Command Modes" section on page 1-3 to determine the appropriate mode for each command.
native-autonomous-fabric-num
To create an IVR persistent FC ID database entry, use the native-autonomous-fabric-num command in fcdomain database configuration submode. To delete all IVR persistent FC ID database entries for a given AFID and VSAN, use the no form of the command.
native-autonomous-fabric-num afid-num native-vsan vsan-id domain domain-id
no native-autonomous-fabric-num afid-num native-vsan vsan-id domain domain-id
Syntax Description
afid-num |
Specifies the native AFID. The range is 1 to 64. |
native-vsan vsan-id |
Specifies the native VSAN ID. The range is 1 to 4093. |
domain domain-id |
Specifies the domain ID. The range is 1 to 239. |
Defaults
None.
Command Modes
fcdomain database configuration submode.
Command History
|
|
2.1(2) |
This command was introduced. |
Usage Guidelines
There is only one domain ID associated with an AFID and VSAN. If you change the domain ID, all the associated FC ID mapping records are also changed.
Examples
The following example shows how to create an entry for a native AFID, VSAN, and domain:
switch(config)# ivr fcdomain database autonomous-fabric-num 10 vsan 20
switch(config-fcdomain)# native-autonomous-fabric-num 20 native-vsan 30 domain 15
switch(config-fcdomain-fcid)#
The following example shows how to remove all entries for a native AFID and VSAN:
switch(config)# ivr fcdomain database autonomous-fabric-num 10 vsan 20
switch(config-fcdomain)# no native-autonomous-fabric-num 20 native-vsan 30
Related Commands
|
|
ivr fcdomain database autonomous-fabric-num |
Creates IVR persistent FC IDs. |
show ivr fcdomain database |
Displays IVR fcdomain database entry information. |
node (Cisco IOA cluster node configuration submode)
To configure IOA switch, use the node command. To delete a node to the cluster, use the no form of the command.
node {local | remote-node-name or ip-address }
no node {local | remote-node-name or ip-address }
Syntax Description
local |
Specifies local node as a part of the cluster. |
remote-node-name |
Specifies either through the DNS name or IPV4/IPV6 address. |
Defaults
None.
Command Modes
Cisco IOA cluster node configuration submode.
Command History
|
|
NX-OS 4.2(1) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example shows how to configure the local switch:
switch(config)# ioa cluster tape_vault
switch#(config-ioa-cl)# node local
switch(config-ioa-cl-node)# node 172.23.144.95
2009 May 19 21:06:57 sjc-sw2 %CLUSTER-2-CLUSTER_QUORUM_GAIN: Cluster 0x2143000dec3ee782
now has quorum with 1 nodes
2009 May 19 21:07:03 sjc-sw2 %CLUSTER-2-CLUSTER_QUORUM_GAIN: Cluster 0x2143000dec3ee782
now has quorum with 2 nodes
sjc-sw2(config-ioa-cl-node)# end
Related Commands
|
|
interface ioa |
Configures the IOA interface. |
node
To configure Cisco SME switch, use the node command. To disable this command, use the no form of the command.
node {local | {A.B.C.D | X:X::X /n| DNS name}}
no node {local | {A.B.C.D | X:X::X /n| DNS name}}
Syntax Description
local |
Configures the local switch. |
A.B.C.D |
Specifies the IP address of the remote switch in IPv4 format. |
X:X::X/n |
Specifies the IP address of the remote switch in IPv6 format. |
DNS name |
Specifies the name of the remote database. |
Defaults
None.
Command Modes
Cisco SME cluster configuration submode.
Command History
|
|
3.2(2) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example adds the Cisco SME interface from a local switch:
switch(config)# sme cluster c1
switch(config-sme-cl)# node local
switch(config-sme-cl-node)#
The following example adds the Cisco SME interface from a remote switch:
switch(config))# sme cluster c1
switch(config-sme-cl)# node 171.71.23.33
switch(config-sme-cl-node)#
Related Commands
|
|
show sme cluster cluster name node |
Displays Cisco SME node information about a local or remote switch. |
npiv enable
To enable N port identifier virtualization (NPIV) for all VSANs on a switch, use the npiv enable command in configuration mode. To disable NPIV, use the no form of the command.
npiv enable
no npiv enable
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
|
|
3.0(1) |
This command was introduced. |
Usage Guidelines
NPIV provides a means to assign multiple port IDs to a single N Port. This feature allows multiple applications on the N port to use different identifiers and allows access control, zoning, and port security to be implemented at the application level.
You must globally enable NPIV for all VSANs on the MDS switch to allow the NPIV-enabled applications to use multiple N port identifiers.
Note All of the N Port Identifiers are allocated in the same VSAN.
Examples
The following example enables NPIV for all VSANs on the switch:
switch(config)# npiv enable
The following example disables NPIV for all VSANs on the switch:
switch(config)# no npiv enable
Related Commands
|
|
show interface |
Displays interface configurations. |
nport
To configure the site and VSAN ID of the N ports, use the nport command. To delete the N port from the IOA cluster, use the no form of the command.
nport {pwwn pwwn site site name vsan vsan-id}
no nport {pwwn pwwn site site name vsan vsan-id}
Syntax Description
pwwn |
Specifies the N port. |
pwwn |
Specifies the N port PWWN. The format is hh:hh:hh:hh:hh:hh:hh:hh. |
site |
Specifies an IOA site. |
site name |
Specifies an IOA site name. The maximum length is 31 characters. |
vsan |
Specifies the VSAN where this flow is accelerated. |
vsan id |
Specifies the VSAN ID where this flow is accelerated. The range is from 1 to 4093. |
Defaults
None.
Command Modes
Configuration mode.
Command History
|
|
NX-OS 4.2(1) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example shows how to configure the site and VSAN ID of the N port:
switch(config-ioa-cl)# nport pwwn 10:0:0:0:0:0:0:1 site SJC vsan 100
switch(config-ioa-cl)# no nport pwwn 11:0:0:0:0:0:0:1 site SJC vsan 100
switch(config-ioa-cl)# end
Related Commands
|
|
show ioa cluster summary |
Displays the summary of all the IOA clusters. |
nport pwwn
To configure the N Port pWWN for the SAN extension tuner, use the nport pwwn command in SAN extension configuration mode. To revert to the default value, use the no form of the command.
nport pwwn pwwn-id vsan vsan-id interface gigabitethernet slot/port
no nport pwwn pwwn-id vsan vsan-id interface gigabitethernet slot/port
Syntax Description
pwwn-id |
Specifies the port WWN ID. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. |
vsan vsan-id |
Specifies the VSAN ID. The range is 1 to 4093. |
interface gigabitethernet slot/port |
Specifies the Gigabit Ethernet interface slot and port. |
Defaults
None.
Command Modes
SAN extension configuration mode.
Command History
|
|
2.0(x) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example shows how to add an entry to the SAN extension tuner database:
switch(san-ext)# nport pwwn 11:22:33:44:55:66:77:88 vsan 1 interface gigabitethernet 1/1
Related Commands
|
|
san-ext-tuner |
Enters SAN extension configuration mode. |
show san-ext-tuner |
Shows SAN extension tuner information. |
npv enable
To enable N port virtualization (NPV), use the npv enable command in configuration mode. To disable this feature, use the no form of the command.
npv enable
no npv enable
Syntax Description
This command has no other arguments or keywords. |
Defaults
None.
Command Modes
Configuration mode.
Command History
|
|
3.2(1) |
This command was introduced. |
Usage Guidelines
When NPV is enabled, all configurations are erased and the switch is rebooted. The switch restarts in the NPV mode. All configuration and verification commands for NPV are available only when NPV is enabled on the switch. When you disable this feature, all related configurations are automatically erased and the switch is rebooted.
Examples
The following example shows how to enable NPV:
switch(config)# npv enable
Related Commands
|
|
show npv status |
Displays the NPV current status. |
npv auto-load-balance disruptive
To enable autoload balance disruptive, use the npv auto-load-balance disruptive command in configuration mode. To disable this feature, use the no form of the command.
npv auto load-balancing disruptive
no npv auto load-balancing disruptive
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
|
|
3.3(1) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example shows how to enable autoload balance disruptive:
switch(config)# npv auto-load-balance disruptive
Enabling this feature may flap the server intefaces whenever load is not in a ba
lanced state. This process may result in traffic disruption. Do you want to proc
Related Commands
|
|
npv traffic-map server interface |
Configures server interface traffic engineering. |
npv traffic-map server-interface
To configure the server interface based traffic engineering, use the npv traffic-map server-interface command in configuration mode. To revert to the default value, use the no form of the command.
npv traffic-map server-interface if -range external-interface if-range
no npv traffic-map server-interface if-range external-interface if-range
Syntax Description
if-range |
Range may vary from 1 to 1. |
Defaults
None.
Command Modes
Configuration mode.
Command History
|
|
3.3(1a) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example shows how to configure NPV traffic map server interface:
switch(config)# npv traffic-map server-interface fc1/1 external-interface fc1/2
switch(config)# npv traffic-map server-interface fc1/4-5 external-interface fc1/6-7
switch(config)# no npv traffic-map server-interface fc1/4-5 external-interface fc1/6-7
switch(config)# no npv traffic-map server-interface fc1/1 external-interface fc1/2
Related Commands
|
|
show npv-traffic-map |
Displays information about the NPV traffic map. |
ntp
To configure NTP settings on the switch, use the ntp command in configuration mode.
ntp {peer hostname | server | tstamp-check}
Syntax Description
peer hostname |
The hostname and IP address of the NTP peer (Maximum Size is 80). |
server |
The hostname and IP address of the NTP server (Maximum Size is 80). |
tstamp-check |
Enables or disables the Timestamp Check. |
Defaults
This command has no default settings.
Command Modes
Configuration mode.
Command History
|
|
NX-OS 4.1(3) |
Added a Note. |
1.0(2) |
This command was introduced. |
Usage Guidelines
None.
Note If the MDS switch does not see the server's time updates for a longer than period of time, it starts polling the server, or it may not poll the server at all. Even after the poll, if the time updates are not coming, the poll interval is reduced until it can elicit a response. The poll interval is reduced up to a minimum of 4 seconds.
Examples
This example forms a server association with a server:
switch(config)# ntp server 10.10.10.10
This example forms a peer association with a peer. You can specify multiple associations:
switch(config)# ntp peer 10.20.10.0
Related Commands
|
|
ntp distribute |
Enables CFS distribution for NTP. |
show ntp |
Displays NTP information. |
ntp abort
To discard the Network Time Protocol (NTP) Cisco Fabric Services (CFS) distribution session in progress, use the ntp abort command in configuration mode.
ntp abort
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
|
|
2.0(x) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example shows how to configure NTP CFS distribution session in progress:
switch(config)# ntp abort
Related Commands
|
|
ntp distribute |
Enables CFS distribution for NTP. |
show ntp |
Displays NTP information. |
ntp commit
To apply the pending configuration pertaining to the Network Time Protocol (NTP) Cisco Fabric Services (CFS) distribution session in progress in the fabric, use the ntp commit command in configuration mode.
ntp commit
Syntax Description
This command has no other arguments or keywords.
Defaults
None.
Command Modes
Configuration mode.
Command History
|
|
2.0(x) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example shows how to commit changes to the active NTP configuration:
switch(config)# ntp commit
Related Commands
|
|
ntp distribute |
Enables CFS distribution for NTP. |
show ntp |
Displays NTP information. |
ntp distribute
To enable Cisco Fabric Services (CFS) distribution for Network Time Protocol (NTP), use the ntp distribute command. To disable this feature, use the no form of the command.
ntp distribute
no ntp distribute
Syntax Description
This command has no other arguments or keywords.
Defaults
Disabled.
Command Modes
Configuration mode.
Command History
This command was introduced in Cisco MDS SAN-OS Release 1.0(2).
Command History
|
|
2.0(x) |
This command was introduced. |
Usage Guidelines
Before distributing the Fibre Channel timer changes to the fabric, the temporary changes to the configuration must be committed to the active configuration using the ntp commit command.
Examples
The following example shows how to distribute the active NTP configuration to the fabric:
switch(config)# ntp distribute
Related Commands
|
|
ntp commit |
Commits the NTP configuration changes to the active configuration. |
show ntp |
Displays NTP information. |
ntp sync-retry
To retry synchronization with configured servers, use the ntp sync-retry command.
ntp sync-retry
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
EXEC mode.
Command History
|
|
4.1(1b) |
Added a note. |
3.3(1a) |
This command was introduced. |
Usage Guidelines
None.
Note If the user changes the mgmt0 ip address, NX-OS should conditionally do an internal ntp syncronization-retry.
Examples
The following example displays the sup-fc0 message logs:
Related Commands
|
|
ntp distribute |
Enables CFS distribution for NTP. |
show ntp |
Displays NTP information. |
nwwn (DPVM database configuration submode)
To add a device to a dynamic port VSAN membership (DPVM) database using the nWWN, use the nwwn command in DPVM database configuration submode. To remove a device from a DPVM database using the nWWN, use the no form of the command.
nwwn nwwn-id vsan vsan-id
no nwwn nwwn-id vsan vsan-id
Syntax Description
nwwn-id |
Specifies the node WWN ID. The format is hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. |
vsan vsan-id |
Specifies the VSAN ID. The range is 1 to 4093. |
Defaults
None.
Command Modes
DPVM database configuration submode.
Command History
|
|
2.0(x) |
This command was introduced. |
Usage Guidelines
To use this command, DPVM must be enabled using the dpvm enable command.
Examples
The following example shows how to add an entry to the DPVM database:
switch(config)# dpvm database
switch(config-dpvm-db)# nwwn 11:22:33:44:55:66:77:88 vsan 1
The following example shows how to delete an entry from the DPVM database:
switch(config-dpvm-db)# no nwwn 11:22:33:44:55:66:77:88 vsan 1
Related Commands
|
|
dpvm database |
Configures the DPVM database. |
show dpvm |
Displays DPVM database information. |
nwwn (SAN extension configuration mode)
To configure the nWWN for the SAN extension tuner, use the nwwn command in SAN extension configuration submode.
nwwn nwwn-id
Syntax Description
nwwn-id |
Specifies the nWWN address. The format is hh:hh:hh:hh:hh:hh:hh:hh, where h is a hexadecimal number. |
Defaults
None.
Command Modes
SAN extension configuration mode.
Command History
|
|
2.0(x) |
This command was introduced. |
Usage Guidelines
None.
Examples
The following example shows how to add an entry to the SAN extension tuner database:
switch(san-ext)# nwwn 20:42:00:0b:46:79:f1:80
Related Commands
|
|
san-ext-tuner |
Enters SAN extension configuration mode. |
show san-ext-tuner |
Shows SAN extension tuner information. |