Appendix a Command Line Interface | Q-Logic 59226-00 B specs

SANbox 1400 Series Switch Management User’s Guide

S

5.2.6	Changing Port Symbolic Name	.5-14
5.3	Using the Extended Credits Wizard	.5-15
5.4	Resetting a Port	.5-16
5.5	Testing Ports	.5-16
5.6	Graphing Port Performance	.5-18
5.6.1	Starting SANsurfer Performance View	.5-19
5.6.2	Exiting SANsurfer Performance View	.5-20
5.6.3	Saving and Opening Performance View Files	.5-21
5.6.4	Changing the Default Performance View File Encryption Key	.5-22
5.6.5	Setting SANsurfer Performance View Preferences	.5-22
5.6.6	Setting the Polling Frequency	.5-23
5.6.7	Displaying Graphs for a Switch	.5-23
5.6.7.1	Arranging Graphs in the Display	.5-24
5.6.7.2	Customizing Graphs	.5-24
5.6.7.3	Setting Global Graph Type	.5-26
5.6.7.4	Rescaling a Selected Graph	.5-26
5.6.8	Printing Graphs	.5-27
5.6.9	Saving Graph Statistics to a File	.5-27

Appendix A Command Line Interface

A.1	Logging On to a Switch	A-1
A.2	User Accounts	A-2
A.3	Working with Switch Configurations	A-2
A.3.1	Modifying a Configuration	A-3
A.3.2	Backing up and Restoring Switch Configurations	A-4
A.4	Commands	A-6
	Admin Command	A-8
	Alias Command	A-9
	Config Command	A-11
	Create Support Command	A-14
	Date Command	A-16
	Feature Command	A-17
	Firmware Install Command	A-18
	Hardreset Command	A-19
	Help Command	A-20
	History Command	A-21
	Hotreset Command	A-22
	Image Command	A-23
	Lip Command	A-26
	Passwd Command	A-27

Page viii

59226-00 B

Image 8

Q-Logic 59226-00 B manual Appendix a Command Line Interface

Contents

SANbox 1400 Series Switch Management User’s Guide Document Revision History Revision B Changes Document Sections Affected Table of Contents Section Managing Fabrics SANbox 1400 Series Switch Management User’s Guide Managing Switches Section Section Managing Ports Appendix a Command Line Interface Glossary Index List of Figures List of Tables SANbox 1400 Series Switch Management User’s Guide 59226-00 B Intended Audience Related Materials Jdom License Training Technical SupportAvailability Contact Information Using SANsurfer Switch Manager Workstation Requirements Installing the Management ApplicationWorkstation Requirements For a Linux platform SANsurfer Switch ManagerFor a Windows platform SMS Installation for Windows SANsurfer Management SuiteFor a Solaris platform For a Mac OS X platform 59226-00 B SMS Installation for Linux Chmod +x sansurferswitchmgrlinuxx.xx.xx.bin SMS Installation for Solaris Locate and execute the file sbmoversms.sh Install the new SANsurfer Switch Manager packageChange directories to the package location Starting SANsurfer Switch Manager ‰ For Linux or Solaris enter the SANsurfer command Initial Startup Dialog SANsurfer Switch Manager Window Exiting SANsurfer Switch Manager Save Default Fabric View File Dialog Load Default Fabric File Dialog Uninstalling SANsurfer Switch Manager SMS Uninstall Standalone Uninstall UninstallerData/UninstallSANsurferSwitchManager Changing the Encryption Key for the Default Fabric View File Saving and Opening Fabric View Files Setting SANsurfer Switch Manager Preferences Using Online Help Viewing Software Version and Copyright Information Faceplate Display SANsurfer Switch Manager User InterfaceTopology Display Menu Bars Topology Display Menu Faceplate Display Menu Shortcut Keys Tool Bar Button Description Tool BarTool Bar Buttons Fabric Tree Fabric Tree Data Window and Tabs Working Status IndicatorGraphic Window Using the Topology Display 10. Topology Display Selecting Switches and Links Switch and Link StatusWorking with Switches and Links Arranging Switches in the Display Opening the Faceplate and Topology Display Popup Menus Topology Data Windows Using the Faceplate Display Port Views and Status Opening the Faceplate Popup Menu Working with PortsSelecting Ports Faceplate Data Windows Components of Fibre Channel fabric security are Fabric SecurityUser Account Security Fabric Services Enabling Snmp ConfigurationClick the In-band Management Enable button Enabling In-band Management Saving a Version Snapshot Security Consistency ChecklistTracking Fabric Firmware and Software Versions Managing the Fabric Database Viewing and Comparing Version SnapshotsExporting Version Snapshots to a File Adding a Fabric Add a New Fabric Dialog Removing a Fabric Opening a Fabric View FileSaving a Fabric View File Rediscovering a Fabric Deleting Switches and Links Adding a New Switch to a Fabric Replacing a Failed Switch Displaying Fabric Information Fabric Status Topology Display Switch and Status Icons Switch Icon Description Displaying the Event Browser Events Browser Discarded when you close a SANsurfer Switch Manager session Severity LevelsEditor or browser Severity Description Icon Filtering the Event Browser Filter Events Dialog Sorting the Event Browser Saving the Event Browser to a File Entry Description Devices Data WindowDevices Data Window Entries Active Zone Set Data Window Active Zone Set Data Window SANsurfer Switch Manager enables you to do the following Link Data WindowWorking with Device Information and Nicknames Displaying Detailed Device Information Creating a Nickname Exporting Device Information to a FileManaging Device Port Nicknames Exporting Nicknames to a File Editing a NicknameDeleting a Nickname Zoning Concepts Importing a Nicknames FileZoning a Fabric Zones Soft Zones Zone Sets Access Control List Hard ZonesAliases Zoning Database Managing the zoning database consists of the following Using the Zoning WizardManaging the Zoning Database Editing the Zoning Database Edit Zoning Dialog Managing Fabrics Zoning a Fabric Edit Zoning Dialog Tool Bar Buttons and Icons Configuring the Zoning Database Interop Auto Save Default Visibility Discard InactiveSaving the Zoning Database to a File Restoring the Zoning Database from a File Restoring the Default Zoning Database Removing All Zoning Definitions Managing Zone Sets Creating a Zone Set Removing a Zone from a Zone Set or from All Zone Sets Activating and Deactivating a Zone SetCopying a Zone to a Zone Set Managing zones involves the following Removing a Zone SetManaging Zones Creating a Zone in a Zone Set Adding Zone Members Renaming a Zone or a Zone Set Removing a Zone MemberRemoving a Zone from a Zone Set Removing a Zone from All Zone Sets Creating an Alias Changing Zone TypesManaging Aliases Adding a Member to an Alias Removing an Alias from All Zones Merging Fabrics and Zoning Zone Merge Failure Zone Merge Failure Recovery Managing Switches Factory User Accounts Account Name Password Admin Authority ExpirationManaging User Accounts User Account Administration Dialog Add Account Creating User Accounts User Account Administration Dialog Remove Account Removing a User Account Changing a User Account Password User Account Administration Dialog Change Password User Account Administration Dialog Modify Account Modifying a User Account Displaying Switch Information Faceplate Display Switch Information Switch Data Window Switch Data Window Entries Ratov Switch Data Window Entries Port Statistics Data Window Port Information Data Window Configured Zonesets Data Window Configured Zonesets Data Window Configuring Port Threshold Alarms Port Threshold Alarm Configuration Dialog Paging a Switch Port Threshold Alarm Example Setting the Date/Time and Enabling NTP Client Resetting a Switch Switch Resets Type Description Configuring a Switch Using the Configuration Wizard Switch Properties Symbolic Name Parameter Description Switch Administrative StatesSwitch Administrative States Domain ID and Domain ID Lock Fabric Device Management Interface Broadcast Support In-band Management Advanced Switch Properties 10. Advanced Switch Properties Dialog Timeout Values Timeout Values Interop Mode for Zoning Legacy Port Address Format Network Properties 11. Network Properties Dialog IP Configuration IP Configuration Parameters Remote Logging NTP Client Snmp Properties 12. Snmp Properties Dialog Snmp Configuration Snmp Configuration Parameters Snmp Trap Configuration Snmp Trap Configuration Parameters Archiving a Switch Restoring a Switch 13. Restore Dialogs Full and Selective Managing Switches Restoring a Switch Setting Value Restoring the Factory Default ConfigurationFactory Default Configuration Settings Downloading a Support File Installing Firmware Displaying Hardware Status 14. Hardware Status LEDs Managing Switches Displaying Hardware Status 59226-00 B Managing Ports Displaying Port Information Monitoring Port Status Displaying Port TypesPort Types State Description Displaying Port Operational States Displaying Port SpeedsPort Operational States Port Speeds Media Icon Description Displaying Transceiver Media StatusPort Transceiver Media View Port Statistics Data Window Entries LIP ALPD,ALPS Port Information Data Window Entries Entry Description Port Address Port Fibre Channel address Port Information Data Window Entries Port Information Data Window Entries Configuring Ports Port Properties Dialog Changing Port Administrative States Port Administrative States Changing Port Speeds Changing Port Types Device Scan Changing Port Symbolic NameStream Guard Using the Extended Credits Wizard Designate Donor Ports Resetting a Port Testing Ports Managing Ports Testing Ports Graphing Port Performance Performance View Graphs This section describes how to do the following Starting SANsurfer Performance View Save Default Performance View File Dialog Exiting SANsurfer Performance View Load Default View File Dialog Saving and Opening Performance View Files Changing the Default Performance View File Encryption Key Setting SANsurfer Performance View Preferences Setting the Polling Frequency Displaying Graphs for a Switch Arranging Graphs in the Display Customizing Graphs Default Graph Options Dialog Setting Global Graph Type Rescaling a Selected Graph Printing Graphs Saving Graph Statistics to a File Managing Ports Graphing Port Performance 59226-00 B Command Line Interface Logging On to a Switch Working with Switch Configurations User Accounts Modifying a Configuration Backing up and Restoring Switch Configurations Ftp ipaddress Keystroke Effect CommandsTable A-1. Command-Line Completion Admin Session Commands Table A-2. Commands Listed by Authority LevelMonitoring Commands Configuration Command Admin Command AuthoritySyntax Keywords Alias Command Syntax aliasKeywords add alias memberlist Copy aliassource aliasdestination Delete alias ListMembers alias Remove alias memberlist Keywords activate configname Config CommandSyntax config Save configname Edit confignameRestore # ftp symbolicname or ipaddress Syntax create support Create Support CommandAuthority None Local directory now /itasca/conf/images bin Keywords MMDDhhmmCCYY Date CommandSyntax date Feature Command Authority None Syntax featureKeywords add licensekey Log Syntax firmware install Firmware Install CommandAuthority Admin Hardreset Command Syntax Help Command Help command keywordCommand Keyword History History CommandFollowing is an example of the History command Hotreset Command Hotreset Image Command Ftp Ftp switchname Wait for the unpack to complete Lip Command Admin sessionFollowing is an example of the Lip command Lip portnumber Passwd Command Syntax passwd accountname Keywords accountname Ping Command Authority None Syntax pingIpaddress Keywords ipaddress Ps Command Examples The following is an example of the Ps commandAuthority None Syntax ps Displays current system process information Syntax quit, exit, or logout Quit CommandCloses the Telnet session Keywords config configname Reset CommandSyntax reset Switch Table A-3. Switch Configuration DefaultsParameter Default System Table A-4. Port Configuration Defaults Arbff Table A-5. Port Threshold Alarm Configuration Defaults Table A-6. Zoning Configuration Defaults Table A-7. Snmp Configuration Defaults Table A-8. System Configuration Defaults Set Command Keywords alarm optionConfig option Syntax set Setup option Switch stateLog option Pagebreak state Timezone Set Config Command Set configTable A-9. Set Config Port Parameters Port portnumber Send Arbff True instead of IDLEs False on Table A-9. Set Config Port Parameters Table A-10. Set Config Switch Parameters Resource Allocation Timeout Value. The number Table A-11. Set Config Threshold Parameters Threshold Table A-12. Set Config Zoning Parameters Arbff Following is an example of the Set Config Switch command Edtov Following is an example of the Set Config Threshold command Following is an example of the Set Config Zoning command Attributes Set Log Command Set logArchive Clear Display filter Level filter Port portlist Alarms are always logged and always displayed on the screen SaveStart Stop Set Port Command EnableKeywords portnumber Bypass alpa Disables the port by removing power from the port lasers State state Set Setup Command Set setupTable A-13. Snmp Configuration Settings Snmp System Table A-14. System Configuration Settings Table A-14. System Configuration Settings Trap Severity Options Following is an example of the Set Setup System command SANbox admin # set setup system Keywords about Show CommandAuthority None Syntax show Log option Alarm optionFdmi portwwn Displays name server information for all switches and ports LsdbNs option Pagebreak Table A-15. Show Port Parameters Tbuf LIPF8ALPS Post log Steering domainid Table A-16. Switch Operational Parameters Support Displays the current time zone setting TopologyDisplays all connected devices Users Following is an example of the Show Domains command Following is an example of the Show Fabric commandFollowing is an example of the Show Fdmi command Version Following is an example of the Show Fdmi WWN command Following is an example of the Show NS local domain command Following is an example of the Show Interface command Following is an example of the Show NS domainID commandFollowing is an example of the Show NS portID command Following is an example of the Show Port command PL-XPL-VC-SG3-22 Following is an example of the Show Switch command Following is an example of the Show Topology command SANbox # show topology 1 Local Link Information Following is an example of the Show Version command Show Config Command Show config Following is an example of the Show Config Switch command Following is an example of the Show Config Threshold command Following is an example of the Show Config Zoning command Show Log Command Show logNumber of events Component Snmp events Displays all informative events Displays all warning eventsDisplays all critical events Displays all events related to EPorts Settings LevelOptions Port Following is an example of the Show Log command Show Perf Command Following is an example of the Show Perf Byte command Mfg Show Setup CommandShow setup Following is an example of the Show Setup Snmp command Following is an example of the Show Setup System command Shutdown Command Syntax shutdown Test Command Syntax testKeywords port portnumber testtype Status Admin start Command Line Interface Test Command Authority None Syntax uptime Uptime CommandExamples The following is an example of the Uptime command Keywords accounts User CommandSyntax user Following is an example of the User Edit command Following is an example of the User Accounts commandFollowing is an example of the User Add command Following is an example of the User Delete command Following is an example of the User List command Authority None Syntax whoami Whoami CommandExamples The following is an example of the Whoami command Zone Command Syntax zoneKeywords add zone memberlist Copy zonesource zonedestination Delete zone Members zoneRemove zone memberlist Rename zoneold zonenew Following is an example of the Zone Members command Following is an example of the Zone Zonesets command Zoneset Command Syntax zoneset Deactivate Delete zonesetRemove zoneset zonelist Rename zonesetold zonesetnew Following is an example of the Zoneset Zones command Opens a Zoning Edit session Zoning CommandKeywords active Limit Description LimitsTable A-17. Zoning Database Limits 108 59226-00 B Following is an example of the Zoning Limits command E2JBOD2 Following is an example of the Zoning List command Command Line Interface Zoning Command 59226-00 B 111 Command Line Interface Zoning Command 112 59226-00 B Access Control List Zone Administrative StateAlarm BootP Class 3 Service Configured Zone SetsDefault Visibility Fabric Management Switch Input Power LED Inter-Switch LinkMaintenance Button Maintenance Mode Soft Zone TargetUser Account World Wide Name WWN Index Index-2 59226-00 B 59226-00 B Index-3 Index-4 59226-00 B 59226-00 B Index-5 Index-6 59226-00 B 59226-00 B Index-7 Index-8 59226-00 B