Table Of Contents
Command Line Interface Command Reference
CLI Usage Tips
Add Commands
add accesslist
add route gw
add scsirouter deviceif
add scsirouter serverif
add scsirouter target loopid
add scsirouter target wwpn
add scsirouter target lun loopid lun
add scsirouter target lun wwpn lun
add scsirouter target lun wwnn
add scsirouter target {loopid | wwpn | wwnn}
Create Commands
create accesslist
create scsirouter
Delete Commands
delete accesslist
delete route
delete savedconfig
delete scsirouter
delete software version
Download Commands
download software list
download software readme
download software url
download software version
Failover Commands
failover all
failover scsirouter
Import Command
import file
import savedconfig
Restore From Commands
restore accesslist from
restore all from
restore scsirouter from
Save Commands
save accesslist
save all
save scsirouter
save system
Session Control Commands
enable
exit
help
logout
ping
reboot
tzselect
verify software version
Set Commands
set admin contactinfo
set admin password
set clock
set cluster
set debug
set ha import pending none
set ha ipaddress
set interface
set log level
set log remote
set mgmt ipaddress
set monitor password
set nameserver
set ntpserver
set scsirouter description
set scsirouter loglevel
set scsirouter primary
set scsirouter target accesslist
set scsirouter target description
set scsirouter target {enable | disable}
set secnameserver
set snmp
set software url
set software user
set software version
set systemname
set timezone
Setup and Clear Configuration Wizards
clearconf
setup
setup access
setup ha
setup mgmt
setup netmgmt
setup scsi
setup time
Show Commands
show accesslist
show admin
show boot
show buffer
show clock
show cluster
show cpu
show crash
show devices
show debug
show diagnostics
show ha
show interface
show log
show memory
show modules
show net
show nfs
show savedconfig
show scsirouter
show snmp
show software
show stack
show system
show task
show tech-support
Start Commands
start scsirouter
start scsirouter force
Stop Commands
stop scsirouter
stop scsirouter force
Command Line Interface Command Reference
The Cisco SN 5420 Storage Router provides three interfaces for operation, configuration and administration, maintenance, and support tasks — command line interface (CLI), web-based GUI, and SNMP. This chapter documents the SN 5420 CLI. For help on the web-based GUI, point your browser at the management IP address for the SN 5420. After logging in, click the Help link to access the online help system.
This chapter provides information about the following CLI topics:
•
CLI Usage Tips
•Add Commands
•Create Commands
•Delete Commands
•Download Commands
•Failover Commands
•Import Command
•Restore From Commands
•Save Commands
•Session Control Commands
•Set Commands
•Setup and Clear Configuration Wizards
•Show Commands
•Start Commands
•Stop Commands
CLI Usage Tips
•Use the Tab key to complete the current word up to a point of ambiguity.
•Use the Question Mark ( ? ) key to list all of the options available at that point in the command line.
•Commands and keywords can be truncated at any point after they are unique.
•The CLI is case sensitive. All commands and keywords must be entered in lower case; user-defined strings can appear in any case (including mixed case). Case for user-defined strings is preserved in the configuration.
•An asterisk ( * ) at the beginning of the CLI command prompt indicates that the system configuration has been changed but not saved.
Add Commands
The add commands add configuration data to an entity created with a create command or to the SN 5420 system routing table.
Use the add commands to perform the following actions (Table 7-1):
Table 7-1 Add Command Actions
Action
|
Commands
|
Add the IP address and network mask of each server allowed to access a common set of storage resources to the specified access list.
|
add accesslist
|
Add a static route to the routing table in the SN 5420.
|
add route gw
|
Add the following parameters to the named SCSI routing services instance:
•IP interface to servers
•storage interface
•targets
The target element is a complex item that specifies the mapping between LUNs on the storage devices and servers. This series of commands provides target-only mapping and target-and-LUN mapping methods for mapping logical target and LUN names to the following types of storage addresses: LoopID, WWPN (World-Wide Port Numbers), and WWNN (World-Wide Node Names). In addition, this series of commands provides an indexed selection method of mapping. The indexed selection commands discover storage resources and assign an index number to each resource. The commands map logical target and LUN names as target-only or LUN-mapped storage resources by index number (instead of by physical storage address).
|
add scsirouter
The following variations of this command provide the means to perform the actions described:
•add scsirouter serverif
•add scsirouter deviceif
•add scsirouter target
|
Note All add commands update the currently running configuration. Use the save commands to retain the added configuration data in the storage router when it is rebooted.
add accesslist
To add the IP address and network mask of servers to the named access list, use the add accesslist command.
add accesslist name A.B.C.D/bits | A.B.C.D/1.2.3.4 [A.B.C.D/bits | A.B.C.D/1.2.3.4], . .
[A.B.D.F/bits | A.B.C.D/1.2.3.4]
Syntax Description
name
|
Name of access list to which you are adding information.
|
A.B.C.D/bits
|
IP address and network mask of the server(s) being added to the access list. A.B.C.D is the dotted quad notation of a server IP address. The /bits specifies the network mask in CIDR style.
|
A.B.C.D/1.2.3.4
|
The IP address and network mask of the server(s) being added to the access list. A.B.C.D is the dotted quad notation of a server IP address. 1.2.3.4 is the dotted quad notation of the network mask.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Access lists specify the IP addresses of the servers allowed to access a common set of storage resources via the SN 5420 Storage Router. Use the add accesslist command after creating an access list entity to populate the list.
Enter multiple addresses and masks, separating each by a space or a comma.
Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the add accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the SN 5420 in a cluster, see "Maintaining and Managing the SN 5420."
Examples
The following command adds the specified entries to the named access list.
add accesslist myAccessList 192.168.54.12/32, 192.168.54.15/32
add accesslist Webserver5 209.165.200.232/255.255.255.255 209.165.202.0/255.255.255.0
Related Commands
Command
|
Description
|
create accesslist
|
Create the named access list entity.
|
delete accesslist
|
Delete a specific access list entry, or an entire access list.
|
restore accesslist from
|
Restore the named access list, or all access lists, from the named configuration file.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
set scsirouter target accesslist
|
Associate access list with a specific SCSI routing services target or all targets.
|
show accesslist
|
Show the contents of the named access list or all access lists.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
add route gw
To add a static route to the SN 5420 routing table, use the add route gw command. The specified IP address is accessed via the gateway (gw) specified in the command.
add route {A.B.C.D/bits | A.B.C.D/1.2.3.4 | default} gw E.F.G.H
Syntax Description
A.B.C.D/bits
|
The IP address of the specified interface. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the network mask in CIDR style.
|
A.B.C.D/1.2.3.4
|
The IP address of the specified interface. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the network mask.
|
default
|
The default route (0.0.0.0/32).
|
gw E.F.G.H
|
The gateway IP address through which the specified IP address/network mask (A.B.C.D/bits or A.B.C.D/1.2.3.4) is accessed.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
All IP interfaces in the storage router use the routing table to reach services and networks outside their local network. Other facilities, such as SNMP and connections to an NTP server or DNS servers, may also use the routing table. Use the add route gw command to set routes for servers or networks outside the local networks associated with the storage router's IP interfaces.
Examples
The following command adds the default route with the specified gateway to the SN 5420 routing table.
add route default gw 10.1.10.1
The following command adds a unique route, specifying the network mask in dotted quad notation.
add route 10.1.30.0/255.255.255.0 gw 10.1.30.10
Related Commands
Command
|
Description
|
delete route
|
Remove the specified route from the system routing table.
|
show net route
|
Display the SN 5420 routing table.
|
add scsirouter deviceif
To add an interface to the named SCSI routing services instance and associate it with storage devices, use the add scsirouter deviceif command. The specified interface acts as the SCSI protocol initiator to the storage devices.
add scsirouter name deviceif fc?
Syntax Description
name
|
Name of the SCSI routing services instance to which you are adding the storage interface.
|
deviceif fc?
|
The name of the storage device interface. When you type the add scsirouter deviceif command, followed by ?, the CLI lists the interfaces available. You cannot specify a nonexistent interface.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use the add scsirouter commands after creating the SCSI routing services instance to configure each of the three required active elements:
•The deviceif element specifies the interface available for the storage devices. The instance becomes active when this interface is added.
•The serverif element assigns an interface and IP address for use by the servers requiring IP access to storage devices.
•The target element is a complex item that specifies the mapping between LUNs on the storage devices and the host systems.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses to an access list.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add scsirouter target
|
Associate targets with the named SCSI routing service instance.
|
create accesslist
|
Create an access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete scsirouter
|
Delete the named element (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named instance, or for all instances, of SCSI routing services.
|
set interface
|
Set operational characteristics for the specified data interface.
|
set scsirouter
|
Associate additional parameter values with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances, of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
add scsirouter serverif
To assign an interface and IP address for use by the servers using the named SCSI routing services instance, use the add scsirouter serverif command. The specified IP address is configured on servers requiring IP access to storage through the SN 5420 Storage Router.
add scsirouter name serverif {ge? | fc?} {A.B.C.D/bits | A.B.C.D/1.2.3.4}
Syntax Description
name
|
Name of the SCSI routing services to which you are adding the IP interface.
|
serverif {ge? | fc?}
|
The name of the interface. When you type the add scsirouter serverif command, followed by ?, the CLI lists the interfaces available. You cannot specify a nonexistent interface.
|
A.B.C.D/bits
|
The IP address of the named interface. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the network mask in CIDR style.
|
A.B.C.D/1.2.3.4
|
The IP address of the named interface. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the network mask.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use the add scsirouter command after creating a SCSI routing services instance to configure one of the three required active elements:
•The deviceif element specifies the interface available for the storage devices. The instance becomes active when this interface is added.
•The serverif element assigns an interface and IP address for use by the servers requiring IP access to storage devices.
•The target element is a complex item that specifies the mapping between LUNs on the storage devices and the host systems.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses to an access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter target
|
Associate targets with the named SCSI routing services instance.
|
create accesslist
|
Create an access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set interface
|
Set operational characteristics for the specified data interface.
|
set scsirouter
|
Associate additional parameter values with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
add scsirouter target loopid
To map a logical target to a loop ID storage address using a target-only method of mapping, use the add scsirouter target loopid command.
add scsirouter name target name loopid nn
Syntax Description
name
|
Name of the SCSI routing services instance to which you are adding the storage target.
|
target name
|
A user-specified name of the logical target.
|
loopid nn
|
Specifies a loop ID number, which is an integer between 0 and 125.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The add scsirouter target loopid command requires only a logical target name to be mapped to a physical target address — no LUNs are specified. However, all LUNs that are part of the physical target address are discovered and made apparent as LUNs belonging to the logical target.
When a target is added, it is (by default) enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any servers. Use the set scsirouter target {enable | disable} command to enable access to this storage target for selected servers.
See "Configuring SCSI Routing," for details on configuring SCSI routing on the SN 5420 Storage Router.
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses to an access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
create accesslist
|
Create an access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter
|
Associate additional parameter values with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
add scsirouter target wwpn
To map a logical target to a primary (and, optionally, a secondary) storage address specified by WWPNs, use the add scsirouter target wwpn command. The add scsirouter target wwpn command is a target-only method of mapping a logical target specified by WWPNs.
add scsirouter name target name wwpn xx:xx:xx:xx:xx:xx:xx:xx [wwpn xx:xx:xx:xx:xx:xx:xx:xx]
Syntax Description
name
|
Name of the SCSI routing services instance to which you are adding the storage target.
|
target name
|
A user-specified name of the logical target.
|
wwpn xx:xx:xx:xx:xx:xx:xx:xx
|
Specifies a WWPN for the primary storage address.
|
wwpn xx:xx:xx:xx:xx:xx:xx:xx
|
(Optional) Specifies a WWPN for the secondary storage address, used as an alternate for mapping if the primary is not available.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The add scsirouter target wwpn command requires only a logical target name to be mapped to a physical target address — no LUNS are specified. However, all LUNs that are part of the physical target address are discovered and made apparent as LUNs belonging to the logical target.
Tips WWPN address notation is represented by 16 hex digits, usually formatted as eight pairs with each pair separated by a colon, xx:xx:xx:xx:xx:xx:xx:xx. When entering WWPN addresses, colons can be placed anywhere in the address notation as long as they do not leave one character without a partner character. The entry should be zero-filled from the most significant (the leftmost) character position.
The following examples are correct:
•0000:0000:1234:5678
•0A0F2860:02111750
The following examples are incorrect:
•1:234:567:8:91:23:FF:67
•12:34:56
When a target is added, it is (by default) enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any servers. Use the set scsirouter target {enable | disable} command to enable access to this storage target for selected servers.
See "Configuring SCSI Routing," for details on configuring SCSI routing on the SN 5420 Storage Router.
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses to an access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
create accesslist
|
Create an access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter
|
Associate additional parameter values with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
add scsirouter target lun loopid lun
To map a logical target and LUN combination to a storage loop ID and LUN, use the add scsirouter target lun loopid lun command. The add scsirouter target lun loopid lun command is a target-and-LUN mapping method of mapping a logical target and LUN combination to a physical loop ID and LUN combination in storage.
add scsirouter name target name lun nn loopid nn lun nn
Syntax Description
name
|
Name of the SCSI routing services instance to which you are adding the storage target.
|
target name
|
A user-specified name of the logical target.
|
lun nn
|
The first instance is the LUN number associated with the target (the iSCSI LUN). iSCSI LUNs are integers between 0 and 255. The second instance is the LUN number associated with the loopid (physical device LUN). Physical LUNs may be any physical device number, for example 0x51d1 or 123.
|
loopid nn
|
Specifies a loop ID number, which is an integer between 0 and 125.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The add scsirouter target lun loopid lun command requires both a logical target and LUN combination, and a physical loop ID and LUN combination.
When a target is added, it is (by default) enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any servers. Use the set scsirouter target {enable | disable} command to enable access to this storage target for selected servers.
See "Configuring SCSI Routing," for details on configuring SCSI routing on the SN 5420 Storage Router.
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses to an access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add accesslist
|
Create an access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter
|
Associate additional parameter values with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
add scsirouter target lun wwpn lun
To map a logical target and LUN combination to a primary (and optional secondary) storage address where each storage address is specified by WWPN and LUN, use the add scsirouter target lun wwpn lun command. The add scsirouter target lun wwpn lun command is a target-and-LUN mapping method of mapping a logical target to storage.
add scsirouter name target name lun nn wwpn xx:xx:xx:xx:xx:xx:xx:xx lun nn
[wwpn xx:xx:xx:xx:xx:xx:xx:xx lun nn]
Syntax Description
name
|
Name of the SCSI routing services instance to which you are adding the storage target.
|
target name
|
A user-specified name of the logical target.
|
lun nn
|
The first instance is the LUN number associated with the target (the iSCSI LUN). iSCSI LUNs are integers between 0 and 255. The second instance is the LUN number associated with the primary WWPN (physical device LUN). Physical LUNs may be any physical device number, for example 0x51d1 or 123.
|
wwpn xx:xx:xx:xx:xx:xx:xx:xx
|
Specifies a WWPN for the primary storage address.
|
wwpn xx:xx:xx:xx:xx:xx:xx:xx
|
(Optional) Specifies a WWPN for the secondary storage address, used as an alternate for mapping if the primary is not available.
|
lun nn
|
(Optional) Specifies the LUN associated with the optional secondary WWPN. Physical LUNs may be any physical device number, for example 0x51d1 or 123.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The add scsirouter target lun wwpn lun command specifies a logical target name and LUN number combination to be mapped to a physical WWPN and LUN combination in storage.
The secondary WWPN and LUN combination is optional. The secondary combination is mapped to the logical target name and LUN combination as an alternate, if the primary WWPN and LUN combination is not available.
When a target is added, it is (by default) enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any servers. Use the set scsirouter target {enable | disable} command to enable access to this storage target for selected servers.
See "Configuring SCSI Routing," for details on configuring SCSI routing on the SN 5420 Storage Router.
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses of servers allowed to access a common set of storage resources to the specified access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
create accesslist
|
Create an access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter
|
Associate additional values and parameters with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
add scsirouter target lun wwnn
To map a logical target and LUN combination to a WWNN storage address, use the add scsirouter target lun wwnn command. The add scsirouter target lun wwnn command is a target-and-LUN mapping method of mapping a logical target to storage.
add scsirouter name target name lun nn wwnn xx:xx:xx:xx:xx:xx:xx:xx
Syntax Description
name
|
Name of the SCSI routing services instance to which you are adding the storage target.
|
target name
|
A user-specified name of the logical target.
|
lun nn
|
The LUN number associated with the logical target. LUNs are integers between 0 and 255.
|
wwnn xx:xx:xx:xx:xx:xx:xx:xx
|
Specifies a WWNN.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The add scsirouter target lun wwnn command specifies a logical target name and LUN number combination to be mapped to a physical WWNN in storage.
Tips WWNN address notation is represented by 16 hex digits, usually formatted as eight pairs with each pair separated by a colon, xx:xx:xx:xx:xx:xx:xx:xx. When entering WWNN addresses, colons may be placed anywhere in the address notation, as long as they do not leave one character without a partner character. The entry should be zero-filled from the most significant (the leftmost) character position.
The following examples are correct:
•0000:0000:1234:5678
•0A0F2860:02111750
The following examples are incorrect:
•1:234:567:8:91:23:FF:67
•12:34:56
When a target is added, it is (by default) enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any servers. Use the set scsirouter target {enable | disable} command to enable access to this storage target for selected servers.
See "Configuring SCSI Routing," for details on configuring SCSI routing on the SN 5420 Storage Router.
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses of servers allowed to access a common set of storage resources to the specified access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
create accesslist
|
Create an access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter
|
Associate additional values and parameters with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
add scsirouter target {loopid | wwpn | wwnn}
To use an index method of mapping a logical target (or a logical target and LUN combination) to storage, use the add scsirouter target {loopid | wwpn | wwnn} command. The add scsirouter target {loopid | wwpn | wwnn} command creates an indexed list of storage resources, assigning a unique index number to each LUN available. Specify the storage resources to map by using the appropriate index numbers.
add scsirouter name target name [lun nn] {loopid | wwpn | wwnn} ?
add scsirouter name target name [lun nn] {loopid | wwpn | wwnn} #nn
Syntax Description
name
|
Name of the SCSI routing services instance to which you are adding the storage target.
|
target name
|
A user-specified name of the logical target.
|
lun nn
|
(Optional) The LUN number associated with the logical target.
|
loopid
|
Use the loop ID address type for the named storage resources.
|
wwpn
|
Use the WWPN address type for the named storage resource.
|
wwnn
|
use the WWNN address type for the named storage resource.
|
#nn
|
The index number from the displayed list. The storage resource listed after the number specified is the physical storage address to which the logical target, or logical target and LUN combination, is to be mapped.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The add scsirouter target {loopid | wwpn | wwnn} command can be used for target-only or target and LUN mapping.
Part of the information included in the indexed list is the address type of each storage resource. The address type indicates what type of physical addressing can be used to access the storage resource: loop ID, WWPN, or WWNN. If the list shows more than one address type for a storage resource, specify the address type you prefer for mapping to that storage resource.
To display the indexed list of storage resources, use the CLI list choices function ( ? key) and completion characters (TAB key). That action will cause a list of devices discovered on the Fibre Channel network to display as a numbered (indexed) set of lines.
When a target is added, it is (by default) enabled. However, it is not associated with any access list ("accesslist none"), effectively disabling access to the target from any servers. Use the set scsirouter target {enable | disable} command to enable access to this storage target for selected servers.
See "Configuring SCSI Routing," for details on configuring SCSI routing on the SN 5420 Storage Router.
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses of servers allowed to access a common set of storage resources to the specified access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
create accesslist
|
Create an access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter
|
Associate additional values and parameters with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
Create Commands
The create commands create named entities to be used in subsequent commands. Create commands return an error message if the entity already exists.
Use the create commands to perform the following actions (Table 7-2):
Table 7-2 Create Command Actions
Action
|
Commands
|
Create an access list.
|
create accesslist
|
Create an instance of SCSI routing services.
|
create scsirouter
|
All create commands update the currently running configuration. Use the save commands to retain the new configuration data in the storage router when it is rebooted.
Note You can create up to four instances of SCSI routing services (scsirouter). Any number of access lists (accesslist) can be created and associated with the storage targets that are mapped to the SCSI routing services.
create accesslist
To create an access list entity, use the create accesslist command.
create accesslist name [description "text"]
Syntax Description
name
|
The name of the access list entity created by this command.
|
description text
|
(Optional) User-defined identification information associated with this access list. Enclose the description string in quotes.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Access lists specify the IP addresses of the servers allowed to access a common set of storage resources via the SN 5420 Storage Router. Access lists are associated with specific storage targets.
In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the create accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the SN 5420."
Examples
The following command creates an access list named webserver2.
create accesslist webserver2 description "Access list for company web servers"
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses to an access list.
|
delete accesslist
|
Delete a specific access list entry, or an entire access list.
|
restore accesslist from
|
Restore the named access list, or all access lists, from the named configuration file.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
set scsirouter target accesslist
|
Associate an access list with a specific SCSI routing services target or all targets.
|
show accesslist
|
Show the contents of the named access list or all access lists.
|
show scsirouter
|
Display configuration and operational details about the named SCSI routing services instance, or all instances of SCSI routing services.
|
create scsirouter
To create an instance of SCSI routing services, use the create scsirouter command.
create scsirouter name [description "text"]
Syntax Description
name
|
The name of the SCSI routing services instance created by this command. Enter a maximum of 32 characters.
|
description text
|
(Optional) User-defined identification information associated with this instance of SCSI routing services. Enclose the description string in quotes.
|
Defaults
None.
Command Modes
Administrator
Usage Guidelines
SCSI routing is the routing of SCSI requests and responses between servers in an IP network and storage devices in a storage network. SCSI routing occurs in the SN 5420 Storage Router through the mapping of physical storage devices to iSCSI targets. The SCSI routing services instance becomes a binding point for the association of configuration parameters such as the server interface IP address, targets, and access lists. Use the create scsirouter command to create the SCSI routing services instance, then use the add scsirouter and set scsirouter commands to complete configuration of the named instance.
There can be a maximum of four instances of SCSI routing services defined per storage router. If the storage router is a member of a cluster, no more than four instances can be defined across the cluster.
Examples
The following command creates a SCSI routing services instance named "myConpanyWebserver2".
create scsirouter myCompanyWebserver2
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses to an access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with the SCSI command initiator.
|
add scsirouter serverif
|
Assign an interface and IP address for use by the TCP/IP endpoint of the named SCSI routing services instance.
|
add scsirouter target
|
Assign targets to the named SCSI routing services instance.
|
create accesslist
|
Create an access list entity.
|
delete scsirouter
|
Delete the named elements from the specified instance of SCSI routing services.
|
failover scsirouter
|
Failover the named SCSI routing services instance to another storage router in the cluster.
|
save accesslist
|
Save configuration data for the named access list or all access lists.
|
save scsirouter
|
Save configuration data for the named SCSI routing services instance.
|
set scsirouter
|
Associate additional parameter values (including access lists) with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances, of SCSI routing services.
|
start scsirouter
|
Start the named instance of SCSI routing services.
|
stop scsirouter
|
Stop the named instance of SCSI routing services.
|
Delete Commands
The delete commands remove entities previously created via the create commands. For entities with many elements, the keyword all is required to delete the entire entity.
Using the delete commands you can perform the following actions (Table 7-3).
Table 7-3 Delete Command Actions
Action
|
Commands
|
Perform the following delete functions related to access lists:
•delete a specific access list or access list entry
•delete all access lists
|
delete accesslist
The following variations of this command provide the means to perform the actions described:
delete accesslist
delete accesslist all
|
Delete the named file from the savedconfig directory
|
delete savedconfig
|
Delete the specified route from the system route table
|
delete route
|
Performs the following delete functions related to SCSI routing services:
•delete the named instance from the SN 5420 and its cluster
•delete the named target from the named instance
•delete all targets from the named instance
•delete the interface to storage used by the named instance
•delete the interface used by servers for access to the named instance
|
delete scsirouter
The following variations of this command provide the means to perform the actions described:
delete scsirouter all
delete scsirouter target
delete scsirouter target all
delete scsirouter deviceif
delete scsirouter serverif
|
Delete a specific version of software from the SN 5420.
|
delete software version
|
Note All delete commands immediately remove the specified entity from the currently running configuration and the permanently saved storage router configuration. A save command is not required to retain the configuration changes in the storage router when it is rebooted and the CLI command prompt does not display an asterisk after a delete command completes.
delete accesslist
To delete an entire access list, all access lists, or a specified server IP address from the named access list, use the delete accesslist command.
delete accesslist {name [A.B.C.D/bits | A.B.C.D/1.2.3.4] | all}
Syntax Description
name
|
The name of the access list.
|
A.B.C.D/bits
|
(Optional) IP address and network mask of the server being deleted from the access list. A.B.C.D is the dotted quad notation of a server IP address. The /bits specifies the network mask in CIDR style.
|
A.B.C.D/1.2.3.4
|
(Optional) IP address and network mask of the server being deleted from the access list. A.B.C.D is the dotted quad notation of a server IP address. 1.2.3.4 is the dotted quad notation of the network mask.
|
all
|
Delete all access lists.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Because access lists are cluster entities, this operation affects all targets associated with this access list, regardless of where the associated SCSI routing services instance is running within the SN 5420 cluster.
•Use the keyword all to delete all access lists.
•Use the delete accesslist name command with no additional parameters to completely delete the named access list.
Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the delete accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the SN 5420 in a cluster, see "Maintaining and Managing the SN 5420."
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses of servers allowed to access a common set of storage resources to the specified access list.
|
restore accesslist from
|
Restore the named access list, or all access lists, from the named configuration file.
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
set scsirouter target accesslist
|
Associate access list with specific SCSI routing services target.
|
show accesslist
|
Show a list of all access lists in the cluster, or the contents of the named access list or all access lists.
|
delete route
To remove the specified static route from the system routing table, use the delete route command.
Note The routing table is used for network management interfaces. See the command add route gw, for details.
delete route {A.B.C.D/bits | A.B.C.D/1.2.3.4 | default}
Syntax Description
A.B.C.D/bits
|
IP address and network mask of the static route being deleted from the routing table. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the network mask in CIDR style.
|
A.B.C.D/1.2.3.4
|
IP address and network mask of the static route being deleted from the routing table. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the network mask.
|
default
|
Deletes the default route (0.0.0.0/32).
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use the keyword default to delete the default route (0.0.0.0/32).
Related Commands
Command
|
Description
|
add route gw
|
Add a static route to the SN 5420 routing table.
|
show net route
|
Display the system route table.
|
delete savedconfig
To remove the named file from the savedconfig directory, use the delete savedconfig command.
delete savedconfig filename
Syntax Description
filename
|
The name of the configuration file to be deleted. This file must exist in the savedconfig directory.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use the show savedconfig command to display the contents of the savedconfig directory.
Related Commands
Command
|
Description
|
import savedconfig
|
Transfer the named configuration file from the specified location to the savedconfig directory.
|
restore all from
|
Restore the complete contents of the named file to the indicated storage router.
|
restore scsirouter from
|
Restore the configuration of the named SCSI routing services instance, or all instances, from the named file.
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save all
|
Save all configuration data.
|
save scsirouter
|
Save configuration data for the named SCSI routing services instance or all instances.
|
save system
|
Save configuration data for the SN 5420 system
|
show cluster
|
Show cluster-related operational statistics, including heartbeat information.
|
show savedconfig
|
List the contents of the savedconfig directory, which contains saved system configuration files.
|
delete scsirouter
To delete the named elements from the SCSI routing services instance, use the delete scsirouter command.
delete scsirouter {all | name [serverif {fc? | ge?} | deviceif {fc? | sc?} | all]}
delete scsirouter name target {name | all} [lun nn]
delete scsirouter {all | name} force
Syntax Description
all
|
Delete all SCSI routing services from the storage router.
|
name
|
The name of the SCSI routing services instance.
|
serverif {fc? | ge?}
|
Delete the interface used by servers for access to the named instance.
|
deviceif {fc? | sc?}
|
Delete the interface to storage devices used by the named instance.
|
name all
|
Delete the entire SCSI routing services instance from the SN 5420 and its cluster.
|
target name
|
(Optional) The name of the specific target to delete.
|
target all
|
(Optional) Delete all targets from the named instance.
|
lun nn
|
(Optional) Delete the specified iSCSI LUN from the named target or all targets.
|
force
|
(Optional) Keyword that overrides normal protections, allowing the action to be performed from a storage router that is not the current primary for the named instance.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
In a cluster environment, a storage router that is currently running a SCSI routing services instance is known as the current primary for that instance. Under normal circumstances, changes to the SCSI routing services instance can only be made on the storage router that is the current primary for that instance. The SCSI routing services instance may be in a stopped state at the time it is deleted.
The force option overrides the normal protections that prevent the deletion of an instance from a storage router that is not the current primary for that instance. The force option should only be used when the storage router, or a specific SCSI routing services instance, is in an abnormal state and cannot be recovered without rebooting.
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Examples
The following command deletes all associated targets, all associated interfaces, and the entire SCSI routing services instance named foo.
delete scsirouter foo all
The following command deletes all targets associated with the instance named foo.
delete scsirouter foo target all
The following command deletes the Fibre Channel interface to storage devices used by the instance named foo.
delete scsirouter foo deviceif fc1
Related Commands
Command
|
Description
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add scsirouter target
|
Assign targets to the named SCSI routing services instance.
|
create accesslist
|
Create the named access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete accesslist
|
Delete a specific access list entry, or an entire access list.
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter
|
Set attribute values for the named SCSI routing services instance, such as associating access lists to targets and enabling connections and logins to those targets.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show accesslist
|
Display a list of access lists, or the contents of the named access list or all access lists.
|
show scsirouter
|
Display configuration and operational details about the named SCSI routing services instance, or all instances.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
delete software version
To delete the specified version of software from the SN 5420, use the delete software version command.
Note The version of software currently running, and the version that will be booted when the system is next restarted, may not be deleted.
delete software version {vx.x-y | all}
Syntax Description
vx.x-y
|
The version of SN 5420 software to be deleted.
|
all
|
Delete all non-bootable and non-current software versions.
|
Defaults
None.
Command Modes
Administrator.
Related Commands
Download Commands
The download commands are used to download new SN 5420 software and configuration data to the storage router. Using the download commands you can perform the following actions (Table 7-4).
Table 7-4 Download Command Actions
Action
|
Commands
|
Display a list of software versions available for download.
|
download software list
|
Fetch the README file for the specified software version.
|
download software readme
|
Download the specified version of software from a specific location.
|
download software url
|
Download the specified version of software from the default download location.
|
download software version
|
download software list
To fetch a file (sw-version.txt) containing a list of SN 5420 software available for downloading from the web server designated as the default software download location and display the versions available for download, use the download software list command.
download software list
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The text file must contain one line for each version of software that is available in the download location. Create this file and update it whenever a new version of software is downloaded from Cisco.com.
See the command set software url for information about identifying the location of the web server to be used to download updated SN 5420 software. See the "Installing Updated Software" section for details on making updated software available to the storage router.
Related Commands
download software readme
To fetch the README file associated with the specified version of SN 5420 software, use the download software readme command.
download software readme vx.x-y
Syntax Description
vx.x-y
|
The version of SN 5420 software associated with this README file.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The readme file contains information helpful in evaluating new versions of software prior to installation.
Related Commands
download software url
To download the indicated version of software from the named location, use the download software url command.
download software url http://anywebserver.com/vx.x-y.fw
Syntax Description
http://anywebserver.com/vx.x-y.fw
|
The fully-qualified URL from which to download this version of SN 5420 software.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
This command allows you to download software from a user-specified location. It does not set the location of the default web server typically associated with this function.
See the command set software url for information about identifying the location of the default web server to be used to download updated SN 5420 software.
Related Commands
download software version
To download the indicated version of software from the default location, use the download software version command.
download software version vx.x-y
Syntax Description
vx.x-y
|
The version of SN 5420 software to be downloaded.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
See the command set software url for information about identifying the location of the default web server to be used to download updated SN 5420 software.
Related Commands
Failover Commands
The failover commands cause the SCSI routing services to cease running on the storage router. The HA system is advised that the storage router is unable to run the SCSI routing services. The failed-over SCSI routing services will start up on another storage router in the cluster.
Note Each storage router can run up to four instances of SCSI routing services. If one storage router is already running two SCSI routing service instances, for example, it is eligible to run up to two additional SCSI routing service instances. See "Maintaining and Managing the SN 5420," for details.
If no eligible storage router is found (for example, if the SN 5420 is a stand-alone system), the SCSI routing services will start running again on the same storage router.
Using the failover commands you can perform the following actions (Table 7-5)
Table 7-5 Failover Command Actions
Actions
|
Commands
|
Failover all applications and associated SCSI routing services to another storage router in the cluster.
|
failover all
|
Failover the specified SCSI routing services instance, or all instances, to another member of the cluster.
|
failover scsirouter
|
.
failover all
To cause all SCSI routing services to cease running on the SN 5420 and start running on another storage router in the cluster, use the failover all command.
Note If no eligible storage router is found (for example, if the SN 5420 is a stand-along system), the SCSI routing services will start running again on the same storage router.
failover all
Syntax Description
all
|
Keyword to stop all SCSI routing services currently running.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Only running instances will failover. If the SCSI routing services instance is stopped it will not be failed-over to another storage router in the SN 5420 cluster. Each storage router can run a maximum of four instances of SCSI routing services.
Related Commands
Command
|
Description
|
failover scsirouter
|
Cause the named SCSI routing services instance to cease running on the SN 5420.
|
start scsirouter
|
Start the named SCSI routing services instance or all instances.
|
stop scsirouter
|
Stop the named SCSI routing services instance or all instances.
|
failover scsirouter
To cause the named SCSI routing services instance to cease running on the SN 5420 and start running on another storage router in the cluster, use the failover scsirouter command.
Note If no eligible storage router is found (for example, if the SN 5420 is a stand-along system), the named SCSI routing services instance will start running again on the same storage router.
failover scsirouter {instancename | all}
Syntax Description
instancename
|
The name of the SCSI routing services instance to be failed-over.
|
all
|
Keyword required to failover all instances currently running on this SN 5420.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use the all keyword to failover all SCSI routing services currently running on this storage router. Each storage router can run a maximum of four instances of SCSI routing services.
Related Commands
Command
|
Description
|
failover all
|
Cause all applications and SCSI routing services to cease running on the SN 5420.
|
start scsirouter
|
Start the named SCSI routing services instance or all instances
|
stop scsirouter
|
Stop the named SCSI routing services instance or all instances.
|
Import Command
The import command allows a named configuration file, or any data file, to be transferred to the SN 5420 savedconfig directory. This makes the named file available for use by the SN 5420.
Using the import commands you can perform the following actions (Table 7-6).
Table 7-6 Import Command Actions
Action
|
Commands
|
Import a previously-saved configuration file in XML format.
|
import savedconfig
|
Import the named data file.
|
import file
|
import file
To transfer the named file from the specified location to the savedconfig directory, use the import file command. The transfer is via HTTP. Any file of the same name in the savedconfig directory is overwritten.
import file FileUrl
Syntax Description
FileUrl
|
The URL (including the file name) of the file to be transferred to the savedconfig directory, such as http://acme/~myhome/allconf.txt. (In this example, the host name acme can be used if the set nameserver command was previously issued. See the "set nameserver" section, for additional information.)
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use the import file command to import a file of any format to the storage router. To import a configuration file, use the import savedconfig command, which verifies that the specified file is of the required XML format.
Related Commands
Commands
|
Description
|
import savedconfig
|
Import a configuration file to the storage router.
|
restore accesslist from
|
Restore the named access list, or all access lists, from the named configuration file.
|
restore all from
|
Restore the contents of the named configuration file into memory.
|
restore scsirouter from
|
Restore the named SCSI routing services instance (or all instances) from the named configuration file.
|
save all
|
Save all configuration data.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
save system
|
Save configuration data for the SN 5420 system.
|
show savedconfig
|
List the contents of the savedconfig directory, which contains saved system configuration files.
|
import savedconfig
To transfer the named configuration file from the specified location to the savedconfig directory, use the import savedconfig command. The transfer is via HTTP. Any file of the same name in the savedconfig directory is overwritten.
import savedconfig ConfigurationFileUrl
Syntax Description
ConfigurationFileUrl
|
The URL (including the file name) of the configuration file to be transferred to the savedconfig directory, such as http://acme/~myhome/allconf.xml. (In this example, the host name acme can be used if the set nameserver command was previously issued. See the "set nameserver" section, for additional information.)
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Configuration files are specially formatted XML files. The import savedconfig command verifies that the specified file is of the required format. Use the import file command to import a file of any other format.
The import savedconfig command does not affect the running or persistent configuration of the storage router or cluster. However, the restore command may be used to copy the contents of this file into persistent memory.
If you are importing a saved configuration file from another storage router, use the complete path to the savedconfig directory (ata0/savedconfig/).
Examples
The following example imports the saved configuration file myFoo.xml from a storage router with an IP address of 10.1.40.10.
import savedconfig http://10.1.40.10/ata0/savedconfig/myFoo.xml
Related Commands
Commands
|
Description
|
import file
|
Import a data file to the storage router.
|
restore accesslist from
|
Restore the named access list, or all access lists, from the named configuration file.
|
restore all from
|
Restore the contents of the named configuration file into memory.
|
restore scsirouter from
|
Restore the named SCSI routing services instance (or all instances) from the named configuration file.
|
save all
|
Save all configuration data.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
save system
|
Save configuration data for the SN 5420 system.
|
show savedconfig
|
List the contents of the savedconfig directory, which contains saved system configuration files.
|
Restore From Commands
The restore from commands cause the contents of the named file to be examined to find the indicated entity, then copies the associated content into persistent memory. The named configuration file must exist in the savedconfig directory.
Note The restore from command does not change the running configuration. Objects are restored to the current saved configuration. You may be able to display the results of a restore by issuing the appropriate show command with the from bootconfig keywords. To change the running configuration, restart the SCSI routing services instance. You can also save your current configuration and reboot the storage router after the restore completes. If SCSI routing services failover to another storage router in the cluster, fail them back to the restored storage router once the reboot command completed.
The restore process does not delete an existing entity or entity attributes. It will add a missing entity or entity attributes, and will overwrite an entity attribute of the same name, but it will not delete an existing entity, or attribute associated with an entity. Thus the restore may appear to be additive in that it merges the restored configuration with the existing configuration. Where duplication occurs, the configuration details from the named configuration file is used. Depending on the situation, you may find it necessary to delete an entity before restoring it from a saved configuration file.
Using the restore from commands you can perform the following actions (Table 7-7).
Table 7-7 Restore From Command Actions
Action
|
Commands
|
Restore the named access list or all accesslist from the named file to the storage router.
|
restore accesslist from
|
Restore all access lists and SCSI routing service instances from the named file to the storage router.
|
restore all from
|
Restore the configuration of the named SCSI routing services instance (or all instances) from the named file to the storage router.
|
restore scsirouter from
|
restore accesslist from
To cause the named access list (or all access lists) to be copied from the specified configuration file into persistent memory, use the restore accesslist from command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, see the "show savedconfig" section.
Note If the storage router belongs to a cluster, the restored access list information will automatically be propagated to other members of that cluster.
restore accesslist [name | all] from filename
Syntax Description
name
|
(Optional) The name of the access list to be restored.
|
all
|
(Optional) Keyword to restore all access lists.
|
from filename
|
The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
If the command is issued without an access list name or the keyword all, all access lists in the specified configuration file are restored.
A restore command never deletes existing information. The restore command will add missing entries, or overwrite existing entries of the same name, but will never purge or delete existing entries. If necessary, you can delete an access list and then restore it from a saved configuration file.
Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the restore accesslist from command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the SN 5420."
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses to an access list.
|
delete accesslist
|
Delete a specific access list entry, or an entire access list.
|
restore all from
|
Restore all applications, SCSI routing services, and other information from the indicated file.
|
restore scsirouter from
|
Restore the named SCSI routing services instance, or all instances, from the indicated file.
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save scsirouter
|
Save configuration data for the named instance, or for all instances of SCSI routing services.
|
save system
|
Save configuration data for the SN 5420 system.
|
set scsirouter target accesslist
|
Associate access list with specific SCSI routing services target or all targets.
|
show accesslist
|
Show the contents of the named access list or all access lists.
|
restore all from
To cause all the saved SCSI routing service instances and access lists to be copied from the specified configuration file into persistent memory, use the restore all from command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, see the command "show savedconfig" section.
Note This does not change the running configuration.
restore all from filename
Syntax Description
all
|
Keyword indicating that all access lists and all instances of SCSI routing services within the named configuration file will be restored.
|
from filename
|
The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The restore all command restores all information from the named file. If the configuration file being restored was created with the save all command, all SCSI routing services and access list configuration information will be restored.
A restore command never deletes existing items. The restore command will add missing items, or overwrite existing items of the same name, but will never purge or delete existing items. If necessary, you may delete access lists and instances of SCSI routing services before restoring from a saved configuration file.
Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the restore all from command from another storage router in the cluster, any saved access lists will not be restored. The CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the SN 5420."
Related Commands
Command
|
Description
|
failover all
|
Cause all applications and SCSI routing services to cease running on the storage router.
|
failover scsirouter
|
Cause the named SCSI routing services instance to cease running on the storage router.
|
restore accesslist from
|
Restore the named access list (or all access lists) from the named configuration file.
|
restore scsirouter from
|
Restore the named SCSI routing services instance, or all instances, from the named configuration file.
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save all
|
Save all configuration data.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
save system
|
Save configuration data for the SN 5420 system.
|
show savedconfig
|
List the contents of the savedconfig directory, which contains saved system configuration files.
|
set scsirouter primary
|
Designate the indicated SN 5420 as the preferred storage router to run the named SCSI routing services instance.
|
start scsirouter
|
Start the named SCSI routing services instance or all instances
|
stop scsirouter
|
Stop the named SCSI routing services instance or all instances.
|
restore scsirouter from
To cause the saved configuration information related to the named SCSI routing services instance (or all instances) to be copied from the specified configuration file into persistent memory, use the restore scsirouter from command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, see the command "show savedconfig" section.
Note This does not change the running configuration.
restore scsirouter [instancename | all] from filename
Syntax Description
instancename
|
(Optional) The name of the SCSI routing services instance to be restored.
|
all
|
(Optional) Keyword to restore all instances of SCSI routing services.
|
from filename
|
The name of the configuration file containing the information to be restored. This file must exist in the savedconfig directory.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
A SCSI routing services instance must be inactive before it can be restored. Use the stop scsirouter command to stop an active SCSI routing services instance so it can be restored.
A restore command never deletes existing items. The restore command will add missing items, or overwrite existing items of the same name, but will never purge or delete existing items. If necessary, you can delete a SCSI routing services instance and then restore it from a saved configuration file.
Related Commands
Command
|
Description
|
failover all
|
Cause all applications and SCSI routing services to cease running on the SN 5420.
|
failover scsirouter
|
Cause the named SCSI routing services instance to cease running on the SN 5420.
|
restore accesslist from
|
Restore the named access list (or all access lists) from the named configuration file.
|
restore all from
|
Restore all the contents of a named configuration file to persistent memory.
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save all
|
Save all configuration data.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
save system
|
Save configuration data for the SN 5420 system.
|
show savedconfig
|
List the contents of the savedconfig directory, which contains saved system configuration files.
|
set scsirouter primary
|
Designate the indicated SN 5420 as the preferred storage router to run the named instance of SCSI routing services.
|
start scsirouter
|
Start the named instance, or all instances, of SCSI routing services.
|
stop scsirouter
|
Stop the named instance, or all instances, of SCSI routing services.
|
Save Commands
The save commands save specified SN 5420 configuration data, or the entire SN 5420 configuration, to non-volatile memory or to a text file in the savedconfig directory. Any save command also triggers a high availability (HA) event, notifying the other systems in the cluster that new configuration data is available. Other members of the cluster fetch this new configuration data, allowing quick failover and sparing.
Using the save commands you can perform the following actions (Table 7-8).
Table 7-8 Save Command Actions
Action
|
Commands
|
Save all configuration data.
|
save all
save all to
|
Save configuration data for the named access list or for all access lists.
|
save accesslist
save accesslist all
|
Save configuration data for the named SCSI routing services instance or for all instances.
|
save scsirouter
save scsirouter all
|
Save system configuration data for the storage router.
|
save system
|
save accesslist
To save configuration data for the named accesslist, or for all access lists, to non-volatile memory, use the save accesslist command.
save accesslist [name | all] [to filename]
Syntax Description
name
|
(Optional) The name of the access list.
|
all
|
(Optional) Keyword, indicating all access lists associated with this storage router will be saved.
|
to filename
|
(Optional) The name of the file where the configuration data is written. This file is stored in the savedconfig directory.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
If the command is issued without an access list name, or the keyword all, all access lists are saved. Use the to keyword to save the configuration data to a text file. Configurations saved to a text file can be restored at a later time.
Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the save accesslist command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the SN 5420."
Related Commands
save all
To save all configuration data for a storage router to non-volatile memory, use the save all command.
save all [to filename]
Syntax Description
to filename
|
(Optional) The name of the file where the configuration data is written. This file is stored in the savedconfig directory.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The save all command saves all system, SCSI routing services, and access list configuration data. Use the to keyword to save the configuration data to a text file, in XML format.
Note In a cluster environment, all access lists must be created and maintained on the first storage router to join the cluster. If you issue the save all command from another storage router in the cluster, the CLI displays an informational message with the IP address of the storage router that is currently handling all access list functions. For more information on operating the storage router in a cluster, see "Maintaining and Managing the SN 5420."
Related Commands
Command
|
Description
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
save system
|
Save configuration data for the SN 5420 system.
|
save scsirouter
To save all configuration data associated with the named SCSI routing services instance, or all instances, to non-volatile memory, use the save scsirouter command.
save scsirouter {name | all} [to filename]
Syntax Description
name
|
The name of the SCSI routing services instance.
|
all
|
Keyword, indicating that configuration data for all SCSI routing services will be saved.
|
to filename
|
(Optional) The name of the file where the configuration data is written. This file is stored in the savedconfig directory.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
In a cluster environment, a storage router that is currently running an instance of SCSI routing services is known as the current primary for that instance. Changes to the SCSI routing services instance can only be made on the storage router that is the current primary for that instance.
•Use the all keyword to save configuration data for all instances of SCSI routing services.
•Use the to keyword to save the configuration data to a file.
Related Commands
Commands
|
Description
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add scsirouter target
|
Assign targets to the named SCSI routing services instance.
|
create accesslist
|
Create the named access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete accesslist
|
Delete a specific access list entry, or an entire access list.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save all
|
Save all configuration data.
|
save system
|
Save configuration data for the SN 5420 system.
|
set scsirouter
|
Set attribute values for a SCSI routing services instance, such as associating access lists to targets and enabling connections and logins to those targets.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show accesslist
|
Show the contents of the named access list or all access lists.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
save system
To save all configuration data associated with the SN 5420 system to non-volatile memory, use the save system command.
save system [to filename]
Syntax Description
to filename
|
(Optional) The name of the file where the configuration data is written. This file is stored in the savedconfig directory.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The following configuration data is saved:
•Monitor and Administrative passwords
•Administrative contact information
•Network Time Protocol (NTP) server name
•Primary and optional secondary Domain Name Server (DNS)
•Default location for downloading SN 5420 software
•System and cluster name
•Management and high availability (HA) interface addresses
•Static routes
•SNMP settings
Use the to keyword to save the configuration data to a file.
Related Commands
Commands
|
Description
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save all
|
Save all configuration data.
|
set systemname
|
Set the storage router system name.
|
show devices
|
Display information used to configure the SN 5420.
|
show system
|
Show various system information, including boot parameter, software versions, and information about the SN 5420 network interfaces.
|
Session Control Commands
The session control commands provide a variety of services, such as changing session mode and terminating active sessions.
Using the session control commands, you can perform the following actions (Table 7-9):
Table 7-9 Session Control Command Actions
Action
|
Commands
|
Terminate the current CLI management session.
|
logout
|
Change the management session from Monitor to Administrator mode.
|
enable
|
Return the management session to Monitor mode.
|
exit
|
Cause the SN 5420 to shut down and then reboot.
|
reboot
|
Display information about how to use the CLI.
|
help
|
Verify communication with another SN 5420 or other system.
|
ping
|
Check the specified software version for problems.
|
verify software version
|
Select a timezone from a list.
|
tzselect
|
enable
To change the management session from Monitor to Administrator mode, use the enable command. Monitor mode, which is the default mode, provides view-only access to the SN 5420 management interface. Administrator mode allows the user to create entities and make changes to the configuration of the storage router.
enable
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Monitor.
Usage Guidelines
Issue the enable command after a successful CLI login to change to Administrator mode.
Related Commands
Command
|
Description
|
exit
|
Return the management session to Monitor mode.
|
logout
|
Terminate the management session.
|
exit
To return the management session to Monitor mode from Administrator mode, use the exit command.
exit
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Issue the exit command to return to Monitor mode after previously issuing the enable command.
Related Commands
Command
|
Description
|
enable
|
Change the management session from Monitor to Administrator mode.
|
logout
|
Terminate the management session.
|
help
To display information about how to use the CLI, issue the help command.
help
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator or Monitor.
logout
To terminates the current CLI management session, use the logout command.
logout
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
After a logout command, no CLI commands can be issued until you log in again.
Related Commands
Command
|
Description
|
enable
|
Change the management session from Monitor to Administrator mode.
|
exit
|
Return the management session to Monitor mode.
|
ping
To verify communication with another SN 5420 or system in the network, use the ping command.
ping {systemname | ipaddress} [num nn]
Syntax Description
systemname
|
Name of another system or SN 5420.
|
ipaddress
|
IP address of another system or SN 5420.
|
num nn
|
(Optional) The number of pings to attempt. The default value is five.
|
Defaults
The default setting is to attempt five pings.
Command Modes
Administrator or Monitor.
Usage Guidelines
Use this command to verify that there is a TCP/IP communication path to another SN 5420 or system in the network. The systemname parameter can only be used if the storage router has access to a DNS. See the set nameserver command for details on providing access to a DNS.
Related Commands
Command
|
Description
|
show net route
|
Display the SN 5420 routing table.
|
reboot
To cause the storage router to shut down and then reboot, issue the reboot command.
Note Rebooting may cause the SN 5420 to run a different version of software. See the set software version command for details.
reboot [now]
Syntax Description
now
|
(Optional) Keyword forcing immediate reboot without requiring the user to press the Enter key.
|
Defaults
If the command is issued without the optional now keyword and there are unsaved configuration changes, the default is to save all changes before rebooting.
Command Modes
Administrator.
Usage Guidelines
If there are unsaved changes to the current configuration, you are prompted to either save all changes, be further prompted to save specific areas that have been modified, or to reboot without saving any changes.
At shutdown, any SCSI routing services running on this storage router will failover to another storage router in the cluster. At reboot, the cluster determines any instances of SCSI routing services that should start on the storage router. If the storage router is identified as the preferred SN 5420 for any SCSI routing services instance (via the set scsirouter primary command), that instance will start running on the storage router.
The now keyword is useful for scripting purposes, because it forces an immediate reboot without requiring the Enter key to be pressed. Use of the now keyword, however, provides no opportunity to save unsaved configuration changes. The storage router is rebooted and any unsaved configuration changes are lost.
Examples
The following prompt is received if you issue a reboot command (without the now keyword) when the storage router has unsaved configuration changes.
Changes have been made to the current configuration of the system which
yes - all of the configuration data will be saved,
no - modifications to the configuration data will not be saved,
prompt - you will be prompted to save the areas that have been modified.
Save ALL configuration data? [yes/no/prompt/CTRL-C to abort (yes)]
Related Commands
Command
|
Description
|
set cluster
|
Add this SN 5420 to the specified cluster.
|
set scsirouter primary
|
Designate the indicated SN 5420 as the preferred storage router to run the named SCSI routing services instance.
|
set software version
|
Set the version of software to run next time the system is booted.
|
tzselect
To select a time zone for the storage router from a comprehensive list of locations, use the tzselect command.
tzselect
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
This command displays a list of areas and cities, along with an associated number. Enter the appropriate number, or press Enter or Return to continue the display. Press Q to quit the display without setting the time zone.
Use the setup time wizard to select a time zone, set the date and time, and identify a NTP server for your storage router. You can also use the set timezone command if you already know the name of the time zone you wish to set. See the "setup time" section or the "set timezone" section for details.
Related Commands
Command
|
Description
|
set timezone
|
Set the time zone associated with this SN 5420.
|
setup time
|
Configure the system date and time.
|
verify software version
To check the specified software version for problems, issue the verify software version command.
verify software version {boot | current | version}
Syntax Description
boot
|
The software version that is set to boot at the next system restart.
|
current
|
The software version that is currently running.
|
version
|
A specific version of software, which must be available to the SN 5420.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use this command after downloading software to verify that the download completed successfully and that the downloaded software is bootable.
Related Commands
Command
|
Description
|
delete software version
|
Remove the specified version of software from the SN 5420.
|
download software list
|
Display a list of software versions available for download from the default download location.
|
download software readme
|
Fetch the README file for the specified software version from the default download location.
|
download software url
|
Download the specified version of software from the named location.
|
download software version
|
Download the specified version of software from the default download location.
|
show software
|
Display a list of software versions and other relevant information, including current default download location.
|
Set Commands
The set commands provide values for administrative and performance parameters. The commands set parameters either for the SN 5420 as a whole or for a named service instance (for example, a SCSI routing services instance). The set command variables always have some value; they cannot be unset, but may be set to new values or returned to default values.
Use the set commands to perform the following actions (Table 7-10):
Table 7-10 Set Command Actions
Action
|
Command
|
Add the SN 5420 to the specified cluster.
|
set cluster
|
Set the HA interface IP address and network mask.
|
set ha ipaddress
|
Reset the import change pending status for a storage router in a cluster.
|
set ha import pending none
|
Set the storage router system name.
|
set systemname [domain]
|
Set the management interface IP address and network mask.
|
set mgmt ipaddress
|
Set the following SNMP notification parameters:
•`Get' community string
•`Set' community string
•primary (optional secondary) destination hosts for notifications (traps)
|
set snmp
The following variations of this command provide the means to perform the actions described:
•set snmp getcommunity
•set snmp setcommunity
•set snmp traphost primary [secondary]
|
Set the event logging level for the console and the SN 5420 log file.
|
set log level
|
Clear the SN 5420 log file.
|
set log file empty
|
Enable logging of event messages to a specified host
|
set log remote
|
Set the following operational characteristics for the specified data interface:
•MTU size
•enable auto negotiation
•topology type
|
set interface
The following variations of this command provide the means to perform the actions described:
•set interface {ge? | fc?} mtusize
•set interface ge? autonegotiation
•set interface fc? topology
|
Set monitor login password.
|
set monitor password
|
Set administrator login password.
|
set admin password
|
Set administrator contact information.
|
set admin contactinfo
|
Set the SN 5420 system clock to a specified date and time.
|
set clock
|
Set the NTP server IP address and mask.
|
set ntpserver
|
Set time zone.
|
set timezone
|
Set DNS server IP address and optional domain
|
set nameserver
|
Set secondary DNS server IP address
|
set secnameserver
|
Set the following software download parameters:
•software download URL
•user ID and password used to access the download location
|
set software
The following variations of this command provide the means to perform the actions described:
•set software url
•set software user
|
Set the software version to run when the system is next booted.
|
set software version
|
Set the following SCSI routing services parameters:
•user-defined identification information
•preferred storage router for this instance
•enable or disable connects for named targets
•associate an accesslist to specific target
•associate a description with the named target
|
set scsirouter
The following variations of this command provide the means to perform the actions described:
•set scsirouter description
•set scsirouter primary
•set scsirouter target {enable | disable}
•set scsirouter target accesslist
•set scsirouter target description
|
Set the following debug trace facilities for SCSI routing service instances:
•enable target front end (tfe) global trace
•disable tfe global trace
•enable tfe trace for the specified LUN
•disable tfe trace for the specified LUN
|
set debug
The following variations of this command provide the means to perform the actions described:
•set debug scsirouter scsitrace
•set debug scsirouter no scsitrace
•set debug scsirouter target lun scsitrace
•set debug scsirouter target num no scsitrace
|
Set the level of trace and debug logging for SCSI routing service instances.
|
set scsirouter loglevel
|
Note All set commands update the currently running configuration. Use the save commands to retain the changed configuration data in the storage router when it is rebooted.
set admin contactinfo
To provide basic contact information for the administrator of this SN 5420 Storage Router, use the set admin contactinfo command.
set admin contactinfo name "string" [email "string" phone "string" pager "string"]
Syntax Description
name string
|
The name of the SN 5420 administrator.
|
email string
|
(Optional) The e-mail address of the SN 5420 administrator. This is an address to which alerts may be sent.
|
phone string
|
(Optional) The phone number of the SN 5420 administrator.
|
pager string
|
(Optional) An optional pager number
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use the set admin contactinfo command to provide site-specific information associated with the storage router. The parameters must be specified in the sequence shown, and all parameters preceding the parameter to be set must be included in the command. Trailing parameters are not required. Usage is completely site-specific.
Enclose each string containing spaces in single or double quotes.
Examples
The following command sets the system administrator name, e-mail address, and phone number.
set admin contactinfo name "Pat Hurley" email "hurley@abc123z.com" phone "123.456.7890"
The following command sets all system administrator contact information.
set admin contactinfo name "Chris Smith" email "chris.smith@zxy478x.com" phone
"123.555.5555 ext 97" pager "123.456.3444 pin 2234"
Related Commands
Command
|
Description
|
save all
|
Save all configuration data, including the administrator contact information.
|
save system
|
Save system configuration data, including the administrator contact information.
|
set admin password
|
Set administrator login password.
|
show admin
|
Display system administrator contact information.
|
set admin password
To set the password used for administrative access to the SN 5420 Storage Router management interface, use the set admin password command. Access may be via Telnet (for CLI), or web-based graphical user interface (GUI).
set admin password string
Syntax Description
password string
|
The password associated with administrative access to the storage router management interface. Enclose the string in quotes. A string value of "" clears the password. The default password is "cisco".
|
Defaults
The default password is "cisco".
Command Modes
Administrator.
Usage Guidelines
The SN 5420 management interface is password protected. You must enter passwords when accessing the SN 5420 via Telnet (for CLI) or web-based GUI. The Monitor-mode password provides view-only access to SN 5420 management interface, while the Administrator-mode password allows the user to create entities and make changes to the configuration of the storage router.
Set the password string to "" to clears the password, effectively setting it to nothing.
Caution This command displays the password entered in clear text.
Related Commands
Command
|
Description
|
enable
|
Enter Administrator mode.
|
exit
|
Leave Administrator mode and enter Monitor mode.
|
save all
|
Save all configuration data, including the administrator password.
|
save system
|
Save system configuration data, including the administrator password, for the storage router.
|
set monitor password
|
Set login password for view-only access to SN 5420 management interface.
|
setup access
|
Run the setup wizard to configure Monitor-mode and Administrator-mode passwords.
|
set clock
To set the storage router system clock to the given date and time, use the set clock command. Date and time information is used for log files and the user interface.
set clock hh:mm:ss mm/dd/yyyy
Syntax Description
hh:mm:ss mm/dd/yyyy
|
The current time, in hours, minutes and seconds, followed by the current month, day and year. For example, 13:55:22 11/19/2000.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
If the storage router should synchronize its date and time with a network time protocol (NTP) server, see the set ntpserver command.
Related Commands
Command
|
Description
|
set ntpserver
|
Set the name or IP address of the NTP server with which the storage router will synchronize date and time.
|
set timezone
|
Set the timezone associated with this SN 5420.
|
setup time
|
Run the setup wizard to configure date and time information (including NTP server and time zone) associated with the storage router.
|
show clock
|
Display the current system date and time, including the system timezone.
|
tzselect
|
Select a time zone for the SN 5420 from an extensive list.
|
set cluster
To add this storage router to the specified cluster, use the set cluster command.
set cluster name
Syntax Description
name
|
The name of the HA cluster to which this storage router is to be added.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The high availability (HA) features of the SN 5420 are designed around a cluster of systems that back each other up in case of failure. A cluster consists of two identically configured storage routers that continually exchange HA information over their HA and management interfaces.
Clusters are defined by name. The set cluster command prompts the user to either merge this system's configuration with others in the cluster, or to delete this system's application configuration data (SCSI routing services and cluster configuration information) and replace it with cluster data. Merged data is replicated to other storage routers in the cluster. When joining an existing cluster, access list information is always deleted and replaced by the cluster's access list information.
Caution Merging configuration data could provide unexpected results.
Changing the SN 5420's cluster name, thereby joining another cluster, has the following effects on its existing configurations and operations:
•All instances of SCSI routing services are failed-over to another member in the former cluster.
•All applications are stopped.
•The cluster name is changed.
•If the user has chosen to merge data, any unsaved cluster configuration information is saved.
•The system reboots. Configuration information is exchanged. All of the original SCSI routing services appears in the new cluster, unless the user has chosen to delete rather than merge data.
•Access lists are always deleted. To preserve an existing access list and make it available to the new cluster, the user must save the access list to a configuration file before issuing the set cluster command. Make the saved configuration file available to the storage router currently performing access list maintenance functions for the cluster (via the import command), and then restore the saved access list to the new cluster from that configuration file. See "Configuring a Storage Router Cluster" for details.
•For cases where the names of SCSI routing service instances are duplicated within the new cluster (meaning instances of the same name are already running in the new cluster), configuration data from the old cluster is deleted in favor of what is currently running in the new cluster.
Examples
The following shows the initial system response to the set cluster command:
[SN5420_PR]# set cluster myCluster
The current configuration of the SN5420 may conflict with the new cluster.
If you choose to merge the configurations, the applications configured on
the SN5420 will be replicated to other SN5420s in the new cluster. This may
cause conflicts in the new cluster.
** Enter CTRL-C to cancel. **
Merge or delete configuration ? [merge/delete (delete)]
If you choose to merge your configuration, an additional warning displays:
########################################################
Please confirm that you want to merge the configuration.
########################################################
Cluster configuration settings will be saved.
The system will prompt you to REBOOT if you answer "yes".
** Enter CTRL-C to cancel. **
Are you sure you want to merge the configuration ? [must type "yes"]
If you choose to delete your existing configuration, this warning displays:
#########################################################
Please confirm that you want to delete the configuration.
#########################################################
All configuration settings will be saved.
The system will prompt you to REBOOT if you answer "yes"
** Enter CTRL-C to cancel and abort the cluster change. **
Are you sure you want to delete the configuration ? [must type "yes"]
Related Commands
Command
|
Description
|
setup time
|
Run the setup wizard to configure the HA cluster.
|
show cluster
|
Show cluster-related operational statistics, including heartbeat information.
|
show ha
|
Show HA operational statistics for the entire storage router or for the specified application.
|
set debug
To enable or disable debug trace facilities for SCSI routing service instances, use the set debug command.
set debug scsirouter name {scsitrace | no scsitrace}
set debug scsirouter name target name lun nn {scsitrace | no scsitrace}
Syntax Description
scsirouter name
|
The name of the SCSI routing service instance to be traced.
|
target name
|
The name of the target to be traced.
|
lun nn
|
The specific LUN to be traced.
|
scsitrace
|
Enables collection of the specified SCSI-level trace and status information by the target front end (tfe) module.
|
no scsitrace
|
Disabled collection of the specified SCSI-level tfe trace and status information.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
This setting changes the operation of the SN 5420 system and may impact all system performance. The set debug command should only be used under the guidance of a Cisco Technical Support professional.
Related Commands
Command
|
Description
|
set scsirouter loglevel
|
Set the level of SCSI trace and status information logged by the tfe module for the specified SCSI routing service instance.
|
show debug
|
Display SCSI-level trace and status information.
|
set ha import pending none
To reset the import pending flag for a storage router in a cluster, use the set ha import pending none command.
set ha import pending none
Syntax Description
none
|
Keyword indicating that current configuration is valid and there is no expected configuration update from another storage router in the cluster.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
When a storage router is in the process of exchanging a configuration update with the other member of a cluster, the storage router that is receiving the update sets an import pending flag. The flag is reset when the configuration information exchange is complete. If the sending storage router fails before that exchange of information is complete, the receiving storage router in the cluster is unable to run the failed-over SCSI routing services because it is waiting for the updated configuration information.
Should this unlikely circumstance occur, use this command to manually reset the import pending flag, so that the storage router can assume running the failed-over SCSI routing services.
Related Commands
Command
|
Description
|
set ha ipaddress
|
Set the IP address and network mask of the SN 5420's HA interface.
|
setup time
|
Run the setup wizard to configure the HA cluster.
|
set ha ipaddress
To set the IP address and network mask for this system's high-availability interface, use the set ha ipaddress command.
set ha ipaddress {A.B.C.D/bits | A.B.C.D/1.2.3.4}
Syntax Description
A.B.C.D/nn
|
The IP address of the HA interface. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the network mask in CIDR style.
|
A.B.C.D/1.2.3.4
|
The IP address of the HA interface. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the network mask.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The HA features are used within a cluster of storage routers. Each member of the cluster communicates over the HA and management interfaces, exchanging heartbeats and other configuration information, allowing for failover in case of system problems.
The HA interface and the management interface must be on unique IP networks. In a cluster, the HA interfaces for all storage routers should be on the same network.
Note If you use the set ha ipaddress to initially configure the storage router with a high availability interface IP address or to reconfigure the interface after performing a clearconf (instead of using the setup ha wizard), be sure to reboot before continuing with the configuration of SCSI routing services.
If you use this command to change an existing HA IP address, a reboot is not necessary.
Related Commands
Command
|
Description
|
save all
|
Save all configuration data.
|
save system
|
Save system configuration data, including the HP IP address, for the storage router.
|
set mgmt ipaddress
|
Set the management interface IP address and network mask.
|
setup time
|
Run the setup wizard to configure the HA cluster.
|
show cluster
|
Show cluster information, including heartbeats sent and received.
|
show ha
|
Show HA operational statistics for the entire storage router or for the specified application.
|
set interface
To set various operational parameters associated with the specified data interface, such as the size of the maximum transfer unit (MTU), use the set interface command. Fibre Channel interfaces support a variable size MTU, and default to 65280 bytes. Gigabit Ethernet interfaces may support jumbo frames, and default to 1500 bytes.
set interface ge? {mtusize {nn | default} | autonegotiation {autodetect | enabled | disabled}}
set interface fc? {mtusize {nn | default} | topology {ptppref | loop | ptp}}
Syntax Description
{ge? | fc?}
|
Specifies the name of the interface for which you are setting this parameter. When you type the set interface ? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.
|
mtusize nn
|
The size of the MTU, in bytes. nn is an integer between 100 and 65280 for a Fibre Channel interface, and between 60 and 16128 for a Gigabit Ethernet interface.
|
mtusize default
|
Resets the value to the factory default for the type of interface specified. The default for a Fibre Channel interface is 65280 bytes. The default for a Gigabit Ethernet interface is 1500.
|
autonegotiation autodetect
|
Automatically detects if auto-negotiation should be used for this interface. This is the default setting.
|
autonegotiation enabled
|
Auto-negotiation will always be used on this interface.
|
autonegotiation disabled
|
Auto-negotiation will never be used on this interface.
|
topology ptppref
|
Sets a preference for Fibre Channel Point-to-Point topology for this interface. If the Fibre Channel interface does not accept the attempt to establish point-to-point link activation, loop topology will be assumed. This is the default setting.
|
topology loop
|
Sets Fibre Channel topology for this interface to Loop.
|
topology ptp
|
Sets Fibre Channel topology for this interface to Point-to-Point.
|
Defaults
MTU size defaults to 65280 bytes for Fibre Channel interfaces, and 1500 bytes for Gigabit Ethernet interfaces. Autonegotiation defaults to autodetect for Gigabit Ethernet interfaces. Topology defaults to ptppref for Fibre Channel interfaces.
Command Modes
Administrator.
Usage Guidelines
•All storage routers in a cluster should be configured with the same MTU size and other interface-specific parameters, allowing failover of applications to provide consistent performance characteristics.
•If the storage devices are all connected to a hub with the intention of running in an arbitrated loop, you should set the device interface topology to loop.
•If the storage devices are all connected in a point-to-point topology, your should set the device interface topology to ptp.
•You must save all configuration information and reboot the storage router for a new MTU size or topology selection to take effect.
Related Commands
Command
|
Description
|
show interface
|
Display operational statistics about the specified interfaces, or all interfaces.
|
set log level
To set the SN 5420 event-logging threshold for display or log file purposes, use the set log {cli | file} level {debug | info | notice | warning | err | critical | alert | emerg} command.
Log messages are sent to various places, including the serial or Telnet console screens. Setting the CLI log level to critical means that notice, warning and error messages are not displayed. Only critical, alert and emergency messages display.
Setting the file log level to alert means only alert or emergency messages are written to the SN 5420 log file. Debug means all messages are written.
set log {cli | file} level {debug | info | notice | warning | error | critical | alert | emergency}
set log file empty
Syntax Description
debug
|
Enables the display or logging of all messages.
|
info
|
Limits display to informational, notice, warning, error, critical, alert and emergency messages only.
|
notice
|
Limits display to notice, warning, error, critical, alert and emergency messages only.
|
warning
|
Limits display to warning, error, critical, alert and emergency messages only.
|
err
|
Limits display to error, critical, alert and emergency messages only.
|
critical
|
Limits display to critical, alert and emergency message only.
|
alert
|
Limits display to alert and emergency messages only. Alert message mean action should be taken.
|
emerg
|
Limits display to emergency messages only. Message at the emergency level signify that the system is unusable. The display of all other message levels is suppressed.
|
empty
|
Clear the log file of all entries.
|
Defaults
The default log level for both the CLI and the logging file is notice.
Command Modes
Administrator. The set log cli level command can also be issued from Monitor mode.
Usage Guidelines
This command impacts the display and logging of messages, but does not impact the operation of the storage router. Use the show log levels command to display the current CLI and log file thresholds before issuing this command.
Related Commands
Command
|
Description
|
show log
|
Display the current SN 5420 console and file logging threshold, or the contents of the SN 5420 log file.
|
set log remote
To enable logging of SN5420 event messages to a specified host running the syslogd utility (or equivalent), use the set log remote command.
set log remote A.B.C.D [facility {syslog | user | local0 | local1 | local2}]
set log remote none
Syntax Description
A.B.C.D
|
The IP address of the host to which the SN 5420 event messages will be written.
|
facility syslog
|
(Optional) Keywords indicating syslog-level messages.
|
facility user
|
(Optional) Keywords indicating user-level messages.
|
facility local0
|
(Optional) Keywords indicating a defined local level message.
|
facility local1
|
(Optional) Keywords indicating a defined local level message.
|
facility local2
|
(Optional) Keywords indicating a defined local level message.
|
none
|
Keyword used to disable remote logging.
|
Defaults
Remote logging is, by default, disabled. If it is enabled, the facility defaults to syslog.
Command Modes
Administrator.
Usage Guidelines
Every SN 5420 event message handed over to syslogd is assigned a level of importance, based on the facility and message level. The SN 5420 message level maps to the syslogd level parameter. The syslogd configuration specifies an action or action for all messages matching various facility and message levels. Remote Syslog messages are UDP messages sent to UDP port 514. Syslogd, or an equivalent facility, must be appropriately configured on the designed host.
If the set log remote command is issued with a host IP address, but no facility parameter, the facility defaults to syslog. Use the set log remote none command to disable remote logging.
Use the show system command to determine if remote logging is enabled for the SN 5420.
Note Normal logging of SN 5420 event message to the SN 5420 log file and console is not impacted by this command.
Examples
The following is an example of a recorded syslog line from a Solaris host:
Feb 14 14:55:42 [10.1.0.150.4.0] Feb 14 14:55:45:fc1:AS_CRIT:Interface Up
Related Commands
Command
|
Description
|
set log level
|
Set the current SN 5420 console and file error logging threshold.
|
show log
|
Display the current SN 5420 console and file logging threshold, or the contents of the SN 5420 log file.
|
show system
|
Display various system information, including system name, boot parameter, software versions, and information about the SN 5420 network interfaces.
|
set mgmt ipaddress
To set the IP address and network mask of the interface labeled MGMT on the front panel of the SN 5420 Storage Router, use the set mgmt ipaddress command. This address is used to manage the storage router via Telnet, the web-based GUI, or SNMP.
set mgmt ipaddress {A.B.C.D/bits | A.B.C.D/1.2.3.4}
Syntax Description
A.B.C.D/bits
|
The IP address of the management interface. A.B.C.D is the dotted quad notation of the IP address. The /bits specifies the network mask in CIDR style.
|
A.B.C.D/1.2.3.4
|
The IP address of the management interface. A.B.C.D is the dotted quad notation of the IP address. 1.2.3.4 is the dotted quad notation of the network mask.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The management and HA interfaces must be on unique IP networks. In a cluster, the management interfaces for all storage routers should be on the same network.
Note If you use the set mgmt ipaddress to initially configure your SN 5420 with a management interface IP address (instead of using the setup mgmt wizard), be sure to reboot your storage router before continuing.
Related Commands
Command
|
Description
|
add route gw
|
Add a static route to the routing table used for the network management interfaces.
|
delete route
|
Delete the specified route from the system route table.
|
save all
|
Save all configuration data associated with the SN 5420.
|
save system
|
Save all configuration data associated with the SN 5420 system, including management and HA interface information.
|
set ha ipaddress
|
Set the IP address and network mask of the SN 5420's HA interface.
|
setup mgmt
|
Run the setup wizard to configure the management interface.
|
show cluster
|
Show cluster-related operational statistics, including heartbeat information.
|
set monitor password
To set the password used for view-only access to the SN 5420 management interface, use the set monitor password command. Access may be via Telnet (for CLI), or web-based graphical user interface (GUI).
set monitor password string
Syntax Description
password string
|
The password associated with view-only access to the SN 5420 management interface. The default password is "cisco".
|
Defaults
The default password is "cisco".
Command Modes
Administrator.
Usage Guidelines
The SN 5420 management interface is password protected. You must enter passwords when accessing the SN 5420 via the CLI or web-based GUI. The Monitor-mode password provides view-only access to SN 5420 management interface, while the Administrator-mode password allows the user to create entities, and make changes to the configuration of the SN 5420 system.
Set the password string to "" to clears the password, effectively setting it to nothing.
Caution This command displays the password entered in clear text.
Related Commands
Command
|
Description
|
enable
|
Enter Administrator mode.
|
exit
|
Leave Administration mode and enter Monitor mode.
|
save all
|
Save all configuration data, including the monitor password.
|
save system
|
Save system configuration data, including the monitor password, for the storage router.
|
set admin password
|
Set login password for Administrator-mode access to SN 5420 management interface.
|
setup access
|
Run the setup wizard to configure Monitor-mode and Administrator-mode passwords.
|
set nameserver
To set the IP address, and optional domain name, of a primary Domain Name Server, use the set nameserver command.
set nameserver {A.B.C.D [domain {name | none}] | none}
Syntax Description
A.B.C.D
|
The IP address of a primary Domain Name Server, accessible by the storage router. A.B.C.D is the dotted quad notation of the IP address.
|
domain name
|
(Optional) The name of the storage router domain.
|
domain none
|
(Optional) Removes any previous domain name setting, returning the domain name to "none".
|
none
|
Removes any previous primary DNS setting, returning the DNS value to "none".
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The storage router requires access to a DNS if any IP addresses are entered as host names via any of the SN 5420 management interfaces, or if the SN 5420 management interface IP address is to be correlated with a DNS host name.
Note If the DNS is outside the storage router management subnet, use the add route gw command to add an appropriate gateway IP address to the SN 5420 routing table.
Related Commands
Command
|
Description
|
add route gw
|
Add a static route to the SN 5420 routing table.
|
set secnameserver
|
Set the IP address of a secondary DNS, for use if the primary is not available.
|
setup mgmt
|
Run the setup wizard to configure SN 5420 management attributes
|
set ntpserver
To set the name or IP address of a Network Time Protocol (NTP) server with which the storage router will synchronize date and time, use the set ntpserver command.
set ntpserver {A.B.C.D | name | none}
Syntax Description
A.B.C.D
|
The IP address of the NTP server with which the storage router synchronizes date and time. A.B.C.D is the dotted quad notation of the IP address.
|
name
|
The name of the NTP server with which the storage router synchronizes date and time.
|
none
|
Keyword used to remove any previous setting.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The storage router must provide accurate date and time information for log files and user interfaces. It will use the services of the NTP server to keep the date and time synchronized with the rest of the network.
Use the none keyword to clear any current NTP server setting.
Note If the NTP server is outside the storage router management subnet, use the add route gw command to add an appropriate gateway IP address to the SN 5420 routing table.
Related Commands
Command
|
Description
|
add route gw
|
Add a static route to the SN 5420 routing table.
|
save all
|
Save all SN 5420 configuration information.
|
save system
|
Save SN 5420 system configuration information, including NTP server name.
|
set clock
|
Set the SN 5420 system clock to a specified date and time
|
set timezone
|
Set the time zone for the SN 5420.
|
setup time
|
Run the setup wizard to configure SN 5420 date and time information, including NTP server address
|
show clock
|
Show the system date and time.
|
tzselect
|
Select a time zone for the SN 5420 from an extensive list.
|
set scsirouter description
To add user-defined identification information to the named instance of SCSI routing services, use the set scsirouter description command.
set scsirouter name description "user text"
Syntax Description
name
|
The name of this SCSI routing services instance.
|
description "user text"
|
User-defined identification information associated with this SCSI routing services instance. If the string contains spaces, enclose it in quotes.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The set scsirouter description command allows you to add a new description or change an existing description. The create scsirouter command also accepts an optional description parameter.
Related Commands
set scsirouter loglevel
To set the level of trace and debug logging for the specified SCSI routing service instance, use the set scsirouter loglevel command.
set scsirouter name loglevel {debug | info | notice | warning | err | critical | alert | emerg}
Syntax Description
name
|
The name of the SCSI routing service instance.
|
debug
|
Enables the logging of all trace and debug information.
|
info
|
Limits logging to informational, notice, warning, error, critical, alert and emergency trace and debug information only.
|
notice
|
Limits logging to notice, warning, error, critical, alert and emergency trace and debug information only.
|
warning
|
Limits logging to warning, error, critical, alert and emergency trace and debug information only.
|
err
|
Limits logging to error, critical, alert and emergency trace and debug information only.
|
critical
|
Limits logging to critical, alert and emergency trace and debug information only.
|
alert
|
Limits logging to alert and emergency trace and debug information only.
|
emerg
|
Limits logging to emergency trace and debug information only.
|
Defaults
None.
Command Modes
Administration.
Usage Guidelines
This setting controls the level of trace and debug logging that will occur for the specified SCSI routing service instance when trace is enabled. If trace is enabled, this setting may impact all system performance. The set scsirouter loglevel command should only be used under the guidance of a Cisco Technical Support professional.
Related Commands
Command
|
Description
|
set debug
|
Enable and disable debug trace facilities for SCSI routing service instances.
|
show debug
|
Display debug trace information for the SCSI routing service instance.
|
set scsirouter primary
To assign the storage router as the preferred storage router for the named SCSI routing services instance, use the set scsirouter primary command.
set scsirouter name primary {A.B.C.D | none}
Syntax Description
name
|
The name of this SCSI routing services instance.
|
primary A.B.C.D
|
The IP address of the preferred storage router.
|
primary none
|
Keyword used to indicate no preferred storage router.
|
Defaults
The primary attribute defaults to "none".
Command Modes
Administrator.
Usage Guidelines
At any given time, a SCSI routing services instance can run on only one storage router in a cluster. If a SCSI routing services instance has the primary attribute set, the specified system (upon system reboot) will take over running that instance. Use the set scsirouter primary command if you always want the specified SCSI routing services instance to run on a specific storage router in a cluster whenever that storage router is available.
If the primary attribute is set to "none" (the default), the SCSI routing services instance continues running on the storage router where it was started until it is explicitly stopped (via a stop scsirouter command), automatically fails over to another storage router in the cluster because an interface is unavailable or a system failure occurs, or an explicit failover scsirouter command is issued.
Note Setting the primary attribute does not change the existing cluster state, and does not immediately change the location of a running SCSI routing services instance.
For additional information about HA, cluster configuration, and managing SCSI routing services in a cluster environment, see "Configuring a Storage Router Cluster," and "Maintaining and Managing the SN 5420."
Related Commands
set scsirouter target accesslist
To associate the named access list with the specified target, use the set scsirouter target accesslist command.
set scsirouter name target {name | all} accesslist {name | all | none}
Syntax Description
name
|
The name of the SCSI routing services instance to which this target belongs.
|
target name
|
The name of the storage target to associate with this access list.
|
target all
|
Associates all targets with the named access list.
|
accesslist name
|
The name of the access list to associate with this storage target.
|
accesslist none
|
Prevents any new connections and logins to this target from any servers. This is effectively "no access".
|
accesslist all
|
Allows connections and logins for the specified target from all servers. This is effectively "open access".
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
An access list specifies the IP addresses of servers allowed to access the associated storage target through the storage router. Access lists are associated with specific storage targets. Use the target all form of this command to create an association between the specified access list and all targets.
Existing connections and logins are not affected by an access list change. However, if there are existing connections, the SN 5420 system issues a warning message with that information in response to this command.
Use the reserved access list name none to remove any access list associations for the specified target. This effectively prevents access to this storage target from any server.
Use the reserved access list name all to allow access to this storage target from any server. This is effectively "open access".
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Examples
The following example creates an association between the storage target webserver4 (accessed via SCSI routing services instance foo) and the access list webserver2.
set scsirouter foo target webserver4 accesslist webserver2
Related CommandsThe
Command
|
Description
|
add accesslist
|
Add IP addresses of servers allowed to access a common set of storage resources to the specified access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add scsirouter target
|
Associate targets with the named SCSI routing services instance.
|
create accesslist
|
Create the named access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete accesslist
|
Delete a specific access list entry, or an entire access list.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save cofiguration data for the named access list or for all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter primary
|
Designate the storage router as the preferred storage router to run the named SCSI routing services instance.
|
set scsirouter target {enable | disable}
|
Enable or disable connections and logins for the specified target or all targets.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show accesslist
|
Show the contents of the named access list or all access lists.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
set scsirouter target description
To add a description to the named target, use the set scsirouter target command.
set scsirouter name target name description "user text"
Syntax Description
name
|
The name of the SCSI routing services instance to which this target belongs.
|
target name
|
The name of the storage target.
|
description "user text"
|
User-defined identification information associated with this storage target. If the description contains spaces, enclose the string in quotes.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Description information is optional. Use the show scsirouter command to display target description information.
Related CommandsThe
set scsirouter target {enable | disable}
To allow or disallow connections and logins for the named target, use the set scsirouter target command.
set scsirouter name target {name | all} {enable | disable}
Syntax Description
name
|
The name of the SCSI routing services instance to which this target belongs.
|
target name
|
The name of the storage target.
|
target all
|
Allows connections for all targets of this SCSI routing services instance to be enabled or disabled.
|
enable
|
Allows connections and logins for the named target, or for all targets, of the specified SCSI routing services instance.
|
disable
|
Prevents new connections and logins for the named target, or for all targets, of the specified SCSI routing services instance.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
When you add a target to a SCSI routing services instance, it is by default enabled. However, no access list is associated with the target, thus effectively preventing any access to the storage target from any servers. When you associate an access list with a target, the specified connections and logins are allowed. Use the enable and disable keywords on the set scsirouter target command to control access without changing the target access list association.
Existing connections and logins are not affected by the disable keyword, but future connections and logins are not allowed. If existing hosts are connected, the storage router issues a warning message with that information in response to this command.
Use the reserved target name all to enable or disable connections for all targets of this SCSI routing services instance.
Note When making changes to SCSI routing services (such as adding or deleting targets, or changing access) be sure to make the complimentary changes to the iSCSI driver configuration of servers using these services to access the storage resources. See the readme files for the appropriate iSCSI drivers for additional details. You can access the latest iSCSI drivers, readme and example configuration files from Cisco.com.
Examples
The following example enables connections for all targets of the SCSI routing services instance scsiA.
set scsirouter scsiA target all enable
Related CommandsThe
Command
|
Description
|
add accesslist
|
Add the IP addresses of servers allowed to access a common set of storage resources to the specified access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add scsirouter target
|
Associate targets with the named SCSI routing services instance.
|
create accesslist
|
Create the named access list entity.
|
create scsirouter
|
Create the named SCSI routing services entity.
|
delete accesslist
|
Delete a specific access list entry, or an entire access list.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
save accesslist
|
Save cofiguration data for the named access list or for all access lists.
|
save scsirouter
|
Save configuration data for the named instance, or for all instances, of SCSI routing services.
|
set scsirouter target accesslist
|
Associate an access list with a specific SCSI routing services target.
|
set scsirouter target description
|
Add a description to the named SCSI routing services target.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
show accesslist
|
Show the contents of the named access list or all access lists.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances, of SCSI routing services.
|
start scsirouter
|
Start the named SCSI routing services instance.
|
stop scsirouter
|
Stop the named SCSI routing services instance.
|
set secnameserver
To set the IP address of a secondary Domain Name Server, use the set secnameserver command.
set secnameserver {A.B.C.D | none}
Syntax Description
A.B.C.D
|
The IP address of a secondary DNS, accessible by the storage router. A.B.C.D is the dotted quad notation of the IP address.
|
none
|
Removes any previous secondary DNS setting, returning the secondary DNS value to "none".
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The storage router requires access to a DNS if any IP addresses are entered as host names via any of the SN 5420 management interfaces, or if the SN 5420 management interface IP address is to be correlated with a DNS host name. The secondary DNS is used if the primary DNS is not available.
Note If the secondary DNS is outside the storage router management subnet, use the add route gw command to add an appropriate gateway IP address to the SN 5420 routing table.
Related Commands
Command
|
Description
|
add route gw
|
Add a static route to the SN 5420 routing table.
|
setup mgmt
|
Run the setup wizard to configure SN 5420 management attributes
|
set nameserver
|
Set the IP address of a primary DNS.
|
set snmp
To set the name of the community having read access (getcommunity) and write access (setcommunity) to the SN 5420 network, and supply the IP address of destination hosts used for notifications (known as traps), use the set snmp {getcommunity | setcommunity | traphost} command.
set snmp {getcommunity | setcommunity} string
set snmp traphost primary {A.B.C.D | none} [secondary {E.F.G.H | none}]
Syntax Description
getcommunity string
|
The name of the community having read access to the SN 5420 network. The storage router will respond to this community's GET commands. The default getcommunity is public. Enclose the string in quotes.
|
setcommunity string
|
The name of the community having write access to the SN 5420 network. The storage router will respond to this community's SET commands. The default setcommunity is private. Enclose the string in quotes.
|
primary A.B.C.D
|
The IP address of the primary destination host used for notifications (traps). A.B.C.D is the dotted quad notation of the IP address.
|
primary none
|
Disables traps using the primary destination host. If configured, the secondary destination host will be used for notifications. If no secondary address is configured, using the none keyword effecively disables SNMP notifications.
|
secondary E.F.G.H
|
The IP address of the optional secondary destination host used for notifications (traps), used it the primary destination host is not available. E.F.G.H is the dotted quad notation of the IP address.
|
secondary none
|
Disables traps using the secondary destination host. If the primary destination host is configured and is not available, notifications will not occur. If no primary address is configured, using the none keyword effecively disables SNMP notifications.
|
Defaults
The default getcommunity is public. The default setcommunity is private. SNMP notifications are disabled by default (primary and secondary effectively set to "none").
Command Modes
Administrator.
Usage Guidelines
A variety of network management methods may be used with the storage router, including SNMP. All management methods are enabled by default.
To disable SNMP notifications after they have been enabled, use the keyword none with the primary and secondary parameters. SNMP management may also be disabled via the setup mgmt wizard or the web-based GUI.
Related Commands
Command
|
Description
|
setup mgmt
|
Run the setup wizard to configure SN 5420 management attributes
|
set nameserver
|
Set the IP address of a primary DNS.
|
show snmp
|
Display SN 5420 SNMP configuration information.
|
set software url
To set the default location from which to download updated SN 5420 software to the storage router, use the set software url command.
set software url {http://servername/path | default}
Syntax Description
http://servername/path
|
The complete URL identifying the location from which to download SN 5420 software.
|
default
|
Returns this setting to the default download location. The default location is set to "none".
|
Defaults
The location is not set ("none").
Command Modes
Administrator.
Usage Guidelines
Updated SN 5420 software is available from the Cisco.com web site (http://www.cisco.com/pcgi-bin/tablebuild.pl/sn5420). Use a standard browser to download software updates and store them locally. This local location is the location from which you will download updated software to the storage router.
If you plan to download software via the download software version command, the local machine hosting the default location must be running a web server. (If the local machine is not running a web server, use the SN 5420 web-based GUI to make the updated software available to the storage router.)
To see the location defined as the current default download location, issue the show software version command.
Related Commands
Command
|
Description
|
download software list
|
Display a list sof software versions available for download from the default download location.
|
download software readme
|
Fetch the README file for the specified software version from the default download location.
|
download software url
|
Download the specified version of software from the named location.
|
download software version
|
Download the specified version of software from the default download location.
|
save all
|
Save all SN 5420 configuration information.
|
save system
|
Save SN 5420 system configuration information, including the default download location for updated SN 5420 software.
|
show software
|
Display a list of software versions and other relevant information, including current default download location.
|
verify software version
|
Check the specified software version for problems.
|
set software user
To set the optional user name and password used to retrieve updated SN 5420 software from the download location, use the set software user command. See the "set software url" section for details on setting the location from which to download software.
set software user {webserver-username webserver-password | default | none}
Syntax Description
webserver-username
|
An optional user name required to retrieve SN 5420 software from the download location.
|
webserver-password
|
An optional password required to retrieve SN 5420 software from the download location.
|
default
|
Resets the user name and password to their factory defaults.
|
none
|
Indicates user name and password are not required. Sets these values to "none".
|
Defaults
User name and password are, by default, set to "none".
Command Modes
Administrator.
Usage Guidelines
Use the show software command to display the current user name used to retrieve updated SN 5420 software from the download location.
Use the keyword default to reset the user name and password to their factory defaults, or use the keyword none to indicate that the web server does not required a user name and password to download software, effectively changing the user name and password values to "none".
Related Commands
Command
|
Description
|
download software list
|
Display a list sof software versions available for download from the default download location.
|
download software readme
|
Fetch the README file for the specified software version from the default download location.
|
download software url
|
Download the specified version of software from the named location.
|
download software version
|
Download the specified version of software from the default download location.
|
save all
|
Save all SN 5420 configuration information.
|
save system
|
Save SN 5420 system configuration information, including the default download location for updated SN 5420 software.
|
show software
|
Display a list of software versions and other relevant information, including current default download location.
|
verify software version
|
Check the specified software version for problems.
|
set software version
To set the version of SN 5420 software to run the next time the system is booted, use the set software version command. This command does not force a system reset and does not change the currently running version of SN 5420 software.
set software version vx.x-y
Syntax Description
vx.x-y
|
The version of SN 5420 software to be run when the system is reset.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
This command performs necessary system modifications to assure that the new software version can be run. In a cluster environment, this command may temporarily suspend normal HA communications, causing a failover of any SCSI routing service instances active on this storage router.
Any instances with the primary attribute set to the IP address of this storage router will resume running on this storage router after it is rebooted. If you are not going to reboot the SN 5420 immediately, use the failover command to return the desired SCSI routing service instances to this storage router.
Use the show software command to display the list of available versions, the currently running version and the version currently set to run when the system is reset.
Related Commands
Command
|
Description
|
delete software version
|
Remove the specified version of software from the SN 5420.
|
download software list
|
Display a list sof software versions available for download from the default download location.
|
download software readme
|
Fetch the README file for the specified software version from the default download location..
|
download software url
|
Download the specified version of software from the named location.
|
download software version
|
Download the specified version of software from the default download location.
|
save all
|
Save all SN 5420 configuration information.
|
save system
|
Save SN 5420 system configuration information, including the default download location for updated SN 5420 software.
|
show software
|
Display a list of software versions and other relevant information, including current default download location.
|
verify software version
|
Check the specified software version for problems.
|
set systemname
To set the system name for the storage router, use the set systemname command. The SN 5420 is recognized by this name through the management interface.
This command takes effect immediately, and the new system name is automatically integrated into the prompt string.
set systemname name
Syntax Description
name
|
The name of the storage router. This may be the fully-qualified domain name. Maximum length is 19 characters.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
If you wish to enable network management on the SN 5420 using the facilities of a Domain Name Server (DNS), you must make the system name and IP address known to that DNS. Use the system name specified in this command.
Related Commands
Command
|
Description
|
save all
|
Save all SN 5420 configuration information.
|
save system
|
Save storage router system configuration information, including system and cluster name.
|
show devices
|
Display information used to configure the storage router.
|
show system
|
Display various system information, including system name, boot parameter, software versions, and information about the SN 5420 network interfaces.
|
set timezone
To set the time zone for the storage router, use the set timezone command.
set timezone string
Syntax Description
string
|
A character string representing the time zone of the storage router. For example, "America/Chicago"or "Europe/Amsterdam".
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Unless you set the time zone, the clock setting is assumed to be in Universal time (GMT).
You can use the setup time wizard to select a time zone, set the clock and date, and identify an NTP server for the storage router. You can also use the tzselect command to choose a time zone from an comprehensive list. See the "setup time" section or the "tzselect" section for details.
To use the set timezone command, you must know the appropriate time zone string. You may use any string listed by the tzselect command.
Related Commands
Command
|
Description
|
save all
|
Save all SN 5420 configuration information.
|
save system
|
Save SN 5420 system configuration information, including system and cluster name.
|
setup time
|
Run the setup wizard to configure SN 5420 date and time information.
|
show devices
|
Display information used to configure the SN 5420.
|
show system
|
Display various system information, including system name, boot parameters, software versions, and information about the SN 5420 network interfaces.
|
tzselect
|
Select a time zone for the SN 5420 from an extensive list.
|
Setup and Clear Configuration Wizards
Initial system configuration and subsequent reconfiguration can be performed via an interactive wizard interface, either through the RS-232 console interface, or via Telnet (once the management interface has been configured). Wizards prompt you for the necessary information to accomplish the specific configuration task, and may invoke multiple commands to complete their functions.
The CLI provides setup wizards and a clear configuration wizard. The following setup wizards are available:
•Setup All—runs all the individual wizards in sequence.
•Management Interface—configures the management interface with a host name, IP address, etc., and any network management features, such as Telnet, web-based GUI, and SNMP.
•High Availability—configures HA and the HA interface. HA configuration is required in an environment where redundant storage routers are required.
•Date and Time—configures the time zone, use (or non-use) of daylight savings time, the current date and time, and the NTP server address (if one is present).
•Network Management—configures the use of Telnet, web-based GUI, and SNMP for managing the storage router over the network.
•Management Access—configures passwords for monitoring and configuring the storage router.
•SCSI Routing—configures the use of the SN 5420 SCSI routing capabilities.
A Clear Configuration wizard is available for returning certain storage router configuration values to factory default settings.
Operational changes are applied to the currently running system during a setup wizard or after a setup wizard completes. For example, after the Management Interface wizard completes, the system will have an IP address and the management interface will be operational. However, these changes are not saved permanently until the end of the wizard. To quit a setup wizard without saving the changes, press Ctrl-C at any time before the end of the wizard, and then reboot the storage router to restore previous values.
Note Some changes may be retained after a reboot. Be sure to review the prompts that display during configuration using the setup wizards.
Pressing Enter or Return for any given wizard prompt will accept the default value. A default value may be blank or contain a previously configured value. For multiple choice questions, the system will present the choices enclosed in brackets. The default value is shown in parentheses. For example:
Enable SNMP ? [yes/no (yes)]
Using the setup or clearconf commands, you can perform the following actions (Table 7-11).
Table 7-11 Setup and Clearconf Command Actions
Action
|
Commands
|
Configure a complete SN 5420.
|
setup
|
Configure the management interface.
|
setup mgmt
|
Configure the HA interface for the first time
|
setup ha
|
Configure the system date and time
|
setup time
|
Configure the network management interface
|
setup netmgmt
|
Configure management passwords
|
setup access
|
Configure SCSI routing services
|
setup scsi
|
Return most configuration settings to factory defaults.
|
clearconf
|
clearconf
To return certain configuration settings to factory defaults, use the clearconf wizard. The clearconf wizard prompts the user to enter the Administrator mode password, and then to indicate which settings to restore to factory defaults.
clearconf
Syntax Description
This command has no arguments or keywords.
Defaults
See the wizard defaults described for the setup command.
Command Modes
Administrator.
Usage Guidelines
•Select apps to remove all SCSI routing services but retain system configuration settings.
•Select system to remove all SCSI routing services and system configuration settings.
•Select saved to delete all backup configuration files from disk.
•Select all to remove all SCSI routing services, system configuration settings, and saved configuration files.
The system will reboot if you select apps, system or all.
System configuration settings include:
•The management and HA interface IP addresses
•Primary and optional secondary DNS
•NTP server
•SNMP configuration information
•Administrator and Monitor passwords
Deleting system configuration makes the SN 5420 unavailable to Telnet or web-based GUI sessions until the management interface is reconfigured via the RS-232 connection. See "Entering the Management Interface IP Address" in "First-Time Configuration,"for details.
Related Commands
Command
|
Description
|
setup
|
Run all SN 5420 configuration wizards together.
|
setup mgmt
|
Configure the management interface.
|
setup ha
|
Configure the HA interface.
|
setup time
|
Configure the system date and time.
|
setup netmgmt
|
Configure the network management interface.
|
setup access
|
Configure management passwords.
|
setup scsi
|
Configure SCSI routing services.
|
setup
To run all SN 5420 configuration wizards together, use the setup command with no keywords. During setup, operational changes will take place, but these changes are not saved until the end of all wizards. To quit the setup wizard without making changes, press Ctrl-C at any time.
setup
Syntax Description
This command has no arguments or keywords.
Defaults
For multiple choice questions, the system will present the choices enclosed in brackets [ ]. Each multiple choice question has a default answer that is selected when you press Enter or Return. The default is shown in parentheses ( ). For example:
Enable High Availability? [yes/no (no)]
For configuration variables, the current value saved in the system is presented in brackets. For example:
Management Port netmask? [255.0.0.0]
If the configuration variable does not have a value, the system will present a set of "empty" brackets [(empty)] or a template that provides the expected format of the value. For example:
SN5420 system name? [(empty)]
Command Modes
Administrator.
Usage Guidelines
After entering the setup command, several informational messages display, including the following prompt:
User level for setup? [novice/expert (expert)]
•Enter novice to continue with the setup process. Help text will be displayed during the entire wizard.
•Enter expert to continue with the setup process, suppressing all Help text. If you are an experienced user, familiar with the setup wizard, you may prefer this option.
At the end of the wizards, the following prompt displays:
Related Commands
setup access
To configure passwords for monitoring and administering the storage router, use the setup access command. The setup access command runs the Management Access wizard, which prompts the user to enter and confirm new passwords.
setup access
Syntax Description
This command has no arguments or keywords.
Defaults
See the wizard defaults described for the setup command.
Command Modes
Administrator.
Usage Guidelines
The wizard prompts the user to enter (and confirm by re-entering) the new Monitor password, which allows view-only SN 5420 access. The user is also prompted to enter (and confirm by re-entering) the new Administrator password, which allows configuration changes to be made.
Related Commands
Command
|
Description
|
setup
|
Run all SN 5420 configuration wizards together.
|
setup mgmt
|
Configure the management interface.
|
setup ha
|
Configure the HA interface.
|
setup time
|
Configure the system date and time.
|
setup netmgmt
|
Configure the network management interface.
|
setup scsi
|
Configure SCSI routing services.
|
clearconf
|
Return most configuration settings to factory defaults.
|
setup ha
To initially configure the high availability environment for the SN 5420, use the setup ha command. The setup ha command runs the High Availability wizard, which prompts the user to enable HA functionality, which is set off by default. It also prompts the user to enter the cluster name, HA interface IP address and network mask, and optional gateway identification.
setup ha
Syntax Description
This command has no arguments or keywords.
Defaults
See the wizard defaults described for the setup command.
Command Modes
Administrator.
Usage Guidelines
When all information has been entered, the wizard displays notification that the HA interface is operational, and it discovers other systems participating in the cluster. If no other systems are currently participating in the cluster, the user is prompted to confirm the cluster name. If the name is incorrect, the wizard is rerun.
Note This setup wizard can only be run at initial system configuration, or when the cluster name is set to the default. If the SN 5420 is already a member of a cluster, or has a cluster name set, use the conventional CLI commands to perform these actions.
Related Commands
Command
|
Description
|
setup
|
Run all SN 5420 configuration wizards together.
|
setup mgmt
|
Configure the management interface.
|
setup time
|
Configure the system date and time.
|
setup netmgmt
|
Configure the network management interface.
|
setup access
|
Configure management passwords.
|
setup scsi
|
Configure SCSI routing services.
|
clearconf
|
Return most configuration settings to factory defaults.
|
setup mgmt
To configure the SN 5420 management interface, use the setup mgmt command. The setup mgmt command runs the run the Management Interface wizard, which prompts the user to enter the SN 5420 system name, management interface IP address and network mask, optional default gateway and DNS information.
setup mgmt
Syntax Description
This command has no arguments or keywords.
Defaults
See the wizard defaults described for the setup command.
Command Modes
Administrator.
Usage Guidelines
The management interface must be configured before the Telnet interface or web-based GUI can be used for configuration or monitoring tasks. When the wizard is completed, the system displays notification that the management interface is operational. The user may be prompted to reboot the SN 5420 at this time. If the user wishes to continue configuration via a Telnet session, a reboot following the successful completion of the Management Interface wizard is required.
Related Commands
Command
|
Description
|
setup
|
Run all SN 5420 configuration wizards together.
|
setup ha
|
Configure the HA interface
|
setup time
|
Configure the system date and time
|
setup netmgmt
|
Configure the network management interface
|
setup access
|
Configure management passwords
|
setup scsi
|
Configure SCSI routing services
|
clearconf
|
Return most configuration settings to factory defaults.
|
setup netmgmt
To enable network management via any or all of the available interfaces (Telnet, web-based GUI, or SNMP), use the setup netmgmt command. The setup netmgmt command runs the Network Management wizard, which prompts the user to selectively enable the various interfaces and, if SNMP is enabled, will prompt the user to enter the read and write community information, and primary and secondary IP addresses for SNMP traps.
setup netmgmt
Syntax Description
This command has no arguments or keywords.
Defaults
See the wizard defaults described for the setup command.
Command Modes
Administrator.
Usage Guidelines
All network management interfaces are enabled by default, with SNMP "gets" via the public read community. Run this wizard to disable any of these interfaces, or to change the SNMP read community, configure the SNMP write community for SNMP "sets", or add addresses for SNMP traps.
Related Commands
Command
|
Description
|
setup
|
Run all SN 5420 configuration wizards together.
|
setup mgmt
|
Configure the management interface.
|
setup ha
|
Configure the HA interface.
|
setup time
|
Configure the system date and time.
|
setup access
|
Configure management passwords.
|
setup scsi
|
Configure SCSI routing services.
|
clearconf
|
Return most configuration settings to factory defaults.
|
setup scsi
To configure SCSI routing services for the storage router, use the setup scsi command. The setup scsi command runs the SCSI Routing wizard, which prompts the user to enter the name of the SCSI routing services instance (maximum 32 characters) and then discovers all Fibre Channel devices connected to the SN 5420. More granular configuration of SCSI routing services can be performed via the CLI or the web-based GUI.
setup scsi
Syntax Description
This command has no arguments or keywords.
Defaults
See the wizard defaults described for the setup command.
Command Modes
Administrator.
Usage Guidelines
If the storage devices are all connected to a hub with the intention of running in an arbitrated loop, use the set interface command to change the topology to loop before using the the setup scsi command. This will ensure successful device discovery.
After the wizard finishes the discovery process, it displays a default mapping of target names with all accessible storage devices. Target names may be modified by using the web-based GUI or a combination of CLI add and delete commands.
This command can only be run at initial system configuration, or when no SCSI routing services have been configured on the storage router.
Related Commands
Command
|
Description
|
setup
|
Run all SN 5420 configuration wizards together.
|
setup mgmt
|
Configure the management interface.
|
setup ha
|
Configure the HA interface.
|
setup time
|
Configure the system date and time.
|
setup netmgmt
|
Configure the network management interface.
|
setup access
|
Configure management passwords.
|
clearconf
|
Return most configuration settings to factory defaults.
|
setup time
To set current date and time information, and other time-related configuration setting, use the setup time command. The setup time command runs the Date and Time wizard. The storage router uses date and time information for log files and the user interface.
setup time
Syntax Description
This command has no arguments or keywords.
Defaults
See the wizard defaults described for the setup command.
Command Modes
Administrator.
Usage Guidelines
The wizard prompts the user to enter the appropriate time zone (as an offset from Universal/GMT). The user may also enter an optional name or IP address of an NTP server, to be used by the SN 5420 for date and time synchronization. Finally, the wizard prompts the user for the current date and time.
Related Commands
Command
|
Description
|
setup
|
Run all SN 5420 configuration wizards together.
|
setup mgmt
|
Configure the management interface.
|
setup ha
|
Configure the HA interface.
|
setup netmgmt
|
Configure the network management interface.
|
setup access
|
Configure management passwords.
|
setup scsi
|
Configure SCSI routing services.
|
clearconf
|
Return most configuration settings to factory defaults.
|
Show Commands
The show commands display all configuration and operational data for the storage router. The show commands may be used to display accumulated statistics, including login information, receive (server to storage router) and transmit (storage router to server) statistics, and comprehensive error statistics.
Using the show commands you can perform the following actions (Table 7-12).
Table 7-12 Show Command Actions
Action
|
Commands
|
Shows a list of access lists, or shows the content of a specific access list or all access lists.
|
show accesslist
|
Show the system administrator contact information.
|
show admin
|
Show the system date and time.
|
show clock
|
Show cluster-related operational statistics, including heartbeat information.
|
show cluster
|
Lists the contents of the savedconfig directory, which contains system configuration files, or the contents of a specified configuration file.
|
show savedconfig
|
Perform the following display functions related to SCSI routing services:
•show current configuration information for all instances
•show current configuration information for the named instance
•show the current connections associated with the named instance or all instances
•show current configuration information for the targets associated with the named instance
•show current configuration information for the interface between the SCSI routing services instance and the servers/hosts
•show current configuration information for the interface between the SCSI routing services instance and the target storage devices
•show current server status and currently connected hosts, if server state is active
•show accumulated information about all hosts that have connected since the instance became active, including login data, receive and transmit statistics, and other accumulated statistics
|
show scsirouter
The following variations of this command provide the means to perform the actions described:
show scsirouter
show scsirouter name
show scsirouter connection
show scsirouter targets
show scsirouter serverif
show scsirouter deviceif
show scsirouter hosts
show scsirouter stats
|
Shows a list of devices found on the Fibre Channel network.
|
show device
|
Show various system information, including boot parameter, software versions, and information about the SN 5420 network interfaces.
|
show system
|
Show the primary and secondary trap hosts, and the get community and set community strings.
|
show snmp
|
Show a list of software versions and other relevant software information, including current URL from which to download new software and amount of NVRAM available for new software.
|
show software
|
Perform the following display functions related to SN 5420 interfaces:
•show operational characteristics, such as MTU size, for the Fibre Channel, Gigabit Ethernet, management and HA interfaces
•show a line of status information, including input and output packet count, for each SN 5420 interface
•show (and optionally clear) operational statistics related to the Fibre Channel interface
•show (and optionally clear) operational statistics related to the Gigabit Ethernet interface
•show (and optionally clear) operational statistics related to the management interface
•show (and optionally clear) operational statistics related to the HA interface
|
show interface
The following variations of this command provide the means to perform the actions described:
show interface
show interface brief
show interface fc? stats
show interface ge?stats
show interface fei0 stats
show interface fei1 stats
|
Perform the following display functions related to protocols used in the SN 5420 network:
•show various statistics related to named protocol
•show the ARP table
•show known hosts on the IP network
•show the system route table, including network and host routes
•show active TCP connections, including server tasks
•show UDP activity on the system
|
show net
The following variations of this command provide the means to perform the actions described:
show net stat
show net arp
show net hosts
show net route
show net tcp
show net udp
|
Perform the following display functions related to SN 5420 logging:
•display the current logging levels associated with the CLI and the log file
•display some or all of the current log file, or display selected entries or log file size
|
show log
The following variations of this command provide the means to perform the actions described:
show log levels
show log file
|
Display operational information about the HA interface and SCSI routing services running in the HA environment
|
show ha
|
Show boot information and startup file parameters
|
show boot
|
Show memory buffer usage
|
show buffers
|
Show CPU utilization percentage
|
show cpu
|
Show information from the last saved crash trace
|
show crash
|
Perform the following display functions related to SCSI-level trace and debug tasks:
•display status of trace configuration
•display the traces for the specified SCSI routing service instance
•display the traces for the specified LUN
•display the raw LUN database for all discovered targets
|
show debug
The following variations of this command provide the means to perform the actions described:
•show debug scsirouter tfestatus
•show debug scsirouter scsitrace
•show debug scsirouter target lun scsitrace
•show debug rawlundatabase
|
Indicate if the hardware passed diagnostic tests on startup
|
show diagnostics
|
Show information about memory and related system resources
|
show memory
|
Show information about all SN 5420 software modules
|
show modules
|
Show Network File System (NFS) authorization information
|
show nfs
|
Show usage of the stack on a per task basis
|
show stack
|
Show information about all or specified tasks
|
show task
|
Shows the output from a variety of CLI show commands
|
show tech-support
|
show accesslist
To display a list of access lists, or the contents of the named access list (or all access lists), use the show accesslist command.
show accesslist [name | all] [from {bootconfig | filename | runningconfig}]
Syntax Description
name
|
(Optional) The name of the access list.
|
all
|
(Optional) Keyword used to display all access list entries.
|
from bootconfig
|
(Optional) Keywords used to display the access list information from the persistent saved configuration.
|
from filename
|
(Optional) The name of the file where the access list configuration is stored. This file must exist in the savedconfig directory.
|
from runningconfig
|
(Optional) Keywords used to display the access list information from the currently running configuration.
|
Defaults
If no from parameters are specified, the display shows information from the currently running configuration.
Command Modes
Administrator.
Usage Guidelines
•Use the show accesslist (or show accesslist from runningconfig) command to display a list of all access lists from the current running configuration.
•Use the all keyword to display the contents of all access lists.
•Use the from bootconfig keywords to display the specified access list information as it exists in the current saved configuration. This may differ from the running configuration.
Examples
To display a list of access lists, issue this command:
To display the contents of all access lists from the current running configuration, issue this command:
To display the contents of all access lists as they exist in the current saved configuration, issue this command:
show accesslist all from bootconfig
To display the contents of the access list named webserver2 from the current running configuration, issue this command:
show accesslist webserver2
To display the contents of the access list named webserver2 as it exists in the saved configuration file backup_1218, issue this command:
show accesslist webserver2 from backup_1218
Related Commands
show admin
To display the system administrator contact information, use the show admin command.
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
The following information displays:
•Contact name
•E-mail
•Phone
•Pager
Related Commands
show boot
To display system boot information and startup file parameters, use the show boot command.
show boot
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
Use this command to view system boot information, such as the boot device type, path to the boot image, and path to the file containing the startup commands. The show boot command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show buffer
To display buffer pool information for a variety of areas, use the show buffer command.
show buffer
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
The display includes the number of free memory buffers for each pool, along with those currently allocated to various functions. The show buffer command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show clock
To display the current system date and time, use the show clock command. The information displays in the following format:
show clock
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator or Monitor.
Related Commands
Command
|
Description
|
set clock
|
Set the system clock to the given date and time.
|
set ntpserver
|
Set the name or IP address of the NTP server with which the storage router will synchronize date and time.
|
set timezone
|
Set the storage router time zone information.
|
setup time
|
Run the setup wizard to configure date and time information (including NTP server and time zone) associated with the storage router.
|
tzselect
|
Select a time zone for the storage router from an extensive list.
|
show cluster
To display operational information related to the storage router cluster, use the show cluster command.
show cluster
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
The show cluster command displays the following fields:
Field Name
|
Data Format
|
Description
|
Cluster Name
|
string
|
Name of SN 5420 cluster
|
HA State
|
string
|
Indicates the state of HA in the storage router. Valid states include "not running", "running standalone", and "running in cluster"
|
Cluster Changes
|
decimal
|
Number of changes to cluster configuration since last restart
|
Last Change
|
date
|
Date and time of last configuration change
|
Sent heartbeats
|
decimal
|
Number of heartbeats transmitted on the high availability (HA) network
|
Recvd heartbeats
|
decimal
|
Number of heartbeats received on the HA network
|
Node ID
|
string
|
System name (or hex digits)
|
fei0/MGMT
|
IP address
|
Management interface IP addresses of this storage router and the other cluster member
|
fei1/HA IP
|
IP address
|
HA interface IP address of this storage router and the other cluster member
|
Last Heard From
|
date
|
The date the cluster member was last heard from.
|
Application Name
|
string
|
Name of the active SCSI routing services instance. For example, scsirouter/scsi1 or scsirouter/mySCSI
|
Managed on
|
IP address
|
The IP address where this instance is running
|
State
|
string
|
Indicates whether the instance is the primary or secondary
|
Last Config Update
|
date
|
Date of last configuration update for this SCSI routing services instance
|
Access List Management IP
|
IP address
|
The IP address of the storage router in the cluster that currently handles access list management.
|
Related Commands
Command
|
Description
|
restore all from
|
Restore all the contents of a named configuration file to persistent memory.
|
restore scsirouter from
|
Restore the named SCSI routing services instance, or all instances, from the named configuration file.
|
save all
|
Save all configuration data.
|
save scsirouter
|
Save configuration data for the named instance, or for all instances of SCSI routing services.
|
save system
|
Save configuration data for the SN 5420 system.
|
show cpu
To display CPU utilization information, use the show cpu command.
show cpu
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
Use this command to view the percentage of CPU utilization for the last five seconds, the last minute, and the last five minutes. The show cpu command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show crash
To display saved crash trace information, or current crash trace information, use the show crash command.
show crash [current]
Syntax Description
current
|
(Optional) Returns the current crash trace information for the running storage router.
|
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
The default crash trace file is crash.txt in the log directory. This file is created if the storage router unexpectedly restarts. Use the current keyword to display the trace information as it exists for the currently running storage router.
The show crash command is designed for debug purposes, and should only be used under the guidance of a Cisco Technical Support professional.
show devices
To display a list of devices found on the SN 5420 Fibre Channel network, use the show devices command.
show devices
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use this command to display the WWNN, WWPN, LoopID, LUN number, vendor, product name and serial number for all devices found on the SN 5420 Fibre Channel network.
Related Commands
Command
|
Description
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add scsirouter target
|
Assign targets to the named SCSI routing services instance.
|
show interface
|
Display operational characteristics and statistics for storage router interfaces.
|
show scsirouter
|
Display configuration and operational details about the named instance, or all instances, of SCSI routing services.
|
show debug
To display a variety of debug information for the specified SCSI router service instance or target and LUN, use the show debug command.
show debug scsirouter {name | all} {tfestatus | scsitrace}
show debug scsirouter name target name lun nn scsitrace
show debug rawlundatabase
Syntax Description
scsirouter name
|
The name of the SCSI routing service instance.
|
all
|
Keyword used to display information for all SCSI routing service instances.
|
target name
|
The name of the target associated with the specified SCSI routing service instance.
|
nn
|
The target LUN number.
|
tfestatus
|
Keyword used to display the status of the tfe trace configuration.
|
scsitrace
|
Keyword used to display trace information for the specified SCSI router service instance or target and LUN combination.
|
rawlundatabase
|
Keyword used to display raw LUN database information for all discovered targets.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
The show debug command is designed for debug purposes, and should only be used under the guidance of a Cisco Technical Support professional.
Related Commands
Command
|
Description
|
set debug
|
Enable or disable debug trace activities for SCSI routing service instances.
|
set scsirouter loglevel
|
Set the level of debug tracing.
|
show diagnostics
To show that the hardware passed diagnostic tests on startup, use the show diagnostics command.
show diagnostics
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
The show diagnostics command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show ha
To display HA statistics for the storage router or selected applications and instances of SCSI routing services running in the HA environment, use the show ha command.
show ha [stat node]
show ha stat app {all | list | number number}
Syntax Description
stat
|
(Optional) Keyword used to display operational statistics, including number of messages sent and received.
|
node
|
(Optional) Show HA statistics for the storage router and all running applications and SCSI routing services.
|
app all
|
(Optional) Show HA statistics for all applications.
|
app list
|
(Optional) Display a list of HA applications.
|
app number
|
(Optional) Keywords used to display HA statistics for the specified application from the list.
|
number
|
(Optional) The number of the application to display ( from the list displayed using the show ha stat app list command).
|
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
Use this command to help deteremine if there are communications problems within the storage router cluster. The show ha command (with no parameters) displays the state of the management and HA interfaces.
To display statistics about all applications, issue this command:
To display a list of SCSI routing services and applications, with their creation dates and last failover times, issue this command:
The following example uses the app list keywords to display a list of applications and SCSI routing instances, and then uses the app number keywords to display operational statistics about the SCSI instance named myScsi1.
[SN5420-1]# show ha stat app list
----------------------------HA APPLICATION LIST--------------------------
Type = cluster Created = THU FEB 01 00:10:25 2001
(Number 3 ) cluster/myCluster Created = THU FEB 01 00:10:25 2001
Activated = not available
Last Failover = no failover yet
Type = scsirouter Created = THU FEB 01 00:10:25 2001
(Number 0 ) scsirouter/myScsi1 Created = THU FEB 01 00:13:17 2001
Activated = THU FEB 01 18:05:01 2001
Last Failover = not available
(Number 1 ) scsirouter/myScsi1 Created = not available
Activated = FRI FEB 02 09:30:47 2001
Last Failover = THU FEB 01 19:28:33 2001
(Number 2 ) scsirouter/myScsi3 Created = not available
Activated = FRI FEB 02 19:30:52 2001
Last Failover = THU FEB 01 19:28:38 2001
-------------------------------------------------------------------------------
[SN5420-1]# show ha stat app number 0
----------------------------HA APPLICATION Number 0---------------------
Application Name = scsirouter/myScsi1
Type = scsirouter Master Specifics: DataBase:
AppId = 072c1560 Node Id = 3d000820 ID = 8dcdb379
State = Master Preferred Slave = No Status = Up to Date
Permanent Master = No Last Update =
HA Message Transmission Summary:
Total = 00000005 Broadcasts = 00000002 Unicasts = 00000003
HA Message Reception Summary:
-------------------Message Breakdown------------------
Message Types Received Message Types Transmitted
Master Requests = 00000002 Master Requests = 00000001
Master Acks = 00000001 Master Acks = 00000002
Elections = 00000001 Elections = 00000001
Refusals = 00000000 Refusals = 00000000
Conflicts = 00000000 Conflicts = 00000000
Resolves = 00000000 Resolves = 00000000
Quits = 00000000 Quits = 00000000
Resignations = 00000000 Resignations = 00000001
Doas = 00000000 Doas = 00000000
Related Commands
Command
|
Description
|
set ha ipaddress
|
Set the HA interface IP address and network mask.
|
setup time
|
Configure the HA interface for the first time.
|
show interface
To display operational characteristics and statistics for interfaces configured for the storage router, use the show interface command. Statistics are cumulative since the last time the system was started.
show interface [brief]
show interface [fc? | ge? | fei0 | fei1 |all] [stat [clear]]
Syntax Description
brief
|
(Optional) Show basic operational characeristics for all interfaces, including status, IP address, and selected options.
|
fc?
|
(Optional) Show basic operational characteristics and configuration data (including MTU size and topology information) for the specified Fibre Channel interface.
|
ge?
|
(Optional) Show basic operational characteristics and configuration data (including MTU size and autonegotiation setting) for the specified Gigabit Ethernet interface.
|
fei0
|
(Optional) Show basic operational characteristics and configuration data (including MTU size) for the management interface.
|
fei1
|
(Optional) Show basic operational characteristics and configuration data (including MTU size) for the HA interface.
|
all
|
(Optional) Keyword used to show all operational and configuration data for all interfaces.
|
stat
|
(Optional) Show operational statistics, such as number of input and output packets, for the specified interface.
|
clear
|
(Optional) Show operational statistics for the specified interface, and then clear and reset.
|
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
•Use the show interface command with no parameters to display the basic operational characteristics for all interfaces defined for the SN 5420.
•Use the show interface fc? stat command to display operational statistics related to the Fibre Channel interface, including packets received and transmitted, collisions, octets, multicast packets, dropped and unsupported protocol.
•Use the show interface ge? stat command to display operational statistics related to the Gigabit Ethernet interface, including including packets received and transmitted, collisions, octets, multicast packets, dropped and unsupported protocol.
•Use the show interface brief command to display basic operational characteristics for each of the storage router interfaces. This display includes status information for the interface (up or down), and selected operational options, such as type of interface, MTU size, and speed.
Related Commands
Command
|
Description
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add scsirouter target
|
Assign targets to the named SCSI routing services instance.
|
delete scsirouter
|
Delete the named elements from the SCSI routing services instance.
|
save all
|
Save all configuration data.
|
set ha ipaddress
|
Set the HA interface IP address and network mask.
|
set interface
|
Set MTU size, and topology or autonegotiation for the data interface.
|
set mgmt ipaddress
|
Set the management interface IP address and network mask.
|
setup time
|
Run the wizard to configure the SN 5420 HA environment.
|
setup mgmt
|
Run the wizard to configure the SN 5420 management environment.
|
show log
To display event logging levels for the console and the storage router log file, or to display contents of the log file, use the show log command.
show log level
show log file [[last nn | all] [match string] | size]
Syntax Description
level
|
Display event logging levels for the storage router console and log file.
|
file
|
Display the last 20 lines from the current storage router log file.
|
last nn
|
(Optional) Display the last nn lines from the current storage router log file.
|
all
|
(Optional) Display all log file entries.
|
match string
|
(Optional) Display all entries that match the specified string.
|
size
|
(Optional) Display the number of messages in the log file and the size of the logfile, in bytes.
|
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
•Use the show log level command to display the current event logging level for the storage router console and the log file. Change the setting via the set log level command.
•Use the match string parameters to display messages matching the specified string. You can search the entire log file for matching messages, or restrict the search to the last nn number of messages.
Related Commands
Command
|
Description
|
set log level
|
Set the current storage router console and file error logging threshold.
|
show memory
To display information about memory and related resources in the storage router, use the show memory command.
show memory
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
The show memory command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show modules
To display addressing information about the modules included in the storage router, use the show modules command.
show modules
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
The show modules command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show net
To display information about the SN 5420 network, including a variety of protocol stack statistics, use the show net command.
show net stat {route | tcp | udp | ip | icmp}
show net {arp | hosts | route | tcp | udp}
Syntax Description
stat route
|
Displays route-related network statistics.
|
stat tcp
|
Displays TCP-related network statistics.
|
stat udp
|
Displays UDP-related network statistics.
|
stat ip
|
Displays IP-related network statistics
|
stat icmp
|
Displays ICMP-related network statistics.
|
arp
|
Displays the ARP table.
|
hosts
|
Displays all known hosts on the SN 5420 IP network.
|
route
|
Displays the system route table.
|
tcp
|
Displays active TCP connections.
|
udp
|
Displays system UDP activity.
|
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
•Use the stat {route | tcp | udp | ip | icmp} keywords to display net stats related to route, TCP, UDP, IP and ICMP.
•Use the arp keyword to display the ARP table.
•Use the hosts keyword to display all known hosts on the SN 5420 IP network.
•Use the route keyword to display the SN 5420 system routing table, including network and host routes. 0.0.0.0/32 is the default route.
•Use the tcp keyword to display active TCP connections, including server tasks.
•Use the udp keyword to display User Datagram Protocol (UDP) activity on the system.
Related Commands
Command
|
Description
|
add route gw
|
Add a static route to the SN 5420 routing table.
|
show nfs
To display NFS machine name and authorization information, including device name and mount point for mounted NFS file systems, issue the show nfs command.
show nfs
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
The show nfs command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show savedconfig
To list the available files in the savedconfig directory, use the show savedconfig command. Configuration files are stored in the savedconfig directory.
show savedconfig
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use this command to displaya list of configuration files in the savedconfig directory before attempting a restore. Use the show scsirouter from or show accesslist from commands to display the contents of the named configuration file and verify that the object of your restore command exists in the selected file.
Related Commands
Command
|
Description
|
delete savedconfig
|
Delete the named configuration file from the savedconfig directory.
|
import savedconfig
|
Transfer the named configuration file from the specified location to the savedconfig directory.
|
restore all from
|
Restore the complete contents of the named file to the indicated storage router.
|
restore scsirouter from
|
Restore the configuration of the named SCSI routing services instance, or all instances, from the named configuration file.
|
save all
|
Save all configuration data.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
save system
|
Save system configuration data for the storage router.
|
show cluster
|
Show cluster-related operational statistics, including heartbeat information.
|
show scsirouter
To display configuration information and operational statistics related to all SCSI routing services, or the named SCSI routing services instance, use the show scsirouter command.
show scirouter [from {bootconfig | filename | runningconfig}]
show scsirouter [name | all] [all | serverif | deviceif] [from
{bootconfig | filename | runningconfig}]
show scsirouter [name | all] stats
show scsirouter [name | all] connection [stats [clear] | tcp]
show scsirouter [name | all] host [stats [clear]]
show scsirouter [name | all] target [name | all] [from
{bootconfig | filename | runningconfig} | stats [clear]]
Syntax Description
from bootconfig
|
(Optional) Display the requested SCSI routing services configuration information from the persistent saved configuration.
|
from filename
|
(Optional) The name of the saved configuration file containing the specified SCSI routing services instance information. This file must exist in the savedconfig directory.
|
from runningconfig
|
(Optional) Display the requested SCSi routing services configuration information from the currently running configuration.
|
name
|
(Optional) The name of the SCSI routing services instance
|
scsirouter all
|
(Optional) Keyword used to display the requested information about all instances of SCSI routing services.
|
all
|
(Optional) Keyword used to display all configuration information about the specified SCSI routing services instance (or all instances).
|
serverif
|
(Optional) Restricts display to configuration information for interfaces between the named SCSI routing services instance and servers.
|
deviceif
|
(Optional) Restricts display to configuration information for interfaces between the named SCSI routing services instance and the target storage devices.
|
stats
|
(Optional) Display accumulated operational information about the SCSI routing services instance (including connections, hosts or targets). This display shows statistics accumulated since the named SCSI routing services instance became active or statistics were last cleared, whichever is more recent.
|
connection
|
(Optional) Keyword used to display connection information for the named SCSI routing services instance, or all instances.
|
clear
|
(Optional) Keyword used to display and then clear accumulatedoperational statistics for the named instance or all instances of SCSI routing services.
|
tcp
|
(Optional) Keyword used to display current and maximum TCP window size for each connected host.
|
targets
|
(Optional) Restricts display to configuration information related to targets associated with the SCSI routing services instance.
|
hosts
|
(Optional) Display server status and other operational data for hosts currently connected to the named SCSI routing services instance.
|
Defaults
The show scsirouter command with no parameters displays configuration information for all instances of SCSI routing services running on this storage router. When no from parameters are specified, the information displayed is from the currently running configuration.
Command Modes
Administrator.
Usage Guidelines
In a cluster environment, a storage router that is currently running a SCSI routing services instance is known as the current primary for that instance. Issue the appropriate show commands from this storage router to display complete configuration information and operational statistics for the active SCSI routing services instance. If you issue show commands from the storage router that is not running the instance, operational statistics are not available and configuration information is truncated.
Use the optional keywords target, serverif and deviceif to restrict the display to SCSI routing services configuration information related to those objects. For example:
•The command show scsirouter name target displays current configuration information for all targets associated with the named instance, including access lists.
•The command show scsirouter all serverif displays current configuration information for interfaces between all SCSI routing services and the servers/hosts.
•The command show scsirouter name deviceif displays current configuration information for the interface between the named instance and the target storage devices.
Use the connection or host keywords to display specific operational data for the named instance or all instances of SCSI routing services.
•The command show scsirouter name host stats displays server status and operational statistics for currently connected hosts for the named SCSI routing services, if the server status is active.
The following server status fields are displayed:
Field Name
|
Data Format
|
Description
|
SrvState
|
string
|
The current server state (active or inactive). If the server is active, connected host information is also displayed.
|
Uptime
|
decimal
|
Elapsed amount of time the system has been active, in seconds
|
StartTime
|
date
|
The date the server was last started
|
ConnsAccepted
|
decimal
|
Total number of connections accepted since the last time the system was started
|
ConnsOpen
|
decimal
|
Total number of connections that are currently open
|
SessionsActive
|
decimal
|
Total number of sessions that are currently active
|
The following connected host fields are displayed, if the server is active:
Field Name
|
Data Format
|
Description
|
IpAddr
|
dotted-quad IP address
|
IP address of the connected host
|
TcpPort
|
decimal
|
TCP port number for this connection
|
SessionId
|
decimal:decimal
|
A pair of numbers that uniquely identify this session
|
HConnState
|
string
|
The state of the host connection (NotLoggedIn or FullPhase)
|
Rtt
|
boolean
|
On or off
|
HConnElasped
|
decimal
|
Total Amount of time this host has been connected, in seconds
|
HConnDate
|
date
|
Date this connection was established
|
HrxDataBytes
|
decimal
|
Total amount of data received from host on this connection, in bytes
|
HtxDataBytes
|
decimal
|
Total amount of data transmitted to the hosts on this connection, in bytes
|
HScsiCmdsRej
|
decimal
|
Total number of SCSI commands rejected on this connection
|
•The command show scsirouter name stats displays accumulated operational information about all hosts that have been connected since the named instance became active. Operational statistics include login information, host-to-router and router-to-host statistics, followed by a roll-up of selected statistics for quick reference.
The following detail fields are displayed:
Field Name
|
Data Format
|
Description
|
IpAddr
|
dotted-quad IP address
|
The IP address of the connected host.
|
InitiatorName
|
string
|
The name of the initiator. This field is usually blank.
|
LoginsActive
|
decimal
|
Total number of active logins for this instance
|
LastLoginTime
|
date
|
The date and time the last login occurred
|
LoginsTerminated
|
decimal
|
Total number of logins terminated
|
LastLoginTerminatedTime
|
date
|
The date and time the last login termination occurred
|
RxTotMsgs
|
decimal
|
Total number of messages received from this host
|
RxNopMsgs
|
decimal
|
Total number of no-op messages received
|
PingCmdMsgs
|
decimal
|
Total number of "ping" command messages exchanged
|
ScsiCmdMsgs
|
decimal
|
Total number of SCSI commands received
|
ScsiCmdsRej
|
decimal
|
Total number of SCSI commands rejected
|
RxScsiDataMsgs
|
decimal
|
Total number of SCSI data messages received
|
ScsiDataMsgsRejected
|
decimal
|
Total number of SCSI data messages rejected
|
RxScsiDataBytes
|
decimal (64 bits)
|
Total amount of SCSI data received from this host, in bytes
|
ScsiDataBytesDiscarded
|
decimal
|
Total amount of SCSI data discarded from this host, in bytes
|
TaskMgtMsgs
|
decimal
|
Total number of task management messages exchanged
|
TaskMgtMsgsRej
|
decimal
|
Total number of task management messages rejected
|
LoginCmdMsgs
|
decimal
|
Total number of login command messages exchanged
|
LoginCmdMsgsRej
|
decimal
|
Total number of login command messages rejected
|
TextCmdMsgs
|
decimal
|
Total number of text command messages received
|
TextCmdMsgsRej
|
decimal
|
Total number of text command messages rejected
|
InvalidMsgs
|
decimal
|
Total number of "invalid Op Code" messages received
|
TxTotMsgs
|
decimal
|
Total number of messages transmitted to this host
|
TxNopMsgs
|
decimal
|
Total number of no-op messages transmitted to this host
|
PingRspMsgs
|
decimal
|
Total number of responses issued to "ping" commands
|
LoginRspMsgs
|
decimal
|
Total number of responses to login messages
|
TextRspMsgs
|
decimal
|
Total number of responses to text command messages
|
InvOpcodeMsgs
|
decimal
|
Total number of responses to "invalid Op Code" messages
|
RttMsgs
|
decimal
|
Total number of RTT messages sent to this host
|
ScsiRspMsgs
|
decimal
|
Total number of responses to all SCSI messages
|
TxScsiDataMsgs
|
decimal
|
Total number of SCSI data messages transmitted to this host
|
TxScsiDataBytes
|
decimal (64 bits)
|
Total amount of data transmitted to this host, in bytes
|
ScsiTaskMgtRspMsgs
|
decimal
|
Total number of responses to task management messages
|
AsyncEvtMsgs
|
decimal
|
Total number of unsolicited messages transmitted to this host
|
The following instance-wide roll-up fields are displayed:
Field Name
|
Data Format
|
Description
|
TotalRxMsgs
|
decimal
|
Total number of messages received for this instance
|
TotalTxMsgs
|
decimal
|
Total number of messages transmitted for this instance
|
TotalRxDataBtes
|
decimal (64 bits)
|
Total amount of data received for this instance, in bytes
|
TotalTxDataBytes
|
decimal (64 bits)
|
Total amount of data transmitted for this instance, in bytes
|
TotalAsyncMsgs
|
decimal
|
Total number of unsolicited messages transmitted for this instance
|
TotalScsiCmdMsgs
|
decimal
|
Total number of SCSI command messages received for this instance
|
TotalScsiCmdMsgsRej
|
decimal
|
Total number of SCSI command messages rejected for this instance
|
TotalInvalidMsgs
|
decimal
|
Total number of "invalid Op Code" messages received for this instance
|
•The show scsirouter all stats command is useful for determining quick operational status of all SCSI routing services running in the storage router.
•Use the show scsirouter all command to display configuration information for all SCSI routing services, including descriptions, targets and associated access lists.
Related Commands
Command
|
Description
|
add accesslist
|
Add IP addresses of servers allowed to access a common set of storage resources to the specified access list.
|
add scsirouter deviceif
|
Add an interface to the SCSI routing services instance and associate it with storage devices.
|
add scsirouter serverif
|
Assign an interface and IP address for use by a server using the named SCSI routing services instance.
|
add scsirouter target
|
Assign targets to the named SCSI routing services instance.
|
create accesslist
|
Create an access list entity.
|
delete scsirouter
|
Delete the named elements (or all elements) from the specified SCSI routing services instance.
|
restore accesslist from
|
Restore the named access list, or all access lists, from the named configuration file.
|
restore scsirouter from
|
Restore the named SCSI routing services instance, or all instances, from the named configuration file.
|
save accesslist
|
Save configuration data for the named access list or for all access lists.
|
save scsirouter
|
Save configuration data for the named instance or for all instances of SCSI routing services.
|
set scsirouter
|
Associate additional values and parameters (including access lists) with the named SCSI routing services instance.
|
setup scsi
|
Run the setup wizard to configure a SCSI routing services instance.
|
start scsirouter
|
Start the named SCSI routing services instance or all instances.
|
stop scsirouter
|
Stop the named SCSI routing services instance or instances.
|
show snmp
To display SNMP management configuration information for the storage router, use the show snmp command.
show snmp
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
Use the show snmp command to review the SNMP configuration setting before changing those setting with the set snmp command.
The command displays IP addresses or host names of primary and secondary destination hosts used for notifications (traps), the name of the SNMP community having read access to the SN 5420 network (get-community), and the name of the community having write access to the SN 5420 network (set-community).
Related Commands
Command
|
Description
|
set snmp
|
Set the name of the SNMP community having read and write access to the SN 5420 network, and supply the IP address of destination hosts used for SNMP traps.
|
setup mgmt
|
Run the setup wizard to configure SN 5420 management attributes
|
show software
To display a list of SN 5420 software versions available on the storage router, use the show software command.
show software [version vx.x-y]
Syntax Description
version vx.x-y
|
(Optional) Display information about the specified software version.
|
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
This command displays the size of each version of software and the date and time it was built. The list indicates the version of software currently running, and the version which will be booted when the system is reset. It also includes the URL from which new software is available for download, and the amount of NVRAM disk space currently available for new software.
Related Commands
show stack
To display usage of the stack on a per task basis, use the show stack command.
show stack
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
The show stack command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show system
To display a variety of system information about the storage router, including boot parameters and software versions, use the show system command. A table of information about SN 5420 network interfaces also displays.
show system
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator or Monitor.
Usage Guidelines
The show system command displays the following general system fields:
Field Name
|
Data Format
|
Description
|
System Name
|
string
|
The name of the storage router
|
System Model
|
string
|
The CPU type and revision, such as: MTX — MPC 604e
|
Disk Capacity
|
string
|
Total size of storage router disk
|
Free Disk Space
|
string
|
Total space available on storage router disk
|
Software Version
|
string
|
The version of software that is currently running. such as 1.0.11
|
Last Reset
|
date
|
The date and time the system was last reset. For example: Mon Feb 02 21:52:11 CST 2001
|
Current Time
|
date
|
Current date and time
|
Time Zone
|
string
|
Time zone to which this storage router is associated
|
NTP Server
|
IP address
|
IP address of NTP server with which this storage router is associated
|
Name Servers
|
IP address
|
IP address of primary and secondary DNS servers to which this storage router is associated
|
SysLogHost
|
IP address
|
If remote logging is enabled, the IP address of the host to which the SN 5420 event messages are sent.
|
Facility
|
string
|
If remote logging is enabled, the facility on the host used to manage the SN 5420 event messages.
|
Model Number
|
string
|
Model number for the storage router, processor, Fibre Channel and Gigabit Ethernet interfaces
|
Rev
|
decimal
|
Revision number associated with the storage router, processor, Fibre Channel and Gigabit Ethernet interfaces
|
Serial Number
|
string
|
Serial number associated with the storage router, process, Fibre Channel and Gigabit Ethernet interfaces
|
The following interface fields also display:
Field Name
|
Data Format
|
Description
|
Device
|
string
|
The name of the storage router interface
|
IP/Netmask
|
IP address
|
The IP address and network mask associated with this interface
|
MAC Address
|
hex string
|
The machine address associated with this interface
|
Related Commands
show task
To display information about tasks running in the storage router, issue the show task command.
show task {task-id]
Syntax Description
task-id
|
(Optional) The TID for a specific task, obtained from the show task display.
|
Defaults
None.
Command Modes
Administrator and Monitor.
Usage Guidelines
The show task command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
show tech-support
To display the results of several CLI show commands useful for debugging purposes, use the show tech-support command.
show tech-support
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Use this command to display the output of the following commands:
•show net stat udp
•show net stat ip
•show net stat icmp
•show snmp
•show devices
•show accesslist all
•show scsirouter all
•show config
•show ha stat node
•show ha stat app list
•show ha stat app number all
•show diagnostics
•show boot
•show memory
•show task
•show stack
•show modules
•show buffers
•show nfs
The show tech-support command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
Start Commands
The start commands cause SCSI routing services to start running on the storage router. Use the start commands to restart a previously stopped SCSI routing services instance, or an instance that has been restored from a saved configuration file.
Using the start commands you can perform the following actions (Table 7-13):
Table 7-13 Start Command Actions
Action
|
Commands
|
Start the named SCSI routing services instance or all instances.
|
start scsirouter
|
Force the named SCSI routing services instance, or all instances, to start running on the storage router.
|
start scsirouter force
|
start scsirouter
To start the named SCSI routing services instance (or all instances) on this storage router, use the start scsirouter command.
start scsirouter {instancename | all}
Syntax Description
instancename
|
The name of the SCSI routing services instance to be started.
|
all
|
Start all instances on this storage router.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Instances of SCSI routing services that are in a stopped state are not running anywhere in the cluster. To restart a stopped SCSI routing services instance, use the start scsirouter command. Use the all keyword to start all instances on the storage router. All instances previously stopped on this storage router, or available instances not running elsewhere in the cluster, will start on this SN 5420.
Use the start scsirouter command to bring a restored SCSI routing services instance into the running configuration. A restored instance must be started before you can make any additional configuration changes to that instance.
Under normal circumstances, the SCSI routing services instance can only be started from the storage router on which it was stopped, or that is the current primary for that instance.
Related Commands
Command
|
Description
|
failover all
|
Cause all SCSI routing services instances to cease running on the storage router.
|
failover scsirouter
|
Cause the named SCSI routing services instance to cease running on the storage router.
|
set scsirouter primary
|
Designate the indicated SN 5420 as the preferred storage router to run the named SCSI routing services instance.
|
start scsirouter force
|
Force the named SCSI routing services instance or all instances to start running on this storage router.
|
stop scsirouter
|
Stop the named SCSI routing services instance or all instances.
|
start scsirouter force
To force the start the named SCSI routing services instance (or all instances) on this storage router, use the start scsirouter force command.
start scsirouter {instancename | all} force
Syntax Description
instancename
|
The name of the SCSI routing services instance to be started.
|
all
|
Start all instances on this storage router.
|
force
|
Keyword that overrides normal protections, allowing the action to be performed from a storage router that is not currently running the named instance.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Under normal circumstances, the SCSI routing services instance can only be started from the storage router on which it was stopped, or that is the current primary for that instance. The force option overrides the normal protections that prevent the starting of an instance from a storage router that is not the current primary for that instance.
The force option should only be used when the storage router, or a specific SCSI routing services instance, is in an abnormal state and cannot be recovered without rebooting.
Related Commands
Command
|
Description
|
failover all
|
Cause all SCSI routing services instances to cease running on the storage router.
|
failover scsirouter
|
Cause the named SCSI routing services instance to cease running on the storage router.
|
set scsirouter primary
|
Designate the storage router as the preferred storage router to run the named SCSI routing services instance.
|
start scsirouter
|
Start the named SCSI routing services instance or all instances.
|
stop scsirouter
|
Stop the named SCSI routing services instance or all instances.
|
Stop Commands
The stop commands cause SCSI routing services to cease running on the storage router, but do not cause a failover to another system in the cluster. Any in-memory image of the specified SCSI routing services is erased, but permanent configuration is retained.
Use the stop commands to stop the named SCSI routing services from running anywhere in the cluster.
Using the stop commands you can perform the following actions (Table 7-14).
Table 7-14 Stop Command Actions
Action
|
Commands
|
Stop the named SCSI routing services instance or all instances.
|
stop scsirouter
|
Force the named SCSI routing services instance, or all instances, to stop running anywhere in the cluster.
|
stop scsirouter force
|
stop scsirouter
To cause the named SCSI routing services instance (or all instances) to cease running on this storage router, use the stop scsirouter command.
stop scsirouter {instancename | all}
Syntax Description
instancename
|
The name of the SCSI routing services instance to be stopped. This instance must currently be running on the storage router.
|
all
|
Keyword that stops all SCSI routing services currently running on this storage router.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Because stop commands do not cause HA events and failovers, the stop scsirouter command prevents the effected SCSI routing services from running anywhere in the cluster. Use the all keyword to stop all instances currently running on this storage router from running anywhere in the cluster.
In a cluster environment, a storage router that is currently running a SCSI routing services instance is known as the current primary for that instance. Issue the appropriate show commands from this storage router to display complete configuration information and operational statistics for the active SCSI routing services instance.
Under normal circumstances, the SCSI routing services instance can only be stopped from the storage router that is the current primary for that instance.
Related Commands
Command
|
Description
|
failover scsirouter
|
Cause the named SCSI routing services instance to cease running on the storage router.
|
start scsirouter
|
Start the named SCSI routing services instance or all instances.
|
stop scsirouter force
|
Force the named SCSI routing services instance or all instances to stop running.
|
stop scsirouter force
To force the named SCSI routing services instance (or all instances) to cease running on this SN 5420, use the stop scsirouter command.
stop scsirouter {instancename | all} force
Syntax Description
instancename
|
The name of the SCSI routing services instance to be stopped. This instance must currently be running on the SN 5420.
|
all
|
Keyword that stops all SCSI routing services currently running on this storage router.
|
force
|
Keyword that overrides normal protections, allowing the action to be performed from a storage router that is not currently running the named instance.
|
Defaults
None.
Command Modes
Administrator.
Usage Guidelines
Under normal circumstances, the SCSI routing services instance can only be stopped from the storage router that is the current primary for that instance. The force option overrides the normal protections that prevent the stopping of an instance from a storage router that is not currently running the instance.
The force option should only be used when the storage router, or a specific SCSI routing services instance, is in an abnormal state and cannot be recovered without rebooting.
Related Commands
Command
|
Description
|
failover scsirouter
|
Cause the named SCSI routing services instance to cease running on the storage router.
|
start scsirouter
|
Start the named SCSI routing services instance or all instances.
|
stop scsirouter
|
Stop the named SCSI routing services instance or all instances.
|
Feedback
