You'll be entered into a quarterly drawing for free Cisco Press books by returning this survey! Cisco is dedicated to customer satisfaction and would like to hear your thoughts on these printed manuals. Please visit the Cisco Product Comments on-line survey at www.cisco.com/go/crc to submit your comments about accessing Cisco technical manuals.
FIRST-CLASS MAIL PERMIT NO.
Cisco SN 5428-2 Storage Router Software Configuration Guide Release 3.3 Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
C O N T E N T S About This Guide Objectives Audience ix ix ix Organization x Command Syntax Conventions Related Documentation xi xii Obtaining Documentation xii Cisco.com xii Documentation CD-ROM xii Ordering Documentation xiii Documentation Feedback xiii Obtaining Technical Assistance xiii Cisco.
Contents Zoning Overview 1-19 Fibre Channel Interface Overview 1-21 Gigabit Ethernet Interface Overview Authentication Overview 1-21 1-22 SN 5428-2 Cluster Management Overview Interface Naming Where to Go Next CHAPTER 2 1-23 1-24 First-Time Configuration Prerequisite Tasks 1-22 2-1 2-1 Collecting Configuration Information Connecting a Console 2-2 2-6 Initial System Configuration Script 2-7 Running the Setup Configuration Wizard 2-8 Introducing the CLI 2-10 Character Case Sensitivity i
Contents Configuring Administrator Contact Information Configuring the High-Availability Interface 3-9 Configuring for Secure Shell (SSH) Access 3-9 Verifying and Saving Configuration CHAPTER 4 Configuring for VLAN Prerequisite Tasks 3-10 4-1 4-1 VLAN Encapsulation 4-1 Configuration Tasks 4-2 Configuring for VLAN with VTP 4-4 Configuring for VLAN without VTP Configuring an IP Route 4-4 4-5 Verifying and Saving Configuration 4-5 Assigning a VLAN to a SCSI Routing Instance CHAPTER 5 C
Contents CHAPTER 7 Configuring Transparent SCSI Routing Prerequisite Tasks 7-1 Summary of Configuration Process Verifying Configuration CHAPTER 8 Configuring FCIP 7-1 7-1 7-3 8-1 Prerequisite Tasks 8-1 Configuration Tasks 8-2 Setting the Domain ID 8-2 Creating an FCIP Instance Assigning an IP Address 8-3 8-3 Assigning a Protocol, Peer Name, and Peer IP Address Assigning Protocol: tcpserver 8-4 Assigning Protocol: tcpclient 8-4 Assigning Protocol: raw 8-5 CHAPTER 9 Configuring Operati
Contents CHAPTER 10 Configuring a High Availability Cluster 10-1 Prerequisite Tasks 10-1 Guidelines for Configuring SCSI Routing Instances 10-2 Creating a Cluster 10-2 Adding an Unconfigured SN 5428-2 Storage Router 10-4 Adding a Minimally Configured SN 5428-2 Storage Router Joining Stand-alone Storage Routers in a Cluster Changing Clusters CHAPTER 11 10-5 10-6 10-7 Maintaining and Managing the SN 5428-2 Storage Router Prerequisite Tasks 11-1 11-2 Installing Updated Software 11-2 Specifying
Contents Using the Crash Log 11-33 Using FTP with the SN 5428-2 Storage Router 11-35 Understanding Diagnostics 11-36 Capturing System Messages at Bootup 11-36 Capturing the Storage Router Configuration 11-37 Using Debug Facilities 11-37 CHAPTER 12 Command Line Interface Reference About CLI Commands CLI Usage Tips 12-1 CLI Commands 12-2 12-1 12-1 INDEX Cisco SN 5428-2 Storage Router Software Configuration Guide viii 78-15471-01
About This Guide This preface describes the objectives, audience, organization and command syntax conventions of the Cisco SN 5428-2 Storage Router Software Configuration Guide. It also provides information on how to obtain related documentation and technical assistance. Note The model number of the SN 5428-2 Storage Router may appear on your terminal as 5428-2-K9 during console sessions with the storage router and in command line interface (CLI) output.
About This Guide Organization Organization This guide contains the following chapters (Table 1): Table 1 Document Organization Chapter Title Description Chapter 1 Before Configuring SN 5428-2 Storage Router Software Describes what you should understand prior to configuring storage router software. Chapter 2 First-Time Configuration Describes what configuration information to gather and explains the initial system configuration script and setup configuration wizard.
About This Guide Command Syntax Conventions Command Syntax Conventions Table 2 describes the syntax used with the commands in this document. Table 2 Syntax Conventions Convention Description boldface font Indicates commands and keywords that you enter literally as shown. italic font Indicates arguments for which you supply values. [x] Square brackets indicate an optional element (keyword or argument). {x} Braces indicate a required element (keyword or argument).
About This Guide Related Documentation Note Caution Timesaver Means reader take note. Notes contain helpful suggestions or references to additional information and material. Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data. Means the described action saves time. You can save time by performing the action described in the paragraph.
About This Guide Obtaining Technical Assistance All users can order monthly or quarterly subscriptions through the online Subscription Store: http://www.cisco.com/go/subscription Ordering Documentation You can find instructions for ordering documentation at this URL: http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm You can order Cisco documentation in these ways: • Registered Cisco.
About This Guide Obtaining Technical Assistance • Resolve technical issues with online support • Download and test software packages • Order Cisco learning materials and merchandise • Register for online skill assessment, training, and certification programs To obtain customized information and service, you can self-register on Cisco.com at this URL: http://tools.cisco.com/RPF/register/register.
About This Guide Obtaining Additional Publications and Information Cisco TAC Escalation Center The Cisco TAC Escalation Center addresses priority level 1 or priority level 2 issues. These classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer automatically opens a case.
About This Guide Obtaining Additional Publications and Information Cisco SN 5428-2 Storage Router Software Configuration Guide xvi 78-15471-01
C H A P T E R 1 Before Configuring SN 5428-2 Storage Router Software The Cisco SN 5428-2 Storage Router installation and configuration tasks consist of the following: • Install the SN 5428-2 Storage Router according to the Cisco SN 5428-2 Storage Router Hardware Installation Guide. • Select how the SN 5428-2 will be deployed: SCSI routing, transparent SCSI routing, or FCIP.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software SN 5428-2 Storage Router Software Overview SN 5428-2 Storage Router Software Overview The Cisco SN 5428-2 Storage Router provides universal access to storage over IP networks. The storage router software controls the operation of the Cisco SN 5428-2 Storage Router. You can configure the software to provide the following types of access to storage over IP networks: SCSI routing, transparent SCSI routing, or FCIP.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software SN 5428-2 Storage Router Software Overview Fibre Channel over IP (FCIP) enables SN 5428-2 Storage Routers to provide connectivity by tunneling through an IP network between storage area networks (SANs). (See Figure 1-3.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software SCSI Routing Overview Note The web-based GUI is not available in SN 5428-2s deployed for transparent SCSI routing. SCSI Routing Overview SCSI routing provides IP hosts with access to FC storage devices as if the storage devices were directly attached to the hosts, with access to devices being managed primarily in the SN 5428-2 Storage Router. An iSCSI target is an arbitrary name for a group of physical storage devices.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software SCSI Routing Overview Using iSCSI Protocol to Route SCSI Requests and Responses SCSI routing consists of routing SCSI requests and responses between hosts in an IP network and FC storage. (See Figure 1-5.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software SCSI Routing Overview Basic Network Structure Figure 1-7 shows the basic structure of a SCSI routing network. IP hosts with iSCSI drivers access the storage routers through an IP network connected to the Gigabit Ethernet interface of each storage router. The storage routers access storage devices connected to the Fibre Channel interfaces of each storage router.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software SCSI Routing Overview If the LUN is available, it is made available as an iSCSI LUN and numbered with the iSCSI LUN number specified. For example, if an iSCSI target and iSCSI LUN specified as Database, LUN 9 were mapped to the physical storage address, WWPN 3100112233445566, LUN 12, then LUN 12 would be available as one iSCSI LUN. An iSCSI driver would see the iSCSI target named Database, with one iSCSI LUN identified as LUN 9.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software SCSI Routing Overview Access for SCSI routing is controlled in the IP hosts and the storage router. In an IP host, the iSCSI driver is configured with the Gigabit Ethernet IP address of the SCSI routing instance in the storage router with which the host is to transport SCSI requests and responses. In a storage router, access is controlled through an access list and a VLAN identifier (VID) number of the hosts.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software SCSI Routing Overview Figure 1-8 SCSI Routing Storage Mapping and Access Control Concept Storage Cisco SN 5428-2 with IP addresses accessible by 10.1.2.3 and 10.1.2.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Transparent SCSI Routing Overview Transparent SCSI Routing Overview Transparent SCSI routing provides IP hosts with access to intelligent storage arrays as if each storage array were directly attached to the hosts, with access to the storage devices managed primarily in each storage array. The SN 5428-2 transparently presents each IP host to the storage array as if each host were an FC host.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Transparent SCSI Routing Overview Using iSCSI Protocol to Route SCSI Requests and Responses Transparent SCSI routing consists of routing SCSI requests and responses between hosts in an IP network and an intelligent storage array that is directly connected to an SN 5428-2 Fibre Channel interface. (See Figure 1-10.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Transparent SCSI Routing Overview Basic Network Structure Figure 1-12 shows the basic structure of a transparent SCSI routing network. IP hosts with iSCSI drivers access the storage routers through an IP network connected to one of the Gigabit Ethernet interfaces of each storage router. The storage routers access the intelligent storage array through a Fibre Channel interface of each storage router.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Transparent SCSI Routing Overview For example, if an iSCSI target were created for WWPN 3100112233445566 in a storage array, and that WWPN contained LUNs 0 through 2, those LUNs would become available to an IP host as LUNs 0 through 2. An iSCSI driver would see the iSCSI target named eui.3100112233445566 as a controller with three iSCSI LUNs identified as LUN 0, LUN 1, and LUN 2.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Transparent SCSI Routing Overview to it, with each host having a WWPN. Table 1-5 shows the correlation between the IP hosts, the Gigabit Ethernet IP address of the SCSI routing instance, storage device mapping, and IP-host-to-FC-address (WWPN) mapping. Note The purpose of Figure 1-13 and Table 1-5 is only to illustrate the concept of storage mapping, FC address mapping, and access control.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software FCIP Overview Available Instances of Transparent SCSI Routing When an SN 5428-2 Storage Router is deployed for transparent SCSI routing, it is automatically configured for one instance of transparent SCSI routing service; only that one instance can exist in that SN 5428-2.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software FCIP Overview Once configured, FCIP instances on each storage router become active and establish their connectivity via the IP network. The storage devices in one SAN access the storage devices in the connected SAN using FC frames, which are encapsulated in IP packets by the FCIP instance running in the SN 5428-2, and transmitted to the peer SN 5428-2.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software FCIP Overview Figure 1-16 shows a slightly more complex FCIP network: a redundant WAN FCIP configuration. In this configuration, an FC host or FC device connects to one or more Fibre Channel interfaces of each peer SN 5428-2 Storage Router deployed for FCIP, and each SN 5428-2 connects to two separate IP networks through each of its Gigabit Ethernet interfaces.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software VLAN Access Overview Figure 1-18 Multisite FCIP Configuration SN 5428-2 SAN 1 FC hosts and storage devices SN 5428-2 FC hosts and storage devices IP SAN 3 91357 SN 5428-2 SAN 2 VLAN Access Overview SN 5428-2 VLAN access provides IP hosts with access to storage devices according to the VLAN to which each host belongs. Figure 1-19 shows a sample network that employs SN 5428-2 VLAN access.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Zoning Overview If the SN 5428-2 is used in a Cisco switched network environment, configure the SN 5428-2 to use the Cisco proprietary VLAN Trunking Protocol (VTP). With VTP, the SN 5428-2 will exchange VTP packets with an externally attached switch to dynamically learn about the VLANs that are accessible in the IP network. The SN 5428-2 then uses VTP to propagate VLAN information around the switched network using layer 2 multicast packets.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Zoning Overview Figure 1-20 FC Fabric Zoning Overview Zone Y Zone Z Host A Host B IP Host A FC switch IP Host B IP Cisco SN 5428-2 FC storage 85733 FC storage Zoning comprises zones, zone sets, aliases, and zone databases. A zone is a named group of devices that can communicate with each other. Membership in a zone is defined by the device WWPN. Zone members can communicate only with members of the same zone.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Fibre Channel Interface Overview See Chapter 5, “Configuring Fibre Channel Interfaces,” for more information about configuring the SN 5428-2 for FC fabric zoning. Fibre Channel Interface Overview The SN 5428-2 has an integrated switch component with Fibre Channel interfaces that support the following port types: E_Port, F_Port, FL_Port, G_Port, GL_Port, TL_Port, and donor port.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Authentication Overview maintenance interface is lost and if the secondary maintenance interface connection is assigned and connected, the IP address moves to the secondary Gigabit Ethernet interface, which then allows management access. Authentication Overview Authentication is a software service that is available in each SN 5428-2.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Interface Naming • Connected to each other through their management and high availability (HA) interfaces In a cluster, storage routers continually exchange HA information to propagate configuration data to each other and to detect failures in the cluster.
Chapter 1 Before Configuring SN 5428-2 Storage Router Software Where to Go Next 85739 Figure 1-22 SN 5428-2 Chassis-Slot Numbering ge1 ge2 fc1 fc2 fc3 fc4 fc5 fc6 fc7 fc8 Where to Go Next When you are ready to configure the SN 5428-2 software, proceed to one of the following chapters in this configuration guide according to your needs: Note • Chapter 2, “First-Time Configuration”—For initial setup or after configuration has been reset to factory default configuration • Chapter 3, “Config
C H A P T E R 2 First-Time Configuration This chapter describes what configuration information to gather and explains the initial system configuration script and setup configuration wizard for the first-time configuration of the Cisco SN 5428-2 Storage Router. This chapter also introduces the command line interface (CLI) and web-based GUI, which can be used for subsequent configuration tasks. Note The web-based GUI is not available in SN 5428-2s deployed for transparent SCSI routing.
Chapter 2 First-Time Configuration Collecting Configuration Information Collecting Configuration Information Use the Cisco SN 5428-2 Storage Router First-Time Configuration Checklist (Table 2-1) to help you gather the system and network information that is needed for the first-time configuration of your SN 5428-2 Storage Router. The items in the checklist are based on the information requested by the initial system configuration script and the setup configuration wizard.
Chapter 2 First-Time Configuration Collecting Configuration Information Table 2-1 First-Time Configuration Checklist (continued) Configuration Item Description Required or Optional Static route for management interface The destination IP address with subnet mask and then the gateway IP address. Required if SN 5428-2 is managed from a subnet other than the one to which it is physically attached, unless the SN 5428-2 will be configured to use RIP listening.
Chapter 2 First-Time Configuration Collecting Configuration Information Table 2-1 First-Time Configuration Checklist (continued) Configuration Item Description NTP server IP address The IP address of the NTP server available to the Optional storage router. This allows the storage router to keep the date and time synchronized with the rest of the network. Time zone, current date The format for the date is mm/dd/yyyy, and the and time time is hh:mm:ss.
Chapter 2 First-Time Configuration Collecting Configuration Information Table 2-1 First-Time Configuration Checklist (continued) Configuration Item Description Required or Optional Your Configuration Value Monitor-level password A password for users who will only monitor Optional storage router operations. The default password is cisco. Administrator-level password A password for users who will configure and administer the storage router. The default password is cisco.
Chapter 2 First-Time Configuration Connecting a Console Table 2-1 First-Time Configuration Checklist (continued) Configuration Item Description IP address A Gigabit Ethernet interface and IP address for the Required for FCIP named FCIP instance, to provide IP connectivity only between the FCIP instance and its peer destination. Peer address The IP address of the FCIP peer destination.
Chapter 2 First-Time Configuration Initial System Configuration Script Initial System Configuration Script The initial system configuration script runs on the CLI and ensures that a few required values are entered to make the SN 5428-2 Storage Router operational. When you first power up the storage router and after the initial boot process, the script will run automatically on the CLI session running on the terminal emulation program via an EIA/TIA-232 console connection.
Chapter 2 First-Time Configuration Running the Setup Configuration Wizard Running the Setup Configuration Wizard The setup configuration wizard is available from the CLI and is a script that consists of a series of prompts asking you to enter values to provide a basic system configuration for your SN 5428-2.
Chapter 2 First-Time Configuration Running the Setup Configuration Wizard Use the following procedure to start the setup configuration wizard. Step 1 Command Description enable Enter Administrator mode. If prompted for an Administrator password, use the default password, cisco. Note Step 2 setup Passwords are cluster-wide configuration elements and apply to all storage routers in a cluster.
Chapter 2 First-Time Configuration Introducing the CLI Introducing the CLI The CLI is available via a Telnet or Secure Shell (SSH) session to the management interface. It is also available via a direct EIA/TIA-232 connection on the console interface. The CLI provides commands to perform all necessary SN 5428-2 management functions, including software upgrades and maintenance. All CLI commands are capable of prompting for further information as the user types.
Chapter 2 First-Time Configuration Introducing the CLI Reserved Words Reserved words cannot be used as user-defined values or names in CLI commands. Words that are used as commands or as keywords in commands are reserved words. The following are additional reserved words in the CLI. • acl • canonical • iprouter • iptan • loglevel Show CLI Command Use the show cli command to display the complete CLI command syntax tree, along with helpful information about command parameters and arguments.
Chapter 2 First-Time Configuration Introducing the Web-Based GUI Starting a CLI Management Session Follow these steps to start a CLI management session via a Telnet connection to the storage router. Step 1 Establish a Telnet session to the SN 5428-2. Step 2 Enter the appropriate password at the logon prompt. Step 3 (Optional) Enter enable to change to Administrator mode. Note If you need to make changes to the configuration of the storage router, you need to enable the Administrator mode.
Chapter 2 First-Time Configuration Introducing the Web-Based GUI Monitor Mode Monitor mode in the web-based GUI will only allow you to monitor the storage router. You cannot configure, maintain, or troubleshoot the storage router in monitor mode. If you click on the Configuration, Maintenance, and Troubleshooting menu items in the GUI, a login dialog box will appear asking for a user name and password for administrator mode.
Chapter 2 First-Time Configuration Where to Go Next Where to Go Next Note If you want to configure a high availability cluster, or add the storage router to an existing cluster, review the information and procedures in Chapter 10, “Configuring a High Availability Cluster,” before configuring additional system parameters or SCSI routing.
C H A P T E R 3 Configuring System Parameters This chapter explains how to configure system parameters on your SN 5428-2 Storage Router and contains the following sections: • Prerequisite Tasks, page 3-1 • Configuration Tasks, page 3-2 • Configuring the Management Interface, page 3-3 • Configuring Time and Date, page 3-4 • Configuring IP Routes, page 3-5 • Configuring Network Management Access, page 3-7 • Configuring Passwords, page 3-8 • Configuring Administrator Contact Information, page
Chapter 3 Configuring System Parameters Configuration Tasks Configuration Tasks To configure system parameters on your SN 5428-2 Storage Router, perform the following steps: Step 1 Configure the management interface. Step 2 Configure the time and date. Step 3 (Optional) Configure IP routes. Step 4 (Optional) Configure network management access. Step 5 Configure passwords. Step 6 (Optional) Configure administrator contact information.
Chapter 3 Configuring System Parameters Configuring the Management Interface Figure 3-1 System Parameters Example Configuration Cisco SN 5428-2 HA interface Cluster Name: Mt_Olympus IP: 10.1.20.56 Mask: 255.255.255.0 GEx interface GE1 primary management interface GE2 secondary management interface IP: 10.1.70.85 Mask: 255.255.255.0 Management interface System Name: SN_5428-MG1 Domain Name: mystoragenet.com IP: 10.1.10.244 Mask: 255.255.255.0 GEx HA Management Station IP: 10.1.30.17 Gateway IP: 10.1.
Chapter 3 Configuring System Parameters Configuring Time and Date Step 3 Command Description interface mgmt ip-address 10.1.10.244/24 Specify or change the IP address and subnet mask for the management interface. Note Step 4 interface ge1 ip-address 10.1.70.85/24 secondary ge2 (Optional) Configure an IP address and subnet mask on ge1 to be used for SN 5428-2 management and maintenance. Specify ge2 as the secondary interface for this IP address.
Chapter 3 Configuring System Parameters Configuring IP Routes Command Description Step 3 clock set 08:20:00 04 15 2002 Set time and date (for example: time, 8:20 A.M.; date, April 15, 2002). Step 4 ntp peer 10.1.60.86 (Optional) Specify the name or IP address of the network time protocol (NTP) server with which the storage router will synchronize the date and time.
Chapter 3 Configuring System Parameters Configuring IP Routes Step 4 Command Description ip route 10.1.50.249/32 10.1.10.201 Configure a gateway IP address if the secondary DNS server is outside the storage router management subnet. The second IP address specifies a gateway on the storage router management network that will provide access to a secondary DNS server. Note Step 5 ip route 10.1.60.86/32 10.1.10.201 In this configuration example, the mask is set to 32 (255.255.255.
Chapter 3 Configuring System Parameters Configuring Network Management Access Configuring Network Management Access Configuring network management access consists of tasks for configuring SNMP. Use the following procedure to configure SNMP for network management access. Command Description Step 1 enable Enter Administrator mode. Step 2 no restrict all telnet (Optional) Enable Telnet access on all interfaces. By default, Telnet access is enabled on only the management interface.
Chapter 3 Configuring System Parameters Configuring Passwords Configuring Passwords Configuring passwords consists of setting the Monitor mode and Administrator mode passwords for access to the 10/100 Ethernet management interface (used for the CLI via Telnet or SSH, and the web-based GUI via HTTP). You can also enable these passwords to restrict access to the EIA/TIA-232 console interface. The factory default password for both Monitor and Administrator modes is cisco.
Chapter 3 Configuring System Parameters Configuring the High-Availability Interface Configuring the High-Availability Interface If you configured the SN 5428-2 for high availability during the initial system configuration, you were prompted to enter an IP address for the high availability (HA) interface. The HA interface is a 10/100 Ethernet interface, and is used along with the management interface to exchange information as heartbeats to detect changes or failures in the cluster.
Chapter 3 Configuring System Parameters Verifying and Saving Configuration Command Description Step 7 restrict mgmt telnet (Optional) If SSH is being used as a replacement for Telnet, you can disable Telnet access through the specified SN 5428-2 interface (or all interfaces). For example, disable Telnet access via the management interface. Step 8 no telnet enable (Optional) You can also disable Telnet for the entire SN 5428-2 by stopping the Telnet service.
C H A P T E R 4 Configuring for VLAN This chapter explains how to configure your SN 5428-2 Storage Router for a virtual local area network (VLAN) and contains the following sections: • Prerequisite Tasks, page 4-1 • VLAN Encapsulation, page 4-1 • Configuration Tasks, page 4-2 • Configuring for VLAN with VTP, page 4-4 • Configuring for VLAN without VTP, page 4-4 • Configuring an IP Route, page 4-5 • Verifying and Saving Configuration, page 4-5 • Assigning a VLAN to a SCSI Routing Instance, p
Chapter 4 Configuring for VLAN Configuration Tasks Configuration Tasks VLAN and VTP configuration information applies to all storage routers participating in a cluster. When the configuration information is saved, the settings become active on all storage routers in the cluster. Note Changes to cluster-wide configuration elements are handled by a single storage router in the cluster.
Chapter 4 Configuring for VLAN Configuration Tasks Figure 4-1 Contrast of Configuring for VLAN with VTP and without VTP Configuring for VLAN with VTP Network environment: VTP mode: VID: Optional parameter: Cisco only Client Automatically assigned Domain name Manually assigned VIDs and VLAN names VLAN 100 VID: 100 Name: Engineering SN 5428-2 learns about VLANs by exchanging VTP packets with externally attached switch and automatically assigns a VID to each VLAN. Cisco SN 5428-2 802.
Chapter 4 Configuring for VLAN Configuring for VLAN with VTP Configuring for VLAN with VTP Configuring for VLAN using the VLAN Trunking Protocol (VTP) consists of assigning the VTP domain name and setting the VTP mode to client. VTP, a proprietary protocol of Cisco Systems, is used to propagate VLAN information around a switched network. Use the following procedure to configure VLAN using VTP. Note VTP can only be used in a Cisco network environment.
Chapter 4 Configuring for VLAN Configuring an IP Route Configuring an IP Route Note If the SN 5428-2 is configured to dynamically learn routes via RIP listening, you do not need to configure a static IP route. Configuring an IP route to access the VLAN consists of specifying a static route that uses a gateway attached to the desired VLAN. Use the following procedure to configure an IP route. Command Description Step 1 enable Enter Administrator mode. Step 2 ip route 10.2.90.285/32 10.2.10.
Chapter 4 Configuring for VLAN Assigning a VLAN to a SCSI Routing Instance Use the following procedure to verify current operational information for all VLANs either learned from the network using VTP in client mode or configured locally while in transparent mode. Command Description Step 1 enable Enter Administrator mode. Step 2 show vlan Display current VLAN operational information (Example 4-3).
C H A P T E R 5 Configuring Fibre Channel Interfaces This chapter explains how to configure your SN 5428-2 Storage Router Fibre Channel (FC) interfaces.
Chapter 5 Configuring Fibre Channel Interfaces Configuring FC Interfaces Configuring FC Interfaces The SN 5428-2 has an integrated switch component with Fibre Channel interfaces (fc1 through fc8) that support the port types described in Table 5-1. The SN 5428-2 FC interfaces are auto configuring; for public devices and other switches, the SN 5428-2 can automatically set the port mode as each interface discovers the type of device to which it is connected.
Chapter 5 Configuring Fibre Channel Interfaces Configuring FC Interfaces • GS-3 management server commands enabled • Port type of generic loop, which enables automatic selection of port type as Fabric (F_Port), Fabric Loop (FL_Port or public loop) or Expansion (E_Port or switch to switch) • Credit extension is not enabled (ext-credit is 0) Configuring an FC Port Type To configure an FC port type, select the appropriate port type based on the connected equipment, as described in Table 5-1 on page 5-2
Chapter 5 Configuring Fibre Channel Interfaces Configuring the Domain ID Command Description Step 1 enable Enter Administrator mode. Step 2 interface fc8 type donor Set the FC interface port type to donor. Step 3 interface fc1 type f-port Set the FC interface port type to F_Port. Step 4 interface fc1 ext-credit 11 Set a recipient interface port to receive credit extension. Buffer credits can be made available only in increments of 11, with a maximum of 77 credits.
Chapter 5 Configuring Fibre Channel Interfaces Configuring the Domain ID Internal FC Ports There are two internal FC ports in the SN 5428-2, initiator WWPN1 and initiator WWPN2. These two initiator ports identify the SN 5428-2 to the switched fabric. Both initiator WWPN1 and WWPN2 are required by your zone administrator to allow participation in zoning. To include the SN 5428-2 in FC zoning, both ports (WWPN1 and WWPN2) must be included in the zone set.
Chapter 5 Configuring Fibre Channel Interfaces Configuring Zoning Configuring Zoning The SN 5428-2 zoning feature provides the ability to actively participate in FC switched fabric zones and to manage zones. Managing a zone includes creating a zone set, creating zones as zone set members, then adding devices (using WWPN) as zone members. After the zone members are added to the zone set, you must activate the zone set.
Chapter 5 Configuring Fibre Channel Interfaces Configuring Zoning Creating a zone set, a zone, and an alias To operate within a zone, the zone set, zone, and alias names must be unique. Before creating a zone set, zone, or alias, ensure that the SN 5428-2 is attached to the switched fabric. When the SN 5428-2 is attached to the switched fabric, you will not be allowed to use a name that is already in use. Use the following procedure to create a zone set, a zone, and an alias.
Chapter 5 Configuring Fibre Channel Interfaces Configuring Zoning Adding an alias to a zone Use the following procedure to add an alias to a zone. In this example, the zone is named agamemnon and the alias is named leto. The default alias named iscsi is also added to the zone. Command Description Step 1 enable Enter Administrator mode. Step 2 zone agamemnon member fcalias leto Assign the alias to the zone.
Chapter 5 Configuring Fibre Channel Interfaces Verifying Configuration Clearing the fabric wide zoning database When reconfiguring the zones in the FC zoned fabric you must clear the zoning database and deactivate the active zone set for the entire switched fabric. Use the following procedure to clear the local zoning database and deactivate the active zone set on the fabric. Command Description Step 1 enable Enter Administrator mode.
Chapter 5 Configuring Fibre Channel Interfaces Verifying Configuration Cisco SN 5428-2 Storage Router Software Configuration Guide 5-10 78-15471-01
C H A P T E R 6 Configuring SCSI Routing This chapter explains how to configure your SN 5428-2 Storage Router for SCSI routing and contains the following sections: • Prerequisite Tasks, page 6-1 • Configuration Tasks, page 6-2 • Creating a SCSI Routing Instance, page 6-6 • Configuring a Server Interface, page 6-6 • Configuring iSCSI Targets, page 6-7 • Creating and Configuring an Access List, page 6-10 • Configuring Access to iSCSI Targets, page 6-11 • Verifying and Saving Configuration, pa
Chapter 6 Configuring SCSI Routing Configuration Tasks Configuration Tasks To configure SCSI routing on your SN 5428-2 Storage Router, perform the following steps: Step 1 Create a SCSI routing instance. Once an instance is created, you will configure that instance with parameters for a server interface, iSCSI targets, and access by IP hosts. Step 2 Configure a server interface with or without VLAN. Step 3 Configure iSCSI targets. Step 4 (Optional) Create and configure a named access list.
Chapter 6 Configuring SCSI Routing Configuration Tasks Figure 6-1 Configuration Elements for SCSI Routing SN 5428-2 Storage Router configured for SCSI routing SCSI routing instance Access list Control of access between IP hosts and targets Identifier(s) IP Addresses, CHAP user name, or iSCSI name Access Server interface(s) Specifies (a) the primary SN 5428-2 Gigabit Ethernet interface that the SCSI routing instance will use to communicate with IP hosts (b) The IP address of the server interface fo
Chapter 6 Configuring SCSI Routing Configuration Tasks Figure 6-2 SCSI Routing Parameters Example Configuration SCSI routing instance Name: zeus Access list:aegis CHAP User Name 12h7b.lab2.webservices CHAP User Name 52a3c.lab2.webservices CHAP User Name 36a8g.lab1.webservices IP / Mask: 10.2.0.23 / 255.255.255.255 IP / Mask: 10.3.0.36 / 255.255.255.255 IP / Mask: 10.4.0.49 / 255.255.255.
Chapter 6 Configuring SCSI Routing Configuration Tasks Figure 6-3 Configuration of SCSI Routing Instance Determines VLAN Access to Storage Devices SN 5428-2 Storage Router configured for SCSI routing SCSI routing instance A VLAN 200 VID: 200 With the scsirouter serverif vlan command, assign a VLAN (identified by its VID) to the desired SCSI routing instance iSCSI targets iSCSI targets assigned to the SCSI routing instance determine which storage devices the VLAN can access SCSI routing instance B G
Chapter 6 Configuring SCSI Routing Creating a SCSI Routing Instance Creating a SCSI Routing Instance Creating a SCSI routing instance consists of naming the new instance. Use the following procedure to create a SCSI routing instance. Command Description Step 1 enable Enter Administrator mode. Step 2 scsirouter zeus Create a SCSI routing instance by naming the new instance (zeus). Note You can define up to 12 instances on a single SN 5428-2 or across a cluster.
Chapter 6 Configuring SCSI Routing Configuring iSCSI Targets With VLAN Use the following procedure to assign a server interface and VLAN to a SCSI routing instance. Command Description Step 1 enable Enter Administrator mode. Step 2 scsirouter zeus serverif ge2 vlan Assign a VLAN, identified by its VID (100), to the desired SCSI 100 10.1.0.45/24 routing instance (zeus). Specify the server interface (ge2) and the IP address and subnet mask (10.1.0.
Chapter 6 Configuring SCSI Routing Configuring iSCSI Targets Example 6-3 Id --1 2 3 4 I/F ----fc4 fc4 fc4 fc4 Indexed List of Storage Devices by Serial Number Serial -----------------LS092288000019512N3V LS101990000019411NGQ LS093221000019451JM5 LS097776000019511C3B Lun ----0 0 0 0 Device Type -----Disk Disk Disk Disk Vendor -------SEAGATE SEAGATE SEAGATE SEAGATE Product ---------ST319451FC ST319452FC ST319453FC ST319452FC Target-and-LUN mapping using WWPN addressing Use the following procedure
Chapter 6 Configuring SCSI Routing Configuring iSCSI Targets Use the following procedure to map iSCSI targets to storage devices by an index number. Command Description Step 1 enable Enter Administrator mode. Step 2 scsirouter zeus target chimaera_eng lun 17 lunid #? Specify desired SCSI routing instance (zeus). Specify iSCSI target (chimaera_eng) and LUN (17), and prompt for an indexed list of available storage addresses using the number sign and a question mark (#?).
Chapter 6 Configuring SCSI Routing Creating and Configuring an Access List Target-only mapping using WWPN addressing Use the following procedure to map iSCSI targets to storage devices by physical storage address. Command Description Step 1 enable Enter Administrator mode. Step 2 scsirouter zeus target pegasus_email wwpn 22000020371912da Specify desired SCSI routing instance (zeus).
Chapter 6 Configuring SCSI Routing Configuring Access to iSCSI Targets Note If there is a CHAP user name entry in the access list, the SCSI routing instance used to access the storage target must also have iSCSI authentication enabled. See Chapter 9, “Configuring Authentication,” for additional information about AAA and iSCSI authentication. Use the following procedure to create an access list. In this procedure, the access list is called aegis and the IP host identifiers include three IP addresses (10.
Chapter 6 Configuring SCSI Routing Configuring Access to iSCSI Targets You can also associate up to two access lists with an iSCSI target: one allowing read/write access, and one allowing read-only access. The default access is read/write. Access lists are evaluated read/write first, and then read-only, so if an IP host is associated with both types of lists, it will be allowed read/write access. Note Some host operating systems impose restrictions on the use of read-only access lists.
Chapter 6 Configuring SCSI Routing Configuring Access to iSCSI Targets Command Description Step 1 enable Enter Administrator mode. Step 2 scsirouter zeus target all accesslist aegis Specify that all iSCSI targets that were configured as part of the specified SCSI routing instance (zeus) can be accessed by IP hosts listed in an access list (aegis). Because access is read/write by default, it does not need to be specified.
Chapter 6 Configuring SCSI Routing Verifying and Saving Configuration Command Description Step 1 enable Enter Administrator mode. Step 2 scsirouter zeus target Assign read/write access to the iSCSI target (chimaera_eng) by IP chimaera_eng accesslist aegis rw hosts listed in the access list (aegis). Step 3 scsirouter zeus target chimaera_eng accesslist any ro Assign read-only access to the iSCSI target (chimaera_eng) by any other IP hosts with access to that target.
Chapter 6 Configuring SCSI Routing Verifying and Saving Configuration Example 6-5 Verifying IP Hosts in an Access List Named aegis [SN5428-2A]# show accesslist aegis accesslist aegis description "Access to zeus SCSI routing service" accesslist aegis 10.2.0.23/255.255.255.255 accesslist aegis 10.3.0.36/255.255.255.255 accesslist aegis 10.4.0.49/255.255.255.255 accesslist aegis chap-username 12h7b.lab2.webservices accesslist aegis chap-username 36a8g.lab1.webservices accesslist aegis chap-username 52a3c.
Chapter 6 Configuring SCSI Routing Verifying and Saving Configuration Targets - Lun Mapped via Lunid Router Target Lun Lunid ---------- ---------------- ----- ---------------zeus chimaera_eng 17 200000203719129d Targets - Lun Mapped via Serial Router Target Lun Serial ---------- ---------------- ----- ---------------zeus pegasus_web 3 LS093221000019451JM5 Cisco SN 5428-2 Storage Router Software Configuration Guide 6-16 78-15471-01
C H A P T E R 7 Configuring Transparent SCSI Routing This chapter explains the configuration process for a transparent SCSI routing deployment of the SN 5428-2 Storage Router and provides procedures to verify the configuration. It contains the following sections: • Prerequisite Tasks, page 7-1 • Summary of Configuration Process, page 7-1 • Verifying Configuration, page 7-3 Transparent SCSI routing is configured with the values entered with the initial system configuration script.
Chapter 7 Configuring Transparent SCSI Routing Summary of Configuration Process • Dynamic mode When transparent SCSI routing is deployed in dynamic mode, the iSCSI client-to-internal FC WWPN mappings are not persistent across reboots; they are reset each time any of the following occurs: – Whenever the storage router is rebooted – Whenever an IP host (iSCSI client) logs in and out, then logs back in For both static mode and dynamic mode, the maximum number of FC WWPNs available on the storage router is
Chapter 7 Configuring Transparent SCSI Routing Verifying Configuration Verifying Configuration Use the following procedure to verify the configuration of the SCSI routing instance. Command Description Step 1 enable Enter Administrator mode. Step 2 show scsirouter transparent Display configuration for SCSI routing instance (Example 7-1). or Note As shown in the second command, you can type the keyword, all, as a shortcut, instead of the SCSI routing instance name, transparent.
Chapter 7 Configuring Transparent SCSI Routing Verifying Configuration Use the following procedure to verify logged-in IP hosts and bound Fibre Channel targets. Example 7-2 Command Description Step 1 enable Enter Administrator mode. Step 2 show interface fci1 iscsilogins Display logged-in IP hosts and bound Fibre Channel targets on internal FC interface fci1 (Example 7-2).
Chapter 7 Configuring Transparent SCSI Routing Verifying Configuration The following explains the Initiator and State fields: Initiator Initiator 0 is reserved for the primary initiator port. This port performs the discovery of the target devices—the same devices that appear in the show devices command. This port is not available to IP hosts. The port’s IP address is the one assigned to the SN 5428-2 management interface, and its IP host name is the system name of the SN 5428-2 with “iqn.1987-05.com.
Chapter 7 Configuring Transparent SCSI Routing Verifying Configuration Cisco SN 5428-2 Storage Router Software Configuration Guide 7-6 78-15471-01
C H A P T E R 8 Configuring FCIP This chapter explains how to configure your SN 5428-2 Storage Router for FCIP and contains the following sections: • Prerequisite Tasks, page 8-1 • Configuration Tasks, page 8-2 • Setting the Domain ID, page 8-2 • Creating an FCIP Instance, page 8-3 • Assigning an IP Address, page 8-3 • Assigning a Protocol, Peer Name, and Peer IP Address, page 8-3 • Configuring Operational Parameters, page 8-5 • Verifying and Saving Configuration, page 8-6 FCIP is configur
Chapter 8 Configuring FCIP Configuration Tasks Configuration Tasks To configure FCIP on an SN 5428-2 Storage Router, perform the following steps: Step 1 If not already done, set the domain ID to a different value on one of the peer SN5428-2s. Step 2 Create an FCIP instance. Step 3 Assign an interface and IP address to the FCIP instance for use by the peer storage router (another SN 5428-2 configured for FCIP). Step 4 Assign protocol and FCIP peer IP address.
Chapter 8 Configuring FCIP Creating an FCIP Instance Creating an FCIP Instance Creating an FCIP instance consists of naming the new instance. Use the following procedure to create an FCIP instance. Command Description Step 1 enable Enter Administrator mode. Step 2 fcip fcip1 Create an FCIP instance by naming the new instance. For example, name the instance fcip1. The FCIP instance named fcip1 uses the Gigabit Ethernet interface, ge1; the instance named fcip2 uses ge2.
Chapter 8 Configuring FCIP Assigning a Protocol, Peer Name, and Peer IP Address Assigning Protocol: tcpserver If the peer FCIP instance is configured as a TCP client, use the following procedure to assign an arbitrary peer name and configure the peer’s IP address. Command Description Step 1 enable Enter Administrator mode. Step 2 fcip fcip2 destination fcip1san5 tcpserver 10.1.0.47 Assign an arbitrary name to the peer FCIP instance, and enter its IP address.
Chapter 8 Configuring FCIP Configuring Operational Parameters Assigning Protocol: raw If the peer FCIP instance is configured to use raw IP, use the following procedure to assign an arbitrary name to the FCIP peer and configure the peer’s IP address. Command Description Step 1 enable Enter Administrator mode. Step 2 fcip fcip1 destination fcip1san5 raw 10.1.0.48 Assign an arbitrary name to the peer FCIP instance, and enter its IP address.
Chapter 8 Configuring FCIP Verifying and Saving Configuration Table 8-2 describes the optional operational parameters available for raw protocol.
Chapter 8 Configuring FCIP Verifying and Saving Configuration Example 8-1 Verifying Existence of an FCIP instance [SN5428-2A]# show fcip fcip1 Instance Device I/F Network I/F -------- ---------- ----------fcip1 fci1 ge1 10.1.0.16 Description ----------Access to SAN island 5 Destination ----------fcip1san5 LocalMode --------raw IpAddress --------------10.1.0.
Chapter 8 Configuring FCIP Verifying and Saving Configuration Cisco SN 5428-2 Storage Router Software Configuration Guide 8-8 78-15471-01
C H A P T E R 9 Configuring Authentication This chapter explains how to configure the authentication portion of Cisco’s authentication, authorization and accounting (AAA) services on the SN 5428-2 Storage Router and how to configure Enable, Login and iSCSI authentication, which use AAA authentication services.
Chapter 9 Configuring Authentication Prerequisite Tasks Prerequisite Tasks Before performing AAA authentication configuration tasks on the storage router, make sure you have configured system parameters as described in Chapter 2, “First-Time Configuration,” or Chapter 3, “Configuring System Parameters.” If the storage router is deployed for SCSI routing, you should also configure SCSI routing instances as described in Chapter 6, “Configuring SCSI Routing,” before proceeding.
Chapter 9 Configuring Authentication Using Authentication Enable Authentication When configured, a user enters password information each time the CLI enable command is entered from the management console, or from a Telnet or SSH management session. Because the enable command does not require you to enter a user name, configured authentication services that require a user name (such as RADIUS or TACACS+ servers) are passed the default user name, $enab15$, along with the entered password for authentication.
Chapter 9 Configuring Authentication Configuration Tasks Configuration Tasks To configure iSCSI, Enable or Login authentication and the associated AAA authentication services on the storage router, perform the following steps: Step 1 Configure the desired authentication services, such as RADIUS, TACACS+ and the local username database. Step 2 (Optional) Create named groups of RADIUS and TACACS+ servers. Step 3 Create AAA authentication lists.
Chapter 9 Configuring Authentication Configuration Tasks Figure 9-1 iSCSI Authentication Configuration Elements Remote RADIUS servers Remote TACACS+ servers Username database user user user user user user ... ... When iSCSI authentication is enabled, the SCSI routing instance passes the user name and password from the iSCSI driver to AAA for authentication. AAA uses the specified authentication list to determine which services to use for the authentication attempt.
Chapter 9 Configuring Authentication Configuration Tasks Figure 9-2 iSCSI Authentication Example Configuration Remote TACACS+ servers IP 10.7.0.22 IP 10.7.0 41 IP 10.7.0.45 Global Key: tacacs123SN group janus Username database Remote RADIUS servers IP 10.5.0.61 IP 10.6.0.
Chapter 9 Configuring Authentication Configuration Tasks Figure 9-3 illustrates AAA authentication configuration elements used for Enable authentication and Figure 9-4 illustrates the example configuration of Enable authentication and AAA authentication services used in this chapter.
Chapter 9 Configuring Authentication Configuration Tasks Figure 9-4 Enable Authentication Example Configuration group sysadmin Remote TACACS+ servers IP 10.7.0.22 IP 10.7.0.
Chapter 9 Configuring Authentication Configuration Tasks Figure 9-5 illustrates AAA authentication configuration elements used for Login authentication and Figure 9-6 illustrates the example configuration of Login authentication and AAA authentication services used in this chapter.
Chapter 9 Configuring Authentication Configuration Tasks Figure 9-6 Login Authentication Example Configuration group sysadmin Remote TACACS+ servers IP 10.7.0.22 IP 10.7.0.
Chapter 9 Configuring Authentication Configuring AAA Authentication Services Configuring AAA Authentication Services Configuring AAA authentication services consists of setting the appropriate parameters for the various service options that can be used by the storage router. The storage router can use any or all of the supported services: • RADIUS • TACACS+ • Local username database • Enable • Monitor Use the procedures that follow to configure the storage router to use each of these services.
Chapter 9 Configuring Authentication Configuring AAA Authentication Services TACACS+ Hosts Use the commands in the following procedure to configure TACACS+ authentication services. Command Description Step 1 enable Enter Administrator mode. Step 2 tacacs-server host 10.7.0.22 Specify the TACACS+ servers to be used for AAA authentication. For example, specify the TACACS+ servers at 10.7.0.22, 10.7.0.41, and 10.7.0.45 for use by the storage router.
Chapter 9 Configuring Authentication Configuring AAA Authentication Services The following rules apply to passwords: • Passwords are entered in clear text. However, they are changed to “XXXXX” in the CLI command history cache, and are stored in the local username database in an encrypted format. • If the password contains embedded spaces, enclose it with single or double quotes. • After initial entry, passwords display in their encrypted format.
Chapter 9 Configuring Authentication Creating Named Server Groups Creating Named Server Groups By default, you can use all configured RADIUS or TACACS+ servers for authentication. All configured RADIUS servers belong to the default group named radius. All configured TACACS+ servers belong to the default group named tacacs+. You can also create named groups of RADIUS or TACACS+ servers, to be used for specific authentication purposes.
Chapter 9 Configuring Authentication Creating AAA Authentication Lists Step 3 Command Description aaa group server tacacs+ sysadmin server 10.7.0.22 Add a TACACS+ server to the named group. For example, add the TACACS+ server at IP address 10.7.0.22 to the group named sysadmin. Because no port is specified, authentication requests to this server use the default port 49. Servers are accessed in the order in which they are defined within the named group.
Chapter 9 Configuring Authentication Creating AAA Authentication Lists Enable authentication Use the commands in the following procedure to build a default list of AAA authentication services to be used for Enable authentication. Building the default list completes the configuration of Enable authentication and makes it immediately effective. Command Description Step 1 enable Enter Administrator mode.
Chapter 9 Configuring Authentication Testing Authentication Testing Authentication You can perform authentication testing at any time. For example, before enabling iSCSI authentication for a SCSI routing instance, you can test iSCSI authentication. The user name and password are passed to AAA authentication, which performs authentication using the specified iSCSI authentication list. The command response indicates a pass or fail status.
Chapter 9 Configuring Authentication Configuring Two-Way Authentication Login Authentication Use the commands in the following procedure to test Login authentication. Command Description Step 1 enable Enter Administrator mode. Step 2 aaa test authentication login default sysmonitor ciscomonitor Test the user name and password configured for Monitor mode access to the storage router. AAA authentication uses the services in the default list (Example 9-3).
Chapter 9 Configuring Authentication Enabling iSCSI Authentication Enabling iSCSI Authentication iSCSI authentication is enabled for specific SCSI routing instances. By default, iSCSI authentication is not enabled. Use the commands in the following procedure to enable iSCSI authentication using the AAA authentication methods configured in the specified AAA authentication list. Command Description Step 1 enable Enter Administrator mode.
Chapter 9 Configuring Authentication Verifying and Saving Configuration Example 9-4 Display AAA Authentication Configuration [SN5428-2-MG1]# show aaa aaa new-model username "labserver" password "9 491c083a73d7f89bc0205927d086cdd0d8" username "labserver2" password "9 5ccd52d543e0d3a5558afe8cbe2867dd41" radius-server key "9 64ced29a261a8ca554a6f4ea8d494669c1" radius-server host 10.6.0.53 auth-port 1645 radius-server host 10.6.0.73 auth-port 1645 radius-server host 10.5.0.
C H A P T E R 10 Configuring a High Availability Cluster This chapter explains how to configure SN 5428-2 Storage Routers in a cluster to allow the storage routers to back each other up in case of failure.
Chapter 10 Configuring a High Availability Cluster Creating a Cluster Guidelines for Configuring SCSI Routing Instances When you configure SCSI routing instances to run in a high availability cluster, the following operational guidelines apply: • A cluster supports up to 12 active SCSI routing instances.
Chapter 10 Configuring a High Availability Cluster Creating a Cluster To create a cluster, you typically configure a principal storage router (including all cluster-wide settings), and then add a new, unconfigured node or a minimally configured node to the cluster. Note A minimally configured storage router is one in which the management IP address, system name, and optional network management interfaces have been configured.
Chapter 10 Configuring a High Availability Cluster Creating a Cluster Adding an Unconfigured SN 5428-2 Storage Router To add a new, unconfigured SN 5428-2 to the existing cluster, perform the following steps: Step 1 Respond to the prompts from the SN 5428-2 initial system configuration script. When prompted to select HA configuration mode, choose clustered. When prompted for cluster name, enter the name of the existing cluster.
Chapter 10 Configuring a High Availability Cluster Creating a Cluster Adding a Minimally Configured SN 5428-2 Storage Router To add a minimally configured SN 5428-2 to an existing cluster, perform the following steps: Step 1 Run the setup cluster configuration wizard. • When prompted to select HA configuration mode, choose clustered. • When prompted for cluster name, enter the name of the existing cluster. • When prompted, enter the HA IP address for the SN 5428-2.
Chapter 10 Configuring a High Availability Cluster Joining Stand-alone Storage Routers in a Cluster Joining Stand-alone Storage Routers in a Cluster In some cases you may prefer to completely configure both storage routers (including SCSI routing instances and access lists) as stand-alone systems before joining them into a cluster. The following example explains the steps required to create a cluster named Cluster1, composed of two SN 5428-2s named Sys1 and Sys2.
Chapter 10 Configuring a High Availability Cluster Changing Clusters Changing Clusters In some situations, you may need to move a storage router from one cluster to another cluster. Moving a fully configured storage router from one cluster to another is more complex than simply adding it to a cluster. Advanced planning is required.
Chapter 10 Configuring a High Availability Cluster Changing Clusters Cisco SN 5428-2 Storage Router Software Configuration Guide 10-8 78-15471-01
C H A P T E R 11 Maintaining and Managing the SN 5428-2 Storage Router This chapter explains how to perform normal maintenance and management tasks associated with the Cisco SN 5428-2 Storage Router.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Prerequisite Tasks Prerequisite Tasks Before performing any of the storage router maintenance tasks, make sure you have configured system parameters as described in Chapter 2, “First-Time Configuration,” or Chapter 3, “Configuring System Parameters.” Note Certain configuration tasks, such as identifying a location from which to download software, are optional and may not have been performed during initial configuration.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Installing Updated Software Example 11-1 Results of “show software version all” Command [SN5428-2_A01]# show software version all Version -------------------3.3.0.23-K9 3.3.1-K9 Boot ---OK OK Hash ---OK OK Sign ---N/A N/A Crash ----0 0 Size ---------10101.0 KB 11102.0 KB Date --------------------Feb 25 11:38 CDT 2003 Feb 29 15:44 CDT 2003 Http Url: http://www.cisco.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Installing Updated Software Note If you use the URL, http://www.cisco.com, as the default download location, the username and password must be the same as your Cisco.com login ID and password. Using HTTP Use the following procedure to specify the HTTP download location. Command Description Step 1 enable Enter Administrator mode. Step 2 software http url http://10.1.11.32/software/sn5428-2 Configure the default download location.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Installing Updated Software Downloading Updated Software The download software command makes a new version of software available to the storage router for boot purposes. You can store two versions of software on the SN 5428-2. Before attempting to download updated software, verify that only a single version of software exists on the storage router.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Installing Updated Software Command Description Step 1 enable Enter Administrator mode. Step 2 download software tftp version 3.3.1-K9 Make a new software version available to the storage router (for example, 3.3.1-K9). Downloading from a Special Location There may be times when you need to make special software available to the storage router, for example, under the guidance of a Cisco Technical Support professional.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Backing Up System Configuration Command Description Step 3 show software version boot Verify that the correct version is shown as the bootable version (identified as Boot Version). Step 4 reboot When you are ready to run the new software version, restart the storage router.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Restoring from Backups Command Description Step 1 enable Enter Administrator mode. Step 2 save system mybackup Save the storage router system configuration information to a file named mybackup. Storing Backups to a Remote TFTP Server Use the following procedure to create a backup configuration file named backup1 and to copy that backup file to another file named back1.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Restoring from Backups Command Description Step 1 enable Enter Administrator mode. Step 2 copy http://10.1.1.44/~s1/back1 savedconfig:scsi1_restore Copy the specified configuration file from the designated URL and place it in the savedconfig directory, using the file name, scsi1_restore. Step 3 show savedconfig Verify that the imported file now exists in the savedconfig directory.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Restoring from Backups Command Description Step 8 show scsirouter scsi2 (Optional) Verify the configuration of the restored and restarted SCSI routing instance. The running configuration should now match the restored permanent configuration. Once the instance has been restored and restarted, modifications to its configuration can also be made.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Restoring from Backups Restoring AAA Authentication Information When you restore AAA authentication information, the following configuration settings are updated: • AAA authentication lists • The user names and passwords in the local username database • Radius servers, server groups, and associated server, group and global authentication port, retransmit, time-out, deadtime and key values • TACACS+ servers, server groups, and associa
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Restoring from Backups The saved access list in the configuration file named accesslist_backup, contains these entries: Note • 209.165.200.225/32 • 10.1.1.30/32 • chap-username 12h7b.lab2.webservices • chap-username test2.sys3 In a cluster environment, access lists management functions are handled by a single node in the cluster.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Restoring from Backups Note Restoring global FC settings, such as the domain ID, in an operational fabric may cause traffic disruptions. Command Description Step 1 enable Enter Administrator mode. Step 2 no interface fc1 enable (Optional) Remove the storage router from the switched fabric by disabling all FC interfaces operating as E_Ports. For example, disable the FC interfaces fc1 and fc4.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Restoring from Backups ! FC PORTS ! interface fc1 enable interface fc1 ms-enable enable no interface fc1 al-fairness enable interface fc1 fan-enable enable interface fc1 ext-credit 0 interface fc1 mfs-bundle enable timeout 10 interface fc1 linkspeed auto interface fc1 type gl-port ! ...
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Restoring from Backups Restoring System Configuration You can restore selected system information using the restore system command.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Powering Down the SN 5428-2 Storage Router Example 11-3 Verify SNMP Configuration [SN5428-2_PR1]# show snmp First Trap Host: 10.1.32.200 Second Trap Host: 10.2.12.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Resetting the System Resetting the System There may be times when you need to return some or all of the storage router configuration to factory defaults, for example, when moving a system between environments (such as test and production) or for troubleshooting purposes. To reset the SN 5428-2 Storage Router, perform the following steps: Step 1 (Optional) Save existing configuration information to a file.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Resetting the System After the move, use the EIA/TIA-232 console connection to configure the management interface IP address and other required system information. Then continue configuration of the storage router via the setup configuration wizards or other CLI commands, or via the web-based GUI. See Chapter 2, “First-Time Configuration,” for more information about initial system configuration.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Recovering Passwords Reset to Remove Saved Configuration Files The following procedure removes previously saved configuration files from the storage router. The system configuration, management information, and SCSI routing instances remain unchanged. For example, use this procedure if a stand-alone storage router has joined a cluster and adopted the new cluster’s configuration.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Controlling SCSI Routing Instances in a Cluster Controlling SCSI Routing Instances in a Cluster It is important to know where SCSI routing instances are running. While automatic failover capabilities keep the high availability cluster operational in times of system difficulties, manual HA controls provide the ability to distribute SCSI routing instances between the storage routers in a cluster to meet your specific network requirements.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Controlling SCSI Routing Instances in a Cluster For additional information and recommended procedures for changing iSCSI driver configuration, see the iSCSI driver readme and example configuration files. You can access the latest iSCSI drivers and readme and example configuration files from Cisco.com.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Controlling SCSI Routing Instances in a Cluster Example 11-6 Verify Target, Access List, and Target Status [SN5428-2_PR1]# show scsirouter foo SCSI Router Information Status Codes: A=active, I=inactive, C=create failed, D=not enabled, S=slave CDB Reserve Pass Lun Router Stat Retry Proxy Thru Reset Description -------------------- ---- ----- -------- ---- ----- ----------foo A 6 disabled no no test iSCSI SCSI Router Authentication Informatio
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Controlling SCSI Routing Instances in a Cluster Stopping & Starting Instances If the storage router is experiencing a problem with a specific set of IP hosts or storage resources, you may wish to stop the associated SCSI routing instance from running anywhere in the cluster.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Controlling SCSI Routing Instances in a Cluster Note • Some mapped targets are unavailable and all mapped targets are available on another storage router in the cluster. • All mapped targets are available, but another storage router in the cluster also has all targets available and is designated at the primary for the SCSI routing instance. • The storage router stops receiving heartbeats from another storage router within the cluster.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Controlling SCSI Routing Instances in a Cluster Manual Failover While failover of SCSI routing instances is automatic, there may be times when you wish to manually move a SCSI routing instance from one storage router to another. The move may be temporary, after which the instance will be moved back to its original location.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Controlling SCSI Routing Instances in a Cluster Note Use caution if you change the configuration of a SCSI routing instance while it is running on the storage router that is not the instance’s configured primary. If the instance’s configuration changes while the designated primary for that instance is down (or otherwise removed from the cluster), the changes will not be propagated to that node.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Managing CDP on the SN 5428-2 Storage Router Command Description Step 1 enable Enter Administrator mode. Step 2 show cluster Verify that the SCSI routing instance to be moved is indeed running on Sys2. or show scsirouter scsi3 brief Step 3 failover scsirouter scsi3 to Sys1 Failover the desired SCSI routing instance, scsi3, to Sys1.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Using Scripts to Automate Tasks Modify the CDP Holdtime and Timeout Values Holdtime is the amount of time the receiving device should hold a CDP packet from the storage router before discarding it. The CDP holdtime value must be set to a higher number of seconds than the CDP timer value (the time between CDP transmissions from the storage router). For example, the default CDP holdtime value is 180 seconds.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Using the SN 5428-2 Logging Facilities For example: radius-server host 10.5.0.53 \ auth-port 1644 \ timeout 60 \ retransmit 5 ! Configure 1st RADIUS server radius-server host 10.6.0.61 . . . • Scripts can be invoked from other scripts. • You can pass parameters to scripts. Within the script, the key character is the “@” which instructs the script execution function to substitute the value of the specified parameter.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Using the SN 5428-2 Logging Facilities All messages are assigned a notification level, which reflects the priority of the message in the system. Messages with the highest priority are assigned a notification level of emergency. Messages at this level indicate that the system is unusable. Messages with the lowest priority are assigned a notification level of debug. Messages at this level are for troubleshooting purposes.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Using the SN 5428-2 Logging Facilities Table 11-3 Event Message Facilities (continued) Facility Description GE Gigabit Ethernet interfaces. HA High availability cluster functions. IF Interface manager. INVALID Generic functions. IP IP functions. ISCSI iSCSI functions. MON Hardware monitor. SLP Service Location Protocol service functions. SNMP Simple Network Management Protocol. SYSLOG Syslog functions.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Using the SN 5428-2 Logging Facilities Example 11-12 Example Log Route Entries List Index Level 1 notice 2 info Priority Facility 5 SNMP 6 all Route all console logfile Syslog host is enabled, ipaddress is 10.1.70.6 The logging table can be saved and retained across a storage router restart. The order of the rules in the logging table is preserved when entries are deleted. Enabling and Disabling Logging Logging is enabled by default.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Gathering Troubleshooting Information Clearing the Log Files Use the following procedure to periodically clear the log files. Command Description Step 1 enable Enter Administrator mode. Step 2 show logging size (Optional) Check the current size of the log files (Example 11-13).
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Gathering Troubleshooting Information The crash log provides the following information: • System information, including software version • Exception information • Boot information, including the kernel version and creation date • A list of all tasks, including entry point, task ID and priority for each task • Task registers and stack trace for each task in the task list • Net job ring • A list of all modules, including module I
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Gathering Troubleshooting Information Using FTP with the SN 5428-2 Storage Router In certain cases, you may want to copy log files from the storage router to another server in your network for analysis purposes, or you may want to copy configuration or script files to another server prior to making them available to another SN 5428-2. The storage router includes an FTP daemon; however, the FTP port (port 21) is, by default, restricted.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Gathering Troubleshooting Information 92167 Apr-10-2002 19:14:06 tmpcrash.txt 226 Transfer complete ftp: 374 bytes received in 0.02Seconds 23.38Kbytes/sec. ftp> binary 200 Type set to I, binary mode ftp> get (remote-file) messages0 (local-file) SN5428-2Sys1_Messages 200 Port set okay 150 Opening BINARY mode data connection 226 Transfer complete 40863 bytes received in 0.049 seconds (8.1e+02 Kbytes/s) ftp> bye 221 Bye...
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Gathering Troubleshooting Information Capturing the Storage Router Configuration You can use the show runningconfig or show bootconfig command to display the storage router current running configuration or the bootable configuration. You can then redirect this display to create a script file in the SN 5428-2 script directory. The resulting file can be used as a basis to create command scripts to automate common tasks.
Chapter 11 Maintaining and Managing the SN 5428-2 Storage Router Gathering Troubleshooting Information Cisco SN 5428-2 Storage Router Software Configuration Guide 11-38 78-15471-01
C H A P T E R 12 Command Line Interface Reference The Cisco SN 5428-2 Storage Router provides three interfaces for operation, configuration, administration, maintenance, and support tasks: command line interface (CLI), web-based GUI, and SNMP. This chapter documents the storage router CLI. For help on the web-based GUI, point your browser to the storage router’s management interface IP address. After logging on, click the Help link to access the online help system.
Chapter 12 Command Line Interface Reference CLI Commands CLI Commands This section lists all CLI commands in alphabetical order. The no form of any command is shown with the primary command entry. Command information includes syntax, defaults, mode, history, usage guidelines, examples, and related commands.
Chapter 12 Command Line Interface Reference aaa authentication enable aaa authentication enable To configure authentication, authorization and accounting (AAA) authentication services for Administrator mode access to the CLI (via the CLI enable command), use the aaa authentication enable command. To disable this authentication, use the no form of this command. aaa authentication enable default services1 [services2...
Chapter 12 Command Line Interface Reference aaa authentication enable In Table 12-1, the group radius and group tacacs+ methods refer to all previously defined RADIUS or TACACS+ servers; the group name method refers to a previously defined group of one or more RADIUS or TACACS+ servers. Use the radius-server host and tacacs-server host commands to configure the servers, and the aaa group server radius and aaa group server tacacs+ commands to create server groups.
Chapter 12 Command Line Interface Reference aaa authentication iscsi aaa authentication iscsi To configure authentication, authorization and accounting (AAA) authentication services for iSCSI authentication of IP hosts requesting access to storage via SCSI routing instances, use the aaa authentication iscsi command. To disable this authentication, use the no form of this command. aaa authentication iscsi {listname | default} services1 [services2...
Chapter 12 Command Line Interface Reference aaa authentication iscsi In a cluster environment, AAA management functions are handled by a single storage router. To determine which storage router is performing AAA management functions, issue the show cluster command. If you issue the aaa authentication iscsi command from a storage router that is not performing AAA management functions, the CLI displays an informational message with the name of the node that is currently handling those functions.
Chapter 12 Command Line Interface Reference aaa authentication iscsi Related Commands Command Description aaa group server radius Create a named group of RADIUS servers for AAA authentication services. aaa group server tacacs+ Create a named group of TACACS+ servers for AAA authentication services. aaa test authentication Enable testing of the specified AAA authentication list. debug aaa Enable debugging for the AAA authentication services.
Chapter 12 Command Line Interface Reference aaa authentication login aaa authentication login To configure authentication, authorization and accounting (AAA) authentication services for Monitor mode access to the storage router via the CLI, use the aaa authentication login command. To disable this authentication, use the no form of this command. aaa authentication login default services1 [services2...
Chapter 12 Command Line Interface Reference aaa authentication login If the Enable service is used, the user name is ignored and the password is authenticated against the configured Administrator mode password. If the Monitor service is used, the user name is ignored and the password is authenticated against the configured Monitor mode password. Note AAA does not provide authentication for access via the GUI (using HTTP or HTTPS). Use the show aaa command to display the current authentication lists.
Chapter 12 Command Line Interface Reference aaa authentication login Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa group server radius Create a named group of RADIUS servers for AAA authentication services. aaa group server tacacs+ Create a named group of RADIUS servers for AAA authentication services.
Chapter 12 Command Line Interface Reference aaa generate password aaa generate password To generate a long random password, use the aaa generate password command. aaa generate password Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Use this command to generate a long random password.
Chapter 12 Command Line Interface Reference aaa group server radius aaa group server radius To create a named group of RADIUS servers to be used for AAA authentication, use the aaa group server radius command. To disable an existing group of RADIUS servers, use the no form of this command. aaa group server radius name no aaa group server radius name Syntax Description name Defaults None. All configured RADIUS servers belong to the group named radius. Command Modes Administrator.
Chapter 12 Command Line Interface Reference aaa group server radius Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa group server radius deadtime Specify the length of time the storage router can skip a RADIUS server in the named group that is marked as unavailable.
Chapter 12 Command Line Interface Reference aaa group server radius deadtime aaa group server radius deadtime To improve RADIUS response time when some servers might be unavailable, use the aaa group server radius deadtime command to cause the storage router to skip the unavailable servers in the specified group immediately. To set the dead time to 0, effectively preventing the storage router from skipping any RADIUS server in the specified group, use the no form of this command.
Chapter 12 Command Line Interface Reference aaa group server radius deadtime The following example effectively sets a dead time of zero minutes for all RADIUS servers in the group named region6. The global dead time value, if set, will apply to all RADIUS server in the group. [SN5428-2A]# no aaa group server radius region6 deadtime Related Commands Command Description radius-server deadtime Specify the length of time the storage router can skip a RADIUS server that is marked as unavailable.
Chapter 12 Command Line Interface Reference aaa group server radius server aaa group server radius server To add a RADIUS server to a named group of RADIUS servers to be used for AAA authentication, use the aaa group server radius server command. To remove a RADIUS server from an existing group of RADIUS servers, use the no form of this command.
Chapter 12 Command Line Interface Reference aaa group server radius server Examples The following example identifies the servers with IP address 10.5.0.53 and 10.6.0.61 as RADIUS servers, using the default port for authentication. It creates a RADIUS server group named region2 and adds the previously configured RADIUS servers to the region2 group. [SN5428-2A]# [SN5428-2A]# [SN5428-2A]# [SN5428-2A]# [SN5428-2A]# radius-server host 10.5.0.53 radius-server host 10.6.0.
Chapter 12 Command Line Interface Reference aaa group server tacacs+ aaa group server tacacs+ To create a named group of TACACS+ servers to be used for AAA authentication, use the aaa group server tacacs+ command. To disable an existing group of TACACS+ servers, use the no form of this command. aaa group server tacacs+ name no aaa group server tacacs+ name Syntax Description name Defaults None. All configured TACACS+ servers belong to the group named tacacs+. Command Modes Administrator.
Chapter 12 Command Line Interface Reference aaa group server tacacs+ Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference aaa group server tacacs+ server aaa group server tacacs+ server To add a TACACS+ server to a named group of TACACS+ servers to be used for AAA authentication, use the aaa group server tacacs+ server command. To remove a RADIUS server from an existing group of TACACS+ servers, use the no form of this command.
Chapter 12 Command Line Interface Reference aaa group server tacacs+ server Examples The following example identifies the servers with IP address 172.29.39.46 and 10.7.0.72 as TACACS+ servers, using the default port for authentication. It creates a TACACS+ server group named region3 and adds the previously configured TACACS+ servers to the region3 group. [SN5428-2A]# [SN5428-2A]# [SN5428-2A]# [SN5428-2A]# [SN5428-2A]# tacacs-server host 172.29.39.46 tacacs-server host 10.7.0.
Chapter 12 Command Line Interface Reference aaa new-model aaa new-model To enable the AAA access control model, issue the aaa new-model command. aaa new-model no aaa new-model Syntax Description This command has no arguments or keywords. Defaults AAA is enabled. AAA cannot be disabled on the SN 5428-2 Storage Router. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines This command enables the AAA access control model.
Chapter 12 Command Line Interface Reference aaa new-model Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference aaa test authentication aaa test authentication To test authentication using the specified authentication list, use the aaa test authentication command. aaa test authentication {enable | login} default username password aaa test authentication iscsi {listname | default} username password aaa test authentication cancel Syntax Description enable default Use the services in the Enable authentication list for testing. The name of the list must be default.
Chapter 12 Command Line Interface Reference aaa test authentication Examples The following example tests iSCSI authentication using the default authentication list for the user named user1, with a password of password1: [SN5428-2A]# aaa test authentication iscsi default user1 password1 The following example tests iSCSI authentication using the authentication list named webtest1, for the user named user2, with a password of password2: [SN5428-2A]# aaa test authentication iscsi webtest1 user2 password2 T
Chapter 12 Command Line Interface Reference accesslist accesslist To create an access list entity, use the accesslist command. accesslist name Syntax Description name Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The name of the access list entity created by this command. Enter a maximum of 31 characters.
Chapter 12 Command Line Interface Reference accesslist Examples The following command creates an access list named webserver2: [SN5428-2A]# accesslist webserver2 Related Commands Command Description accesslist A.B.C.D/bits Add IP addresses to an access list. accesslist chap-username Add CHAP user name entries to an access list. accesslist description Add a description to an access list. accesslist iscsi-name Add iSCSI Name entries to an access list.
Chapter 12 Command Line Interface Reference accesslist A.B.C.D/bits accesslist A.B.C.D/bits To add the IP address and subnet mask of IP hosts to the named access list, use the accesslist A.B.C.D/bits command. 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 The name of an access list to which you are adding information. A.B.C.D/bits IP address and subnet mask of the IP host being added to the access list.
Chapter 12 Command Line Interface Reference accesslist A.B.C.D/bits In a cluster environment, access list management functions are handled by a single storage router. To determine which storage router is performing access list management functions, issue the show cluster command. If you issue an accesslist A.B.C.
Chapter 12 Command Line Interface Reference accesslist chap-username accesslist chap-username To add the CHAP user name of IP hosts to the named access list, use the accesslist chap-username command. accesslist name chap-username username Syntax Description name The name of an access list to which you are adding information. username The CHAP user name (used for iSCSI authentication purposes) configured for the IP host that requires access to storage. Defaults None. Command Modes Administrator.
Chapter 12 Command Line Interface Reference accesslist chap-username Note If there is a CHAP user name entry in the access list, the SCSI routing instance used to access the storage target must also have iSCSI authentication enabled. See Chapter 9, “Configuring Authentication” for more information about AAA and iSCSI authentication. In a cluster environment, access list management functions are handled by a single storage router.
Chapter 12 Command Line Interface Reference accesslist description accesslist description To add a description to an existing access list entity, use the accesslist description command. accesslist name description “text” Syntax Description name The name of an existing access list entity. text User-defined identification information associated with this access list. Enclose the description string in quotes. Enter a maximum of 64 characters. Defaults None. Command Modes Administrator.
Chapter 12 Command Line Interface Reference accesslist description Examples The following command adds a description to the access list named webserver2: [SN5428-2A]# accesslist webserver2 description “Access list for company web servers” Related Commands Command Description accesslist Create an access list entity. accesslist A.B.C.D/bits Add IP addresses to an access list. accesslist chap-username Add CHAP user name entries to an access list.
Chapter 12 Command Line Interface Reference accesslist iscsi-name accesslist iscsi-name To add the iSCSI Name of IP hosts to the named access list, use the accesslist iscsi-name command. accesslist name iscsi-name string Syntax Description name The name of an access list to which you are adding information. string The iSCSI Name of IP host that requires access to storage. The iSCSI Name is a UTF-8 character string based on iSCSI functional requirements.
Chapter 12 Command Line Interface Reference accesslist iscsi-name In a cluster environment, access list management functions are handled by a single storage router. To determine which storage router is performing access list management functions, issue the show cluster command.
Chapter 12 Command Line Interface Reference admin contactinfo admin contactinfo To provide basic contact information for the system administrator of this SN 5428-2 Storage Router, use the admin contactinfo command. admin contactinfo [name “string” | email “string” | phone “string” | pager “string”] admin contact info name “string” email “string” phone “string” pager “string” Syntax Description name string (Optional) The name of the storage router administrator.
Chapter 12 Command Line Interface Reference admin contactinfo Related Commands Command Description admin password Set the login password for administrative access to the storage router management interface. restore system Restore selected system information from the named configuration file. save all Save all configuration information, including the system administrator contact information.
Chapter 12 Command Line Interface Reference admin password admin password To set the password used for administrative access to the SN 5428-2 Storage Router management interface, use the admin password command. Access may be via Telnet or SSH (for CLI), or web-based GUI. admin password string Syntax Description string Defaults The default password is cisco. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference admin password The following example sets the Administrator mode password to “xZm! 673”: [SN5428-2A]# admin password “xZm! 673” Related Commands Command Description aaa generate password Generate a long random password. enable Enter Administrator mode. exit Leave Administrator mode and enter Monitor mode. monitor password Set the login password for view-only access to the storage router management interface.
Chapter 12 Command Line Interface Reference cdp enable cdp enable To enable Cisco Discovery Protocol (CDP) on the SN 5428-2 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 Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference cdp holdtime cdp holdtime To specify the amount of time the receiving device should hold a CDP packet from the SN 5428-2 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 nn Defaults The default holdtime is 180 seconds. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference cdp interface 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 if-name The name of the interface for which you are enabling or disabling CDP. CDP can be enabled on the management (mgmt), HA, and Gigabit Ethernet (ge2) interfaces.
Chapter 12 Command Line Interface Reference cdp timer cdp timer To specify the amount of time between transmissions of CDP packets from the SN 5428-2 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 nn Defaults The default is 60 seconds. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference clear conf 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 Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference clear conf 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. See Chapter 2, “First-Time Configuration,” for more information about initial system configuration. Note Examples The clear conf wizard will not reset any Secure Shell (SSH) public and private key pairs generated for the storage router.
Chapter 12 Command Line Interface Reference clear conf {all | system} 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 all Remove all storage router configuration information, including system configuration settings, saved configuration files, SCSI routing and FCIP instances, access lists, and cluster configuration settings.
Chapter 12 Command Line Interface Reference clear conf {all | system} Note Examples The clear conf command will not reset any Secure Shell (SSH) public and private key pairs generated for the storage router. Use the ssh keygen command to generate new SSH keys after the storage router is restored to the selected factory default settings. The following example removes all storage router configuration information, returning the storage router to its initial default configuration.
Chapter 12 Command Line Interface Reference clear counters fcip 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 Release Modification 3.3.1 This command was introduced.
Chapter 12 Command Line Interface Reference clear counters interface 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 if-name The name of the interface.
Chapter 12 Command Line Interface Reference clear counters scsirouter 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 name The name of the SCSI routing instance for which counters will be cleared. all Clear counters for all SCSI routing instances.
Chapter 12 Command Line Interface Reference clear fcswitch 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 | zones {fabric | local}} Syntax Description devlog The switch development log file. syslog The switch system log file. zones Zoning changes received from switches in the fabric and stored by the SN 5428-2 Storage Router.
Chapter 12 Command Line Interface Reference clear fcswitch The following example clears all saved zoning information from the storage router local zoning database: [SN5428-2A]# clear fcswitch zones local The following example clears the local zoning database and deactivates the active zone set for the entire fabric: [SN5428-2A]# clear fcswitch zones fabric Related Commands Command Description fcswitch devlog Specify logging parameters for the switch development log file.
Chapter 12 Command Line Interface Reference clear log clear log To clear the SN 5428-2 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 Release Modification 3.2.1. This command was introduced.
Chapter 12 Command Line Interface Reference clear logging table clear logging table To clear the SN 5428-2 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 Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1. This command was introduced.
Chapter 12 Command Line Interface Reference clear scsirouter failover 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.
Chapter 12 Command Line Interface Reference clear scsirouter failover Related Commands Command Description failover scsirouter Cause the named SCSI routing instance to cease running on the storage router. scsirouter failover Add the storage router to the HA failover list for the specified SCSI routing instance.
Chapter 12 Command Line Interface Reference clear scsirouter primary 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 name Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The name of the SCSI routing instance.
Chapter 12 Command Line Interface Reference clear static 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 iscsibindings all Clear all IP host to FC address mappings.
Chapter 12 Command Line Interface Reference clear static The 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 all Related Commands Command Description show static Display the currently configured IP host to FC address mappings saved in the storage router.
Chapter 12 Command Line Interface Reference clock set 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 Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference clock timezone clock timezone To specify the time zone for the storage router, use the clock timezone command. clock timezone {string | ?} Syntax Description string A character string representing the time zone of the storage router. For example, America/Chicago or Europe/Amsterdam. ? Display a list of all valid time zones. Use any time zone in this list for the string parameter to set the storage router to that time zone. Defaults None.
Chapter 12 Command Line Interface Reference copy 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.
Chapter 12 Command Line Interface Reference copy 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.xml The following example copies the script file SN5428-2_Lab from a server named acme.
Chapter 12 Command Line Interface Reference debug aaa debug aaa To enable debugging for authentication, authorization, and accounting (AAA) services, use the debug aaa command. To disable debugging for AAA authentication services, use the no form of this command. debug aaa no debug aaa Syntax Description This command has no arguments or keywords. Defaults Debugging is not enabled. Command Modes Administrator. Command History Release Modifications 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference debug aaa Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference debug cmd debug cmd To run any operating system command with up to five arguments from the CLI, use the debug cmd command. debug cmd os-command [parameters] Syntax Description os-command Any valid operating system command. Do not invoke interactive functions. parameters Up to five command parameters. Defaults None. Command Modes Administrator. Command History Release Modifications 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference debug fcip debug fcip To enable trace facilities for debugging FCIP instances, use the debug fcip command. To disable debugging, use the no form of this command. debug fcip name {mailboxtrace | packettrace mask} no debug fcip name mailboxtrace Syntax Description name The name of the FCIP instance to be debugged. mailboxtrace Keyword, indicating that mail box tracing services will be enabled.
Chapter 12 Command Line Interface Reference debug fcip The following example disables debug mail box tracing services for the FCIP instance named fcip1: [SN5428-2A]# no debug fcip fcip1 mailboxtrace The following example turns off all packet tracing services for the FCIP instance named fcip2: [SN5428-2A]# debug fcip fcip2 packettrace 0x0000 Related Commands Command Description fcip Create an FCIP instance. fcip destination config Configure operational parameters for the named FCIP instance.
Chapter 12 Command Line Interface Reference debug interface debug interface To specify the maximum number of firmware dump files that can exist on the storage router for a specified initiator interface, or to remove all existing firmware dump files, use the debug interface command. debug interface if-name {forcefcfwdump | lldrestartfcfw} debug interface if-name fwdumpcount nn debug interface if-name removefwdumps Syntax Description if-name Enable IP trace for the FC initiator interfaces.
Chapter 12 Command Line Interface Reference debug interface Examples The following example sets the maximum number of times the firmware dump files for fci1 can be overwritten to 2: [SN5428-2A]# debug interface fci1 fwdumpcount 2 The following example clears all firmware dump files for fci2: [SN5428-2A]# debug interface fci2 removefwdumps Related Commands Command Description show debug Display a variety of debug information or perform specific troubleshooting activities.
Chapter 12 Command Line Interface Reference debug interface fc? debug interface fc? To configure a variety of operational parameters for the internal FC interface switch ports, use the debug interface fc? command. To disable various parameters, use the no form of this command.
Chapter 12 Command Line Interface Reference debug interface fc? Defaults loopback external Keywords, indicating an external test will be performed. The specified port must be in a diagnostic state. loopback internal Keywords, indicating an internal test will be performed. The specified port must be in a diagnostic state. loopback online Keywords, indicating an online loopback test will be performed. The specified port must be enabled.
Chapter 12 Command Line Interface Reference debug interface fc? Command History Usage Guidelines Caution Examples Release Modification 3.2.1 This command was introduced. The debug interface fc? command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional. Changing operational characteristic for the interface FC switch ports can cause unexpected behavior in the storage router.
Chapter 12 Command Line Interface Reference debug interface ge? debug interface ge? To enable packet tracing on a Gigabit Ethernet interface, use the debug interface ge? command. To disable packet tracing, use the no form of this command. debug interface ge? trace [pktcnt nn] [pktsize nn] enable no debug interface ge? trace enable Syntax Description ge? Enable IP trace for the specified Gigabit Ethernet interface. When you type the debug interface ge? command, the CLI lists the interfaces available.
Chapter 12 Command Line Interface Reference debug interface ge? Examples The following example enables IP packet tracing on the ge2 interface: [SN5428-2A]# debug interface ge2 trace enable The following example enables IP packet tracing on ge1, for a maximum of 100 packets. A maximum of 200 bytes will be traced per packet.
Chapter 12 Command Line Interface Reference debug ip rip debug ip rip To enable routing information protocol (RIP) debug log message, use the debug ip rip command. To disable RIP debug log message, use the no form of this command. debug ip rip no debug ip rip Syntax Description This command has no arguments or keywords. Defaults RIP debug log messages are disabled. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference debug ip rip Related Commands Command Description ip rip enable Enable the storage router to learn dynamic routing using the routing information protocol (RIP). show ip Display entries from the SN 5428-2 Storage Router routing table, and statistics about the protocols used in the storage router network. Use the rip keyword to display RIP configuration information.
Chapter 12 Command Line Interface Reference debug scsirouter debug scsirouter To enable trace facilities for debugging SCSI routing instances, use the debug scsirouter command. To disable debugging, use the no form of this command. debug scsirouter name scsitrace no debug scsirouter name scsitrace Syntax Description name The name of the SCSI routing instance to be debugged. scsitrace Keyword indicating tracing services will be enabled. Defaults All trace facilities are enabled by default.
Chapter 12 Command Line Interface Reference debug scsirouter iscsitrace debug scsirouter iscsitrace To enable trace facilities for debugging iSCSI connections to and from SCSI routing instances, use the debug scsirouter iscsitrace command. To disable iSCSI trace facilities, use the no form of this command. debug scsirouter name iscsitrace [fromto {A.B.C.D/bits | A.B.C.D/1.2.3.
Chapter 12 Command Line Interface Reference debug scsirouter iscsitrace Examples The following example enables iSCSI trace facilities for the SCSI routing instance named zeus, using the default iSCSI trace options: [SN5428-2A]# debug scsirouter zeus iscsitrace enable Related Commands Command Description debug scsirouter Enable debugging for the named SCSI routing instance. debug scsirouter target Enable debugging for a specific SCSI routing instance target and LUN combination.
Chapter 12 Command Line Interface Reference debug scsirouter target debug scsirouter target To enable trace facilities for debugging a specific SCSI routing instance target and LUN combination, use the debug scsirouter target command. To disable debugging, use the no debug scsirouter target form of this command. debug scsirouter name target name lun nn scsitrace no debug scsirouter name target name lun nn scsitrace Syntax Description name The name of the SCSI routing instance to be debugged.
Chapter 12 Command Line Interface Reference delete accesslist delete accesslist To delete an entire access list, all access lists, or a specified entry from the named access list, use the delete accesslist command. This command does not change the persistent storage router configuration until the relevant configuration information has been saved using the appropriate save command with the bootconfig keyword. delete accesslist all delete accesslist name [A.B.C.D/bits | A.B.C.D/1.2.3.
Chapter 12 Command Line Interface Reference delete accesslist 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 instance is running within the high availability cluster. • Use the delete accesslist name all to clear all entries from the access list, but retain the access list entity.
Chapter 12 Command Line Interface Reference delete accesslist The following example deletes the specified iSCSI Name from the named accesslist, fooList4. This command does not update the bootable configuration of the storage router until a save accesslist bootconfig or save all bootconfig command is issued. [SN5428-2A]# delete fooList4 iscsi-name ign.1987-05.com.cisco.01.8838a325b4017f Related Commands Command Description accesslist Create an access list entity. accesslist A.B.C.
Chapter 12 Command Line Interface Reference delete fcalias delete fcalias To delete the named alias, or the specified member WWPN from the named alias, use the delete fcalias command. delete fcalias alias-name [member wwpn xxxxxxxxxxxxxxxx] Syntax Description alias-name The name of the alias. member wwpn xxxxxxxxxxxxxxxx The WWPN of the alias member. Note WWPN address notation is represented by 16 hex digits. The digits may be separated by colons.
Chapter 12 Command Line Interface Reference delete fcalias The following example deletes the member WWPN 21000004ed4105ab from the alias AliasFoo: [SN5428-2A]# delete fcalias AliasFoo member wwpn 21000004ed4105ab Related Commands Command Description fcalias Create an alias entity for use in Fibre Channel zoning. fcalias member Add the specified member to the named alias. show fcalias Display information about aliases and their members.
Chapter 12 Command Line Interface Reference delete fcip delete fcip To delete the named elements from the FCIP instance, or to delete the named instance or all FCIP instances, use the delete fcip command. This command does not change the persistent storage router configuration until the relevant configuration information has been saved using the appropriate save command with the bootconfig keyword.
Chapter 12 Command Line Interface Reference delete fcip Related Commands Command Description fcip Create an FCIP instance. show fcip Display configuration and operational information for the named FCIP instance.
Chapter 12 Command Line Interface Reference delete logging delete logging To delete a rule from the logging table, use the delete logging command. delete logging level notification-level from facility-name delete logging #? delete logging #nn Syntax Description level notification-level The notification level of the routing rules entry to be deleted. See Table 12-4 in the Usage Guidelines section for a list of valid names that can be used for the notification-level argument.
Chapter 12 Command Line Interface Reference delete logging Table 12-4 Logging Level Notification Levels and Corresponding Numbers Note Notification Level Level Number Description emergency 0 System unusable alert 1 Immediate action needed critical 2 Critical conditions error 3 Error conditions warning 4 Non-fatal warning conditions notice 5 Normal but significant conditions info 6 Informational messages only debug 7 Information for troubleshooting purposes The debug notificat
Chapter 12 Command Line Interface Reference delete logging Use the save system bootconfig or save all bootconfig commands to save the updated logging table. Examples The following example displays the logging table and then deletes the routing rule entry for messages at level info from facility all: [SN5428-2A]# show logging Logging is enabled Index Level 1 info 2 debug Priority Facility 6 all 7 HA Route console logfile logfile rslog Syslog host is enabled, ip-address is 10.1.1.
Chapter 12 Command Line Interface Reference delete savedconfig delete savedconfig To remove the named file from the savedconfig directory, use the delete savedconfig command. delete savedconfig {filename | all} Syntax Description filename The name of the configuration file to be deleted. This file must exist in the savedconfig directory. all Keyword, indicating that all configuration files in the savedconfig directory are to be deleted. Defaults None. Command Modes Administrator.
Chapter 12 Command Line Interface Reference delete script delete script To remove the named command file from the script directory, use the delete script command. delete script {filename | all} Syntax Description filename The name of the command file to be deleted. This file must exist in the script directory. all Keyword, indicating that all command files in the script directory are to be deleted. Defaults None. Command Modes Administrator. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference delete script Related Commands Command Description copy Copy the named configuration or script file from a remote location to the storage router, or from the storage router to a remote location. read script Read and execute the CLI commands in the named script file. restore all Restore the contents of the named configuration file into memory. save all Save all configuration information. save system Save selected system configuration information.
Chapter 12 Command Line Interface Reference delete scsirouter delete scsirouter To delete the named elements from the SCSI routing instance, use the delete scsirouter command. This command does not change the persistent storage router configuration until the relevant configuration information has been saved using the appropriate save command with the bootconfig keyword.
Chapter 12 Command Line Interface Reference delete scsirouter Usage Guidelines In a cluster environment, changes to the SCSI routing instance can only be made on the storage router that is the currently running that instance. The SCSI routing instance may be in a stopped state at the time it is deleted. The force option allows the SCSI routing instance to be deleted from a storage router that is not currently running the instance.
Chapter 12 Command Line Interface Reference delete scsirouter Related Commands Command Description restore scsirouter Restore the named SCSI routing instance from the named configuration file. save scsirouter Save configuration information for the named SCSI routing instance. scsirouter Create a SCSI routing instance. scsirouter enable Start and stop the named SCSI routing instance.
Chapter 12 Command Line Interface Reference delete software version delete software version To delete a version of software from the storage router, use the delete software version command. Note The version of software currently running and the version that will be booted when the system is restarted may not be deleted. delete software version {v.x.y | all} Syntax Description v.x.y The version of storage router software to be deleted. all Delete all non-bootable and non-current software versions.
Chapter 12 Command Line Interface Reference delete zone delete zone To delete the specified Fibre Channel (FC) zone or the specified member of the zone from the zoning database, use the delete zone command. delete zone name [member {fcalias alias-name | fcid port-id | wwpn xxxxxxxxxxxxxxxx}] Syntax Description name The name of the zone. member (Optional) Keyword, indicating the specified zone member will be deleted. fcalias alias-name Deletes the named alias member from the named zone.
Chapter 12 Command Line Interface Reference delete zone Examples The following example deletes the zone named testlab from the zoning database: [SN5428-2A]# delete zone testlab The following example deletes the alias member myfoo from the zone webservices: [SN5428-2A]# delete zone webservices member fcalias myfoo Related Commands Command Description show zone Display configuration and operational information for Fibre Channel fabric zones from the local zoning database.
Chapter 12 Command Line Interface Reference delete zoneset delete zoneset To delete the specified zone from the zone set or to delete the entire named zone set from the zoning database, use the delete zoneset command. delete zoneset name [zone name] Syntax Description name The name of the zone set. zone name (Optional) Deletes the named zone from the specified zone set. Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference delete zoneset Related Commands Command Description show zone Display configuration and operational information for Fibre Channel fabric zones from the local zoning database. show zoneset Display configuration and operational information for Fibre Channel fabric zone sets. zone Create a Fibre Channel fabric zone. zone member Add a device or an alias to a zone. zoneset Create a Fibre Channel fabric zone set.
Chapter 12 Command Line Interface Reference download software download software To fetch the specified object from the named location or the default download location, use the download software list command. download software {http | proxy} {list | url full_url | version v.x.y} download software tftp {hostname host filename file | list | version v.x.y} Syntax Description http Download using the HTTP protocol. proxy Download using a proxy server.
Chapter 12 Command Line Interface Reference download software Note Examples While the size of the software file may vary, it will exceed 16 MB. Some older TFTP implementations have a 16 MB download limitation. The following example downloads storage router software version 3.3.1-K9 from the default location via standard Hypertext Transfer Protocol (HTTP): [SN5428-2A]# download software http version 3.3.1-K9 The following example downloads a file named sn5428-2v331.
Chapter 12 Command Line Interface Reference enable enable To change the management session from Monitor mode to Administrator mode, use the enable command. Monitor mode, which is the default mode, provides view-only access to the storage router management interface. Administrator mode allows you 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.
Chapter 12 Command Line Interface Reference exit 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. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Issue the exit command to return to Monitor mode after previously issuing the enable command.
Chapter 12 Command Line Interface Reference failover eligibility failover eligibility To enable failover by eligibility for all SCSI routing instances running on the storage router, use the failover eligibility command. To disable failover by eligibility, use the no form of this command. failover eligibility on no failover eligibility on Syntax Description on Defaults Failover by eligibility is enabled. Command Modes Administrator mode. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference failover eligibility Examples The following example disables failover by eligibility for all SCSI routing instances running on the storage router named SN 5428-2A: [SN5428-2A] no failover eligibility on Related Commands Command Description failover scsirouter Cause the named SCSI routing instance to cease running on the storage router. show ha Display HA operational statistics for the storage router or for a specific application.
Chapter 12 Command Line Interface Reference failover scsirouter failover scsirouter To cause the named SCSI routing instance to cease running on this storage router and start running on another storage router in the cluster, use the failover scsirouter command. Note If no eligible storage router is found, the SCSI routing instance will start running again on the same node. If the storage router is configured as a standalone system, failover is not allowed.
Chapter 12 Command Line Interface Reference failover scsirouter Related Commands Command Description scsirouter enable Stop or start the named SCSI routing instance. scsirouter failover Add the storage router to the HA failover list for the specified SCSI routing instance. setup cluster Change the configuration of the high availability environment.
Chapter 12 Command Line Interface Reference fcalias fcalias To create an alias entity for use in Fibre Channel zoning, use the fcalias command. An alias is a group of FC ports or devices (such as switches, storage or SN 5428-2 Storage Routers) that are grouped together for convenience. fcalias alias-name Syntax Description alias-name Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference fcalias member fcalias member To add the specified member to the named alias, use the fcalias member command. An alias is a group of FC ports or devices (such as switches, storage or SN 5428-2 Storage Routers) that are grouped together for convenience. fcalias alias-name member wwpn xxxxxxxxxxxxxxxx Syntax Description alias-name The name of the alias entity.
Chapter 12 Command Line Interface Reference fcalias member Related Commands Command Description delete fcalias Delete the named alias or the specified alias member. fcalias Create an alias entity for use in Fibre Channel zoning. show fcalias Display information about aliases and their members. zone member Add a device or an alias to a zone.
Chapter 12 Command Line Interface Reference fcip fcip To create an FCIP instance, use the fcip command. fcip name Syntax Description name Defaults None. Command Modes Administrator. Command History Release Modification 3.3.1 This command was introduced. Usage Guidelines The name of the FCIP instance. Valid named are fcip1 and fcip2. FCIP provides connectivity between SANs.
Chapter 12 Command Line Interface Reference fcip Examples The following example creates an FCIP instance named fcip1: [SN5428-2A]# fcip fcip1 Related Commands Command Description clear counters fcip Reset accumulated operational statistics for the specified SCSI routing instance. delete fcip Delete the named FCIP instance or the specified element of the FCIP instance. delete fcip Enable debugging for the named FCIP instance.
Chapter 12 Command Line Interface Reference fcip description fcip description To add user-defined identification information to the named FCIP instance, use the fcip description command. fcip name description “user text” Syntax Description name The name of this FCIP instance. Valid named are fcip1 and fcip2. “user text” User-defined identification information associated with this FCIP instance. If the string contains spaces, enclose it in quotes. Enter a maximum of 64 characters. Defaults None.
Chapter 12 Command Line Interface Reference fcip destination config fcip destination config To configure operational parameters for the selected FCIP connection protocol type, use the fcip destination config command.
Chapter 12 Command Line Interface Reference fcip destination config burstouthiwater nn The maximum number of bytes that can be transmitted on a raw IP connection. Valid values are from 1 to 4294967294, inclusive. The default value is 2097152. This configuration option applies to raw IP connections only. frouthiwater nn The maximum number of frames that can be outstanding on a raw IP connection. Valid values are from 1 to 4294967294, inclusive. The default value is 1024.
Chapter 12 Command Line Interface Reference fcip destination config Defaults idlepingdelay nn The number of seconds before a keep-alive packet is sent across an idle connection. Valid values are 1 to 65535, inclusive. The default value is 60. This configuration option applies to all FCIP connection types. pkttracemask mask The value of the packet trace mask, in hex. Packets are traced for debugging problems. Valid values are 0 (0x0000) to 0xffff. A value of zero disables packet tracing.
Chapter 12 Command Line Interface Reference fcip destination config Command History Usage Guidelines Release Modification 3.3.1 This command was introduced. Each FCIP instance requires three active elements: • The networkif element assigns an interface and IP address for use by the FCIP peer. • The destination element assigns the peer’s protocol and IP address.
Chapter 12 Command Line Interface Reference fcip destination config 3. For error recovery using timeoutincrement, initialtimeout and rexmitcount: – timeout = initialtimeout /* initial calculation */ – timeout = timeout * timeoutincrement /* subsequent calculations */ For example, using a timeoutincrement value of 2, an initialtimeout value of 8, and a rexmitcount of 4 would result in retransmissions at 8, 16, 32 and 64 ticks. 4.
Chapter 12 Command Line Interface Reference fcip destination raw fcip destination raw To add a peer destination to the named FCIP instance, with a connection type of raw IP, use the fcip destination raw command. fcip name destination name raw A.B.C.D Syntax Description name The name of the FCIP instance. Valid names are fcip1 and fcip2. destination name The name of the peer destination. Enter a maximum of 31 characters. A.B.C.D The IP address of the peer destination. A.B.C.
Chapter 12 Command Line Interface Reference fcip destination raw Examples The following example configures the FCIP instance named fcip1 with a destination named lucky at IP address 10.1.3.47, using raw IP connection protocol: [SN5428-2A]# fcip fcip1 destination lucky raw 10.1.3.47 Related Commands Command Description fcip Create an FCIP instance. fcip destination config Configure operational parameters for the named FCIP instance.
Chapter 12 Command Line Interface Reference fcip destination tcpclient fcip destination tcpclient To add a peer destination to the named FCIP instance, with a connection type of TCP/IP, use the fcip destination tcpclient command. The named FCIP instance will initiate the TCP connection. fcip name destination name tcpclient A.B.C.D Syntax Description name The name of the FCIP instance. Valid names are fcip1 and fcip2. destination name The name of the peer destination.
Chapter 12 Command Line Interface Reference fcip destination tcpclient Note Examples When configuring an FCIP instance, you must configure the network interface before you configure the peer destination and protocol. The following example configures the FCIP instance named fcip2 with a destination named lucky2 at IP address 10.1.4.32, using TCP/IP connection protocol. The FCIP instance is configured as a TCP client, and will initiate the TCP connection to the destination.
Chapter 12 Command Line Interface Reference fcip destination tcpserver fcip destination tcpserver To add a peer destination to the named FCIP instance, with a connection type of TCP/IP, use the fcip destination tcpserver command. The named FCIP instance will listen for the TCP connection from the named destination. fcip name destination name tcpserver A.B.C.D Syntax Description name The name of the FCIP instance. Valid names are fcip1 and fcip2. destination name The name of the peer destination.
Chapter 12 Command Line Interface Reference fcip destination tcpserver Note Examples When configuring an FCIP instance, you must configure the network interface before you configure the peer destination and protocol. The following example configures the FCIP instance named fcip1 with a destination named dest1 at IP address 10.1.5.222, using TCP/IP connection protocol. The FCIP instance is configured as a TCP server, and will listen for the TCP connection from the destination.
Chapter 12 Command Line Interface Reference fcip enable fcip enable To start the named FCIP instance on this SN 5428-2 Storage Router, use the fcip enable command. To stop the named FCIP instance, use the no form of this command. fcip {name | all} enable no fcip {name | all} enable Syntax Description name The name of the FCIP instance to be started. Valid names are fcip1 and fcip2. all Start all FCIP instances on this storage router. Defaults None. Command Modes Administrator.
Chapter 12 Command Line Interface Reference fcip enable Related Commands Command Description delete fcip Delete the named FCIP instance or the specified element of the FCIP instance. fcip Create an FCIP instance. show fcip Display configuration and operational information for the named FCIP instance.
Chapter 12 Command Line Interface Reference fcip networkif fcip networkif To assign a Gigabit Ethernet interface and IP address to the named FCIP instance, use the fcip networkif command. The specified interface provides IP connectivity between the FCIP instance and its peer destination. fcip name networkif {A.B.C.D/bits | A.B.C.D/1.2.3.4} [secondary] Syntax Description name Name of the FCIP instance to which you are adding the Gigabit Ethernet interface. Valid names are fcip1 and fcip2. A.B.C.
Chapter 12 Command Line Interface Reference fcip networkif Note Each FCIP instance must connect to a unique peer SN 5428-2 Storage Router. If you have two FCIP instances running in a single storage router, you cannot connect both instances to the same peer SN 5428-2 Storage Router. Use this command to configure an IP address for the FCIP instance, to be used by the FCIP peer for IP connectivity.
Chapter 12 Command Line Interface Reference fcip networkif Related Commands Command Description fcip Create an FCIP instance. fcip destination config Configure operational parameters for the named FCIP instance. fcip destination raw Add a peer destination to the named FCIP instance, with a connection type of raw IP. fcip destination tcpclient Add a peer destination to the named FCIP instance, with a connection type of TCP/IP. The named FCIP instance initiates the TCP connection.
Chapter 12 Command Line Interface Reference fcswitch beacon enable fcswitch beacon enable To enable all Fibre Channel port Logged-In (LOG) LEDs to flash, use the fcswitch beacon enable command. To disable LOG LED flashing, use the no form of this command. fcswitch beacon enable no fcswitch beacon enable Syntax Description This command has no arguments or keywords. Defaults Beacon flashing is disabled, by default.
Chapter 12 Command Line Interface Reference fcswitch devlog fcswitch devlog To specify the logging parameters for the SN 5428-2 Storage Router integrated Fibre Channel (FC) switch component development log file, use the fcswitch devlog command. fcswitch devlog components component1 [component2...] fcswitch devlog level notification-level Syntax Description components component1 [component2...] At least one of the components described in Table 12-6.
Chapter 12 Command Line Interface Reference fcswitch devlog Table 12-6 fcswitch devlog components (continued) Component Description Swb Software bus internal process communications mechanism. Util Utility message interpreter for handling legacy user interfaces. Table 12-7 fcswitch devlog notification-level Examples Notification Level Description Critical Log all messages from the selected components (critical, warning and informational).
Chapter 12 Command Line Interface Reference fcswitch devlog enable fcswitch devlog enable To start development logging for the SN 5428-2 Storage Router integrated Fibre Channel (FC) switch component, use the fcswitch devlog enable command. To stop development logging, use the no form of this command. fcswitch devlog enable no fcswitch devlog enable Syntax Description This command has no arguments or keywords. Defaults Development logging is stopped. Command Modes Administrator.
Chapter 12 Command Line Interface Reference fcswitch diag fcswitch diag To set all Fibre Channel (FC) interfaces into diagnostic mode for testing purposes, use the fcswitch diag command. fcswitch diag Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference fcswitch domainid fcswitch domainid To set the SN 5428-2 Storage Router’s domain ID for switched zoned fabric to a unique value, and to prevent the FC fabric from changing that domain ID, use the fcswitch domainid command. To disable the lock and allow the domain ID to be changed by the switched zoned fabric, use the no form of this command.
Chapter 12 Command Line Interface Reference fcswitch domainid Examples The following example sets the switched zoned fabric domain ID for the storage router to 42: [SN5428-2A]# fcswitch domainid 42 *** Warning: Changing domain ID in an operational fabric will cause traffic disruption Do you want to continue? [(yes/no (no)] yes The following example sets the switched zoned fabric domain ID for the storage router to 5 and enables the lock, which prevents the domain ID from being changed by the zoned fabri
Chapter 12 Command Line Interface Reference fcswitch dstov fcswitch dstov To specify the amount of time the storage router is to wait for Fibre Channel (FC) Distributed Services, use the fcswitch dstov command. fcswitch dstov {nn | default} Syntax Description nn The Distributed Services timeout value, in milliseconds. default Keyword, indicating the storage router is to wait 5000 milliseconds for Fibre Channel Distributed Services.
Chapter 12 Command Line Interface Reference fcswitch edtov fcswitch edtov To specify an error detect timeout value for all Fibre Channel (FC) interfaces, use the fcswitch edtov command. fcswitch edtov {nn | default} Syntax Description nn The amount of time a port is to wait for errors to clear, in milliseconds. default Keyword, indicating the port is to wait 2000 milliseconds for errors to clear. Defaults The default error detect timeout value is 2000 milliseconds. Command Modes Administrator.
Chapter 12 Command Line Interface Reference fcswitch enable fcswitch enable To enable all Fibre Channel (FC) interfaces, use the fcswitch enable command. To disable all FC interfaces, use the no form of this command. fcswitch enable no fcswitch enable Syntax Description This command has no arguments or keywords. Defaults All FC interfaces are enabled, by default. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference fcswitch enable Related Commands Command Description fcswitch diag Set all FC interfaces into diagnostic mode for testing purposes. interface fc? diag Set the named FC interface into diagnostic mode for testing purposes. interface fc? enable Enable the named FC interface. interface fc? loopback Initiate a loopback test on the named FC interface. show fcswitch Display global configuration information for storage router FC interfaces.
Chapter 12 Command Line Interface Reference fcswitch fstov fcswitch fstov To specify the fabric services timeout value, use the fcswitch fstov command. fcswitch fstov {nn | default} Syntax Description nn The amount of time the storage router is to wait for fabric services, in milliseconds. default Keyword, indicating the storage router will wait for 1000 milliseconds for fabric services. Defaults The default fabric stability timeout value is 1000 milliseconds. Command Modes Administrator.
Chapter 12 Command Line Interface Reference fcswitch interop-credit fcswitch interop-credit To set the buffer-to-buffer credit value for all Fibre Channel (FC) ports, use the fcswitch interop-credit command. fcswitch interop-credit credit Syntax Description credit Defaults The data buffer credit capacity is 12, by default. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference fcswitch interop-credit Related Commands Command Description fcswitch domainid Set the domain ID for the storage router, to be used for FC switched fabric zoning. fcswitch enable Enable all FC interfaces. fcswitch zoning autosave Configure the storage router to participate in FC switched zones. fcswitch zoning default Select the level of communication between the storage router and devices in the fabric where there is no active zone set.
Chapter 12 Command Line Interface Reference fcswitch log interface fcswitch log interface To restrict the SN 5428-2 Storage Router integrated Fibre Channel (FC) switch logging to information related to a specific FC interface, use the fcswitch log interface command. fcswitch log interface {if-name | default} Syntax Description if-name The name of the FC interface for which you are setting this parameter. Valid values are fc1 through fc8.
Chapter 12 Command Line Interface Reference fcswitch ratov fcswitch ratov To specify a Fibre Channel (FC) resource allocation timeout value for the storage router, use the fcswitch ratov command. fcswitch ratov {nn | default} Syntax Description nn The amount of time the storage router is to wait to allow two FC ports to allocate enough resources to establish a link.
Chapter 12 Command Line Interface Reference fcswitch syslog fcswitch syslog To specify the logging parameters for the SN 5428-2 Storage Router integrated Fibre Channel (FC) switch component system log file, use the fcswitch syslog command. fcswitch syslog components component1 [component2...] fcswitch syslog level notification-level Syntax Description components component1 [component2...] At least one of the components described in Table 12-8.
Chapter 12 Command Line Interface Reference fcswitch syslog Table 12-9 fcswitch syslog notification level Examples Notification Level Description Critical Log all messages from the selected components (critical, warning and informational). Warn Log all warning and informational messages for the selected components. Info Log informational messages only for the selected components. None Log no messages. This setting stops switch system logging.
Chapter 12 Command Line Interface Reference fcswitch syslog enable fcswitch syslog enable To start system logging for the SN 5428-2 Storage Router integrated Fibre Channel (FC) switch component, use the fcswitch syslog enable command. To stop system logging, use the no form of this command. fcswitch syslog enable no fcswitch syslog enable Syntax Description This command has no arguments or keywords. Defaults System logging for the integrated FC switch component is started, by default.
Chapter 12 Command Line Interface Reference fcswitch zoning autosave fcswitch zoning autosave To enable the SN 5428-2 Storage Router to automatically save zoning changes received from switches in the fabric, use the fcswitch zoning autosave command. To prevent the storage router from saving zoning changes, use the no form of this command. fcswitch zoning autosave enable no fcswitch zoning autosave enable Syntax Description autosave enable Defaults The storage router saves zoning changes by default.
Chapter 12 Command Line Interface Reference fcswitch zoning autosave Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. fcswitch domainid Set the domain ID for the storage router, to be used for FC switched fabric zoning. fcswitch enable Enable all FC interfaces. fcswitch interop-credit Set the data buffer credit capacity for all FC ports.
Chapter 12 Command Line Interface Reference fcswitch zoning default fcswitch zoning default To select the level of communication between the storage router and devices in the fabric when there is no active zone set, use the fcswitch zoning default command. fcswitch zoning default {all | none} Syntax Description default all Enables the storage router to communicate with all switches and other devices in the fabric when there is no active zone set. This is the default.
Chapter 12 Command Line Interface Reference fcswitch zoning default Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. fcswitch domainid Set the domain ID for the storage router, to be used for FC switched fabric zoning. fcswitch enable Enable all FC interfaces. fcswitch interop-credit Set the data buffer credit capacity for all FC ports.
Chapter 12 Command Line Interface Reference fcswitch zoning merge fcswitch zoning merge To set zoning merge compliance, use the fcswitch zoning merge command. fcswitch zoning merge sw2 Syntax Description sw2 Defaults The SN 5428-2 Storage Router is FC-SW-2 compliant, and is configured to participate in a fabric with only FC-SW-2 compliant switches by default. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference fcswitch zoning merge Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. fcswitch domainid Set the domain ID for the storage router, to be used for FC switched fabric zoning. fcswitch enable Enable all FC interfaces. fcswitch interop-credit Set the data buffer credit capacity for all FC ports.
Chapter 12 Command Line Interface Reference halt halt To prepare the storage router to be powered down, issue the halt command. halt [force] [fast] Syntax Description force (Optional) Force an immediate halt of the SN 5428-2 Storage Router. fast (Optional) Bypass hardware diagnostics when the storage router is next restarted. Defaults If there are unsaved configuration changes when the command is issued, the default is to save all changes before halting.
Chapter 12 Command Line Interface Reference halt Examples The following prompt is received if you issue a halt command (without the force keyword) when the storage router has unsaved configuration changes. [SN5428-2A]# halt *** Warning: This will halt the system. Do you want to continue? [yes/no (no)] yes Changes have been made to the current configuration of the system which have not been saved.
Chapter 12 Command Line Interface Reference help help To display information on 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. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The help command displays information about the various CLI commands that can be issued, based on the mode currently in use.
Chapter 12 Command Line Interface Reference hostname hostname To specify a new system name for the SN 5428-2 Storage Router, use the hostname command. The storage router 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. hostname sysname Syntax Description sysname Defaults None. Command Modes Administrator. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference interface fc? al-fairness interface fc? al-fairness To enable the fairness algorithm (loop priority) on the named Fibre Channel (FC) interface, use the interface fc? al-fairness command. To disable the fairness algorithm on the named FC interface, use the no form of this command. interface fc? al-fairness enable no interface fc? al-fairness enable Syntax Description fc? The name of the FC interface for which you are setting this parameter.
Chapter 12 Command Line Interface Reference interface fc? al-fairness Related Commands Command Description interface fc? default Return the named FC interface to its default operational characteristics. interface fc? fan-enable Enable Fabric Address Notification (FAN) on the named FC interface. interface fc? linkspeed Set the transfer rate for the named FC interface. interface fc? mfs-bundle Enable Multi-Frame Sequence bundling for the named FC interface.
Chapter 12 Command Line Interface Reference interface fc? default interface fc? default To return the named Fibre Channel (FC) interface to its default operational characteristics, use the interface fc? default command. interface fc? default Syntax Description fc? Defaults The following are the default operational characteristics for the Fibre Channel interface: The name of the FC interface to be returned to its default operational characteristics. Valid values are fc1 through fc8.
Chapter 12 Command Line Interface Reference interface fc? default Note Examples All storage routers in a cluster should be configured with the same interface-specific parameters, allowing failover of SCSI routing instances to provide consistent performance characteristics.
Chapter 12 Command Line Interface Reference interface fc? diag interface fc? diag To set the named Fibre Channel (FC) interface into diagnostic mode for testing purposes, use the interface fc? diag command. interface fc? diag Syntax Description fc? Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Examples The name of the FC interface to be placed into diagnostic mode. Valid values are fc1 through fc8.
Chapter 12 Command Line Interface Reference interface fc? diag Related Commands Command Description fcswitch diag Set all FC interfaces into diagnostic mode for testing purposes. fcswitch enable Enable all FC interfaces. interface fc? enable Enable the named FC interface. interface fc? loopback Initiate a loopback test on the named FC interface. interface fc? reset Disable and then enable the specified FC interface.
Chapter 12 Command Line Interface Reference interface fc? enable interface fc? enable To enable the named Fibre Channel (FC) interface, use the interface fc? enable command. To disable the named FC interface, use the no form of this command. interface fc? enable no interface fc? enable Syntax Description fc? Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The name of the FC interface to be enabled.
Chapter 12 Command Line Interface Reference interface fc? enable Related Commands Command Description fcswitch diag Set all FC interfaces into diagnostic mode for testing purposes. fcswitch enable Enable all FC interfaces. interface fc? diag Set the named FC interface into diagnostic mode for testing purposes. interface fc? loopback Initiate a loopback test on the named FC interface. interface fc? reset Disable and then enable the specified FC interface.
Chapter 12 Command Line Interface Reference interface fc? ext-credit interface fc? ext-credit To configure the specified interface for credit extension, use the interface fc? ext-credit command. interface fc? ext-credit nn Syntax Description fc? The name of the interface to receive the additional buffer credits. Valid values are fc1 through fc8. When you type the interface fc? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.
Chapter 12 Command Line Interface Reference interface fc? ext-credit Examples The following example sets the port type for interface fc1 to F_Port, sets the port type for interface fc8 as donor (making 11 extended credits available to the interface fc1), and configures interface fc1 for credit extension: [SN5428-2A]# interface fc8 type donor *[SN5428-2A]# interface fc1 type f-port *[SN5428-2A]# interface fc1 ext-credit 11 The following example makes the interface fc1 unavailable for credit extension: [S
Chapter 12 Command Line Interface Reference interface fc? fan-enable interface fc? fan-enable To enable Fabric Address Notification (FAN) on the named Fibre Channel (FC) interface, use the interface fc? fan-enable command. To disable FAN on the named FC interface, use the no form of this command. interface fc? fan-enable enable no interface fc? fan-enable enable Syntax Description fc? The name of the FC interface for which you are setting this parameter. Valid values are fc1 through fc8.
Chapter 12 Command Line Interface Reference interface fc? fan-enable Related Commands Command Description interface fc? al-fairness Enable the fairness algorithm on the named FC interface. interface fc? default Return the named FC interface to its default operational characteristics. interface fc? linkspeed Set the transfer rate for the named FC interface. interface fc? mfs-bundle Enable Multi-Frame Sequence bundling for the named FC interface.
Chapter 12 Command Line Interface Reference interface fc? linkspeed interface fc? linkspeed To set the transfer rate for the named Fibre Channel (FC) interface, use the interface fc? linkspeed command. interface fc? linkspeed {auto | 1gb | 2gb} Syntax Description fc? The name of the FC interface for which you are setting this parameter. Valid values are fc1 through fc8. When you type the interface fc? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.
Chapter 12 Command Line Interface Reference interface fc? linkspeed Related Commands Command Description interface fc? al-fairness Enable the fairness algorithm on the named FC interface. interface fc? default Return the named FC interface to its default operational characteristics. interface fc? fan-enable Enable Fabric Address Notification (FAN) on the named FC interface. interface fc? mfs-bundle Enable Multi-Frame Sequence bundling for the named FC interface.
Chapter 12 Command Line Interface Reference interface fc? loopback interface fc? loopback To initiate a loopback test on the named Fibre Channel (FC) interface, use the interface fc? loopback command. interface fc? loopback {external | internal | online} Syntax Description fc? The name of the FC interface to be tested. Valid values are fc1 through fc8. When you type the interface fc? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.
Chapter 12 Command Line Interface Reference interface fc? loopback The following example enables the FC interface fc3 and then performs an online loopback test: [SN5428-2A]# interface fc3 enable [SN5428-2A]# interface fc3 loopback online Related Commands Command Description fcswitch diag Set all FC interfaces into diagnostic mode for testing purposes. fcswitch enable Enable all FC interfaces. interface fc? diag Set the named FC interface into diagnostic mode for testing purposes.
Chapter 12 Command Line Interface Reference interface fc? mfs-bundle interface fc? mfs-bundle To enable Multi-Frame Sequence (MFS) bundling for the named Fibre Channel (FC) interface, use the interface fc? mfs-bundle command. To disable MFS bundling for the named FC interface, use the no form of this command. interface fc? mfs-bundle enable timeout nn no interface fc? mfs-bundle enable Syntax Description fc? The name of the FC interface for which you are setting this parameter.
Chapter 12 Command Line Interface Reference interface fc? mfs-bundle Related Commands Command Description interface fc? al-fairness Enable the fairness algorithm on the named FC interface. interface fc? default Return the named FC interface to its default operational characteristics. interface fc? fan-enable Enable Fabric Address Notification (FAN) on the named FC interface. interface fc? linkspeed Set the transfer rate for the named FC interface.
Chapter 12 Command Line Interface Reference interface fc? ms-enable interface fc? ms-enable To enable GS-3 management server commands for the specified Fibre Channel (FC) interface, use the interface fc? ms-enable command. To disable GS-3 management server commands, use the no form of this command. interface fc? ms-enable enable no interface fc? ms-enable enable Syntax Description fc? The name of the FC interface for which you are setting this parameter. Valid values are fc1 through fc8.
Chapter 12 Command Line Interface Reference interface fc? reset interface fc? reset To disable and then enable the specified Fibre Channel (FC) interface, use the interface fc? reset command. interface fc? reset Syntax Description fc? Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The name of the FC interface for which you are setting this parameter. Valid values are fc1 through fc8.
Chapter 12 Command Line Interface Reference interface fc? rscn interface fc? rscn To enable the generation of Registered State Control Notification (RSCN) messages on the specified Fibre Channel (FC) interface, use the interface fc? rscn command. To disable RSCN messages, use the no form of this command. interface fc? rscn enable no interface fc? rscn enable Syntax Description fc? The name of the FC interface for which you are setting this parameter. Valid values are fc1 through fc8.
Chapter 12 Command Line Interface Reference interface fc? type interface fc? type To set the port type for the named Fibre Channel interface, use the interface fc? type command. interface fc? type {auto | f-port | fl-port | g-port | gl-port} interface fc? type tl-port mode {autobridge | autolearn} interface fc? type donor Syntax Description fc? The name of the FC interface for which you are setting this parameter. Valid values are fc1 through fc8.
Chapter 12 Command Line Interface Reference interface fc? type • A GL_Port configures as an FL_Port when connected to a loop of public devices, an F_Port when connected to a single device, or an E_Port when connected to another SN 5428-2 or an FC-SW-2 compliant switch. A GL_Port may also configure as an E_Port when connected to a switch running non-FC-SW-2 compliant firmware.
Chapter 12 Command Line Interface Reference interface fc? type Related Commands Command Description interface fc? al-fairness Enable the fairness algorithm on the named FC interface. interface fc? default Return the named FC interface to its default operational characteristics. interface fc? ext-credit Configure the specified interface as a potential recipient of donated data buffer credits. interface fc? fan-enable Enable Fabric Address Notification (FAN) on the named FC interface.
Chapter 12 Command Line Interface Reference interface fci? devicediscoverytimer interface fci? devicediscoverytimer To enable the SN 5428-2 Storage Router internal Fibre Channel (FC) interfaces to perform background device rediscovery for all attached FC targets at specific time intervals, use the interface fci? devicediscoverytimer command. interface fci? devicediscoverytimer nn Syntax Description fci? The name of the internal FC interface. Valid values are fci1 or fci2.
Chapter 12 Command Line Interface Reference interface fci? devicediscoverytimer Use the show interface command with the stats keyword to display the current device rediscovery timer configuration. In the following example, the storage router will perform background device rediscovery every 10 minutes. [SN5428-2B]# show interface fci1 stats loop: LOOP READY connection: F Port Data Rate: 2 Gb/s port id: 0x20f00 ALPA: 0x0 firmware: READY device rediscovery timer: 10 minutes . . .
Chapter 12 Command Line Interface Reference interface ge? interface ge? To set various operational parameters associated with the Gigabit Ethernet interface, such as the size of the maximum transfer unit (MTU) or the use of VLANs, use the interface ge? command. To disable the use of VLANs, use the no form of this command. To specify that auto negotiation will never be used on this interface, use the interface ge? no autonegotiation command.
Chapter 12 Command Line Interface Reference interface ge? Examples The following example enables auto negotiation on the Gigabit Ethernet interface, ge1. The ge1 interface will not come up until auto negotiation is successfully completed. [SN5428-2A]# interface ge1 autonegotiation The following example disables VLANs for the Gigabit Ethernet interface, ge2: [SN5428-2A]# no interface ge2 vlan enable The following examples changes the MTU size for the Gigabit Ethernet interface, ge1, to 9000 bytes.
Chapter 12 Command Line Interface Reference interface ge? ip-address interface ge? ip-address To enable an IP address on a Gigabit Ethernet interface for management of the SN 5428-2 Storage Router, use the interface ge? ip-address command. To disable an IP address configured for storage router management, use the no form of this command. interface ge? [vlan vid] ip-address {A.B.C.D/bits | A.B.C.D/1.2.3.
Chapter 12 Command Line Interface Reference interface ge? ip-address In-band management is performed via a Telnet or Secure Shell (SSH) session, or via the web-based GUI. Only one IP address per logical interface can be configured for in-band management. Telnet, SSH, HTTP and SSL access is restricted, by default, on all Gigabit Ethernet interfaces. Use the no restrict CLI command to allow access to the storage router using the desired protocol via the specified Gigabit Ethernet interface.
Chapter 12 Command Line Interface Reference interface ge? ip-address Related Commands Command Description restrict Secure access to storage router interfaces by communications protocols and services. show interface Display operational and configuration information for the specified interface or all interfaces. show ip Display entries from the SN 5428-2 Storage Router routing table and statistics about the protocols used in the SN 5428-2 network.
Chapter 12 Command Line Interface Reference interface ha interface ha To set various operational parameters associated with the high availability (HA) interface, such as the speed and duplex mode, use the interface ha command. interface ha autonegotiation interface ha no autonegotiation [speed {10 | 100}] [duplex {full | half}] Syntax Description autonegotiation Auto negotiation will always be used on this interface. Operational characteristics will automatically be negotiated with the partner.
Chapter 12 Command Line Interface Reference interface ha Related Commands Command Description interface ha ip-address Specify the HA interface IP address and subnet mask. show interface Display operational and configuration information for the specified interface or all interfaces.
Chapter 12 Command Line Interface Reference interface ha ip-address interface ha ip-address To specify the IP address and subnet mask for this system’s high availability interface, use the interface ha ip-address command. interface ha ip-address {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 subnet mask in CIDR style. A.B.C.D/1.2.3.4 The IP address of the HA interface. A.
Chapter 12 Command Line Interface Reference interface ha ip-address Related Commands Command Description interface mgmt ip-address Specify the management interface IP address and subnet mask. save all Save all configuration information. save system Save selected system configuration information, including HA IP address. setup cluster Change the configuration of the high availability environment. show cluster Display cluster-related operational statistics, including heartbeat information.
Chapter 12 Command Line Interface Reference interface mgmt interface mgmt To set various operational parameters associated with the management interface, such as the speed and duplex mode, use the interface mgmt command. interface mgmt autonegotiation interface mgmt no autonegotiation [speed {10 | 100}] [duplex {full | half}] Syntax Description autonegotiation Auto negotiation will always be used on this interface. Operational characteristics will automatically be negotiated with the partner.
Chapter 12 Command Line Interface Reference interface mgmt Related Commands Command Description interface mgmt ip-address Specify the management interface IP address and subnet mask. show interface Display operational and configuration information for the specified interface or all interfaces.
Chapter 12 Command Line Interface Reference interface mgmt ip-address interface mgmt ip-address To specify the IP address and subnet mask of the interface labeled MGMT on the front panel of the SN 5428-2 Storage Router, use the interface mgmt ip-address command. This address is used to manage the storage router via Telnet, Secure Shell (SSH), the web-based GUI, or SNMP. interface mgmt ip-address {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.
Chapter 12 Command Line Interface Reference interface mgmt ip-address Related Commands Command Description interface ha ip-address Specify the HA interface IP address and subnet mask. ip route Add a static route to the SN 5428-2 Storage Router routing table. save all Save all configuration information. save system Save selected system configuration information, including management and HA interface information. setup mgmt Run the wizard to configure the management interface.
Chapter 12 Command Line Interface Reference ip default-gateway ip default-gateway To add a gateway to the default route in the SN 5428-2 Storage Router routing table, use the ip default-gateway command. To delete the gateway, use the no form of this command. ip default-gateway E.F.G.H [administrative-distance] no ip default-gateway [A.B.C.D] Syntax Description E.F.G.H The default gateway IP address. administrative-distance (Optional) The administrative distance for the route.
Chapter 12 Command Line Interface Reference ip default-gateway The following example adds a default route to gateway 10.3.30.1, with an administrative distance of 130, in the routing table. If RIP is enabled for the storage router, the default route can be overridden by a dynamically learned route. [SN5428-2A]# ip default-gateway 10.3.30.1 130 Related Commands Command Description ip route Add a static route to the SN 5428-2 Storage Router routing table.
Chapter 12 Command Line Interface Reference ip domain-name ip domain-name To specify the name of the SN 5428-2 Storage Router domain, use the ip domain-name command. To remove a domain name, use the no form of this command. ip domain-name name no ip domain-name Syntax Description name Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Note Examples The name of the SN 5428-2 Storage Router domain.
Chapter 12 Command Line Interface Reference ip name-server ip name-server To specify the IP address of the primary and optional secondary Domain Name Server (DNS), use the ip name-server command. To remove the settings for current domain name servers, use the no form of this command. ip name-server A.B.C.D [E.F.G.H] no ip name-server 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. E.F.
Chapter 12 Command Line Interface Reference ip radius sourceinterface ip radius sourceinterface To specify a single network interface to be used as the source IP address for all outgoing AAA authentication requests to RADIUS servers, use the ip radius sourceinterface command. To disable this restriction, use the no form of this command. ip radius sourceinterface if-name no ip radius sourceinterface Syntax Description if-name Defaults None. Command Modes Administrator.
Chapter 12 Command Line Interface Reference ip radius sourceinterface Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference ip rip enable ip rip enable To enable the SN 5428-2 Storage Router to learn dynamic routing using the routing information protocol (RIP), use the ip rip enable command. To disable dynamic routing via RIP, use the no form of this command. ip rip enable no ip rip enable Syntax Description This command has no arguments or keywords. Defaults RIP is disabled by default. Command Modes Administrator. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference ip rip enable Related Commands Command Description ip rip timers Configure various RIP timers. show ip Display entries from the SN 5428-2 Storage Router routing table, and statistics about the protocols used in the storage router network. Use the rip keyword to display RIP configuration information.
Chapter 12 Command Line Interface Reference ip rip timers ip rip timers To configure various RIP timers, use the ip rip timers command. ip rip timers invalid {nn | default} Syntax Description invalid nn Specifies the maximum time, in seconds, between updates before a route is expired and made a candidate for removal from the routing table. default Keyword, used to return the specified timer to the default value. The default invalid timer is180 seconds.
Chapter 12 Command Line Interface Reference ip rip timers Related Commands Command Description ip rip enable Enable the storage router to learn dynamic routing using the routing information protocol (RIP). show ip Display entries from the SN 5428-2 Storage Router routing table, and statistics about the protocols used in the storage router network. Use the rip keyword to display RIP configuration information.
Chapter 12 Command Line Interface Reference ip route ip route To add a static route to the SN 5428-2 Storage Router routing table, use the ip route command. The specified IP address is accessed via the gateway specified in the command. To remove a static route from the routing table, use the no form of this command. ip route {A.B.C.D/bits | A.B.C.D/1.2.3.4} E.F.G.H [administrative-distance] no ip route {A.B.C.D/bits | A.B.C.D/1.2.3.4} [E.F.G.H] Syntax Description A.B.C.
Chapter 12 Command Line Interface Reference ip route Note Examples A route is not added to the routing table until the associated IP gateway address is configured. The CLI displays an informational message if a route is added for an IP address that is not yet configured. The following command adds a unique route for IP address 10.1.30.0, specifying the subnet mask in dotted quad notation: [SN5428-2A]# ip route 10.1.30.0/255.255.255.0 10.1.10.
Chapter 12 Command Line Interface Reference ip tacacs sourceinterface ip tacacs sourceinterface To specify a single network interface to be used as the source IP address for all outgoing AAA authentication requests to TACACS+ servers, use the ip tacacs sourceinterface command. To disable this restriction, use the no form of this command. ip tacacs sourceinterface if-name no ip tacacs sourceinterface Syntax Description if-name Defaults None. Command Modes Administrator.
Chapter 12 Command Line Interface Reference ip tacacs sourceinterface Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference logging #? logging #? To insert a routing rules entry into the logging table before the specified entry, use the logging #? command. logging #? logging #nn level notification-level from facility-name to destination1 [destination2...] Syntax Description #? Request an indexed list of entries in the logging table. #nn The index number from the displayed list of entries. The new routing rule will be inserted before the specified logging table entry.
Chapter 12 Command Line Interface Reference logging #? The level limits logging to messages of the specified notification level or lower levels, based on level number. Table 12-10 describes the available logging levels.
Chapter 12 Command Line Interface Reference logging #? Table 12-11 Logging Level Facilities (continued) Facility Name Description UI User interface functions. VTP VTP and VLAN functions. Table 12-12 describes the available logging destinations. Table 12-12 Logging Level Destinations Destination Description all Logs to all destinations. none No logging occurs. console Logs to serial console CLI sessions. logfile Logs messages to the storage router log file.
Chapter 12 Command Line Interface Reference logging #? Related Commands Command Description clear logging table Clear the SN 5428-2 Storage Router logging table of all entries, or to reset the table to factory defaults. delete logging Delete a rule from the logging table. logging level Add rule entries to route storage router event, debug and trace messages to various destinations based on facility and notification level.
Chapter 12 Command Line Interface Reference logging level logging level To add a routing rule to the logging table, use the logging level command. logging level notification-level from facility-name to destination1 [destination2...] Syntax Description Defaults notification-level Limit logging to messages of a specified level or lower levels. See Table 12-13 in the Usage Guidelines section for a list of valid names that can be used for the notification-level argument.
Chapter 12 Command Line Interface Reference logging level Table 12-13 Logging Level Notification Levels and Corresponding Numbers Note Notification Level Level Number Description emergency 0 System unusable alert 1 Immediate action needed critical 2 Critical conditions error 3 Error conditions warning 4 Non-fatal warning conditions notice 5 Normal but significant conditions info 6 Informational messages only debug 7 Information for troubleshooting purposes The debug notificat
Chapter 12 Command Line Interface Reference logging level Table 12-15 describes the available logging destinations. Table 12-15 Logging Level Destinations Destination Description all Logs to all destinations. none No logging occurs. console Logs to console CLI sessions. logfile Logs messages to the storage router log file. rslog Logs messages to a remote syslog server. Use the logging syslog command to specify the IP address of the remote syslog server.
Chapter 12 Command Line Interface Reference logging level Related Commands Command Description clear logging table Clear the SN 5428-2 Storage Router logging table of all entries, or to reset the table to factory defaults. delete logging Delete a rule from the logging table. logging #? Insert a routing rule entry into the storage router logging table. logging on Enable or temporarily disable logging of storage router event message.
Chapter 12 Command Line Interface Reference logging on logging on To enable logging of SN 5428-2 Storage Router event messages based on the rules in the logging table, use the logging on command. To temporarily disable logging of all event messages, use the no form of this command. logging on no logging on Syntax Description This command has no arguments or keywords. Defaults Logging is enabled by default.
Chapter 12 Command Line Interface Reference logging on Related Commands Command Description clear logging table Clear the SN 5428-2 Storage Router logging table of all entries, or to reset the table to factory defaults. delete logging Delete a rule from the logging table. logging #? Insert a routing rule entry into the storage router logging table.
Chapter 12 Command Line Interface Reference logging syslog logging syslog To identify a remote syslog host to be used to log SN 5428-2 Storage Router event messages, use the logging syslog command. Use the no form of this command to disable remote logging. logging syslog A.B.C.D no logging syslog Syntax Description A.B.C.D Defaults Remote logging is disabled by default. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference logging syslog Related Commands Command Description clear logging table Clear the SN 5428-2 Storage Router logging table of all entries, or to reset the table to factory defaults. delete logging Delete a rule from the logging table. logging #? Insert a routing rule entry into the storage router logging table.
Chapter 12 Command Line Interface Reference logout logout To terminate 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. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference monitor password monitor password To set the password used for view-only access to the SN 5428-2 Storage Router management interface, use the monitor password command. Access may be via Telnet or SSH (for CLI) or web-based GUI. monitor password string Syntax Description string Defaults The default password is cisco. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference monitor password Related Commands Command Description aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI. aaa generate password Generate a long random password. admin password Set the login password for administrative access to the management interface. enable Enter Administrator mode. exit Leave Administration mode and enter Monitor mode.
Chapter 12 Command Line Interface Reference ntp peer ntp peer To specify the name or IP address of a Network Time Protocol (NTP) server with which the SN 5428-2 Storage Router will synchronize date and time, use the ntp peer command. To clear the current NTP server setting, use the no form of this command. ntp peer{A.B.C.D | server-name} no ntp peer 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.
Chapter 12 Command Line Interface Reference ntp peer Related Commands Command Description clock set Set the storage router system clock. clock timezone Specify the time zone associated with the storage router. ip route Add a static route to the SN 5428-2 Storage Router routing table. save all Save all configuration information. save system Save selected system information, including NTP server name. setup time Run the wizard to configure the system date and time.
Chapter 12 Command Line Interface Reference ping ping To verify communication with another SN 5428-2 Storage Router or system in the network, use the ping command. ping {ip-address | servername} [numpkts nn] [size sn] Syntax Description ip-address The IP address of another system or SN 5428-2 Storage Router. servername The name of another server. The storage router must be configured to use the services of a Domain Name Server (DNS).
Chapter 12 Command Line Interface Reference radius-server deadtime radius-server deadtime To improve RADIUS response time when some servers might be unavailable, use the radius-server deadtime command to cause the storage router to skip the unavailable servers immediately. To set the dead time to 0, effectively preventing the storage router from skipping any RADIUS server, use the no form of this command.
Chapter 12 Command Line Interface Reference radius-server deadtime Related Commands Command Description aaa group server radius deadtime Specify the length of time the storage router can skip a RADIUS server in the named group that is marked as unavailable. show aaa Display AAA configuration information.
Chapter 12 Command Line Interface Reference radius-server host radius-server host To specify a RADIUS server to be used for AAA authentication services, use the radius-server host command. To delete the specified RADIUS server, use the no form of this command. radius-server host ip-address [auth-port port-number] [timeout seconds] [retransmit retries] [key key-string] no radius-server host ip-address [auth-port port-number] Syntax Description ip-address The IP address of the RADIUS server.
Chapter 12 Command Line Interface Reference radius-server host Usage Guidelines AAA authentication services are used to provide the following authentication types: • iSCSI authentication—provides authentication of IP hosts requiring access to storage via SCSI routing instances • Login authentication—provides authentication of users requiring Monitor mode access to the storage router via the CLI • Enable authentication—provides authentication of users requiring Administrator mode access to the stora
Chapter 12 Command Line Interface Reference radius-server host Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference radius-server key radius-server key To set the authentication and encryption key to be used for all RADIUS communications between the SN 5428-2 Storage Router and the RADIUS daemon, use the radius-server key command. To disable the key, use the no form of this command. radius-server key key-string no radius-server key Syntax Description key-string Defaults None. Command Modes Administrator. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference radius-server key Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference radius-server retransmit radius-server retransmit To specify the number of times the SN 5428-2 Storage Router resends the RADIUS request to each server in the list of configured RADIUS servers after a timeout occurs, use the radius-server retransmit command. To disable retransmission, use the no form of this command.
Chapter 12 Command Line Interface Reference radius-server retransmit Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference radius-server timeout radius-server timeout To set the global interval that the SN 5428-2 Storage Router waits for a RADIUS server to reply, use the radius-server timeout command. To restore the default, use the no form of this command. radius-server timeout seconds no radius-server timeout Syntax Description seconds Defaults The timeout value defaults to five seconds. Command Modes Administrator. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference radius-server timeout Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference read script read script To read and execute the CLI commands in a command file, use the read script command. read script command-file [force [parameters]] Syntax Description command-file The name of the command file. The command file must exist in the script directory. force (Optional) Suppress warning prompts and messages and execute the script immediately. parameters (Optional) Pass one or more parameters to the specified script.
Chapter 12 Command Line Interface Reference read script Examples The following example reads and executes the CLI commands in the command file named myCommands. [SN5428-2A]# read script myCommands *** Warning: this script may change your configuration. Do you want to continue? [yes/no (yes)] yes Related Commands Command Description show bootconfig Display the bootable configuration, or create a command file based on the bootable configuration. show cli Display the syntax of CLI commands.
Chapter 12 Command Line Interface Reference reboot reboot To cause the SN 5428-2 Storage Router to shut down and then restart, issue the reboot command. Note Rebooting may cause the storage router to run a different version of software. See the software version command for details. reboot [force] [fast] Syntax Description fast (Optional) Force a soft reboot of the storage router, bypassing hardware diagnostics. force (Optional) Force an immediate reboot of the storage router.
Chapter 12 Command Line Interface Reference reboot Examples The following prompt is received if you issue a reboot command (without the force keyword) when the storage router has unsaved configuration changes. [SN5428-2A]# reboot *** Warning: This will reboot the system. Do you want to continue? [yes/no (no)] yes Changes have been made to the current configuration of the system which have not been saved.
Chapter 12 Command Line Interface Reference restore aaa restore aaa To cause the AAA authentication configuration to be copied from the specified configuration file into persistent memory, use the restore aaa command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, issue the show savedconfig command.
Chapter 12 Command Line Interface Reference restore aaa Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference restore accesslist restore accesslist 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 command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, issue the show savedconfig command.
Chapter 12 Command Line Interface Reference restore accesslist Examples The following example restores the access list named fooList from the saved configuration file named accessList_backup: [SN5428-2A]# restore accesslist fooList from accessList_backup Related Commands Command Description accesslist Create an access list entity. accesslist A.B.C.D/bits Add IP addresses to an access list. delete accesslist Delete a specific access list entry or an entire access list.
Chapter 12 Command Line Interface Reference restore all restore all To cause all the previously saved configuration information to be copied from the specified configuration file into persistent memory, use the restore all command. The configuration file must exist in the savedconfig directory. Use the show savedconfig command to display the contents of the savedconfig directory. Note This command may change the running configuration of the storage router.
Chapter 12 Command Line Interface Reference restore all Note Examples In a cluster environment, all AAA, access list, password, and VLAN management functions are handled by a single storage router. To determine which storage router is performing these management functions, issue the show cluster command.
Chapter 12 Command Line Interface Reference restore fcip restore fcip To cause the previously saved configuration information related to the named FCIP instance to be copied from the specified configuration file into the bootable configuration, use the restore fcip command. The configuration file must exist in the savedconfig directory. Use the show savedconfig command to display the contents of the savedconfig directory. Note This does not change the running configuration of the storage router.
Chapter 12 Command Line Interface Reference restore fcip Related Commands Command Description fcip Create an FCIP instance. fcip enable Stop or start the named FCIP instance. save fcip Save configuration information for the named FCIP instance. show fcip Display configuration and operational information for the named FCIP instance.
Chapter 12 Command Line Interface Reference restore fcswitch restore fcswitch To cause the previously saved configuration information associated with the SN 5428-2 Storage Router Fibre Channel (FC) interfaces to be copied from the specified configuration file into the bootable configuration, use the restore fcswitch command. The configuration file must exist in the savedconfig directory. Use the show savedconfig command to display the contents of the savedconfig directory.
Chapter 12 Command Line Interface Reference restore fcswitch Use the interface keyword to restore configuration information for each FC port, including: • State of the interface (enabled or disabled) • Fairness algorithm • FAN • MFS bundling and associated timeout value • Transfer rate (linkspeed) • Port type Use the zones keyword to restore the internal zoning database, including: Caution Examples • Aliases and alias members • Zones and zone members • Zone sets and zone set members •
Chapter 12 Command Line Interface Reference restore fcswitch Related Commands Command Description delete fcalias Delete the named alias or the specified alias member. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or to delete the entire named zone set from the zoning database. fcalias Create an alias entity for use in Fibre Channel zoning.
Chapter 12 Command Line Interface Reference restore scsirouter restore scsirouter To cause the previously saved configuration information related to the named SCSI routing instance to be copied from the specified configuration file into the bootable configuration, use the restore scsirouter command. The configuration file must exist in the savedconfig directory. Use the show savedconfig command to display the contents of the savedconfig directory.
Chapter 12 Command Line Interface Reference restore scsirouter Related Commands Command Description failover scsirouter Cause the named SCSI routing instance to cease running on the storage router. restore accesslist Restore the named access list or all access lists from the named configuration file. restore all Restore the contents of the named configuration file into memory. save accesslist Save configuration data for the named access list or all access lists.
Chapter 12 Command Line Interface Reference restore system restore system To cause previously saved system configuration information to be copied from the specified configuration file into persistent memory, use the restore system command. The configuration file must exist in the savedconfig directory. Use the show savedconfig command to display the contents of the savedconfig directory. restore system {name | all} from filename Syntax Description name The named system information to be restored.
Chapter 12 Command Line Interface Reference restore system Usage Guidelines Table 12-16 describes the named system information that can be restored. Table 12-16 Restore System Named System Information Named System Configuration Description cdp Restore CDP configuration. contactinfo Restore administrator contact information. ip-route Restore the route table and RIP settings. logging Restore the routing rules in the storage router event message logging table.
Chapter 12 Command Line Interface Reference restore system The following example restores the logging table from the saved configuration file system_backup: [SN5428-2A]# restore system logging from system_backup The following example restores the SNMP configuration information from the saved configuration file sys_SN5428-2A: [SN5428-2A]# restore system snmp from sys_SN5428-2A Related Commands Commands Description delete savedconfig Remove a saved configuration file from the storage router.
Chapter 12 Command Line Interface Reference restore vlan restore vlan To cause the specified VLAN to be copied from the named configuration file into persistent memory, use the restore vlan command. The configuration file must exist in the savedconfig directory. To display the contents of the savedconfig directory, issue the show savedconfig command.
Chapter 12 Command Line Interface Reference restore vlan Related Commands Command Description save vlan Save configuration information for the named VLAN or all VLANs scsirouter serverif Assign a Gigabit Ethernet interface, IP address, and optionally a VLAN to the named SCSI routing instance. show savedconfig List the contents of the savedconfig directory or the contents of the named configuration file.
Chapter 12 Command Line Interface Reference restrict restrict To close access to the specified interface via the named service, use the restrict command. To allow access via the named service, use the no form of this command. restrict all [service] restrict interface {service | all} no restrict all [service] no restrict interface {service | all} Syntax Description Defaults interface Restrict access to the specified interface.
Chapter 12 Command Line Interface Reference restrict Table 12-17 restrict interface Interface Keyword Description ge? The Gigabit Ethernet interfaces (including all logical interfaces created by associating a VLAN with a Gigabit Ethernet IP address for a SCSI routing instance). All services are restricted on the Gigabit Ethernet interfaces by default. ha The HA interface. This interface is open to HTTP by default. mgmt The management interface.
Chapter 12 Command Line Interface Reference restrict Table 12-18 restrict interface service (continued) Service Keyword Description ssl Secure Socket Layer. SSL is restricted on all interfaces by default. telnet Telnet. Telnet access is enabled on the management interface by default; it is restricted on all other interfaces. Note The Telnet server is started by default. Use the no telnet enable command to stop the Telnet server (disabling access via Telnet) without changing the restrict settings.
Chapter 12 Command Line Interface Reference restrict console restrict console To enable password checking on the SN 5428-2 Storage Router console interface, use the restrict console command. The Administrator mode and Monitor mode passwords will be required when accessing the storage router via a console connected to the EIA/TIA-232 port. To disable password checking on the console interface, use the no form of this command.
Chapter 12 Command Line Interface Reference save aaa save aaa To save the current AAA settings to nonvolatile memory, use the save aaa command. save aaa {filename | bootconfig} Syntax Description filename The name of the file where the AAA configuration information will be written. This file is stored in the savedconfig directory. bootconfig Save the AAA settings to the bootable configuration, which is used when the SN 5428-2 Storage Router is restarted.
Chapter 12 Command Line Interface Reference save aaa Examples The following example saves the running AAA settings to the bootable configuration, used when the storage router is restarted: [SN5428-2A]# save aaa bootconfig The following example saves the running AAA settings to a file named aaa_SN5428-2A: [SN5428-2A]# save aaa aaa_SN5428-2A Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Route
Chapter 12 Command Line Interface Reference save accesslist save accesslist To save configuration data to nonvolatile memory for the named accesslist or for all access lists, use the save accesslist command. save accesslist {name | all} {filename | bootconfig} Syntax Description name The name of the access list to be saved. all Save all access lists. filename The name of the file where the running access list configuration data will be written. This file is stored in the savedconfig directory.
Chapter 12 Command Line Interface Reference save accesslist Examples The following example saves the current configuration for all access lists to the bootable configuration, used when the storage router is restarted: [SN5428-2A]# save accesslist all bootconfig The following example saves the access list fooList to a configuration file named fooList_SN5428-2A: [SN5428-2A]# save accesslist fooList fooList_SN5428-2A Related Commands Command Description accesslist Create an access list entity.
Chapter 12 Command Line Interface Reference save all save all To save all configuration data for the SN 5428-2 Storage Router to nonvolatile memory, use the save all command. save all {filename | bootconfig} Syntax Description filename The name of the file where the configuration data will be written. This file is stored in the savedconfig directory. bootconfig Save the current running configuration information to the bootable configuration, used when the SN 5428-2 Storage Router is restarted.
Chapter 12 Command Line Interface Reference save all The following example saves the current running configuration to the file named SN5428-2A_03Nov2001. You may want to do this as a means of archiving the current running configuration of the storage router on a regular basis. [SN5428-2A]# save all SN5428-2A_03Nov2001 Related Commands Command Description delete savedconfig Remove a saved configuration file from the storage router.
Chapter 12 Command Line Interface Reference save fcip save fcip To save all configuration data associated with the named FCIP instance to nonvolatile memory, use the save fcip command. save fcip {name | all} {filename | bootconfig} Syntax Description name The name of the FCIP instance. Valid names are fcip1 and fcip2. all Save configuration data for all FCIP instances. filename The name of the file where the configuration data will be written. This file is stored in the savedconfig directory.
Chapter 12 Command Line Interface Reference save fcswitch save fcswitch To save all configuration data for the SN 5428-2 Storage Router Fibre Channel (FC) interfaces to nonvolatile memory, use the save fcswitch command. save fcswitch {filename | bootconfig} Syntax Description filename The name of the file where the configuration data will be written. This file is stored in the savedconfig directory.
Chapter 12 Command Line Interface Reference save fcswitch Related Commands Command Description delete fcalias Delete the named alias or the specified alias member. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or to delete the entire named zone set from the zoning database. fcalias Create an alias entity for use in Fibre Channel zoning.
Chapter 12 Command Line Interface Reference save scsirouter save scsirouter To save all configuration data associated with the named SCSI routing instance to nonvolatile memory, use the save scsirouter command. save scsirouter {name | all} {filename | bootconfig} Syntax Description name The name of the SCSI routing instance. all Save configuration data for all SCSI routing instances. filename The name of the file where the configuration data will be written.
Chapter 12 Command Line Interface Reference save scsirouter Related Commands Commands Description delete savedconfig Remove a saved configuration file from the storage router. delete scsirouter Delete the named SCSI routing instance or the specified element of the SCSI routing instance. restore scsirouter Restore the named SCSI routing instance from the named configuration file. save aaa Save the current AAA configuration information.
Chapter 12 Command Line Interface Reference save system save system To save selected system configuration information to nonvolatile memory, use the save system command. save system {filename | bootconfig} Syntax Description filename The name of the file where the system configuration data will be written. This file is stored in the savedconfig directory. bootconfig Save the current running system configuration to the bootable configuration, used when the SN 5428-2 Storage Router is restarted.
Chapter 12 Command Line Interface Reference save system Examples • Configuration information for the Gigabit Ethernet interfaces • Management session timeout value • Secure Shell (SSH) settings The following example saves the current system configuration to the bootable configuration, used when the storage router is restarted: [SN5428-2A]# save system bootconfig The following example copies the current system configuration to the file named sys_SN5428-2A: [SN5428-2A]# save system sys_SN5428-2A R
Chapter 12 Command Line Interface Reference save vlan save vlan To save VLAN and VTP configuration information for the specified VLAN or for all VLANs to nonvolatile memory, use the save vlan command. save vlan {vid | all} {filename | bootconfig} Syntax Description vid The VLAN identification number of the VLAN configuration to be saved. all Save all VLANs associated with this storage router. filename The name of the file where the current VLAN configuration data will be written.
Chapter 12 Command Line Interface Reference save vlan Related Commands Command Description restore vlan Restore VLAN configuration information from the named configuration file. save aaa Save current AAA configuration information. save accesslist Save configuration data for the named access list or all access lists. save all Save all configuration information. save scsirouter Save configuration information for the named SCSI routing instance.
Chapter 12 Command Line Interface Reference scsirouter scsirouter To create a SCSI routing instance, use the scsirouter command. scsirouter name Syntax Description name Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The name of the SCSI routing instance created by this command. Enter a maximum of 31 characters.
Chapter 12 Command Line Interface Reference scsirouter Related Commands Command Description accesslist Create an access list entity. delete scsirouter Delete the named SCSI routing instance or the specified element of the SCSI routing instance. failover scsirouter Cause the named SCSI routing instance to cease running on the storage router. restore accesslist Restore the named access list or all access lists from the named configuration file.
Chapter 12 Command Line Interface Reference scsirouter authentication scsirouter authentication To enable iSCSI authentication using the specified AAA authentication services for the named SCSI routing instance, use the scsirouter authentication command. scsirouter name authentication {listname | default | none} Syntax Description name The name of this SCSI routing instance. listname Enable AAA authentication using the specified iSCSI authentication list.
Chapter 12 Command Line Interface Reference scsirouter authentication Related Commands Command Description aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. debug aaa Enable debugging for the AAA authentication services. radius-server host Configure remote RADIUS servers for AAA authentication services. restore aaa Restore AAA authentication services from the named configuration file.
Chapter 12 Command Line Interface Reference scsirouter cdbretrycount scsirouter cdbretrycount To specify the number of times a failed command should be retried before returning an error on the CDB, use the scsirouter cdbretrycount command. scsirouter name cdbretrycount nn Syntax Description name The name of this SCSI routing instance. nn The number of CDB retries. nn is an integer from 0 to 512. The default value is 6. There is one second between retries.
Chapter 12 Command Line Interface Reference scsirouter description scsirouter description To add user-defined identification information to the named SCSI routing instance, use the scsirouter description command. scsirouter name description “user text” Syntax Description name The name of this SCSI routing instance. “user text” User-defined identification information associated with this SCSI routing instance. If the string contains spaces, enclose it in quotes. Enter a maximum of 64 characters.
Chapter 12 Command Line Interface Reference scsirouter enable scsirouter enable To start the named SCSI routing instance on this SN 5428-2 Storage Router, use the scsirouter enable command. To stop the named SCSI routing instance, use the no form of this command. scsirouter {name | all} enable no scsirouter {name | all} enable Syntax Description name The name of the SCSI routing instance to be started. all Start all SCSI routing instances on this storage router. Defaults None.
Chapter 12 Command Line Interface Reference scsirouter enable Related Commands Command Description delete scsirouter Delete the named SCSI routing instance or the specified element of the SCSI routing instance. failover scsirouter Cause the named SCSI routing instance to cease running on the storage router. restore scsirouter Restore the named SCSI routing instance from the named configuration file. save scsirouter Save configuration information for the named SCSI routing instance.
Chapter 12 Command Line Interface Reference scsirouter failover scsirouter failover To build a list of storage routers to be used for failover purposes, use the scsirouter failover command. scsirouter name failover {primary | secondary} sysname Syntax Description name The name of the SCSI routing instance. primary sysname The name of the storage router in the cluster. In case of failure, the specified SCSI routing instance will be failed over to this storage router.
Chapter 12 Command Line Interface Reference scsirouter failover Examples The following example builds the HA failover list for the SCSI routing instance named foo. The primary storage router in the HA failover list is SN5428-2A. [SN5428-2A]# scsirouter foo failover primary SN5428-2A Related Commands Command Description clear scsirouter failover Remove the designated primary or secondary storage router from the HA failover list for the specified SCSI routing instance.
Chapter 12 Command Line Interface Reference scsirouter lun reset scsirouter lun reset To specify that “LUN reset” rather than “clear task” commands will be sent to the storage resources opened by the specified SCSI routing instance, use the scsirouter lun reset command. scsirouter name lun reset {yes | no} Syntax Description name The name of the SCSI routing instance. The specified SCSI routing instance must be running. yes Send “lun reset” to storage resources when they are opened.
Chapter 12 Command Line Interface Reference scsirouter lun reset Related Commands Command Description delete scsirouter Delete the named SCSI routing instance or the specified element of the SCSI routing instance. restore scsirouter Restore the named SCSI routing instance from the named configuration file. save scsirouter Save configuration information for the named SCSI routing instance. scsirouter Create a SCSI routing instance.
Chapter 12 Command Line Interface Reference scsirouter password scsirouter password To assign a password to a SCSI routing instance for iSCSI authentication purposes, use the scsirouter password command. scsirouter name password {password-string | none} Syntax Description name The name of the SCSI routing instance. password-string The password associated with the named SCSI routing instance. If the password is encrypted (starts with “9”), enter a maximum of 170 characters.
Chapter 12 Command Line Interface Reference scsirouter password The initial “9” in the example display indicates that the password is encrypted. • You can re-enter an encrypted password using the normal scsirouter password command. Enter the encrypted password in single or double quotes, starting with 9 and a single space.
Chapter 12 Command Line Interface Reference scsirouter primary scsirouter primary To assign the specified system as the preferred storage router for the named SCSI routing instance, use the scsirouter primary command. scsirouter name primary sysname Syntax Description name The name of this SCSI routing instance. primary sysname The system name of the preferred storage router. Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference scsirouter primary Examples The following command designates the SN 5428-2 LabRouter1 as the storage router on which the SCSI routing instance named foo will always, under normal conditions, run. [SN5428-2A]# scsirouter foo primary LabRouter1 Related Commands Command Description clear scsirouter primary Remove the storage router configured as the primary for the named SCSI routing instance.
Chapter 12 Command Line Interface Reference scsirouter reserveproxy scsirouter reserveproxy To configure the SCSI routing instance to track SCSI reserve/release commands and to specify whether these commands are forwarded to the storage target, use the scsirouter reserveproxy command. scsirouter name reserveproxy {enable passthru {yes | no} | disable} Syntax Description name The name of the SCSI routing instance.
Chapter 12 Command Line Interface Reference scsirouter reserveproxy Related Commands Command Description delete scsirouter Delete the named SCSI routing instance or the specified element of the SCSI routing instance. restore scsirouter Restore the named SCSI routing instance from the named configuration file. save scsirouter Save configuration information for the named SCSI routing instance. scsirouter Create a SCSI routing instance.
Chapter 12 Command Line Interface Reference scsirouter serverif scsirouter serverif To assign a Gigabit Ethernet interface and IP address to the named SCSI routing instance, use the scsirouter serverif command. The specified interface allows IP hosts access to Fibre Channel storage. scsirouter name serverif ge? {A.B.C.D/bits | A.B.C.D/1.2.3.4} [secondary ge?] scsirouter name serverif ge? vlan vid {A.B.C.D/bits | A.B.C.D/1.2.3.
Chapter 12 Command Line Interface Reference scsirouter serverif Usage Guidelines The specified interface IP address is configured on IP hosts requiring access to storage resources through the SN 5428-2 Storage Router. Each SCSI routing instance requires two active elements: • The serverif element assigns an interface and IP address for use by IP hosts requiring access to storage resources. The instance becomes active when this interface is added.
Chapter 12 Command Line Interface Reference scsirouter slp enable scsirouter slp enable To enable the advertisement of the targets of the named SCSI routing instance with the Service Location Protocol (SLP) service, use the scsirouter slp enable command. To disable target advertisement, use the no form of this command. scsirouter name slp enable no scsirouter name slp enable Syntax Description name Defaults Advertising with the SLP Service is enabled for all targets. Command Modes Administrator.
Chapter 12 Command Line Interface Reference scsirouter slp enable Related Commands Command Description show slp Display the status of the SLP service and the interface address where the SLP service is listening for incoming SLP service requests. slp findattrs Discover the attributes of a specific SLP registered service. slp findsrvs Locate a SLP registered service of a specific type on the local subnet. slp findsrvtypes Discover all SLP registered service types on the local subnet.
Chapter 12 Command Line Interface Reference scsirouter target accesslist scsirouter target accesslist To associate the named access list with the specified target, use the scsirouter target accesslist command. scsirouter name target {name | all} accesslist {name | any | none} [ro | rw] Syntax Description name The name of the SCSI routing instance to which this target belongs. target name The name of the storage target to associate with this access list. The target must already exist.
Chapter 12 Command Line Interface Reference scsirouter target accesslist Note Examples • Use the target all form of this command to create an association between the specified access list and all targets. • 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 IP host. • Use the reserved access list name any to allow access to this storage target from any IP host.
Chapter 12 Command Line Interface Reference scsirouter target accesslist Related Commands Command Description accesslist Create an access list entity. accesslist A.B.C.D/bits Add IP addresses to an access list. accesslist chap-username Add CHAP user name entries to an access list. accesslist iscsi-name Add iSCSI Name entries to an access list. delete accesslist Delete a specific access list entry or an entire access list.
Chapter 12 Command Line Interface Reference scsirouter target crc scsirouter target crc To control the usage of iSCSI cyclical redundancy check (CRC) on the specified target or all targets, use the scsirouter target crc command. scsirouter name target {name | all} crc {always | any | never | prefer-off | prefer-on} Syntax Description name The name of the SCSI routing instance to which this target belongs. target name The name of the storage target.
Chapter 12 Command Line Interface Reference scsirouter target crc Table 12-19 iSCSI CRC Negotiation Outcomes Initiator CRC Mode Target CRC Mode CRC Negotiation Outcome always always CRC is enabled. never Negotiation is rejected. No session is established to the target. prefer-on CRC is enabled. prefer-off CRC is enabled. any CRC is enabled. always Negotiation is rejected. No session is established to the target. never CRC is disabled. prefer-on CRC is disabled.
Chapter 12 Command Line Interface Reference scsirouter target crc Related Commands Command Description delete scsirouter Delete the named SCSI routing instance or the specified element of the SCSI routing instance. restore scsirouter Restore the named SCSI routing instance from the named configuration file. save scsirouter Save configuration information for the named SCSI routing instance.
Chapter 12 Command Line Interface Reference scsirouter target description scsirouter target description To add a description to the named target, use the scsirouter target description command. scsirouter name target name description “user text” Syntax Description name The name of the SCSI routing instance to which this target belongs. target name The name of the storage target. “user text” User-defined identification information associated with this storage target.
Chapter 12 Command Line Interface Reference scsirouter target description Related Commands Command Description accesslist Create an access list entity. accesslist A.B.C.D/bits Add IP addresses to an access list. accesslist chap-username Add CHAP user name entries to an access list. accesslist iscsi-name Add iSCSI Name entries to an access list. delete accesslist Delete a specific access list entry or an entire access list.
Chapter 12 Command Line Interface Reference scsirouter target enable scsirouter target enable To allow connections and logins for the named target, use the scsirouter target enable command. To disallow connections and logins for the named target, use the no form of this command. scsirouter name target {name | all} enable no scsirouter name target {name | all} enable Syntax Description name The name of the SCSI routing instance to which this target belongs. target name The name of the storage target.
Chapter 12 Command Line Interface Reference scsirouter target enable Examples The following example enables connections for all targets of the SCSI routing instance foo. [SN5428-2A]# scsirouter foo target all enable The following examples disables connections for the target webservices2 of the SCSI routing instance named lab2: [SN5428-2A]# no scsirouter lab2 target webservices2 enable Related Commands Command Description accesslist Create an access list entity. accesslist A.B.C.
Chapter 12 Command Line Interface Reference scsirouter target {lunid | serial | wwpn} #? scsirouter target {lunid | serial | wwpn} #? To use an index method of mapping a logical target or a logical target and LUN combination to storage, use the scsirouter target {serial | lunid | wwpn} #? command. This 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.
Chapter 12 Command Line Interface Reference scsirouter target {lunid | serial | wwpn} #? Command History Usage Guidelines Release Modification 3.2.1 This command was introduced. This command can be used for target-only or target-and-LUN mapping.
Chapter 12 Command Line Interface Reference scsirouter target {lunid | serial | wwpn} #? Related Commands Command Description accesslist Create an access list entity. accesslist A.B.C.D/bits Add IP addresses to an access list. accesslist chap-username Add CHAP user name entries to an access list. accesslist iscsi-name Add iSCSI Name entries to an access list. delete accesslist Delete a specific access list entry or an entire access list.
Chapter 12 Command Line Interface Reference scsirouter target lun lunid scsirouter target lun lunid To map a logical target and LUN combination to a unique LUN identifier, use the scsirouter target lun lunid command. The scsirouter target lun lunid command is a target-and-LUN mapping method of mapping a logical target to storage. scsirouter name target name lun nn lunid lun-identifier [force] Syntax Description name Name of the SCSI routing instance to which you are adding the storage target.
Chapter 12 Command Line Interface Reference scsirouter target lun lunid Use the force keyword to allow mapping of the same storage array control LUN in multiple targets. Do not use the force keyword to LUN-map the same data LUN in multiple targets. LUN-mapping of the same LUN in multiple targets is advised for a control LUN on a storage controller only. Examples The following example maps a logical target and LUN combination for SCSI router instance foo.
Chapter 12 Command Line Interface Reference scsirouter target lun serial scsirouter target lun serial To map a logical target and LUN combination to the serial number of the physical LUN, use the scsirouter target lun serial command. The scsirouter target lun serial command is a target-and-LUN mapping method of mapping a logical target and LUN combination to a physical storage resource by the LUN serial number.
Chapter 12 Command Line Interface Reference scsirouter target lun serial Use the force keyword to allow mapping of the same storage array control LUN in multiple targets. Do not use the force keyword to LUN-map the same data LUN in multiple targets. LUN-mapping of the same LUN in multiple targets is advised for a control LUN on a storage controller only. Examples The following example maps the logical target and LUN combination for SCSI routing instance lab2.
Chapter 12 Command Line Interface Reference scsirouter target lun wwpn lun 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 World Wide Port Name (WWPN) and LUN, use the scsirouter target lun wwpn lun command. The scsirouter target lun wwpn lun command is a target-and-LUN mapping method of mapping a logical target to storage.
Chapter 12 Command Line Interface Reference scsirouter target lun wwpn lun Tips WWPN address notation is represented by 16 hex digits. The digits may be separated by colons. When entering WWPN addresses, colons can be omitted or 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 left-most) character position.
Chapter 12 Command Line Interface Reference scsirouter target lun wwpn lun Examples The following example maps a logical target and LUN combination for SCSI router instance lab3. The logical target and LUN combination, webserver7 LUN 7, is mapped to the primary WWPN and LUN combination, 2200002037191505 LUN 0. [SN5428-2A]# scsirouter lab3 target webserver7 lun 7 wwpn 2200002037191505 lun 0 The following example maps a logical target and LUN combination to a primary and secondary WWPN.
Chapter 12 Command Line Interface Reference scsirouter target maxcmdqueuedepth scsirouter target maxcmdqueuedepth To specify the maximum number of commands allowed at any given time from each iSCSI session to the specified target, use the scsirouter target maxcmdqueuedepth command. scsirouter name target {all | name} maxcmdqueuedepth nn Syntax Description name Name of the SCSI routing instance. target all Specify the maximum number of command for all targets.
Chapter 12 Command Line Interface Reference scsirouter target maxcmdqueuedepth Related Commands Command Description delete scsirouter Delete the named SCSI routing instance or the specified element of the SCSI routing instance. restore scsirouter Restore the named SCSI routing instance from the named configuration file. save scsirouter Save configuration information for the named SCSI routing instance. scsirouter target enable Allow or disallow connections and logins for the named target.
Chapter 12 Command Line Interface Reference scsirouter target profile scsirouter target profile To disable the use of an initial iSCSI Ready-to-Transfer (R2T) on connections coming to this target, use the scsirouter target profile command. scsirouter name target name profile {high | low} Syntax Description name Name of the SCSI routing instance to which you are adding the target profile. target name The name of the storage target. high Disable the use of R2T for the specified target.
Chapter 12 Command Line Interface Reference scsirouter target profile Related Commands Command Description delete scsirouter Delete the named SCSI routing instance or the specified element of the SCSI routing instance. restore scsirouter Restore the named SCSI routing instance from the named configuration file. save scsirouter Save configuration information for the named SCSI routing instance. scsirouter target enable Allow or disallow connections and logins for the named target.
Chapter 12 Command Line Interface Reference scsirouter target wwpn scsirouter target wwpn To map a logical target to a primary (and, optionally, a secondary) storage address specified by World Wide Port Names (WWPNs), use the scsirouter target wwpn command. The scsirouter target wwpn command is a target-only method of mapping a logical target specified by WWPNs.
Chapter 12 Command Line Interface Reference scsirouter target wwpn The following examples are incorrect: • 1:234:567:8:91:23:FF:6 • 12:34:56 When you map a target using WWPN and the target needs to be accessed in a high availability cluster, you must specify both the primary WWPN (the WWPN of the storage resource as known to the first storage router in the cluster) and the secondary WWPN (the WWPN of the storage resource as known to the second storage router in the cluster).
Chapter 12 Command Line Interface Reference scsirouter target wwpn Related Commands Command Description accesslist Create an access list entity. accesslist A.B.C.D/bits Add IP addresses to an access list. accesslist chap-username Add CHAP user name entries to an access list. accesslist iscsi-name Add iSCSI Name entries to an access list. delete accesslist Delete a specific access list entry or an entire access list.
Chapter 12 Command Line Interface Reference scsirouter username scsirouter username To assign a user name to a SCSI routing instance for iSCSI authentication purposes, use the scsirouter username command. scsirouter name username {user-name | none} Syntax Description name The name of the SCSI routing instance. user-name A valid user name. Enter a maximum of 63 characters none Keyword, removing any existing iSCSI user name assigned to the named SCSI routing instance. Defaults None.
Chapter 12 Command Line Interface Reference scsirouter username Related Commands Command Description scsirouter authentication Enable iSCSI authentication for the named SCSI routing instance. scsirouter password Assign a password to a SCSI routing instance for iSCSI authentication purposes. show scsirouter Display configuration and operational information for the named SCSI routing instance.
Chapter 12 Command Line Interface Reference session-timeout session-timeout To set the number of minutes a Telnet or SSH management session (or an Administrator mode session via the EIA/TIA-232 console connection) to the SN 5428-2 Storage Router can be inactive before the session times out, use the session timeout command. To prevent management sessions from timing out, use the no form of this command.
Chapter 12 Command Line Interface Reference session-timeout Related Commands Command Description show sessions Display information about active console, Telnet, SSH or GUI sessions to the storage router. show system Display selected system information.
Chapter 12 Command Line Interface Reference setup setup To configure the SN 5428-2 Storage Router using the setup configuration wizard, use the setup command. The Setup configuration wizard runs the Management Interface, Date and Time, Network Management, Management Access, and SCSI routing (if applicable) individual wizards in sequence. setup Syntax Description This command has no arguments or keywords.
Chapter 12 Command Line Interface Reference setup • Management Access—configures passwords for monitoring and configuring the storage router. • SCSI Routing—configures a SCSI routing instance. The wizard is only available when the storage router is deployed for SCSI routing; it is not available if the storage router is deployed for transparent SCSI routing. • FCIP—configures FCIP instances.
Chapter 12 Command Line Interface Reference setup Examples The following shows the initial explanatory text for the setup command: [SN5428-2_A]# setup You are about to set up the SN5428-2. Running this wizard will modify the configuration of this system. During setup, operational changes will take place. However, these changes are not saved until the end of the script. To quit the setup wizard without saving changes, ** hit CTRL-C at any time **. Reboot to restore previous values.
Chapter 12 Command Line Interface Reference setup access setup access To configure passwords for monitoring and administering the SN 5428-2 Storage Router, use the setup access configuration wizard. The wizard prompts you to enter and confirm new passwords. setup access [parameter1 parameter2...] Syntax Description parameter1 parameter2 (Optional) Enter each parameter that the wizard prompts for. All parameters ... must be passed.
Chapter 12 Command Line Interface Reference setup access Examples The following example sets the Monitor mode and Administrator mode passwords for the storage router, but does not apply them to the console interface. Administrator contact information is also configured. Passwords display as asterisks when entered. [SN5428-2_PR]# setup access ############################### ## Management Access Setup ## ############################### The SN5428-2 CLI and GUI are protected by two passwords.
Chapter 12 Command Line Interface Reference setup access Related Commands Command Description clear conf Return most configuration settings to factory defaults. setup Run the setup configuration wizard. setup cluster Change the configuration of the high availability environment. setup fcip Run the wizard to manually configure FCIP instances. setup iscsi-port Run the wizard to manually configure the port used for iSCSI traffic. setup mgmt Run the wizard to configure the management interface.
Chapter 12 Command Line Interface Reference setup cluster setup cluster To configure the high availability (HA) environment for the SN 5428-2 Storage Router, to add the storage router to a cluster, or to remove it from an existing cluster, use the setup cluster configuration wizard. The wizard prompts you to select the appropriate HA configuration mode, enter a cluster name and (if necessary) an HA interface IP address and subnet mask. setup cluster [parameter1 parameter2...
Chapter 12 Command Line Interface Reference setup cluster Caution Retaining SCSI routing instance configuration data could provide unexpected results. Changing the cluster name, thereby joining another cluster, has the following effects on its existing configurations and operations: • All SCSI routing instances are failed over to another member in the original cluster. • All applications are stopped. • The cluster name is changed.
Chapter 12 Command Line Interface Reference setup cluster If you select HA configuration mode clustered, the wizard prompts you to enter an HA IP address: To determine the health of other SN5428-2s in a cluster, the SN5428-2 must send occasional heartbeat packets on at least two interfaces (in case one interface has problems). By default, the interfaces used are the 10/100 management interface (already set up) and the 10/100 HA interface. Please select an IP address and network mask for the HA interface.
Chapter 12 Command Line Interface Reference setup cluster Related Commands Command Description clear conf Return most configuration settings to factory defaults. setup Run the setup configuration wizard. setup access Run the wizard to configure Monitor mode and Administrator mode passwords. setup fcip Run the wizard to manually configure FCIP instances. setup iscsi-port Run the wizard to manually configure the port used for iSCSI traffic.
Chapter 12 Command Line Interface Reference setup fcip setup fcip To configure an FCIP instance, use the setup fcip configuration wizard. The wizard prompts you to choose the name of the FCIP instance and specify the Gigabit Ethernet IP address and network mask. Then the wizard prompts you to enter the peer IP address and the connection protocol type. More extensive configuration of FCIP instances can be performed via the CLI or the web-based GUI. setup fcip [parameter1 parameter2...
Chapter 12 Command Line Interface Reference setup fcip Examples The following shows example output and input for the setup scsi command: [techpubs4]# setup fcip In order to correctly configure this FCIP instance, be sure you know the configuration of the remote FCIP instance. You will need to know the IP address and the communication protocol of the remote FCIP instance.
Chapter 12 Command Line Interface Reference setup fcip Related Commands Command Description clear conf Return most configuration settings to factory defaults. setup Run the setup configuration wizard. setup access Run the wizard to configure Monitor mode and Administrator mode passwords. setup cluster Change the configuration of the high availability environment. setup iscsi-port Run the wizard to manually configure the port used for iSCSI traffic.
Chapter 12 Command Line Interface Reference setup iscsi-port setup iscsi-port To change the default listening port used for iSCSI traffic, use the setup iscsi-port wizard. setup iscsi-port [parameter1 parameter2...] Syntax Description parameter1 parameter2 (Optional) Enter each parameter that the wizard prompts for. All parameters ... must be passed. If a parameter includes an embedded space, enclose the parameter in quotation marks. Defaults The default listening port used for iSCSI traffic is 3260.
Chapter 12 Command Line Interface Reference setup iscsi-port Do you want to change the iSCSI port number?[yes/no (no)] yes ########################## ## Changing iSCSI port ## ########################## Now, you will need to enter a new iSCSI port number. The new port will be used as the iSCSI server listen port. Make sure the new port is not used by other applications in your network environment.
Chapter 12 Command Line Interface Reference setup mgmt setup mgmt To configure the SN 5428-2 Storage Router management interface, use the setup mgmt configuration wizard. The wizard prompts you to enter the system name, management interface IP address and subnet mask, optional default gateway and DNS information. setup mgmt [parameter1 parameter2...] Syntax Description parameter1 parameter2 (Optional) Enter each parameter that the wizard prompts for. All parameters ... must be passed.
Chapter 12 Command Line Interface Reference setup mgmt Examples The following shows example output for the setup mgmt command: [SN5428-2A]# setup mgmt ################################ ## Management Interface Setup ## ################################ Please choose a name for the SN5428-2. This name is associated with the SN5428-2 Management Interface IP address.
Chapter 12 Command Line Interface Reference setup netmgmt setup netmgmt To enable network management via any or all of the available interfaces (Telnet, web-based GUI, or SNMP), use the setup netmgmt configuration wizard. The wizard prompts you to selectively enable the various interfaces and, if SNMP is enabled, will prompt you to enter the read and write community information, IP addresses for SNMP traps, and additional SNMP configuration information. setup netmgmt [parameter1 parameter2...
Chapter 12 Command Line Interface Reference setup netmgmt Examples The following shows example output and input for the setup netmgmt command: [SN5428-2A]# setup netmgmt ##################################### ## Network Management Access Setup ## ##################################### This wizard will enable you to configure access to telnet, the web-based GUI, and configure SNMP. By default, telnet and the web-based GUI are enabled.
Chapter 12 Command Line Interface Reference setup netmgmt Related Commands Command Description clear conf Return most configuration settings to factory defaults. setup Run the setup configuration wizard. setup access Run the wizard to configure Monitor mode and Administrator mode passwords. setup cluster Change the configuration of the high availability environment. setup fcip Run the wizard to manually configure FCIP instances.
Chapter 12 Command Line Interface Reference setup scsi setup scsi To configure a SCSI routing instance, use the setup scsi configuration wizard. The wizard prompts you to enter the name of the SCSI routing instance (maximum 32 characters) and to specify the IP address and Gigabit Ethernet interface for the SCSI routing instance. Then the wizard discovers all Fibre Channel devices connected to the SN 5428-2 Storage Router.
Chapter 12 Command Line Interface Reference setup scsi Examples The following shows example output and input for the setup scsi command: [SN5428-2A]# setup scsi ####################### ## scsirouter Setup ## ####################### This wizard will enable you to set up a scsirouter instance, but will not enable you to specify a VLAN for the IP interface. If a VLAN is required for the scsirouter instance, please use CLI commands to configure the scsirouter.
Chapter 12 Command Line Interface Reference setup scsi Related Commands Command Description clear conf Return most configuration settings to factory defaults. setup Run the setup configuration wizard. setup access Run the wizard to configure Monitor mode and Administrator mode passwords. setup cluster Change the configuration of the high availability environment. setup fcip Run the wizard to manually configure FCIP instances.
Chapter 12 Command Line Interface Reference setup time setup time To set current date and time information and other time-related configuration settings, use the setup time configuration wizard. The storage router uses date and time information for log files and the user interface. setup time [parameter1 parameter2...] Syntax Description parameter1 parameter2 (Optional) Enter each parameter that the wizard prompts for. All parameters ... must be passed.
Chapter 12 Command Line Interface Reference setup time Examples The following shows example output and input for the setup time command: [SN5428-2A]# setup time ######################### ## Date and Time Setup ## ######################### To provide correct information in log files and user interfaces, the SN5428-2 must have a reasonably accurate date and time. To use Daylight Savings Time or specify time zone by geographic region use the "clock timezone" command.
Chapter 12 Command Line Interface Reference setup time Related Commands Command Description clear conf Return most configuration settings to factory defaults. setup Run the setup configuration wizard. setup access Run the wizard to configure Monitor mode and Administrator mode passwords. setup cluster Change the configuration of the high availability environment. setup fcip Run the wizard to manually configure FCIP instances.
Chapter 12 Command Line Interface Reference show aaa show aaa To display AAA configuration information and operational statistics, use the show aaa command. show aaa [from {filename | bootconfig | runningconfig}] show aaa [stats] Syntax Description from filename (Optional) The name of the configuration file where the AAA configuration is stored. This file must exist in the savedconfig directory. from bootconfig (Optional) Display the AAA information from the persistent saved configuration.
Chapter 12 Command Line Interface Reference show aaa [SN5428-2A]# show aaa from bootconfig aaa new-model aaa authentication iscsi default group tacacs+ local username "fred" password "9 af4f2428498a41a31e237de1c4a9b9fcef" username "pat" password "9 7ddbccc3d0daf013f4293c3d3bd94539dd" username "kris" password "9 0607167520058771e66ab1d379d7e6505f" username "adrian" password "9 0ad24a3b35dc296d894e512416d572b3ee" radius-server retransmit 12 radius-server host 10.5.0.
Chapter 12 Command Line Interface Reference show accesslist 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 {filename | bootconfig | runningconfig}] Syntax Description name (Optional) The name of the access list. all (Optional) Display all access list entries. from filename (Optional) The name of the configuration file where the access list configuration is stored.
Chapter 12 Command Line Interface Reference show accesslist To display the contents of the access list named webserver2 from the current running configuration, issue this command: [SN5428-2A]# 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: [SN5428-2A]# show accesslist webserver2 from backup_1218 Related Commands Commands Description accesslist Create an access list entity.
Chapter 12 Command Line Interface Reference show admin 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. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show boot 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. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show bootconfig show bootconfig To display the bootable configuration for the SN 5428-2 Storage Router, or to save the commands used to create the bootable configuration to a file, use the show bootconfig command. show bootconfig [to filename] Syntax Description to filename Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show bootconfig Table 12-20 Elements Displayed for the “show bootconfig” Command (continued) Examples Element Description FC PORTS Operational characteristics of the Fibre Channel interfaces. FC SWITCH Global Fibre Channel attributes. FC ZONE Zone configuration information. FC ZONE ALIAS Zone alias configuration information. FC ZONE SET Zone set configuration information.
Chapter 12 Command Line Interface Reference show bootconfig ! accesslist aegis accesslist aegis 10.2.0.23/255.255.255.255 accesslist aegis 10.3.0.36/255.255.255.255 accesslist aegis 10.4.0.49/255.255.255.255 accesslist aegis iscsi-name ign.1987-05.com.cisco.08.80342789af73ebcdef123.xxx accesslist aegis iscsi-name ign.1987-05.com.cisco.08.7125abc9af73ebcdef123.xxx accesslist aegis iscsi-name ign.1987-05.com.cisco.08.1234abecf9876bac00034.xxx accesslist aegis chap-username 12h7b.lab2.
Chapter 12 Command Line Interface Reference show bootconfig ! ip route 10.1.30.0/255.255.255.0 10.1.10.201 ip route 10.1.40.243/255.255.255.255 10.1.10.201 ip route 10.1.50.249/255.255.255.255 10.1.10.201 ip default-gateway 10.1.10.201 ! ! RIP ! no ip rip enable ip rip timers invalid 180 ! ! ADMIN ! admin contactinfo name “pat” ! ! ADMIN LOGIN ! admin password ! ! MONITOR LOGIN ! monitor password ! ! SNTP ! ntp peer 10.1.60.
Chapter 12 Command Line Interface Reference show bootconfig ! ! HA ! ! ha configuration clustered ! ! SYSLOG ! logging syslog 10.1.40.
Chapter 12 Command Line Interface Reference show bootconfig no fcswitch domainid lock enable fcswitch interop-credit 12 ! ! FC ZONE ALIAS ! fcalias iscsi fcalias iscsi member wwpn 280000048aa58710 fcalias iscsi member wwpn 290000048aa58710 fcalias leto fcalias leto member wwpn 201b00491585c219 ! ! FC ZONE ! zone agamemnon zone agamemnon member wwpn 201b00491585c219 zone agamemnon member fcalias leto ! ! FC ZONE SET ! zoneset helen zoneset helen zone agamemnon no zoneset helen enable ! ! FC PORTS ! interfa
Chapter 12 Command Line Interface Reference show bootconfig interface fc5 enable interface fc5 ms-enable enable no interface fc5 al-fairness enable interface fc5 fan-enable enable interface fc5 ext-credit 0 interface fc5 mfs-bundle enable timeout 10 interface fc5 linkspeed auto interface fc5 type gl-port ! interface fc6 enable interface fc6 ms-enable enable no interface fc6 al-fairness enable interface fc6 fan-enable enable interface fc6 ext-credit 0 interface fc6 mfs-bundle enable timeout 10 interface f
Chapter 12 Command Line Interface Reference show bootconfig Related Commands Command Description read script Read and execute the CLI commands in the named script file. restore all Restore the contents of the named configuration file into memory. save all Save all configuration information show runningconfig Display the running configuration, or create a command file based on the running configuration.
Chapter 12 Command Line Interface Reference show buffers show buffers To display buffer pool information for a variety of areas, use the show buffers command. show buffers Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show buffers number of mbufs: 42176 number of times failed to find headers: 0 number of times failed to find clusters: 0 number of times waited for space: 0 number of times drained protocols for space: 0 __________________ CLUSTER POOL TABLE _______________________________________________________________________________ size clusters free usage low water -------------------------------------------------------------------------------------------------------------
Chapter 12 Command Line Interface Reference show buffers SONAME : 0 ZOMBIE : 0 SOOPTS : 0 FTABLE : 0 RIGHTS : 0 IFADDR : 12 CONTROL : 0 OOBDATA : 0 IPMOPTS : 5 IPMADDR : 12 IFMADDR : 0 MRTABLE : 0 TOTAL : 16384 LOW WTR : 16224 number of mbufs: 16384 number of times failed to find headers: 0 number of times failed to find clusters: 0 number of times waited for space: 0 number of times drained protocols for space: 0 __________________ CLUSTER POOL TABLE _____________________________________________________
Chapter 12 Command Line Interface Reference show buffers CLUSTER POOL TABLE _______________________________________________________________________________ size clusters free usage low water ------------------------------------------------------------------------------64 2832 2832 58994 2816 128 4124 4124 367277 3946 256 901 901 138752 770 512 947 947 67656 857 1024 96 96 37952 68 2048 97 97 1051 96 ------------------------------------------------------------------------------Net Buffers: type --------FRE
Chapter 12 Command Line Interface Reference show cdp show cdp To display global Cisco Discovery Protocol (CDP) configuration information for the SN 5428-2 Storage Router, including timer and holdtime information, use the show cdp command. show cdp Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show cdp Table 12-21 Description of Fields in the “show cdp” Command Output (continued) Related Commands Field Definition Sending a holdtime value of nn seconds The amount of time (in seconds) the storage router directs a neighbor to hold the CDP advertisement before discarding it. This field is controlled by the cdp holdtime command. Sending CDPv2 advertisements are enabled Indicates that CDP version 2 advertisements are enabled.
Chapter 12 Command Line Interface Reference show cdp entry show cdp entry To display information about a specific neighboring device or all neighboring devices discovered using CDP, use the show cdp entry command. show cdp entry {device-id | all} Syntax Description device-id The device ID of the CDP neighbor about which you want information. all Display all CDP neighbors. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference show cdp entry Related Commands Command Description cdp enable Enable or disable CDP on the SN 5428-2 Storage Router. cdp holdtime Specify the amount of time the receiving device should hold a CDP packet from the SN 5428-2 Storage Router before discarding it. cdp interface Switch CDP on or off for the specified interface. cdp timer Specify the amount of time between transmissions of CDP packets from the SN 5428-2 Storage Router.
Chapter 12 Command Line Interface Reference show cdp interface show cdp interface To display information about the SN 5428-2 Storage Router interfaces on which CDP is enabled, use the show cdp interface command. show cdp interface [if-name] Syntax Description if-name Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced. Display CDP status and operational information for the specified interface.
Chapter 12 Command Line Interface Reference show cdp interface Related Commands Command Description cdp enable Enable or disable CDP on the SN 5428-2 Storage Router. cdp holdtime Specify the amount of time the receiving device should hold a CDP packet from the SN 5428-2 Storage Router before discarding it. cdp interface Switch CDP on or off for the specified interface. cdp timer Specify the amount of time between transmissions of CDP packets from the SN 5428-2 Storage Router.
Chapter 12 Command Line Interface Reference show cdp neighbors show cdp neighbors To display detailed information about neighboring devices discovered using CDP, use the show cdp neighbors command. show cdp neighbors [interface if-name] [detail] Syntax Description interface if-name (Optional) Keyword and name of the interface connected to the neighbors for which you want information.
Chapter 12 Command Line Interface Reference show cdp neighbors Table 12-22 describes the significant fields shown in the display. Table 12-22 Description of Fields in the “show cdp neighbors” Command Output Field Description Capability Codes The type of device that can be discovered. Device-ID The name of the neighbor device and either the MAC address or the serial number of this device. This field is truncated after 27 characters.
Chapter 12 Command Line Interface Reference show cdp neighbors Table 12-23 describes the significant fields shown in the display. Table 12-23 Description of Fields in the “show cdp neighbors detail” Command Output Related Commands Field Description Device-ID The name of the neighbor device and either the MAC address or the serial number of this device. Entry address(es) A list of network addresses of neighbor devices. IP address The IP address of the neighboring device.
Chapter 12 Command Line Interface Reference show cdp traffic show cdp traffic To display information about traffic between devices gathered using Cisco Discovery Protocol (CDP), use the show cdp traffic command. show cdp traffic Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show cdp traffic Table 12-24 Description of Fields in the “show cdp traffic” Command Output (continued) Field Description Encaps failed The number of times CDP failed to send advertisements on an interface because of a failure caused by the bridge port of the storage router.
Chapter 12 Command Line Interface Reference show cli show cli To display information about the command line interface (CLI), use the show cli command. show cli [command-keyword] [command-keyword ... command keyword ...] show cli status Syntax Description command-keyword (Optional) The first keyword in the command displays the CLI command tree for all varieties of that command. status (Optional) Keyword used to display the status of the last CLI command. Defaults None.
Chapter 12 Command Line Interface Reference show cli Related Commands Command Description help Display information about how to use the CLI.
Chapter 12 Command Line Interface Reference show clock show clock To display the current system date and time, use the show clock command. show clock Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Use this command to display the storage router date and time setting.
Chapter 12 Command Line Interface Reference show cluster show cluster To display operational information related to the high availability (HA) cluster, use the show cluster command. show cluster Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show cluster The following example displays cluster information about a standalone storage router: [SN5428-2A]# show cluster Cluster Name: 630041D Cluster Changes: 0 Last Change: Mon Nov 19 14:09:18 GMT+6 2001 IP Multicast Address: 224.0.0.
Chapter 12 Command Line Interface Reference show cluster Table 12-25 Description of Fields in the “show cluster” Command Output (continued) Field Name Description Cluster Node List A list of storage routers in the cluster. System Name The name of the storage router. MGMT IP The IP address of the cluster node management interface. HA IP The IP address of the cluster node HA interface. Last Heard From The date and time the cluster node was last heard from.
Chapter 12 Command Line Interface Reference show cpu 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 or Monitor. Command History Release Modification 3.2.1 This command was introduced. 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.
Chapter 12 Command Line Interface Reference show crash show crash To display saved crash trace information or current crash trace information, use the show crash command. show crash [current] Syntax Description current Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines (Optional) Returns the current crash trace information for the running system. The default crash trace file is crash-cpp.
Chapter 12 Command Line Interface Reference show crash Panic Msg: NULL # # Boot Information # VxWorks (for Galileo GT64260/MPC7410) version 5.4.1. Kernel: WIND version 2.5. Made on Dec 12 2002, 15:13:30. Boot line: ata=0,00(0,0):/ata0/vxWorks e=10.1.10.244:ffffff00 tn=lab2 s=/ata0/NuSpeed.start o=fei # #Task List# # In the following example, no saved crash trace information exists. This condition occurs when the command is issued and the storage router has never unexpectedly restarted.
Chapter 12 Command Line Interface Reference show debug show debug To display a variety of debug information or perform specific troubleshooting activities, use the show debug command. show debug {mailboxtrace | rawlundatabase} {fci? | all} show debug portarray fci? Syntax Description fci? The name of the internal Fibre Channel (FC) interface. Valid values are fci1 and fci2. When you type fci?, the CLI lists the interfaces available. You cannot specify a nonexistent interface.
Chapter 12 Command Line Interface Reference show debug Examples The following example displays raw lun database information for all targets discovered on the internal FC interface fci1: [SN5428-2_PR]# show debug rawlundatabase fci1 Entry Address = 0xd047ab4 fabricLoginFailureCode=0x0,fabricLoginExtendedCode=0x0,fabricLoginTimeoutCode=0x0 ReportLunsLLDStatus=0x0,ReportLunsLLDStatusModifier=0x0,ReportLunsSCSIStatus=0x0,ReportLun sASCASCQ=0x0,ReportLunsLunCount=1 InquiryLLDStatus=0x0,InquiryLLDStatusModifie
Chapter 12 Command Line Interface Reference show debug Related Commands Command Description debug scsirouter Enable debugging for the named SCSI routing instance debug scsirouter target Enable debugging for a specific SCSI routing instance target and LUN combination.
Chapter 12 Command Line Interface Reference show debug fcip show debug fcip To display a variety of debug information or perform specific troubleshooting activities for FCIP instances, use the show debug fcip command. show debug fcip name {mailboxtrace | packettrace} Syntax Description name The name of the FCIP instance. Valid names are fcip1 and fcip2. mailboxtrace Display mailbox trace data. packettrace Display packet trace data.
Chapter 12 Command Line Interface Reference show debug fcip 046: 40 8 0009 047: 41 1 4000 048: 40 8 0009 049: 41 1 4000 050: 40 8 0009 051: 41 1 4000 052: 40 2 0007 ...
Chapter 12 Command Line Interface Reference show debug fcswitch show debug fcswitch To display internal Fibre Channel (FC) interface parameters, use the show debug fcswitch command. show debug fcswitch {all | brief | memory | tech-support} show debug fcswitch clish text Syntax Description all Display all interface parameters for internal FC interfaces fc0, fc15, fci1 and fci2, including all switch log entries. brief Display all interface parameters for internal FC interfaces fc0, fc15, fci1 and fci2.
Chapter 12 Command Line Interface Reference show debug fcswitch Initiator --------WWPN1 WWPN2 Value ---------------280000021e071160 290000021e071160 Global attributes Value ---------------------- ----Switch Name SN5428-2 Node WWN 100000021e071151 DomainID 1 Uptime (seconds) 76956 SysLogLevel Critical SysLogComp NameServer MgmtServer Zoning Switch Chassis Blade Port Eport Other DevLogLevel Critical DevLogComp None AlarmEntries 1 Display last 5 of 45 syslog entries [41][Tue Mar 19 05:08:44.
Chapter 12 Command Line Interface Reference show debug interface fc? show debug interface fc? To display debug information for internal Fibre Channel (FC) interface switch ports, use the show debug interface fc? command. show debug interface fc? [hosts | stats] Syntax Description fc? Display debug information for the specified internal FC interface switch ports. When you type the show debug interface fc? command, the CLI lists the interfaces available. You cannot specify a nonexistent interface.
Chapter 12 Command Line Interface Reference show debug interface fc? SFPPartNumber N/A SFPRev N/A Configuration Data AlExt FanInterface Status fairness credit enable --------- -------- -------- ------ -------fc0 enabled disabled 0 enabled Related Commands Link speed ----2Gb/s Loopback type -------Unknown Mfsbundle -------enabled Time out ---10 PortPorttype mode ------- --------f-port Command Description debug interface fc? Enable IP packet tracing for the specified Gigabit Ethernet interface.
Chapter 12 Command Line Interface Reference show debug interface ge? show debug interface ge? To display IP packet trace buffer statistics and contents, use the show debug interface ge? command. show debug interface ge? trace stats show debug interface ge? trace [first nn | last nn] show debug interface ge? trace hex [ascii] [first nn | last nn] Syntax Description ge? Display IP trace information for the specified Gigabit Ethernet interface.
Chapter 12 Command Line Interface Reference show debug interface ge? Examples The following example disables IP packet tracing on the interface ge1 and then displays the full contents of the trace buffer: [SN5428-2_PR]# no debug interface ge1 trace enable [SN5428-2_PR]# 1: RX, len 60, 0000: 01 00 0c 0010: 03 00 00 0020: 68 6f 00 0030: 00 08 7c Related Commands show debug interface time 0.
Chapter 12 Command Line Interface Reference show debug scsirouter show debug scsirouter To display a variety of debug information or perform specific troubleshooting activities for SCSI routing instances, use the show debug scsirouter command.
Chapter 12 Command Line Interface Reference show debug scsirouter Usage Guidelines To enable trace facilities for debugging SCSI routing instances, use the debug scsirouter command. The show debug scsirouter command is designed for debug purposes, and should be used under the guidance of a Cisco Technical Support professional.
Chapter 12 Command Line Interface Reference show debug scsirouter 00b0: 00c0: 00d0: 00e0: 00f0: 61 6f 73 73 79 76 6d 3d 63 70 68 00 64 6f 65 6f 49 61 2e 3d 2d 6e 76 63 6e 6c 69 61 6f 6f 6e 74 76 6d 72 78 69 68 00 6d 2e 61 6f 53 61 63 74 2d 65 6c 69 6f 6c 73 00 73 72 6e 73 00 63 41 78 69 6f 6c 2e 6f 2e 69 63 6e 63 61 69 54 avho-lnx.cisco.c om.InitiatorAlia s=davavho-lnx.ci sco.com.SessionT ype=normal.. 2: 10.1.50.100:3260 -> 10.1.50.12:1912, len 132, time 0.
Chapter 12 Command Line Interface Reference show devices show devices To display a list of devices found on the SN 5428-2 Storage Router Fibre Channel (FC) network, use the show devices command. show devices [all | brief] show devices [fc?] [lunid | serial] show devices rediscover Syntax Description all (Optional) Keyword used to display information for all devices on all FC interfaces.
Chapter 12 Command Line Interface Reference show devices Caution Examples The show devices rediscover command flushes existing tables and forces a PLOGI to each device. If IP hosts are accessing a device, they will be required to wait until this process completes.
Chapter 12 Command Line Interface Reference show devices The following is example output from the show devices brief command, which displays the LUN description table: [SN5428-2A]# show devices brief Lun Description Table Interface WWPN Lun --------- ---------------- ----fc1 22000003be3203bc 0 fc1 2200001026448a0d 0 Capacity -------17GB 17GB Vendor -----------SEAGATE SEAGATE Product ---------ST207341EB ST207340EB Serial -------------------2DU0537A00006105FGJ6 1BB00L3J0000600256DW The following is ex
Chapter 12 Command Line Interface Reference show diagnostics 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 or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show fcalias show fcalias To display information about aliases and their members, use the show fcalias command. show fcalias {alias-name | all | brief} Syntax Description alias-name The name of a specific alias entity. Only information about this alias entity will be displayed. all Display information about all alias entities. brief Show member information only for all alias entities. Defaults None. Command Modes Administrator or Monitor.
Chapter 12 Command Line Interface Reference show fcalias Related Commands Command Description delete fcalias Delete the named alias or the specified alias member. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or to delete the entire named zone set from the zoning database. fcalias Create an alias entity for use in Fibre Channel zoning.
Chapter 12 Command Line Interface Reference show fcip show fcip To display configuration information and operational statistics related to the named FCIP instance or all instances, use the show fcip command. show fcip {name | all} [from {filename | bootconfig | runningconfig}] show fcip {name | all} [brief | stats] Syntax Description name The name of the FCIP instance. Valid names are fcip1 and fcip2. all Display the requested information for all FCIP instances.
Chapter 12 Command Line Interface Reference show fcip Examples The following is example output from the show fcip command. In this example, the FCIP instance is configured to use a raw IP connection. [SN5428-2A]# show fcip fcip1 Instance Device I/F Network I/F -------- ---------- -------------fcip1 fci1 ge1 10.1.0.16 Description ----------Accessing SAN island 5 Destination ----------dest1 Mode --------raw IpAddress --------------10.2.70.
Chapter 12 Command Line Interface Reference show fcip The following is example output from the show fcip command. In this example, the FCIP instance is configured to use a TCP server connection. [SN5428-2A]# show fcip fcip2 Instance -------fcip2 Device I/F ---------fci2 Network I/F ----------ge2 10.1.40.42 Description ----------Testing SAN Destination ----------dest2 LocalMode --------tcpserver IpAddress --------------10.2.50.
Chapter 12 Command Line Interface Reference show fcip Table 12-27 Description of Fields in the “show fcip” Command Output (continued) Field Description Trace Status Operational information about FCIP traces. pktTraceMask The trace mask. mboxTracing Indicates if tracing is turned on for the FCIP instance. mboxCmdCount The number of commands that have been traced. Connection Information Configuration and operational information about the FCIP instance connection to the peer.
Chapter 12 Command Line Interface Reference show fcip Table 12-27 Description of Fields in the “show fcip” Command Output (continued) Field Description ipProtocol The value of the IP protocol used in the IP header. reXmitCnt The maximum number of times a packet can be retransmitted, before it is discarded. reXmitMaxTO The maximum amount of time, in ticks, that can be used for any one retransmission, before the packet is discarded.
Chapter 12 Command Line Interface Reference show fcip The following is example output from the show fcip stats command: [SN5428-2A]# show fcip all stats fcip1 ----Mode Destination Address Connected Related Commands tcpclient 10.1.40.170 Yes fcip1 Stats ----------Link up events Link down events Connect events Network connections established Network flow controlled fcip2 ----Mode Destination Address Connected raw 10.1.50.
Chapter 12 Command Line Interface Reference show fcswitch show fcswitch To display global configuration information for SN 5428-2 Storage Router Fibre Channel (FC) interfaces, use the show fcswitch command. show fcswitch Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show fcswitch Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or delete the entire named zone set from the zoning database.
Chapter 12 Command Line Interface Reference show fcswitch eport show fcswitch eport To display Fabric Shortest Path First (FSPF) protocol information for the Fibre Channel (FC) fabric, use the show fcswitch eport command. show fcswitch eport {all | brief} Syntax Description all Display complete FSPF information for all switches in the fabric. brief Display abbreviated FSPF information for all switches in the fabric. Defaults None. Command Modes Administrator or Monitor.
Chapter 12 Command Line Interface Reference show fcswitch eport Table 12-28 Description of Fields in the “show fcswitch eport brief” Command Output (continued) Related Commands Field Description Incarnation The link state incarnation number. Links The number of links associated with this node. Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information.
Chapter 12 Command Line Interface Reference show fcswitch fabric show fcswitch fabric To display information about the Fibre Channel (FC) fabric, use the show fcswitch fabric command. show fcswitch fabric {all | brief} Syntax Description all Display complete information for all domains in the fabric. brief Display abbreviated information for all domains in the fabric. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference show fcswitch fabric Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or delete the entire named zone set from the zoning database.
Chapter 12 Command Line Interface Reference show fcswitch global-nameserver show fcswitch global-nameserver To display the Fibre Channel (FC) fabric nameserver database, use the show fcswitch global-nameserver command. show fcswitch global-nameserver {all | brief} Syntax Description all Display the fabric nameserver database. brief Display abbreviated information from the fabric nameserver database. Defaults None. Command Modes Administrator or Monitor.
Chapter 12 Command Line Interface Reference show fcswitch global-nameserver domainId = 239 Port Id ------ef0000 ef02ef ef04d1 ef04d2 ef04d3 ef04d4 ef04d5 ef04d6 ef04d9 ef04da ef04dc ef04e0 ef0f00 Port Type ------N NL NL NL NL NL NL NL NL NL NL NL N Port Number --------------Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown Unknown Port WWN ---------------280000012c061100 210000d07a031e24 21000003be64e2a5 21000003be64e22e 21000003be64e2a2 21000003be64e225 21
Chapter 12 Command Line Interface Reference show fcswitch global-nameserver Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or delete the entire named zone set from the zoning database.
Chapter 12 Command Line Interface Reference show fcswitch linkstate show fcswitch linkstate To display information about the SN 5428-2 Storage Router link state database, use the show fcswitch linkstate command. show fcswitch linkstate database Syntax Description database Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced. Display current link information for all Fibre Channel (FC) ports.
Chapter 12 Command Line Interface Reference show fcswitch linkstate Local Node WWN 100000059ba69821 Local Port 1 Local Port WWN 200100059ba69821 Remote Node WWN 2000002037559b0e Remote Port ffffffff Remote Port WWN 2200002037559b0e Remote Agent Address 00000000 Remote Agent Type 0 Remote Agent Port 0 Remote Unit Type Unknown Remote Connection Id 0000e1 Local Node WWN Local Port Local Port WWN Remote Node WWN Remote Port Remote Port WWN Remote Agent Address Remote Agent Type Remote Agent Port Remote Unit
Chapter 12 Command Line Interface Reference show fcswitch linkstate Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or delete the entire named zone set from the zoning database.
Chapter 12 Command Line Interface Reference show fcswitch nameserver show fcswitch nameserver To display the local Fibre Channel (FC) nameserver database, use the show fcswitch nameserver command. show fcswitch nameserver {all | brief} Syntax Description all Display the local fabric nameserver database. brief Display abbreviated information from the local fabric nameserver database. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference show fcswitch nameserver Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or delete the entire named zone set from the zoning database.
Chapter 12 Command Line Interface Reference show ha show ha To display HA configuration and status information and HA statistics for the SN 5428-2 Storage Router or selected applications and SCSI routing instances running in the HA environment, use the show ha command. show ha all show ha app {all | list} stats show ha app nn {stats | failover list} show ha node stats Syntax Description all Display brief HA status and configuration information. app all stats Show HA statistics for all applications.
Chapter 12 Command Line Interface Reference show ha Examples The following is example output from the show ha command, using the app list keywords to display a list of applications and SCSI routing instances: [SN5428-2A]# show ha app list stats ----------------------------HA APPLICATION LIST-------------------------- Type = cluster (Number 01) Created = Tue Mar cluster/myCluster Created = Activated = Last Failover = 19 17:08:02 CDT 2002 Tue Mar 19 17:08:03 CDT 2002 Tue Mar 19 17:08:03 CDT 2002 no fail
Chapter 12 Command Line Interface Reference show ha HA Message Transmission Summary: Total = 00000005 Multicasts = 00000002 HA Message Reception Summary: Total = 00000004 Unicasts = 00000003 -------------------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 =
Chapter 12 Command Line Interface Reference show ha Table 12-30 Description of Fields in the “show ha app” Command Output (continued) Related Commands Field Description HA Message Reception Summary The total number of HA messages received by this application. Message Breakdown The number of each type of HA message that has been received and transmitted by this HA application.
Chapter 12 Command Line Interface Reference show interface show interface To display operational characteristics and statistics for interfaces configured for the SN 5428-2 Storage Router, use the show interface command. Statistics are cumulative since the last time the system was started.
Chapter 12 Command Line Interface Reference show interface • Use the show interface if-name stats command to display operational statistics related to the specified interface.
Chapter 12 Command Line Interface Reference show interface fc1 up fc2 down fc3 down fc4 down type Fibre Channel OperState enabled PortID 010100 WWN 200100c0aa00bc30 LinkSpeed 1Gb/s LinkState Active SyncState SyncAcquired LoginStatus LoggedIn Loopback Status Not Running MaxCredit 12 DonatedToPort None RunningType fl-port PendingType gl-port InBandMgmt enabled SFPType 100-M5-SN-1 SFPVendor PICOLIGHT SFPVendorID 850400 SFPPartNumber PL-XPL-00-S23-00 SFPRev type Fibre Channel OperState disabled PortI
Chapter 12 Command Line Interface Reference show interface fc5 down fc6 down fc7 down LoginStatus NotLoggedIn Loopback Status Not Running MaxCredit 12 DonatedToPort None RunningType Unknown PendingType gl-port InBandMgmt enabled SFPType NotInstalled SFPVendor Unknown SFPVendorID 0 SFPPartNumber Unknown SFPRev 0 type Fibre Channel OperState disabled PortID 010500 WWN 200500c0dd00bc30 LinkSpeed auto LinkState Inactive SyncState SyncLost LoginStatus NotLoggedIn Loopback Status Not Running MaxCredit 12
Chapter 12 Command Line Interface Reference show interface fc8 down fc15 up fci1 up fci2 up ge1 up 10.1.10.
Chapter 12 Command Line Interface Reference show interface ge2 up flow control rx pause SFPVendor IBM SFPVendorID 53P1476006FSR SFPPartNumber IBM42P21SNY SFPRev AA102P21SNY 02045aa80a51 type Gigabit Ethernet mtu 1500 speed 1000000000 flags UP BRDCST RUNNING MLTCST signal signal detect duplex full auto-negotiate complete flow control rx pause SFPVendor IBM SFPVendorID 53P1476000XY1 SFPPartNumber IBM42P21SNY SFPRev AA102P21SNY 10.3.10.
Chapter 12 Command Line Interface Reference show interface Table 12-32 Description of Fields in the “show interface” Command Output (continued) Field Description Interface The interface name. IP/Netmask The IP address and subnet mask of the interface. AutoNegotiation For management, HA and Gigabit Ethernet interfaces, the status of autonegotiation (enabled or disabled). Speed The port speed. Duplex The duplex setting.
Chapter 12 Command Line Interface Reference show interface fci1 fci2 ge1 ge2 up up up up type type 02012d020304 type 02034d030405 type 10.1.10.45/ffffff00 10.3.10.
Chapter 12 Command Line Interface Reference show interface Table 12-33 Description of Port Attributes in the “show interface stats” Command Output (continued) Port Attribute Description Logout Count Incremented when a user logs out. Invalid Dest Add Number of invalid destination addresses received. Class2 Frames In Number of class 2 frames received by this port. Class3 Frames In Number of class 3 frames received by this port. Total Rx Frames Total number of frames received by this port.
Chapter 12 Command Line Interface Reference show interface Table 12-33 Description of Port Attributes in the “show interface stats” Command Output (continued) Port Attribute Description Total Link Reset Total number of link reset primitives. Rx Offline Seq Number of offline sequences received. An OLS is issued for link initialization, an NOS state, or to enter the offline state. Tx Offline Seq Number of offline sequences issued by this port.
Chapter 12 Command Line Interface Reference show ip show ip To display information about the SN 5428-2 Storage Router network, including a variety of protocol stack statistics, use the show ip command. show ip {arp | hosts | rip | tcp | udp} show ip [icmp | route] stats show ip route [all] show ip [interface {if-name | all}] [tcp | udp] stats Syntax Description arp Display the ARP table. hosts Display all known hosts on the IP network. rip Display Routing Information Protocol (RIP) information.
Chapter 12 Command Line Interface Reference show ip Examples • Use the rip keyword to display RIP timers and flags. • Use the route keyword to display the routing table. Use the all keyword to display all routes, including non-operational routes. 0.0.0.0/32 is the default route. • Use the tcp keyword to display active TCP connections, including the SN 5428-2 web server and other server tasks. • Use the udp keyword to display User Datagram Protocol (UDP) activity on the system.
Chapter 12 Command Line Interface Reference show ip Related Commands Command Description ip rip enable Enable the storage router to learn dynamic routing using the routing information protocol (RIP). ip rip timers Configure various RIP timers. ip route Add a static route to the SN 5428-2 Storage Router routing table.
Chapter 12 Command Line Interface Reference show logging show logging To display the logging table routing rules or to display contents of the log file, use the show logging command. show logging [[all | last nn] [match expression] | size] Syntax Descriptions all (Optional) Display all log file entries. last nn (Optional) Display the last nn lines from the current log file. match expression (Optional) Display all entries that match the specified string or regular expression.
Chapter 12 Command Line Interface Reference show logging The following example matches on a regular expression and displays all messages from the UI or IF facility, or all messages at notice or debug level. Only the last 50 log messages are searched for matches. [sn5428-2a]# show logging last 50 match “(%(UI|IF)-|-[67]-)” Oct 10 13:28:45: %UI-5-EWSSSL: Starting SSL OpenSSL 0.9.
Chapter 12 Command Line Interface Reference show memory show memory To display information about memory and related resources, use the show memory command. show memory Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Use this command to display information about the storage router memory usage.
Chapter 12 Command Line Interface Reference show memory Related Commands Command Description show buffers Display information about buffer pools. show modules Display addressing information related to the software modules. show stack Display the memory stack on a per-task basis. show task Display information about the tasks running in the storage router. show tech-support Display a variety of diagnostic information for use by Cisco Technical Support professionals.
Chapter 12 Command Line Interface Reference show modules show modules To display addressing information about the modules included in the SN 5428-2 Storage Router, use the show modules command. show modules Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show modules sysDpp.out 0xd62f8d8 scsiTargetFE.out 0xd62f660 scsiTcpAuth.out 0xd5e3448 slpcommon.out 0xd5dc2f8 libslp.out 0xd5d46e0 slpattr.out 0xd5cced0 slpd.out 0xd5c5e20 slptool.out 0xd5c0db0 scsiTcpServer.out 0xd5c0b68 ttcp.out 0xd45c8b8 confMgmt.out 0xd459830 hdwmon.out 0xd4595a8 diagMon.out 0xd42cd28 diagCppUtils.out 0xd42cae0 diagCppTests.out 0xd426db8 diagDppTests.out 0xd421360 sn5428TestTable.out 0xd4210a8 confXML.out 0xd420e70 confObj.
Chapter 12 Command Line Interface Reference show modules Related Commands Command Description show buffers Display information about buffer pools. show memory Display information about memory and related resources. show stack Display the memory stack on a per-task basis. show task Display information about the tasks running in the storage router. show tech-support Display a variety of diagnostic information for use by Cisco Technical Support professionals.
Chapter 12 Command Line Interface Reference show restrict show restrict To display current restrictions on the use of the SN 5428-2 Storage Router console, interfaces, and ports, use the show restrict command. show restrict Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show restrict ge2 21 22 23 80 161 443 closed closed closed closed open closed tp ssh telnet http snmp ssl Console Passwords: disabled Related Commands Command Description restrict Secure access to storage router interfaces by communications protocols and services. restrict console Enable or disable password checking on the console interface.
Chapter 12 Command Line Interface Reference show route show route To display all static routes that have been configured, including those that have not been added to the routing table because the associated interface is not yet configured, use the show route command. show route Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show runningconfig show runningconfig To display the current running configuration of the SN 5428-2 Storage Router, or save the commands used to create the running configuration to a file, use the show runningconfig command. show runningconfig [to filename] Syntax Description to filename Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show runningconfig Table 12-34 Elements Displayed for the show runningconfig Command (continued) Examples Element Description FCIP FCIP instance configuration information. FC PORTS Operational characteristics of the Fibre Channel interfaces. FC SWITCH Global Fibre Channel attributes. FC ZONE Zone configuration information. FC ZONE ALIAS Zone alias configuration information. FC ZONE SET Zone set configuration information.
Chapter 12 Command Line Interface Reference show runningconfig ! accesslist aegis accesslist aegis 10.2.0.23/255.255.255.255 accesslist aegis 10.3.0.36/255.255.255.255 accesslist aegis 10.4.0.49/255.255.255.255 accesslist aegis iscsi-name ign.1987-05.com.cisco.08.80342789af73ebcdef123.xxx accesslist aegis iscsi-name ign.1987-05.com.cisco.08.7125abc9af73ebcdef123.xxx accesslist aegis iscsi-name ign.1987-05.com.cisco.08.1234abecf9876bac00034.xxx accesslist aegis chap-username 12h7b.lab2.
Chapter 12 Command Line Interface Reference show runningconfig ip route 10.1.40.243/255.255.255.255 10.1.10.201 ip route 10.1.50.249/255.255.255.255 10.1.10.201 ip default-gateway 10.1.10.201 ! ! RIP ! no ip rip enable ip rip timers invalid 180 ! ADMIN LOGIN ! admin password ! ! MONITOR LOGIN ! monitor password ! ! SNTP ! clock timezone CST6CDT ntp peer 10.1.60.
Chapter 12 Command Line Interface Reference show runningconfig ! SYSLOG ! logging syslog 10.4.5.
Chapter 12 Command Line Interface Reference show runningconfig no fcswitch domainid lock enable fcswitch interop-credit 12 ! ! FC ZONE ALIAS ! fcalias iscsi fcalias iscsi member wwpn 280000059ac58710 fcalias iscsi member wwpn 290000059ac58710 fcalias foo fcalias foo member wwpn 20:1b:00:38:15:74:b1:19 ! ! FC ZONE ! zone footest zone footest member wwpn 201a0381474b118 zone footest member fcalias foo ! ! FC ZONE SET ! zoneset thor zoneset thor zone agamemnon no zoneset thor enable ! ! FC PORT ! interface
Chapter 12 Command Line Interface Reference show runningconfig interface fc5 fan-enable enable interface fc5 ext-credit 0 interface fc5 mfs-bundle enable timeout interface fc5 linkspeed auto interface fc5 type gl-port ! interface fc6 enable interface fc6 ms-enable enable no interface fc6 al-fairness enable interface fc6 fan-enable enable interface fc6 ext-credit 0 interface fc6 mfs-bundle enable timeout interface fc6 linkspeed auto interface fc6 type gl-port ! interface fc7 enable interface fc7 ms-enable
Chapter 12 Command Line Interface Reference show runningconfig Related Commands Command Description read script Read and execute the CLI commands in the named script file. restore all Restore the contents of the named configuration file into memory. save all Save all configuration information show bootconfig Display the bootable configuration, or create a command file based on the bootable configuration.
Chapter 12 Command Line Interface Reference show savedconfig show savedconfig To list the available files in the savedconfig directory or to view the contents of a specific configuration file, use the show savedconfig command. Configuration files are stored in the savedconfig directory. show savedconfig [filename] Syntax Description filename Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show savedconfig Related Commands Command Description copy Copy the named configuration or script file from a remote location to the storage router or from the storage router to a remote location. delete savedconfig Remove a saved configuration file from the storage router. restore aaa Restore AAA authentication services from the named configuration file.
Chapter 12 Command Line Interface Reference show script show script To list the available files in the script directory or to view the contents of a specific command file, use the show script command. Configuration files are stored in the script directory. show script [filename] Syntax Description filename Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced. (Optional) The name of the command file to display.
Chapter 12 Command Line Interface Reference show scsirouter show scsirouter To display configuration information and operational statistics related to the named SCSI routing instance or all instances, use the show scsirouter command.
Chapter 12 Command Line Interface Reference show scsirouter host (Optional) Display status and other operational data for IP hosts currently connected to the named SCSI routing instance. host table (Optional) Display information about all IP hosts that have attempted to connect to the named SCSI routing instance. serverif (Optional) Display configuration information for the Gigabit Ethernet interface associated with the named SCSI routing instance.
Chapter 12 Command Line Interface Reference show scsirouter Use the connection or host keyword to display specific operational data for the named SCSI routing instance. Examples • The command show scsirouter name host stats displays IP host status and operational statistics for currently connected IP hosts for the named SCSI routing instance.
Chapter 12 Command Line Interface Reference show scsirouter The following is example output from the show scsirouter all host table command. If you are going to use iSCSI Name entries for access control, you can configure your IP hosts and attempt to access the desired SCSI routing instance. Then issue this command to display the iSCSI Name information, which can be used to populate the desired access list. [SN5428-2A]# show scsirouter all host table Name: iqn.1987-05.com.cisco.01.
Chapter 12 Command Line Interface Reference show scsirouter The following is example output from the show scsirouter all failover brief command. This command shows the eligibility of each SCSI routing instance for each storage router in the cluster.
Chapter 12 Command Line Interface Reference show sessions show sessions To display information about active Telnet, SSH or GUI sessions to the SN 5428-2 Storage Router, use the show sessions command. show sessions {all | cli | gui} Syntax Description all Display all active Telnet or GUI management sessions. cli Display only active CLI sessions. gui Display only active GUI sessions. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference show sessions Related Commands Command Description admin password Set the login password for administrative access to the storage router management interface. monitor password Set the login password for view-only access to the storage router management interface. session-timeout Set the number of minutes a management session to the storage router can be inactive before the session times out.
Chapter 12 Command Line Interface Reference show slp show slp To display the status of the Service Location Protocol (SLP) service and the interface address where the SLP service is listening for incoming SLP service requests, use the show slp command. show slp Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show snmp show snmp To display SNMP management configuration information for the SN 5428-2 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. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show snmp Link Up/Down Enable Link Up/Down Enable Link Up/Down Enable Link Up/Down Enable System location is: Related Commands for fc7: for fc8: for ge1: for ge2: Test lab enabled disabled enabled enabled Command Description setup netmgmt Run the wizard to configure network management. snmp-server Configure the storage router for SNMP management.
Chapter 12 Command Line Interface Reference show software version show software version To display a list of software versions available on the SN 5428-2 Storage Router, use the show software version command. show software version {v.x.y | all | boot | current} Syntax Description all Display information about all versions of software available on the storage router. v.x.y Display information about the specified software version, including the download file name.
Chapter 12 Command Line Interface Reference show software version Tftp Hostname: Tftp Directory: Software Space Available: 34250.0 KB Current Version: 3.3.1-K9 Boot Version: 3.3.1-K9 The following example displays the download file name for the currently running version of software: [SN5428-2A]# show software version current Version -------------------3.3.1-K9 Boot ---OK Hash ---OK Sign ---N/A Crash ----0 Size ---------11229.
Chapter 12 Command Line Interface Reference show ssh show ssh To display Secure Shell (SSH) server configuration, use the show ssh command. show ssh Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator and Monitor. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Use this command to verify SSH is configured for the storage router and that the SSH service is running.
Chapter 12 Command Line Interface Reference show ssh fingerprint show ssh fingerprint To display the status of SSH key generation and the current public key information for the SN 5428-2 Storage Router, use the show ssh fingerprint command. show ssh fingerprint Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator and Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show ssh fingerprint Related Commands Command Description restrict Secure access to storage router interfaces by communications protocols and services. show restrict Display configurable security settings for the storage router interfaces. show sessions Display information about active Telnet, SSH or GUI sessions to the storage router. show ssh Display SSH server configuration. ssh enable Enable SSH and start the SSH service.
Chapter 12 Command Line Interface Reference show stack 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. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The show stack command is designed for debug purposes and should be used under the guidance of a Cisco Technical Support professional.
Chapter 12 Command Line Interface Reference show stack HA_monitor HA_appctrl hdwMonitor sensorMntr eeScratch cppEeIpc dpp0EeIpc nuLogTask tSnmpTmr tSMLMgr tfeTask cppEeJob dpp0EeJob tNetTask ui tSntpcMon slpTask srMonitor tFcSwMon idleTask INTERRUPT HA_monitor_t HA_appctrl_t 0x000d452410 entitySensor ExeEng::scra ExeEng::ipcT ExeEng::ipcT LogTask::tas 0x00000508d0 0x000d642c8c ScsiTargetGl ExeEng::jobT ExeEng::jobT netTask tEmWeb SntpConf::sn slpd_task srMonitor(vo FcSwApp::fcs 0x000d8603a4 c975b68 c97
Chapter 12 Command Line Interface Reference show static show static To display the currently configured IP host to Fibre Channel (FC) address mappings saved in the storage router, use the show static command. This command is only available when the storage router is deployed for static transparent SCSI routing. show static iscsibindings Syntax Description iscsibindings Defaults None. Command Modes Administrator and Monitor. Command History Release Modification 3.3.1 This command was introduced.
Chapter 12 Command Line Interface Reference show system show system To display a variety of system information about the SN 5428-2 Storage Router, including system name and deployment option, use the show system command. A table of information about storage router network interfaces also displays. show system [from {filename | bootconfig | runningconfig}] Syntax Description from filename (Optional) Display the system configuration information from the specified configuration file.
Chapter 12 Command Line Interface Reference show system Domain: mystoragenet.com Telnet session timeout: 15 Model Number SN 5428-2-K9 RME060702 System Processor Device lo0 mgmt ha ge1 ge2 Rev A0 A0 Serial Number SAD051301XB SAD05130130 Part Number 800-21476-01 73-7996-04 IP/Netmask 127.0.0.1/8 10.1.10.244/24 10.1.20.56/24 MAC 00:00:00:00:00:00 00:01:2c:06:13:70 00:01:64:40:ef:c1 10.1.0.45/24 02:02:3d:01:1c:a5 Table 12-38 describes the fields in the display.
Chapter 12 Command Line Interface Reference show system The following is example output from the show system from bootconfig command: ! ! SYSTEM ! hostname SN5428-2A ! ! Mgmt Port ! interface mgmt ip-address 10.1.10.244/255.255.255.0 ! ! HA Port ! interface ha ip-address 10.1.20.56/255.255.255.
Chapter 12 Command Line Interface Reference show system snmp-server linkupdown fc1 snmp-server linkupdown fc15 snmp-server linkupdown fc2 snmp-server linkupdown fc3 snmp-server linkupdown fc4 snmp-server linkupdown fc5 snmp-server linkupdown fc6 snmp-server linkupdown fc7 snmp-server linkupdown fc8 ! ! DNS ! ip name-server 10.1.40.243 10.1.50.249 ip domain-name cisco.com ! ! TELNET ! session-timeout 15 ! ! SSH ! ssh enable ! ! SOFTWARE ! software http url "http://www.cisco.
Chapter 12 Command Line Interface Reference show system ! restrict ge2 ftp no restrict ge2 telnet restrict ge2 http restrict ge2 snmp restrict ge2 ssl restrict ge2 ssh ! ! ! CDP ! cdp enable cdp timer 60 cdp interface mgmt enable cdp interface ha enable cdp interface ge1 enable cdp interface ge2 enable Related Commands Commands Description hostname Specify the storage router system name. ip name-server Specify the IP addresses of a primary (and optional secondary) DNS.
Chapter 12 Command Line Interface Reference show task show task To display information about tasks running in the SN 5428-2 Storage Router, issue the show task command. show task {task-id | all} Syntax Description task-id The TID for a specific task, obtained from the show task all display. Prefix the TID with 0x, which indicates a hex number. all Display information about all running tasks. Defaults None. Command Modes Administrator and Monitor. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference show task ui VTP tSnmpd tProtoCDP tCfgCopy HA_newcfg HA_monitor HA_appctrl hdwMonitor sensorMntr eeScratch cppEeIpc dpp0EeIpc nuLogTask tSnmpTmr tSMLMgr tfeTask cppEeJob dpp0EeJob tNetTask tSntpcMon slpTask srMonitor tFcSwMon idleTask tEmWeb task__3Vtp 50af0 cdp_prot__Fv listWatcher_ HA_newcfg_ta HA_monitor_t HA_appctrl_t d452410 entitySensor scratchTask_ ipcTaskExec_ ipcTaskExec_ task__7LogTa 508d0 d642c8c tfeTask__19S jobTaskExec_ jobTaskExec_ netTask sntpcM
Chapter 12 Command Line Interface Reference show task Related Commands Command Description show buffers Display information about buffer pools. show memory Display information about memory and related resources. show modules Display addressing information related to the software modules. show stack Display the memory stack on a per-task basis. show tech-support Display a variety of diagnostic information for use by Cisco Technical Support professionals.
Chapter 12 Command Line Interface Reference show tech-support 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 or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show tech-support Examples • shop ip udp stats • show snmp • show devices • show accesslist all • show scsirouter all • show bootconfig • show runningconfig • show ha node stats • show ha app list stats • show ha app all stats • show diagnostics • show boot • show memory • show task all • show stack • show modules • show buffers • show debug scsirouter all tfestatus • show debug fcswitch all • show debug mailboxtrace all
Chapter 12 Command Line Interface Reference show tech-support Related Commands Command Description show accesslist Display the contents of the named access list or all access lists. show admin Display system administrator contact information. show boot Display system boot information and startup file parameters. show bootconfig Display the bootable configuration, or create a command file based on the bootable configuration. show buffers Display information about buffer pools.
Chapter 12 Command Line Interface Reference show telnet show telnet To display the status of the SN 5428-2 Storage Router Telnet server, use the show telnet command. show telnet Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator and Monitor. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Use this command to display the status of the Telnet server.
Chapter 12 Command Line Interface Reference show version show version To display version information for system-level software and applications, use the show version command. show version Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show version Table 12-39 Description of Fields in the “show version” Command Output (continued) Related Commands Field Description System Bootstrap The version of software that will run when the storage router is next restarted. Operating System The version of software that is currently running. Application The current application version. Web Server The version number of the SN 5428-2 web server software.
Chapter 12 Command Line Interface Reference show vlan show vlan To view configuration and operational information about the specified VLAN, use the show vlan command. show vlan [id vid] [brief] show vlan [id vid] from {filename | bootconfig | runningconfig} Syntax Description id vid (Optional) ID of the VLAN to be displayed. brief (Optional) Display name, status, and ports for each VLAN.
Chapter 12 Command Line Interface Reference show vlan Examples The following is example output from the show vlan command, followed by example output from the show vlan config command for the VLAN ID 101: [SN5428-2A]# show vlan VLAN Name ---- -------------------------------101 vlanfoo1 102 vlanfoo2 VLAN ---101 102 Type ----enet enet MTU ----1500 1500 Status --------active active Ports ------------------------------ge1, ge2 ge2 Interfaces ------------------------------ge2VLAN101 ge2VLAN102 [SN5428-2
Chapter 12 Command Line Interface Reference show vtp show vtp To display general configuration and status information about the VLAN Trunking Protocol (VTP), use the show vtp command. show vtp [config | stats] Syntax Description config (Optional) Display mode and domain information. stats (Optional) Display operational statistics. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference show vtp The following is example output from the show vtp stats command: [SN5428-2A]# show vtp stats Summary advertisements received Subset advertisements received Request advertisements received Request advertisements transmitted Related Commands : : : : 3 2 5 5 Command Description restore vlan Restore VLAN configuration information from the named configuration file. save all Save all configuration information, including VLAN information.
Chapter 12 Command Line Interface Reference show zone show zone To display configuration and operational information for Fibre Channel fabric zones from the local zoning database, use the show zone command. show zone {name | all | brief} Syntax Description name Display member type and value for the specified zone. all Display member type and value for all zones. brief Display member value only for all zones. Defaults None. Command Modes Administrator or Monitor.
Chapter 12 Command Line Interface Reference show zone Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete fcalias Delete the named alias or the specified alias member. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database.
Chapter 12 Command Line Interface Reference show zoneset show zoneset To display configuration and operational information for Fibre Channel fabric zone sets, use the show zoneset command. show zoneset {name | all | brief} Syntax Description name Display the member count for the specified zone set. all Display configuration information for all zone sets. brief Display the active flag and the member count only for all zone sets. Defaults None Command Modes Administrator or Monitor.
Chapter 12 Command Line Interface Reference show zoneset Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete fcalias Delete the named alias or the specified alias member. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database.
Chapter 12 Command Line Interface Reference slp findattrs slp findattrs To discover the attributes of a specific Service Location Protocol (SLP) registered service, use the slp findattrs command. slp findattrs service [attribute] Syntax Description service The SLP service. Use the slp findsrvs command to locate the specific service. attribute Display the value of the specified service attribute. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference slp findattrs Related Commands Command Description scsirouter slp enable Enable the advertisement of the targets of the named SCSI routing instance with the SLP service. show slp Display the status of the SLP service and the interface address where the SLP service is listening for incoming SLP service requests. slp findsrvs Locate a SLP registered service of a specific type on the local subnet.
Chapter 12 Command Line Interface Reference slp findsrvs slp findsrvs To locate a Service Location Protocol (SLP) registered service of a specific type on the local subnet where the SN 5428-2 Storage Router is located, use the slp findsrvs command. slp findsrvs service [(attribute=value)] Syntax Description service The SLP service type. For example, the SLP service type for iSCSI targets is iscsi:target. attribute=value Display the specified service attribute value pair.
Chapter 12 Command Line Interface Reference slp findsrvs Related Commands Command Description scsirouter slp enable Enable the advertisement of the targets of the named SCSI routing instance with the SLP service. show slp Display the status of the SLP service and the interface address where the SLP service is listening for incoming SLP service requests. slp findattrs Discover the attributes of a specific SLP registered service.
Chapter 12 Command Line Interface Reference slp findsrvtypes slp findsrvtypes To discover all Service Location Protocol (SLP) registered services on the local subnet where the SN 5428-2 Storage Router is located, use the slp findsrvtypes command. slp findsrvtypes Syntax Description This command has no arguments or keywords. Defaults None. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference snmp-server snmp-server To configure SNMP management on the SN 5428-2 Storage Router, use the snmp-server command. To disable SNMP management or specific host or traps, use the no forms of this command. snmp-server community community-name {ro | rw} snmp-server host A.B.C.D [version version-number] traps snmp-server linkupdown {all | if-name} snmp-server location text-string snmp-server {sendauthtraps | sendfrutraps} no snmp-server host {A.B.C.
Chapter 12 Command Line Interface Reference snmp-server Defaults The default read-only community name is public. This is also known as the getcommunity. The default read/write community name is private. This is also known as the setcommunity. SNMP notifications are disabled by default. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines A variety of network management methods may be used with the storage router, including SNMP.
Chapter 12 Command Line Interface Reference snmp-server Related Commands Command Description setup mgmt Run the wizard to configure the management interface. setup netmgmt Run the wizard to configure network management. show snmp Display the SNMP management configuration information for the storage router.
Chapter 12 Command Line Interface Reference software http url software http url To configure the default location from which to download updated software to the SN 5428-2 Storage Router via HTTP protocol, use the software http url command. software http url {http://servername/path | none} Syntax Description http://servername/path The complete URL identifying the location from which to download storage router software. none Delete the current download location and leave the URL blank.
Chapter 12 Command Line Interface Reference software http url Related Commands Command Description download software Download the list of available software versions or the specified version of software from the named location. save all Save all configuration information, including default download location for updated SN 5428-2 software. save system Save selected system configuration information, including default download location for updated SN 5428-2 software.
Chapter 12 Command Line Interface Reference software http username software http username To configure an optional user name and password used to retrieve updated SN 5428-2 software from the HTTP download location, use the software http username command. software http username {webserver-username | none} [password webserver-password] Syntax Description webserver-username The user name required to retrieve SN 5428-2 software from the download location.
Chapter 12 Command Line Interface Reference software http username Related Commands Command Description download software Download the list of available software versions or the specified version of software from the named location. save all Save all configuration information, including default download location for updated SN 5428-2 software. save system Save selected system configuration information, including default download location for updated SN 5428-2 software.
Chapter 12 Command Line Interface Reference software proxy software proxy To configure the address and port of a proxy server to be used when downloading updated software to the SN 5428-2 Storage Router via HTTP protocol, use the software proxy command. software proxy address address [port nn] software proxy port nn Syntax Description address The IP address or URL of the proxy server. To remove a proxy server address, set the address string to blank, using “ ”.
Chapter 12 Command Line Interface Reference software proxy Related Commands Command Description download software Download the list of available software versions or the specified version of software from the named location. save all Save all configuration information, including default download location for updated SN 5428-2 software. save system Save selected system configuration information, including default download location for updated SN 5428-2 software.
Chapter 12 Command Line Interface Reference software proxy url software proxy url To configure the default location from which to download updated software to the SN 5428-2 Storage Router via HTTP protocol using the configured proxy server, use the software proxy url command. software proxy url {http://servername/path | none} Syntax Description http://servername/path The complete URL identifying the location from which to download SN 5428-2 software via the configured proxy server.
Chapter 12 Command Line Interface Reference software proxy url Related Commands Command Description download software Download the list of available software versions or the specified version of software from the named location. save all Save all configuration information, including default download location for updated SN 5428-2 software. save system Save selected system configuration information, including default download location for updated SN 5428-2 software.
Chapter 12 Command Line Interface Reference software proxy username software proxy username To configure a user name and an optional password to be used to retrieve updated SN 5428-2 software from the proxy download location, use the software proxy username command. software proxy username {webserver-username | none} [password webserver-password] Syntax Description webserver-username The user name required to retrieve SN 5428-2 software from the proxy download location.
Chapter 12 Command Line Interface Reference software proxy username Related Commands Command Description download software Download the list of available software versions or the specified version of software from the named location. save all Save all configuration information, including default download location for updated SN 5428-2 software. save system Save selected system configuration information, including default download location for updated SN 5428-2 software.
Chapter 12 Command Line Interface Reference software tftp software tftp To configure host and directory information to be used when downloading updated software to the SN 5428-2 Storage Router via the Trivial File Transfer Protocol (TFTP), use the software tftp command. software tftp directory {directory_name | none} software tftp hostname hostname [directory directory_name] Syntax Description directory_name The name of the TFTP base directory.
Chapter 12 Command Line Interface Reference software tftp Related Commands Command Description download software Download the list of available software versions or the specified version of software from the named location. save all Save all configuration information, including default download location for updated SN 5428-2 software. save system Save selected system configuration information, including default download location for updated SN 5428-2 software.
Chapter 12 Command Line Interface Reference software version software version To specify the version of software to run the next time the SN 5428-2 Storage Router is restarted, use the software version command. This command forces a system reset and changes the running version of SN 5428-2 software. software version v.x.y Syntax Description v.x.y Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced.
Chapter 12 Command Line Interface Reference software version scsiTargetFE.out scsiTargetBE.out virtdev.out scsiTcpAuth.out scsiTcpServer.out scsiTcpClient.out ttcp.out confMgmt.out hdwmon.out diag.out confXML.out confObj.out openssl.out openssh.out clusterApp.out cdp.out systemApp.out ipRouter.out srMon.out scsiRouter.out frameRacer.out authServerApp.out fcSwApp.out fdisk.out sysMon.out ui.out snmp_util.out mib2.out ifx.out ether.out mau_if.out mau_neg.out entity.out entity_sensor.out cdp_snmp.
Chapter 12 Command Line Interface Reference software version Related Commands Command Description delete software version Remove the specified version of software from the storage router. download software Download the list of available software versions or the specified version of software from the named location. save all Save all configuration information, including default download location for updated SN 5428-2 software.
Chapter 12 Command Line Interface Reference ssh enable ssh enable To enable Secure Shell (SSH) for the SN 5428-2 Storage Router and to start the SSH service, use the ssh enable command. To disable SSH and stop the SSH service, use the no form of this command. ssh enable no ssh enable Syntax Description This command has no arguments or keywords. Defaults SSH is enabled and the SSH service is started by default. Command Modes Administrator. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference ssh keygen ssh keygen To generate the SSH public and private key pair for the SN 5428-2 Storage Router, use the ssh keygen command. ssh keygen [bits nn] Syntax Description bits nn Defaults 1024 bit public and private keys are generated for the storage router. Command Modes Administrator or Monitor. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Specify the number of bits to be used for the key encryption.
Chapter 12 Command Line Interface Reference ssh keygen Related Commands Command Description restrict Secure access to storage router interfaces by communications protocols and services. show ssh Display SSH server configuration. show ssh fingerprint Display SSH key generation status and current public key information. ssh enable Enable SSH and start the SSH service.
Chapter 12 Command Line Interface Reference tacacs-server host tacacs-server host To specify a TACACS+ server to be used for AAA authentication services, use the tacacs-server host command. Use the no form of this command to delete the specified host. tacacs-server host ip-address [auth-port port-number] [timeout seconds] [key key-string] no tacacs-server host ip-address [auth-port nn] Syntax Description ip-address The IP address of the TACACS+ server.
Chapter 12 Command Line Interface Reference tacacs-server host Note Examples Verification of IP addresses in a server group occurs only at runtime. If a TACACS+ server group contains an IP address that is not defined as a TACACS+ server, the authentication process generates error messages and the IP address is skipped. This could cause unexpected authentication failures. The following example specifies the server with IP address 172.29.39.
Chapter 12 Command Line Interface Reference tacacs-server key tacacs-server key To set the authentication and encryption key used for all TACACS+ communications between the SN 5428-2 Storage Router and the TACACS+ daemon, use the tacacs-server key command. To disable the key, use the no form of this command. tacacs-server key key-string no tacacs-server key Syntax Description key-string Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1.
Chapter 12 Command Line Interface Reference tacacs-server key Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference tacacs-server timeout tacacs-server timeout To set the global interval that the SN 5428-2 Storage Router waits for a TACACS+ server to reply, use the tacacs-server timeout command.To restore the default, use the no form of this command. tacacs-server timeout seconds no tacacs-server timeout Syntax Description seconds Defaults The timeout value defaults to five seconds. Command Modes Administrator. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference tacacs-server timeout Related Commands Command Description aaa authentication enable Configure AAA authentication services for Administrator mode access to the SN 5428-2 Storage Router via the CLI enable command. aaa authentication iscsi Configure the AAA authentication services to be used for iSCSI authentication. aaa authentication login Configure AAA authentication services for Monitor mode access to the SN 5428-2 Storage Router via the CLI.
Chapter 12 Command Line Interface Reference telnet enable telnet enable To enable Telnet for the SN 5428-2 Storage Router and to start the Telnet server, use the telnet enable command. To disable Telnet and stop the Telnet server, use the no form of this command. telnet enable no telnet enable Syntax Description This command has no arguments or keywords. Defaults Telnet is enabled and the Telnet server is started by default. Command Modes Administrator. Command History Release Modification 3.2.
Chapter 12 Command Line Interface Reference username password username password To build a local user name database for use with the local method of AAA authentication services, use the username password command. Use the no form of this command to delete the specified user name. username user-name password password-string no username user-name Syntax Description user-name A valid user name. Enter a maximum of 63 characters. password-string The password associated with the specified user name.
Chapter 12 Command Line Interface Reference username password • You can re-enter an encrypted password using the normal username password command. Enter the encrypted password in single or double quotes, starting with 9 and a single space. For example, copying and pasting password "9 ea9bb0c57ca4806d3555f3f78a4204177a" from the example above into the username pat command would create an entry for pat in the username database. The user named pat would have the same password as the user named foo.
Chapter 12 Command Line Interface Reference verify software version verify software version To check the specified software version for problems, issue the verify software version command. verify software version {version-id | all | boot | current} Syntax Description version-id A specific version of software, which must be available to the storage router. all Verify all software versions available to the storage router. boot The software version that is set to boot at the next system restart.
Chapter 12 Command Line Interface Reference verify software version Related Commands virtdev.out scsiTcpAuth.out scsiTcpServer.out scsiTcpClient.out ttcp.out confMgmt.out hdwmon.out diag.out confXML.out confObj.out openssl.out openssh.out clusterApp.out cdp.out systemApp.out ipRouter.out srMon.out scsiRouter.out frameRacer.out authServerApp.out fcSwApp.out fdisk.out sysMon.out ui.out snmp_util.out mib2.out ifx.out ether.out mau_if.out mau_neg.out entity.out entity_sensor.out cdp_snmp.out iscsi_mib.
Chapter 12 Command Line Interface Reference vlan vlan To configure a VLAN on the SN 5428-2 Storage Router, use the vlan command. To delete a VLAN, use the no form of this command. vlan vid [name vlan_name] [mtusize nn] no vlan vid [force] Syntax Description vid VLAN identification (VID) number. Enter an integer from 1 to 4095. name vlan_name (Optional) The name of the VLAN, which can be up to 32 characters in length.
Chapter 12 Command Line Interface Reference vlan The storage router uses 802.1Q VLAN encapsulation to carry VLAN information on packets sent and received on the Gigabit Ethernet interface. The 802.1Q packet tag is a four-byte field inserted between the source MAC address and ether-type fields in the layer 2 header. It consists of a two-byte Tag Protocol Identifier (TPID) field and a two-byte Tag Control Information (TCI) field.
Chapter 12 Command Line Interface Reference vtp domain vtp domain To assign a VLAN Trunking Protocol (VTP) domain name to the SN 5428-2 Storage Router, use the vtp domain command. VLAN information will not be accepted from a switch which is in a different domain. vtp domain {domain_name | none} Syntax Description domain_name The name of the domain to which the storage router belongs. none The storage router is not assigned to a specific domain.
Chapter 12 Command Line Interface Reference vtp domain Related Commands Command Description restore vlan Restore VLAN configuration information from the named configuration file. save all Save all configuration information, including VLAN information. save scsirouter Save configuration information for the named SCSI routing instance. save system Save selected system configuration information, including VLAN information. save vlan Save configuration information for the named VLAN or all VLANs.
Chapter 12 Command Line Interface Reference vtp mode vtp mode To assign the VTP mode in which the SN 5428-2 Storage Router operates, use the vtp mode command. vtp mode {client | transparent} Syntax Description client The storage router will operate in VTP Client mode. It will exchange VTP packets with an externally attached switch to learn about the VLANs that are accessible in the network. This is the default. transparent The storage router will operate in VTP Transparent mode.
Chapter 12 Command Line Interface Reference vtp mode When operating in transparent mode, the storage router ignores any VTP packets it may receive. VLANs are configured using the GUI or the CLI vlan command. Use transparent mode when the storage router is connected to a switched network that does not support VTP but does support 802.1Q VLANs.
Chapter 12 Command Line Interface Reference zone zone To create a Fibre Channel (FC) switched fabric zone, use the zone command. zone name Syntax Description name Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The name of the zone created by this command. Enter a maximum of 31 characters. The name must begin with an alpha character.
Chapter 12 Command Line Interface Reference zone Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or to delete the entire named zone set from the zoning database. fcalias Create an alias entity for use in Fibre Channel zoning.
Chapter 12 Command Line Interface Reference zone member zone member To add a device or an alias to a zone, use the zone member command. zone name member {fcalias alias-name | wwpn xxxxxxxxxxxxxxxx} Syntax Description name The name of the zone to which the member is being added. fcalias alias-name Make the specified alias a member of the named zone. wwpn xxxxxxxxxxxxxxxx Make the specified WWPN a member of the named zone. Note WWPN address notation is represented by 16 hex digits.
Chapter 12 Command Line Interface Reference zone member Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or to delete the entire named zone set from the zoning database.
Chapter 12 Command Line Interface Reference zoneset zoneset To create a Fibre Channel (FC) switched fabric zone set, use the zoneset command. zoneset name Syntax Description name Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines Caution The name of the zone set created by this command. Enter a maximum of 31 characters. The name must begin with an alpha character. A zone set is a named group of fabric zones.
Chapter 12 Command Line Interface Reference zoneset Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or to delete the entire named zone set from the zoning database. fcalias Create an alias entity for use in Fibre Channel zoning.
Chapter 12 Command Line Interface Reference zoneset enable zoneset enable To activate a zone set, use the zoneset enable command. To deactivate a zone set, use the no form of this command. zoneset name enable no zoneset name enable Syntax Description name Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines The name of the zone set being activated.
Chapter 12 Command Line Interface Reference zoneset enable Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or to delete the entire named zone set from the zoning database.
Chapter 12 Command Line Interface Reference zoneset zone zoneset zone To add a member zone to a zone set, use the zoneset zone command. zoneset name zone name Syntax Description name The name of the zone set to which the member is being added. zone name The name of the zone. Defaults None. Command Modes Administrator. Command History Release Modification 3.2.1 This command was introduced. Usage Guidelines A zone set is a named group of fabric zones.
Chapter 12 Command Line Interface Reference zoneset zone Related Commands Command Description clear fcswitch Clear the switch log files of all entries or clear stored zoning configuration information. delete zone Delete the specified Fibre Channel zone or the specified member of the zone from the zoning database. delete zoneset Delete the specified zone from the zone set or to delete the entire named zone set from the zoning database.
I N D EX accessing iSCSI targets Symbols access lists * (asterisk), meaning of in prompt 2-10 denying 6-12 6-13 accesslist A.B.C.D/bits command accesslist chap-username command Numerics accesslist command 5428-2-K9 model number ix 802.
Index adding (continued) routes authentication (continued) configuration (continued) 12-201, 12-211 static routes saving 12-211 storage routers to cluster verifying 10-2 TACACS+ servers to server groups zone members Enable service admin contactinfo command enabling 3-8, 12-36 contact information 3-8, 12-36 displaying mode 9-13 9-19 9-6 example Login configuration (figure) 9-10 iSCSI configuration elements (figure) 9-5 9-15 local username database 2-13, 12-105 admin password comman
Index boldface font CHAP xi boldface screen font braces 1-22, 9-2 character case sensitivity in CLI xi CIDR style xi buffer credits 2-10 xi Cisco Discovery Protocol configuring donor port See CDP 5-3 default value, setting donating to other FC ports value, setting classless interdomain routing style 12-145 See CIDR style 5-3 clear conf {all | system} command 12-170 buffer pool information displaying clear conf command 2-7, 11-17, 11-18, 11-19, 12-44 clear counters fcip command 1
Index CLI (continued) clusters (continued) management session time out value, setting monitor mode overview 12-336 collecting configuration information 2-10 special keys 2-2 command modes 2-11 administrator 2-11 starting management session usage tips 12-559, 12-561 See also high availability 2-10 reserved words VTP and monitor 2-12 2-10 2-10 command prompt in CLI 12-1 valid commands, displaying clock, configuring about 12-393 asterisk (*), meaning of 3-5, 12-60 clock set comman
Index creating (continued) deleting (continued) TACACS+ server groups zone command file 12-18 FCIP instance elements 12-563 zone set FCIP instances 12-567 credit extension configuring for donor port logging table rule 12-170 12-87 12-87 logging table entries 12-89 12-89 saved configuration file 12-183 scripts 12-92 12-93 SCSI routing instance elements D SCSI routing instances data buffer credit capacity date, configuring zone members zones 12-64 debug cmd command debug faciliti
Index document conventions enable (continued) xi document organization (table) RIP x domain 12-207 SCSI routing instances ID, configuring SLP for SCSI routing instance 5-4, 12-138 name, configuring setting for FCIP SSH service 3-4, 12-203 downloading software 12-552 Enable authentication 5-3 AAA services 11-5, 11-6, 12-103 download software command creating list 11-2, 11-5, 11-6, 12-103 9-3 9-16 FTP access, allowing overview E testing E_Port EIA/TIA-232 console interface, requi
Index FC interfaces FC interfaces (continued) 6-2 automatic device rediscovery specify domain ID for zoned fabric 12-186 configuration restoring switch logging, restricting testing 12-256 returning to default saving counters, clearing adding description 12-145 assigning IP address to FCIP instance 12-416 assigning IP address to FCIP peer 12-137 displaying 12-409 clear counters configuring 12-430 global configuration information link state database operational statistics 12-172 enable
Index FCIP (continued) G starting instance 12-128 stopping instance fcip command Gigabit Ethernet interfaces 12-128 capabilities 8-3, 12-114 fcip description command clearing counters 8-3, 12-116 fcip destination config command fcip destination raw command 1-21 12-117 12-122 12-49 configuring for FCIP 12-130 configuring for SCSI routing 6-6, 12-303 fcip destination tcpclient command 12-124 configuring for system management fcip destination tcpserver command 12-126 naming fcip ena
Index hostname command interfaces (continued) 3-3, 12-161 HTTPS configuring (continued) See SSL HA 12-193, 12-195 management 12-197, 12-199 counters, clearing I 12-49 displaying operational characteristics IEEE 802.1Q operational statistics See 802.
Index iSCSI (continued) logging drivers (continued) destinations necessary for storage router SCSI routing and TOE 1-1, 1-5 1-6, 6-2 disabling 11-32, 12-223 enabling 12-223 event messages 1-1 transparent SCSI routing and 1-11 Name filtering 11-31 routing adding to access list determining 12-215, 12-219 log file contents, displaying 12-34, 12-480 port for iSCSI traffic 11-31 facilities 12-34 using to identify IP host protocol 12-215, 12-219 log file entries, clearing 12-34 not
Index MTU size M specifying for GbE interfaces management specifying for VLAN configuring GbE IP address for 12-190 specifying secondary GbE interface verifying 12-190 12-188 4-4 4-6 multiple IP address 1-3 management interface clearing counters 12-49 N clusters and 3-4 configuring 3-4, 12-197, 12-199 network management access management session configuring setting time out value starting 12-336 SNMP, configuring 2-12 1-6 transparent SCSI routing and managing the storage router
Index no interface fc? fan-enable command 12-172 no interface fc? mfs-bundle command no interface fc? ms-enable command no interface fc? rscn command no interface ge? command 12-180 operational statistics, viewing 12-201 packet tracing 12-204 no ip radius sourceinterface command no ip rip enable command P 12-203 no ip name-server command 12-205 about 12-207 9-13, 12-297, 12-553 clusters and no ip tacacs sourceinterface command 12-38, 12-228 configuring 12-213 for administrator 12-223
Index RADIUS (continued) setting deadtime restoring AAA authentication information 12-233 source interface, specifying access list 12-205 radius-server deadtime command 11-11, 12-250 all saved configuration information 12-233 radius-server host command 9-11, 12-235 deleted SCSI routing instance radius-server key command 9-11, 12-238 existing SCSI routing instance radius-server retransmit command radius-server timeout command FC configuration information 12-240 12-242 read/write access to
Index save all bootconfig command save all command scsirouter target {lunid | serial | wwpn} #? command 12-317 3-10 11-8, 12-274 save fcip command save fcswitch command save system command scsirouter target crc command 12-277 save scsirouter command save vlan command scsirouter target accesslist command 12-276 scsirouter target enable command 11-15, 12-281 11-14, 12-283 saving access list FCIP instance configuration 12-277 6-8, 12-320 scsirouter target lun serial command 6-9, 12-322 scs
Index SCSI routing instances (continued) SCSI routing instances (continued) configuring (continued) CDB retry count iSCSI targets primary stopping troubleshooting 12-289 connections 6-7 general 12-57 server interfaces use of iSCSI CRC 12-81 user name for iSCSI authentication 12-334 VLAN access to storage devices via (figure) 12-310 secondary GbE interface use of iSCSI reserve/release commands 12-301 11-20 6-5 1-3 Secure Shell protocol See SSH creating 6-6, 12-285 deleting 12-95
Index show aaa command 9-19, 12-364 show accesslist command show admin command 6-14, 12-366 show bootconfig command show cdp command show cdp traffic command show scsirouter stats command 11-22 show sessions command show slp command 12-485 3-10, 11-15, 12-488 show snmp command, example 12-402 show software version command 12-405 11-23 12-487 show snmp command 12-400 11-16 11-2, 11-7, 12-490 show debug fcswitch command 12-407 show software version command, example show debug interface
Index SLP SSH discovering configuring all registered services attributes displaying 12-524 current public key 12-520 displaying status 3-9 12-493 key generation process status 12-487 enabling for SCSI routing instances locating registered service status 12-305 12-492 Enable authentication and 12-522 slp findattrs command 12-520 enabling access 12-266 slp findsrvs command 12-522 generating keys 12-544 slp findsrvtypes command restricting access 12-524 SNMP support configurin
Index TCP/IP Offload Engine system clock configuring See TOE 12-60 displaying TCP Window Tuning 12-395 system configuration backing up clearing Telnet disabling 11-7 restoring saving enabling 12-498 12-552 12-266 restricting access 12-281 telnet enable command 12-510 testing FC interfaces 11-1 to 11-37 system messages, capturing system name case sensitivity configuring 12-137, 12-166, 12-176 2-10 command syntax convention 2-10 TFTP 3-3, 12-161 system parameters configuring tim
Index troubleshooting (continued) VID 1-3, 1-8, 1-19, 4-4 viewing displays buffer pool information 12-378 available software crash trace information 12-400 operational statistics debug information 12-402, 12-413, 12-506 diagnostic information IP packet trace resources See VID 12-503 enabling iSCSI trace facilities enabling trace facilities OS commands ping 12-79 12-78, 12-81 gathering information for iSCSI connections 1-19, 4-1, 12-558 VLAN identifier number 12-461 task status 1-18,
Index zone sets (continued) W members, adding web-based GUI, about 2-12 overview wizards 1-20 zoneset zone command clear conf setup 12-571 12-44 12-571 zoning 2-8, 12-338 configuring 5-1 setup access 12-341 fabric participation setup cluster 12-344 initiators WWPN1 and WWPN2 setup fcip 5-5 12-348 setup iscsi-port setup mgmt 12-351 12-353 setup netmgmt setup scsi 1-19 12-355 12-358 setup time 12-361 Z zone command 12-563 zone databases 1-20 zone member command 12-565