Home
HP Compaq StorageWorks SAN Director 64 CLI Reference Guide
Contents
1. Al Tab Complete the current keyword aK Control K Delete to the end of the line AL Control L Redraw the line AN Control N Move down one line in the command history AP Control P Move up one line in the command history AR Control R Redraw the line AU Control U Clear the input and reset the line buffer AX Control X Clear the input and reset the line buffer lt ESC gt A Up Arrow Move up one line in the command history lt ESC gt B Down Arrow Move down one line in the command history lt ESC gt C Right Arrow Position the cursor right one character lt ESC gt D Left Arrow Position the cursor left one character Command Tree The command tree of the CLI begins from the root The commands in the four extended branches config maint perf and show are described in Chapter 2 CLI Commands There are three additional commands login logout and commaDelim that are globally available These commands are described in this chapter The hierarchy from the root reading from left to right is as follows CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 1 3 Introduction Table 1 2 CLI Command Tree S EAS IE C sw Y CMS IEA e rane A YA all EA ESA AS AA a AT E CC IE aeietecommaniy CS IEA meea IEA ary Y merme i UNNE EA EA EA E SA A 1 4 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Introduction Table 1
2. As shown in this example use of the complete command syntax avoids navigating up and down the branches of the CLI command tree and the prompt stays at the root The use of complete command syntax is particularly useful when writing scripts CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 1 7 Introduction When coding a script remember to code the appropriate character sequences which are described in Navigation Conventions on page 1 2 Root gt config port name 4 HP Tape Drive lt CR gt Root gt maint port beacon 4 true lt CR gt Limitation on Movements As the commands are entered they are recorded in a history log The limitations on movement that result from use of the history log are e Ifa command has more than 60 characters the command runs but the command 1s not recorded in the history log and the position in the tree does not change as shown in the following example Because the command is not recorded in the history a subsequent asynchronous command navigation command cannot depend on it Root gt config zoning addWwnMem TheUltimateZone 10 00 00 00 C9 22 9B 64 Root gt Whenever the position in the CLI command tree moves to a new branch for example config to maint config to config port or config port to config the history log is cleared In this case any asynchronous commands for example the up arrow command lt ESC gt A or the up arrow keyboard symbol c
3. Description This command resets an individual port without affecting any other ports However if a device is attached to the port and the device is online the reset causes a link reset to occur If the port is in a failed state that is after failing a loopback test the reset restores the port to an operational state The reset also clears all statistics counters and disables port beaconing for the specified port Parameters This command has one parameter portNumber Specifies the port number to be reset Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 Command Example Root gt maint port reset 4 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 49 CLI Commands Syntax beacon beaconState Purpose This command enables or disables unit beaconing Parameters This command has one parameter beaconState Specifies whether unit beaconing is enabled Valid values are true and false Boolean 1 and 0 may be substituted as values Command Examples Root gt maint system beacon false Root gt maint system beacon 0 Syntax clearSysError Purpose This command clears the system error light Parameters This command has no parameters Command Example Root gt maint system clearSysError 2 50 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax ipl Purpose
4. remove changes the WWN to the default value 00 00 00 00 00 00 00 00 Even though this removes the WWN port association if the portBindingState value set with the config security portBinding bound command is still true the port binding is active other devices are prevented from logging in to this port To allow other devices to log in to this port use the config security portBinding bound command to set the portBindingState parameter to false Command Examples Root gt config security portBinding wwn 4 AA 99 23 23 08 14 88 C1 Root gt config security portBinding wwn 4 attached Root gt config security portBinding wwn 4 remove 2 14 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax show portNumber Purpose This command shows the port binding configuration for a single port Parameters This command has one parameter portNumber Specifies the port number for which the port binding configuration will be shown Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 Command Example Root gt config security portBinding show 4 Output The port binding configuration date is displayed as a table that includes the following properties Port Number The port number WWN Binding The state of port binding for the specified port either active or inactive Bound WWN The WWN of the device that is bound to the s
5. Error 78 System Error Light On Description This product cannot beacon because the system error light is on Action Refer to the product service manual for the appropriate procedure Clear the system error light before enabling beaconing A 14 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 79 FRU Failed Description The specified FRU has failed Action Refer to the product service manual for the appropriate procedure Error 81 Default Zone Enabled Description The request cannot be completed because the default zone is enabled Action Disable the default zone before reentering the command Error 82 Invalid Interop Mode Description The value entered for the interoperability mode is not valid Action The interoperability mode for the director or switch must be Homogenous Fabric or Open Fabric 1 0 Enter either Homogenous Fabric or Open Fabric 1 0 to set the interoperability mode CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 15 Error Messages Error 83 Not Allowed in Open Fabric Mode Description Zone member cannot be put into the default zone while the product is operating in Open Fabric 1 0 mode For example if the following series of commands is entered Error 83 results Root gt maint system setOnlineState false Root gt config switch interopMode open Root gt config zoning setDefZoneStat
6. active beaconing causes LEDs to flash for selected components CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary 1 Glossary BER See bit error rate bidirectional In Fibre Channel the capability to simultaneously communicate at maximum speeds 100 Mbps in both directions over a link bit error rate BER Ratio of received bits that contain errors to total of all bits transmitted blocked port Devices communicating with the port are prevented from logging into a director or switch or communicating with other devices attached to the director or switch A blocked port continuously transmits the offline sequence broadcast Send a transmission to all N_Ports on a fabric See also multicast broadcast frames Data packet also known as a broadcast packet whose destination address specifies all computers on a network buffer Storage area for data in transit Buffers compensate for differences in processing speeds between devices See also buffer to buffer credit buffer to buffer credit BB_Credit See buffer to buffer credit Indicates the maximum number of frames a port can transmit without receiving a receive ready signal from the receiving device call home Product feature which requires installation of HP Proactive Service software and enables the HAFM server to automatically transmit system events failure information to an HP customer support center The HP support center serv
7. 0 00 cece eee 1 6 Limitation on Movements 0 0 ce cece ect eeeee enn 1 8 PArame ergy oss ahs a se teenies aoe A E Gas ens tates GE aetna aan gs 1 8 OUE 62th A ee a ees ae lead Sada e dE 1 9 Logging In and Logging Out 0 0 0 0 cette teens 1 9 User Access Rights monesti anao tied 24h gated dant ae Weave canes dai Lads 1 9 LOGIN seg AA A aa ah ited Skee een Omak 2 eae Bee 1 9 logott ca va ehh ean e BEE Sa eed Re ap ewe Lad 1 10 COMMAD Sli ys id Fes ss tice eed oc BAA e ed a Ve RE oe way OA AER 1 11 Handling Command Line Interface Errors 1 0 0 0 00 ccc ees 1 12 Using the Command Line Interface Help o o ooooooooorororomom oo 1 12 Commenting Scripts easair ea cas a aaa aio 1 13 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 iii Contents IEA RN 1 14 Ethernet Connection Loss o ococ oooomoco corr 1 14 2 CLI Commands Command Oveivje Woner nrn Saale ROS Sam Ae oh eA Pa eae R 2 1 config Commands cute ica dida 2 1 config features installKey ooooooooooooorrrrrr eens 2 2 config features shOW o 0ooooooooorrrrr nent tenes 2 3 configap ethermeti ists Sk side E 24 COMAS TP edad a gare 25 config port blocked ico cai Aaabdan a ete eee 2 6 CONTE POTt extDIStiis erei pest neoske Maher eon Mes ates VER Dees 2 7 Config portnaMer lt a Wig hh Se eee Sade aaa 2 8 CONTE Port speed eit sos OM eke hs wehbe wale Maa le tales Wed Dh eed 2 9 CONS port type cnt e
8. 254 If no switch is set to principal the switch with a priority 254 becomes the principal switch however if two or more switches have a priority of 254 the switch with the lowest WWN becomes the principal switch neverprincipal sets the numerical switch priority to 255 This switch is not able to become the principal switch NOTE At least one switch in a multiswitch fabric must have a switch priority value of principal or default NOTE The number codes 2 253 are not now in use Command Example Root gt config switch priority principal Syntax raTOV timeoutValue Purpose This command sets the R A TOV for the switch 2 26 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Description The switch must be set offline before this command is entered Special care should be used when scripting this command due to its relationship with E D TOV Parameters This command has one parameter timeout Value Specifies the new R_A_ TOV value The units for this value are tenths of a second This parameter must be an integer in the range 10 1200 1 second to 120 seconds and must be larger than the E D TOV Command Example Root gt config switch raTOV 20 Syntax rerouteDelay rerouteDelayState Purpose This command enables or disables rerouting delay for the switch Description The switch must be set offline before this command is entered This command is only
9. RSU2A TE hp StorageWorks edge switch 2 16 service manual A7284 96002 AA RS2JA TE hp StorageWorks edge switch 2 16 product manager user guide A7284 96003 AA RS2KA TE hp StorageWorks edge switch 2 16 release notes A7284 96004 AV RSU3A TE hp StorageWorks edge switch rack mount installation instructions A7283 96004 AA RT4MA TE hp StorageWorks SFP transceiver installation instructions A6534 96030 AA RSS3A TE x CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 About This Guide Document Conventions The conventions included in Table 1 apply Table 1 Document Conventions Element Convention Cross reference links Blue text Figure 1 Key names menu items buttons and Bold dialog box titles File names application names and text Italics emphasis User input command names system Monospace font responses output and messages COMMAND NAMES are uppercase unless they are case sensitive Variables Monospace italic font Website addresses Sans serif font http thenew hp com Symbols in Text These symbols may be found in the text of this guide They have the following meanings WARNING Text set off in this manner indicates that failure to follow directions in the warning could result in bodily harm or loss of life CAUTION Text set off in this manner indicates that failure to follow directions could 7 result in damage to equ
10. Switch Priority The switch priority as set in the config switch priority command Speed The switch speed as set in the config switch speed command Rerouting Delay The rerouting delay as set in the config switch rerouteDelay command Operating Mode The operating mode Open Systems or S 390 This attribute cannot be configured through the command line interface Interop Mode The interoperability mode as set in the config switch interopMode command Active Domain Id The active domain ID of the switch This ID may or may not be the same as the preferred domain ID World Wide Name The world wide name for the switch Output Example The output from the show switch command displays as follows Switch Information State BB Credit R_A_TOV E_D_TOV Preferred Domain Id Switch Priority Speed Rerouting Delay Operating Mode Interop Mode Active Domain Id World Wide Name Online 2 20 4 iL Default 2 Gb sec Enabled Open Systems Open Fabric 1 0 L 10 00 08 00 88 00 21 07 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 79 CLI Commands Syntax system Purpose This command displays a set of system attributes Parameters This command has no parameters Command Example Root gt show system Output The system attributes are displayed as a table that includes the following properties Name Description Contact Location Date T
11. active FRU that has failed to a backup FRU fiber Physical media types supported by the Fibre Channel specification such as optical fiber copper twisted pair and coaxial cable fiber optics Branch of optical technology concerned with the transmission of light pulses through fibers made of transparent materials such as glass fused silica and plastic CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary 5 Glossary Fibre Channel Integrated set of standards recognized by the American national Standards Institute ANSI which defines specific protocols for flexible information transfer Logically a point to point serial data channel structured for high performance field replaceable unit FRU Assembly removed and replaced in its entirety when any one of its components fails firmware Embedded program code that resides and executes on a director or switch F_Port See fabric port FRU See field replaceable unit gateway address A unique string of numbers in the format xxx xx xxx xxx that identifies a gateway on the network generic port G_Port Physical interface on a director or switch that can function either as a fabric port F_Port or an expansion port E_Port depending on the port type to which it connects G_Port See generic port high availability fabric manager HAFM application Application that implements the management user interface for HP Fibre Channel swit
12. an SNMP managed device and directed to an SNMP network management station trap host SNMP management workstation that is configured to receive traps CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary 13 Glossary trunk cable Cable consisting of multiple fiber pairs that do not directly attach to an active device This cable usually exists between distribution panels See also optical cable contrast with jumper cable unblocked port Devices attached to an unblocked port can login to the director or switch and communicate with devices attached to any other unblocked port unicast Communication between a single sender and a single receiver over a network Compare to multicast communication between any sender and the nearest of a group of receivers universal port module UPM card Each director 2 64 UPM card provides four 2 125 Gbps Fibre Channel connections through duplex small form factor SFF pluggable fiber optic transceivers UPM card See universal port module card vital product data VPD System level data stored by the backplane in the electrically erasable programmable read only memory This data includes serial numbers and identifies the manufacturer VPD See vital product data world wide name WWN Eight byte address that uniquely identifies a switch or a node end device on global networks WWN See world wide name zone Set of devices that can access one anot
13. and FRU position where applicable Event Data The 32 byte hexidecimal description of the event in words Output Example The output from the show eventLog command displays as follows Date Time Code Severity FRU Event Data 04 12 01 10 58A 375 Major CTP 0 00010203 04050607 08090A0B OCODOEOF 04 12 01 9 58A 385 Severe CTP 0 00010203 04050607 08090A0B OCODOEOF 04 11 01 7 18P 395 Severe CTP 0 00010203 04050607 08090A0B OCODOEOF Syntax frus Purpose This command displays information about all FRUs 2 62 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Parameters This command has no parameters Command Example Root gt show frus Output The FRU information is displayed as a table that includes the following properties FRU The FRU name NotInstalled means the FRU is not installed Position The relative position of the FRU that is its slot State The state of the FRU Values are e Active the current module is active e Backup this module is not currently being used but it is available for immediate failover e Failed the current module is failed Serial Num The serial number of the FRU Part Num The part number of the FRU Beaconing The beaconing state of the FRU on or off Pwr On Hrs The power on hours value for the FRU CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 63 CLI Commands Output Example The
14. applicable if the configured switch is in a multiswitch fabric Enabling the rerouting delay ensures that frames are delivered in order through the fabric to their destination CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 27 CLI Commands If there is a change to the fabric topology that creates a new path for example a new switch is added to the fabric frames may be routed over this new path if its hop count is less than a previous path with a minimum hop count This may result in frames being delivered to a destination out of order because frames sent over the new shorter path may arrive ahead of older frames still in route over the older path If rerouting delay is enabled traffic ceases in the fabric for the time specified in the config switch edTOV command This delay allows frames sent on the old path to exit to their destination before new frames begin traversing the new path Note that during this delay period frames addressed to the destinations that are being rerouted are discarded if they are Class 3 frames and rejected if they are Class 2 or Class F frames Parameter This command has one parameter rerouteDelayState Specifies whether rerouting delay is enabled Valid values are true and false Boolean 1 and 0 may be substituted as values Command Examples Root gt config switch rerouteDelay true Root gt config switch rerouteDelay 1 Syntax speed switchSpeed Purpose Thi
15. are entered while the switch is online an error message results 2 22 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax bbCredit bbCreditValue Purpose This command sets the buffer to buffer credit value for all ports except those ports configured for extended distance Description The switch must be set offline before this command is entered Parameters This command has one parameter bbCredit Value Specifies the new buffer to buffer credit value This parameter must be an integer in the range 1 60 Command Example Root gt config switch bbCredit 2 Syntax edTOV timeoutValue Purpose This command sets the E D_ TOV for the switch Description The switch must be set offline before this command is entered CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 23 CLI Commands Special care should be used when scripting this command due to its relationship with R_A TOV Parameters This command has one parameter timeout Value Specifies the new E D_ TOV value The units for this value are tenths of a second This parameter must be an integer in the range 2 600 0 2 second to 60 seconds and it must be smaller than the R_A TOV Command Example Root gt config switch edTOV 4 Syntax interopMode Purpose This command sets the interoperability mode for the switch Description The switch must be set offline
16. before this command is entered Parameters This command has one parameter interopMode Specifies the interoperability mode Valid values are e Homogenous Fabric e Open Fabric 1 0 2 24 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Command Example Root gt config switch interopMode open Syntax prefDomainId domainId Purpose This command sets the preferred domain ID for the switch Description The switch must be set offline before this command is entered Parameters This command has one parameter domainId Specifies the new preferred domain ID value This parameter must be an integer in the range 1 31 Command Example Root gt config switch prefDomainld 1 Syntax priority switchPriority Purpose This command sets the switch priority CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 25 CLI Commands Description The switch must be set offline before this command is entered Parameters This command has one parameter switchPriority Specifies the switch priority Valid values are principal default or neverprincipal principal sets the numerical switch priority to 1 The switch with a priority of 1 becomes the principal switch however if two or more switches have a priority of 1 the switch with the lowest WWN becomes the principal switch default sets the numerical switch priority to
17. commands and their parameters Check that all values for the parameters meet the CLI requirements and then reenter the command CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 25 Error Messages Error 225 Argument Does Not Contain All USASCII Characters Description The CLI received one or more non USASCII characters Action Refer to Chapter 2 for information about the command parameters Check that all parameters are typed correctly and then resubmit the command Error 226 Argument Is Too Long Description One or more parameters of the specified command are invalid Action Refer to Chapter 2 for information about the command parameters Check that all parameters are typed correctly and resubmit the command Error 227 Invalid SNMP Community Name Description The value specified for the SNMP community name is invalid Action The community name must not exceed 32 characters in length Duplicate community names are allowed if the corresponding write authorizations match Specify a valid SNMP community name and resubmit the command A 26 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 228 Invalid Write Authorization Argument Description The writeAuthorization parameter of the config snmp addCommunity command does not contain a valid value For example the values true and false are invalid values for this com
18. director 2 64 edge switch 2 16 and edge switch 2 32 A 23 Error Messages e Reduce the number of zones in the zone set e Reduce the number of members in a zone e Reduce the length of the zone names Error 218 Invalid Port Number Description The value specified for the port number is invalid Action Enter a port number within the range supported by the director or switch Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 Error 219 Invalid Port Type Description The value specified for the port type is invalid Action A port may be configured as an E_Port a G_Port or an F_Port Check that the port is configured appropriately and reenter the command A 24 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 222 Invalid SNMP Community Index Description The value specified for the SNMP community index is invalid Action The SNMP community index must be an integer in the range 1 6 Enter an integer in the range 1 6 Error 223 Unknown Error Description The switch did not accept the request Action Contact your service representative Error 224 Invalid Argument Description The values entered for one or more parameters of the command are invalid For example a letter may have been entered where an integer is required Action Refer to Chapter 2 for information about the
19. errors or omissions contained herein The information is provided as is without warranty of any kind and is subject to change without notice The warranties for Hewlett Packard Company products are set forth in the express limited warranty statements accompanying such products Nothing herein should be construed as constituting an additional warranty Printed in the U S A CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Second Edition August 2002 Part Number A6534 96027 AA RQ7AB TE Contents About This Guide Intended AU a eed ix Related Documentation anoo re hura e En A a ea E A E EENES S ix Document Conventions e i aaa 0 0c ccc a a a a a a eees xi Symbols m Texto a esha ee eng ie ok ae tinh eee N xl Symbols on Equipment o ooooooooooo tet t teen eee nes xii R ck Stability eant A E AE gach ie Ahh ei is xiii Gettine Helpi sa a Sites cate edo igs cae dean eho a a e a a aaa hen aaa xiii HP Technical S pport ieies o eee E O E A cece Ea a xiii HP Websit EA xiv HP Authorized Reseler tit Er a a XIV 1 Introduction Command Line Interface Overview 0 0 0 eect eee eens 1 1 Entering Command Line Interface Commands 000 c eee eee ee 1 2 Documentation Conventions 0 n nee 1 2 Navigation Conventions 0 00 cece ccc ee eee nen ene n enna 1 2 Command Tree oan e eve cree We adie OR odd end hace ea a oe wale 1 3 Navigation of the CLI Command Tree 2
20. follows Port 2 Statistic Count Wrap Rx 75 N A Tx 30 N A RxFrames 2953184 23 TxFrames 1842953 12 TxWords 2953184 65 TxWords 1842953 32 show Commands The show branch of the CLI command tree contains commands that display but do not change stored data values The displayed output that results from these commands 1s not necessarily identical with the output from the show commands that are within the other CLI command tree branches for example config port show The commands in the show branch can by used by either the Administrator or the Operator Syntax eventLog Purpose This command shows the contents of the event log as maintained in NV RAM on the director or switch Parameters This command has no parameters Command Example Root gt show eventLog CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 61 CLI Commands Output The event log data are displayed as a table that includes the following properties Date Time The date and time when the event occurred Code The event reason code Severity The severity of the event The values are Major Unit operational major failure Minor Unit operational minor failure Severity Severe Unit not operational continued The causes are either the switch contains no operational SBAR cards or the system shutdowns due to CTP thermal threshold violations Info Unit operational information only FRU The FRU
21. for director 2 64 edge switch 2 16 and edge switch 2 32 A 17 Error Messages Error 94 Invalid Feature Combination Description The requested features cannot be installed at the same time on one director or switch Action Contact your sales representative Error 99 Preferred Domain ID Cannot Be Zero Description This switch cannot be configured to have a preferred domain ID equal to zero 0 Action Enter an integer in the range 1 31 for the preferred domain ID Error 101 Command Not Supported on This Product Description This product does not support the specified command Action Information only message this operation is not supported Error 102 Switch Not Operational Description The request cannot be completed because the switch is not operational A 18 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Action Refer to the product service manual and consult your service representative Error 115 Invalid Switch Speed Description The request cannot be completed because the switch is not capable of operating at the configured speed Action Refer to the product service manual to determine the speed capabilities of the product Error 116 Switch Not Capable of 2 Gbps Description The request cannot be completed because the switch is not capable of operating at 2 125 gigabits per second Gbps Action Refer to the product service m
22. is not connected to any other switches it acts as its own principal switch Product Manager application Application that implements the management user interface for a specified director 2 64 edge switch 2 16 or edge switch 2 32 When a product instance is opened from the HAFM application s Product View the Product Manager application is invoked R_A_TOV See resource allocation time out value redundancy Performance characteristic of a system or product whose integral components are backed up by identical components to which operations will automatically failover in the event of a component failure Redundancy is a vital characteristic of virtually all high availability 24 hours per day seven days per week computer systems and networks CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary 11 Glossary remote notification A process by which a system is able to inform remote users and or workstations of certain classes of events that occur on the system E mail notification and the configuration of SNMP trap recipients are two examples of remote notification programs that can be implemented on director class switches remote user workstation Workstation such as a PC using the HAFM and Product Manager applications that can access the HAFM server over a LAN connection resource allocation time out value R_A_TOV User specified value used to time out operations that depend on the maximum
23. message that is returned is a string that includes both the error number and the text of the message CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 31 Glossary This glossary defines terms used in this guide or related to this product and is not a comprehensive glossary of computer terms access control Method of control with associated permissions by which a set of devices can access other devices across a network See also persistent binding and zoning active zone set Single zone set that is active in a multi switch fabric It is created when you enable a specified zone set This zone set is compiled by checking for undefined zones or aliases agent Software that processes queries on behalf of an application and returns replies alarm Simple network management protocol SNMP message notifying an operator of a network or device problem alias server Fabric software facility that supports multicast group management arbitration Process of selecting one device from a collection of devices that request service simultaneously audit log Log summarizing actions audit trail made by the user backplane The backplane provides 48 VDC power distribution and connections for all logic cards BB_Credit See buffer to buffer credit beaconing Use of light emitting diodes on ports port cards field replaceable units directors and switches to aid in the fault isolation process when enabled
24. output from the show frus command displays as follows FRU Position State Serial Num Part Num Beacon Pwr On Hrs CTP 0 Backup 81440005 254136 001 off 4512 CTP 1 Active 81440011 254136 001 off 4512 SBAR 0 Active 21109984 254133 001 off 8616 SBAR 1 Backup 21101442 254133 001 off 8616 Power 0 Active 22044540 254137 001 off 8616 Power t Active 22044548 254137 001 off 8616 Fan 0 Active off 0 Fan 1 Active off 0 Backplane 0 Active 21050137 254131 001 off 8616 UPM 0 Active 82060705 292006 001 off 1464 UPM 1 Active 82060627 292006 001 off 1464 UPM 2 Active 82060959 292006 001 off 1457 UPM 3 Active 82060621 292006 001 off 1464 UPM 4 Active 82060632 292006 001 off 1464 UPM 5 Active 82060694 292006 001 off 1458 UPM 6 Active 82063621 292006 001 off 1458 UPM 7 Active 82060639 292006 001 off 1456 UPM 8 Active 82051711 292006 001 off 1455 UPM 9 Active 82051779 292006 001 off 1469 UPM 10 Active 82060969 292006 001 off 1454 UPM 11 Active 82051819 292006 001 off 1455 UPM 12 Active 82060660 292006 001 off 1456 UPM 13 Active 82051743 292006 001 off 1471 UPM 14 Active 82063560 292006 001 off 1456 UPM 15 Active 82051815 292006 001 off 1471 2 64 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax ethernet Purpose This command displays ethernet attributes Parameters This command has no parameters Command Example Root gt show ip ethernet Output The Ethernet attribute
25. possible time that a frame could be delayed in a fabric and still be delivered RFI Acronym for radio frequency interface SAN See storage area network SBAR See serial crossbar assembly segmented E_Port E_Port that has ceased to function as an E_Port within a multi switch fabric due to an incompatibility between the fabrics that it joins See also expansion port serial crossbar SBAR assembly Responsible for Fibre Channel frame transmission from any director port to any other director port Connections are established without software intervention SFP Acronym for small form factor pluggable a type of Fibre Channel connector See also universal port module card simple Network management protocol SNMP A protocol that specifies a mechanism for network management that is complete yet simple Information is exchanged between agents which are the devices on the network being managed and managers which are the devices on the network through which the management is done SNMP See simple network management protocol Glossary 12 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary SNMP community Also known as SNMP community string An SNMP community is a cluster of managed products in SNMP terminology hosts to which a server or managed product running the SNMP agent belongs SNMP community name The name assigned to a given SNMP community Queries from an SNMP management s
26. requested Action Refer to Using the Command Line Interface Help on page 1 12 for information about the help command Refer to Chapter 2 for the correct spelling of the submitted command Ensure that the command is spelled correctly CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 29 Error Messages Refer to Navigation of the CLI Command Tree on page 1 6 Ensure that the command has been entered at the right place in the CLI command tree and then resubmit the command Error 236 Ambiguous Command Description The CLI does not recognize the submitted command For example an incomplete command is entered Root gt co The commaDelim command or the config command may have been intended Action Specify the complete name of the command and resubmit the command Error 237 Invalid Zoning Database Description An unidentifiable problem with the zone set in the local work area occurred Action Check that all the parameters of the command are valid and resubmit the command If the problem persists clear and then reconstruct the zone set Error 238 Invalid Feature Key Description The specified feature key is invalid A 30 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Action Check that the feature key is entered correctly and resubmit the command If the problem persists contact your service representative The
27. table that includes the following properties Active ZoneSet The enabled status name and member zones of the zone set CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 81 CLI Commands Output Example The output from the show zoning command displays as follows Active Zone Set Default Zone Enabled False ZoneSet TheUltimateZoneSet Zone TheUltimateZone ZoneMember Domain 10 Port 6 ZoneMember Domain 15 Port 2 ZoneMember Domain 2 Port 63 ZoneMember 10 00 00 00 C9 22 9B 64 ZoneMember 10 00 00 00 C9 22 9B BD Zone TheNotSoUltimateZone ZoneMember 10 00 00 00 C9 22 9B AB ZoneMember 10 00 00 00 C9 22 9B C6 ZoneMember 10 00 00 00 C9 22 9B AB Zone TheNotUltimateAtAllZone ZoneMember Domain 2 Port 63 2 82 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A Error Messages This appendix lists and explains error messages for the command line interface CLI Any error numbers that are not listed are reserved for future use The message that is returned is a string that includes the error number and the text of the message Error 08 Invalid Switch Name Description The value entered for the switch name is invalid Action The name for a director 2 64 edge switch 2 16 or edger switch 2 32 can contain 0 24 characters Enter a name with 0 24 characters If spaces are used enclose the name in quotation marks Error 09 Invalid Sw
28. 11 Introduction Specifies the comma delineated state for output Valid values are true and false Boolean and 0 may be substituted as values Command Examples Root gt commaDelim true Config gt commaDelim 1 Config Port gt commaDelim false Output Example Output displayed in commaDelim mode follows Root gt show eventLog Date Time Code Severity FRU Event Data 04 12 01 10 58A 375 Major CTP 0 00010203 04050607 08090A0B OCODOEOF 04 12 01 10 58A 375 Major CTP 0 00010203 04050607 08090A0B OCODOEOF 04 12 01 9 58A 385 Severe CTP 0 00010203 04050607 08090A0B OCODOEOF 04 11 01 7 18P 395 Severe CTP 0 00010203 04050607 08090A0B OCODOEOF Handling Command Line Interface Errors Two types of errors detected by the CLI are e An error associated with the interface For example a keyword is misspelled or does not exist Root gt confg Error 234 Invalid Command e An error associated with a fabric director or switch For example a parameter error is detected by a switch where port 24 is entered for a switch that supports only 16 ports Root gt config port name 24 Port 24 Error 248 Invalid Port Number In either case the command is ignored The CLI remains at the point it was before the command was entered The error messages including error number and error are listed in Appendix A Error Messages Using the Command Line Interface Help The question mark can be used within a command to o
29. 15 Error 83 Not Allowed in Open Fabric Mode 1 0 0 0 00 cece ees A 16 Error 88 Invalid Feature Key Length 1 0 0 0 0000s A 16 Error 89 Operational Mode S390 0 0 cette ees A 16 Error 90 Invalid Port Typen ssamen eaat a ett eens A 17 Error 91 E Port Type Configured 0 0 ccc eee A 17 Error 92 Not Allowed While Port Is Unblocked oo o ooooo o A 17 Error 94 Invalid Feature Combination 0 000 c cece eee eee A 18 Error 99 Preferred Domain ID Cannot Be Zero n unana naana A 18 Error 101 Command Not Supported on This Product o o ooooo o A 18 Error 102 Switch Not Operational 0 0 0 0 0 cece A 18 Error 115 Invalid Switch Speed 0 0 o A 19 Error 116 Switch Not Capable of 2 Gbps 1 0 0 0 00 c cee A 19 Error 117 Ports Cannot Be Set at Speeds Higher Than the Switch Speed A 19 Error 201 Change Authorization Request Failed 02005 A 20 Error 202 Invalid Change Authorization ID 00 02 e eee eee A 20 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 vii Contents Error 203 Another Client Has Change Authorizati0M o ooooo A 20 Error 207 Change Request Failed 0 0 0 eee eens A 21 Error 208 Change Request Timed Out 0 0 0 0 0c ccc o A 21 Error 209 Change Request Aborted 0 0 0 0 ccc cee es A 21 Error 210 Busy Processing Another Request 00 0c c
30. 2 CLI Command Tree Continued setDefZoneState activateZoneSet deactivateZoneSe replaceZoneSet clearZoneSet addZone deleteZone renameZoneSet addWwnMem clearZone deleteWwnMem deletePortMem renameZone showPending showActive beacon reset beacon clearSysError resetConfig setOnlineState class2 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 1 5 Introduction Table 1 2 CLI Command Tree Continued clearStats ES EA CIC frus config tc o IEA a ETA IONES INN pening EEN INIA Commands are shown with the exception of the zoning commands in alphabetical order to make them easier to locate Although the commands can be entered in any order depending on the results desired the order shown in Table 1 2 on page 1 4 for the zoning commands is a typical order in which the zoning commands are entered Note that the order in which commands are entered determines the order in which the show commands display the values Refer to Chapter 2 CLI Commands for examples of show commands output Navigation of the CLI Command Tree Once the administrator or operator logs in and receives the Root gt prompt the CLI commands are accessed by navigating up and down the CLI command tree 1 6 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Introduction To move from the root through the any of the four extended branches enter the name of the ne
31. Examples of a restart include an IPL and any power off situation User Access Rights The CLI supports two user access rights administrator and operator A user who logs in with administrator access rights can use all of the commands described in this publication However operator access rights grant permission to use only the perf and show branches of the CLI command tree for example the perf traffic and show system commands as well as the globally available commands login logout and commaDelim described in the following section Syntax login Purpose This command allows a Telnet client to connect to a director or switch CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 1 9 Introduction Description This command allows the user to log in with either administrator or operator access rights The default passwords are password The login command is called automatically by the CLI each time a new Telnet session is activated as well as each time new administrator access rights are configured After the login command is issued the Username prompt automatically displays After a valid user name is entered the Password prompt automatically displays After the corresponding valid password is entered the Root gt prompt displays At this prompt the user may enter any of the commands included in Table 1 2 on page 1 4 A user name and password can be set by the administrator through the config
32. TOV value Action Enter an E D_TOV value in the range 2 600 0 2 second to 60 seconds that is smaller than the R_A_TOV value or enter an R_A_TOV time out value in the range 10 1200 1 second to 120 seconds that is larger than the E D_TOV value Error 20 Invalid Preferred Domain ID Description The value entered for the preferred domain ID for the director or switch is invalid Action The preferred domain ID must be an integer in the range 1 31 Enter a value in the range 1 31 A 4 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 21 Invalid Switch Priority Description The value entered for the switch priority is invalid Action The switch priority entered for the director or switch must be principal default or neverprincipal Refer to the description of the command in config switch priority on page 2 25 Enter principal default or neverprincipal Error 29 Invalid Gateway Address Description The value entered for the gateway address is invalid Action The new gateway address for the Ethernet interface must be entered in dotted decimal format for example 0 0 0 0 Enter the gateway address for the Ethernet interface in the dotted decimal format Error 30 Invalid IP Address Description The value entered for the IP address of the director or switch is invalid Action The IP address for the Ethernet interface must be entered in dotted d
33. This command IPLs the switch Description Connection to the command line interface is lost when this command runs Parameters This command has no parameters Command Example Root gt maint system ipl Syntax resetConfig Purpose This command resets all NV RAM configuration parameters to their default values including feature keys and IP addresses Description This command IPLs the switch Connection from the CLI to the switch is lost when this command runs NOTE This command resets all configuration data and non volatile settings including network information to their default values factory settings Management access may be lost until the network information is restored The default values are set in the firmware of the director or switch For information about the default values refer to the service manual for your director or switch CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 51 CLI Commands Parameters This command has no parameters Command Example Root gt maint system resetConfig Syntax setOnlineState onlineState Purpose This command sets the switch online or offline Parameters This command has one parameter onlineState Specifies whether the switch is online Valid values are true and false Boolean 1 and 0 may be substituted as values Command Examples Root gt maint system setOnlineState true Root gt maint system setOnlin
34. acters a command for example to start a comment The following is an invalid script line Root gt maint system beacon true Turn on beaconing lt CR gt CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 1 13 Introduction To correct the previous script line move the comment either before or after the line with the command For example the following examples are both valid Root gt Turn on beaconing lt CR gt Root gt maint system beacon true lt CR gt or Root gt maint system beacon true lt CR gt Root gt Turn on beaconing lt CR gt Telnet Session The CLI can only be used through a Telnet client session in an out of band management environment using the Ethernet port in a director or switch Although the primary use of the CLI is in host based scripting environments the CLI commands can also be entered directly at a command line Any hardware platform that supports the Telnet client software can be used NOTE If you have the HAFM application use the Configure option in the software to enable Telnet access before attempting to establish a Telnet client session You can also enable Telnet access by using the Configure option of the Embedded Web Server EWS Ethernet Connection Loss If the Ethernet cable is disconnected from a director or switch during a Telnet session one of three scenarios is possible e Replace the Ethernet cable before the client connection times out and
35. ady exists in the zone Action Do nothing if the correct zone member has already been added to the zone otherwise add a zone member that is not already in the zone A 22 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 213 Number of Zones Is Zero Description The config zoning activateZoneSet command tried to activate a zone set contained in the work area to the fabric however the zone set is empty Action A zone set must have at least one zone to be a valid zone set Add at least one zone to the zone set and then reenter the config zoning activateZoneSet command to activate the zone set in the work area to the fabric Error 214 A Zone Contains Zero Members Description The config zoning activateZoneSet command tried to activate the zone set contained in the work area to the fabric however the zone set contains at least one zone that is empty Action Each zone in the zone set must contain at least one zone member Add zone members so that each zone has at least one zone member then reenter the config zoning activateZoneSet command to activate the zone set in the work area to the fabric Error 215 Zone Set Size Exceeded Description The size of the local work area zone set has outgrown the size supported by the CLI Action Reduce the size of the zone set to meet CLI requirements by doing one or more of the following CLI reference guide for
36. and systems xii CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 About This Guide component exceeds the recommended weight for one individual to f h Any product or assembly marked with these symbols indicates that the handle safely WARNING To reduce the risk of personal injury or damage to the equipment observe local occupational health and safety requirements and guidelines for manually handling material Rack Stability sure that A WARNING To reduce the risk of personal injury or damage to the equipment be The leveling jacks are extended to the floor The full weight of the rack rests on the leveling jacks In single rack installations the stabilizing feet are attached to the rack In multiple rack installations the racks are coupled Only one rack component is extended at any time A rack may become unstable if more than one rack component is extended for any reason Getting Help If you still have a question after reading this guide contact an HP authorized service provider or access our website http thenew hp com HP Technical Support In North America call technical support at 1 800 652 6672 available 24 hours a day 7 days a week NOTE For continuous quality improvement calls may be recorded or monitored Outside North America call technical support at the nearest location Telephone numbers for worldwide technical support are listed on the HP
37. annot move the position back towards the root as shown in this example Root gt config Root Config gt port Root Config Port gt lt ESC gt A Root Config Port gt Parameters Some command parameters accept character strings that include spaces Quotation marks are required when a string includes spaces Config System gt location Building_24_Room_16 Config System gt location Building 24 Room 16 If spaces are not included in a parameter that accepts a string the quotation marks are not required around that string 1 8 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Introduction To include quotation marks in a string use the escape character 1 before the quotation marks Config System gt location Building 24 HP Lab A null string can be created by using the quotation marks without any space between them Config System gt location Output All output from the CLI commands is limited to the standard 80 columns supported by most Telnet interfaces The output is left justified Logging In and Logging Out The CLI allows a single Telnet client to be connected to a director or switch Ifa Telnet client logs out or if after 15 minutes of inactivity the client s access times out another Telnet client may log in Also note that the Telnet client user must log in any time a director or switch is restarted because the current user s access is lost
38. anual to determine the speed capabilities of the product Error 117 Ports Cannot Be Set at Speeds Higher Than the Switch Speed Description The request cannot be completed because the requested port speed is faster than the configured switch speed CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 19 Error Messages Action Refer to config switch speed on page 2 28 and config port speed on page 2 9 for information about setting speeds Ensure that the requested speeds meet all requirements Error 201 Change Authorization Request Failed Description The switch did not accept the request to make a change to NV RAM Action Check that all the parameters are correct and reenter the command If problems persist contact your service representative Error 202 Invalid Change Authorization ID Description The switch will not accept a change request from this particular client Action Check that all the parameters are correct and reenter the command If problems persist contact your service representative Error 203 Another Client Has Change Authorization Description Another user is currently making changes to this switch Action Check that all the parameters are correct and reenter the command A 20 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 207 Change Request Failed Description The switch did not a
39. ation See also node D_ID See destination identifier director An intelligent redundant high port count Fibre Channel switching device providing any to any port connectivity between nodes end devices in a switched fabric Directors send data frames between nodes in accordance with the address information present in the frame headers of those transmissions DNS name Host or node name for a device or managed product that is translated to an internet protocol IP address through a domain name server domain ID Number 1 through 31 that uniquely identifies a switch in a multi switch fabric A distinct domain ID is automatically allocated to each switch in the fabric by the principal switch domain name service DNS See DNS name E D TOV See error detect time out value E_Port See expansion port embedded web server Administrators or operators with a browser capable PC and Internet connection can monitor and manage a director or switch through an embedded web server interface The interface provides a GUI similar to Product Manager applications and supports director and switch configuration statistics monitoring and basic operation error detect time out value E_D_TOV User specified value that defines the time a director or switch waits for an expected response before declaring an error condition Glossary 4 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary Ethernet A
40. atistics along with a wrap count for each corresponding counter Port The port number RxFrames The number of Fibre Channel Class 3 frames that the port has received TxFrames The number of Fibre Channel Class 3 frames that the port has transmitted RxWords The number of Class 3 4 byte words within frames that the port has received TxWords The number of Class 3 4 byte words within frames that the port has transmitted Disc Frames The number of Class 3 frames that have been discarded upon receipt by this port There are no FBSYs Fabric Busy link response or FRJTs Frame Reject link response generated for Class 3 frames Output Example The output from the perf class3 command displays as follows Port 2 Statistic Count Wrap CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 55 CLI Commands RxFrames 2953184 23 TxFrames 1842953 12 RxWords 2953184 65 TxWords 1842953 32 Disc Frames 2953184 26 Syntax clearStats portNumber Purpose This command resets all port statistics for an individual port or for all ports Parameters This command has one parameter portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 all for every port on the director or switch Command Example Root gt perf clearStats 4 Root gt perf clearStats all 2 56 CLI reference guide for director 2 64 ed
41. ays as follows Port 2 Statistic Count Prim Seq Err 753452 Disc Frms 351269 Inv Tx Wrds 2953184 CRC Errs 1842953 Delim Errs 2953184 Addr Id Errs 1842953 Syntax link portNumber Purpose This command displays port link counters for a single ports Parameters This command has one parameter portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 2 58 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Command Example Root gt perf link 2 Output The port link counter data is displayed as a table that includes the following statistics Port The port number OLS In The number of offline sequences initiated by the attached N_ Port OLS Out The number of offline sequences initiated by this director or switch port Reset In The number of link resets initiated by the attached N_ Port Reset Out The number of link resets initiated by this director or switch Link Flrs The number of times the port has detected a link error resulting from an invalid link state transition or timeout Sync Losses The number of times the port has detected a loss of synchronization timeout while not in an offline or LF2 state Sig Losses The number of times the port has detected a loss of signal while not in an offline or LF2 state Output Example The output from the perf link command displa
42. b sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec SpeedCap Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec Gb sec CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 71 CLI Commands Syntax status Purpose This command displays port status for all ports Parameters This command has no parameters Command Example Root gt show port status Output The port status data is displayed as a table that includes the following properties Port The port number State The port state For example Segmented E Port Invalid Attachment Not Installed e Online e Offline e Not Operational No Light e Testing e Port Failure e Link Reset Inactive 2 72 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Type The operational port type If the configured port type is F_Port or E_Port this value will match the configured type If the configured type is G_Port this value can be E_Port F_ Port or G_Port depending on what is connected to the port Attached WWN The world wide name of the device or switch attached to the port if one is attached Beaconing The beaconing state for the port true or false Reason An optional message number that indicates if the port has a segmented ISL or if a port binding v
43. btain certain information 1 12 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Introduction If the question mark is used in place of a command keyword all the keywords at that level of the CLI command tree display Root gt config system Command identified contact Set the date Set the description Set the location Set the name Set the show Display for that command display Root gt config port name system contact attribute system date and time system description attribute system location attribute system name attribute the system configuration If the question mark is used at the end of a recognized command any parameters name lt portNumber gt lt portName gt If the question mark is used after keywords at that level of the CLI Root gt config s security snmp switch system Commenting Scripts one or more characters of a keyword any command tree display The pound sign can be used to add comments in a script file The pound sign must be the first character in the line the CLI ignores everything after the pound sign in that line The following lines are valid Root gt Change port 3 to an Root gt config port lt CR gt config port gt HHH HHH EHHH EHHH config port gt Begin Scrip E_Port lt CR gt EEHH lt CR gt t lt CR gt config port gt HEFHEEEHEEEEEE lt CR gt The pound sign cannot be used after any other char
44. ccept the request Action Check that all the parameters are correct and reenter the command If problems persist contact your service representative Error 208 Change Request Timed Out Description The authorization time allowed to make NV RAM changes has expired Action Check that all the parameters are correct and reenter the command If problems persist contact your service representative Error 209 Change Request Aborted Description The switch did not accept the request Action Check that all the parameters are correct and reenter the command If problems persist contact your service representative CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 21 Error Messages Error 210 Busy Processing Another Request Description A different switch in the fabric was busy processing another request and could not complete the command Action Check that all the parameters are correct and reenter the command If problems persist contact your service representative Error 211 Duplicate Zone Description The entered command tried to add a zone name that already exists in the local zone set Action All zone names must be unique Delete or rename the zone with the duplicate name before reentering the command or change the name of the new zone and reenter the command Error 212 Duplicate Zone Member Description The entered command tried to add a member that alre
45. ce The numbers in this field correspond to the list at the bottom of the table Output Example The output from the show nameServer command displays as follows Type Port Id Port Name Node Name COS FC4 Types N 010400 00 11 22 33 44 55 66 77 33 44 55 66 77 2 3 2 N 010500 00 11 22 33 44 55 66 78 33 44 55 66 78 2 3 0 N 010600 00 11 22 33 44 55 66 79 33 44 55 66 79 2 3 2 N 010700 00 11 22 33 44 55 66 80 33 44 55 66 80 2 2 N 010800 00 11 22 33 44 55 66 81 33 44 55 66 81 3 2 N 010900 00 11 22 33 44 55 66 82 33 44 55 66 82 3 2 N 010C00 00 11 22 33 44 55 66 83 33 44 55 66 83 2 3 2 N 010D00 00 11 22 33 44 55 66 84 33 44 55 66 84 2 3 2 N 010E00 00 11 22 33 44 55 66 85 33 44 55 66 85 2 5 N 010F00 00 11 22 33 44 55 66 86 33 44 55 66 86 2 4 N 011200 00 11 22 33 44 55 66 87 33 44 55 66 87 2 3 2 N 011300 00 11 22 33 44 55 66 88 33 44 55 66 88 2 3 2 FC4 Types ISO IEC 8802 2 LLC ISO IEC 8802 2 LLC SNAP 0 1 2 SCSI FCP 3 SCSI GPP 4 IPI 3 Master 5 IPI 3 Slave 6 IPI 3 Peer 7 CP IPI 3 Master 8 CP IPI 3 Slave 9 CP IPI 3 Peer 10 SBCCS Channel 11 SBCCS Control Unit 12 FC SB 2 Channel to Control Unit 13 FC SB 2 Control Unit to Channel 14 Fibre Channel Service 2 68 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands 17 FC AL 18 SNMP 19 HIPPI FP 20 Vendor Unique Syntax config Purpose This command shows the port confi
46. ching products and as a launching point for Product Manager applications The application runs locally on the HAFM server or on a remote workstation high availability fabric manager HAFM server Notebook computer shipped with a director or switch that runs the HAFM and Product Manager applications HAFM application See high availability fabric manager application HAFM server See high availability fabric manager server hardware log Record of FRU insertions and removals for a director or switch HBA See host bus adapter Glossary 6 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary heterogeneous fabric A fabric with both HP and non HP products high availability A performance feature characterized by hardware component redundancy and hot swapability enabling non disruptive maintenance High availability systems maximize system uptime while providing superior reliability availability and serviceability hop Data transfer from one fabric node to another node homogeneous fabric A fabric consisting of only HP products hop count The number of hops a unit of information traverses in a fabric host bus adapter HBA Logic card that provides a link between the server and storage subsystem and that integrates the operating systems and I O protocols to ensure interoperability hot swapping Removing and replacing a device s components while the device continues to operate
47. command displays port information for all ports Parameters This command has no parameters Command Example Root gt show port info 2 70 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Output The port information data is displayed as a table that includes the following properties Port WWN OpSpeed SpeedCap The port number The world wide name of the port The current operating speed 1 0625 Gbps 2 125 Gbps or Not Established The current transceiver capability speed 1 0625 or 2 125 Gbps Output Example The output from the show port info command displays as follows Port WWN oO 0 J HD HO FF U NEO IL f I f I H H H H H H H H H H H H H H H H O MO OA FO UD HO E e O OIDO O O E e E O oF U N e O 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 80 80 80 80 80 80 80 80 80 80 80 1 80 1 80 1 80 1 80 1 80 1 00 01 02 03 04 05 06 07 08 09 Oo e W N be PPP PP RP RP PP RP BP BP BP Pp Rp H H H i j H i H H A i i H A i H ERRE 1 22 1 22 2222 L222 L322 1 22 sedans 1 22 1 22 1 22 1 22 1 22 13 22 E 1 22 33 4 33 4 33 44 33 44 33 4 33 4 33 44 33 44 33 44 33 4 33 44 33 44 33 4 33 4 33 44 33 44 OpSpeed RRERPRRRPDNDNNDNNDNONO PRP PO PR Gb sec Gb sec Gb sec Gb sec G
48. commands that set parameter values These values are not temporary session values but are retained across power cycles The commands in the config branch can by used only by the administrator Note that the config zoning commands function in a different way from the other CLI commands which are single action commands that take effect immediately A zoning configuration is typically too complicated to be described by a single command so the CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 1 CLI Commands first zoning command entered invokes a work area editor The commands take effect on a temporary copy of a zone set in the work area until the temporary copy in the work area is activated to the fabric or is discarded Because not all the verification of the zone set can occur on the temporary copy in the work area it is possible however unlikely that the copy of the zone set encounters no errors until the zone set is activated to the fabric Syntax installKey featureKey Purpose This command allows the user to install a feature set that is enabled by the provided feature key Description The switch must be offline to install a feature key After the key is installed you must IPL the switch the connection to the CLI will be lost at this time and must be re established Parameters This command has one parameter featureKey Specifies the key you have received to enable an opt
49. e 4 Online gPort 10 00 80 00 11 22 33 57 false 5 Port Failure fPort 10 00 80 00 11 22 33 46 false 6 Link Reset gPort 10 00 80 00 11 22 33 63 false 7 Segmented E_Port ePort 10 00 80 00 11 22 33 47 false 2 8 Online ePort 10 00 80 00 11 22 33 88 false 9 Offline fPort 10 00 80 00 11 22 33 49 false 10 Inactive ePort 10 00 80 00 11 22 33 50 false 3 11 Online fPort 10 00 80 00 11 22 33 53 false 12 No Light fPort 10 00 80 00 11 22 33 56 false 13 Online fPort 10 00 80 00 11 22 33 59 false 14 Invalid Attachment fPort 10 00 80 00 11 22 33 64 false 7 15 Online fPort 10 00 80 00 11 22 33 66 false 2 Duplicate Domain ID s 3 Switch Speed Conflict 7 ISL connection not allowed on this port 2 74 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax technology Purpose This command displays port technology information for all ports Parameters This command has no parameters Command Example Root gt show port technology Output The port technology data is displayed as a table that includes the following properties Port The port number Connectr The port connector type LC MT_RJ MU Internal Transcvr The transceiver type Long LC Short Short OFC Long LL Long Dist Distance The distances supported Short Intermediate Long Very Long CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 75 CLI Commands Media The m
50. e ee Te A a Deo he ate Pa a ae ene 2 10 confie Port Show vir aes eat ore oe ada a E eo ee 2 11 config security portBinding 00 cece eee eens 2 12 config security portBinding bound 0 0 0c cee eee 2 12 config security portBinding Wwn 0 0 c cece teenies 2 13 config security portBinding ShOW 0 ooooooooororoomorooomoo 2 15 config security userRights 0 0 cece eee eens 2 16 config security userRights administrator u s asuessaan urarea 2 16 config security userRights operator 0 0 eee eee 2 17 config security userRights show 0 ooooooooooomormommmmooo 2 18 config snmp addCommunity 0 0 ccc eee eee 2 19 config snmp authTraps 0 0 ccc cet tenes 2 20 config snmp deleteCommunity 00 cece eee eee 2 21 Config snmp Show rse sry ean kOe oe ns Slew a Sea ia 2 21 config switch COMMANOS ooooooooco cece teen ee eens 2 22 config switch bbCredit o oooooooooooorrrorarr teen ene 2 23 config Witch TOV ree enie en a eel Wb ea eae 2 23 config switch interopMode ooooooocooocorr tenes 2 24 config switch prefDomainId 0 0 0 0 teenies 2 25 config SWItCh pTIOTItY o ooooooooooorrrrr teen ene 2 25 config switch raTOV neo e i a a t eee eens 2 26 config switch rerouteDelay 0 0 ect tteeeeeee 2 27 config switch speed ji bf dank died A 2 28 config switch show ennei os aana e ete teen eens 2 29 iv CLI reference guide for director 2 64 edg
51. e eee eee A 22 Error 211 Duplicate Zone saui enemi asana See da A 22 Error 212 Duplicate Zone Member 0 0 c eee eee eee A 22 Error 213 Number of Zones Is Zero 1 eens A 23 Error 214 A Zone Contains Zero Members 00000 eee eee A 23 Error 215 Zone Set Size Exceeded 0 eens A 23 Error 218 Invalid Port Number 0 0 0 00 eens A 24 Error 219 Invalid Port Type 2 0 0 cee ees A 24 Error 222 Invalid SNMP Community Index 0 0 00 cece eee A 25 Error 223 Unknown Erro btt dani A 25 Error 224 Invalid Argument 0 0c ccc eee cece eee teen eens A 25 Error 225 Argument Does Not Contain All USASCII Characters A 26 Error 226 Argument Is Too Long 2 0 0 eee eee A 26 Error 227 Invalid SNMP Community Name 0 00 00 e eee eee A 26 Error 228 Invalid Write Authorization Argument 00005 A 27 Error 229 Invalid UDP Port Number 0 00 c cece ees A 27 Error 230 Invalid WWN 0 ene n eee e eens A 27 Error 231 Invalid Port Number 0 0 0 0 00 cece eee es A 28 Error 232 Invalid Domain ID 0 1 tees A 28 Error 233 Invalid Member 0 0 0 ccc e ee ES A 28 Error 234 Invalid Command 1 0 0 0 ccc cee eens A 29 Error 235 Unrecognized Command 000 cece eee A 29 Error 236 Ambiguous Command 0 0 0 e cece cee eee ees A 30 Error 237 Invalid Zoning Database 0 0 0 0 ees A 30 Error 238 Inva
52. e for director 2 64 edge switch 2 16 and edge switch 2 32 2 9 CLI Commands Syntax type portNumber portType Purpose This command sets the allowed type for a port Description A port can be configured as an F Port an E Port ora G Port If a port is configured as an F_ Port that port cannot be used as an interswitch link but may attach to a device with an N_Port Ifa port is configured as an E_Port only other switches may attach to that port If a port is configured as a G_Port either a device or another switch may attach Parameters This command has two required parameters portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 portType Specifies the type of the port Valid values are eport fport and gport Command Example Root gt config port type 4 fport 2 10 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax show portNumber Purpose This command displays the port configuration for a single port Description This show command on the config port branch displays the current configuration for the specified port Parameters This command has one parameter portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 Command Example Root gt config port show 4 O
53. e switch 2 16 and edge switch 2 32 Contents config system contact 0 0 ccc eee een n enn ene 2 31 config system date 2 i6 awe Desai Pt iio ni 2 31 config system description 0 0 ccc cece tenn enna 2 32 config system location 2 0 0 0 ccc cee ee rr 2 33 config system amerre 5 6 oes ae ee as ee Ba ee Le tee ee 2 33 config system HOW is sites auai sanii a a dae dio dla 2 34 config zoning Commands 0 ooo 2 35 config zoning setDefZoneState oooooooooooorororrrr nen 2 35 config zoning activateZoneSet o ooooooooorrroro eens 2 36 config zoning deactivateZoneSet 0 6 eee eens 2 37 config zoning replaceZoneSet 0 cette eens 2 37 config zoning clearZoneSet 0 c ccc eee nen nee 2 38 config zoning addZone 6 eee nee eens 2 38 config zoning deleteZone siapa ee e ei ana iea e rr 2 39 config zoning renameZoneSet 0 eee eens 240 config zoning addWwnMem 00 cece eect n eens 2 41 config zoning addPortMem 0 ccc ccc tenets 2 42 config zoning clearZone 0 ccc eee eee n eens 2 43 config zoning deleteWwnmem 00 cece cece enn eee 2 43 config zoning deletePortMem 2 2 cee eee eens 2 44 config zoning renameZone 6 ooo n eens 2 45 config zoning showPending 0 cece eee ene tenes 246 config zoning showACtive 0 cece eee ee eee nen e ens 2 47 maint Commands sias 0s 8 bee bk da aaa ados 2 48 m int port DEACON ek ge wad
54. e switch 2 32 CLI Commands Syntax clearZone zoneName Purpose This command clears all zone members for the specified zone in the work area Description This command does not change the zone name Parameters This command has one parameter zoneName Specifies the name of the zone to be cleared Command Example Root gt config zoning clearZone TheNotUltimateAtAllZone Syntax deleteWwnMem zoneName wwn Purpose This command removes a WWN member from a zone that is in the work area Parameters This command has two parameters zoneName Specifies the name of the zone that contains the member to be deleted CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 43 CLI Commands wwn Specifies the world wide name of the member to be deleted from the zone The value of the WWN must be in colon delimited hexidecimal notation For example AA 00 AA 00 AA 00 AA 00 Command Example Root gt config zoning deleteWwnMem TheNotSoUltimateZone 10 00 00 00 C9 22 9B AB Syntax deletePortMem zoneName domainId portNumber Purpose This command deletes a domain ID and port number for a zone member in the specified zone in the work area Parameters This command has three parameters zoneName domainId portNumber Specifies the name of the zone that contains the member to be deleted Specifies the domain ID of the member that to be deleted from t
55. e true Action Configure the interoperability mode as Homogenous Fabric in the previous series of commands Error 88 Invalid Feature Key Length Description The value of the specified feature key is longer than the maximum length allowed Action Refer to config features installkey on page 2 2 for requirements and reenter the feature key If problems persist contact your sales representative Error 89 Operational Mode 390 Description This procedure is not allowed in S 390 mode Action The entered command is only supported when the product is in Open Systems mode The product cannot be taken out of S 390 mode through the CLI Use the HAFM application to change the product operating mode and then reenter the command A 16 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 90 Invalid Port Type Description The configured port type is invalid Action The port may be configured as an E_Port G_Port or F_Port Reconfigure the port and then resubmit the command Error 91 E_Port Type Configured Description Ports cannot be configured as E_Ports in S 390 mode Action Reconfigure the port as either an F_Port or a G_Port and then resubmit the command Error 92 Not Allowed While Port Is Unblocked Description The port must be blocked to complete this request Action Block the port and then resubmit the command CLI reference guide
56. eState 1 perf Commands The perf branch of the CLI command tree contains commands that relate to performance services The commands in the perf branch can by used by either the administrator or the operator 2 52 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Note that the counters in perf command output are 32 bit values that wrap at 4 294 967 296 To calculate the full value of a counter multiply 4 294 967 296 by the value in the wrap field and add the resulting product to the value in the count field For example if a TxFrames statistic has a count value of 1842953 and a wrap value of 12 the full value of the counter is 4 294 967 296 x 12 1842953 51 541 450 505 Syntax class2 portNumber Purpose This command displays port Class 2 counters for a single port Parameters This command has one parameter portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 031 for the edge switch 2 32 0 63 for the director 2 64 Command Example Root gt perf class2 2 Output The port Class 2 counter data is displayed as a table that includes the following statistics along with a wrap count for each corresponding counter Port The port number RxFrames The number of Fibre Channel Class 2 frames that the port has received CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 53 CLI Commands TxFra
57. ecimal format for example 10 0 0 0 Enter the IP address for the Ethernet interface in dotted decimal format CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 5 Error Messages Error 31 Invalid Subnet Mask Description The value entered for the new subnet mask for the Ethernet interface is invalid Action The subnet mask must be entered in dotted decimal format for example 255 0 0 0 Enter the subnet mask for the Ethernet interface in dotted decimal format Error 32 Invalid SNMP Community Name Description The value entered for the SNMP community name is invalid Action The SNMP community name is the name of the community specified in the config snmp addCommunity command The community name must not exceed 32 characters Valid characters include all those in the ISO Latin 1 character set Duplicate community names are allowed but the corresponding writeAuthorization values must match Enter an SNMP community name that meets all of the requirements Error 33 Invalid SNMP Trap Address Description The value entered for the SNMP trap address is invalid Action The new SNMP trap address for the SNMP interface must be entered in dotted decimal format for example 10 0 0 0 Enter an SNMP trap address that meets the requirements A 6 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 34 Duplicate Community Names Requi
58. ed for information transfer Fibre Channel password Unique string of characters known to the computer system and to a user who must specify it to gain full or limited access to a system and to the information stored within it persistent binding A form of server level access control that uses configuration information to bind a server to a specific Fibre Channel storage volume or logical device using a unit number Glossary 10 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary port Receptacle on a device to which a cable leading to another device can be attached port card Field replaceable hardware component that provides the port connections for fiber cables and performs specific device dependent logic functions port card map Map showing numbers assigned to each port card by card slot port name Name that the user assigns to a particular port through the Product Manager POST See power on self test power on self test POST Series of self tests executed each time the unit is booted or reset preferred domain ID Domain ID that a director or switch is assigned by the principal switch in a switched fabric The preferred domain ID becomes the active domain ID except when configured otherwise by the user principal switch The director or switch that allocates domain IDs to itself and to all other switches in a fabric There is always one principal switch in a fabric If a switch
59. edia type e M M 62 5um e M M 50um M M 50 e 62 5um e S M9um e Copper Output Example The output from the show port technology command displays as follows Port Connectr Transcvr Distance Media 0 LC Long LC song M M 50um 1 LC Long LC Ong M M 50um 2 LC Long LC Ong M M 50um 3 MT_RJ Long LC Ong M M 50um 4 MT_RJ Long LC song M M 50um 5 MT_RJ Long LC Ong M M 50um 6 LC Long LC song M M 50um 7 LC Long LC Ong M M 50um 8 LC Long LC song M M 50um 9 LC Long LC song M M 50um 10 LC Long LC Ong M M 50um TL LC Long LC Ong M M 50um 12 LC Long LC Ong M M 50um 13 LC Long LC Ong M M 50um 14 LC Long LC Ong M M 50um 15 LC Long LC Ong M M 50um 2 76 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax portBinding Purpose This command shows the port binding configuration for all ports Parameters This command has no parameters Command Example Root gt show security portBinding Output The port binding configuration data is displayed as a table that includes the following properties Port The port number WWN Binding The state of port binding for the specified port e active inactive Bound WWN The WWN of the device that is bound to the specified port If this field is blank no device is bound to the specified port Output Example The output from the show secur
60. er accepts calls from the HAFM server logs reported events and can notify one or more support center representatives Class F Fibre Channel service Used by switches to communicate across interswitch links ISLs to configure control and coordinate a multi switch fabric Class 2 Fibre Channel service Provides a connectionless not dedicated service with notification of delivery or nondelivery between two N_Ports In order delivery of frames is not guaranteed Class 3 Fibre Channel service Provides a connectionless not dedicated service without notification of delivery or nondelivery between two N_Ports Also known as datagram Glossary 2 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary community profile Information that specifies which management objects are available to what management domain or SNMP community name concurrent maintenance Ability to perform maintenance tasks such as removal or replacement of field replaceable units FRUs while normal operations continue without interruption See also nondisruptive maintenance configuration data Configuration data includes identification data port configuration data operating parameters SNMP configuration and zoning configuration A configuration backup file is required to restore configuration data if the control processor CTP card in a nonredundant director is removed and replaced connectionless Nondedicated link Typ
61. f that data at the switch s outgoing F_Port to the destination N_Port The amount of time it takes for data transmission to pass through a switching device LIN See link incident link incident LIN Interruption to a Fibre Channel link due to loss of light or other cause logical unit number LUN In Fibre Channel addressing a logical unit number is a number assigned to a storage device which in combination with the storage device s node port s world wide name represents a unique identifier for a logical device on a storage area network loopback plug In a fiber optic environment a type of duplex connector used to wrap the optical output signal of a device directly to the optical input loopback test Test that checks attachment or control unit circuitry without checking the mechanism itself by returning the output of the mechanism as input LUN See logical unit number MAC address See Media Access Control address Glossary 8 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary maintenance port Connector on the director or switch where a PC running an ASCH terminal emulator can be attached or dial up connection made for specialized maintenance support managed product Hardware product that can be managed with the HAFM application For example the director 2 64 is a managed product See also device management information base MIB Related set of software objects va
62. fies a managed product on a transmission control protocol internet protocol TCP IP network The network address can be either an IP address in dotted decimal notation containing four three digit octets in the format xxx xxx xxx xxx or a domain name as administered on a customer network nickname Alternate name assigned to a world wide name for a node director or switch in a fabric node In Fibre Channel terminology node refers to an end device server or storage device that is or can be connected to a switched fabric node port N_Port Physical interface within an end device which can connect to an F_Port on a switched fabric or directly to another N_ Port in point to point communications nondisruptive maintenance Ability to service FRUs including maintenance installation removal and replacement while normal operations continue without interruption See also concurrent maintenance N_Port See node port offline sequence OLS Sequence sent by the transmitting port to indicate that it is attempting to initialize a link and has detected a problem in doing so OLS See offline sequence optical cable Fiber multiple fibers or a fiber bundle in a structure built to meet optical mechanical and environmental specifications See also jumper cable optical cable assembly and trunk cable out of band management Transmission of management information using frequencies or channels Ethernet other than those routinely us
63. ge switch 2 16 and edge switch 2 32 CLI Commands Syntax errors portNumber Purpose This command displays port error counters for a single port Parameters This command has one parameter portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 Command Example Root gt perf errors 2 Output The port error counter data is displayed as a table that includes the following statistics Port Prim Seq Err Disc Frms Inv Tx Wrds The port number The number of state machine protocol errors detected by the port hardware The number of received frames discarded due to a frame size of less than size words or to frames dropped because the BB credit was zero This number is counted during the first round of frame verification and applies to both Class 2 and Class 3 traffic The number of 10 bit transmission words that the port is unable to map to 8 bit bytes because of disparity errors or misaligned K characters while in the OL2 or OL3 state CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 57 CLI Commands CRC Errs The number of frame CRC errors detected by the port Dlim Errs The number of invalid frame delimiters SOF or EOF received by the port Addr Id Errs The number of frames received with unknown addressing Output Example The output from the perf errors command displ
64. guration for all ports Parameters This command has no parameters Command Example Root gt show port config Output The port configuration attributes are displayed as a table that includes the following properties Port The port number Name The name of the port as set in the config port name command Blocked The blocked state of the port as set in the config port blocked command Ext Dist The extended distance state as set in the config port extDist command Type The port type as set in the config port type command Speed The port speed as set in the config port speed command CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 69 CLI Commands Output Example The output from the show port config command displays as follows Port Name Blocked Ext Dist Type Speed 0 Port 1 false false fPort 1 Gb sec 1 Port 2 true true fPort 1 Gb sec 2 Port 3 false false gPort 1 Gb sec 3 Port 4 false false fPort 2 Gb sec 4 Port 5 true true fPort 2 Gb sec 5 Port 6 false false fPort 2 Gb sec 6 Port 7 true true fPort 1 Gb sec 7 Port 8 false false fPort Negotiate 8 Port 9 false true fPort 1 Gb sec 9 Port A false false fPort 1 Gb sec 10 Port B false false fPort 2 Gb sec 11 Port C false false fPort 2 Gb sec 12 Port D false false fPort 1 Gb sec 13 Port E false false fPort 1 Gb sec 14 Port F false false fPort 1 Gb sec 15 Port X false false fPort 1 Gb sec Syntax info Purpose This
65. he port name for the individual port can contain 0 24 characters Enter a name with 0 24 characters If spaces are used enclose the name in quotation marks Error 15 Invalid BB Credit Description The value entered for the buffer to buffer credit is invalid Action The buffer to buffer credit must be an integer in the range 1 60 Enter a value in the range 1 60 characters A buffer to buffer credit is not used for ports configured for extended distance Error 16 Invalid R_A_TOV Description The value entered for the resource allocation time out value is invalid Action The R_A_TOV is entered in tenths of a second and must be an integer in the range 10 1200 1 second to 120 seconds The R_A_TOV value must be larger than the E_D_TOV value Enter a value in the range 10 1200 that is larger than the E D TOV value CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 3 Error Messages Error 17 Invalid E_D_TOV Description The value entered for the error detect time out value is invalid Action The E_D_TOV is entered in tenths of a second and must be an integer in the range 2 600 0 2 second to 60 seconds The E D_TOV value must be smaller than the R_A_TOV value Enter a value in the range 2 600 that is smaller than the R A TOV value Error 18 Invalid TOV Description The values for the E D_TOV and R_A_TOV do not meet the requirement that the E_D_TOV value be smaller than the R_A_
66. he zone Valid domain IDs are in the range 131 Specifies the port number of the member to be deleted from the zone Valid port numbers values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 2 44 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Command Example Root gt config zoning deletePortMem TheUltimateZone 10 5 Syntax 29 66 renameZone oldZoneName newZoneName Purpose This command renames a zone in the work area Parameters This command has two parameters oldZoneName Specifies the current zone name of the zone to be renamed newZoneName Specifies the new zone name The newZoneName must contain 1 64 characters Valid characters are ABCDEFGHIJKLMNOPQRSTUVWXY Zabcde fehijklImnopqrstuvwxyz _ Spaces are not permitted and the first character must be alphabetical Command Example Root gt config zoning renameZone TheOldUltimateZone TheUltimateZone CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 45 CLI Commands Syntax showPending Purpose This command shows the zoning configuration in the work area of the zone set that has not yet been activated Parameters This command has no parameters Command Example Root gt config zoning showPending Output The zoning configuration data is displayed as a table that includes the following proper
67. her All connected devices may be configured into one or more zones Devices in the same zone can see each other Those devices that occupy different zones cannot zone member Specification of a device to be included in a zone A zone member can be identified by the port number of the director or switch to which it is attached or by its world wide name In multi switch fabrics identification of end devices nodes by world wide name is preferable zone set See zone Glossary 14 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary zoning Grouping of several devices by function or by location All devices connected to a connectivity product such as the director or switch may be configured into one or more zones See also zone CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary 15 Cc case sensitivity CLI commands 1 2 CLI commands case sensitivity 1 2 commaDelim 1 13 command tree 1 3 config features installKey 2 2 config features show 2 4 config ip ethernet 2 5 config ip show 2 6 config port blocked 2 7 config port extDist 2 8 config port name 2 9 config port show 2 12 config port speed 2 10 config port type 2 11 config security portBinding 2 14 config security portBinding bound 2 14 config security portBinding show 2 17 config security portBinding wwn 2 15 config security userRights 2 19 config security userRights administrator 2 19 config
68. hp Storage Works CLI reference guide for director 2 64 sa switch 2 16 and edge switch 2 32 Part Number A6534 96027 AA RQ7AB TE Second Edition August 2002 This guide covers the essentials of using a command line interface CLI to manage the Hewlett Packard HP StorageWorks director 2 64 hp StorageWorks edge switch 2 16 and hp StorageWorks edge switch 2 32 Also included are CLI commands syntax purpose and parameters O invent O Hewlett Packard Company 2002 All rights reserved Hewlett Packard Company makes no warranty of any kind with regard to this material including but not limited to the implied warranties of merchantab li and fitness for a particular purpose Hewlett Packard shali not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing performance or use of this material This document contains proprietary information which is protected by copyright No part of this ocument may be photocopied reproduced or iranelaled into another language without the prior written consent of Hewlett Packard The information contained in this document is subject to no without notice Microsoft MS DOS Windows and Windows NT are trademarks of Microsoft Corporation in the U S and or other countries All other product names mentioned herein may be trademarks of their respective companies Hewlett Packard Company shall not be liable for technical or editorial
69. ically used to describe a link between nodes which allows the switch to forward Class 2 or Class 3 frames as resources ports allow control processor CTP card Circuit card that contains the director microprocessor The CTP card also initializes hardware components of the system after power on A 10 Mbps RJ 45 twisted pair connector is located on the CTP card to connect to an Ethernet LAN and communicate with the HAFM server or a specific management station control unit A device that controls the reading writing or displaying of data at one or more input output units CRC See cyclic redundancy check CTP card See control processor card cyclic redundancy check CRC System of error checking performed at both the sending and receiving station using the value of a particular character generated by a cyclic algorithm When the values generated at each station are identical data integrity is confirmed DASD Acronym for direct access storage device datagram See Class 3 Fibre Channel service CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary 3 Glossary default zone Contains all attached devices that are not members of a separate zone destination identifier D_ID Address identifier that indicates the targeted destination of a data frame device Product server or storage connected to a managed director or switch that is not controlled directly by the Product Manager applic
70. ice 2 66 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Output Example The output from the show loginServer command displays as follows Port BB Crdt RxFldSz COS Port Name Node Name 0 10 2 3 00 11 22 33 44 55 00 77 20 11 22 33 44 55 66 77 1 10 2 00 11 22 33 44 55 00 78 20 11 22 33 44 55 66 78 4 10 2 3 00 11 22 33 44 55 00 79 20 11 22 33 44 55 66 79 7 10 2 3 00 11 22 33 44 55 00 80 20 11 22 33 44 55 66 80 8 10 2 00 11 22 33 44 55 00 81 20 11 22 33 44 55 66 81 10 10 2 3 00 11 22 33 44 55 00 82 20 11 22 33 44 55 66 82 11 10 2 3 00 11 22 133 44 55 00 83 20 11 22 33 44 55 66 83 12 10 3 00 11 13 0 2 3 00 15 0 2 3 00 11 Syntax nameServer Purpose This command displays information from the name server database for devices attached to this switch Parameters This command has no parameters Command Example Root gt show nameServer CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 67 CLI Commands Output The device information data is displayed as a table that includes the following properties Type The type N NL F NL F FL E B Port Id The 24 bit Fibre Channel address Port Name The port world wide name of the attached device Node Name The node world wide name of the attached device COS The class of service for example 1 2 3 4 5 6 F 1 2 2 3 FC4 Types The FC4 types registered for this devi
71. ime Serial Number Type Number Model Number EC Level The system name as set in the config system name command The system description as set in the config system description command The system contact as set in the config system contact command The system description as set in the config system description command The system date and time as set in the config system date command The serial number for the system The type number for the system The model number for the system for example director 2 64 The engineering change level installed Firmware Version The current firmware version installed 2 80 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Beaconing The enabled state of unit beaconing enabled or disabled as set in the maint system beacon command Output Example The output from the show system command displays as follows System Information Name hp3 director Description hp StorageWorks director 2 64 Contact Joe Location Everywhere Date Time 04 16 2001 10 34 01AM Serial Number 123456789 Type Number 1 Model Number director 2 64 EC Level 1 Firmware Version 01 03 00 34 Beaconing Disabled Syntax zoning Purpose This command shows the zoning configuration saved on the fabric Parameters This command has no parameters Command Example Root gt show zoning Output The zoning configuration data is displayed as a
72. ime Out Value This value is set in tenths of a second Error Detect Time Out Value This value is set in tenths of a second The preferred domain ID of the switch The switch priority Values are Principal Default or Never Principal The switch speed The rerouting delay that ensures that frames are delivered in order through the fabric to their destination Values are Enabled or Disabled Interoperability mode for the switch Output Example The output from the config switch show command displays as follows BB Credit 2 R_A_TOV 20 E_D_TOV 4 Preferred Domain Id 1 Switch Priority Principal Speed 2 Gb sec Rerouting Delay Enabled Interop Mode Open Fabric 1 0 2 30 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax contact systemContact Purpose This command sets the system contact attribute Parameters This command has one parameter systemContact Specifies the new system contact string for the director or switch The contact can contain 0 255 characters Command Example Root gt config system contact Joe Syntax date sysDate sysTime Purpose This command sets the system date and time CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 31 CLI Commands Parameters This command has two required parameters sysDate Specifies the new system date The format of the date
73. inId parameter is invalid For example the domainId parameter of the config switch prefDomainId command requires an integer in the range 1 31 Action Refer to Chapter 2 for information about the commands with the domainId parameter Specify a valid domain ID value and resubmit the command Error 233 Invalid Member Description The value specified for the zoneName parameter the name of the zone member is invalid A 28 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Action Refer to Chapter 2 for information about the commands with the zoneName parameter Specify a valid name for the zone member and resubmit the command Error 234 Invalid Command Description The CLI cannot associate an action with the submitted command The command may be misspelled required parameters may be missing or the request may not be applicable to the branch of the CLI tree from which it was submitted Action Refer to Chapter 2 for the correct command syntax and spelling Ensure that the command is spelled correctly and that all required parameters are included with the command Refer to Navigation of the CLI Command Tree on page 1 6 Ensure that the command has been entered at the right place in the CLI command tree and then resubmit the command Error 235 Unrecognized Command Description The CLI does not recognize the submitted command and cannot perform the help command as
74. ing eevee o beet ae tes pee Pee 2 48 MAINt POFTESCt iy ee ES eed ee A hae eed SIN oe es wa ee ee os 249 maty ste Deacon esr eaan a O AA A OA 2 50 maint system clearSysError 2 0 ete eens 2 50 MANE MP A ea a e eS 2 51 maint system resetConfig 0 cece teen eens 2 51 maint system setOnlineState 0 2 ee cee eee 2 52 perf Commands a dto ea ne eas 2 52 pericias Zola dd Stes ean dele vee Solio pt ih Blvd cis ei 2 53 pericias Vias did A A E iz 2 54 perticlear Static a ei ede A Si a teas 2 56 POLECITOTS A A cen Pt el taci n 2 57 perfil cial ia os 2 58 Perra a bios 2 60 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Contents show Commands os ii coke iG ATA A Rie ee 2 61 show evento go 1 20 Pee A Pea eae Peat sees 2 61 SHOW AUS o e Sees a thnk e Ghe yin dopants Gee ls 2 62 SOHO WID CthSIO ii a a ON Oe Re ace a eee 2 65 shOW OSI Vi A RO eae 2 66 SHOW name Serve sisses x slau etd ie ahs Baten dadas 2 67 show port config 2 0 0 ccc cece teen enn nee n ees 2 69 SHOW POKiniton ss A A ge aca ae ek ela 2 70 show port Status cerere vice Sad Bare eee ch ee ee sce Ps ce ee 2 72 show port technology 0 ccc cece reae 2 75 show security portBinding 0 0 cece eee een ees 2 77 SHOWS Wicho a Bie aida nt he 2 78 SHOW SYStEM ey are Wid neds ware ahd Mast ea hat eG rk eae ae te 2 80 SHOW ZONING did 2 81 A Error Messages Error 08 Invalid Switch Name oooooc
75. ing wwn command If no WWN has been configured no devices can log in to that port false sets the port binding to inactive Any device is free to connect to the specified port in this state regardless of the WWN setting Boolean and 0 may be substituted as values Command Examples Root gt config security portBinding bound 4 true Root gt config security portBinding bound 4 1 Syntax wwn portNumber boundWwn Purpose This command configures the single device WWN to which a port is bound Parameters This command has two parameters portNumber Specified the port number for which the bound WWN is being set Valid port number values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 13 CLI Commands boundWwn Specifies the WWN of the device that is being bound to the specified port The value must be entered in colon delimited hexidecimal notation for example 11 22 33 44 55 66 AA BB If the boundWwn is configured and the portBindState is Active only the device described by boundWwn will be able to connect to the specified port Inactive the WWN is retained but any device can connect to the specified port Instead of the WWN either of two values can be entered in this parameter attached automatically configures the currently attached device WWN as the bound WWN
76. iolation has occurred or if the part is inactive The message description for this message number is provided at the bottom of the table State is Segmented E_Port 0 Segment Not Defined 1 Incompatible Operating Parameters 2 Duplicate Domain ID s 3 Incompatible Zoning Configurations 4 Build Fabric Protocol Error 5 No Principal Switch 6 No Response from Attached Switch 7 ELP Retransmission Failure Timeout State is Invalid Attachment 0 Unknown 1 ISL connection not allowed on this port 2 ELP rejected by the attached switch 3 Incompatible switch at other end of the ISL 4 External loopback adapter connected to the port 5 N_Port connection not allowed on this port 6 Non HP switch at other end of the ISL 7 ISL connection not allowed on this port 8 ISL connection not allowed to external Fabrics 9 Port binding violation unauthorized WWN CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 73 CLI Commands State is Inactive 0 Inactive RC 0 1 No Serial Number 2 Feature not enabled 3 Switch Speed Conflict 4 Optics Speed Conflict 5 No SBAR support Output Example The output from the show port status command displays as follows Port State Type Attached WWN Beaconing Reason 0 Online fPort 10 00 80 00 11 22 33 44 false 1 Online gPort 10 00 80 00 11 22 33 45 true 2 No Light fPort 10 00 80 00 11 22 33 55 true 3 Offline ePort 10 00 80 00 11 22 33 00 fals
77. ion of the zone set can occur on the temporary copy in the work area it is possible however unlikely that the copy of the zone set encounters no errors until the zone set is activated to the fabric Syntax setDefZoneState defaultZoneState Purpose This command enables or disables the default zone and takes effect immediately fabric wide Description This command takes effect immediately in the fabric CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 35 CLI Commands Parameters This command has one parameter defaultZoneState Specifies whether the default zone is enabled Valid values are true and false Boolean 1 and 0 may be substituted as values Command Examples Root gt config zoning setDefZoneState false Root gt config zoning setDefZoneState 0 Syntax activateZoneSet Purpose This command activates the zone set contained in the work area to the fabric and takes effect immediately Description This command takes effect immediately in the fabric Parameters This command has no parameters Command Example Root gt config zoning activateZoneSet 2 36 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax deactivateZoneSet Purpose This command places all attached devices in the default zone and takes effect immediately fabric wide Description The default zone must be activated independent
78. ional software feature on a specific product A feature key is a string of case sensitive alphanumeric ASCII characters The number of characters may vary in the format however the key must be entered exactly including the hyphens An example of a feature key format is XxXx XXxX xxXX xX Command Example Root gt config features installKey AaBb CCdD eeFF gH 2 2 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax show Purpose This command shows the product feature information configured for this switch Parameters This command has no parameters Command Example Root gt config features show Output The product feature data is displayed as a table that includes the following property Features The list of features supported for the feature key Output Example The output from the config ip show command displays as follows Features Open Systems Management Server 8 Flex Ports CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 3 CLI Commands Syntax ethernet ipAddress gatewayAddress subnetMask Purpose This command sets the Ethernet network settings Description The Telnet connection can be lost when these Ethernet network settings are changed If the IP address is reconfigured your Telnet client must be reconnected to the new IP address A new login will be requested Parameters This command has three
79. ipment or data IMPORTANT Text set off in this manner presents clarifying information or specific instructions NOTE Text set off in this manner presents commentary sidelights or interesting points of information CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 xi About This Guide Symbols on Equipment AAA Any enclosed surface or area of the equipment marked with these symbols indicates the presence of electrical shock hazards Enclosed area contains no operator serviceable parts WARNING To reduce the risk of injury from electrical shock hazards do not open this enclosure ANS Any RJ 45 receptacle marked with these symbols indicates a network interface connection WARNING To reduce the risk of electrical shock fire or damage to the equipment do not plug telephone or telecommunications connectors into this receptacle ANA Any surface or area of the equipment marked with these symbols indicates the presence of a hot surface or hot component Contact with this surface could result in injury WARNING To reduce the risk of injury from a hot component allow the surface to cool before touching ZN Power supplies or systems marked with these symbols indicate the presence of multiple sources of power STE ETD WARNING To reduce the risk of injury from electrical shock n N remove all power cords to completely disconnect power from the power supplies
80. itch Description Description The value entered for the switch description is invalid Action The description for the director or switch can contain 0 255 characters Enter a description with 0 255 characters If spaces are used enclose the description in quotation marks CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 1 Error Messages Error 10 Invalid Switch Location Description The value entered for the switch location is invalid Action The location for the director or switch can contain 0 255 characters Enter a location with 0 255 characters If spaces are used enclose the location in quotation marks Error 11 Invalid Switch Contact Description The value entered for the switch contact is invalid Action The contact for the director or switch can contain 0 255 characters Enter a contact with 0 255 characters If spaces are used enclose the contact in quotation marks Error 13 Invalid Port Number Description The value entered for the port number is invalid Action Enter a port number within the range supported by the director or switch Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 A 2 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 14 Invalid Port Name Description The value entered for the port name is invalid Action T
81. ity portBinding command displays as follows Port WWN Binding Bound WWN 0 Active AA 00 AA 00 AA 00 AA 00 1 Inactive 00 00 00 00 00 00 00 00 2 Inactive CC 33 44 55 CC 33 44 55 3 Active 00 00 00 00 00 00 00 00 4 Inactive 00 00 00 00 00 00 00 00 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 77 CLI Commands 5 Inactive 00 00 00 00 00 00 00 00 6 Inactive 00 00 00 00 00 00 00 00 7 Inactive 00 00 00 00 00 00 00 00 8 Inactive 00 00 00 00 00 00 00 00 9 Inactive 00 00 00 00 00 00 00 00 10 Inactive 00 00 00 00 00 00 00 00 11 Inactive 00 00 00 00 00 00 00 00 12 Inactive 00 00 00 00 00 00 00 00 13 Inactive 00 00 00 00 00 00 00 00 14 Inactive 00 00 00 00 00 00 00 00 15 Inactive 00 00 00 00 00 00 00 00 Syntax switch Purpose This command displays switch attributes Parameters This command has no parameters Command Example Root gt show switch Output The switch attributes data is displayed as a table that includes the following properties State The state of the switch For example online offline BB Credit The BB credit as set in the config switch bbCredit command R_A TOV The R_A_TOV as set in the config switch raTov command E D TOV The E_D_TOV as set in the config switch ed Tov command 2 78 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Preferred Domain The domain ID as set in the config switch domainId Id command
82. lid Feature Key 0 0 eee ees A 30 Glossary Index 1 Document Conventions o oooooooroorr eee nee ene nes XXV 1 1 CLI Command Tree Navigation Conventions 000 cee eens 1 2 1 2 GLI Command Tra ts A E bee Ree eee as 1 4 viii CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 About This Guide This reference guide provides information to use the command line interface CLI for the following Hewlett Packard HP products e hp StorageWorks director 2 64 e hp StorageWorks edge switch 2 16 e hp StorageWorks edge switch 2 32 e ha fabric manager HAFM application Intended Audience This publication is intended for data center administrators and customer support personnel who can enter CLI commands manually or write scripts The primary purpose of the CLI is for scripts written by these administrators and personnel for use in a host based scripting environment Therefore this publication presumes that the user is familiar with Establishing and using a Telnet session Using a terminal command line Networking SAN and zoning concepts HP products in the user s network Related Documentation In addition to this guide HP provides corresponding information e hp StorageWorks product in a SAN environment planning guide for director 2 64 edge switch 2 16 and edge switch 2 32 A6534 96025 AA RS2DA TE hp StorageWorks SNMP reference guide for director 2 64 edge s
83. ly of this command NOTE This command takes effect immediately in the fabric Parameters This command has no parameters Command Example Root gt config zoning deactiveZoneSet Syntax replaceZoneSet Purpose This command replaces the work area with the active zone set that is currently loaded on the fabric Parameters This command has no parameters Command Example Root gt config zoning replaceZoneSet CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 37 CLI Commands Syntax clearZoneSet Purpose This command clears the zone set contained in the work area removing all zones and takes effect immediately Description This command does not change the zone set name Parameters This command has no parameters Command Example Root gt config zoning clearZoneSet Syntax addZone zoneName Purpose This command adds a new empty zone to the zone set in the work area Description Changes are not activated on the switch until the config zoning activateZoneSet command is issued The CLI supports the number of zones per zone set specified for a given product 2 38 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Parameters This command has one parameter zoneName Specifies the name of the new zone The zoneName must contain 1 64 characters Valid characters are ABCDEFGHIJKLMNOPQRSTUVWXY Zabcdefghijklmn
84. mand Action Valid values for the writeAuthorization parameter are enabled and disabled Boolean 1 and 0 may be substituted as values Specify a supported value and resubmit the command Error 229 Invalid UDP Port Number Description The udpPortNum parameter of the config snmp addCommunity command does not contain a valid value Action Valid values for the udpPortNum parameter are decimal numbers the default value is 162 Valid values include all legal user datagram protocol UDP port numbers Specify a valid UDP port number and resubmit the command Error 230 Invalid WWN Description The WWN parameter does not contain a valid value For example the WWN parameter of the config zoning addWwnMem or config zoning deleteWwnMem command does not contain a value in the correct format CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 27 Error Messages Action The world wide name of the WWN member must be in colon delimited hexadecimal notation Enter a valid WWN in the correct format for example AA 00 AA 00 AA 00 AA 00 and resubmit the command Error 231 Invalid Port Number Description The value specified for the portNumber parameter is invalid Action Refer to Chapter 2 for information about the commands with the portNumber parameter Specify a valid port number value and resubmit the command Error 232 Invalid Domain ID Description The value specified for the doma
85. mand adds a world wide name zone member to the specified zone in the work area Description The CLI supports the number of zones members per zone specified for a given product Parameters This command has two parameters zoneName Specifies the name of the zone wwn The world wide name of the member to be added to the zone The value of the WWN must be in colon delimited hexadecimal notation For example AA 00 AA 00 AA 00 AA 00 Command Example Root gt config zoning addWwnMem TheUltimateZone 10 00 00 00 C9 22 9B 64 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 41 CLI Commands Syntax addPortMem zoneName domainId portNumber Purpose This command adds the domain ID and port number of a zone member to the specified zone in the work area Description The CLI supports the number of zones members per zone specified for a given product Parameters This command has one parameter zoneName Specifies the name of the zone domainId Specifies the domain ID of the member to be added to the zone Valid values are in the range 1 31 portNumber Specifies the port number of the member to be added to the zone Valid port number values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 Command Example Root gt config zoning addPortMem TheUltimateZone 10 6 2 42 CLI reference guide for director 2 64 edge switch 2 16 and edg
86. mes The number of Fibre Channel Class 2 frames that the port has transmitted RxWords The number of Class 2 4 byte words within frames that the port has received Tx Words The number of Class 2 4 byte words within frames that the port has transmitted Busied Frms The number of times that FBSY Fabric Busy link response was returned to this port as a result of a Class 2 frame that could not be delivered to the other end of the link This occurs if either the fabric or the destination port is temporarily busy Rjct Frames The number of times that FRJT Frame Reject link response was returned to this port as the result of a Class 2 frame that was rejected by the fabric Output Example The output from the perf class2 command displays as follows Port 2 Statistic Count Wrap RxFrames 2953184 23 TxFrames 1842953 12 RxWords 2943184 65 TxWords 1842953 32 Busied Frms 2953184 0 Rjct Frames 1842953 0 Syntax class3 portNumber Purpose This command displays port Class 3 counters for a single ports 2 54 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Parameters This command has one parameter portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 Command Example Root gt perf class3 2 Output The port Class 3 counter data is displayed as a table that includes the following st
87. ministrator The username for administrator privileges Username 2 18 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Administrator The password for administrator privileges Password Output Example The output from the config security userRights show command displays as follows Operator Username Operator Operator Password xxKKKK KK Administrator Username Administrator Administrator Password kkekKK KK Syntax addCommunity commIndex commName writeAuthorization trapRecipient udpPortNum Purpose This command adds an SNMP community to the SNMP configuration Parameters This command has five parameters Up to six community names and trap recipients may be defined commindex Specifies the community to be created or edited Valid values are integers in the range 1 6 commName Specifies the community name of the community specified by commIndex The community name must not exceed 32 characters in length Valid characters include all those in the ISO Latin 1 character set Duplicate community names are allowed but the corresponding writeAuthorization values must match writeAuthorization Specifies the write authorization state of the community Valid values are enabled and disabled Boolean 1 and 0 may be substituted as values CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 19 CLI Commands trapRecipient S
88. must contain 1 64 characters Valid characters are ABCDEFGHIJKLMNOPQRSTUVWXY ZabcdefghijklImnopqrstuvwxyz0123456789 _ spaces are not permitted and the first character must be alphabetical Enter a zone name in the range of 1 64 characters using the valid characters Error 57 Duplicate Zone Description Two or more zone names in the zone set are identical Action All zone names within a zone set must be unique Enter a zone name that does not duplicate the name of another zone within the zone set Error 59 Zone Name in Use Description Two or more zone names in the zone set are identical Action All zone names within a zone set must be unique Enter a zone name that does not duplicate the name of another zone within the zone set Error 60 Invalid Number of Zone Members Description The entered command tried to add more zone members than the zone can hold A 10 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Action Delete one or more zone members in the zone and then resubmit the command to add the new zone member Error 61 Invalid Zone Member Type Description The specified zone member is neither a world wide name WWN nor a domain port pair Action The zone member type must be either a world wide name WWN or a domain port pair Refer to config zoning addWwnMem on page 2 41 or config zoning addPortMem on page 2 42 for specific requirements Ente
89. n of the CLI Command Tree on page 1 6 Even though commands cannot be entered with periods command line prompts do include periods as shown below Config Port gt Navigation Conventions Basic command line navigation conventions are supported The following table includes asynchronous commands recognized by the CLI Table 1 4 CLI Command Tree Navigation Conventions Character Common Sequence Name Action or Description lt CR gt Carriage Pass a completed line to the parser Return lt DEL gt Delete Backspace one character and delete the character lt NL gt New Line Pass a completed line to the parser lt SP gt Space Used to separate keywords Pound Sign Used to designate comments in a script Question Mark Provide help information Quotation Mark Used to surround a single token A Control A Position the cursor to the start of the line B Control B Position the cursor left one character 1 2 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Introduction Table 1 4 CLI Command Tree Navigation Conventions Continued Character Common Sequence Name Action or Description D Control D Delete the current character NE Control E Position the cursor to the end of the line aF Control F Position the cursor right one character H Control H Backspace one character and delete the character
90. normally hub In Fibre Channel a device that connects nodes into a logical loop by using a physical star topology IML See initial machine load initial machine load IML Hardware reset for a director or switch initiated by pushing the button on a director CTP card or switch bezel initial program load IPL Process of initializing the device and causing the operating system to start Initiated through a menu in the Product Manager this option performs a hardware reset on the active CTP only internet protocol address Unique string of numbers in the format xxx xxx xxx xxx that identifies a device on a network interoperability Ability to communicate execute programs or transfer data between various functional units over a network CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary 7 Glossary interswitch link ISL Physical E_Port connection between two directors or switches in a fabric IP address See internet protocol address IPL See initial program load ISL See interswitch link jumper cable Optical cable that provides physical attachment between two devices or between a device and a distribution panel Contrast with trunk cable latency When used in reference to a Fibre Channel switching device latency refers to the amount of time elapsed between receipt of a data transmission at a switch s incoming F_Port from the originating node port to retransmission o
91. oneMember 10 00 00 00 10 00 00 00 10 00 00 00 09 C9 Zone TheNotUltimateAtAllZone Domain 2 Port ZoneMember 63 22 22 222 PAA 222 63 U dad CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 47 CLI Commands maint Commands The maint branch of the CLI command tree contains commands that relate to maintenance activities The commands in the maint branch can be used only by the administrator Note that the maint system resetConfig command resets all configuration data and non volatile settings including network information to their default values factory settings Management access may be lost until the network information is restored Syntax beacon portNumber beaconState Purpose This command enables or disables port beaconing for a port Parameters This command has two required parameters portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 031 for the edge switch 2 32 0 63 for the director 2 64 beaconState Specifies whether unit beaconing is enabled Valid values are true and false Boolean 1 and 0 may be substituted as values Command Examples Root gt maint port beacon 4 false Root gt maint port beacon 4 0 2 48 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax reset portNumber Purpose This command resets a port
92. ooocococor eens A 1 Error 09 Invalid Switch Descripti0N ooooooooooorororrrro o A 1 Error 10 Invalid Switch Location 0 00 00 cece eee eens A 2 Error 11 Invalid Switch Contact 00 0 A 2 Error 13 Invalid Port Number 0 0 0 0 000 anaana A 2 Error 14 Invalid Port Name ooooooooocrcrcrr eens A 3 Error 15 Invalid BB Credit ooooooooocoorororo rr A 3 Error 16 Invalid R A TOV 0 nanna a ccc n nee A 3 Error 17s Invalid E D TOV orto teint ae Deseo awh A 4 Error 18 Invalid TOV sce cies a Hei ee BLE EE a ees Ue EE UE a ees A 4 Error 20 Invalid Preferred Domain ID 0 0 c cece eee A 4 Error 21 Invalid Switch Priority 0 0 0 0 ccc cette eee A 5 Error 29 Invalid Gateway Address 00 ce cece cette eens A 5 Error 30 Invalid IP Address 0 0 00 cece ccc cette eee eee A 5 Error 31 Invalid Subnet Mask nnou ett A 6 Error 32 Invalid SNMP Community Name 02 0 0 c eee eee eee A 6 Error 33 Invalid SNMP Trap Address 0 000 cece cece teens A 6 Error 34 Duplicate Community Names Require Identical Write Authorization A 7 Error 37 Invalid Month 0 00 e teen eee A 7 Error 38 Invalid Day isch gue ees eked whe ee wee Bec ee Re eS A 7 Error 392 Invalid Year iii Barked Pa wove don BE dey oe Ra A 8 Error 40 Invalid Hour 0 cece eect nent ene ne tenes A 8 vi CLI reference guide for director 2 64 edge switch 2 16 and edge s
93. opqrs tuvwxyz0123456789 Spaces are not permitted and the first character must be alphabetical Command Example Root gt config zoning addZone TheUltimateZone Syntax deleteZone zoneName Purpose This command deletes a zone from the zone set in the work area Description Changes are not activated on the switch until the config zoning activeZoneSet command is issued Parameters This command has one parameter zoneName Specifies the name of the zone to be deleted Command Example Root gt config zoning deleteZone TheLeastUltimateZone CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 39 CLI Commands Syntax renameZoneSet zoneSetName Purpose This command changes the name of the zone set in the work area Description Changes are not activated on the switch until the config zoning activateZoneSet command is issued Parameters This command has one parameter zoneSetName Specifies the new name for the zone set The zoneSetName must contain 1 64 characters Valid characters are ABCDEFGHIJKLMNOPQRSTUVWXY Zabcdefghijklmnopqrs tuvwxyz0123456789 2_ Spaces are not permitted and the first character must be alphabetical Command Example Root gt config zoning renameZoneSet TheUltimateZoneSet 2 40 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax addWwnMem zoneName wwn Purpose This com
94. parameter must be mm dd yyyy or mm dd yyyy Valid date values include e mm 1 12 e dd 1 31 e yyyy gt 1980 sysTime Specifies the new system time The format of the time parameter must be hh mm ss Valid time values include e hh 0 23 mm 0 59 e ss 0 59 Command Examples Root gt config system date 04 16 2001 10 34 01 Root gt config system date 10 09 2001 14 07 55 Syntax description systemDescription Purpose This command sets the system description string 2 32 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Parameters This command has one parameter systemDescription Specifies the new system description string for the director or switch The name can contain 0 255 characters Command Example Root gt config system description hp StorageWorks director 2 64 Syntax location systemLocation Purpose This command sets the system location attribute Parameters This command has one parameter systemLocation Specifies the new system location for the director or switch The location can contain 0 255 characters Command Example Root gt config system location Everywhere Syntax name systemName CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 33 CLI Commands Purpose This command sets the system name attribute Parameters This command has one required parameter sys
95. parameters ipAddress Specifies the new IP address for the director 2 64 edge switch 2 16 or edge switch 2 32 The address must be entered in dotted decimal format for example 10 0 0 0 gatewayAddress Specifies the new gateway address for the Ethernet interface The address must be entered in dotted decimal format for example 0 0 0 0 subnetMask Specifies the new subnet mask for the Ethernet interface The address must be entered in dotted decimal format for example 255 0 0 0 Command Example Root gt config ip ethernet 10 0 0 0 0 0 0 0 255 0 0 0 2 4 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax show Purpose This command shows the LAN configuration Parameters This command has no parameters Command Example Root gt config ip show Output The LAN configuration data is displayed as a table that includes the following properties IP Address The IP address Gateway Address The gateway address Subnet Mask The subnet mask Output Example The output from the config ip show command displays as follows IP Address 10 0 0 0 Gateway Address 0 0 0 0 Subnet Mask 255 0 0 0 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 5 CLI Commands al Syntax blocked portNumber blockedState Purpose This command sets the blocked state for a port Parameters This command has two required paramete
96. parameters portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 portName Specifies the name for the port The port name must not exceed 24 characters in length Command Example Root gt config port name 4 HP Tape Drive 2 8 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax speed portNumber portSpeed Purpose This command sets the speed for a port Description A port can be configured to operate at 1 0625 Gbps 2 125 Gbps or a negotiated speed The port speed can be set only to 1 0625 Gbps if the switch speed is 1 0625 Gbps An attempt to set the port speed to 2 125 Gbps or to negotiate in a switch with a 1 0625 Gbps switch speed results in an error message If the port speed is set to negotiate the port and the device to which it is attached negotiate the data speed setting to either 1 0625 or 2 125 Gbps NOTE Port speed changes temporarily disrupt port data transfers Parameters This command has two required parameters portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 portSpeed Specifies the speed of the port Valid values are 1g 2g and negotiate Command Examples Root gt config port speed 4 2g Root gt config port speed 6 negotiate CLI reference guid
97. pecified port If this field is blank no device has been bound to the specified port CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 15 CLI Commands Output Example The output from the config security portBinding show command displays as follows Port Number 4 WWN Binding Active Bound WWN AA 99 23 23 08 14 88 C1 Syntax 99 66 administrator username password Purpose This command sets the name and password for administrator level access Description Immediately after the name and password for the administrator is set you will be prompted to log in with the new access rights Parameters This command has two parameters username Specifies the new user name for administrator level login Default is set to Administrator This parameter is 1 15 characters Valid characters include all characters in the USASCI character set excluding control characters and spaces Spaces are not valid even though quotation marks are used 2 16 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands password Specifies the password for administrator level login Default is set to password This parameter is 1 15 characters Valid characters include all characters in the USASCI character set excluding control characters and spaces Spaces are not valid even though quotation marks are used Command Example Root gt config secu
98. pecifies the trap recipient Values must be 4 bytes in dotted decimal format udpPortNum Specifies the user datagram protocol UDP port number to which the director will send traps for each recipient The value must be a decimal number the default value is 162 Valid values include all legal UDP port numbers Command Example Root gt config snmp addCommunity 1 CommunityNamel enabled 123 123 123 123 162 Syntax authTraps enabledState Purpose This command enables or disables the authorization traps to be sent to SNMP management stations when unauthorized stations try to access SNMP information from the director or switch Parameters This command has one parameter enabledState Specifies whether the authorization traps are enabled Valid values are true and false Boolean 1 and 0 may be substituted as values Command Examples Root gt config snmp authTraps true Root gt config snmp authTraps 1 2 20 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax deleteCommunity commIndex Purpose This command entirely deletes a community from the SNMP Parameters This command has one parameter commIndex Specifies the community to be deleted Valid values are integers in the range 1 6 This value was set in the commIndex parameter of the config snmp addCommunity command Valid values are integers in the range 1 6 Command Example Root gt config
99. r in the range 0 23 Enter a time including an hour in the range 0 23 Error 41 Invalid Minute Description The value of the minute entered for the new system time is invalid Action The format of the time parameter must be hh mm ss The minute must contain an integer in the range 0 59 Enter a time including minutes in the range 0 59 A 8 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Error Messages Error 42 Invalid Second Description The value of the second entered for the new system time is invalid Action The format of the time parameter must be hh mm ss The second must contain an integer in the range 0 59 Enter a time including seconds in the range 0 59 Error 44 Max SNMP Communities Defined Description A new SNMP community cannot be defined before removing an existing community from the list Action A total of six communities may be defined for SNMP Remove at least one of the current communities and then define the new community Error 45 Not Allowed While Switch Online Description The entered command requires that the director or switch be set offline Action Set the director or switch offline before reentering the command Error 55 Invalid Zone Name Description The value entered for the zone name is invalid CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 9 Error Messages Action The zone name
100. r either a WWN or domain port pair that meets the requirements Error 62 Invalid Zone Set Name Description The value entered for the zone set name is invalid Action The zone set name must contain 1 64 characters Valid characters are ABCDEFGHIJKLMNOPQRSTUVWXY ZabcdefghijklImnopqrstuvwxyz0123456789 spaces are not permitted and the first character must be alphabetical Enter a zone set name in the range of 1 64 characters using the valid characters Error 69 Duplicate Port Name Description Two or more port names are identical CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 11 Error Messages Action Port names must be unique The name must contain 1 24 characters Enter a port name in the range of 1 24 characters Error 70 Invalid Device Type Description The specified FRU does not exist on this product Action Refer to the product service manual for product specific FRU information Error 71 FRU Not Installed Description The specified FRU is not installed Action Refer to the product service manual for product specific FRU information and procedures Error 72 No Backup FRU Description The FRU cannot be swapped because a backup FRU is not installed Action Refer to the product service manual for product specific FRU information and procedures Insert a backup FRU and reenter the command A 12 CLI reference guide for director 2 64 edge s
101. re Identical Write Authorization Description The two or more entered community names are identical but their corresponding write authorizations are not identical Action Enter different values for the community names or enter identical write authorizations for the duplicate community names Error 37 Invalid Month Description The value of the month entered for the new system date is invalid Action The format of the date parameter must be mm dd yyyy or mm dd yyyy The month must contain an integer in the range 1 12 Enter a date including a month in the range 1 12 Error 38 Invalid Day Description The value of the day entered for the new system date is invalid Action The format of the date parameter must be mm dd yyyy or mm dd yyyy The day must contain an integer in the range 1 31 Enter a date including a day in the range 1 31 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 7 Error Messages Error 39 Invalid Year Description The value of the year entered for the new system date is invalid Action The format of the date parameter must be mm dd yyyy or mm dd yyyy The year must contain an integer greater than 1980 Enter a date including a year greater than 1980 Error 40 Invalid Hour Description The value of the hour entered for the new system time is invalid Action The format of the time parameter must be hh mm ss The hour must contain an intege
102. riables containing information about a managed device and accessed via SNMP from a network management station Management Services application Software application that provides back end product independent services to the HAFM application Management Services runs only on the HAFM server and cannot be downloaded to remote workstations management session A management session exists when a user logs on to the HAFM application The application can support multiple concurrent management sessions The user must specify the network address of the HAFM server at logon time Media Access Control MAC address Hardware address of a node device connected to a network MIB See management information base multicast Delivery of a single transmission to multiple destination N_Ports Can be one to many or many to many All members of the group are identified by one IP address See also broadcast multi switch fabric Fibre Channel fabric created by linking more than one director or switch in a fabric name server Program that translates names from one form into another For example the domain name service DNS translates domain names into IP addresses name server zoning N_Port access management that allows N_Ports to communicate if and only if they belong to a common name server zone CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Glossary 9 Glossary network address Name or address that identi
103. rity userRights administrator Administrator newpassword Syntax 99 ce operator username password Purpose This command sets the name and password for operator level access Parameters This command has two parameters username Specifies the new user name for operator level login Default is Operator This parameter is 1 15 characters Valid characters include all characters in the USASCHO character set excluding control characters and spaces Spaces are not valid even though quotation marks are used CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 17 CLI Commands password Specifies the password for operator level login Default is password This parameter is 1 15 characters Valid characters include all characters in the USASCI character set excluding control characters and spaces Spaces are not valid even though quotation marks are used Command Example Root gt config security userRights operator Operator newpassword Syntax show Purpose This command shows the user rights for the CLl access levels Parameters This command has no parameters Command Example Root gt config security userRights show Output The user rights configuration data is displayed as a table that includes the following properties Operator Username The username for operator privileges Operator Password The password for operator privileges Ad
104. rs portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 blockedState Specifies the blocked state for the port Valid values are true and false Boolean 1 and 0 may be substituted as values Command Examples Root gt config port blocked 4 false Root gt config port blocked 4 0 2 6 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax extDist portNumber extDistOn Purpose This command sets the extended distance state for a port Description When the extended distance field is true the port is configured for 60 buffer credits which supports a distance of up to 100 km for a 2 125 gigabit per second Gbps port Parameters This command has two required parameters portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 extDistOn Specifies the extended distance state for the port Valid values are true and false Boolean 1 and 0 may be substituted as values Command Examples Root gt config port extDist 4 false Root gt config port extDist 4 0 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 7 CLI Commands Syntax name portNumber portName Purpose This command sets the name for a port Parameters This command has two required
105. s 1 8 perf class2 2 67 perf class3 2 69 perf clearStats 2 71 perf errors 2 72 perf link 2 74 perf traffic 2 76 show eventLog 2 78 show frus 2 80 show ip ethernet 2 82 show login server 2 83 show nameServer 2 85 show port config 2 87 show port info 2 89 show port status 2 91 show port technology 2 94 show security portBinding 2 96 show switch 2 98 show system 2 100 show zoning 2 102 command line interface command overview 2 1 command tree 1 3 handling errors 1 14 help 1 14 logging in or out 1 9 output 1 9 overview 1 1 parameters 1 8 purpose 1 1 Telnet session 1 16 user access rights 1 9 command tree 1 3 movement limitations 1 8 navigation 1 6 commands config 2 1 config maint 2 60 config perf 2 66 config show 2 78 config switch 2 27 config zoning 2 44 config commands 2 1 config maint commands 2 60 config perf commands 2 66 config show commands 2 78 config switch commands 2 27 config zoning commands 2 44 conventions documentation 1 2 navigation 1 2 D documentation conventions 1 2 E entering CLI commands 1 2 error messages A 1 H help 1 14 L logging in 1 9 logging out 1 9 N navigation conventions 1 2 null strings 1 9 T Telnet client session 1 16 U user access rights 1 9 Index 2 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32
106. s command sets the speed for the switch Description The switch must be set offline before this command is entered A switch can be configured to operate at 1 0625 or 2 125 Gbps 2 28 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands If the switch has fibre port module FPM cards configuring the switch speed to 2 125 Gbps makes all the ports on the FPM cards inactive and their operational state will be set to inactive FPM ports do not support 2 125 Gbps and therefore will remain inactive after the switch is returned to the online state Parameters This command has one required parameter switchSpeed Specifies the speed of the switch Valid values are 7g for 1 Gbps or 2g for 2 Gbps Command Examples Root gt config switch speed 2g Syntax show Purpose This command shows the switch configuration Parameters This command has no parameters Command Example Root gt config switch show CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 29 CLI Commands Output The switch configuration data is displayed as a table that includes the following properties BB Credit R_A TOV E D TOV Preferred Domain Id Switch Priority Speed Rerouting Delay Interop Mode The maximum number of outstanding frames that can be transmitted without causing a buffer overrun condition at the receiver Resource Allocation T
107. s data is displayed as a table that includes the following properties IP Address The IP address for the Ethernet adapter as set in the config ip ethernet command Gateway Address The gateway address for the Ethernet adapter as set in the config ip ethernet command Subnet Mask The subnet mask for the Ethernet adapter as set in the config ip ethernet command Output Example The output from the show ip ethernet command displays as follows LAN Information IP Address 144 49 10 15 Gateway Address 144 49 10 1 Subnet Mask 255525542050 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 65 CLI Commands Syntax loginServer Purpose This command displays information from the login server database for devices attached to this switch Parameters This command has no parameters Command Example Root gt show loginServer Output The device information is displayed as a table that includes the following properties Port The port number where the device is attached BB Crdt The maximum number of remaining frames that can be transmitted without causing a buffer overrun condition at the receiver RxFldSz The buffer to buffer receive data field size from the FLOGI received from the attached N_Port COS The class of service for example 1 2 3 4 5 6 F 1 2 2 3 Port Name The port world wide name of the attached device Node Name The node world wide name of the attached dev
108. security userRights administrator command or through the config security userRights operator command The access rights chosen for the CLI are completely independent of the other product interfaces for example SNMP or Hewlett Packard HP product interfaces Parameters This command has no parameters Command Examples login Username Administrator Password password login Username Operator Password password Syntax logout 1 10 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Introduction Purpose This command allows a Telnet client to disconnect from a director or switch Description This command logs out the single Telnet client connected to a director or switch This command can be entered at any point in the command tree Parameters This command has no parameters Command Examples Root gt logout Config gt logout Config Port gt logout NOTE The output examples shown in the other sections of this publication presume that commaDelim is off Syntax commaDelim enable Purpose This command enables the user to obtain displayed information from a show command in comma delimited rather than tabular format Tabular format is the default Description This command can be entered at any point in the command tree Parameter This command has one parameter enable CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 1
109. security userRights operator 2 20 config security userRights show 2 21 config samp addCommunity 2 22 config snmp authTraps 2 23 config snmp show 2 25 config switch bbCredit 2 27 config switch edTOV 2 28 config switch interopMode 2 29 config switch prefDomainId 2 30 Index config switch priority 2 31 config switch raTOV 2 33 config switch rerouteDelay 2 34 config switch show 2 36 config system contact 2 38 config system date 2 39 config system description 2 40 config system location 2 41 config system name 2 42 config system show 2 43 config zoning activateZoneSet 2 45 config zoning addPortMem 2 53 config zoning addWwnMem 2 52 config zoning addZone 2 49 config zoning clearZone 2 54 config zoning clearZoneSet 2 48 config zoning deactivateZoneSet 2 46 config zoning deletePortMem 2 56 config zoning delete WwnMem 2 55 config zoning deleteZone 2 50 config zoning renameZone 2 57 config zoning renameZoneSet 2 51 config zoning replaceZoneSet 2 47 config zoning setDefZoneState 2 44 config zoning showActive 2 59 config zoning showPending 2 58 handling errors 1 14 logging in or out 1 9 login 1 10 logout 1 12 maint port beacon 2 60 maint port reset 2 61 maint system beacon 2 62 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 Index 1 Index maint system clearSysError 2 63 maint system ipi 2 64 maint system resetConfig 2 65 maint system setOnlineState 2 66 output 1 9 overview 2 1 parameter
110. snmp deleteCommunity 5 Syntax show Purpose This command shows the switch SNMP configuration Parameters This command has no parameters Command Example Root gt config snmp show CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 21 CLI Commands Output The switch configuration data is displayed as a table that includes the following properties Authorization The state of the authorization traps for example enabled Traps that will be sent to SNMP management stations when unauthorized stations attempt to access SNMP information from the switch Index The community index number Community Name The name of the community writeAuth The write authorization state Trap Recipient The address of the trap recipient UDP Port The user datagram protocol UDP port number to which the director will send traps for each recipient Output Example The output from the config snmp show command displays as follows Authorization Traps Index Community Name 1 CommunityNamel 2 CommunityName2 3 CommunityName3 4 public 5 6 config switch Commands WriteAuth Trap Recipient UDP Port Enabled 123 123 123 123 162 Enabled 10 25 25 10 Disabled 132 44 85 224 Enabled 144 162 162 All of the config switch commands except for the config switch show command require that the switch be set offline Use the maint system setOnlineState to set the switch offline If these commands
111. t Session 1 14 Command Line Interface Overview The CLI is a feature that provides director 2 64 edge switch 2 16 or edge switch 2 32 management capabilities The CLI can only be used through a Telnet client session in an out of band management environment using the Ethernet port in the director or switch The purpose of the CLI is to automate management of a large number of directors and switches through scripts Although the primary use of the CLI is in host based scripting environments CLI commands can also be entered directly at a command line Any hardware platform that supports the Telnet client software can be used Because the CLI is not an interactive interface no prompts are displayed to guide the user through a task If an interactive interface is needed the ha fabric manager HAFM application or embedded web server EWS application should be used instead of the CLI CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 1 1 Introduction Entering Command Line Interface Commands CLI commands can be entered directly at the command line of a workstation or coded in a script CLI commands are not case sensitive Documentation Conventions Throughout this publication periods are used to separate components of a command name However periods cannot be included when the command is actually entered at a workstation or coded in a script How to enter commands is explained in Navigatio
112. tation to a device running an SNMP agent will only elicit a response if those queries are addressed with the correct SNMP community name storage area network SAN A high performance data communications environment that interconnects computing and storage resources so that the resources can be effectively shared and consolidated subnet mask Used by a computer to determine whether another computer with which it needs to communicate is located on a local or remote network The network mask depends upon the class of networks to which the computer is connecting The mask indicates which digits to look at in a longer network address and allows the router to avoid handling the entire address switch An intelligent but nonredundant low port count Fibre Channel switching device providing any to any port connectivity between nodes end devices in a switched fabric Switches send data frames between nodes in accordance with the address information present in the frame headers of those transmissions switchover Changing a backup FRU to the active state and the active FRU to the backup state TCP IP See transmission control protocol internet protocol topology Logical and or physical arrangement of stations on a network transmission control protocol internet protocol TCP IP A suite of communication protocols used to connect host systems to the Internet See also network address trap Unsolicited notification of an event originating from
113. temName Specifies the new system name for the director or switch The name can contain 0 24 characters Command Example Root gt config system name hp edge switch 2 16 Syntax show Purpose This command shows the system configuration Parameters This command has no parameters Command Example Root gt config system show Output The system configuration is displayed as a table that includes the following properties Name The system name Description The system description Contact The system contact 2 34 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Location The system location Date Time The system date and time Output Examples The output from the config system show command displays as follows Name hp director Description hp StorageWorks director 2 64 Contact Joe Location Everywhere Date Time 04 16 2001 10 34 01 config zoning Commands Note that the config zoning commands function in a different way from the other CLI commands which are single action commands that take effect immediately A zoning configuration is typically too complicated to be described by a single command so the first zoning command entered invokes a work area editor The commands take effect on a temporary copy of a zone set in the work area until the temporary copy in the work area is activated to the fabric or is discarded Because not all the verificat
114. the Telnet session will continue e Wait 15 minutes for the client connection times out then replace the Ethernet cable and restart the connection e Ifthe client connection has already timed out replace the Ethernet cable Open an EWS or HAFM application window Toggle the enabled state of the CLI thereby clearing the client connection Restart the client connection Once the client connection is reestablished verify your configuration s completeness and accuracy 1 14 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 CLI Commands This chapter describes command line interface CLI commands including their syntax purpose and parameters as well as examples of their usage and any output that they generate Section Page Command Overview 2 1 config Commands 2 1 config switch Commands 2 22 config zoning Commands 2 35 maint Commands 2 48 perf Commands 2 52 show Commands 2 61 Command Overview Most of the commands in this chapter are listed in alphabetical order to make them easy to locate Although the commands can be entered in any order depending on the results desired so long as the tree structure is followed the order used herein for the zoning commands follows a typical order of entry The various show commands are usually entered at the end of a group of other commands config Commands The config branch of the CLI command tree contains
115. ties Local ZoneSet The enabled status name and member zones of the zone set Output Example The output from the config zoning showPending command displays as follows Pending Zone Set Default Zone Enabled False ZoneSet TheNewUltimateZoneSet Zone TheNewUltimateZone ZoneMember Domain 10 Port 6 ZoneMember Domain 15 Port 2 Zone TheNewNotSoUltimateZone ZoneMember 10 00 00 00 C9 22 9B AB ZoneMember 10 00 00 00 C9 22 9B C6 ZoneMember 10 00 00 00 C9 22 9B AB Zone TheNewNotUltimateAtAllZone ZoneMember Domain 2 Port 63 2 46 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands Syntax showActive Purpose This command shows the zoning configuration saved on the fabric Parameters This command has no parameters Command Example Root gt config zoning showActive Output The zoning configuration data is displayed as a table that includes the following properties Active ZoneSet set Output Example The enabled status name and member zones of the zone The output from the config zoning showActive command displays as follows Active Zone Set Default Zone Enabled False ZoneSet TheUltimateZoneSet Zone TheUltimateZone ZoneMember ZoneMember ZoneMember ZoneMember ZoneMember Domain 10 Domain 15 Port 6 Port 2 Domain 2 Port 10 00 00 00 10 00 00 00 Zone TheNotSoUltimateZone ZoneMember ZoneMember Z
116. utput The port configuration is displayed as a table that includes the following properties Port Number The port number Name The port name Blocked The blocked state Valid values are true and false Extended Distance The extended distance configuration state Valid values are true and false Type The port type Valid values are F Port E Port and G Port CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 11 CLI Commands Speed The port speed Valid values are 7 Gb sec 2 Gb sec and Negotiate Output Example The output from the config port show command displays as follows Port Number 4 Name HP4 tape drive Blocked false Extended distance false Type F Port Speed 2 Gb sec Syntax bound portNumber portBindingState Purpose This command sets the port binding state for a given port Parameters This command has two parameters portNumber Specifies the port number for which the port binding state is being set Valid port number values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 2 12 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands portBindingState Specifies the port binding state as active or inactive Valid values are true and false true sets the port binding to active The specified port will be bound to the WWN configured with the config security portBind
117. website under support http thenew hp com country us eng support html CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 xiii About This Guide Be sure to have the following information available before calling e Technical support registration number if applicable e Product serial numbers e Product model names and numbers e Applicable error messages e Operating system type and revision level e Detailed specific questions HP Website The HP website has the latest information on this product as well as the latest drivers Access storage at http thenew hp com country us eng prodserv storage html From this website select the appropriate product or solution HP Authorized Reseller For the name of your nearest HP Authorized Reseller Inthe United States call 1 800 345 1518 In Canada call 1 800 263 5868 e Elsewhere see the HP website for locations and telephone numbers http thenew hp com xiv CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 1 Introduction This chapter introduces the command line interface CLI and describes the essentials for using CLI commands Section Page Command Line Interface Overview 1 1 Entering Command Line Interface 1 2 Commands Logging In and Logging Out 1 9 The commaDelim Command 1 11 Handling Command Line Interface Errors 1 12 Using the Command Line Interface Help 1 12 Telne
118. widely implemented local area network LAN protocol that uses a bus or star topology and serves as the basis for the IEEE 802 3 standard which specifies the physical and software layers Baseband LAN allows multiple station access to the transmission medium at will without prior coordination and which avoids or resolves contention Ethernet hub A customer supplied device used to LAN connect the HAFM server and managed directors or switches event code Error code that provides the operator with information concerning events that indicate degraded operation or failure of a director or switch event log Record of significant events that have occurred at the director or switch such as FRU failures degraded operation and port problems expansion port E_Port Physical interface on a Fibre Channel switch within a fabric that attaches to an expansion port E_Port on another Fibre Channel switch to form a multi switch fabric fabric Fibre Channel entity that interconnects node ports N_Ports_ and is capable of routing switching Fibre Channel frames using the destination ID information in the Fibre Channel frame header accompanying the frames fabric element An active director switch or node in a Fibre Channel switched fabric fabric port F_Port Physical interface on a director or switch that connects to an N_Port through a point to point full duplex connection failover Automatic and nondisruptive transition of functions from an
119. witch 2 16 and edge switch 2 32 A6534 96026 AA RO7BB TE CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 ix About This Guide e hp StorageWorks director 2 64 installation guide A6534 96110 AA RSNGA TE e hp StorageWorks director 2 64 service manual A6534 96022 AA RS2EA TE e hp StorageWorks director 2 64 product manager user guide A6534 96023 AA RS2FA TE hp StorageWorks director 2 64 release notes A6534 96111 AV RSNHA TE e hp StorageWorks m series rack mount kit installation instructions A6534 96028 AA ROZPB TE hp StorageWorks model A6534A AZ torque tool caution flyer A6534 96021 AA RT4LA TE e hp StorageWorks universal port module kit installation instructions A6574 96004 AA RSS2A TE hp StorageWorks HAFM server installation guide A6582 96001 AA RT4KA TE e hp StorageWorks ha fabric manager user guide A6534 96024 AA RS2CA TE hp StorageWorks ha fabric manager release notes A6575 96004 AV ROZJC TE hp StorageWorks edge switch 2 32 installation guide A7283 96001 AA RSTZA TE hp StorageWorks edge switch 2 32 service manual A7283 96002 AA RS2GA TE hp StorageWorks edge switch 2 32 product manager user guide A7283 96003 AA RS2HA TE hp StorageWorks edge switch 2 32 release notes A7283 96004 AV RSU0A TE e hp StorageWorks edge switch 2 32 flexport upgrade instructions A7290 96001 AA RS33A TE hp StorageWorks edge switch 2 16 installation guide A7284 96001 AA
120. witch 2 16 and edge switch 2 32 Error Messages Error 73 Port Not Installed Description The specified port is not installed on the product Action Refer to the product service manual for information about installing a port optic Error 74 Invalid Number of Zones Description The specified zone set contains less than one zone or more than the maximum number of zones allowed for this product Action The zone set must contain at least one zone Add or remove zones to stay within the required number of zones for this product Error 75 Invalid Zone Set Size Description The specified zone set exceeds the NV RAM limitations of the director or switch Action Reduce the size of the zone set to meet the NV RAM limitations of the product Reduce the number of zones in the zone set reduce the number of members in a zone or reduce the zone name lengths CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 A 13 Error Messages Error 76 Invalid Number of Unique Zone Members Description The specified zone contains more than the maximum number of zone members allowed per zone set for this product Action Reduce the number of members in the zone before reentering the command Error 77 Not Allowed While Port Is Failed Description The specified port is in a failed or inactive state or requires service Action Refer to the product service manual for the appropriate action
121. witch 2 32 Contents Error 41 Invalid Minute eee oae e e E teen enn A 8 Error 427 Invalid Second io taa it Me hae bees A 9 Error 44 Max SNMP Communities Defined 0 00 cece ee eee A 9 Error 45 Not Allowed While Switch Online 0 0 0 0 A 9 Error 55 Invalid Zone Name 2 0 0 ete ene eens A 9 Error 5 7 Duplicate Lo uno ada wn eel La tada A 10 Error 59 Zone Name in Use 1 eee eens A 10 Error 60 Invalid Number of Zone Members 0 0 00 cece eee ees A 10 Error 61 Invalid Zone Member Type 0 00 ccc cee ees A 11 Error 62 Invalid Zone Set Name 0 0 cece eens A 11 Error 69 Duplicate Port Name 0 0 ccc eee een ene A 11 Error 70 Invalid Device Type 0 0 0 0 cece ete Y A 12 Error 71 FRU Not Installed 2 0 0 tenes A 12 Error 72 No Backup FRU eds ak eh ks dd dd Behe A 12 Error 73 Port Not Installed ys oct ct eens Sa eats ee Ae SSR ARN ee ales A 13 Error 74 Invalid Number of Zones 0 0 0 0 cece eee neces A 13 Error 75 Invalid Zone Set Size teen eas A 13 Error 76 Invalid Number of Unique Zone Members 005 A 14 Error 77 Not Allowed While Port Is Failed o ooooooooomom o A 14 Error 78 System Error Light On 1 6 0 ees A 14 Error 79 FRU Failed ca Gece akira ot aide a hens aes Win soe ei a ates A 15 Error 81 Default Zone Enabled 0 0 00 teens A 15 Error 82 Invalid Interop Mode 2 0 0 cette eens A
122. xt branch as shown in Table 1 2 on page 1 4 For example to use the config port name command to configure the name for port 4 on the switch this series of commands is entered Root gt config Config gt port Config Port gt name 4 HP Tape Drive At this point to enter the maint port beacon command to set the beaconing state of port 4 the following series of commands is entered Config Port gt Config gt Root gt maint Maint gt port Maint Port gt beacon 4 true NOTE You must return all the way to the root of the tree to transition to another extended branch When traversing back to the root the name of each branch cannot be used Instead use the double dot command two periods to move back towards the root Only one double dot command may be entered at a time One approach to making the navigation more concise is to use the root command to jump directly to the root of the CLI command tree The previous example which shows stepping back to the root with the double dot command is simplified as follows Config Port gt root Root gt maint Maint gt port Maint Port gt beacon 4 true Another approach to making the navigation more concise is to use the complete command syntax from the Root gt prompt each time For example to issue the config port name command and then the maint port beacon command the commands are entered as follows Root gt config port name 4 HP Tape Drive Root gt maint port beacon 4 true
123. ys as follows Port 2 Statistic Count OLS In 753452 OLS Out 351269 Reset In 2953184 Reset Out 1842953 Link Flrs 2953184 Sync Losses 1842953 Sig Losses 35246 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 2 59 CLI Commands Syntax traffic portNumber Purpose This command displays port traffic counters for a single port Parameters This command has one parameter portNumber Specifies the port number Valid values are 0 15 for the edge switch 2 16 0 31 for the edge switch 2 32 0 63 for the director 2 64 Command Example Root gt perf traffic 2 Output The port traffic counter data is displayed as a table that includes the following statistics along with a wrap count for each corresponding counter Port The port number Rx The received link utilization percentage Tx The transmitted link utilization percentage RxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has received TxFrames The number of Fibre Channel Class 2 and Class 3 frames that the port has transmitted Rx Words The number of 4 byte words in Class 2 and Class 3 frames that the port has received 2 60 CLI reference guide for director 2 64 edge switch 2 16 and edge switch 2 32 CLI Commands TxWords The number of 4 byte words in Class 2 and Class 3 frames that the port has transmitted Output Example The output from the perf traffic command displays as
Download Pdf Manuals
Related Search
Related Contents
PONCEUSE A BANDE - CE Cetim Nantes Cisco Unified Com Mgr BE 7.X - Seat Licenses - 10 TDSH`BA 東芝H ー ロ安定器取扱説明書 保管用 Samsung MAXS950TH Manual de Usuario StarTech.com INSERTBLANK patch panel accessory Edelbrock 641570 Automobile Parts User Manual D05 - London School of Economics and Political Science Copyright © All rights reserved.
Failed to retrieve file