Test Command, Syntax test, Status | Q-Logic 8C/16 guide

A – Command Line Interface Test Command

Q

Test Command

Tests ports using internal (SerDes level), external (SFP), and online loopback tests. Internal and external tests require that the port be placed in diagnostic mode. Refer to the ”Set Command” on page A-27for information about changing the port administrative state. While the test is running, the remaining ports on the switch remain fully operational.

Authority Admin

Syntax test

port [port_number] [test_type] cancel

status

Keywords port [port_number] [test_type]

Tests the port given by [port_number] using the test given by [test_type]. If you omit [test_type], Internal is used. [test_type] can have the following values:

internal

Tests the SerDes. This is the default. The port must be in diagnostics mode to perform this test.

external

Tests both the SerDes and SFP. The port must be in diagnostics mode to perform this test, and a loopback plug must be installed in the SFP.

online

Tests one online port.

cancel

Cancels the online test in progress.

status

Displays the status of a test in progress, or if there is no test in progress, the status of the test that was executed last.

Examples To run an internal (SerDes) or external (SFP) port test, do the following:

1.To start an admin session, enter the following command and press the Enter key.

admin start

2.Place the port in Diagnostics mode, enter the following command (x = port number) and press the Enter key.

set port x state diagnostics

3.Insert the loopback plug into the SFP on the selected port.

A-70	59022-06 A

Image 184

Q-Logic 8C/16 manual Test Command, Syntax test, Keywords port portnumber testtype, Status

Contents

SANbox2-8c/16 Switch Management User’s Guide SANbox2-8c/16 Switch Management User’s Guide Document Revision History Table of Contents Section Managing Fabrics Section Managing Switches Displaying Switch Information Section Managing Ports Appendix a Command Line Interface Command Syntax Glossary Index Appendix B Graphing Port PerformanceInitial Startup Dialog SANbox Manager Window Account Administration Add Account Administration Remove TablesMenu Shortcut Keys Tool Bar Buttons Severity Levels Edit Zoning Window Tool Bar Buttons Port Administrative States Port Speeds Port Modes Intended Audience Related Materials Technical Support AvailabilityTraining Contact Information Installing SANbox Manager Management Workstation Requirements SANsurfer Management Suite Disk Windows Installation SANsurfer Management Suite Disk Linux Installation Enter the following command SANsurfer Management Suite Disk Solaris Installation SANbox2 Installation Disk Linux Installation SANbox2 Installation Disk Windows InstallationSANbox2 Installation Disk Solaris Installation „ For a Solaris platform, enter the SANboxManager command „ For a Linux platform, enter the SANboxManager commandStarting SANbox Manager SANbox Manager Window Save Default Fabric File Dialog SANbox Manager Exiting SANbox Manager Uninstalling SANbox Manager Changing the SANbox Manager Default Fabric File Password Saving and Opening SANbox Manager Fabric View Files Setting SANbox Manager Preferences Preferences Dialog SANbox Manager Using Online Help Viewing Software Version and Copyright Information Topology Display SANbox Manager User InterfaceFaceplate Display Switch Menu Bar Menu Shortcut Keys Most menu selections have shortcut keys as shown in TableShortcut Selection Tool Bar Buttons Tool BarTool Bar Button Description Fabric Tree Fabric Tree Graphic Window Working Status IndicatorData Window and Tabs Using the Topology Display Switch and Link Status Selecting Switches and Links Working with Switches and LinksArranging Switches in the Display Opening the Faceplate Display and Topology Popup Menus Topology Data Windows Using the Faceplate Display Port Views and Status Selecting Ports Working with PortsOpening the Faceplate Popup Menu Faceplate Data Windows User Authentication Security Inter-Switch Link Security Inband Management Adding a Fabric Managing the Fabric DatabaseChoose the Add Fabric button Opening a Fabric View File Removing a FabricSaving a Fabric View File Adding a New Switch to a Fabric Rediscovering a Fabric Replacing a Failed Switch Displaying Fabric Information Deleting Switches and LinksFabric Status Topology Display Switch and Status Icons Switch Icon Description Displaying the Event Browser Events Browser Severity Levels Severity Description Icon Filtering the Event Browser Filter Events Dialog Sorting the Event Browser Save the Event Browser to a File Active Zone Set Data Window Active Zone Set Data Window Zoning Concepts Zoning a FabricZones Soft Zones Access Control List Hard ZonesVirtual Private Fabric Hard Zones Aliases Zone Sets Zoning Configuration Zoning Database Default Visibility Using the Zoning Config DialogFC-SW-2 Auto Save Merging Fabrics and Zoning Restoring Default ZoningZone Merge Failure Zone Merge Failure Recovery Using the Edit Zoning Window Edit Zoning Window Edit Zoning Window Tool Bar Buttons Managing Zone Sets Creating a Zone Set Copying a Zone to a Zone Set Activating and Deactivating a Zone SetRemoving a Zone from a Zone Set or from All Zone Sets Removing a Zone Set Removing All Zoning Definitions Managing 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 Managing Aliases Changing Zone TypesCreating an Alias Adding a Member to an Alias Removing an Alias from All Zones Managing User Accounts Account Name Password Admin Authority ExpirationFactory User Accounts Account Administration Add Creating User Accounts Account Administration Remove Removing a User Account Changing a User Account Password Account Administration Change Password Displaying Switch Information Faceplate Display Displaying Hardware Status Faceplate Display Chassis LED Cluster Switch Data Window Name Server Data WindowName Server Data Window Entries Entry Description Switch Data Window Entries Switch Data Window Entries Port Statistics Data Window Link Data WindowPort Information Data Window Configured Zonesets Data Window Configured Zonesets Data Window Configuring Alarms Alarm Threshold Configuration Dialog Count EventSample Interval Paging a Switch Setting the Date and TimeSetting Temperature Thresholds Exporting Name Server Information to a File Switch Resets Resetting a SwitchType Description Configuring a Switch Switch Properties Symbolic Name Switch Administrative States 5describes the administrative state values Switch Administrative StatesDomain ID and Domain ID Lock Parameter Description Broadcast Support FC-SW-2 Compliance for Zoning Timeout Values Timeout ValuesLegacy Port Address Format Network Properties 11. Network Properties Dialog IP Configuration IP Configuration Parameters Snmp Configuration Snmp Configuration Parameters Snmp Trap Configuration Parameters Snmp Trap ConfigurationRemote Logging Archiving a Switch Restoring a Switch 12. Restore Dialogs Full and Selective Managing Switches Restoring a Switch Installing Firmware Managing Firmware Activating the Pending Firmware Changing the Pending Firmware 10. Factory Default Configuration Settings Restoring the Factory Default ConfigurationSetting Value 10. Factory Default Configuration Settings Page Managing Ports Displaying Port Information Mode Description Monitoring Port StatusDisplaying Port Modes Port Modes Displaying Port Operational States Displaying Port SpeedsPort Operational States Port Speeds Displaying Transceiver Media Status Transceiver Media ViewPort Statistics Data Window Entries Media Icon Description LIP ALPD,ALPS Port Statistics Data Window Entries Port Information Data Window Entries Name Server Data Window Configuring Ports Port Properties Dialog Changing Port Administrative States Port Administrative States Changing Port Speeds Changing Port Modes Changing Buffer-to-Buffer Credits Scan Device Stream GuardExtending Port Credits Resetting a Port Designate Donor Ports Testing Ports Port Loopback Test Dialog Managing Ports Testing Ports Command Line Interface Logging On to a Switch Table A-1. Command-Line Completion Command SyntaxKeystroke Effect Commands Table A-2. Commands Listed by Authority LevelUser Authority Commands Admin Authority Command Admin Session Commands Admin Command Syntax adminKeywords Examples Alias Command Syntax alias Remove alias members Members aliasRename aliasold aliasnew Config Command Syntax configKeywords activate config Edit config Restore Archive function are not compatible with the Config RestoreCommand Save config # ftp symbolicname or ipaddress Syntax date Date CommandKeywords MMDDhhmmCCYY Fallback Command SyntaxAuthority Fallback Hardreset Command Syntax Help Command Keywords commandSyntax help command keyword Keyword History Command Syntax history Hotreset Command HotresetFabric is in the diagnostic operational state This command clears the event log and all counters Image Command Syntax image cleanupKeywords cleanup Unpack file Authority Admin Syntax lip portnumber Keywords portnumber Lip CommandReinitializes the specified loop port Passwd Command Syntax passwd accountname Keywords accountname Ping Command Syntax PingIpaddress Keywords ipaddress Ps Command Following is an example of the Ps commandSyntax Examples Displays current system process information Closes the Telnet session Quit CommandAuthority User Syntax quit, exit, or logout Syntax reset Reset CommandKeywords config configname Table A-4. Port Configuration Defaults Table A-3. Switch Configuration DefaultsParameter Default Table A-5. Alarm Threshold Configuration Defaults Table A-6. Zoning Configuration Defaults Table A-7. Snmp Configuration Defaults Table A-8. System Configuration Defaults Set Command Syntax set Switch state Setup optionPort option Set Config Command Set configTable A-9. Set Config Port Parameters Port portnumber Send Arbff True instead of IDLEs Table A-10. Set Config Switch Parameters Compliant on page A-32. The default is Table A-11. Set Config Threshold Parameters Threshold Table A-12. Set Config Zoning Parameters Memory. Refer to FC-SW-2 Compliant on Arbff Following is an example of the Set Config Switch command Following is an example of the Set Config Threshold command Following is an example of the Set Config Zoning command Set Log Command Keywords archiveSet log Clear Port portlist Level levelSave Start StopStops logging of events Level keyword to Info at the same time Set Port Command EnableBypass alpa Speed transmissionspeed Set Setup Command Set setupTable A-13. Snmp Configuration Settings Snmp System Table A-14. System Configuration Settings Press Location Following is an example of the Set Setup System command SANbox2 admin # set setup system Show Command AlarmKeywords about Broadcast Log option Ns option Perf option Table A-15. Show Port Parameters LIPF8ALPS Steering domainid Post logSupport Users TopologyVersion Following is an example of the Show Fabric command Following is an example of the Show NS local domain commandFollowing is an example of the Show NS domainID command Following is an example of the Show NS portID command Following is an example of the Show Interface command Collisions0 txqueuelen100 Following is an example of the Show Port command LIPF8F7 Following is an example of the Show Switch command Following is an example of the Show Topology command Command Line Interface Show Command 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 Following is an example of the Show Log Options command Following is an example of the Show Log command Show Perf Command Errors portnumberFrame portnumber Inframe portnumber Following is an example of the Show Perf Byte command Show setup Show Setup CommandKeywords mfg Following is an example of the Show Setup Snmp command Following is an example of the Show Setup System command Shutdown Command Authority Admin Syntax shutdown Test Command Syntax testKeywords port portnumber testtype Status Test port x internal Command Line Interface Test Command Examples The following is an example of the Uptime command Uptime CommandSyntax uptime User Command Displays all user accounts that exist on the switchKeywords accounts Add Following is an example of the User Delete command Following is an example of the User Add commandFollowing is an example of the User List command Following is an example of the Whoami command Whoami CommandWhoami Zone Command Syntax zone Members zone Remove zone membersRename zoneold zonenew Type zone zonetype Following is an example of the Zone Members command Following is an example of the Zone Zonesets command Zoneset Command Syntax zoneset Following is an example of the Zoneset List command Delete zonesetRemove zoneset zonelist Rename zonesetold zonesetnew Following is an example of the Zoneset Zones command Zoning Command Keywords activeEdit Opens a Zoning Edit session Following is an example of the Zoning Limits command Limits Following is an example of the Zoning List command E2JBOD2 Command Line Interface Zoning Command Command Line Interface Zoning Command 59022-06 a Graphing Port Performance Starting SANsurfer Fabric View Exiting SANsurfer Fabric View Figure B-3. Load Default Fabric File SANsurfer Fabric View Saving and Opening SANsurfer Fabric View Fabric View Files Setting SANsurfer Fabric View Preferences Figure B-5. Preferences SANsurfer Fabric View Setting the Polling Frequency Displaying Graphs Arranging Graphs in the Display Customizing Graphs Printing Graphs Saving Graph Statistics to a File Access Control List Zone Administrative StateBootP Class 2 Service Class 3 Service Configured Zone SetsDefault Visibility Fabric Management Switch Input Power LED Inter-Switch LinkMaintenance Mode Output Power LED Power On Self Test Post Principal SwitchPrivate Device Private Loop Index Index-2 59022-06 a 59022-06 a Index-3 Index-4 59022-06 a 59022-06 a Index-5 Index-6 59022-06 a 59022-06 a Index-7