Cisco SFS7000P-SK9 - SFS InfiniBand Server Switch 7000 Command Reference Manual

Download

Corporate Headquarters

Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000

800 553-NETS (6387)

Fax: 408 526-4100

Cisco SFS 7000 Series Product Family Command Reference Guide

Release 2.7.0

Customer Order Number: Text Part Number: OL-9163-02

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS M ANUAL ARE SUBJECT TO CHA NGE WITHOUT NO TICE. 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 RESPONSI BILITY FOR THEIR APPLICA TION OF ANY PRODUCT S.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORT H IN THE INFORMATION PACKET T HAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP head er compressi on is an adap tation of a program developed by the Universi ty of Ca lifornia, Berk eley (UCB) as part of UCB ’s public domain version of the UNIX operatin g system. All rights reserved . Copyri ght © 1981 , Rege nts of the Uni versity of Calif ornia.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THE SE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAI M ALL WARRANTIE S, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NO NINFRINGEM ENT OR ARISING FROM A COURS E OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING , WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE S.

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative pur poses onl y. Any use of act ual IP addr ess es in ill ustr ativ e conten t is uninten tio nal and coincident al.

Cisco SFS 7000 Series Product Family Command Reference Guide

CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Pac k e t, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0601R)

iii

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-01

CONTENTS

Preface xi

Audience xi

Organization xi

Conventions xii

Related Documentation

• For additional information about Cisco SFS 7000P series switches, refer to the following:

–

Release Notes for Cisc o SF S 7 000 P Se ries Swit ch Softw are Release 2.5. 0

–

Cisco SFS 7000 Series Product Family Element Manager User Guide

–

Cisco SFS 7000 Series Product Family Chassis Manager User Guide

• For detailed hardware configuratio n and mainte nance pr ocedu res, see t hese hardwa re guides:

–

Cisco SFS 7000P Switch Installation and Configuration Note

–

Cisco SFS 7008P Switch Installation and Configuration Note

–

Cisco SFS 7000P Hardware Installation Guide

–

Cisco SFS 7008P Hardware Installation Guide

Obtaining Documentation

Cisco documentatio n and a dd ition al lite rat ure a r e available on Cisc o.co m. Cisc o al so provide s s everal ways to obtain technical assista nce an d othe r techni cal re sour ces. Thes e secti ons explain how to obtain technical information from Cisco Systems.

Cisco.com

You can access the most current Cisco documentation at this URL:

http://www.cisco.com/techsupport

You can access the Cisco website at this URL:

http://www.cisco.com

You can access international Cisco websites at this URL:

http://www.cisco.com/public/countries_languages.shtml

Product Documentation DVD

The Product Doc um enta ti on DVD is a c omp rehe nsive library of te ch nic al p ro duct do cu ment atio n o n a portable medium. The DVD enables you to access multiple versions of installation, configuration, and command guides for Cisco hardware and software products. With the DVD, you have access to the same HTML documentatio n that is fou nd on the Cisco we bsite wit hout bei ng connec ted to the In ternet . Certain products also have.PDF version s of the docum en tati on available.

xiv

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Preface

Documentation Feedback

The Product Documentation D VD is av ailable as a single unit or as a subscriptio n. Registered Cisco.com users (Cisco direct customers) can order a Product Documentation DVD (product number DOC-DOCDVD= or DOC-DOCDVD=SUB) from Cisco Marketplace at this URL:

http://www.cisco.com/go/marketplace/

Ordering Documentation

Registered Cisco.com users may order Cisco docu ment atio n at the Prod uct Docu me nta tion Stor e in the Cisco Marketplace at this URL:

http://www.cisco.com/go/marketplace/

Nonregistered Cisco.com users can order tec hnical docum ent ation from 8:00 a.m. to 5:00 p. m. (0800 to 1700 ) PDT by calling 1 86 6 4 63-348 7 in t he U nite d State s and Ca nada , or el sewhere by calling 011 408 519-5055. You can also order documentation by e-mail at

tech-doc-store-mkpl@external.cisco.com or by fax at 1 408 519-5001 in the Unit ed States and Canada ,

or elsewhere at 011 408 5 19- 5001.

Documentation Feedback

You can ra te an d provide feedback abo ut Ci sc o tech nical documents by co m ple ting the o nl ine feedback form that appears with the technical documents on Cisco.com.

You can submit comments about Cisco documentation by using the response card (if present) behind the front cover of your document or by writing to the following address:

Cisco Systems Attn: Customer Docume nt Ordering 170 West Tasman Drive San Jose, CA 95134- 988 3

We appreciate yo ur comm ents .

Cisco Product Security Overview

Cisco provides a free online Security Vulnerability Policy portal at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

From this site, you will find information about how to:

• Report security vulnerabilities in Cisco products.

• Obtain assistance with security incidents that involve Cisco products.

• Register to receive security informat ion from Ci sco.

A current list of security advisories, security notices, and security responses for Cisco products is available at this URL:

http://www.cisco.com/go/psirt

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Preface

Obtaining Technical Assistance

To see security advisor ies , s ec urity no tic es , and se cu ri ty r es p on ses as th e y are upda t ed in r eal tim e, yo u can subscribe to the Product Security Incident Response Team Really Simple Syndication (PSIR T RSS) feed. Information about how to subscribe to the PSIRT RSS feed is found at this URL:

http://www.cisco.com/en/US/products/products_psirt_rss_feed.html

Reporting Security Problems in Cisco Products

Cisco is committed to deliv ering secure products. We test our products internally before we relea se them, and we strive to correct all vulnerabilities quickly. If you think that you have identified a vulnerability in a Cisco product , c onta ct PSIRT:

• For Emergencies only—security-alert@cisco.com

An emergency is either a co nditio n in which a system is und er active attack or a condition for which a severe and urgent security vulnerability should be reported. All other conditions are considered non-emergencies.

• For Non-emergencies—psirt@cisco.com

In an emergency, you can also reac h PSIRT by telephone:

• 1 877 228-7302

• 1 408 525-6532

Tip We en cour ag e yo u to use Pret ty Go od Privacy (PGP) or a com pat ibl e produ ct (f or example , Gn uPG) t o

encrypt any sensitive information that you send to Cisco. PSIRT can work with information that has been encrypted with PGP versions 2.x through 9.x.

Never use a revoked or an expired encryption key. The correct public key to use in your correspondence with PSIRT is the one linked in the Contact Summary section of the Security Vulnerability Policy page at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

The link on this page ha s the cur rent PGP key ID in use.

If you do not have or use PGP, contact PSIRT at the aforementioned e-mail addresses or phone numbers before sending any sen si tive materia l to find o the r m ean s of enc ry pti ng t he dat a.

Obtaining Technical Assistance

Cisco Technical Support provides 24-hour-a-day award-winning techn ical assi stance . The Cisc o Te chnical Support & Documentation website on Cisco.com features extensive online support resources. In addition, if you h ave a valid C isco se rvic e c ontra ct , Cisco Technical Assistan ce Cen ter ( TAC) engineers provide tele pho ne sup por t. If yo u d o no t h ave a valid Cisco se rvic e c ontra ct , con t act y our reseller.

xvi

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Preface

Obtaining Technical Assistance

Cisco Technical Support & Documentation Website

The Cisco Technical Support & D ocu men tat ion w ebsi te provides on lin e docum en ts a nd tool s for troubleshooting and re solvi ng t ec hnic al issues w ith C isco pr oduc ts and te ch nolog ies. The we b site is available 24 hours a day, at this URL:

http://www.cisco.com/techsupport

Access to all tools on the Cisco Technical Support & Documentation web site requires a Cisco.com user ID and password. If you have a valid servi ce cont rac t but do n ot have a user ID or passwor d, you c a n register at this URL:

http://tools.cisco.com/RPF/register/register.do

Note Use the Cisco Pr oduct Ident ificati on (CPI ) to ol to loc ate your pr odu ct s er ial n umb er b efore su bmitt ing

a web or phone request for servic e. You can access the CPI tool from t he Cisco Technical Support & Documentation web site by clicking the Tools & Resources link under Documentation & Tools. Choose

Cisco Product Identification Tool from the Alphabetical Index drop-d own list, or click the Cisco Product Identification Tool link under Alerts & RMAs. The CPI tool offers three sea rch option s: by

product ID or model name; by tree view; or for certain products, by copying and pasting show command output. Search results show an illustration of your product with the serial number label location highlighted. Locate the serial number label on your product and record the information before placing a service call.

Submitting a Service Request

Using the online TAC Service Request Too l is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information. ) After you desc ribe you r situation, the TAC Service Request Tool provides recommended s oluti ons. I f your issu e is no t re so lved using t he r ecom me nded re sourc e s, your se rv ice request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL:

http://www.cisco.com/techsupport/servicerequest

For S1 or S2 service requests, or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are t hose in whic h your prod uction network is down or severely degraded.) Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.

To open a service request by telephone, use one of the fo llowing numb ers: Asia-Pacific: +61 2 8446 7411 (Australia : 1 800 805 227)

EMEA: +32 2 704 55 55 USA: 1 800 553-2447

For a complete list of Cisco TAC contacts, go to this URL:

http://www.cisco.com/techsupport/contacts

Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.

xvii

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Preface

Obtaining Additional Publications and Information

Severity 1 (S1)—An existing network is down, or there is a critical impact to your business operations. You and Cisco w ill comm it all nec essary re sources ar ound th e clock to re solve the situat ion.

Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operations are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.

Severity 3 (S3)—Operational performan ce of the net work is impaire d, while mo st business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory leve ls.

Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is li ttle or no effect on you r business operations.

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources.

• The Cisco Product Quick Reference Guide is a handy, compact reference tool that includes brief

product overviews, key features, sample part numbers, and abbreviated techni cal spe cifications for many Cisco products that are sol d through channel partners. It is updated twice a year and includes the latest Cisco offerings . To order and find out m ore a bo ut the Cisco Pr oduct Qu ick Re fere nce Guide, go to this URL:

http://www.cisco.com/go/guide

• Cisco Marketplace provides a variety of Ci sco b ook s, refe renc e guid es, d oc ument at ion, and logo

merchandise. Visit Cisco Marketplace, the company store, at this URL:

http://www.cisco.com/go/marketplace/

• Cisco Press publishes a wide range of general networking, train ing and certificati on titles. Both new

and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL:

http://www.ciscopress.com

• Packet magazine is the Cisco System s tech nical user ma gazine for maximiz ing Intern et an d

networking investments. Each quar ter, Packet delivers coverage of t he l ate st ind ust ry t rend s, technology breakthrough s, and Cisco product s and soluti ons, as well as network deployme nt and troubleshooting t ips, configu ratio n exa mp les, cust om er c a se studie s, ce rtificat ion an d tr aini n g information, and links to score s of in-dept h online resource s. You can access Packet magazine at this URL:

http://www.cisco.com/packet

• iQ Magazine is the quarterly pu bli cati on from Ci sco System s desig ned t o hel p growing comp an ies

learn how they can use tec hn ology to i n crea se revenue, stre a mline the ir business , and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, usin g rea l-worl d ca se st ud ies an d business st rategies t o he lp r eade rs make soun d technology investment decisions. You can access iQ Magazin e at this URL :

http://www.cisco.com/go/iqmagazine

or view the digital edition at this URL:

http://ciscoiq.texterity.com/ciscoiq/sample/

xviii

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Preface

Obtaining Additional Publications and Information

• Internet Protocol Journal is a quarterly journal published by Cisco Systems for engin eering

professionals involved in designing, developing, and ope ratin g p ubli c a nd pr ivate internets a nd intranets. You can access the Internet Protocol Journal at this URL:

http://www.cisco.com/ipj

• Networking products offered by Cisco Systems, as well as custom er support services, ca n be

obtained at this URL:

http://www.cisco.com/en/US/products/index.html

• Networking Professionals Conne ct ion is a n int era ctive web site f or networ king profe ssiona ls t o

share questions, sug gest ions, and info rma tion a bout net workin g p roduc ts a nd techn ologi es w it h Cisco experts and other networking professio nals. Join a discu ssion at this URL:

http://www.cisco.com/discuss/networking

• Wo rld-cl ass networki ng traini ng is available from Cisc o. You can view current offerings at

this URL:

http://www.cisco.com/en/US/learning/index.html

CHAPTER

1-1

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Using the CLI

This chapter provides a general overview of the Cisco Server Switch command line interface (CLI). It describes how to start a CLI session, how to enter commands, and how to view online help. Details about individual commands appea r later i n this docum ent.

The following sections appear in this chapter:

• Setting up the Switch, page 1-1

• Starting A CLI Session, page 1-2

• Entering CLI M ode s, page 1-4

• Exiting CLI Modes, page 1-6

• Quick Help, pa ge 1- 6

• Editing the CLI, page 1-7

• Exiting the CLI Session, page 1-8

• Specifying Modules and Ports, pa ge 1-9

• Using the Documenta tion, page 1-10

Setting up the Switch

The first time that you access your Server Switch, you must connect a management station, such as a PC or Linux terminal, to the Serial Console port on your Server Switch. After you establish this connection, you can configure the ma nage me nt p orts on you r Ser ver Sw itch so tha t yo u can pe rform c onfigura tion tasks with a telnet session, Element Manager, or Chassis Manage r.

Note SFS Server Switch product configurations with TopspinOS release 2.3.x and higher use a 128-bit

MD5-based hashing sch em e t o st ore p asswords .

1-2

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Starting A CLI Session

To configure a Server Switch through the Serial Console port, perform the following steps:

Step 1 Connect a PC or terminal to the Serial Console port. For detailed instructions, see the appropriate

hardware guide for your Server Switch model.

Step 2 Open a termi nal emul at ion pro gram (su ch as H yp erTerminal for Windows), and con figure sessi on

parameters as follows:

–

Baud: 9600 b/s

–

Data Bits: 8

–

Parity: None

–

Stop Bits: 1

–

Flow control: None

Step 3 Attach both power plugs to the Server Switch chassis to power up the Server Switch. The CLI login

prompt appears on the manage ment stat ion termina l.

Starting A CLI Session

The CLI login prompt au tomatic ally appe ars in a term inal wi ndow when you conne ct the seria l port of a computer to the Serial Console port. It also appears when you launch a telnet session to an Ethernet Management port. The use r account that you use t o log in deter mines your level of access. By default, you can log in a s “ supe r,” “admi n,” or “g uest .” Table 1-1 lists and describes user logi n privileges.

In addition to the default user accounts described above, there are administrative roles that may be assigned to ind ividual user a ccoun ts . Rol es a llow gr an ular levels of pr ivileges. For exam ple, y ou can create separate FibreCha nnel, Ethernet , or InfiniBand admini strator s, who only ne ed access to specific subsystems. The Server Switch combines multiple roles with read and read-write access for flexible control.

Table 1-1 Privilege Levels

User Log-in Privileges

super The super user has unrestric ted privileges. Use this account for initial configuration.

This user may view and modify a configuration, as well as administer user accounts and access privileges. Thi s u ser co nfigure s th e co nsole and ma nage m ent port s f or initial Server Switch setup. This login uses "super" as the default password.

admin The admin user has general read-write privileges. This user may view and modify the

current con figurati on. However, the admin use r ca n ch an ge on ly it s own u ser information, suc h as t he a dm in p assword. Thi s logi n use s “ admi n” as the defau lt password.

guest The guest user has r e ad-o nly pr ivileges. Th is us er m ay on ly v iew the curre nt

configuration. The guest user cannot make any changes during the CLI session. When you first bring up your Ser ver Swi tch , you m ust ena ble thi s login. ( See th e

“username” section on page 2-80). This log i n u ses “gue st” as the d efaul t pa ssword.

1-3

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Starting A CLI Session

Note If a user does not have access to particular functionality, that functionality will not appear in the CLI,

on-line help, or any GUI managem ent windows.

The unrestrict ed (sup er) adm inist rato r assig ns thes e role s. Table 1-2 lists and describes these access levels.

To configure accounts, see the userna me command in the “username” section on page 2-80.

Logging In

At the CLI promp t, e nte r t he a ppr opri ate us er na me a nd password t o log in as the sup er u ser.

Password: xxxxx SFS-7000P>

You are now logged in as an admin istrator and can view and configure the CLI configurati on.

Note Server Switches support up to thre e c oncur re nt C LI se ssions .

Authentication

You can use any of the authent ication me thods shown in Table 1-3.

Table 1-3 Authentication Methods for Logging In

Table 1-2 Access Levels

Role Description

ib-ro InfiniBand read-only access. ib-rw InfiniBand read-w rite acce ss. ip-ethernet-ro Ethernet read-only access. ip-ethernet-rw Ethernet rea d- wri te acc ess . fc-ro FibreChannel read-only access. fc-rw FibreChannel read-write access. unrestricted-rw Read-write access to all network configuration commands.

Authentication How it Works

local Verifies against the chassis database. local and then RADIUS Verifies against the chassis database then checks the RADIUS

server.

RADIUS and t hen lo ca l Checks the R AD IU S s e rver an d t h en veri fies agai nst th e ch ass is

database.

1-4

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Entering CLI Modes

When local authentication is in effect and a user logs in, the user must be configured as a CLI user. The login username an d password are verified agai ns t the loc a l CL I use r data base . If a m atch i s fo und, t he login succeeds, and the user is assigned a pre-configured privilege level.

When TACACS+ authentication is in effect, the login username and password are passed to the TACACS+ server for verification. The TACACS+ server verifies the login username and password, and it sends back a reply. No TAC ACS+ user information is stored locally. The show user all command shows local users only.

The config TACA CS- server host co mmand ( see config TACA CS-server host, page 2-22) configur es the IP address of TACACS+ servers. There can be three TACACS+ servers configured. The first server is queried, the second s er ver is queried if the first server is not reach ab le, and the third server is quer ie d if the both of the other servers ar e not reac hable .

Cisco supports only TACACS+ authentication; therefore, no privilege level is verified against the TACACS+ server. All users authenticated by the TACACS+ server are given unrestricted rights. If a TACACS+ user makes changes to system configuration, the log will include the TACACS+ username and the config infor matio n, just as it do es for a lo cal us er.

Like RADIUS users, the TACACS+ users do not have associating SNMP community stri ngs. There are no SNMP logins for TACACS+ users.

Note The following are limitations to TACACS+ authentication:

TACACS+ authorization an d acco unt ing a re n ot suppo rt ed . TACACS+ single-connection n ot supported. Each login authenticatio n makes its own connection to the TACACS+ server. TACACS+ user privilege level is always unrestricted.

Customizing the Login Prompt

The CLI checks the file login-banner for customized text to inclu de in the pr ompt. Use th e copy command to place a file named login-banner in the config directory of the switch. You can do this with FTP:

copy ftp://user:xxx.x.x.x/my-banner config:login-banner

Entering CLI Modes

The CLI uses the fol lowing thre e comm and mod es:

• User Execute mode

• Privileged Execute mode

• Global Configuration mo de

local and then TACAS Verifies against the chassis database then checks the TACAS client. TACAS and th en lo cal Checks the TACAS client and th en verifies against the ch ass is

database.

Authentication How it Works

1-5

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Entering CLI Modes

Note Global Configuration mode include s a number of subm odes.

The commands that you can execute de pend upo n th e cu rrent co mman d mode and your use r login. You may enter a question mark (?) at the CLI prompt to list the commands available to the current user identity in the current mode.

Using User Execute Mode

All CLI sessions begin in User Ex ecut e mode . This mode provides comm ands for viewing som e of the system configuration and some user information. Guest users may only work in User Exec mode. From User Exec mode, authorized users can access Privileged Execute mode.

Using Privileged Execute Mode

When you enter the

enable

command in User E xecute mode, you enter Privileged Execute mode. From Privileged Exec mode, you can view the entire system configuration and all user information. From this mode, you can perform certa in high-level admini strative tasks, such as save the current con figuration and set the system clock. You can also access Global Configuration mode. You must enter Privileged Execute mode before you can e nter Globa l Configuration mode. O nly admi nistrat ive and unrestricted users may enter Privileged Exec mode.

# telnet SFS-7000P

Mode changes are reflected in changes to the CLI prompt. When you transition from User Exec mode to Privileged Exec mode, the prompt changes from SFS-7000P> to SFS-7000P#.

Using Global Configuration Mode

You enter Global Configuration mode from Privileged Exec mode. Global Configuration (config) mode configures system-level attr ibutes, such as SNMP, SNMP agents, and networks. To enter config mode, enter either the

configure terminal

or the

configure

command in Privileged Exec mode.

SFS-7000P# configure terminal

SFS-7000P(config)#

When you transition fr om Pr ivileged Execute to G loba l C onfigurat ion m ode, the p rompt cha ng es fr om SFS-7000P# to SFS-7000P(config)#.

T o conf igure particular elements of the Server Switch, you must enter a configuration submode specific to that element. All Ethe rnet, FibreCha nnel, an d InfiniBand configur ation occurs in submode s. In submodes, you can assign IP addresses to interface gateway ports, set connection speeds, set connection types, and so on.

To enter the Ethernet Int erface Configurat ion (config-if -ether ) submode fro m Glob al Configurati on mode, enter the

interface

command, specify the interface type, and specify the port(s) to configure.

SFS-7000P(config)# interface ethernet 4/1-4/4

SFS-7000P(config-if-ether-4/1-4/4)#

1-6

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Exiting CLI Modes

The commands that you enter in a configuration submode apply to the specified modules and ports. The Ethernet Mana gement po rt, ho we ver , do es not requ ire you to spe cify a port number becau se there is on ly one active Ethernet Management por t during a system se ssion.

SFS-7000P(config)# interface mgmt-ethernet

SFS-7000P(config-if-mgmt-ethernet)#

Exiting CLI Modes

Most commands are mode-dependent. For example, you can configure clock settings in Global Configuration mode only. To configure t he system, you mu st enter and exit CLI modes. The

exit

command returns yo u to th e p revious mo de.

SFS-90(config-if-fc-5/1)# exit

SFS-90(config)# exit SFS-90#

Note If you enter the

exit

command in User Exec mod e or Privilege d Exec mode, your tel net ses sion en ds.

You may also en ter the exit command with the all keyword to return to User Exec mode i n one step.

SFS-90(config-if-fc-5/1)# exit all

SFS-90>

To return to User Exec mode fro m Privileged Exec mode, enter the

disable

command.

SFS-90# disable

SFS-90>

Quick Help

You can enter the question mark (?) at the CLI prompt to displ ay one of three types of user information.

Step 1 Enter a quest ion m ar k (? ) a t t he CLI p rom pt a t a ny ti me t o displa y the c omm an ds th at you c an e nte r.

Only those commands that are appropriate to the current mode and user login appear.

SFS-7000P> ?

Exec Commands: broadcast - Write message to all users logged in enable - Turn on privileged commands exit - Exit current mode help - Show command help history - Show command history login - Login as a different user logout - Logout of this system ping - Send echo messages show - Show running system information terminal - Set terminal line parameters who - Display users currently logged in write - Write text to another user

1-7

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Editing the CLI

Step 2 Enter part of a c omm and st rin g, a nd en d i t wit h a que sti on mar k ( ?) to di spla y op tion s tha t you c an use

to complete the string.

SFS-7000P> b?

broadcast

Step 3 Enter a command (or enough of a command for the CLI to uniquely identify it), and then enter a space

and a question mark (?) to di splay available arguments t o follow the comma nd.

SFS-7000P> broadcast ?

String - Message to broadcast. Enclose multi-word strings within

double-quotes.

SFS-7000P> broadcast

After the CLI displays the help information, the Server Switch prints the command string up to the question mark on the in put lin e an d wai ts f or yo u to c omp lete the str ing. You do not have to retype the string.

Command Abbreviation

To facilitate command entry, you do not need to enter CLI commands in their entirety. You may enter just enough of e ach c omm and or argume nt to make it un ique ly iden tifiab le.

When enough chara ct er s have been ent ered to uni que ly i den tify a com ma nd or keyword in a c om mand string, you may leave the partially- typed co mmand or keyword, enter a spac e, and the n add add itiona l keywords or arguments, or you can press the Tab key to complete the commands or keywords to improve readability.

SFS-7000P(config)# fc ?

srp - Configure FC SRP srp-global - Configure FC SRP-global parameters SFS-7000P(config)# fc srp- ? enable - Enable FC SRP gateway-portmask-pol - Configure FC SRP-global gateway-portmask-policy itl - Configure FC SRP-global ITL lun-policy - Configure FC SRP-global lun-policy target-portmask-poli - Configure FC SRP-global target portmask policy SFS-7000P(config)# fc srp- gate ? restricted - Configure FC SRP gateway-portmask-policy restricted SFS-7000P(config)# fc srp- gate res ? <cr> SFS-7000P(config)# fc srp- gate res

In the precedin g examp le, srp- is short f or srp- global , gate is short for gateway-portmask-policy, and res is short for restricted.

Editing the CLI

Command-line editin g lets you mo dify a comm and line co mman d that you have just enter ed or a command line that you entere d previously in the CL I session. Th e CLI supp orts a variety of ways to move about and edit the currently displayed command line. Table 1-4 lists and describe s these options.

1-8

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Exiting the CLI Session

To exit the CLI session, return to User Exec mode or Privileged Exec mode, and enter the

logout

command or th e

exit

command. The CLI session ends.

SFS-90(config-if-fc-5/1)# exit all

SFS-90> logout Login:

Note If you use Telnet or SSH to run a remote CLI session, the connection clo ses when you l og out.

Conversely, whe n you terminat e a telnet or SSH session, you log out of the Server Switch.

Table 1-4 Key Stroke Shortcuts

Key Strokes Description

Ctrl-a Moves the cursor to the beginning of the line. Ctrl-b Moves the cursor left (back) one ch arac ter. Ctrl-d Deletes the curre nt ch aract er. Ctrl-e Moves the cu rso r t o t he end of the line . Ctrl-f Moves the cursor t o the r ight (fo rwa rd) o ne cha ra cte r. Ctrl-k Deletes text from cursor to the end of the line. Ctrl-l Ref reshes th e input lin e. Ctrl-n Displa ys the next co mma nd in the hist or y que ue . Ctrl-p Displa ys the previous comm and in the histo ry queue. Ctrl-q Returns to User Exec mode.

Note If a command is entered on the command line, execute the command before

returning to User Execute mode. Ctrl-t Transposes th e cu rrent an d p revious c ha ract ers. Ctrl-u Deletes all text to the left of the cursor. Ctrl-w Deletes the text of a word up to cursor. Ctrl-z R eturns you to Privileged Exec mode. Esc-b Moves the cursor left (back) one word. Esc-c Converts characters, from the cursor to the end of the word, to upper case. Esc-d Deletes characters from the cursor through remainder of the word. Esc-f Moves the cursor right (forwa rd) one word. Esc-l Converts characters, from the cursor to the end of the word, to lower case. down-arrow Displ ays the next c om mand in the hi stor y que ue . up-arrow Displays the previous command in the history queue . left-arrow Moves the cursor left (back ) one char acter. right-arrow Moves the cursor right (forward) one character.

1-9

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Specifying Modules and Ports

To configure one or more ports on one or more modules, specify the ports when you enter the configuration submo de. Ma ny CLI com ma nds al low you to e nter the f oll owing:

• A slot#/port# pair.

• A range of pairs.

• A list of pairs.

• The all keyword.

Slot#/Port# Pairs

A slot#/port# pair (sometimes referred to as the card#/port# pair) is a slash-separated (/) pair of numbers. The first number i nd icate s the slot in w hic h th e int erface mod ule resi des, a nd t he seco nd num ber represents a port on that modu le. See yo ur hardware doc umen tation to id entify slo t numbers an d port numbers.

Note With hardware platforms with no removable modules, such as the Cisco 4x InfiniBand Switch Modu le

for IBM BladeCenter, or the Cisco SFS 7000, the slot number defaults to 1.

Ranges

A range is a dash-separated (-) set of two slot#/port# pairs. A range may span multiple modules of the same interface type. Module and port numbers in a range must both appear in ascending order. That is, specify the lower module and port numbe r in the first slot#/po rt# pair and the higher mod ule and port number in the sec on d slo t# /por t# p air.

Note Do not insert spaces between elements in the range.

The range 3/2-4 /3 i ndi cat es a ll port s sta rti ng w ith m odule 3 , por t 2, u p to and i nclu ding mo dule 4, an d port 3. (This exampl e a ssum es th at mo dul es 3 a nd 4 ar e of the s ame int erface type .)

Lists

A list is a co mma- sep arat ed (,) serie s o f slot #/por t# p air s and/ or r a nges. Seq uenc ing of pai rs in the li st is not important. You may specify pairs in any order you wish; however, the data returned is displayed in numerical sequence with the lowest slot#/port# pair first. Do not insert spaces between elements in the list. For example, 3/ 1,3/ 3,4/ 3 indic ate s p orts 1 and 3 o n i nte rface m odu le 3 and p ort 3 o n in te rface module 4. (This example assumes that modules 3 and 4 are of the same interface type.) You can include ranges in lists.

3/1,4/1-4/4,5/1 The preceding exam ple as sumes that mod ule s 3, 4, an d 5 are of th e same interfac e typ e.

1-10

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Using the Documentation

The “all” Keyword

The all keyword indicates all the ports of all the modules of a spe cific type of inte rface. That is, all Ethernet, FibreChannel, or InfiniBand interface modules. The subsequent prompt will appear as though you entered the ports as a list.

Using the Documentation

The command descr iptio ns in this boo k provide quic k access to th e info rmation ab out eac h comma nd. This book divides each command descript ion into subsec tions, so you can go directl y to the desired information.

Synopsis

The Synopsis subsection p rovides a brief, high-level description of the command .

Syntax

The Syntax subsection provides t he command synt ax. The following conventions apply:

• Text i n bold font represents text that you enter exactly as it appears.

• Text i n italicized font represents variables that you replace with actual values when you enter a

command at t h e co mm an d l ine .

• Square brackets ([,]) enclose optional syntax. D o not enter squa re bracket s in the CLI.

• Braces ({,}) enclose required syntax choices. Do not enter braces in the CLI.

• The pipe character (|) delineates between selections in syntax. That is, if command X requires

argument Y or argument Z, but not both at the same time, the syntax will appear as follows: X {Y | Z}

A table that describes all syntax arguments follows the syntax line(s).

Note Input strings, such as device names and descriptions, must be contiguous without any intervening spaces

or blanks. In the event that you wish to enter a multi-word string, enclose the string within double-quotes (“,”); otherwise the CLI parses each word as a separate argument, which results in a syntax violation.

Platform Availability

The platform subsection indicates the p latform or platforms (such a s Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, InfiniBand Switch Module for IBM BladeCenter) on which you may execute the command.

1-11

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Using the Documentation

Command Modes

The Command Mode s subsec tion i nd ica tes t he c om mand mo de or su bmo de t hat y ou mus t e nter to execute the command.

Privilege Level

The Privile ge Level subsection indicates the user permissi ons that ar e requ ired to e x ecu te the c ommand. For example, there ar e co mman ds th at only an u nre st ric ted re a d-w rit e u s er (for exa mpl e, a sup er u ser ) can execute that a user with gener al read -write pe rmissi ons (admin ) cannot .

Usage Guidelines

The Usage Guidelines subsection supplies ad ditional information and details to help you use a command to its full potential.

Examples

The examples subsecti on shows actual com mand ent ry and CLI output.

SFS-7000P# show interface gateway 5

=============================Gateway Information================================ gateway : 5 name : 5/0 type : fc-gateway desc : 5/0 (320) last-change : none mtu : 0 admin-status : up oper-status : up SFS-7000P#

Defaults

The Defaults subsecti on lists comm and defa ult behavior or values.

Related Commands

The Related Commands subse ction provides hype rtext link s to related CLI commands.

1-12

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 1 Using the CLI

Using the Documentation

CHAPTER

2-1

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Administrative Commands

This chapter documents the following commands:

• action, page 2-3

• addr-option, page 2 -5

• authentication, pa ge 2 -6

• auto-negotiate, page 2-8

• boot-config, page 2-10

• broadcast, page 2-11

• card, page 2-12

• cdp advertise-v2, page 2-13

• cdp holdtime, pa ge 2 -15

• cdp run, page 2-16

• cdp timer, page 2-18

• clear cdp coun ter s, page 2- 19

• clear cdp table, page 2-20

• clock set, page 2-21

• config TACACS-server host, page 2-2 2

• copy, page 2-26

• delete, page 2-29

• dir, page 2-31

• disable, page 2- 33

• enable, page 2-3 4

• exec, page 2-35

• exit, page 2-36

• ftp-server enable, pa ge 2 -37

• gateway, page 2-38

• help, page 2-39

• history, page 2-40

2-2

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

• hostname, page 2-41

• install, page 2-42

• ip http, page 2- 44

• link-trap, page 2-46

• location, page 2-47

• logging, page 2-48

• login, page 2-49

• logout, page 2-50

• more, page 2-51

• mtu, page 2-53

• name, page 2-54

• ntp, page 2-55

• ping, page 2-56

• power-supply, page 2-57

• radius-server, page 2-58

• reload, page 2-60

• save-log, page 2-62

• shutdown, page 2-63

• snmp-server, page 2-66

• speed, page 2-69

• system-mode, page 2-71

• system ib-counter-reset, page 2-72

• telnet, page 2-73

• terminal, page 2-74

• trace, page 2-76

• type, page 2-78

• username, page 2-80

• who, page 2-83

• write, page 2-84

2-3

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

action

T o e xecute predefined administrative functions on expansion modules (gateway cards), enter the

action

command in Card Co nfigurat ion sub mod e.

action {delete-inactive-image | reset }

Syntax Description

Command Modes Card Configuration (config-card) mode.

Defaults This command has no default settings.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted or card-s pecific re ad-wri te user. Currently , y ou can e xecute on ly one predef ined a dministrati ve function on all platfor ms except th e Cisco

SFS 7008. The function (dele te-inactive-image) deletes inactive images from one or more cards to provide more available memo ry on the c ard.

Before you use the

action

command with th e

delete-inactive-images

keyword, enter the

boot-config

command with t he

primary-image-source

keyword to install and activate the proper image on the card. When y ou ex ecute th is command, the pre vio usly-ac ti ve im age become s inacti v e. You can now execute the

action

command to clear the inactive image from your card.

T o execute this command, you must have read-write administrative permission for the type(s) of card(s) that you want to clear.

Examples The following example deletes inactive images from the card that resides in slot 2:

SFS-7000P(config-card-2)# action delete-inactive-images

The following example resets a management I/O card on a Cisco SFS 7008:

SFS-270(config-card-15)# action reset

delete-inactive- im age Removes the inactive image from interface cards. Use the

action

command

with the

delete-inactive-image

keyword after the

boot-config

command when you upgrad e t he sy stem ima ge on your Server Swi tch to c le ar t he inactive image from the card(s) after a reboot.

reset Resets the card(s) that you specify in a Cisco SFS 7008.

2-4

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

action

Related Commands boot-config

copy install show card shutdown

2-5

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

addr-option

To configure the Ethernet Manage ment por t to

• use a static IP address,

• obtain an IP address from a DHCP server,

• automatically obtain an IP address from a hardware-designated controller,

enter the

addr-option

command in Eth ern et Man ag eme nt Co nfigurat ion sub mod e.

addr-option {auto | dhcp | static}

Syntax Description

Defaults This command has no default settings.

Command Modes Ethernet Managem ent Configurati on (config-mgm t-ether net) mod e.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Ethernet read -write user. If you use the

static

keyword, configure the IP address of the Ethernet Management port with the “ip”

section on page 5-8.

Examples The following example configures the Ethernet Management port to obtain an IP address from a DHCP

server:

SFS-270(config-if-mgmt-ethernet)# addr-option dhcp

Related Commands ip

auto Applies an IP addr ess fr om an outsi de c on troll er t o t he E the rne t

Management port.

dhcp Use s DHCP to con figure the addre ss for the Et hernet Manage ment port. static Changes the address of the Ethe rnet man agemen t port from the DC HP

address to the static address that you configure with the

command.

2-6

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

authentication

Authentication ca n be c onfigured five ways, as shown in Table 2-1

Table 2-1 Authentication Methods for Logging In

For more information, see the “Aut henti cati on” se ctio n o n p age 1-3.

authentication login [default {local [radius|tacacs] | [radius|tacacs] local}]

Syntax Description

Defaults Authentication defaults to local.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user.

Authentication How it Works

local Verifies against the chassis database local and then RADIUS Verifies against the chassis database then checks the RADIUS

server

RADIUS a nd t hen l oca l Checks the R AD I US se rver an d th en veri fies aga ins t t h e ch as si s

database

local and then TACACS+ Verifies against the chassis database then checks the TACACS+

client

TACACS+ and then local Checks the TACACS+ client and then verifies against the chassis

database

Note When you enter

authentication login

, the comman d b eh aves as

though you had entered

authentication login def au lt l oca l

default (Optional) Configures w he re an d in wha t or der you r Se rver Swi tch

authenticates logins.

local (Optional) Authenticates the login with the local CLI user database. radius (Optional) Authenticates the login with the RADIUS server. tacacs (Optional) Authenticates the login with the TACACS+ server.

2-7

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

authentication

Use the

configure authenticatio n

command to indi cate th e u ser logi n aut hor izat ion s our ce s and the

sequence in which to chec k them.

Examples The following example configures the Server Switch to authenticate to the RADIUS server, then to the

local database if server authentication fails:

SFS-7000P(config)# authentication login default radius local

The following ex a mple c onfigures the Server Switch to authenticate to the TACACS+ server then to th e local database if server authentication fails:

SFS-7000P(config)# authentication login default tacacs local

The following example configures the Server Switch to authenticate to the local database, then to the RADIUS server if server authentication fails:

SFS-7000P(config)# authentication login default local radius

The following example configures the Server Switch to authenticate to the local database, then to the TACACS+ server if server authentication fails:

SFS-7000P(config)# authentication login default local tacacs

Related Commands config TACACS-server host

radius-server show authentication config TACACS-server host config TACACS-server host

2-8

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

auto-negotiate

To configure your Server Switch to

• dynamically determine the connection speed of direct-attached Fibre Channel devices,

• dynamically determine the connection speed of direct-attached Ethernet devices,

• dynamically determine the connection speed of direct-attached InfiniBand devices,

enter the

auto-negotiate

command in the appropriat e Interface Con figuration subm ode. To disable

auto-negotiation, use the

form of this command.

auto-negotiate no auto-negotiate

Syntax Description This command has n o a rguments or keyword s

Defaults Fibre Channel and Ethernet ports auto-negotiate connection speeds by default.

Command Modes Fibre Channel Interface Configurat ion (config-if-f c) submode , Ethern et Interfac e Configurati on

(config-if-ether) submo de , I nfiniBand In terface C onfigura tion (co nfig-if- ib) sub mod e.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Fibre Channel read-wr ite user (fo r FC ports) , Ethern et read- write use r (for Ethe rnet por ts), InfiniB and read-write us er (for I nfiniBan d p or ts) .

Fibre Channel:

Before you configure your FC port to auto-negotiate speed , foll o w thes e steps to v erif y tha t the att ached Fibre Channel device suppor ts a uto- negotiation:

Step 1 Enter t he

show interface fc

command in User Exec mode or Privileged Exec mode.

Step 2 Verify that the auto-negotiate-supported f ield of the command output displays yes. If the field display s

no, you must manual ly c on figure th e co nnec tio n sp eed of the p ort.

Note If you disable auto-negotiation in the CLI but leave it active on the attached Fibre Channel devices, the

port manager for the Fibre Channel interface on your de vice does not ne gotiate speed and mode with the FC devices. The FC devices may choose a different duplex setting than the port manager and produce unexpected results.

2-9

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

auto-negotiate

Ethernet:

Before you enable auto-negotiation, follow these steps to verify that the Ethernet host supports auto-negotiation:

Step 1 Enter t he

show interface ethernet

command in Use r Exec mode o r Privileged Exec m ode.

Step 2 Verify that the auto-negotiate-supported field displays yes. If the field displays no, you must manual ly

configure the conn ect ion speed of the port.

InfiniBand:

Before you enable auto-negotiation, follow these steps to verify that the InfiniBand host supports auto-negotiation:

Step 1 Enter t he

show interface ib

command in User Exec mode or Privileged Exec mode.

Step 2 Verify that the auto-negotiate-supported field displays yes. If the field displays no, you must manual ly

configure the conn ect ion speed of the port.

Examples Th e following exampl e disable s auto-negot iation on ports 1 throu gh 2 on Fibre Cha nnel card 5. Th e

result of this command appears in the auto-negotiate field of the

show interface fc

command:

SFS-7000P(config-if-fc-5/1-5/2)# no auto-negotiate

The following example di sables auto-negotiation on ports 1 thro ugh 4 on Etherne t card 4. The result of this command appears in the auto-negotiate-supported field of the

show interface ethernet

command:

SFS-7000P(config-if-ether-4/1-4/4)# no auto-negotiate

The following example enables auto-negotiation on port 1 on a Cisco SFS 7000. The result of this command appea rs in th e aut o-ne go tiate -su ppo rted field of th e

show interface ib

command:

SFS-120(config-if-ib-1/1)# auto-negotiate

Related Commands link-trap

name show fc srp initiator show interf ace et hernet show interface fc show interface ib shutdown speed

2-10

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

boot-config

To specify the system image to run when your Ser ver Switch boots, enter the

boot-config

command in

Global Configuration mo de.

boot-config primary-image-sou rce

dir

Syntax Description

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. Specify an image directory as a boot ima ge. Do not specif y image f iles tha t end in “.img ” since these ar e

compressed archives that must be installed first.

Note Use the

dir

command wit h th e ima ge keyword to v iew a list of ima ges on y our device.

Examples The following example configures the Server Switch controller to use the sfsOS-1.1.0/build460 directory

when the Server Swit ch bo ot s. Without thi s d irect or y, the system cannot bo ot su cce ssfu lly.

SFS-7000P(config)# boot-config primary-image-source sfsOS-1.1.0/build460

Related Commands dir

install radius-server reload show boot-config show card show card-inventor y

primary-image-source Specifies that you want to configure the boot image.

dir Directory that contains the boot image.

2-11

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

broadcast

To send text messages to a ll ot her CL I use rs, ente r th e

broadcast

command in User Exec mode or

Privileged Exec mode.

broadcast

message

Syntax Description

Defaults This command has no default settings.

Command Modes User Execute mode, Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. Multi-word messages must begin a nd e nd with quot ation m arks (“,” ). Si ngle- word me ssage s d o not

require quotation marks. You can broadcast a message to warn other CLI users about events that may impact their sessions, such

as a network out age or m ajor con figura tion cha ng e. A bro adca st m ess ag e ap pear s on every active CLI session on the Server Switc h, i ncl uding the us er w ho send s the m ess age.

Examples The following example prints “FC card 5 going down in 10 minutes” to the terminal screens of all users

on the Server Switch:

SFS-7000P# broadcast "FC card 5 going down in 10 minutes."

Related Commands reload

who write

message Message to broadcast. This message may consist of one or more words and

may include any alphanume ric chara cter or sym bol (except for quotat ion marks).

2-12

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

card

To enter Card Configuration submode , enter th e

card

command in Gl obal C onfigurati on m ode.

card {slot-list | all | digit | digit ,dig it | digi t-digit}

Syntax Description

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Card-specific rea d-writ e user Enter Card Configuration submod e to enable , disabl e, configure, a nd reinitia lize cards in your Server

Switch.

Examples Th e fo llowing exam ple ent e rs Car d Configura tio n s ubm ode f or a ll ca rd s o n th e Ser ver Swi tch . Any

commands that execute in this mode apply to all of the cards in the chassis.

SFS-7000P(config)# card all SFS-7000P(config-card-1,6,11,15-16)#

Related Commands clock set

delete install show card show card-inventor y shutdown

slot-list Card, list of ca rds, o r ra nge o f ca rds t o co nfigure.

all Configures all cards in the chassis.

digit | digit,digit Specifies the slot n umb ers f or car ds you wa nt to c onfigure in t he ch assis.

2-13

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

cdp advertise-v2

To enable Cisco D iscovery Prot ocol Version 2 (CDPv2) advertising func ti onal ity on a device, use t he cdp advertise-v2 command in global configuration mode. To disable advertising CDPv2 functionality, use the no form of the c omm an d.

cdp advertise-v2 no cdp advertise-v2

Syntax Description This comm and ha s n o argume nts o r keywords

Defaults Enabled. CDP is running on ch assis boot.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted and gene ral read -write user. Each device configured for CDP sends periodic messages, known as advertisements, to a multicast

address. Each device advertises at least one address at which it can receive SNMP messages. The advertisements also contain time-to-live, or holdtime, information, which indicates the length of time a receiving device should hold CDP i nf orma tio n b efore di scard ing i t. E ach device al so lis tens to the periodic CDP messages sen t by others i n orde r to l earn about nei ghbori ng devices and de termi ne w hen their interfaces to the media go up or down.

CDP Version 2 is t he m ost r e cent rele as e of the p rotocol . With CDP Version-2, detailed informatio n is provided on the VLA N Trunking Prot ocol (VT P) mana geme nt dom ain a nd dupl ex modes of n eigh bor devices, CDP-related counte rs, and VLAN IDs of connecting ports. This can help the Ethernet gateway configuration. CDP is run on server switches over management-Ethernet interfaces. CDP Ve rsi o n 2 has three additional t y pe-len gt h values (TLVs): VTP Management Do main N a me, Nat ive VLAN, a nd full/half-Du plex.

Note CDP runs by default when a cha ssis bo ots u p, but C DP is on ly l ea rning in this m ode . If any ne ighb ors

are advertising, CDP will identify them.

Examples The following example sets the CDP advertisement for CDP Version 2:

SFS-7000P(config)# cdp advertise-v2

2-14

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

cdp advertise-v2

Related Commands cdp holdtime

cdp timer show cdp show cdp entry show cdp neighbors show clock

2-15

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

cdp holdtime

To set the Cisco Discovery Protocol (CDP) transmi ssion holdtime , enter the

cdp holdtime

command

in Global Configurat ion m od e.

cdp holdtime seconds

Syntax Description

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted and gene ral read -write user. CDP packets are sent with a tim e to live, or hold time, value. The rec eiving device will discard the CDP

information in the CDP packet after the hold time has elapsed. You can set the hold time lower than the default setting of 18 0 sec ond s if yo u want the re ceiving devices t o updat e t heir CD P inf orm ation m ore rapidly. The CDP hold time must be set to a higher number of seconds than the time be tween CDP transmissions, which is set using the cdp timer command.

Examples The following example sets the CDP holdtime:

SFS-7000P(config)# cdp holdtime 120

Related Commands cdp advertise-v2

cdp timer show cdp show cdp entry show cdp neighbors show clock

seconds Sets the number of seconds for transmissi on holdtim e.

2-16

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

cdp run

T o enable Cisco Discovery Protocol (CDP), use the cdp run command in global configuration mode. To disable CDP, use the no form of th is c omm and.

cdp run no cdp run

Syntax Description This command has n o a rguments or keyword s.

Defaults Disabled

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted and gene ral read -write user. CDP is enabled by def ault, which means th e Cisco IOS software will recei ve CDP in formation. CDP also

is enabled on s uppo rte d in terfa ces by defa ult. To disable CDP on a n i nte rface , use th e no cdp run interface configuration command.

Note Because ODR (o- demand routing) uses CDP , the cdp enable, cdp ti mer , and cdp run comm ands af fect

the operation of t he router odr global configuration command. For more information on the router odr command, see the Ci sco IO S IP Comm an d R efer ence , Volume 2 of 3: Routing Protocols d ocume nt.

Note CDP runs by default when a c hassi s boot s, but CDP is on l y lear ning i n t his m ode . If a ny neighbo rs ar e

advertising, CDP will identify them.

Examples Th e following example starts CDP advertis ing on your ch assis:

SFS-7000P(config)# cdp run

The following example starts CDP advertising on your chassis and specifies the CDP timer interval:

SFS-7000P# configure SFS-7000P(config)# cdp run SFS-7000P(config)# cdp timer 10

2-17

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

cdp run

Related Commands cdp advertise-v2

cdp holdtime cdp timer show cdp show cdp entry show cdp neighbors show clock

2-18

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

cdp timer

To specify how often the Ci sco IOS s oft ware se nd s Cisco Disc overy Protoco l (C DP) upda tes, us e t he cdp timer command in global configurat ion mode . To revert to the default setting, use the no form of this command.

cdp timer seconds no cdp timer

Syntax Description

Defaults 80 seconds

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted and gene ral read -write user. The trade-off with sending more fre quent CDP u pdates to provide up- to-d ate inform ation is t hat

bandwidth is used more often.

Note The cdp timer, and cdp run commands affect the op er at ion of the IP o n d ema nd rou tin g f eat ure (t hat

is, the router odr glob al co nf i gur at ion command). For more information on the router odr command, see the "On-Demand Routing Commands" chapter in the Cisco IOS IP Command Reference, Volume 2 of 3: Routing Protoc ols d ocume nt.

Examples The following example sets the CDP timer:

SFS-7000P(config)# cdp timer 120

Related Commands cdp advertise-v2

cdp holdtime cdp run show cdp show cdp entry show cdp neighbors show clock

seconds Sets the number of seconds for the transmi ssion timer.

2-19

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

clear cdp counters

T o reset Cisco Discovery Protocol (CDP) traffic counters to zero, use the clear cdp counters command in privileged EXEC mode.

clear cdp counters

Syntax Description This comm and ha s n o argume nts o r keywords .

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Privileged EXEC mode.

Examples The following example sets the CDP counters to zero:

SFS-7000P(config)# clear cdp counters

Related Commands cdp advertise-v2

cdp holdtime cdp run clear cdp table show cdp show cdp entry show cdp neighbors show clock

2-20

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

clear cdp table

To clear the table tha t c onta ins Cisco D iscovery Prot ocol (CD P) info rm ati on abou t ne ighb ors, u se the

clear cdp table command in privileged EXEC mode.

clear cdp table

Syntax Description This command has n o a rguments or keyword s.

Defaults This command has no default settings.

Command Modes Privileged EXEC mode

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted and gene ral read -write user.

Examples The following example sets the CDP counters to zero:

SFS-7000P(config)# clear cdp counters

Related Commands cdp advertise-v2

cdp holdtime cdp run clear cdp counters show cdp show cdp entry show cdp neighbors show clock

2-21

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

clock set

To manually configure the time and date of the on-board Server Switch clock, enter the

clock set

command in Privileged Exec mode.

clock set hh:mm:ss dd mm yy

Syntax Description

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted and gene ral read -write user. Your Server Switch uses one of the following means to maintain system time:

• an on-board system clock

• an external NTP server (recommended)

When you first power on you r Se rver Swi tch, fact ory- defa ult sys tem c lock set ting s run . To ensure accurate synchronization, we recommend that you use an external NTP server, as it will synchronize log dates with other management systems. To configure NTP servers, refer to the “ntp” section on page 2-55.

Examples Th e following exampl e sets the cloc k time to 7:22 PM and 10 seconds on t he 25th of Ma y, 2015:

SFS-7000P# clock set 19:22:10 25 05 15

Related Commands card

ntp radius-server show clock

hh Hour to assign. mm Minute to assign. ss Second to assign. dd Day to assign. mm Month to assign. yy Year t o ass ig n.

2-22

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

config TACACS-server host

To configure a TACACS+ server, use the config tacacs-server host command.

tacacs-server host <ip-addr> [port <port>] [timeout <seconds>] [ret ransmit <retransmit>] [key

<server-client key> no tacacs-server host <ip-add r > // delete entry tacacs-server ho s t <ip -addr> key "" // to remove the key

Syntax Description

Defaults The TACACS+ host authentication port defaults to 49. Seconds defaults to 5.

Command Modes Unrestricted and gene ral read -write user.

Use the the config tacacs-server host command to identify a host as a TACACS+ server.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-wri te user.

Examples The following example changes to executive mode, changes to configuration mode, and then identifies

164.28.299.30 a s a TACACS+ s erver:

SFS-7000>enable SFS-7000P# configure SFS-7000P(config)# tacacs-server host 164.28.299.30

Related Commands authenti cat ion

boot-config clock set

ip-addr IP address. port TACACS+ host authenticat ion port, defa ults to 49. seconds Login request times out if no reply is received from the server within this period.

Default is 5 seconds.

retransmit Number of retries (timeouts). server-client key Secret key used between TACACS+ server and client.

2-23

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

config TACACS-server host

show authentication snmp-server radius-server

2-24

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

configure terminal

To enter Global Configuration mo de, ente r the co nfigure te rmin al command in Privileged Exec mode.

configure terminal

Syntax Description This command has n o a rguments or keyword s.

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted and gene ral read -write user. Use the

configure terminal

command to enter Gl obal Con figuratio n mod e. From this m ode , yo u can configure gateway and switch cards, subnet ma nagement , IP addressi ng, an d various aspects of you r Server Switch.

Examples The following example enters Global Configuration mode:

SFS-7000P# configure terminal SFS-7000P(config)#

Related Commands arp ethernet

authentication boot-config bridge-group card show diagnostic exit fc srp initiator fc srp initiator-wwpn fc srp it fc srp itl fc srp lu fc srp target fc srp-global gateway-portmask-po licy restricted fc srp-global itl fc srp-global lun-policy restricted

2-25

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

configure terminal

ftp-server ena ble help history hostname ib sm ib-agent ip location logging ntp radius-server redundancy-group snmp-server telnet trace trunk-group username

2-26

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

copy

To copy files

• to your Server Switch from a remote location,

• from your Server Switch to a remote location,

• from one directory on your Ser ver Switch to another,

enter the

copy

command in Privileged Exec mode.

copy ftp

://user-id:password@host[/path]/file-nam e [slot-numbe r:]file-system[:file-name]

Downloads a file from a FTP server.

copy scp

://user-id:password@host[/path]/file-name [slot-number:]file-system[:file-name]

Securely transfers files from a remote server to the chassis.

copy tftp

://

remote-system[/path]/file-name [slot-number:]file-system[:file-name]

Downloads a file from a remote TFTP server.

copy

{[slot-number:]file-system:file-name |

startup-config |

running-config

}

ftp

://user-id:password@host[/path]/[file-name]

Uploads a file to a FTP server.

copy running-config startup-config

Saves the running configuration as the startup configuration. copy [slot-number:]file-system:file-name running-config Executes a configuration file without a system reboot.

Syntax Description ftp Identifies a remo te s yst em t hat r uns file tr ansfe r pro toc ol ( FTP).

scp Securely transfers files from a remote server to the chassis. tftp Identifies a remote system that runs trivial file transfer protocol (TFTP). remote-system IP address (or DNS name , i f ap prop ria te) o f th e remo te host . running-config Refers to the active configuration run ning on yo ur Ser ver Sw itch . startup-config Refers to the configuration that your Server Switch runs when it boots.

user-id User ID that you use to log in to the FTP server. password Password that you use to log in to the FTP server. host FTP server domain na me or I P a ddre ss. path (Optional) Directory path on the host from which or to wh ich you want to

copy a file.

slot-number (Optional) Slot of the controller card (1 on the Cisco SFS 3001, Cisco SFS

7000, and Cisco 4x InfiniBand Switch Module for IBM BladeCenter; 1 or 14 on the Cisco SFS 3012; 11 or 12 on the Cisco SFS 7008).

2-27

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

copy

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. Use the

copy

command to save a running configu ration as a boot-up configuration, to download image

files to install, or to upload configurations that you want to propagate to other Server Switches. The

copy

command copies image data, configuration data, and log data locally as well as onto and off of the system chassis.

Note If an administrator has configured the system-mode to VFrame, the Server Switch does not apply SRP

configuration changes to the startup configuration. For more information, refer to this command:

system-mode, page 2-71.

The

copy

command can al so copy t h e cont en ts of a co nfigura ti on file.

Note Configuration files that you upload from your Server Switch to a remote host contain plain text that you

can read with any word processor. Log files also appear in plain text.

You may download image and configuratio n files from an FTP server to the syste m chassis. You may also upload log and configuration files from the system chassis to an FTP server.

Download image files to your Server Switch to upgrade system fir mw a re . Download configuration files to quickly replicate a desired conf iguratio n. Upload conf iguration and log f iles to mai ntain back-up f iles and to troubleshoot your Server Switc h.

Image files require add itional processing. Your Server Switch can run an im age only afte r you install the image file. F or more information ab out how to i nstall an image, refer to this command: ins tall , page 2-42.

After you download a configuration file to yo ur Server Switch, you can use the

boot-config

command

to configure your Server Switch to load that configuration when you reboot the Server Switch. The

copy

command recognizes Ctrl-c as a command to terminat e a file transfer. Use Ctrl-c to cancel a

transfer if the network hangs.

Note You can download image and configuration files only. Log files cannot be downloaded. You can upload

configuration files and lo g files on ly. System image data c anno t be u ploa ded.

file-nam e (Optional) Name of the file that you want to copy. file-system File system on your Server Switc h.

2-28

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

copy

Examples The following example downloads an image file from a remote host to the Server Switch:

SFS-7000P# copy ftp://bob:mypassword@10.0.0.5/SFS-7000P-sfsOS-2.3.0-build497.img image:SFS-7000P-2.3.0-build497.img

sfsOS-2.3.0-build497.img operation completed successfully

The following example saves the running configura tion as th e startup co nfigurati on so the curr ent configuration executes when the Server Switc h reboots:

SFS-7000P# copy running-config startup-config operation completed successfully

SFS-7000P

The following example c opie s th e st art up co nfigurati on ima ge f rom the co ntrol le r ca rd in sl ot 1 on a Cisco SFS 3012 to the controller card in slot 14:

SFS-7000P# copy 1:config:startup-config 14:config:save.cfg ** operation completed successfully

Related Commands action

boot-config delete dir exec ftp-server ena ble history install show boot-config show fan

2-29

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

delete

To remove image, configuration, or log files from your Server Switch, enter the

delete

command in

Privileged Exec mode.

delete

[slot-number:]file-system:file

Syntax Description

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. You cannot delete an active image. To deactivate an active system image in order to delete it, install a

new image using this command: (i nstall , page 2-42) and configure your Server Switch to boot that image using this command: (boot-config, page 2-10), then delete the old image.

Examples The following example deletes the delete-me.cfg file from the controller card in slot 1 of a Cisco SFS

3012:

SFS-7000P# delete 1:config:delete-me.cfg Delete file 1:delete-me.cfg? [yes(default) | no] yes ******

file-system Server Switch file system. Your Server Switch displays this internal

directory by name only. The file systems are config, images, and syslog. The

specified file system must be appropriate to the type of file that you want to

delete. For example, if you attempt to delete a configuration file from the

syslog file system, an error occu rs because the name o f the file does not

match the file system. A colon (:) always follows the file-system

specification.

Note The startup configuration maps to config:startup-config. Therefore,

you do not need t o spec ify the file s yst em a t t he CLI .

slot-number (Optional) Slot of the controller card (1 on the Cisco SFS 3001 and Cisco

SFS 7000, 1 or 14 on the Cisco SFS 301 2).

file Name of the conf igurati on fi le, image f il e, or log f ile that y ou want to delete.

2-30

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

delete

The following example deletes an image file from the controller card in slot 14 of a Cisco SFS 3012:

SFS-7000P# delete 14:image:sfs360-sfsOS-2.0.0-build488.img Delete file 14:sfs360-sfsOS-2.0.0-build488.img? [yes(default) | no] yes ******

Related Commands boot-config

copy dir install

2-31

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

dir

To list the configuration files, log files, and system image files on your Server Switch, enter the

dir

command in Privileged Exec mode.

dir [slot-number:]{

config

image

syslog

}

Syntax Description

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-only user. Use this command to list the files on your Serv er Switch. This command requires one of thre e arguments:

config, image

, or

syslog

. Files reside on the Server Switch in separate file systems. The CLI

automatically tracks these f ile syste ms, so you do not need t o include f ile-path information to a dminister these files.

Use the

dir

command with the

image

keyword to see the installed image directorie s on your Server

Switch. On the Cisco SFS 3012, use the slot-number variable to view files on the controller card in slot 1 or slot

14. The

dir

command lists the files of the active controller by default.

Examples The following example displays the configuration files on the Server Switch:

SFS-7000P# dir config ============================================================================ Existing Configurations on System ============================================================================

slot-number (Optional) Slot of the controller card (1 on the Cisco SFS 3001 and Cisco

SFS 7000, 1 or 14 on the Cisco SFS 3012, 11 or 12 on the Cisco SFS 7008).

config Lists all configuration files in the config directory. image Lists the current imag e files and s ystem images in th e image directo ry . Image

files end with a .img extension. Installed system images look like path

names.

Note You must unpack and install image files before they can boot the

system. For more informat ion, re fer to thi s comm and: install, page

2-42.

syslog Lists the log files in the syslog directory.

2-32

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

dir

slot date-created size file-name

---------------------------------------------------------------------------1 Thu Oct 24 11:21:06 2002 58 check.cfg 1 Thu Dec 5 14:50:09 2002 39216 check2.cfg 1 Wed Dec 11 09:09:54 2002 1712 config_bc.cfg 1 Thu Dec 5 11:18:21 2002 1712 running_config.cfg 1 Wed Dec 4 07:10:23 2002 4407 running_config.cfg.backup 1 Thu Dec 5 12:04:53 2002 1712 running_config2.cfg 1 Thu Oct 24 11:19:53 2002 58 test.cfg SFS-7000P#

The following example displays installed system images and image files on the Server Switch:

SFS-7000P# dir image =============================================================== Existing Boot-Images on System =============================================================== slot date-created size file-name

---------------------------------------------------------------------------1 Thu Jun 1 11:16:50 2003 23691613 TopspinOS-1.1.3-build548.img 1 Wed Jul 11 00:56:52 2002 1024 TopspinOS-1.1.3/build541 1 Thu Jul 1 00:10:40 2003 1024 TopspinOS-1.1.3/build548 SFS-7000P#

The following example displays the log files in the syslog directory on the Server Switch:

SFS-7000P# dir syslog ============================================================================ Existing Syslog-files on System ============================================================================ slot date-created size file-name

---------------------------------------------------------------------------1 Thu Jun 12 12:13:06 2002 19636 ts_log 1 Wed Jun 11 13:28:54 2002 4978 ts_log.1.gz 1 Tue Jun 10 04:02:02 2002 30 ts_log.2.gz 1 Mon Jun 9 04:02:02 2002 30 ts_log.3.gz 1 Sun Jul 8 04:02:02 2002 30 ts_log.4.gz 1 Sat Jul 7 04:02:02 2002 30 ts_log.5.gz 1 Fri Jul 6 17:20:35 2002 16264 ts_log.6.gz 1 Thu Jul 5 15:14:57 2002 245 ts_log.7.gz SFS-7000P#

The following example disp lays t he files in the i mage dir ect ory o n t h e co nt rolle r in sl o t 14 of a Cisc o SFS 3012:

SFS-7000P# dir 14:image

================================================================================ Existing Boot-Images on System ================================================================================ slot date-created size file-name

-------------------------------------------------------------------------------14 Thu Mar 18 14:59:06 2004 0 TopspinOS-2.0.0/build488

Related Commands boot-config

copy delete install more

2-33

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

disable

To exit Privileged Exec mode and return to User Exec mode, enter the

disable

command in Privileged

Exec mode. To disable a t run k g roup, e nter the

disable

command in Trunk Interface Configuration submode.

disable

Syntax Description This comm and ha s n o argume nts o r keywords .

Defaults This command has no default settings.

Command Modes Privileged Execute mode, Trunk Interfac e Con figurat ion (config- if-tr unk ) su bm ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-only user.

Examples Th e foll owing example exits Privilege d Exec mode a nd enter s User Exe c mode:

SFS-7000P# disable SFS-7000P>

The following example delete s a trunk grou p:

SFS-7000P(config-if-trunk)# disable

Related Commands enab l e

show interf ace et hernet

2-34

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

enable

To enter Privileged Exec mode from User Exec mode, enter the

enable

command in User Exec mode.

To enable a tr unk gr oup, en t er t he

enable

command in Trunk Interfa ce C onfigu ratio n su bmo de .

enable

Syntax Description This command has n o a rguments or keyword s.

Defaults This command has no default settings.

Command Modes User Execute mode, Trunk Inte rfac e Co nfigurat ion (con fig-if- trunk ) mod e.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-only user. Enter the

enable

command in Use r Exec m ode t o make ad mini stra tive configurati on cha nges to your

Server Switch. Ente r the

enable

command in Trunk Interface Configuration submode to activate a trunk

group.

Examples Th e following example ente rs Privileged Exec mode from Use r Exec mode:

SFS-7000P> enable SFS-7000P#

The following example en abl es a n ew trunk gr oup :

SFS-7000P(config-if-trunk)# enable

Related Commands config TACACS-server host

disable exit

2-35

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

exec

To execute a file in the config file system on your Server Switch , ente r th e

exec

command in Privileged

Exec mode.

exec

file-name

Syntax Description

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. You can create command files on a management workstation and copy them to config file system on the

switch u sing

copy

command. Then you can execute these files with

exec

command. Use the

save-log

command to save the latest commands that you have executed in the CLI to a file, then copy the file to the management station and use it as an example. See the

save-log

and

copy

commands for fu rt her

details.

Note You can run files onl y from the con fig dire ct ory of y our file syste m.

Examples The following example executes the test.cfg file in the config file system on the Server Switch:

SFS-7000P# exec test.cfg

Related Commands config TACACS-server host

copy

file-nam e Name of the file that you want to execute.

2-36

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

exit

To exit your current CLI mode and return to the previous mode, enter the

exit

command in any mode.

exit [all

]

Syntax Description

Defaults This command has no default settings.

Command Modes All modes.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

All users. The

exit

command performs different function s in differen t modes.

Examples Th e fo llowing exam ple exit s Ca rd Configur ati on sub mod e a nd en ter s Us er E xec mo de :

SFS-7000P(config-card-1,2)# exit all SFS-7000P>

Related Commands enab l e

all (Optional) Returns yo u to User Execute mod e from any other CLI mode.

Table 2-2 Exit Command Modes and Functions

Mode(s) Function

User Exec Privileged Exec

Logs you out of t h e Ser ver Sw itch .

Global Configuration Re turns you t o Privileged Exec mode. Configuration submode (any) Ret urns y ou to G lob al Con figuratio n mod e.

2-37

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

ftp-server enable

To enable the FTP server on your Server Switch, enter the

ftp-server enable

command in Global

Configuration mode. To disable this featur e, use t he

form of this command.

ftp-server enable no ftp-server

enable

Syntax Description This comm and ha s n o argume nts o r keywords .

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

All users. The FTP server feature provides read-only access to the file systems on the Server Switch and

complements the

copy

command. Use a FTP cli ent on a m a nagem ent workst at ion t o c onn ect to the

server using FTP protocol. Yo u can download log files, configurati on files or image files.

Examples Th e fo llowing exam pl e d is abl es FT P se rv ice s o n th e Ser ver S wi tc h:

SFS-7000P(config)# no ftp-server enable

Related Commands show system-services

copy telnet

2-38

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

gateway

To assign a default IP gateway to

• the Ethernet Management port,

• the virtual in-band I nfiniBand por t,

enter the

gateway

command in the approp riate Int erface Configuration mo de. To disassociate a port

from a gateway, use the

form of this command.

gateway

no gateway

Syntax Description

Defaults The gateway address de fau lts to 0 .0. 0.0.

Command Modes Ethernet Managem ent Interfa ce Configurat ion (co nfig-if-mg mt-ethe rnet) subm ode, InfiniBand

Management Interfa ce C onfigur ati on ( co nfig-if-mg mt -ib) su bmode .

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. The gateway that you assign conne cts t he po rt to t he In finiBand ba ck pla ne on your Ser ver Swit ch. You

must configure the gat eway through the Se rial Con sole po rt. En ter the I P add ress of t he gat eway when you configure the ma na geme nt i nte rfac es.

Examples The following example assigns a default IP gateway to the Ethernet Management interface:

SFS-7000P(config-if-mgmt-ethernet)# gateway 10.3.0.94

The following example assigns a defau lt IP gateway to the InfiniBand Ma nageme nt interfac e:

SFS-7000P(config-if-mgmt-ib)# gateway 10.3.0.2

Related Commands show interface mgmt-ethernet

show interface mgmt-ib snmp-server

gateway IP address of the gateway to assign to the port.

2-39

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

help

To view the help options that the CLI provides, enter the

help

command in any mode.

help

Syntax Description This comm and ha s n o argume nts o r keywords .

Defaults This command has no default settings.

Command Modes All modes.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

All users. This command may be executed in any mode. It provides the methods for you to display the various types

of available help. The

help

command provides the same instr uctio ns regardless of mode.

Examples The following example displays help options:

SFS-7000P(config-if-ib-16/1-16/12)# help Help may be requested at any point in a command by entering a question mark '?'. If nothing matches, the help list will be empty and you must backup until entering a '?' shows the available options. Two styles of help are provided:

1. Full help is available when you are ready to enter a command argument (e.g. 'show ?') and describes each possible argument.

2. Partial help is provided when an abbreviated argument is entered and you want to know what arguments match the input (e.g. 'show pr?'.) SFS-7000P360(config-if-ib-16/1-16/12)#

2-40

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

history

To display a lis t o f the c omman ds th at you execute d d urin g y our CLI se ssion, e nte r th e

history

command in a ny mod e.

history

Syntax Description This command has n o a rguments or keyword s.

Defaults The

history

command stor es t he l ast 40 com ma nds tha t yo u ente red.

Command Modes All modes.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

All users. The format of the history output and a configuration file are similar. You can cut and paste the contents

of the history output to a text file and, with minor editing, use it as a configuration file. This global command may be executed in any mode. To display just one screen of history data at a time,

configure the terminal display length.

Examples Th e fo llowing exam ple d isp lays the r ece nt c omma nd hist ory:

SFS-7000P(config)# history

1 history 2 enable 3 config 4 arp 5 boot-conf 6 boot-config 7 diagn 8 interface ib all 9 exit 10 interface ethernet all 11 ip 12 history

SFS-7000P(config)#

Related Commands copy

telnet show fan show system-services

2-41

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

hostname

To assign a hostname to yo ur Server Swi tc h, ent er th e

hostname

command in Global Configurat ion

mode.

hostname

name

Syntax Description

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. When you enter the

hostname

command, you apply the new name to the fol lowing three are as:

Step 1 Server Switch version information Step 2 CLI prompt Step 3 Server Switch network name

After you configure the host name, the name that you assigned appears in the

show version

command

output. When you change modes, the new host name will appear in the CLI prompt.

Examples Note the change in the CLI prompt that occurs in the last line of example output:

SFS-7000P(config)# hostname samplename SFS-7000P(config)# exit samplename#

Related Commands ip

ping show ve rsi o n

name Name to assign to the system.

2-42

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

install

To install an image file on your Server Switch, enter the

install

command in Privileged Exec m ode.

install

[slot-number:]

image:

file

Syntax Description

Image files must reside in the image file system and the file name must have the .img extension.

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. To run a new system image, you must follow these steps:

Step 1 Download an image file to your Server Switch. See the copy command at the “copy” s ectio n on

page 2-26.

Step 2 Power up all modules in your chassis. Step 3 Install the image file with the

install

command.

Step 4 Configure your Server Switch to run the new system image when it boots. See the boot command at the

“boot-config” section on page 2-10.

Step 5 (Optional) Execute the

action

command with the

delete-inactive-images

keyword for each card in

your chassis to remove old images.

The

install

command performs everything necessary to install a new system image to flash memory.

The command automatically in stalls all ne cessary f irmwar e and componen t images, and then updat es all cards with an administrative status of up.

To update additi onal ca rds, r e- ent er t he

install

and

boot-config

commands after you add the cards.

slot-number (Optional) Slot of the controller card (1 on the Cisco SFS 3001, Cisco SFS

7000, and Cisco 4x InfiniBand Switch Module for IBM BladeCenter; 1 or 14 on the Cisco SFS 3012; 11 or 12 on the Cisco SFS 7008).

image Specifies that the file resides in the image file-system. file The name of the image file to install.

2-43

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

install

Note When you upgrade your Ser ver Switch, your configuratio n file persists.

Examples The following example installs a new image on the Server Switch:

SFS-7000P# install image:SFS-7000P-sfsOS-2.3.0-build497.img ************************** operation completed successfully SFS-7000P#

Note If you try to install an OS image designed for Anafa chips on a system with Anafa 2 chips, you will

receive an error message.

TS120-1# install image:sfs120-sfsOS-2.2.0-build556.img Proceed with install? [yes(default) | no] ***************************** Error: This image cannot be used with the Anafa2 chip(s) installed.

Related Commands action

boot-config card dir reload show boot-config show card shutdown

2-44

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

ip http

To enable or configure HTTP and HTTPS services on your Server Switch, enter the

ip http

command

in Global Configuration m ode . To disable service or cha nge a por t num be r to the d efaul t value, use the

form of th is com m and.

ip http {polling | port number | secure-cert-common-name {useSysName |

useMgmtEnetIpAddr | useMgmtIbIpAddr} | secure-port | secure-server | server}

no ip http {polling | port | secure-port | secure-server | server}

Syntax Description

Defaults The HTTP port value defaults to 80.

HTTP services o n y our Se rver S witc h run by defau lt. The HTTPS port value default s to 44 3. HTTPS services o n y our Se rver Switc h run by defau lt.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

polling Enables polling on the Server Switch. port Specifies th e HTT P p ort th at th e H TT P s e rver use s. Re t ur ns t h e por t

configuration to th e de fault value (80) w hen you u se th e

form of the

command.

secure

-cert-common-name

Specifies where to get t he comm on n ame used to gen erate a SSL cer tif icat e.

server Enables the HTTP server on your Serv er Switch . Us e this ke yw or d with the

form of the co mma nd to di sabl e t he HT TP server.

useSysName Configures your Server Switch to use its system na me (that you configure

with the

hostname

command) in SSL certificates.

useMgmtEnetIpAddr Configures your Server Switch to use the IP addre ss of its Ether net

Management Port in SSL cert ificates.

useMgmtIbIpAddr Configure s your Server Switch to use the IP address of i ts InfiniBand

Management Port in SSL cert ificates.

secure-port Specifies the H TTP S port that t he HTT P server uses. Retur ns th e port

configuration to th e defaul t value ( 443 ) when yo u use t he no form o f t h e command.

secure-server Enables HTTPS with Secure Sockets Layer (SSL) on your Server Switch.

Use this keyword with the

form of the command to disable HTTPS.

number HTTP port (integer) that the HTTP server uses.

2-45

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

ip http

Privilege Level:

Ethernet read -write user. Configure the

ip http

command to run Cha ssis M ana ger. For more infor mat ion, ref er t o the Ch assis

Manager User Guide.

Examples The following example enables the HTTP server on the Server Switch:

SFS-7000P(config)# ip http server

Related Commands show ip http

show ip http server secure

2-46

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

link-trap

To configure internal and external ports to generate link-up and link-down SNMP traps when the operating status (ope r-status) of the po rts chang es, ente r the

link-trap

command in th e appr opr iat e

Interface Configurati on m ode. To disable this f unct ion, us e the

form of this command.

link-trap no link-trap

Syntax Description This command has n o a rguments or keyword s.

Defaults By default, ports do not generate link traps.

Command Modes All Interface Configuration submodes.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Fibre Channel read-wr ite user, Ethernet read -writ e user. Ports generate link-up traps when the oper-status of the port changes to up and link-down traps when

the oper-status of the port changes to down. Trap receivers (that you define with the

snmp-server

command) receive the traps. You can then perform link validation and checking with the receivers, or configure SNMP alert s.

Examples The following example enables li nk - t ra p generation for Fibre Channel int e rface ports 1 and 2 on card 5:

SFS-7000P(config-if-fc-5/1-5/2)# link-trap

The following example ena bl es l ink- tra p g ener ation f or In finiBand i nte rfac e po rts 1 t hrou gh 5 o n card

15. The resulting traps are sent to trap receivers, as defined by the

snmp-server

command:

SFS-7000P(config-if-ib-15/1-15/5)# link-trap

The following example enables link-trap generation for Ethernet interface port 1 on card 4. The resulting traps are sent to trap receivers, as defined by the

snmp-server

command:

SFS-7000P(config-if-ether-4/1)# link-trap

Related Commands auto-ne goti ate

shutdown show snmp snmp-server

2-47

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

location

To assign a text-based location identifier to your Serv er Swit ch , en ter the

location

command in Global

Configuration mode. To reset the locatio n to an em pty st ring, us e t he

form of this command.

location “

string

”

no location

Syntax Description

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. Use the

location

command to assign a readable identifier to your Server Switch. Use the location string to identify support pro vid er s, th e Se rv er Switch owner, the Server Switch itself, or the phy sical location of the Server Switch. Display the location with the

show location

command.

Note The

location

command configures th e same par ameter th at the

snmp-server

command configures

with the

location

and location-string arguments.

Examples The following example assigns a location to the Server Switch:

SFS-7000P(config)# location "515 Ellis Street, Mountain View, CA 94043"

Related Commands snmp-server

show location show ve rsi o n

string Refers to an ASCII text string. Enclose multi-word strings within

double-quotes (“,”).

2-48

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

logging

To identify a remote server as a server that accepts log messages from your Server Switch, enter the

logging

command in Global Configurati on mode. To undo logging settings, use the no form of this

command.

[ No] logging-se rver one <ip-address> [ No] logging -server two <ip-address>

Syntax Description

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

All users. Warnings, errors, notifications, and alerts occur once the system boots successfully. The

logging

command sends these occurrences to the remote server that you specify.

Examples The following example configures the Serve r Switch to send log messages to the host with an IP address

of 10.3.0.60:

SFS-7000P(config)# logging-server one 10.3.0.60

Related Commands show logging

terminal snmp-server show snmp

ip-address I P address of the remo te syslog server.

2-49

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

T o chang e user iden tity during a CLI session, enter th e

command in User Exec mode or Privileged

Exec mode.

userid

Syntax Description

Defaults This command has no default settings.

Command Modes User Execute mode, Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

All users. The

command allows you to assume the iden tity of anot her user wi thout having to exit the CLI.

The CLI prompts you for you r password.

Note To change back to a pr evious lo gin, do n ot u se t he

logout

command. Instea d, use th e

command

again.

Examples In the following example, the user moves from the current login to the super login:

SFS-7000P> login super Password: xxxxx SFS-7000P>

Related Commands exit

logout username show user

userid User ID that you want to use to log in.

2-50

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

logout

T o log out of the current CLI session, enter the

logout

command in User Exec mode or Privileged Exec

mode.

logout

Syntax Description This command has n o a rguments or keyword s.

Defaults This commandhas no default s ettings.

Command Modes User Execute mode, Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

All users. The

logout

command ends the current CL I session. If logged in through the Serial Con sole port, the CLI login prompt appe ars. If log ge d in t hroug h a Telnet connectio n, t he Telnet session en ds a nd you ar e returned to your operat ing system.

Examples The following example logs the user out of the CLI:

SFS-7000P# logout SFS-7000P# Connection to host lost.

Related Commands exit

2-51

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

To view the contents of a text file on y our ter minal screen, enter the

command in Privileged Exec

mode.

[slot-number:]file-system:file-nam e

Syntax Description

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-w rite user. The

command displays text da ta resident on the chassis in in crements determined b y the

terminal

length

command. The specif ie d file-system must be appropriate for the file . Se e a lso t he

dir

command

to list the names of files in the respective file-systems. Press any key (except the q key) to display the next s cree n of t ext lin es. The file-system va riabl e repres ent s the f ile syste m that c ontai ns the file. The file system var iable may b e

config or syslog. You cannot display image file data or compressed system log files. Only the cur rently active log file, ts_log, may be viewed.

Examples The following example displays the contents of the startup configuration file:

SFS-7000P# more config:startup-config ! TopspinOS-2.3.0/build560 ! Fri Mar 15 18:06:10 1935 enable config terminal ! boot-config primary-image-source TopspinOS-2.3.0/build560 ! interface mgmt-ethernet ip address 10.3.106.25 255.255.0.0

slot-number (Optional) Slot of the controller card (1 on the Cisco SFS 3001 and Cisco

SFS 7000, 1 or 14 on the Cisco SFS 301 2).

file-system File system on your Server Switch in which the text file resides.

Note For the startup configuration file, you do n ot need to inc lu de the file

system in the command syntax.

file-nam e Name of the file to disp lay.

2-52

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

gateway 10.3.0.1 no shutdown ! SFS-7000P#

Note The lines beginn ing with an e xclamati on point (!) ar e comments th at are ignored when the conf iguratio n

file executes.

The following example displays the contents of the hwif_log file:

SFS-7000P# more 14:syslog:hwif_log Mon Mar 1 00:32:10 2004: card_startup.x : card is starting up Mon Mar 1 00:32:26 2004: POST: Tavor: Firmware rev 200000000 matches tavor_fw.A

1.200000000.bin: PASSED Mon Mar 1 03:58:49 2004: card_startup.x : card is starting up Mon Mar 1 03:59:05 2004: POST: Tavor: Firmware rev 200000000 matches tavor_fw.A

1.200000000.bin: PASSED Mon Mar 1 04:01:37 2004: card_startup.x : card is starting up Mon Mar 1 04:01:53 2004: POST: Tavor: Firmware rev 200000000 matches tavor_fw.A

1.200000000.bin: PASSED Mon Mar 1 04:04:27 2004: card_startup.x : card is starting up Mon Mar 1 04:04:43 2004: POST: Tavor: Firmware rev 200000000 matches tavor_fw.A

1.200000000.bin: PASSED Mon Mar 1 04:07:10 2004: card_startup.x : card is starting up Mon Mar 1 04:07:26 2004: POST: Tavor: Firmware rev 200000000 matches tavor_fw.A

1.200000000.bin: PASSED Mon Mar 1 19:27:10 2004: card_startup.x : card is starting up Mon Mar 1 19:27:26 2004: POST: Tavor: Firmware rev 200000000 matches tavor_fw.A

1.200000000.bin: PASSED Mon Mar 1 19:30:39 2004: card_startup.x : card is starting up Mon Mar 1 19:30:55 2004: POST: Tavor: Firmware rev 200000000 matches tavor_fw.A

1.200000000.bin: PASSED Mon Mar 1 19:55:33 2004: card_startup.x : card is starting up Mon Mar 1 19:55:50 2004: POST: Tavor: Firmware rev 200000000 matches tavor_fw.A

Related Commands dir

telnet terminal

2-53

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

mtu

To configure the maximum transmission unit on the chassis, enter the

mtu

command in In finiB and

Management Interfa ce C onfigur atio n su bmo de .

mtu

integer

no mtu

Syntax Description

Defaults The IB MTU value defaults to 1500.

Command Modes InfiniBand Management Int erface Con figuration subm ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-wri te user. The maximum possible MTU for InfiniBand is higher than the MTU for Ethernet. To smoothly transition

traffic through Ethernet gateways, the factory setting of IB MTU matches the maximum Ethernet setting. On an IB-only ne twork, you c an se t t he MT U a s h igh as 204 4.

Examples The following example configures the IB MTU:

SFS-120(config-if-mgmt-ib)# mtu 1500

Related Commands show interface mgmt-ib

integer Slot of the controller card (1 on the Cisco SFS 3001 and Cisco SFS 7000, 1

or 14 on the Cisco SFS 3012).

2-54

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

name

T o assign a user-defined name to an interface port, enter the

name

command in the appropriate In terface

Configuration submode.

name

string

Syntax Description

Defaults By default, the name of a po rt a pp ears as a slot #/p ort# pai r.

Command Modes Interface Configurati on ( co nfig-if- fc, co nfig-if -ib, config- if-e the r) sub modes.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Fibre Channel rea d- wri te user, InfiniBand re ad-w rit e u ser, Ethern et re ad -wri te user. The name can be used to simplify port identification and indicate port use. Assign the same name to

multiple ports to identify the ports as a group with a uniform function. The name that you assign appears in the name field of the appropriate

show interface

command.

string Alphanumeric ASCII t ext stri ng (u p t o 20 c ha racte rs, i ncl ud ing s pac es) t o

assign to one or more ports.

2-55

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

ntp

To synchronize t he c lock o n y our Se rver Sw itch t o pri mary, secondary, and tertiary NTP se rver s, en ter the

ntp

command in Global Configuration mode. To reset an NTP configuration to the default value, use

the

form of this command.

ntp {server-one

server-two

server-three

} ip-a ddress

no ntp {server-one

server-two

server-three

}

Syntax Description This comm and ha s n o argume nts o r keywords .

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. Use the

ntp

command to configure your Server Switch to take time information from up to three servers so that your Server Switch can identify a problem when one server sends faulty data packets. W e strongly recommend that you c onfigure a ll t hree se rvers fo r m axi mum pre cisi on .

Examples Th e following exampl e a ssigns pr ima ry, secondary, and tertiary NTP servers to t he Ser ver Swi tch :

SFS-7000P(config)# ntp server-one 10.0.3.110 SFS-7000P(config)# ntp server-two 10.0.3.111 SFS-7000P(config)# ntp server-three 10.0.3.112

Related Commands clock set

show clock show ntp snmp-server

2-56

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

ping

T o verify that your Server Switch can reach a given host, enter the

ping

command from User Exec mode

or Privileged Exec mode.

ping

host

Syntax Description

Defaults This command has no default settings.

Command Modes User Execute mode, Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-only user. Use the

ping

command to v e rify connectivity between yo ur Ser ver Switch and a host or port. Th e r ep ly

packet tells you if the host rec eived the ping and the amou nt of time i t took to ret urn the pack et.

Note You must configur e a DNS server on your netwo rk to use ho stnames as an argume nt in the

ping

command.

Examples Th e foll owing exampl e verifies tha t the Se rver Swit ch can co nta ct th e device with an IP addr ess of

10.3.102.24:

SFS-7000P# ping 10.3.102.24 Sending 5 ICMP Echoes to 10.3.102.24, 56 data bytes !!!!! Success rate is 100 percent (5/5) round-trip min/avg/max = 0.000000/0.000000/0.000000 ms SFS-7000P#

Related Commands hostname

host IP address or hostname of the host, port, or expansion module that you want

to reach.

2-57

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

power-supply

To enter Power Supply Configurat ion subm ode, ent er th e

power-supply

command from Global

Configuration mode.

power-supply [

all

| selection]

Syntax Description

Defaults This command has no default settings.

Command Modes Global Configuration mo de.

Usage Guidelines

Platform Availability:

Cisco SFS 7000, Cisco SFS 7008

Privilege Level:

General read-wri te user. Use the

shutdown

no shutdown

commands to bring down and bring up power supplie s. The

command will only let you bring down one power supply at a time.

Examples Th e following exampl e e nte rs Power Supply Con figuratio n s ubmode f or a ll power supp lies :

SFS-120(config)# power-supply all

Related Commands show power-supply

all (Optional) Configures all power supplies.

selection (Optional) Selection of power supplies to configure.

2-58

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

radius-server

To configure up to three RADIUS servers that your Server Switch uses to authenticate CLI user logins, enter the

radius-server

command in Global Configuration mode. To remove a RADIUS server from

the configuration, use the

form of this comm an d.

radius-server host ip-address [auth-port udp-port] [timeout seconds] [retransmit retries] [key

encryption - key]

no radius-server host ip-address

Syntax Description

Defaults The RADIUS server IP address defaults to 0.0. 0.0, whi ch assigns no server, and the Server Switch

authenticates locally by default. The udp-port variable defaults to 1812.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted read-write access.

host Specifies the IP address of the RADIUS server. ip-address IP address of the RADIUS server. auth-port (Optional) Specifies the user datagram protocol (UDP) authentication port

of the RADIUS server.

udp-port (Optional) UDP authen tica tion port of the RADIUS ser ver. timeout (Optional) Specifies the amount of time t hat y our Server Switch wa its fo r a

reply from the server before t he login requ est time s out.

seconds (Optional) Amount of time, in seconds, that your Server Switch wa its for a

reply from the server before t he login requ est time s out.

retransmit (Optional) Specifies the number of times that your Server Switch tries to

authenticate after a timeout.

retries (Optional) Number of times that your Server Switch tries to authenticate

after a timeout.

key (Optional) Specifies the authenticatio n k e y that the client and radius serv er

use.

encryption-key (Opti onal) Encr yption key that the clie nt and rad ius server use.

2-59

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

radius-server

Configure a RADIUS server to authenticate CLI user logins. Enter the

authentication

command to

enable authentication and to conf i gure your Se rver Switch to au thentic ate with the RADIUS serv er. Use the show authentication command to display the co nfigurat ion of the rad ius se r ver, including t he priority.

Examples The following example assigns the RADIUS server that the Server Switch can use to validate logins:

SFS-7000P(config)# radius-server host 10.5.0.100

Related Commands authenti cat ion

boot-config clock set show authentication snmp-server config TACACS-server host

2-60

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

reload

To reboot your Server Switch, en ter the

reload

command in Privileged Exec mode .

reload [no-failover

]

Syntax Description

Defaults This command has no default settings.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-wri te user. At stages of chassis a nd interface se tup, you need to reinitialize chass is firmw are or restor e interface card

configurations. Use the

reload

command because it allows the chassis to close files and prepare for

shutdown. The

reload

command brings down th e entire Serv er Switc h and restarts all of the cards in the

Server Switch. The Server Switch prompts you to verify the reload. If you have not already saved configuration changes,

and the Server Switch detects the changes, it prompts you to save. T o store the new configuration as the startup configuration, enter yes at the prompt. To store the configuration elsewhere under a different file name, enter the new file name and press Enter.

The system reinitializes itself and then loads the active system image and the startup configuration file. Wait a few minutes and attempt to log onto the chassis.

Note If your Server Switch includes a second controller card, the CLI will prompt you to save changes to the

backup controll er as well as to the prim ary con troll er.

Examples The following example reloads the Server Switch:

SFS-7000P# reload System configuration has been modified. Save? [yes(default)/no/*.cfg] yes Proceed with reload? [confirm] SFS-7000P# Connection to host lost. #

no-failover

(Cisco SFS

3012 only)

(Optional) Forces a Cisco SFS 3012 to run from the same controller card when it reboots. By default, Cisco SFS 3012 Server Switches swap active controller cards when they reboot.

2-61

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

reload

Related Commands boot-config

broadcast install who show boot-config

2-62

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

save-log

To save a log file of the last 40 co mmand s t hat y ou ent ere d, en ter the

save-log

command in Pr ivilege d

Exec mode.

save-log

[filename]

Syntax Description

Defaults If you do not provid e a na me for the lo g file, y our Server Switc h assi g ns a name wi th t he fol lowing

format:

savelog.mmddhhmmss

where mmddhhmmss represents the system UTC time.

Command Modes Privileged Execute mode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

General read-wri te user. Your Server Switch sto res sa ve-log files t o the sy slog direct ory . T o exe cute the co mmands in th e sav e-log

file, copy the file to a host, edit it appropriately, copy it to the config file system on a Server Switch, and run the

exec

command.

Examples Th e foll owing example saves the last 40 co mman ds as a file ca lled mylo g.lo g:

SFS-7000P# save-log mylog.log

Related Commands exec

history

filename (Optional) Nam e of the file you create to store your co mmand history.

2-63

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

shutdown

Use the shutdown command to disable any of th e foll owing:

• A specific interface card or port

• An Ethernet Mana ge ment po rt

• An InfiniBand Management port

• A power supply

Enter the

shutdown

command in the a pp rop riat e c on figurati on subm ode. To enable any of th ese

elements, use the

form of this command.

shutdown no shutdown

Syntax Description This comm and ha s n o argume nts o r keywords .

Defaults This command has no default settings.

Command Modes Card Configuration (config-card) subm ode, Eth ernet Man agement In terface Configura tion

(config-int-mgmt-ethe rn et) sub mo de, InfiniBa nd Man agem en t In terfa ce C onfigurati on (config-int-mgmt-ib) submode, Ethernet Interface Configuration (config-if-ether) submode, InfiniBand Interface Configuration ( co nfig-if-i b) subm od e, Fibr e Chann el Int erfac e Co nfigurat ion (c on fig-if-fc ) submode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted or card-s pecific re ad-wri te user.

Enabling/Disabling a card:

Before you use the

action

command on a card, you must enable (bring up) the card. To enable or disable

a card, follow the se step s:

Step 1 In User Exec mode, enter the

enable

command to enter Privileged Exec mode .

Step 2 Enter t he

configure terminal

command to ent er G loba l C onfigurat ion m ode .

Step 3 Enter t he

card

command and specify the card or cards that you want to enable.

Step 4 Enter t he

shutdown

command or the

no shutdown

command to d isa ble o r en able th e ca rd s t hat y ou

specified in the previous step.

2-64

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

shutdown

When you use the

shutdown

command to disable a card, the card stops processing packets and powers

down.

Enabling/Disabling an interface port:

You canno t update or de lete the ac tive system image on a card when you disable the card. Be fore yo u update the active system image on your Server Switc h, enab le all cards that you want t o update. To enable or disable a port, fo llow thes e step s:

Step 1 In User Exec mode, enter the

enable

command to enter Privileged Exec mode .

Step 2 Enter t he

configure terminal

command to ent er G loba l C onfigurat ion m ode .

Step 3 Enter t he

interface

command and a ppropr iat e keyword (

ethernet, fc

, or ib), then specify the port or

ports that you want to enable.

Step 4 Enter t he

shutdown

command or the

no shutdown

command to d isa ble o r en able th e ca rd s t hat y ou

specified in Step 3.

Enabling/Disabling the Ethernet Management Port:

You canno t update or de lete the ac tive system image on a card when you disable the card. Be fore yo u update the acti ve system image on your Server Switch, enab le all cards that you wa nt to upda te.To enable or disable the Ethe rnet Ma nage ment port , f oll ow these ste ps:

Step 1 In User Exec mode, enter the

enable

command to enter Privileged Exec mode .

Step 2 Enter t he

configure terminal

command to ent er G loba l C onfigurat ion m ode .

Step 3 Enter the

interface mgmt-ethernet

command to enter Ethernet Management Interface Configuration

submode.

Step 4 Enter t he

shutdown

command or the

no shutdown

command to disa ble o r en abl e t he por t.

You must enab le the Et hern et Manage ment por t before you can configur e it. Use th e

no shutdown

command to bring up the Ethernet Ma nagement port before you assign IP and gat eway ad dresses to the port.

When you disable the Ethernet Management port, the current configuration of the port remains intact. If you experience problems co nfiguring the Et hernet Manageme nt port , first check that the admin-st atus field in the

show interface mgmt-ethernet

command output displays up.

Enabling/Disabling the Infiniband Management port:

Step 1 In User Exec mode, enter the

enable

command to enter Privileged Exec mode .

Step 2 Enter t he

configure terminal

command to ent er G loba l C onfigurat ion m ode .

Step 3 Enter t he

interface mgmt-ib

command to en ter In finiBan d M ana geme nt I nte rfac e Co nfigurat ion

submode.

2-65

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

shutdown

Step 4 Enter t he

shutdown

command or the

no shutdown

command to disa ble o r en abl e t he por t.

The InfiniBand Manageme nt port provid es Telnet, SSH, and Element Manag er access to InfiniBand hosts that run IPoIB and connec t to any of the InfiniBand ports on your Ser ver Switch. With the IB management port, you ca n run m a nag eme nt a pplic ati on s over IPo IB.

Note You must configur e the IP addre ss and gateway of the Infiniband Mana gemen t port throug h the Ser ial

Console terminal. Use the ip and

gateway

commands.

Examples The following example enables interface card 12:

SFS-7000P(config-card-12)# no shutdown

The following example e nab le s the in terfa ce Ma nage me nt E the rne t p ort:

SFS-7000P(config-if-mgmt-ethernet)# no shutdown

The following example e nab le s the in terfa ce Ma nage me nt I B por t:

SFS-7000P360(config-if-mgmt-ib)# no shutdown

The following example sets the admi n-status field for port s 1 through 6 on InfiniBa nd card 15 to up:

SFS-7000P(config-if-ib-15/1-15/6)# no shutdown

Related Commands action

auto-negotiate card gateway ip link-trap show card show fc srp initiator show interface mgmt-serial type

2-66

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

snmp-server

To store contact and location info rmat ion and to con figure the SNMP notificatio n host and SNMPv3 user, enter the

snmp-server

command in Global Configuration mode. To replace these values with

empty strings, enter th e

form of this command.

snmp-server {contact “

contact-string” |

engineID local

engine-string |

host

dest

[community-string] [

recv-event-traps

] |

location “

location-string” |

enable traps

authentication

}

snmp-server user

username {

disable

enable

privilege

privileges | v3 [

encrypted] auth

{

md5

sha

} password [

priv des56

privacy]}

no snmp-server {contact | ho st ip-a ddress [recv-event -tra p s] | lo cation | user username v3 |

enable traps authenti catio n}

Syntax Description contact Stores the contact information for your Server Switch. This contact

information appears in the

show ve rs i o n

command outpu t.

host Configures your Server Switch to communicate with the host that receives

SNMP traps from y our Server Swit ch.

engineID Configures a SNMPv3 en gine I D . local Configures the engine ID of the local agent.

engine-string Engine ID, as a 15-octet string.

location Stores location information about your Server Switch. This contact

information appears in the

show ve rs i o n

command outpu t.

contact-string ASCI I text string of conta ct informa tion. dest IP address or DNS name of an SNMP server. community-string (Optional) SNMP community string that authenticates your Server Switch

to the SNMP server.

recv-event-traps (Option al) Configures the Server Switch to send SNMP traps to th e receive r .

If you configure this keyword, the rem ote ho st re ceives SNMP events as well as traps.

location-string ASCII text string of location information. user Specifies the user ID that you want to configure. username U ser ID th at you want to c onfigure.

disable Disables the SNMP user. enable Enables the SNMP user. privilege Assigns privileges to the user. enable traps

authentication

Generates a trap each time a user is blocked from accessing the system.

2-67

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

snmp-server

Defaults This command has no default settings.

Command Modes Global Configuration (c onfig) m ode.

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted rea d-write user. The snmp-server cont act stri ng appe ars when yo u v iew system vers ion o r SNMP in forma ti on. The snmp-server host string appears in th e

show snmp

command output.

The

host

keyword configures the IP address of the host that you want to rece ive traps.

Note SNMPv3 configurations are not port able acro ss Server Switches. You must configure SNMPv3

individually on each chassis. If you migrate a co nfiguration file from one chassis to anothe r, the SNMPv3 section does not appear.

privileges Privileges to apply to the user. The privileges may be any combination of

the following:

• ib-ro

• ib-rw

• ip-ethernet-ro

• ip-ethernet-rw

• fc-ro

• fc-rw

• unrestricted-rw

You must enter whichever pri vileg es you include in the order in which the y appear above.

v3 Configures a user with the SNMPv3 security model. encrypted (Optional) Specifies passwords as digests auth Configures authentication parameters for the user. md5 Specifies md5 authentication. sha Specifies sha authentication.

password Authentication password to assign to the user.

priv (Opt iona l) Configures p rivacy for the use r an d a ssign s a p rivacy password. des56 (Optional) Configures the privacy type.

privacy Privacy pa ssword.

2-68

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

snmp-server

Examples The following example stores contact information on your Server Switch and assigns a SNMP server to

your Server Switch:

SFS-7000P(config)# snmp-server contact "support@cisco.com" SFS-7000P(config)# snmp-server host 10.3.106.99 secret

The following e xample inputs u ser “dog” wi th the SNMPv3 sec urity model, assigns md5 auth entication, a password of “cat,” and assigns des56 privacy with a password of “fish” in the configuration :

SFS-270(config)# snmp-server user dog v3 auth md5 cat priv des56 fish

Related Commands gatewa y

radius-server ntp location logging

2-69

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

speed

To configure the connection speed between Fibre Channel interface ports on your Server Switch and Fibre Channel devices, enter the

speed

command in Fibre Channel Interface Configura tion submod e.

T o assign an Ethernet connection speed to a port or ports, enter the

speed

command in Ethernet Interface

Configuration submode.

speed

Syntax Description

Defaults By default, Fibre Cha nnel con ne ctions ru n at 2 000 M bps (2 G bp s).

Command Modes Fibre Channel Interface Con figuration (config- if-fc) mode , Ether net Interfa ce Configurati on

(config-if-ether) submo de , I nfiniBand In terface C onfigura tion (co nfig-if- ib) sub mod e (se lec t Se rver Switches).

Usage Guidelines

Platform Availability:

Cisco SFS 3001, Cisco SFS 7000, Cisco SFS 7008, Cisco SFS 3012, Cisco 4x InfiniBand Switch Module for IBM BladeCenter

Privilege Level:

Unrestricted read-write user, Fibre Channel read-write user, Ethernet read-write user, InfiniBand read-write us er.

Fibre Channel:

The speed of a connection does not necessa rily ma tch the speed th at you configure. If your conn ection cannot physically connect at the speed t hat you specify, the connection runs at a slower speed that your Server Switch automatical ly det ects. A s so on as a phy sical cha nge m akes yo ur spee d s etti ng possi ble , the connection will run at the speed that you specified.

Note You canno t manuall y configure conne ctio n speed you enabl e auto- negotiation . Enter t he

no auto-negotiate

command before you ma nually configure co nnectio n speed.

Ethernet:

The

speed

command sets the a dmi nist rative speed (the spe ed t hat yo u want) on ly. Self-detectio n determines the actual speed, which depends on the capabilities of the connection. You must disable the auto-negotiation feature to manually configure speed.

speed Integer value th at conf ig ure s the speed (in Mb ps) of the co nnec tion betw een

your Server Switch and a Fibre Channel device or Ethernet device. For Fibre Channel, enter 1000 for 1 Gbps or 2 000 for 2 Gbps.

2-70

Cisco SFS 7000 Series Product Family Command Reference Guide

OL-9163-02

Chapter 2 Administrative Commands

speed

InfiniBand:

The

speed

command sets the administrative speed only. Self-detection determines the actual speed, which depends on the capabilities of the connection. You must disable the auto-negotiation feature to manually configure speed .

Examples Th e fo llowing exam ple set s t he pre ferr ed sp eed to 1 ,00 0 Mb ps ( 1 Gb ps) . Th e r e sults of t his co mm an d

may be viewed in t he a dmi n-spe e d field f or Fibre C ha nnel int erfac es us ing the

show interface fc

command:

SFS-7000P(config-if-fc-5/4)# speed 1000

The following example sets the et hernet inter face (slot 4, por t 1) to a speed of 100 Mbps :

SFS-7000P(config-if-ether-4/1)# speed 100

The following example sets all InfiniBand interfaces on a Cisco SFS 7000 to a speed of 4x:

SFS-120(config-if-ib-1/1-1/24)# speed 4x

Related Commands auto-ne goti ate

half-duplex show fc srp initiator show interfa ce et hern et

Cisco SFS7000P-SK9 - SFS InfiniBand Server Switch 7000 Command Reference Manual

Specifications and Main Features

Frequently Asked Questions

User Manual