Image Command, Syntax image, Keywords cleanup | Q-Logic 5600

A – Command Line Interface Image Command

S

Image Command

Manages and installs switch firmware.

Authority

Admin session

Syntax image

cleanup

fetch [account_name] [ip_address] [file_source] [file_destination] install

list

unpack [file]

Keywords cleanup

Removes all firmware image files from the switch. All firmware image files are removed automatically each time the switch is reset.

fetch [account_name] [ip_address] [file_source] [file_destination]

Retrieves image file given by [file_source] and stores it on the switch with the file name given by [file_destination]. The image file is retrieved from the FTP server with the IP address given by [ip_address] and an account name given by [account_name]. If an account name needs a password to access the FTP server, the system will prompt you for it.

install

Downloads firmware from a remote host to the switch, installs the firmware, then resets the switch (without a power-on self test) to activate the firmware. This reset is disruptive. The command prompts you for the following:

IP address of the remote host

An account name and password on the remote host

Pathname for the firmware image file

list

Displays the list of image files that reside on the switch.

unpack [file]

Installs the firmware file given by [file]. After unpacking the file, a message appears confirming successful unpacking. The switch must be reset for the new firmware to take effect. Enter the Hotreset command to attempt a non-disruptive activation.

A-38	59097-02 B

Image 218

Q-Logic 5600 manual Image Command, Syntax image, Keywords cleanup

Contents

SANbox 5600 Series Switch Managment User’s Guide SANbox 5600 Series Switch Management User’s Guide Document Revision History Table of Contents Section Managing Fabrics SANbox 5600 Series Switch Management User’s Guide Managing Switches Section SANbox 5600 Series Switch Management User’s Guide Section Managing Ports Appendix a Command Line Interface Glossary Index List of Figures List of Tables SANbox 5600 Series Switch Management User’s Guide Jdom License Intended AudienceRelated Materials Introduction Jdom License Training Technical SupportAvailability Contact Information Support Headquarters Using SANsurfer Switch Manager Workstation Requirements Installing the Management ApplicationWorkstation Requirements SANsurfer Switch Manager SMS Installation for Windows SANsurfer Management Suite Chglax.bat SMS Installation for Linux 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 Uninstalling SANsurfer Switch Manager Load Default Fabric File Dialog SMS Uninstall Standalone Uninstall 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 SANsurfer Switch Manager User Interface Faceplate Display Menu Bars Topology Display Menu Faceplate Display Menu Shortcut Keys Tool Bar Tool Bar Buttons Fabric Tree Fabric Tree Data Window and Tabs Working Status IndicatorGraphic Window Using the Topology Display Switch and Link Status Arranging Switches in the Display Working with Switches and LinksSelecting Switches and Links Opening the Faceplate and Topology Display Popup Menus Topology Data Windows Using the Faceplate Display 11. Faceplate Display Selecting Ports Port Views and StatusWorking with Ports Opening the Faceplate Popup Menu Faceplate Data WindowsPage Managing Fabrics Radius Servers Adding a Radius Server Add Server Managing Fabrics Radius Servers Removing a Radius Server Remove Server Editing Radius Server Information Edit Server Information Modifying Authentication Order Radius Server Information Modify Authentication Order Radius Server Information Fabric security consists of the following Securing a FabricConnection Security Security Consistency Checklist User Account Security Device Security Edit Security Dialog Edit Security Dialog Creating a Security Set Create Security Group Dialog Creating a Security Group Create Security Group Member Dialog Create a Security Group Member Dialog Managing Fabrics Securing a Fabric Creating a Security Group Member Editing the Security Configuration on a Switch Using the Security Config Dialog Viewing Properties of a Security Set, Group, or Member Deactivating a Security Set Archiving a Security Configuration to a FileActivating a Security Set Active Security Data Window Configured Security Data WindowFabric Services Enabling In-band Management Enabling Snmp ConfigurationClick the In-band Management Enable button Tracking Fabric Firmware and Software Versions Saving a Version Snapshot Viewing and Comparing Version Snapshots Exporting Version Snapshots to a File Fabric Version Snapshot Analysis Dialog Managing the Fabric Database Adding a Fabric Removing a Fabric Opening a Fabric View File Rediscovering a Fabric Deleting Switches and LinksSaving a Fabric View File Adding a New Switch to a Fabric Replacing a Failed Switch Displaying Fabric Information Topology Display Switch and Status Icons Fabric Status Displaying the Event Browser 11. Events Browser Editor or browser Discarded when you close a SANsurfer Switch Manager sessionSeverity Levels Filtering the Event Browser 12. Filter Events Dialog Sorting the Event Browser Saving the Event Browser to a File Devices Data Window Devices Data Window Entries Active Zone Set Data Window 13. Active Zone Set Data Window Displaying Detailed Device Information Link Data WindowWorking with Device Information and Nicknames 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 Viewing Zoning Limits and Properties Using the Zoning Wizard Managing the zoning database consists of the following Managing the Zoning DatabaseEditing the Zoning Database Edit Zoning Dialog Tool Bar Buttons and Icons Edit Zoning Dialog Tool Bar Buttons and Icons Configuring the Zoning Database Interop Auto Save Saving the Zoning Database to a File Default VisibilityDiscard Inactive 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 Removing a Zone from a Zone Set Renaming a Zone or a Zone SetRemoving a Zone Member 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 Fabrics Zoning a Fabric 59097-02 B Managing Switches Managing User Accounts Factory 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 Ing Detailed Device Information on page 3-36for infor Port Statistics Data Window Port Information Data Window Configured Zonesets Data Windows 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 Switch Administrative States Switch 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 Interop Mode for Zoning Legacy Port Address Format Timeout Values Timeout Values System Services Dialog 11. System Services Dialog Security Consistency Checklist Dialog Network Properties 12. Network Properties Dialog IP Configuration IP Configuration Parameters Remote Logging NTP Client Snmp Properties 13. Snmp Properties Dialog Snmp Configuration Snmp Configuration Parameters Snmp Trap Configuration Snmp Trap Configuration Parameters Managing Switch Stacks 14. Switch Stacks Syslog 15. Syslog Dialog Archiving a Switch Select Source Dialog Restoring a Switch 16. Restore Dialogs Full and Selective Managing Switches Restoring a Switch Restoring the Factory Default Configuration Factory Default Configuration Settings Factory Default Configuration Settings Upgrading the Switch Using License Keys Downloading a Support File 17. Features License Key Dialog Installing Firmware Displaying Hardware Status 19. Hardware Status LEDs Managing Switches Displaying Hardware Status 59097-02 B Managing Ports Displaying Port Information Port Types Monitoring Port StatusDisplaying Port Types Port Operational States Displaying Port Operational StatesDisplaying Port Speeds Port Speeds Displaying Transceiver Media Status Port Transceiver Media View Port Statistics Data Window Entries LIP ALPD,ALPS Port Statistics Data Window Entries 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 Resetting a Port Designate Donor Ports Testing Ports Port Loopback Test Dialog Managing Ports Testing Ports Graphing Port Performance Fabric View Graphs This section describes how to do the following Starting SANsurfer Performance Viewer Save Default Performance View File Dialog Exiting SANsurfer Performance Viewer Load Default View File Dialog Saving and Opening Performance View Files Changing the Default Performance View File Encryption Key Setting SANsurfer Performance Viewer Preferences Setting the Polling Frequency Displaying Graphs for a Switch Displaying Graphs for a Stack Arranging Graphs in the Display Default Graph Options Dialog Customizing Graphs Managing Ports Graphing Port Performance Printing Graphs Setting Global Graph TypeRescaling a Selected Graph Saving Graph Statistics to a File 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 userimages password images ftp bin Commands Table A-1. Command-Line Completion Table A-2. Commands Listed by Authority Level Admin Session Commands Syntax Admin CommandAuthority Keywords Keywords add alias memberlist Alias CommandSyntax alias Copy aliassource aliasdestination Members alias Delete aliasList Remove alias memberlist CIM Command Following is an example of the CIM Limits command CIMListener Command Table A-3. CIM Listener Configuration Parameters Edit listenername URL Syntax cimsubscription CIMSubscription CommandTable A-4. CIM Subscription Configuration Parameters Keywords create subscriptionname Edit subscriptionname Keywords activate configname Config CommandSyntax config Save configname Edit confignameRestore #ftp symbolicname or ipaddress user images Keywords certificate Create CommandSyntax create certificate support Support Local directory now /itasca/conf/images bin Following is an example of the Create Certificate command SANbox xxxx admin # create support Keywords MMDDhhmmCCYY Date CommandSyntax date Keywords add licensekey Feature CommandSyntax feature Log Syntax firmware install Firmware Install CommandAuthority Admin Group Command Syntax group Keywords add group Table A-5. ISL Group Member Attributes Table A-6. Port Group Member Attributes Copy groupsource groupdestination Configures security for attachments to other switchesTable A-7. MS Group Member Attributes Create group type Edit group member Table A-8. Group Member Attributes Rename groupold groupnew Members groupRemove group memberlist Securitysets group Following is an example of the Group Edit command ISL Following is an example of the Group List command Following is an example of the Group Members command Hardreset Command Syntax Command Help CommandHelp command keyword Keyword History History CommandFollowing is an example of the History command Hotreset Command Hotreset Syntax image Image CommandKeywords cleanup Ftp Ftp switchname Wait for the unpack to complete Following is an example of the Lip command Lip CommandAdmin session Lip portnumber Passwd Command Syntax passwd accountname Keywords accountname Ping ipaddress Ping CommandFollowing is an example of a successful Ping command Ipaddress Authority None Syntax ps Ps CommandExamples The following is an example of the Ps command Displays current system process information Closes the Telnet session Quit CommandAuthority None Syntax quit, exit, or logout Keywords config configname Reset CommandSyntax reset Factory Radius ServicesSwitch Security Table A-9. Switch Configuration Defaults Values Table A-10. Port Configuration Defaults Parameter 4-Gbps Port Defaults Table A-11. Port Threshold Alarm Configuration Defaults Table A-12. Zoning Configuration Defaults Table A-13. Snmp Configuration Defaults Table A-14. Radius Configuration Defaults Table A-15. Services Configuration Defaults Table A-16. System Configuration Defaults Table A-17. Security Configuration Defaults Security Command Keywords active Edit Following is an example of the Security History command MD5 Following is an example of the Security Limits command Following is an example of the Security List command Securityset Command Delete securityset Create securitysetDeactivate Groups securityset Following is an example of the Securityset Groups command Following is an example of the Securityset List command Config option Set CommandKeywords alarm option Syntax set Log option Setup optionSwitch state Pagebreak state Timezone Table A-18. Set Config Port Parameters Set Config CommandSet config Port portnumber Send Arbff True instead of IDLEs False on the loop Table A-18. Set Config Port Parameters Table A-19. Security Configuration Parameters Table A-20. Set Config Switch Parameters Resource Allocation Timeout Value. The number Table A-21. Set Config Threshold Parameters Threshold Table A-22. Set Config Zoning Parameters Following is an example of the Set Config Port command Arbff Enter key to do so Configuring Port Number AdminState Following is an example of the Set Config Security command 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 Archive Set Log CommandSet log Component filterlist Display filter Level filter Port portlist Stop Alarms are always logged and always displayed on the screenStart Stops logging of events Set Port Command Disables the port by removing power from the port lasers State state Radius Services Snmp System Set Setup CommandSet setup Configuration fields Table A-23. Radius Service Settings Table A-24. Switch Services Settings Table A-24. Switch Services Settings Table A-25. Snmp Configuration Settings Table A-26. System Configuration Settings Table A-26. System Configuration Settings Following is an example of the Set Setup Services command Following is an example of the Set Setup Snmp command Following is an example of the Set Setup System command Show Command Keywords about Cimsubscription subscriptionname Alarm optionCimlistener listenername Log option Fdmi portwwnInterface Lsdb Table A-27. Show Port Parameters PagebreakPerf option Lipalpdalps Post log Steering domainid Table A-28. Switch Operational Parameters Displays all connected devices Displays the current time zone settingTopology Users Following is an example of the Show Fdmi command Following is an example of the Show Domains commandFollowing is an example of the Show Fabric command 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 59097-02 B 105 Following is an example of the Show Version command Show Config Command Show config Following is an example of the Show Config Port command 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 Show Log CommandNone Keywords numberofevents Displays all critical events Snmp eventsDisplays all informative events Displays all warning events Displays all events related to EPorts Options SettingsLevel Port Following is an example of the Show Log command Show Perf Command Errors portnumber Outframe portnumber Following is an example of the Show Perf Byte command Mfg Show Setup CommandShow setup Following is an example of the Show Setup Services command Following is an example of the Show Setup Radius command Following is an example of the Show Setup Snmp command Following is an example of the Show Setup System command Shutdown Command Syntax shutdown Syntax test Test CommandPort portnumber testtype cancel Status Keywords port portnumber testtype Cancels the online test in progress Status Test port x online Authority None Syntax uptime Uptime CommandExamples The following is an example of the Uptime command Keywords accounts User CommandSyntax user Add 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 Keywords add zone memberlist Zone CommandSyntax zone Copy zonesource zonedestination Remove zone memberlist Delete zoneMembers zone 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 Rename zonesetold zonesetnew Delete zonesetRemove zoneset zonelist Zones zoneset Following is an example of the Zoneset Zones command Zoning Command Opens a Zoning Edit session Table A-29. Zoning Database Limits Limit Description Following is an example of the Zoning Limits command E2JBOD2 Following is an example of the Zoning List command Command Line Interface Zoning Command 142 59097-02 B Alarm Access Control List ZoneAdministrative State BootP Default Visibility Class 3 ServiceConfigured Zone Sets Fabric Management Switch Maintenance Button Input Power LEDInter-Switch Link Maintenance Mode Target Small Form-Factor Pluggable Zoning DatabaseSoft Zone User Account Index Index-2 59097-02 B 59097-02 B Index-3 Index-4 59097-02 B 59097-02 B Index-5 Index-6 59097-02 B 59097-02 B Index-7 Index-8 59097-02 B 59097-02 B Index-9 Index-10 59097-02 B