Q-Logic 59048-02 A manual

Simplify D 59048-02 A Page i SANbox2-64 Switch Management User ’ s Guide[...]

Page ii 59048-02 A Q SANbox2-64 Switch Management User’s Guide © 2000–2003 QLogic Corporation First Printed: Novemver 2002 All Rights Reserved Worldwide. Printed in U. S.A. QLogic Corporation, 6321 Bury Drive, Eden Prairie, MN 55346 (800) 342-7379 or (952) 932-4000 Information fu rnished in this manual is believed to be accurate and reliab le.[...]

59048-02 A Page iii T able of Content s Section 1 Introduction 1.1 Intended Audience .................................................... ......................................... 1-1 1.2 Related Materials ........................................................................... .................... 1-1 1.3 T echnical Support ....................[...]

Page iv 59048-02 A SANbox2-64 Switch Management User’s Guide Q 2.1 1.2.3 Opening the Faceplate Display and T opology Popup Menus ......... 2-21 2.12 T opology Data Windows ............................................ ....................................... 2-21 2.13 Using the Faceplate Display................................................. ....[...]

59048-02 A Page v SANbox2-64 Switch Manageme nt User’s Guide Q 3.4.2.2 Default V isibility .................................................. ............................ 3-18 3.4.3 Restoring Default Zoning ....................... .................................................. 3-18 3.4.4 Merging Fabrics and Zoning ............................[...]

Page vi 59048-02 A SANbox2-64 Switch Management User’s Guide Q 4.5 Paging a Switch......................................................... ....................................... 4-13 4.6 Setting the Date and T ime .............................. .................................................. 4-13 4.7 Resetting a Switch.......................[...]

59048-02 A Page vii SANbox2-64 Switch Manageme nt User’s Guide Q 6.1.2 Port S t atistics Data Window ............................................................. ......... 6-4 6.1.3 Port Information Da ta Window ............................................... .................... 6-7 6.1.4 Name Server Dat a Window ...............................[...]

Page viii 59048-02 A SANbox2-64 Switch Management User’s Guide Q Show Command .................................................................... .................. A-50 Show Config Command............................................... ............................ A-64 Show Log Command ...........................................................[...]

59048-02 A Page ix SANbox2-64 Switch Manageme nt User’s Guide Q 2-10 Topology Display.............................................. ............................................................ 2 -19 2-11 Faceplate Display.................................................................. ....................................... 2 -22 3-1 Add a New [...]

Page x 59048-02 A SANbox2-64 Switch Management User’s Guide Q 4-7 IP Configuration Parameters ................................................. ....................................... 4-22 4-8 SNMP Configuration Parameters .......................................... ....................................... 4-23 4-9 SNMP Trap Configuration Parameter[...]

59048-02 A 1-1 Section 1 Introduction This manual describes the sw itch manageme nt tools which include the SANbox® Manager application (version 2.0) and the Command Line Interface (CLI) for the SANbox2®-64 Fibre Channel switch (firmware versio n 2.0). The SANbox Manager switch management application is th e primary focus of this manual which is [...]

1 – Introduction Technical Support 1-2 59048-02 A Q 1.3 T ec hnical Support Customers should cont act their authorized maintenance provider for technical support of their QLogic switch product s. QLogic-direct customers may contact QLogic T echnical Support; others will be redire cted to their authorized maintenance provider . Visit the QLogic su[...]

59048-02 A 2-1 Section 2 Using SANbox Manager This section describes how to use t he SANbox Manager application and its menus. The following topics are covered:  Installing SANbox Manager  S ta rting SANbox Manager  Exiting SANbox Manager  Changing the p assword for the default fabric view file  Setting SANbox Manager user preference[...]

2 – Using SANbox Manager Installing SANbox Manager 2-2 59048-02 A Q Y our switch was shipped with either a SANsurfer Management Suite Disk or a SANbox2 Installation Disk. Refer to the fo llowing installation instructions that correspond to your sit uation:  SANsurfer Management Suite Disk - Windows Inst allation  SANsurfer Management Suite [...]

2 – Using SANbox Mana ger Installing SANbox Manager 59048-02 A 2-3 Q 2.1.2 SANsurfer Management Suit e Disk - Linux Inst allation T o install the SANbox Mana ger application on Linux from the SANsurfer Management Suite Disk, do the following: 1. Close all programs currently running, and insert the SANsurfer Management Suite Disk into the manageme[...]

2 – Using SANbox Manager Installing SANbox Manager 2-4 59048-02 A Q 2.1.3 SANsurfer Management Suite Disk - Solaris Inst allation T o install the SANbox Mana ger application on Solaris from the SANsurfer Management Suite CD-ROM, do the followin g: 1. Close all programs currently running, and insert the SANsurfer Management Suite Disk into the man[...]

2 – Using SANbox Mana ger Installing SANbox Manager 59048-02 A 2-5 Q 2.1.4 SANbox2 Inst allation Disk - Windows Inst allation T o install the SANbox Mana ger application on Windows from the SANbox2 Installation Disk, do the following: 1. Close all programs currently runni ng, and insert the SANbox2 Installation Disk into the management workst ati[...]

2 – Using SANbox Manager Starting SANbox Manager 2-6 59048-02 A Q 2.2 S tarti ng SANbox Manager T o start the SANbox Manag er application for the first time, choose one of the following methods:  For a Windows plat form, double-click the SANbox Manager shortcut, or select SANbox Manager from S tart menu, depending on how you inst alled the SAN[...]

2 – Using SANbox Mana ger Starting SANbox Manager 59048-02 A 2-7 Q  Choose Open Existing Fabric to open the Add a New Fabric d ialog, which prompts you fo r an fabric name, IP address, account name, and p assword. Refer to ”Adding a Fabric” on page 3-3 .  Choose Open Existing Fabric View File to open th e Open View dialog which prompts [...]

2 – Using SANbox Manager Exiting SANbox Manager 2-8 59048-02 A Q 2.3 Exiting SANbox Manager T o exit a SANbox Manager application session, open the File menu and select Exit . If you have made changes to th e view , the Save Default Fabric File dialog, shown in Figure 2-3 , prompt s you to save the view as the default f abric view file. Y ou may [...]

2 – Using SANbox Mana ger Uninstalling SANbox Manager 59048-02 A 2-9 Q 2.4 Uninst alling SANbox Manager A program to uninst all SANbox Manager was installed as p art of the SANbox Manager installation p rocess. The Uninstaller Dat a folder in the Install folder contains the uninst all program (Uninsta ll SANbox Manager). Also, a shortcut/link to [...]

2 – Using SANbox Manager Changing the SANbox Manager Default Fa bric File Password 2-10 59048-02 A Q 2.5 Changing the SANbox Manager Default Fabric File Password T o change the password for t he default fabric view file, do the following: 1. Open the File menu and select Change Def ault File Password to open the Set New Password dialog as shown i[...]

2 – Using SANbox Mana ger Setting SANbo x Manager Pr eferences 59048-02 A 2-1 1 Q 2.7 Setting SANbox Manager Preferences Using the preferences settings, you can:  Change the location of the wo rking directory in which to save files  Change the location of the browser used to view the online help.  Choose the fabric discovery interval. Th[...]

2 – Using SANbox Manager Using Online Help 2-12 59048-02 A Q T o set preferences for your SANbox Manager sessions, do the following: 1. Open the File menu, and select Preferences to open the Preferences dialog. 2. Enter or browse for paths to th e working directory and browser . 3. In the Application-wide Options area, ch oose the preferences you[...]

2 – Using SANbox Mana ger SANbox Mana ger User Inte rface 59048-02 A 2-13 Q Figure 2-7. SANbox Ma nager Display Elements 2.10.1 Menu Bar The Menu Bar present s the SANbox Manager menus as shown in Figu re 2-8 . The menus and the t asks offered in them va ry depending on the display . For example, the Port menu and many of the Switch menu selectio[...]

2 – Using SANbox Manager SANbox Manager User Interf ace 2-14 59048-02 A Q Figure 2-8. SANbox Ma nager Menu S tructure In addition to the menu bar , both the topology and faceplate displays have context sensitive menus that pop up when you click in the graphic window with the right mouse button. Refer to ”Opening the Faceplate Display and T o po[...]

2 – Using SANbox Mana ger SANbox Mana ger User Inte rface 59048-02 A 2-15 Q Most menu selections have shortcut keys as sho wn in T able 2-2 . T able 2-2. Menu Shortcut Keys Shortcut Selection Shortcut Selection Ctrl+O Alt+F+O File>Open View File Alt+S+ F Switch>Firmware Fallback Alt+F+A File>Save As Alt+ S+E Switch>Reset Switch Alt+F+[...]

2 – Using SANbox Manager SANbox Manager User Interf ace 2-16 59048-02 A Q 2.10.2 To o l B a r The tool bar consists o f a row of graphical buttons that you can use to access SANbox Manager functions a s shown in T able 2-3 . The tool ba r buttons are an alternative method to using the menu bar . The tool bar can be relocated in the display by cli[...]

2 – Using SANbox Mana ger SANbox Mana ger User Inte rface 59048-02 A 2-17 Q 2.10.3 Fabric T ree The fabric tree list s the managed fabr ics and their switches as shown in Figure 2-9 . The window width can be adjusted by clicking and dragging the moveable window border . An entry handle located to the left of an entry in the tree indicates that th[...]

2 – Using SANbox Manager SANbox Manager User Interf ace 2-18 59048-02 A Q 2.10.4 Graphic Window The graphic window presents graph ic information about fabrics and switches such as the fabric topology and the switch faceplate. The window length can be adjusted by clicking and dragging the window bord er that it shares with the data window . 2.10.5[...]

2 – Using SANbox Mana ger Using the Topology Display 59048-02 A 2-19 Q 2.1 1 Using the T opology Display The topology display shown in F igure 2-10 receives information from the selected fabric and displays it s topology . Switches and inter-switch links (ISL) appear in the graphic window and use color to indicate status. Consider the following t[...]

2 – Using SANbox Manager Using the Topology Display 2-20 59048-02 A Q 2.1 1.2 Wo rking with Switches and Links Switch and link icons are selectable a nd moveable, and serve as access points for other displays and menus. Y ou select switches and links to display information about them, modify their configu ration, or delete them from the display .[...]

2 – Using SANbox Mana ger Topology Data Windows 59048-02 A 2-21 Q 2.1 1.2.3 Opening the Faceplate Display and T opology Popup Men us The faceplate display shows the front of a single switch and it s ports. T o open the faceplate display when viewing the topology display , click the switch entry/icon in the fabric tree, or double-click the switch [...]

2 – Using SANbox Manager Using the Faceplate Display 2-22 59048-02 A Q 2.13 Using the Faceplate Display The faceplate display shown in Figure 2-1 1 displays the switch name and operational sta te, and port status. Consi der the following f unctional elements of the faceplate display:  I/O blades  Port views and status  Working with I/O b[...]

2 – Using SANbox Mana ger Using the Faceplate Displ ay 59048-02 A 2-23 Q 2.13.2 Port V iews and St atus Port color and text provides informatio n about the port and its operatio nal state. Green indicates active; gray indicates inac tive. The fa ceplate display provides the following views of port sta tus correspondi ng to the View men u options [...]

2 – Using SANbox Manager Using the Faceplate Display 2-24 59048-02 A Q 2.13.3.2 Opening the F aceplate Popup Menu T o open the popup menu, right-click anywhere in t he graphic window to present the following ta sks. If no blades or ports are selected, the corresponding tasks will be unavailable in the menu.  Refresh the switch  Select all p[...]

59048-02 A 3-1 Section 3 Managing Fabrics This section describes the follo wing tasks that manage fabrics:  Security  Managing the fabric datab ase  Displaying fabric information  Zoning a fabric 3.1 Security The components of secu rity are:  User authentication  Inter-switch link security  Inband management 3.1.1 User Authenti[...]

3 – Managing Fa brics Security 3-2 59048-02 A Q 3.1.2 Inter-Switch Link Security Inter-switch link security pertain s to whether the switches in the fabric are configured to permit access to each switch in that fabric. Inte r-switch link security enables inter-switch links with FC-SW -2 compliant switches, SANbox2 switches only , or none regardle[...]

3 – Managing Fabrics Managing the Fabric Database 59048-02 A 3-3 Q 3.2 Managing the Fabric Dat abase A fabric dat abase contains the set of fabrics that you have adde d during a SANbox Manager session. Initially , the SANbox Manager ap plication opens with an empty fabric d atabase. 3.2.1 Adding a Fabric T o add a fabric to the datab ase, do the [...]

3 – Managing Fa brics Managing the Fabric Database 3-4 59048-02 A Q 3.2.2 Removing a Fabric T o delete a fabric file from the database , do the following: 1. Select a fabric in the fabric tree. 2. Open the Fabric menu and select Remove Fabric . 3.2.3 Opening a Fabric V iew File T o open an existing view file, do the following: 1. Open the File me[...]

3 – Managing Fabrics Managing the Fabric Database 59048-02 A 3-5 Q 3.2.5 Rediscovering a Fabric After making changes to or deleting switches from a fabric view , it may be helpful to again view the actual fabric configur ation. The rediscover fabric option clears out the current fabric information b eing displayed, and rediscovers all switch info[...]

3 – Managing Fa brics Managing the Fabric Database 3-6 59048-02 A Q 3.2.7 Replacing a Failed Switch The archive/restore works for a ll switches. However , the Restore menu item is not available for the inband switches. Y ou can only restore a switch out-of-band (the connection switch). Use the following procedure to rep lace a failed switch for w[...]

3 – Managing Fabrics Displaying Fabric Information 59048-02 A 3-7 Q 3.2.8 Deleting Switches and Links The SANbox Manager application does not automatically delete switches or links that have failed or have been physically removed from the Fibre Channel netwo rk. In these cases, you can delete switches and links to bring the display up t o date. I[...]

3 – Managing Fa brics Displaying Fabric Information 3-8 59048-02 A Q The topology display uses switch and sta tus icons to provide status information about switches, inter-switch links, and the Ethernet connection. The switch st atus icons, displayed on the lef t side of a switch, vary in shape and color . Switches controlled by an Ethernet Inter[...]

3 – Managing Fabrics Displaying Fabric Information 59048-02 A 3-9 Q 3.3.2 Displaying the Event Browser The Event Browser is a compilation of messages that have been ge nerated by the switches in the fabric in response to various events. The event format consist s of a severity , time stamp, source, type, an d descrip tion. The Event Browser shown[...]

3 – Managing Fa brics Displaying Fabric Information 3-10 59048-02 A Q Severity is indicated in the severity column usin g icons as described in T able 3-2 . T able 3-2. Severity Levels Severity Icon Description Alarm – An event generated by the sw itch that specifically requests attention. Alarms are generated by se veral swit ch processes. Som[...]

3 – Managing Fabrics Displaying Fabric Information 59048-02 A 3-1 1 Q 3.3.2.1 Filtering the Event Browser Filtering the Event Browser enables you to display only those events that are of interest based on the event severity , timestamp, so urce, type, and description. T o filter the Event Browser , open the Filter menu and select Filter Entries .[...]

3 – Managing Fa brics Displaying Fabric Information 3-12 59048-02 A Q 3.3.2.2 Sorting the Event Browser Sorting the Event Browser enables yo u to display the events in alphanumeric order based on the event se verity , timestamp, source, type, or description. Initially , the Event Browser is sorted in ascending order by timest amp. T o sort the Ev[...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-13 Q Figure 3-4. Active Zone Set Data Window 3.4 Zoning a Fabric Zoning enables you to divide the port s and devices of the fabric into zon es for more efficien t and secure communication among functionally gro uped nodes. This subsection addresses the following topics:  Zoning concepts  Usi[...]

3 – Managing Fa brics Zoning a Fabric 3-14 59048-02 A Q 3.4.1 Zoning Concept s The following zoning concept s provid e some context for the zoning tasks described in this section:  Zones  Aliases  Zone set s  Zoning data base  Zoning configuration 3.4.1.1 Zones A zone is a named group of port s or devices that can communicate with [...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-15 Q 3.4.1.1.2 Access Control List Hard Zones Access Control List (ACL) zoning divides the fabric for p urposes of controlling discovery and inbound traf fic. ACL zoning is a type of hard zon ing that is hardware enforced. This type of zonin g is useful for controlling access to certain devices wi[...]

3 – Managing Fa brics Zoning a Fabric 3-16 59048-02 A Q 3.4.1.2 Aliases T o make it easier to add a group of port s or devices to one or more zones, you can create an alias. An alias is a name d set of ports or devices that are grouped together for convenience. Unlike z ones, aliases impose no communica tion restrictions between it s members. Y o[...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-17 Q 3.4.1.5 Zoning Configuration Y ou can set the FC-SW-2 Auto Save and Defau lt Visibility zoning con figuration parameters using SANbox Manage r or t he Set Config Zoning command. The Auto Save parameter determines wheth er changes to the active zone set that a switch receives from other switch[...]

3 – Managing Fa brics Zoning a Fabric 3-18 59048-02 A Q 3.4.2.2 Default V isibility Default visibility determines the level of communica tion that is permitted among ports/devices when there is no active zone set. The default visibility parameter can be set different ly on each switch. When def ault visibility is enabled (ALL) on a switch, all po[...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-19 Q 3.4.4.1 Zone Merge Failure If a zone merge is unsuccessful, the in ter-switch links b etween the fabrics will isolate due to a zone merge failure, which will generate an alarm. The reason for the E_Port isolation can also be determi ned by viewing the port information. Refer to ”Port Inform[...]

3 – Managing Fa brics Zoning a Fabric 3-20 59048-02 A Q 3.4.5 Using the Edit Zoning Window T o edit the zoning database for a p artic ular switch, open the Zoning me nu from the faceplate display and select Edit Zoning to open the Edit Zoning window shown in Figure 3-6 . Changes can only be made t o inactive zone sets, which are stored in flash ([...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-21 Q without closing the Edit Zoning window . Be fore zoning changes are implemented, SANbox Manager checks for and report s the following zoning conflicts:  Empty zone sets  Empty zones  Empty aliases  ACL or VPF zones with non-domain ID/port number membership  VPF zones that share[...]

3 – Managing Fa brics Zoning a Fabric 3-22 59048-02 A Q 3.4.6 Managing Zone Set s Zoning a fabric involves creating a zo ne set, creating zones as zone set members, then adding devices as zone members. The zoning dat abase supports multiple zone sets to serve the dif ferent security and access needs of your storage a rea network, but only one zon[...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-23 Q 3.4.6.2 Activating and Dea ctivating a Zone Set Y ou must activate a zone set to apply its zoning de finitions to the fabric. Only one zone set can be active at one time. When y ou a ctivate a zone set, the switch distributes that zone set to the temporar y zonin g database on every switch in[...]

3 – Managing Fa brics Zoning a Fabric 3-24 59048-02 A Q 3.4.6.5 Removing a Zone Set Removing a zone set from the dat abase affects the me mber zones in the following ways.  Member zones that are members of othe r zone sets are not af fected.  Member zones that are not me mbers of other zone sets become me mbers of the orphan zone set. The o[...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-25 Q 3.4.7 Managing Zones Managing zones involves the following:  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 3.4.7.1 Creatin[...]

3 – Managing Fa brics Zoning a Fabric 3-26 59048-02 A Q 4. T o add ports or devices to the zon e, do one of the following:  In the zone set tree, select the zone set. In t he graphic window , select the port to add to the zone. Open the Edit men u and select Add Members .  Select a port by port number , Fibre Channel address, or worldwide n[...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-27 Q 3.4.7.3 Renaming a Zone or a Zone Set T o rename a zone, do the following: 1. In the Zone Set s tree of the Edit Zoning window , click the zone/zone set to be renamed. 2. Open the Edit menu and select Rename . 3. In the Rename Zone/Rename Zone Set dialog, enter a new name for the zone/zone se[...]

3 – Managing Fa brics Zoning a Fabric 3-28 59048-02 A Q 3.4.7.7 Changing Zone T ypes T o change a zone type, do the following : 1. In the faceplate display , select t he switch with the zon e type to change. 2. Choose the Zoning button to ope n the Edit Zoning window . 3. In the Zone Set s tree, select the zone to change. 4. Open the Edit menu an[...]

3 – Managing Fabrics Zoning a Fabric 59048-02 A 3-29 Q 3.4.8.2 Adding a Member to an Alias Y ou can ad d a member to an alias in the following ways:  Drag-and-drop method.  Select the alias in the lef t pane and the member in the right pane to add to that alias, and choose the Insert button.  Select the alias in the lef t pane and the me[...]

3 – Managing Fa brics Zoning a Fabric 3-30 59048-02 A Q Notes[...]

59048-02 A 4-1 Section 4 Managing Switches This section describes the follo wing tasks that manage switches in the fabric.  Managing user accounts  Displaying switch information  Managing alarms  Exporting name server information to a file  Paging a switch  Resetting a switch  Setting the date and time  Configuring a switch [...]

4 – Managing Switches Managing User Accounts 4-2 59048-02 A Q modify the switch and its co nfiguration both with SANbox Manager and the T elnet command line interface. Without Admin authorit y , you are limited to viewing switch status and co nfiguration. The Images account is for exchanging files with the switch using FTP . The factory switch co[...]

4 – Managing Switches Managing Us er Accounts 59048-02 A 4-3 Q 1. Enter an account name in the New Ac count Login field. Account names are limited to 15 characters. 2. If the account is to have the ability to modify switch configurations, check the Admin Authority Enabled box. 3. Enter a passwo rd in the New Password field and enter it again in t[...]

4 – Managing Switches Managing User Accounts 4-4 59048-02 A Q 4.1.3 Changing a User Accoun t Password T o change the password for an account on a p articular switch, open the faceplate display and select User Accounts... . Choose the Change Pas sword tab in the dialog to present the display shown in Figure 4-3 . Select the account name from the l[...]

4 – Managing Switches Displaying Switch Information 59048-02 A 4-5 Q 4.2 Displaying Switch Information The faceplate display and dat a windows provide the following specific switch information:  Name server information  Switch specifications and addresses  Configuration parameters  Performance statistics  Configured zone set s Figu[...]

4 – Managing Switches Displaying Switch Information 4-6 59048-02 A Q  Right-click a switch in the topology display and select Refresh Switc h from the popup menu.  Right-click in the graphic window of the fa ceplate display , and select Refresh Switch from the popup me nu. 4.2.1 Name Server Dat a Window The Name Server dat a window displays[...]

4 – Managing Switches Displaying Switch Information 59048-02 A 4-7 Q T able 4-3. Switch Data Window Entries Entry Description FcAddress Switch Fibre Channel ad dress World Wide Name Switch worldwide name Reason for S t atus Additional status infor mation User Name Account name Login Level Authority level Security Enabled Enforcement of account na[...]

4 – Managing Switches Displaying Switch Information 4-8 59048-02 A Q FC-SW-2 Compliant Zoning merge st atus. If T rue, changes to the active zone set are propa gated throughout the fabric. If false, changes to the zoning dat abase are propaga ted throughout the fabric. LegacyAddressFormat Legacy port addressing st atus. Enabled only for interoper[...]

4 – Managing Switches Displaying Switch Information 59048-02 A 4-9 Q 4.2.3 Link Dat a Window The Link data win dow displays information about all switch links in the fabric or selected links. This information includes the swit ch name, the port number at the end of each link, and the link st atus. T o open the Link data window , choose the Link t[...]

4 – Managing Switches Displaying Switch Information 4-10 59048-02 A Q 4.2.6 Configured Zoneset s Dat a Wi ndow The Configured Zoneset s data window displays all zone set s, zones, and zone membership in the zoning dat abase, as shown in Figure 4-5 . T o open the Configured Zonesets da ta window , choose the Configured Zonesets tab below the data [...]

4 – Managing Switches Configuring Alarms 59048-02 A 4-1 1 Q 4.3 Configuring Alarms Y ou can configure the switch to generate alarms for selected events. Co nfiguring an alarm involves choosing an event type, rising and falling thresholds, a sampling interval, and finally enabling or disabling the alarm. T o configure alarms, do the following: 1. [...]

4 – Managing Switches Configuring Alarms 4-12 59048-02 A Q 6. Enter a value for the rising threshold. A rising threshold alarm is generated when the event count exceeds the risi ng threshold. The switch will not generate another rising thresho ld alarm for that event until the count descends below the falling threshold and rises again above the r[...]

4 – Managing Switches Exporting Name Server Information to a File 59048-02 A 4-13 Q 4.4 Exporting Name Server Information to a File T o save name server information to a file, ope n the topology display and do the following: 1. Select one or more switches. If no switches are selecte d, name server information is gathere d for the all switches. 2.[...]

4 – Managing Switches Configuring a Switch 4-14 59048-02 A Q T o reset a switch using SANbox Manager, do the following: 1. Select the switch to be reset and open the fa ceplate display . 2. Open the Switch menu and select th e Reset Switch pull-down menu:  Select Hot Reset to perform a hot reset.  Select Reset to perform a st andard reset. [...]

4 – Managing Switches Configuring a Switch 59048-02 A 4-15 Q 4.8.1 Switch Properties Use the Switch Properties dialog to change the following switch configuration parameters:  Symbolic name  Administrative st ate  Domain ID and domain ID lock  Broadcast support (TCP/IP)  Inband management  FC-SW-2 compliance for zoning  Legac[...]

4 – Managing Switches Configuring a Switch 4-16 59048-02 A Q 4.8.1.1 Symbolic Name A user-defined name of up to 63 char acters that identifies the switch. 4.8.1.2 Switch Administrative St ates The switch administrative st ate determines the operational st ate of the switch. The switch administrative st ate exists in two forms: the co nfigured adm[...]

4 – Managing Switches Configuring a Switch 59048-02 A 4-17 Q However , you can remedy this by resetting the new switch or ta king it offline then back online. The princip al switch will reassign the domain ID and the switch will join the fabric. 4.8.1.4 Broadcast Support Broadcast is supported on the SANbox 2 which allows for TCP/IP support. Broa[...]

4 – Managing Switches Configuring a Switch 4-18 59048-02 A Q 4.8.1.7 Legacy Port Address Format Legacy Address Format should be enabled only to permit interoperation with certain older non-FC-SW -2, non-QLogic switches. Enabling this setting under other circumstances will d i sable zoning that is defined by domain ID and port number . This settin[...]

4 – Managing Switches Configuring a Switch 59048-02 A 4-19 Q 4.8.2 Network Properties Use the Network Properties dialog shown in Figure 4-9 to change IP an d SNMP configuration para meters. After making changes, choose the OK button to put the new values into ef fect. T o open the Network Properties dialog, open the Switch menu and select Network[...]

4 – Managing Switches Configuring a Switch 4-20 59048-02 A Q 4.8.2.1 IP Configuration The IP configuration ident ifies the switch on the Ethernet network and determines which network discovery method to use. Ta b l e 4 - 7 describes the IP configuration parameters. T able 4-7. IP Configuration Parameters Parameter Description Network Discove ry C[...]

4 – Managing Switches Configuring a Switch 59048-02 A 4-21 Q 4.8.2.2 SNMP Configuration The SNMP configuration defin es how authentication traps are managed. T able 4-8 describes the SNMP configuration parameters. T able 4-8. SNMP Configuration Parameters Parameter Description SNMP Proxy SNMP proxy . Enables or disa bles SNMP communication with o[...]

4 – Managing Switches Configuring a Switch 4-22 59048-02 A Q 4.8.2.3 SNMP T rap Configuration The SNMP trap configuration defines how trap s are set. Choose from the tabs Trap1 – Trap 5 and configure the trap. T able 4-9 describes the SNMP configuration p arameters. 4.8.2.4 Remote Logging The Remote Logging (syslog) feature enables saving of th[...]

4 – Managing Switches Archiving a Switch 59048-02 A 4-23 Q 4.9 Archiving a Switch Y ou can create a n .XML archive file c ont aining the configuration parameters. Archived parameters include the following:  Switch properties and st atistics  IP configuration  SNMP configuration  Port properties and st atistics  Alarm configuration [...]

4 – Managing Switches Restoring a Switch 4-24 59048-02 A Q 4.10 Restoring a Switch Restoring a switch loads the archived switch configu ration parameters to the switch. The switch configuration must be archived be fore it can be restored. Furthermore, the switch archive must be compatible with the switch to be restored; that is, you cannot restor[...]

4 – Managing Switches Restoring a Switch 59048-02 A 4-25 Q choose the Selective Restore t ab and check one or more of the follo wing boxes, then choose the Restore bu tton:  Network Properties : Restores all settings presented in the Network properties dialog except the IP address. Refer to ”Network Prop erties” on page 4-19 .  IP Addre[...]

4 – Managing Switches Managing Fi rmware 4-26 59048-02 A Q 4.1 1 Managing Firmware The switch memory is partitioned for two firmware images. One of these p artitions contains the active firmware; that is, the firmware ve rsion that is in use. The other partition cont ains the inactive firmware which is not in use. The pen ding firmware is the fir[...]

4 – Managing Switches Restoring the Factory Default Configu ration 59048-02 A 4-27 Q 4.1 1.2 Activating the Pending Firmware T o activate firmware that is both i nactive and pending, open the Switch menu in the faceplate display and select Activate Firmware . SANbox Manager attempt s a non-disruptive activation if the active and pending firmware [...]

4 – Managing Switches Restoring the Factory Default Configuration 4-28 59048-02 A Q Broadcast Suppor t Enable Resource Allocation T imeout (RA TOV) 10000 milliseconds Error Detect T imeout (ED TOV) 2000 milliseconds IP address 10.0.0.1 Subnet mask address 255.0.0.0 Gateway address 10.0.0.254 Network Discovery S tatic Remote Logging False Remote L[...]

59048-02 A 5-1 Section 5 Managing I/O Blades An I/O blade is a component switch of the larger SANbox2-64 switch. When you configure an I/O blade and it s ports you ar e really configuring the slot. Becau se this configuration is saved on the switch CPU, any I/O blade that you inst all in that slot will acquire that configuration. This section descr[...]

5 – Managin g I/O Blades Changing the I/O Blade Administrative State 5-2 59048-02 A Q 5.2 Changing the I/O Blade Administrative St ate The I/O blade administrative st ate determines the operational st atus of the I/O blade and its ports. The I/O blade administrative st ate exists in two forms: the configured administrative st ate and the current [...]

5 – Managin g I/O Blades Resetting an I/O Blade 59048-02 A 5-3 Q 5.4 Resetting an I/O Blade Resetting an I/O blade reinitializes the I/O blade using the saved configuration. T o reset an I/O blade, do the following : 1. Select one or more blades in the faceplate display . 2. Open the Blade menu and select Reset Blade . 5.5 Hot Swap Wizard The Hot[...]

5 – Managin g I/O Blades Hot Swap Wizard 5-4 59048-02 A Q  Removing an I/O Blade 1. Select the Remove a Blade hot swap procedure 2. Select and confirm the slot from which to remove t he blade. 3. The Port S tatus LEDs will flash green to positively identify the I/O blade. Remove the I/O blade and confirm.[...]

59048-02 A 6-1 Section 6 Managing Port s This section describes the following t a sks that manage port s and devices:  Displaying port information  Configuring ports  T esting ports 6.1 Displaying Port Information Port information is available primaril y in the faceplate display shown in Figu re 6-1 . The faceplate display dat a windows pr[...]

6 – Managing Ports Displaying Port Information 6-2 59048-02 A Q 6.1.1 Monitoring Port S tatus The faceplate display provides the following p ort related information:  Port mode  Port operational state  Port speed  Port media T o display port number and st atus information for a port, position the cursor over a port on the faceplate di[...]

6 – Managing Por ts Displaying Port Information 59048-02 A 6-3 Q 6.1.1.2 Displaying Port Operational St ates T o display the operational st ate on each port in the faceplate display , open the View men u and select View Port States . T able 6-2 list s the possible operational states and their me anings. The port operational state re fers to actua[...]

6 – Managing Ports Displaying Port Information 6-4 59048-02 A Q 6.1.1.4 Displaying T ransceiver Media St atus T o display transceiver media st atus, open the View menu and select View Port Media . T able 6-2 lists the possible media st ates and their meanings. 6.1.2 Port St atistics Data W indow The Port S tatistics data window displays st atisti[...]

6 – Managing Por ts Displaying Port Information 59048-02 A 6-5 Q Logout Count Number of device logouts that ha ve occurred on the switch. Al Init Count Numbe r of times t he po rt entered the initialization state. Invalid Destination Address Number of address identifier (S_ID, D_ID) errors. AL_P A equals 0 on FL_Port or non-ze ro AL_P A found on [...]

6 – Managing Ports Displaying Port Information 6-6 59048-02 A Q Invalid CRC Count Number of invalid Cyclic Redundan cy Check (CRC) frames detected. Tx Wait Count Number of times the port entere d a wait state becaus e it didn't receive credit to tran smit from the attached device. Class 3 T oss Count Number of class 2 an d class 3 sequences [...]

6 – Managing Por ts Displaying Port Information 59048-02 A 6-7 Q 6.1.3 Port Information Dat a Window The Port Information dat a window displays port detail informa tion for the selected port. T o open the Port Information dat a window , choose the Port Info tab below the data wind ow in the faceplate display . T otal Link Resets Number of link-re[...]

6 – Managing Ports Displaying Port Information 6-8 59048-02 A Q 6.1.4 Name Server Dat a Window The Name Server dat a window displays information about the port and the connected device. T o open the Name Server dat a window , select one or more switches in the topology display and choose the Name Server tab below the dat a window . Y ou can also [...]

6 – Managing Por ts Configuring Ports 59048-02 A 6-9 Q 6.2 Configuring Port s The port settings o r characteristics are c onfigured using the Port Properties dialog shown in Figure 6-2 . T o open the Port Properties dialog, select one or more p orts, open the Port menu and select Port Properties . Figure 6-2. Port Properties Dialog The Port Prope[...]

6 – Managing Ports Configuring Ports 6-10 59048-02 A Q 6.2.1 Changing Port Administrative St ates The port administrative st ate determines the operational st ate of a port. The port administrative st ate exists in two forms: the co nfigured administrative state a nd the current administrative st ate.  The configured administrative st ate is t[...]

6 – Managing Por ts Configuring Ports 59048-02 A 6-1 1 Q 6.2.2 Changing Port Speeds The SANbox2 switch port s are capable of transmitt ing and receiving at 1 or 2 Gbps. The port s can be configured for either transmission sp eed or to sense the transmission speed of the devic e to which it is connected. Ta b l e 6 - 8 describes the port speeds. T[...]

6 – Managing Ports Configuring Ports 6-12 59048-02 A Q 6.2.4 Changing Buffer-to-Buffer Credit s SANbox2 switches negotiate with other swit ches to resolve differences in the number of port buf fer credits. However , certain non-FC-SW -2-compliant switches do not negotiate and will isolate when connected. T o remedy this situation, disconnect the [...]

6 – Managing Por ts Configuring Ports 59048-02 A 6-13 Q 2. Select the SANbox2 switch port s in the faceplate display that are to serve as links to the non-compliant switch. 3. Open the Port menu and select Port Properti es . 4. In the E_Port BB Credits field, enter the number of credits per po rt of the non-compliant switch and choose the OK butt[...]

6 – Managing Ports Configuring Ports 6-14 59048-02 A Q 3. Designate Donor Ports: Select availa ble ports and choose >> to move the port into the Selected Donor Port column shown in Fig ure 6-3 . Match the number of port s needed with the number of designated donor port s. The port receiving the credits and the donor port s must reside on th[...]

6 – Managing Por ts Testing Ports 59048-02 A 6-15 Q 6.3 Te s t i n g P o r t s The port loopback test s verify correct port operation by sending a frame out through the loop, and then verif ying that the frame received matches the frame that was sent. Only one port can be tested at a time for each type of test. The Port Loopback T est dialog show[...]

6 – Managing Ports Testing Ports 6-16 59048-02 A Q  Node-to-Node (Online) - The Node-to -Node test verifies communications between the port and it s device node or device loop. The port being tested must be online and conn ected to a remote device. The port p asses the test if the frame that was sent by the ASIC matche s the frame that was rec[...]

59048-02 A A-1 Appendix A Command Line Interface Each switch contains a T elnet server . This server allows a T elnet client to est ablish a T elnet session with the switch to retrieve information or to configure paramete rs using the Command Line Interface (CLI). The CLI enables you to perform a variety of fabric and switch management tasks throug[...]

A – Command Line Interface Command Syntax A-2 59048-02 A Q A.2 Command Synt ax The command synt ax is as follows: command key word keyword [value] keyword [value1] [value2] The Command is followed by one or more keyw ords. Consider the fo llowing rules and conventions:  Commands and keywords are lowercase and case sensitive.  Commands with [...]

A – Command Line Interface Commands 59048-02 A A-3 Q A.3 Commands The command set provides for User and Ad min authority levels.  User authority grant s viewing access to the fabric and switches using the Show command and other read-only commands.  Admin authority includes the User authority and grants permission to use the Admin command. T[...]

A – Command Line Interface Admin Command A-4 59048-02 A Q Admin Command Opens and closes an Admin session. The Admin session provides comma nds that change the fabric and swit ch confi gurations. Only one Admin session can be open on the switch at any time. An inactive Ad min session will time out after a period of time which can be changed using[...]

A – Command Line Interface Alias Command 59048-02 A A-5 Q Alias Command Creates a named set of port s/devices. Aliases make it easier to assign a set of ports/devices to many zon es. An alias can not have a zone or another alias as a member . Authority Admin Synt ax alias add [alias] [members] copy [alias_source] [alias_destination] create [alias[...]

A – Command Line Interface Alias Command A-6 59048-02 A Q members [alias] Displays all members of the alias given by [alias]. This keyword is available with User authority and does n ot require a zoning edit session or an admin session. remove [alias] [members] Removes the ports/de vices given by [members] from the alias given by [alias]. [member[...]

A – Command Line Interface Config Command 59048-02 A A-7 Q Config Command Manages the Fibre Channel con figurations on a switch. For information about setting the port and switch configu rations, refer to the ”Set Config Command” on page A-3 2 . Authority Admin for all keywords except List Synt ax config act ivate [config] backup cancel copy [...]

A – Command Line Interface Config Command A-8 59048-02 A Q restore Restores configuration settings to an out-of-band switch from a backup file na med configdata , which must b e first uploaded on the switch using FTP . Y ou create the backup file using the Config Backup command. Use FTP to load the backup file on a switch, then enter the Config R[...]

A – Command Line Interface Config Command 59048-02 A A-9 Q The following is an example of how to cre ate a backup file (configdata) and download the file to the workst ation. SANbox2 #> admin start SANbox2 (admin) #> config backup SANbox2 (admin) #> admin end SANbox2 #> exit #>ftp symbolic_name or ip_address user: images password: [...]

A – Command Line Interface Config Command A-10 59048-02 A Q The following is an example of how to upload a configuration backup file (configdata) from the workst ation to the switch, and then restore the configuratio n. #> ftp symbolic_name or ip_address user: images password: images ftp> bin ftp> put configdata ftp> quit SANbox2 #>[...]

A – Command Line Interface Date Command 59048-02 A A-1 1 Q Date Command This command displays or set s the system date and time. T o set the date and time the information string must be provid ed in this format: MMDDhhmmCCYY . The new date and time t akes effect immediately . Authority Admin to change the date; User to display the date. Synt ax d[...]

A – Command Line Interface Fallback Command A-12 59048-02 A Q Fallback Command Assigns the pending firmware st atus back and forth between the active and inactive firmware images stored in switch memory . Authority Admin Synt ax fallback Notes  The Show Switch command displays the two firmware images, active firmware, inactive firmware, and pe[...]

A – Command Line Interface Hardrese t Command 59048-02 A A-13 Q Hardreset Command Resets the switch and performs a power-on self test. This reset activates the pending firmware and disrupt s traffic. Authority Admin Synt ax hardreset Notes T o reset the switch without a powe r-on self test, refer to the ”Reset Command” on page A-2 5 . T o res[...]

A – Command Line Interface Help Command A-14 59048-02 A Q Help Command Displays a brief description of the specifie d command and its keyword s. Authority User Synt ax help [command] [keyword] Keywords [command] Displays a summary of the comman d given by [command] and it s keywords. If you omit [command], the system displays al l available comma[...]

A – Command Line Interface History Command 59048-02 A A-15 Q History Command Displays a numbered list of the previously e ntered commands from which you can re-execute selected commands. Authority User Synt ax history Notes Use the History command to provide co ntext for the ! command:  Enter ![command] to re-enter the most re cent execution o[...]

A – Command Line Interface Hotreset Command A-16 59048-02 A Q Hotreset Command Resets the switch for th e purpose of activating the pending firmwar e without disrupting traf fic. This command termi nates all management sessions and saves all configuration information. Af ter the pending firmware is activated, the configuration is recovered. This [...]

A – Command Line Interface Hotswap Command 59048-02 A A-17 Q Hot swap Command This command prompts you step-by-ste p through the procedure to replace an I/O blade, insert an I/O blade, or remove an I/O blade while the switch is running. Authority Admin Synt ax hotswap Notes The Hotswap command a utomatically starts a nd ends an Admin session in t[...]

A – Command Line Interface Hotswap Command A-18 59048-02 A Q to replace? (1,2,3,4,6,7,8,9): [1] 6 o Remove all connections from the IO blade in slot 6. o Remove the IO blade in slot 6 from the chassis. Have the above operations been completed? (y = proceed / n = cancel) y Hotswap IO blade removal sub-procedure successfully completed. If you wish [...]

A – Command Line Interface Image Command 59048-02 A A-19 Q Image Command Manages and insta lls switch firmware. Authority Admin Synt ax image cleanup fetch [account_name] [ ip_address] [file_source] [file_destination] list unpack [file ] Keywords cleanup Removes all firmware image files from the switch. All firmware image f iles are removed autom[...]

A – Command Line Interface Lip Command A-20 59048-02 A Q Lip Command Reinitializes the specified loop port. Authority Admin Synt ax lip [port_number] Keywords [port_number] The number of the port to be reinitialize d. Examples The following is an example of the Lip command: SANbox2 (admin) #> lip 2[...]

A – Command Line Interface Passwd Command 59048-02 A A-21 Q Passwd Command Changes a user account’ s password. Authority Admin to change another acco unt’s password; User to chang e your own. Synt ax passwd [account_name ] Keywords [account_name] The user account name. Y ou must open an admin session to change the password for an accou nt nam[...]

A – Command Line Interface Ping Command A-22 59048-02 A Q Ping Command Initiates an attempt to communicate with a nother switch in the fabric and reports the result. Authority User Synt ax Ping ip_address Keywords ip_address The IP address of the switch to qu ery . Examples The following is an example of a successfu l Ping command: SANbox2 #> [...]

A – Command Line Interface Ps Command 59048-02 A A-23 Q Ps Command Displays current system process information. Authority User Synt ax ps Examples The following is an example of the Ps command: SANbox2 #> ps PID PPID %CPU TIME ELAPSED COMMAND 338 327 0.0 00:00:00 3-01:18:35 cns 339 327 0.0 00:00:01 3-01:18:35 ens 340 327 0.0 00:00:21 3-01:18:3[...]

A – Command Line Interface Quit Command A-24 59048-02 A Q Quit Command Closes the T elnet session. Authority User Synt ax quit, exit, or logout Notes Y ou can also enter Control-D to close the T elnet session.[...]

A – Command Line Interface Reset Com mand 59048-02 A A-25 Q Reset Command Resets the switch configuration paramet ers. If you omit the keyword, the default is Reset Switch. Authority Admin Synt ax reset blade [slot_number] config [config_name] factory port [port_number] snmp switch (default) system zoning Keywords blade [slot_number] Resets the I[...]

A – Command Line Interface Reset Command A-26 59048-02 A Q system Resets the system con figuration settings to the factory default values. Refer to T able A-8 for system configuration default values. zoning Clears the zoning dat abase and deactivates th e active zone set. The zoning configuration values (autosave, defa ult visibility) remain unch[...]

A – Command Line Interface Reset Com mand 59048-02 A A-27 Q ForceOfflin eRSCN False ARB_FF False InteropCredit 0 ExtCredit 0 F A NEnable T rue LCFEnable F alse MFSEnable True MFS_T OV 10 MSEnable T rue NoClose False IOS treamGuard Disabled VIEnable False CheckAlps False T able A-5. Alarm Threshold Configuration Defaults Parameter Default Threshol[...]

A – Command Line Interface Reset Command A-28 59048-02 A Q LoginMonitoringEna bled RisingT rigger FallingT rigger SampleWindow Tr u e 5 1 10 LogoutMonit oringEnabled RisingT rigger FallingT rigger SampleWindow Tr u e 5 1 10 LOSMonitoringEnabled RisingT rigger FallingT rigger SampleWindow Tr u e 100 5 10 T able A-6. Zoning Configuration Defa ults [...]

A – Command Line Interface Reset Com mand 59048-02 A A-29 Q AuthFailureT rap False ProxyEnabled T rue T able A-8. System Configuration Defaults Parameter Default Ethernet Network Discovery S tatic Ethernet Network IP Address 10.0.0.1 Ethernet Network IP Mask 255.0.0.0 Ethernet Gateway Address 10.0.0.254 Fibre Chan nel Network D iscovery S tatic F[...]

A – Command Line Interface Set Command A-30 59048-02 A Q Set Command Sets a vari ety of switch parameters. Authority Admin for all keywords except Alarm Clear , Beacon, and Pagebreak which are available with User authority . Synt ax set alarm clear beacon [st ate] blade [slot_number] [state] config [option] log [option] pagebreak [st ate] port [o[...]

A – Command Line Interface Set Comman d 59048-02 A A-31 Q log [option] S pecifies the type of entries to be entered in the event log. Refer to the ”Set Log Command” on page A-42 . p agebreak [st ate] S pecifies how much info rmation is displayed on the screen at a time according to the value given by [state]. This ke yword is av ailable with [...]

A – Command Line Interface Set Config Command A-32 59048-02 A Q Set Config Command Sets switch, blade, po rt, alarm threshold, and zoning configuration p arameters. Authority Admin au thority and a Config Edit session Synt ax set config blade [slot_number] port [port_number] ports [port_number] switch threshold zoning Keywords blade [slot_number][...]

A – Command Line Interface Set Config Command 59048-02 A A-33 Q ISLSecurity E_Port security . Determines which switches a port will establish a link with.  Any - link with any FC-SW-2 compliant switch. This is the default.  Ours - link only with an FC-SW-2 compliant QLogic switch.  None - reject the link. SymbolicPortName Descriptive nam[...]

A – Command Line Interface Set Config Command A-34 59048-02 A Q LCFEnable Link contro l frame pre ference ro uting. Enables (True) or disables (Fals e) preferred routing of frames with R_CTL = 1 100 (Class 2 response s). The default is False. Enabling LCFEnable will disable MFSEnable. MFSEnable Multi-Frame Sequ ence bundling. Prevent s (T rue) or[...]

A – Command Line Interface Set Config Command 59048-02 A A-35 Q switch Initiates an editing session in which to change switch configuration settings. The system displays each p arameter one line at a time and prompts you for a value. For each pa rameter , enter a new valu e or press the Enter key to accept the current value shown in bracket s. T [...]

A – Command Line Interface Set Config Command A-36 59048-02 A Q threshold Initiates a configuration session by which to gene rate and log alarms for selected events. The system d isplays each event, its th resholds, and sampling interval one line at a time and prompt s you for a value. For each parame ter , enter a new value or press the Enter ke[...]

A – Command Line Interface Set Config Command 59048-02 A A-37 Q zoning Initiates an editing session in which to change switch zoning attributes. The system displays each p arameter one line at a time and prompts you for a value. For each pa rameter , enter a new valu e or press the Enter key to accept the current value shown in bracket s. Rising [...]

A – Command Line Interface Set Config Command A-38 59048-02 A Q Examples The following is an example of the Set Config Blad e command: SANbox2-64 108 (admin-config) #> set config blade 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the default value. If you wish [...]

A – Command Line Interface Set Config Command 59048-02 A A-39 Q The following is an example of the Set Config Port command: SANbox2 #> admin start SANbox2 (admin) #> config edit SANbox2 (admin-config) #> set config port 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key [...]

A – Command Line Interface Set Config Command A-40 59048-02 A Q The following is an example of the Set Config Switch co mmand: SANbox2 #> admin start SANbox2 (admin) #> config edit SANbox2 (admin-config) #> set config switch A list of attributes with formatting and default values will follow. Enter a new value or simply press the ENTER k[...]

A – Command Line Interface Set Config Command 59048-02 A A-41 Q SampleWindow (decimal value, 1-1000 sec) [10 ] ISLMonitoringEnabled (True / False) [True] RisingTrigger (decimal value, 1-1000) [2 ] FallingTrigger (decimal value, 0-1000) [0 ] SampleWindow (decimal value, 1-1000 sec) [10 ] LoginMonitoringEnabled (True / False) [True] RisingTrigger ([...]

A – Command Line Interface Set Log Command A-42 59048-02 A Q Set Log Command S pecifies the type of entries to be entered in the event log. The log consist s of six files contained on the switch: log file , and logfile.1 – logfile.5 . Each file can hold a maximum of 200 entries. The switch begins writing en tries to logfile . When logfile is fu[...]

A – Command Line Interface Set Log Command 59048-02 A A-43 Q Mgmtserver Monitors management server st atus. Nameserver Monitors name server st atus. None Monitor none of the component eve nts. Other Monitors other mi scellaneous event s. Port Monitors all port event s Switch Monitors switch management event s. Zoning Monitors zoning conflict even[...]

A – Command Line Interface Set Log Command A-44 59048-02 A Q save Saves the log settings for the compone nt, level, and port. These settings remain in effect af ter a switch reset. The log settings can be viewed using the Show Log Settings command. T o export log entries to a file, use the Set Log Archive command. st art S ta rts the logging of e[...]

A – Command Line Interface Set Port Command 59048-02 A A-45 Q Set Port Command Sets port st ate and speed for the specified port temp orarily until the next switch reset or new configuration activation. Th is command also clears port counters. Authority Admin Synt ax set port [port_number] bypass [alp a] clear enable speed [transmission_speed] st[...]

A – Command Line Interface Set Setup Command A-46 59048-02 A Q Set Setup Command Changes SNMP and system configuration settings. The swit ch maintains one SNMP configuration and one system configuration. Authority Admin Synt ax set setup snmp system Keywords snmp Prompts you in a line-by-lin e fashion to change SNMP configuration settings. T able[...]

A – Command Line Interface Set Setup Command 59048-02 A A-47 Q system Prompts you in a line-by-lin e fashion to change system configuration settings. T able A-14 describes the system configuration fields. For each parameter , enter a new value or press the Enter key to accept the current value shown in bracket s. T rapCommunity Trap community pas[...]

A – Command Line Interface Set Setup Command A-48 59048-02 A Q Examples The following is a n example of the Set Setup SNMP command: SANbox2 #> admin start SANbox2 (admin) #> set setup snmp A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you [...]

A – Command Line Interface Set Setup Command 59048-02 A A-49 Q Trap2Enabled (True / False) [False ] Trap3Address (dot-notated IP Address) [0.0.0.0 ] Trap3Port (decimal value) [162 ] Trap3Severity (see allowed options above) [warning ] Trap3Version (1 / 2) [2 ] Trap3Enabled (True / False) [False ] Trap4Address (dot-notated IP Address) [0.0.0.0 ] T[...]

A – Command Line Interface Show Command A-50 59048-02 A Q Show Command Displays fabric, switch, and port operational inf ormation. Authority User Synt ax show about alarm blade broadcast chassis config [option] domains donor fabric interface log [option] lsdb mem [count] ns [option] pagebreak panel perf [option] port [port_number] post log setup [...]

A – Command Line Interface Show Command 59048-02 A A-51 Q chassis Displays chassis component sta tus and temperature. config [option] Displays switch, port, and zoning configuration attributes. Refer to the ”Show Config Command” on page A-6 4 . domains Displays list of each domain and it s worldwide name in the fabric. donor Displays list of [...]

A – Command Line Interface Show Command A-52 59048-02 A Q p agebreak Displays the current p agebreak setting. The pag ebreak setting limits the display of information to 20 lines (On) or allows the continuous display of information without a break (Of f). p anel Displays the hardware configu ration and port mapping for a switch. The representat i[...]

A – Command Line Interface Show Command 59048-02 A A-53 Q Flowerrors Received a frame when there were no available credits. FReject Num ber of fram es from d evices that were reject ed. InvalidCRC Invalid CRC detected. InvalidDestAddr Invalid dest ination address detected. LIP ALPD ALPS Number of F7, AL_PS LIPs, or AL_PD (vendor specific) resets [...]

A – Command Line Interface Show Command A-54 59048-02 A Q post log Displays the Power On Self T est (POST) log which contains result s from the POST . setup [option] Displays setup attributes for the system, SNMP , and the switch manufacturer . Refer to the ”Show Setup Command” on p age A-71 . slot [slot_number] Displays the hardware attribut[...]

A – Command Line Interface Show Command 59048-02 A A-55 Q  Alias List  Config List  Date  History  Ps  Show (About, Alarm, Backtrace, Chassis, Config Port, Config Switch, Config Threshold, Dev , Dev Settings, Domains, Donor , Fabric, Log, Log Settings, Lsdb, Mem, Ns, Perf, Port, Setup Mfg, Setup Snmp, Setup Syste m, S teering, S[...]

A – Command Line Interface Show Command A-56 59048-02 A Q The following is an example of the Show Chassis co mmand: SANbox2 #> show chassis Chassis Information ------------------- FanStatus (1) Good FanStatus (2) Good FanStatus (3) Good PowerSupplyStatus (1) NotInstalled PowerSupplyStatus (2) NotInstalled HeartBeatCode 1 HeartBeatStatus Normal[...]

A – Command Line Interface Show Command 59048-02 A A-57 Q The following is an example of the Show Fab ric command: SANbox2 #> show fabric Domain WWN Enet IP Addr FC IP Addr SymbolicName ------ --- ------------ ---------- ------------ 16 (0x10) 10:00:00:c0:dd:00:77:81 10.20.68.11 0.0.0.0 gui sb1 .11 17 (0x11) 10:00:00:c0:dd:00:6a:2d 10.20.68.12[...]

A – Command Line Interface Show Command A-58 59048-02 A Q The following is an example of the Show NS [domain_ ID] command: SANbox2 #> show ns 18 Seq Domain Port Port No ID ID Type COS PortWWN NodeWWN --- ------ ------ ---- --- ------- ------- 1 18 (0x12) 120700 N 3 21:00:00:e0:8b:07:a7:bc 20:00:00:e0:8b:07:a7:bc The following is an example of [...]

A – Command Line Interface Show Command 59048-02 A A-59 Q The following is an example of the Show Port command: SANbox2 #> show port 1 Port Number: 1 ------------ AdminState Online PortID 150100 AsicNumber 0 PortWWN 20:01:00:c0:dd:00:bc:b8 AsicPort 1 RunningType Unknown ConfigType G SFPPartNumber Unknown DiagStatus Passed SFPRevision 0 EpConnS[...]

A – Command Line Interface Show Command A-60 59048-02 A Q The following is an example of the Show Slot command: SANbox2 #> show slot Slot Blade Port Blade Diag Temp Credit Number Type Range Status Status Status Pool ------ ----- ----- ------ ------ ------ ------ 0 PS-0 * NotInstalled Passed Normal * 1 IO-0 0-7 Good Compromised Normal 0 2 IO-1 [...]

A – Command Line Interface Show Command 59048-02 A A-61 Q The following is an example of the Show Switch co mmand: SANbox2 #> show switch Switch Information ------------------ SymbolicName sw .108 SwitchWWN 100000c0dd00bc56 SwitchType SANbox2-64 PROMVersion V2.0.0.0-0 (day month date time year) CreditPool 0 DomainID 19 (0x13) FirstPortAddress [...]

A – Command Line Interface Show Command A-62 59048-02 A Q The following is an example of the Show T opology command for port 1: SANbox2 #> show topology 1 Local Link Information ---------------------- PortNumber 1 PortID 650100 PortWWN 20:01:00:c0:dd:00:91:11 PortType F Remote Link Information ----------------------- Device 0 NodeWWN 50:80:02:[...]

A – Command Line Interface Show Command 59048-02 A A-63 Q The following is an example of the Show V ersion command: SANbox2 #> show version ***************************************************** * * * Command Line Interface SHell (CLISH) * * * ***************************************************** SystemDescription QLogic SANbox2 FC Switch Eth0N[...]

A – Command Line Interface Show Config Command A-64 59048-02 A Q Show Config Command Displays switch, I/O blade, port, alarm threshold, and zoning attributes for the current configuration. Authority User Synt ax show config blade [slot_number] port [port_number] switch threshold zoning Keywords blade [slot_number] Displays configuration parameter[...]

A – Command Line Interface Show Config Command 59048-02 A A-65 Q MFSEnabled True MSEnabled True NoClose False IOStreamGuard Disabled VIEnabled False CheckAlps False The following is an example of the Show Config Switch comma nd: SANbox2 #> show config switch Switch Configuration Information -------------------------------- AdminState Online Br[...]

A – Command Line Interface Show Config Command A-66 59048-02 A Q FallingTrigger 0 SampleWindow 10 ISLMonitoringEnabled True RisingTrigger 2 FallingTrigger 0 SampleWindow 10 LoginMonitoringEnabled True RisingTrigger 5 FallingTrigger 1 SampleWindow 10 LogoutMonitoringEnabled True RisingTrigger 5 FallingTrigger 1 SampleWindow 10 LOSMonitoringEnabled[...]

A – Command Line Interface Show Log Command 59048-02 A A-67 Q Show Log Command Displays the content s of the log or the parameters used to create entries in the log. The log contains a maximum of 200 en tries. When the log reaches it s entry capacity , subsequent en tries overwrite the existing entries, beginning with the oldest. Authority User S[...]

A – Command Line Interface Show Log Comm and A-68 59048-02 A Q The following is an example of the Show Log Options command: SANbox2 #> show log options Allowed options for log ----------------------- component All, None, NameServer, MgmtServer, Zoning, Switch, Chassis, Blade, Port, Eport, Snmp, Other,CimServer level Critical,Warn,Info,None The[...]

A – Command Line Interface Show Perf Command 59048-02 A A-69 Q Show Perf Command Displays port performance in frames/second and byt es/second. If you omit the keyword, the command displays dat a transmitted (out), dat a received (in), and total dat a transmitted and received in frames/second and bytes per second. Authority User Synt ax show perf [...]

A – Command Line Interface Show Perf Command A-70 59048-02 A Q Examples The following is an example of the Show Perf command: SANbox2 #> show perf 63 Port Bytes/s Bytes/s Bytes/s Frames/s Frames/s Frames/s Number (in) (out) (total) (in) (out) (total) ------ ------- ------- ------- -------- -------- -------- 48 0 0 0 0 0 0 49 0 0 0 0 0 0 50 0 0[...]

A – Command Line Interface Show Setup Command 59048-02 A A-71 Q Show Setup Command Displays the current SNMP and system settin gs. Authority User Synt ax show setup mfg snmp system Keywords mfg Displays manufacturing information about the switch . snmp Displays the current SNMP settings. system Displays the current system settings. Examples The f[...]

A – Command Line Interface Show Setup Command A-72 59048-02 A Q The following is an example of the Show Setup Snmp command: SANbox2 #> show setup snmp SNMP Information ---------------- Contact <sysContact undefined> Location N_107 System Test Lab Description QLogic SANbox2 FC Switch Trap1Address 10.0.0.254 Trap1Port 162 Trap1Severity war[...]

A – Command Line Interface Show Setup Command 59048-02 A A-73 Q The following is an example of the Show Setup System command: SANbox2 #> show setup system System Information ------------------ Eth0NetworkDiscovery Static Eth0NetworkAddress 10.20.11.32 Eth0NetworkMask 255.255.252.0 Eth0GatewayAddress 10.20.8.254 FCNetworkDiscovery Static FCNetw[...]

A – Command Line Interface Shutdown Command A-74 59048-02 A Q Shut down Command T erminates all data transfers on the switch a t convenient points and closes the T elnet session. Always power cycle the switch af ter entering this command. Authority Admin Synt ax shutdown Notes Always use this command to perform an orderly shut down before removin[...]

A – Command Line Interface Test Command 59048-02 A A-75 Q T est Command T ests I/O blades and port s using internal (SerDes level), external (SFP), and online loopback test s. Internal and external tests require that the port be placed in diagnostic mode. Refer to the ”Set Comma nd” on page A-30 for information about changing the I/O blade or[...]

A – Command Line Interface Test Command A-76 59048-02 A Q 3. Insert the loopback plug into the SF P on the selected port. 4. Choose the type of port loopback test to ru n:  T o run an internal loopback test, enter the followin g: test port x internal  T o run an external loopback test, enter the following command. A loopback plug must be in[...]

A – Command Line Interface Test Command 59048-02 A A-77 Q 3. A series of test pa rameters are displayed on the screen. Press the Enter key to accept each default p arameter value, or type a new value for ea ch parameter and press th e Enter key . The T estLen gth parameter is the number of frames sent, the FrameSize (256 byte maximum in some case[...]

A – Command Line Interface Uptime Command A-78 59048-02 A Q Uptime Command Displays the elap sed up time since the switch was last reset and reset method. A hot reset or non-disruptive firmware activatio n does not reset the elapsed up time reported by this command. Authority User Synt ax uptime Examples The following is an example of the Uptime [...]

A – Command Line Interface User Command 59048-02 A A-79 Q User Command Administers or displays user accounts. Authority Admin. The List keyword is available with User authority . Synt ax user accounts add del ete [account_name] list Keywords account s Displays all user account s that exist on the switch. add Add a user account to the switch. Y ou[...]

A – Command Line Interface User Command A-80 59048-02 A Q The following is an example of the User Ad d command: SANbox2 (admin) #> user add Press 'q' and the ENTER key to abort this command. account name (1-15 chars) : user1 account password (4-20 chars) : please confirm account password: set account expiration in days (0-2000, 0=nev[...]

A – Command Line Interface Whoami Command 59048-02 A A-81 Q Whoami Command Displays the account name, session numb er , and switch domain ID for the T elnet session. Authority User Synt ax whoami Examples The following is an example of the Whoa mi command: SANbox2 #> whoami User name : admin@session2 Switch name : SANbox2 Switch domain ID: 21 [...]

A – Command Line Interface Zone Command A-82 59048-02 A Q Zone Command Manages zones and zone membership on a switch. T he Zone command defines members (ports /devices) for a single switch. Zones are members of zone set s. Authority Admin authority and a Zoning Edit session. Ref er to the ”Zoning Command” on page A-8 9 for information about s[...]

A – Command Line Interface Zone Command 59048-02 A A-83 Q list Displays a list of all zones and the zone set s of which they are members. This keyword is valid for User authority and does not req uire a zoning edit session. members [zone] Displays all members of the zone given by [zon e]. This keyword is available with User authority and does n o[...]

A – Command Line Interface Zone Command A-84 59048-02 A Q Examples The following is an example of the Zone List command: SANbox2 #> zone list Zone ZoneSet ------------------- wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_1 wwn_2215c3 zone_set_1 wwn_0160ed zone_set_1 wwn_c001b0 zone_set_1 wwn_401248 zone_set_1 wwn_02402f zone_[...]

A – Command Line Interface Zone Command 59048-02 A A-85 Q The following is an example of th e Zone Zonesets command: SANbox2 #> zone zonesets zone1 Current List of ZoneSets for Zone: wwn_b0241f ---------------------------------- zone_set_1[...]

A – Command Line Interface Zoneset Command A-86 59048-02 A Q Zoneset Command Manages zone sets and zone set membership across the fabric. Authority Admin authority and a Zoning Edit session. Ref er to the ”Zoning Command” on page A-8 9 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available wit[...]

A – Command Line Interface Zoneset Com mand 59048-02 A A-87 Q del ete [zone_set] Deletes the zone set given by [zone_set]. If the specified zone set is active, the command is suspended until the zone set is deactivated. This keyword require s a Zoning Edit session. list Displays a list of all zone set s. This keyw ord is available with User autho[...]

A – Command Line Interface Zoneset Command A-88 59048-02 A Q The following is an example of the Zone set Zones command: SANbox2 #> zoneset zones ssss Current List of Zones for ZoneSet: ssss ---------------------------------- zone1 zone2 zone3[...]

A – Command Line Interface Zoning Command 59048-02 A A-89 Q Zoning Command Opens a Zoning Edit session in which to create and manage zone set s and zones. Refer to the ”Zone Command” on page A-82 an d the ”Zoneset Command” on page A-8 6 . Authority Admin. The List keyword is available with User authority . Synt ax zoning active cancel cle[...]

A – Command Line Interface Zoning Command A-90 59048-02 A Q limit s Displays the number of zone set s, zones, aliases, members per zone, members per alias, and tot al members in the zoning database. This keyword also displays the zo ning databa se lim its. list Lists all fa bric zoning definitions. This ke yword is available with User authorit y [...]

A – Command Line Interface Zoning Command 59048-02 A A-91 Q 16 D_2_NewJBOD_2 5 E1JBOD1 5 E2JBOD2 3 LinkResetZone 3 LinkResetZone2 8 NewJBOD1 8 NewJBOD2 12 Q_1Photon1 12 Q_2Photon2 8 Q_1_NewJBOD1 13 Q_1_Photon_1 8 Q_2_NewJBOD2 13 Q_2_Photon_2 3 ZoneAlias 3 ZoneDomainPort 4 ZoneFCAddr MaxMembersPerAlias 2000 2 AliasInAZone The following is an examp[...]

A – Command Line Interface Zoning Command A-92 59048-02 A Q 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:15:c3 Configured Zoning Information ZoneSet Zone ZoneMember -------------------------------- wwn wwn_b0241f 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 21:00:00:e0:8b:02:41:2f wwn_23bd31 50:06:04:82:bf:d2:18:c2 50:06:0[...]

59048-02 A B-1 Appendix B Graphing Port Performance SANsurfer Fabric Vi ew is an optional appl ication that displays port performance using graphs. SANsurfer Fabric V iew plots dat a communication rates and tota l errors for selected port s as shown in Figure B-1 . When graphing dat a communication rates, you can choose either frames/seco nd or KB/[...]

B – Graphing Port Perfor mance Starting SANsurfer Fabric View B-2 59048-02 A Q B.1 S ta rting SANsurfer Fabric V iew T o start SANsurfer Fabric V iew from within SANbox Manager, open the topology display and select Start Fabric View from the Fabric menu. B.2 Exiting SANsurfer Fabri c View T o exit a SANsurfer Fabric View se ssion, open the File m[...]

B – Graphing Port Performan ce Saving and Opening SANsurf er Fabric View Fabric View Files 59048-02 A B-3 Q In your next SANsurfer Fabric V iew session, the Load Default Fabric File d ialog shown in Figure B-3 prompt s you to load the default fabric view file and to specify its pa ssword if there is one. Figure B-3. Load Default Fabric File – S[...]

B – Graphing Port Perfor mance Changing the SANsurfer Fabric View Default Fa bric File Password B-4 59048-02 A Q B.4 Changing the SANsurfer Fabric View Default Fabric File Password T o change the password for t he default fabric file, do the following: 1. Open the File menu and select Change Def ault File Password to open the Set New Password dia[...]

B – Graphing Port Performan ce Setting the Po lling Frequency 59048-02 A B-5 Q B.6 Setting the Polling Frequency Fabric V iew updates the graphs once per second by default. T o change this polling frequency , do the following: 1. Open the Graph menu, and select Set Polling Frequency to open the Set Graph Polling Frequency dialog. 2. Enter the new[...]

B – Graphing Port Perfor mance Displaying Graphs B-6 59048-02 A Q B.7.1 Arranging Graphs in the Display T o arrange and size graphs in the display , open t he Window menu and select Cascade , Tile , or Close Al l .  Cascade overlaps the graphs so that all gr aphs are at least pa rtially visible.  Tile arranges the graphs in non-overlapping [...]

B – Graphing Port Performan ce Printing Graphs 59048-02 A B-7 Q T o modify the graph options, do the following: 1. Choose the units for the graph:  Select the Show Bytes Data on Graph check box to plot data in KBytes/second  Select the Show Frames Data on Graph check box to plot data in frames/second. 2. Choose what data typ e to plot. For [...]

B – Graphing Port Perfor mance Saving Graph Statistics to a File B-8 59048-02 A Q B.9 Saving Graph St atistics to a File S ta tistics for one or all graphs can be sa ved to a file th at can be opened with a spreadsheet application. T o save a graph st atistics file, do the following: 1. Select a graph. 2. Open the File menu, and select Save Curre[...]

59048-02 A Glossary-1 Glossary Access Control List Zone Access Control List zoning divides the fabric for purposes of controlling discovery and inbound traf fic. Active Zone Set The zone set that define s the current zoning for the fabric. Active Firmware The firmware image on the switch that is in use. Activity LED A port LED that indicates when f[...]

Glossary-2 59048-02 A SANbox2-64 Switch Manageme nt User’s Guide Q Class 3 Service A service which multiplexes frames at frame boundaries to or from one or more N_Ports without acknowledg ment. Configured Zone Set s The zone set s stored on a switch excluding the active zone set. Default Visibility Zoning para meter that determines the level of c[...]

Glossary-3 59048-02 A SANbox2-64 Switch Manageme nt User’s Guide Q In-Order-Delivery A feature that requires that frames be received in the same order in which they were sent. Input Power LED A chassis LED that indicates that the switch logic circuitry is receiving proper DC voltages. Inter-Switch Link The connection between two switches using E_[...]

Glossary-4 59048-02 A SANbox2-64 Switch Manageme nt User’s Guide Q Power On Self T est (POST) Diagnostics that the switch chassis performs at start up. Princip al Switch The switch in the fabric that manages domain ID assignment s. Private Device A device that can communica te only with other devices on the same loop. Private Loop A loop of priva[...]

59048-02 A Index- 1 Index A access control list zone 3-15, 3-28 account name 3-1, 3-3, A-1, A-81 active firmware 4-26 zone set 3-12, 3-16, 4-17 Active Zoneset data window 3-12 Admin authority 3-1, A-3 Admin command A-4 administrative st ate blade 5-2, A-30 configured 4-16, 5-2, 6-10 current 4-16, 5-2, 6-10 I/O blade 5-2 port 6-10, A-45 switch 4-16,[...]

Index-2 59048-02 A SANbox2-64 Switch Manageme nt User’s Guide Q restore 4-24, A-8 save A-8 configured administrative st ate 4-16 contact 4-21 CRC error 4-11 credits 6-13 current administrative state 4-16 D data window Active Zoneset 3-12 Blade Information 5-1 Configured Zonesets 4-1 0 description 2-18, 2-21, 2-24 Name Server 4-6, 6-8 port informa[...]

59048-02 A Index-3 SANbox2-64 Switch Management User’s Guide Q rediscovery 3-5 security 3-1 status 3-7 tree 2-17 zoning 3-13 Fabric View arrange graphs B-6 customize graphs B-6 display graphs B-5 preferences B-4 start B-2 fabric view f ile B-3 auto save B-4 open 3-4, B-3 pas s wo rd B -2 save 2-10, 3-4 faceplate display data window 2-24 descripti[...]

Index-4 59048-02 A SANbox2-64 Switch Manageme nt User’s Guide Q ISL monitoring 4-11 L layout 2-20 legacy address format 4-18 link delete 3-7 selecting 2-20 state dat abase A-51 status 2-19 Link data window 4 -9 Lip command A-20 log archive A-42 clear A-42 event A-42, A-67 power-on self test A-54 logged in users A-55 login limit 3-4, A-1 loop port[...]

59048-02 A Index-5 SANbox2-64 Switch Management User’s Guide Q online test A-75 operational information A-52 operational st ate 6-3 performance A-52, A-69, B-1 recipient 6-13 reset 6-14 selecting 2-23 speed 6-3, 6-11, A-45 status 2-23 test 6-15 view 2-11, 2-23 Port Information dat a window 4-9, 6-7 Port S t atistics data window 4-9, 6-4 port/devi[...]

Index-6 59048-02 A SANbox2-64 Switch Manageme nt User’s Guide Q slot number 2-22, A-54 soft zone 3-14, 3-28 static boot method 4-20 status icon color 2-17 steering A-54 subnet mask address 4-20 switch add 3-5 administrative st ate 4-16, A-31 configuration 4-14, A-35 configuration display A-64 delete 3-7 displaying information 4-5 hard reset 4-14,[...]

59048-02 A Index-7 SANbox2-64 Switch Management User’s Guide Q Z zone access control list 3-15 add member port 3-26, A-82 copy 3-23, A-82 create 3-25, A-82 definition 3-14 delete A-82 delete member port A-83 list A-83 list members A-83 name server 3-14 remove 3-23, 3-27 remove all 3-27 remove member port 3-27 rename 3-27, A-83 soft 3-14 type 3-28[...]

Index-8 59048-02 A SANbox2-64 Switch Manageme nt User’s Guide Q Notes[...]