-
Cisco SN 5400 Series Storage Router Command Reference, Release 3.4
-
About This Guide
-
Chapter 1 - CLI Overview
-
Chapter 2 - A Commands
-
Chapter 3 - C Commands
-
Chapter 4 - D Commands
-
Chapter 5 - E Commands
-
Chapter 6 - F Commands
-
Chapter 7 - H Commands
-
Chapter 8 - I Commands
-
Chapter 9 - L Commands
-
Chapter 10 - M Commands
-
Chapter 11 - N Commands
-
Chapter 12 - P Commands
-
Chapter 13 - R Commands
-
Chapter 14 - S Commands
-
Chapter 15 - Show Commands
-
Chapter 16 - T Commands
-
Chapter 17 - U Commands
-
Chapter 18 - V Commands
-
Chapter 19 - Z Commands
-
Table Of Contents
C Commands
This chapter covers the following commands:
•
copy
cdp enable
To enable Cisco Discovery Protocol (CDP) on the storage router, use the cdp enable command. To disable CDP on the storage router, use the no form of this command.
cdp enable
no cdp enable
Syntax Description
This command has no arguments or keywords.
Defaults
CDP is enabled.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
CDP is enabled by default in order to send or receive CDP information. CDP can be switched on or off for each specific interface via the cdp interface command.
Examples
The following example enables CDP on the storage router:
[SN5428-2A]# cdp enableRelated Commands
cdp holdtime
To specify the amount of time the receiving device should hold a CDP packet from the storage router before discarding it, use the cdp holdtime command. To revert to the default setting, use the no form of this command.
cdp holdtime nn
no cdp holdtime
Syntax Description
Defaults
The default holdtime is 180 seconds.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
The CDP holdtime must be set to a higher number of seconds than the time between CDP transmissions, which is set using the cdp timer command.
Examples
The following example sets the CDP holdtime to 60, meaning that the CDP packet being sent from the storage router should be held by the receiving device for 60 seconds before being discarded. You may want to set the holdtime lower than the default setting of 180 seconds if information about the storage router changes frequently.
[SN5428-2A]# cdp holdtime 60Related Commands
cdp interface
To enable CDP for a specific interface, use the cdp interface command. To disable CDP for a specific interface, use the no form of this command.
cdp interface if-name enable
no cdp interface if-name enable
Syntax Description
Defaults
CDP is enabled for all interfaces.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
CDP must be enabled for the storage router (using the cdp enable command or the equivalent GUI functionality) before it can be enabled for a specific interface.
Examples
The following example enables CDP for the Gigabit Ethernet interface, ge2:
[SN5428-2A]# cdp interface ge2 enableThe following example disables CDP for the management interface:
[SN5428-2A]# no cdp interface mgmt enableRelated Commands
cdp timer
To specify the amount of time between transmissions of CDP packets from the storage router, use the cdp timer command. To revert to the default setting, use the no form of this command.
cdp timer nn
no cdp timer
Syntax Description
Defaults
The default is 60 seconds.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
The time between CDP transmissions must be set to a lower number than the CDP holdtime, which is set using the cdp holdtime command. There is a trade-off between sending more frequent CDP updates and bandwidth utilization.
Examples
The following example sets the CDP timer to 90, meaning that CDP updates are sent every 90 seconds, which is less frequently than the default of 60 seconds. You may want to make this change if you are concerned about preserving bandwidth.
[SN5428-2A]# cdp timer 90Related Commands
clear conf
To return certain configuration settings to factory defaults, use the clear conf wizard. The clear conf wizard prompts you to enter the Administrator mode password and then to indicate which settings to restore to factory defaults.
clear conf
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
The clear conf wizard is only available when the storage router is deployed for SCSI routing. If the storage router is deployed for transparent SCSI routing, use the clear conf {all | system} command to return the storage router configuration to factory default settings.
Follow these guidelines when using the clear conf wizard:
•
•
•
•
The system will reboot if you select apps, system, or all.
System configuration settings include:
•
•
•
•
•
•
•
•
•
Deleting system configuration makes the storage router unavailable to Telnet, SSH or web-based GUI sessions until the management interface is reconfigured with an IP address via a console connection. Refer to the appropriate Cisco Storage Router Software Configuration Guide for your storage router model for more information about initial system configuration.
Note
Examples
The following example removes all SCSI routing instances from the storage router. The system configuration settings are retained.
[SN5428-2_A1]# clear confEnter admin password: *****This process can restore factory default settings for the SN5428-2.* Select "apps" to remove active applications and retain systemconfiguration settings.* Select "system" to remove active applications and systemconfiguration settings.* Select "saved" to remove all backup configurations from disk.* Select "all" to remove active applications, system configuration,and saved configurations.The system configuration includes the management port, dns, admin andmonitor login, ntp, and snmp. You will need to use the consoleto reconfigure the management port if you erase the system configuration.The system will reboot if you select "apps", "system", or "all".Erase what? [apps/system/saved/all/cancel (cancel)]appsConfiguration cleared. System configuration settings retained.System halting.............!System has been haltedRelated Commands
clear conf {all | system}
To return certain configuration settings to factory defaults, use the clear conf {all | system} command.
clear conf {all | system} password
Syntax Description
Defaults
None.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
System configuration settings include:
•
•
•
•
•
•
•
•
•
Issuing the clear conf command with either the system or all keyword causes the storage router to reboot.
Deleting system configuration makes the storage router unavailable to Telnet or web-based GUI sessions until the management interface is reconfigured with an IP address via a console connection. Refer to the appropriate Cisco Storage Router Software Configuration Guide for your storage router model for more information about initial system configuration.
Note
Examples
The following example removes all storage router configuration information, returning the storage router to its initial default configuration. The example uses the default Administrator mode password, cisco.
[SN5428-2_A1]# clear conf all ciscoClearing configuration...Current configuration and named configurations cleared.System halting.........Related Commands
clear counters fcip
To clear all counters associated with the specified FCIP instance, or all instances, use the clear counters fcip command.
clear counters fcip {name | all}
Syntax Description
name
The name of the FCIP instance for which counters will be cleared.
all
Clear counters for all FCIP instances.
Defaults
None.
Command Modes
Administrator.
Command History
Usage Guidelines
This command resets the specified operational statistics. It does not display the accumulated statistics before resetting the counters.
Clear counters before beginning a troubleshooting session, so you can quickly identify the counters that are changing.
Examples
The following example clears the operational counters for the FCIP instance named fcip1:
[SN5428-2A]# clear counters fcip fcip1The following example clears the operational counters for all FCIP instances:
[SN5428-2A]# clear counters fcip allRelated Commands
Create an FCIP instance.
Display configuration and operational information for the named FCIP instance.
clear counters interface
To clear all counters associated with the specified interface, or all interfaces, use the clear counters interface command.
clear counters interface {if-name | all}
Syntax Description
Defaults
None.
Command Modes
Administrator or Monitor.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
This command resets all accumulated operational statistics for the specified interface. Operational statistics can include counters for packets received and transmitted, collisions, octets, multicast packets, dropped and unsupported protocol, exception status IOCBs (such as LIP reset aborts, port unavailable or logged out, DMA errors, port configuration changed, command timeout, data overrun, write or read data underrun, and queue full), Fibre Channel errors, and other general events.
Clear counters before beginning a troubleshooting session, so you can quickly identify the counters that are changing.
Examples
The following example clears all accumulated operational statistics counters for the Fibre Channel interface fc1.
[SN5428-2A]# clear counters interface fc1Related Commands
Display operational and configuration information for the specified interface or all interfaces.
clear counters scsirouter
To reset accumulated operational statistics for the specified SCSI routing instance, use the clear counters scsirouter command.
clear counters scsirouter {name | all} {connection | host | target {name | all}}
Syntax Description
Defaults
None.
Command Modes
Administrator or Monitor.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
This command resets the specified operational statistics. It does not display the accumulated statistics before resetting the counters.
Clear counters before beginning a troubleshooting session, so you can quickly identify the counters that are changing.
Examples
The following example clears the connection counters for the SCSI routing instance myScsi1.
[SN5428-2A]# clear counters scsirouter myScsi1 connectionRelated Commands
Display configuration and operational information for the named SCSI routing instance.
clear fcswitch
To clear the switch log files of all entries or to clear stored zoning configuration information, issue the clear fcswitch command.
clear fcswitch {devlog | syslog}
clear fcswitch| zones {fabric | local}
Syntax Description
Defaults
None.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
Clear the switch development or system log file if it is large, or if you are going to perform testing and want to be sure the switch log files only reflects information from the testing session.
Clear local zoning configuration if you are moving the storage router from one FC switched zoned fabric to another or removing a switch from the fabric, or when other network changes have been made that render the saved zoning information inaccurate. All ports operating as E_Ports must be inactive. If the clear fcswitch zones local command is issued when there is an active E_Port on the storage router, the command fails and issues a warning message indicating the FC interfaces that are currently enabled.
Use the fabric keyword to clear the local zoning database and deactivate the active zoneset for the entire fabric.
Examples
The following example clears the switch development log files:
[SN5428-2A]# clear fcswitch devlogThe following example clears the switch system log files:
[SN5428-2A]# clear fcswitch syslogThe following example clears all saved zoning information from the storage router local zoning database:
[SN5428-2A]# clear fcswitch zones localThe following example clears the local zoning database and deactivates the active zone set for the entire fabric:
[SN5428-2A]# clear fcswitch zones fabricRelated Commands
clear log
To clear the storage router log file of all entries, issue the clear log command.
clear log
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
Clear the storage router log file if it is large, or if you are going to perform testing and want to be sure the log file only reflects information from the testing session.
Examples
The following example clears all entries from the storage router log file:
[SN5428-2A]# clear logRelated Commands
clear logging table
To clear the storage router logging table of all entries, or to reset the table to factory defaults, issue the clear logging table command.
clear logging table [to factory_defaults]
Syntax Description
to factory_defaults
Return the storage router logging table to the factory default logging rule entries.
Defaults
None.
Command Modes
Administrator.
Command History
2.3.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
Use this command to remove all rules for routing storage router event messages. If the logging table is cleared, logging is still enabled but all messages will be discarded.
To return the logging table to the factory default logging rules, use the to factory_defaults keywords. The factory default logging rules are as follows:
•
•
Examples
The following example clears all entries from the storage router logging table and returns the table to the default logging rules:
[SN5428-2A]# clear logging table to factory_defaultsRelated Commands
clear scsirouter failover
To clear the primary or secondary storage router from the HA failover list for the specified SCSI routing instance, use the clear scsirouter command.
clear scsirouter name failover {primary | secondary}
Syntax Description
name
The name of the SCSI routing instance.
primary
Delete the current primary storage router from the HA failover list.
secondary
Delete the secondary storage router from the HA failover list.
Defaults
None.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
Use the clear scsirouter failover command to reset the primary or secondary storage router on the HA failover list for the specified SCSI routing instance. If there is no primary or secondary storage router configured on the HA failover list when the SCSI routing instance fails over, the cluster attempts to run the instance on the first node that is available based on HA failover eligibility information.
Use the scsirouter failover command to add a storage router to the HA failover list.
Note
Examples
The following example removes the current primary storage router from the HA failover list for SCSI routing instance foo:
[SN5428-2A]# clear scsirouter foo failover primaryRelated Commands
Cause the named SCSI routing instance to cease running on the storage router.
Add the storage router to the HA failover list for the specified SCSI routing instance.
clear scsirouter primary
To remove the storage router configured as the primary for the named SCSI routing instance, use the clear scsirouter primary command.
clear scsirouter name primary
Syntax Description
Defaults
None.
Command Modes
Administrator.
Command History
3.2.1
This command was introduced. For the SN 5428, this command replaces the scsirouter primary command with the none keyword.
Usage Guidelines
At any given time, a SCSI routing instance can run on only one storage router in a cluster. If a SCSI routing instance has the primary attribute set, the specified storage router will take over running that instance upon system restart or whenever target and critical resources are available.
If the primary attribute is not set, the SCSI routing instance continues running on the node where it was started until it is explicitly stopped (via a no scsirouter enable command), it automatically fails over to another storage router in the cluster because targets or critical resources are unavailable, or an explicit failover scsirouter command is issued. This is the default behavior.
Examples
The following command removes the storage router configured as the primary for the SCSI routing instance named lab2:
[SN5428-2A]# clear scsirouter lab2 primaryRelated Commands
clear static
To clear the mapping of the IP host to Fibre Channel (FC) address for the specified World Wide Port Name (WWPN), use the clear static command. This command is only available when the storage router is deployed for static transparent SCSI routing.
clear static iscsibindings {all | xxxxxxxxxxxxxxxx}
Syntax Description
Defaults
None.
Command Modes
Administrator.
Command History
Usage Guidelines
When the storage router is deployed for static transparent SCSI routing, the IP host to FC address mappings are saved and retained in the storage router when it is restarted. If an IP host will no longer be accessing storage, or if you want the storage router to create a new mapping when the IP host logs in again, you can clear an existing mapping. Mappings can only be cleared if they are not currently in use.
To display the mappings that are currently configured in the storage router, use the show static iscsibindings command.
Examples
The following example displays the currently configured mappings, and then deletes the mapping for the IP host at IP address 10.1.20.2 (WWPN 280100065338d6c0):
[SN5428-2A]# show static iscsibindingsInterface WWPN Host IP Address Host Name--------- ---------------- ---------------- -------------------------------fci1 280100065338d6c0 10.1.20.2 iscsi.cisco.testlabfci1 280200065338d6c0 10.1.4.213 iqn.1987-05.com.cisco.02.0AB08....B6E5CCE.WIN1fci2 290100065338d6c0 10.1.30.100 iqn.1987-05.com.cisco.02.9FD389....36D3D3.NT10[SN5428-2A]# clear static iscsibindings 280100065338d6c0Binding cleared for WWPN 280100065338d6c0The following example clears all IP host to FC mappings saved in the storage router. If a mapping is in use by an IP host, the mapping will not be cleared.
[SN5428-2A]# clear static iscsibindings allRelated Commands
clock set
To set the storage router system clock to the given date and time, use the clock set command. Date and time information is used for log files and the user interface.
clock set 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 06 22 2001.
Defaults
None.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
If the storage router should synchronize its date and time with a network time protocol (NTP) server, see the ntp peer command.
After a time change, a system reboot is required to synchronize the system timestamp with the timestamps on the integrated FC switch log files, syslog and devlog.
Examples
The following example sets the storage router date and time to June 22, 2001 at 14:39:00.
[SN5428-2A]# clock set 14:39:00 06 22 2001Related Commands
clock timezone
To specify the time zone for the storage router, use the clock timezone command.
clock timezone {string | ?}
Syntax Description
Defaults
None.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
Unless you specify the time zone, the clock setting is assumed to be in Universal time, also known as Greenwich Mean 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.
To use the clock timezone command, you must know the appropriate time zone string. Use the "?" to display a list of valid time zone strings.
After a time change, a system reboot is required to synchronize the system timestamp with the timestamps on the integrated FC switch log files, syslog and devlog.
Examples
The following example sets the storage router time zone to US/Mountain:
[SN5428-2A]# clock timezone US/MountainRelated Commands
copy
To copy the named configuration file or script file from the specified location to the savedconfig or script directory, or from the storage router to the specified location, use the copy command. The exchange is via HTTP or TFTP. When copying files to the storage router, any file of the same name in the savedconfig or script directory is overwritten.
copy http://FileUrl {savedconfig:configfilename | script:scriptfilename}
copy tftp://Location/Directory/Filename {savedconfig:configfilename | script:scriptfilename}
copy {savedconfig:configfilename | script:scriptfilename} tftp://Location/Directory/Filename
Syntax Description
Defaults
None.
Command Modes
Administrator.
Command History
2.2.1
This command was introduced for the SN 5428.
3.2.1
This command was introduced for the SN 5428-2.
Usage Guidelines
The copy command does not affect the running or persistent configuration of the storage router or high availability cluster. However, the restore command can be used to copy the contents of a saved configuration file into persistent memory, while the read script command can be used to execute the commands in a script file to modify a storage router configuration.
Because TFTP does not require a user name and password, directories and files cannot be created. When you copy a file to a TFTP server, you must have read/write permissions for the complete file path, and the file copied from the storage router must already exist.
Examples
The following example copies the saved configuration file myFoo.xml from a server with an IP address of 10.1.40.10 to the storage router. The file name is changed to myFoo_restore.xml when it is written to the storage router savedconfig directory.
[SN5428-2A]# copy http://10.1.40.10/usr/SN5428-2/savedconfig/myFoo.xml savedconfig:myFoo_restore.xmlThe following example copies the script file SN5428-2_Lab from a server named acme. The file name is unchanged when it is written to the storage router script directory.
[SN5428-2A]# copy http://acme/~myhome/SN5428-2_Lab script:SN5428-2_LabThe following example copies the saved configuration file, backup_23, to the daily_backup file in the tftpboot directory of the tftp_primary server. The file, daily_backup, must already exist in the tftpboot directory of the tftp_primary server. This command will overwrite the existing daily_backup file.
Note
[SN5428-2A]# copy savedconfig:backup_23 tftp://tftp_primary/daily_backupRelated Commands
