Q-Logic 59022-11 A 4-13, SANBOX2-16

A – Command Line Interface

Set Port Command

A-76 59022-11 A

state [state]

Specifies one of the following administrative states for the specified port:

Online

Places the port online. This activates and prepares the port to send data.

Offline

Places the port offline. This prevents the port from receiving signal and

accepting a device login.

Diagnostics

Prepares the port for testing. This prepares the port for testing and prevents

the port from accepting a device login.

Down

Disables the port by removing power from the port lasers.

Contents

Main Page ii 59022-11 A SANbox2-8c/16 Switch Management Users Guide Release, Revision A, February 2005 Document Revision History Table of Contents Section 1 Introduction Section 2 Using SANsurfer Switch Manager Section 3 Managing Fabrics Page Page Page Section 4 Managing Switches Section 5 Managing Ports Appendix A Command Line Interface Glossary Index Figures Tabl es Page Section 1 Introduction Intended Audience Related Materials JDOM License Technical Support Availability Train ing Contact Information Page Section 2 Using SANsurfer Switch Manager Workstation Requirements Installing the Management Application SANsurfer Switch Manager SANsurfer Management Suite SMS Installation for Windows Page SMS Installation for Linux SMS Installation for Solaris Page Starting SANsurfer Switch Manager Figure 2-1. Initial Startup Dialog Figure 2-2. SANsurfer Switch Manager Window Exiting SANsurfer Management Suite Figure 2-3. Save Default Fabric View File Dialog Figure 2-4. Load Default Fabric File Dialog Uninstalling SANsurfer Switch Manager 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 Figure 2-5. Preferences Dialog SANsurfer Switch Manager Using Online Help Viewing Software Version and Copyright Information SANsurfer Switch Manager User Interface Figure 2-6. SANsurfer Switch Manager Display Elements Faceplate Display Topology Display Page Faceplate Display Menu Figure 2-8. Faceplate Display Menu Shortcut Keys Tool Bar Fabric Tree Figure 2-9. Fabric Tree Graphic Window Data Window and Tabs Working Status Indicator Using the Topology Display Figure 2-10. Topology Display Switch and Link Status Working with Switches and Links Selecting Switches and Links Arranging Switches in the Display Opening the Faceplate Display and Topology Popup Menus Topology Data Windows Using the Faceplate Display Figure 2-11. Faceplate Display Port Views and Status Working with P orts Selecting Ports Opening the Faceplate Popup Menu Faceplate Data Windows Page Section 3 Managing Fabrics RADIUS Servers Adding a RADIUS Server Figure 3-1. Add Server Page Removing a RADIUS Server Figure 3-2. Remove Server Editing RADIUS Server Information Figure 3-3. Edit Radius Server Information Modifying Authentication Order RADIUS Server Information Figure 3-4. Modify Authentication Order - Radius Server Information Securing a Fabric Connection Security User Account Security Security Consistency Checklist Device Security Edit Security Dialog Figure 3-5. Edit Security Dialog Creating a Security Set Create Security Group Dialog Figure 3-6. Create Security Group Dialog Creating a Security Group Create Security Group Member Dialog Figure 3-7. Create a Security Group Member Dialog Creating a Security Group Member Editing the Security Configuration on a Switch Viewing Properties of a Security Set, Group, or Member Using the Security Config Dialog Figure 3-8. Security Config Dialog Archiving a Security Configuration to a File Activating a Security Set Deactivating a Security Set Configured Security Data Window Active Security Data Window Fabric Services Enabling SNMP Configuration Enabling In-band Management Tracking Fabric Firmware and Software Versions Saving a Version Snapshot Viewing and Comparing Version Snapshots Exporting Version Snapshots to a File Figure 3-9. Fabric Version Snapshot Analysis Dialog Managing the Fabric Database Adding a Fabric Figure 3-10. Add a New Fabric Dialog Removing a Fabric Opening a Fabric View File Saving a Fabric View File Rediscovering a Fabric Adding a New Switch to a Fabric Replacing a Failed Switch Deleting Switches and Links Displaying Fabric Information Fabric Status Displaying the Event Browser Figure 3-11. Events Browser Page Filtering the Event Browser Figure 3-12. Filter Events Dialog Sorting the Event Browser Saving the Event Browser to a File Devices Data Window Active Zone Set Data Window Figure 3-13. Active Zone Set Data Window Link Data Window Working with Device Information and Nicknames Figure 3-14. Detailed Devices Display Dialog Displaying Detailed Device Information Exporting Device Information to a File Managing Device Port Nicknames Creating a Nickname Editing a Nickname Deleting a Nickname Exporting Nicknames to a File Importing a Nicknames File Zoning a Fabric Zoning Concepts Zones Soft Zones Access Control List Hard Zones Aliases Zone Sets Zoning Database Using the Zoning Wizard Managing the Zoning Database Editing the Zoning Database Figure 3-15. Edit Zoning Dialog Page Configuring the Zoning Database Figure 3-16. Zoning Config Dialog Interop Auto Save Default Visibility Discard Inactive Saving 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 Activating and Deactivating a Zone Set Copying a Zone to a Zone Set Removing a Zone from a Zone Set or from All Zone Sets Removing a Zone Set Managing Zones Creating a Zone in a Zone Set Adding Zone Members Renaming a Zone or a Zone Set Removing a Zone Member Removing a Zone from a Zone Set Removing a Zone from All Zone Sets Changing Zone Types Managing Aliases Creating an Alias Adding a Member to an Alias Removing an Alias from All Zones Merging Fabrics and Zoning Zone Merge Failure Zone Merge Failure Recovery Section 4 Managing Switches Managing User Accounts Creating User Accounts Figure 4-1. User Account Administration Dialog Add Account Removing a User Account Figure 4-2. User Account Administration Dialog Remove Account Changing a User Account Password Figure 4-3. User Account Administration Dialog Change Password Modifying a User Account Figure 4-4. User Account Administration Dialog Modify Account Displaying Switch Information Figure 4-5. Faceplate Display Devices Data Window Switch Data Window Page Page Page Port Statistics Data Window Port Information Data Window Figure 4-6. Faceplate Display - Port Information Configured and Active Zonesets Data Window Figure 4-7. Configured Zonesets Data Window Configuring Port Threshold Alarms Figure 4-8. Port Threshold Alarm Configuration Dialog Figure 4-9. Port Threshold Alarm Example Paging a Switch Event Count Sample Window Setting the Date/Time and Enabling NTP Client Resetting a Switch Page Configuring a Switch Using the Configuration Wizard Switch Properties Figure 4-10. Switch Properties Dialog Symbolic Name Switch Administrative States Domain ID and Domain ID Lock Fabric Device Management Interface Broadcast Support In-band Management Advanced Switch Properties Figure 4-11. Advanced Switch Properties Dialog Interop Mode for Zoning Legacy Port Address Format Timeout Values System Services Dialog Figure 4-12. System Services Dialog Security Consistency Checklist Dialog Network Properties Figure 4-13. Network Properties Dialog IP Configuration Remote Logging NTP Client SNMP Properties Figure 4-14. SNMP Properties Dialog SNMP Configuration SNMP Trap Configuration Archiving a Switch Restoring a Switch Figure 4-15. Restore Dialogs Full and Selective Page Restoring the Factory Default Configuration Downloading a Support File Installing Firmware Displaying Hardware Status Figure 4-16. Hardware Status LEDs Page Section 5 Managing Ports Figure 5-1. Faceplate Display - Port Information Displaying Port Information Monitoring Port Status Displaying Port Types Displaying Port Operational States Displaying Port Speeds Displaying Transceiver Media Status Port Statistics Data Window Table 5-5. Port Statistics Data Window Entries Table 5-5. Port Statistics Data Window Entries (Continued) Port Information Data Window Table 5-6. Port Information Data Window Entries Table 5-5. Port Statistics Data Window Entries (Continued) Page Table 5-6. Port Information Data Window Entries (Continued) Configuring Ports Figure 5-2. Port Properties Dialog Changing Port Administrative States Changing Port Speeds Changing Port Types I/O Stream Guard Device Scan Changing Port Symbolic Name Using the Extended Credits Wizard Figure 5-3. Designate Donor Ports Resetting a Port Test ing P orts Figure 5-4. Port Loopback Test Dialog Page Graphing Port Performance Figure 5-5. Fabric View Graphs Starting SANsurfer Performance Viewer Exiting SANsurfer Performance Viewer Figure 5-6. Save Default Performance View File Dialog Figure 5-7. Load Default Performance File Dialog Saving and Opening Performance View Files Changing the Default Performance View File Encryption Key Setting SANsurfer Performance Viewer Preferences Figure 5-8. Preferences SANsurfer Performance Viewer Setting the Polling Frequency Displaying Graphs Arranging Graphs in the Display Customizing Graphs Figure 5-9. Default Graph Options Dialog Page Setting Global Graph Type Rescaling a Selected Graph Printing Graphs Saving Graph Statistics to a File Appendix A Command Line Interface Logging On to a Switch User Accounts Working with Switch Configurations Modifying a Configuration Backing up and Restoring Switch Configurations Page Commands Page Admin Command Authority Syntax Keywords Notes Examples Alias Command Authority Syntax Keywords Page CIM Command Syntax Keywords Examples CIMListener Command Authority Syntax Keywords Examples CIMSubscription Command Authority Syntax Keywords CIMSubscription Command Examples Config Command Authority Syntax Keywords Notes Examples Config Command A-18 59022-11 A Create Command Syntax Keywords Examples Create Command A-20 59022-11 A The following is an example of the Create Certificate command: Date Command Firmware Install Command Authority Syntax Examples Group Command Authority Syntax Keywords Table A-6. Port Group Member Attributes Page Page Notes Group Command A-30 59022-11 A Examples The following is an example of the Group Edit command: Group Command 59022-11 A A-31 The following is an example of the Group List command: The following is an example of the Group Members command: Hardreset Command Help Command Syntax Keywords Examples History Command Syntax Notes Examples Hotreset Command Syntax Notes Image Command Syntax Keywords Notes Examples Lip Command Passwd Command Authority Syntax Keywords Examples Ping Command Syntax Keywords Examples Ps Command A-42 59022-11 A Ps Command Displays current system process information. Syntax Examples Quit Command Reset Command Syntax Keywords Page Notes Enter the Show Config Switch command to display switch configuration Table A-9. Switch Configuration Defaults Enter the Show Config Port command to display port configuration values. Table A-10. Port Configuration Defaults Enter Show Config Threshold command to display threshold alarm configuration values. Enter the Show Config Zoning command to display zoning configuration Table A-11. Port Threshold Alarm Configuration Defaults Table A-12. Zoning Configuration Defaults Enter the Show Setup SNMP command to display SNMP configuration Table A-13. SNMP Configuration Defaults Page Page Security Command Authority Syntax Keywords Examples Security Command A-54 59022-11 A The following is an example of the Security History command: The following is an example of the Security Limits command: Security Command 59022-11 A A-55 The following is an example of the Security List command: Securityset Command Authority Syntax Keywords Notes Examples Set Command Authority Syntax Keywords Examples Set Config Command Authority Syntax Keywords Table A-18. Set Config Port Parameters Table A-18. Set Config Port Parameters Page Table A-20. Set Config Switch Parameters Page Examples Table A-22. Set Config Zoning Parameters 59022-11 A A-67 A-68 59022-11 A The following is an example of the Set Config Security command: The following is an example of the Set Config Switch command: 59022-11 A A-69 The following is an example of the Set Config Threshold command: The following is an example of the Set Config Zoning command. Set Log Command Syntax Keywords Page Page Page Set Port Command Authority Syntax Keywords Page Set Setup Command Syntax Keywords Table A-23. RADIUS Service Settings Page Table A-24. Switch Services Settings Page Page Table A-26. System Configuration Settings A-84 59022-11 A Examples The following is an example of the Set Setup Services command: 59022-11 A A-85 The following is an example of the Set Setup SNMP command: A-86 59022-11 A The following is an example of the Set Setup System command: Show Command Syntax Keywords Page Page Page Table A-27. Show Port Parameters Page Page Page 59022-11 A A-95 Examples The following is an example of the Show Domains command: The following is an example of the Show Fabric command: A-96 59022-11 A The following is an example of the Show FDMI command: The following is an example of the Show FDMI WWN command: 59022-11 A A-97 The following is an example of the Show NS (local domain) command: The following is an example of the Show NS [domain_ID] command: The following is an example of the Show NS [port_ID] command: A-98 59022-11 A The following is an example of the Show Interface command: 59022-11 A A-99 The following is an example of the Show Port command: A-100 59022-11 A The following is an example of the Show Switch command: The following is an example of the Show Topology command: 59022-11 A A-101 The following is an example of the Show Topology command for port 1: A-102 59022-11 A The following is an example of the Show Version command: Show Config Command Syntax Keywords Examples Show Config Command The following is an example of the Show Config Switch command: Show Config Command 59022-11 A A-105 The following is an example of the Show Config Threshold command: The following is an example of the Show Config Zoning command: Show Log Command Syntax Keywords Page Show Log Command A-108 59022-11 A Examples The following is an example of the Show Log Level command: The following is an example of the Show Log Options command: The following is an example of the Show Log command: Show Perf Command Syntax Keywords Show Perf Command A-110 59022-11 A Examples The following is an example of the Show Perf Byte command: Show Setup Command Syntax Keywords Examples A-112 59022-11 A The following is an example of the Show Setup Services command: The following is an example of the Show Setup RADIUS command: 59022-11 A A-113 The following is an example of the Show Setup Snmp command: A-114 59022-11 A The following is an example of the Show Setup System command: Shutdown Command Test Command Syntax Keywords Examples Page Uptime Command User Command Authority Syntax Keywords Notes Examples The following is an example of the User Add command: The following is an example of the User Edit command: The following is an example of the User Delete command: The following is an example of the User List command: Whoami Command Zone Command Authority Syntax Keywords Page Zone Command A-126 59022-11 A Examples The following is an example of the Zone Members command: Page Zoneset Command Authority Syntax Keywords Notes Examples Zoning Command Authority Syntax Keywords Page Zoning Command A-132 59022-11 A Examples The following is an example of the Zoning Limits command: Zoning Command 59022-11 A A-133 The following is an example of the Zoning List command: Page Glossary Page Page Page Index A B C D E F G H I L M N O P Q R S Page T U V W Z