StorageTek StorageNet SCSI-3 User's Manual
Contents
1. The FCP LUN value format is described in Table 3 3 or the value is O The latter refers to the SESD on the local switch The FCP_CNTL value is set to 1 2 or 0 depending on whether READ DATA WRITE DATA or neither is involved in the command The FCP_CDB value contains the appropriate command descriptor The FCP_DL field contains a count of the maximum number of data bytes to be transferred to or from the target for the command FCP Transfer Ready Information Unit The FCP_XF ER_RDY Information Unit contains SCSI 3 data delivery service parameters required by the initiator and must be transmitted preceding each read or write FCP_DATA IU Note The SESD does not generate this optional Information Unit FCP Data Information Unit The FCP_DATA Information Unit transfers the actual data FCP Response Information Unit Table 3 4 shows the FCP_RSP that carries the response status and sense information associated with a particular FCP_CMND Table 3 4 FCP_RSP Format 8946121402 Byte Size Field Name Description 8 Reserved Reserved 4 FCP_STATUS Status of the linked previous request 4 FCP_RESID Residual Count 4 FCP SNS LEN Length of Sense Information FCP_SNS_ INFO 4 FCP RSP LEN Length of Response Information FCP_RSP_INFO m FCP RSP INFO FCP Response Information n FCP SNS INFO SCSI Sense Information 3 3 FCP and SES Commands Table 3 5 shows the FCP STATUS field format Table 3 5 FCP STA2. 8946121402 FCP and SES Commands If the page code is set to 83h the SESD will return codes shown in Table 3 21 Table 3 21 SESD Return Codes for 83h Byte Bit 7 6 5 4 3 2 1 0 0 Peripheral qualifier 0 Peripheral Device Type ODh 1 Page Code 83h Reserved Page length 32 Reserved 0 Code set 2 Reserved 0 Identifier type 1 Reserved 0 Identifier length 28 O NJ ono a AJ OJN Identifier Vendor Identification 8 bytes Product identification 16 bytes Product revision level 4 bytes See Table 3 17 35 Receive Diagnostic Results An SES Application Client sends a Receive Diagnostic Results command to return diagnostic or management data The FCP_CDB format is shown in Table 3 22 Table 3 22 Receive Diagnostic Results Command Format Byte Bit 7 6 5 4 3 2 1 0 0 Operation Code 1Ch 1 Reserved PCV 2 Page Code 3 4 Allocation Length 5 Control 0 A Page Code Valid PCV bit of zero indicates that the most recent Send Diagnostic command defines the data returned by this command A value of 1 indicates that the Page Code field defines the data to be returned for this command The page codes and formats are defined in the Switch Diagnostics Pages section 8946121402 3 13 FCP and SES Commands Report LUNs An SES Application Client sends Report LUNs command to obtain the number of logical units each is a switch
3. Enclosure Services The services that establishes indictors and controls for the proper operation and maintenance of devices within the enclosure Enclosure Services Device A SCSI device that monitors and controls enclosure services The switches imbedded port Initiator A SCSI device containing application clients that originate device service requests to be processed by the device servers 8946121402 A 1 A 2 Logical Unit A target resident entity that implements a device model and executes SCSI commands originated by an application client Logical Unit Number A device or element known by an enclosure that identifies it to the application client Redundancy The presence in an enclosure of one or more elements capable of automatically taking over the functions of a failed element SCSI Small Computer Systems Interface SCSI Device A device that is connected to a service delivery subsystem and supports the SCSI application protocol Target A SCSI device that receives SCSI commands and directs such commands to one or more logical units for execution 8946121402 Index A Application Client A 1 ASC Field 3 16 ASCQ Field 3 16 B Bit Page Code Valid 3 13 Byte A 1 C Code Additional Sense 3 16 Additional Sense Code Qualifier 3 16 Sense NO ADDITIONAL SENSE INFORMATION 3 14 Command FCP Data Information Unit 3 3 Information Unit 3 2 Response Information Unit 3 3 Transfer Ready Information Unit 3 3 Inqu
4. 2 or 3 Note The destination address in the PLOGI request must be set to FFFFFAh The FCP Process Login PRLI is not required by the SESD The format of an FCP Command FCP_CMND FCP Transfer Ready FCP_XFER_RDY FCP Data FCP DATA and FCP Response FCP RSP conforms to those defined in the SCSI 3 Fibre Channel Protocol FCP Revision 12 X3T10 269 working draft Table 3 2 gives a brief description of the FCP Information Unit Table 3 2 FCP Information Unit Descriptions FCP Information Unit FCP CMND FCP XFER RDY FCP DATA Description The Information Unit contains a SCSI Command to be executed or a task management request on a target The Information Unit indicates that the target is ready to perform the data transfer associated with a FCP_CMD The data associated with an I O operation FCP_RSP The Information Unit contains status and sense information FCP Command Information Unit Table 3 3 shows the FCP_CMND Information Unit IU that carries either a SCSI command to be executed or a task management request to be performed It contains the values and control fields defined in its payload 3 2 8946121402 Table 3 3 FCP CMND IU Format FCP Constructs Byte Size Field Name Description 8 FCP LUN Logical Unit Number 4 FCP CNTL 8 11 Control flags and bits for task execution management 16 FCP CDB 12 27 SCSI command descriptor block 4 FCP DL 28 31 Data Length
5. 48 51 9 ro swFCPortTxC2Frames 0 52 55 10 ro swFCPortTxC3Frames 0 56 59 11 ro swFCPortRxLCs 0 60 63 12 ro swFCPortRxMcasts 0 64 67 13 ro swFCPortTooManyRdys 0 68 71 14 ro swFCPortNoTxCredits 0 72 75 15 ro swFCPortRxEncInFrs 0 76 79 16 ro swFCPortRxCrcs 0 80 83 17 ro swFCPortRxTruncs 0 84 87 18 ro swFCPortRxTooLongs 0 88 91 19 ro swFCPortRxBadEofs 0 92 95 20 ro swFCPortRxEncOutFrs 0 96 99 21 ro swFCPortRxBadOs 0 100 103 22 ro swFCPortRxC3Discards 0 104 107 23 ro swFCPortMcastTimedouts 0 8946121402 3 9 FCP and SES Commands Table 3 14 Fibre Channel Port Table Page Format Continued Byte Bit Field 4 Access swFCPortTxMcasts 0 112 115 25 swFCPortLiplns 116 119 26 swFCPortLipOuts swFCPortLipLastAlpa swFCPortEntry swValidity swFCPortTxMcasts if applicable swFCPortLipLastAlpa i 7 Name Server Local Table Page If requested using the Send DiagnosticorReceive Diagnostic Result command the SESD returns the following response as shown in Table 3 15 Table 3 15 Format of Name Server Local Table Page Byte Bit Field 4 Access 7 6 5 4 3 2 1 0 0 na na Page Code 85h 1 na na Reserved 2 98 na na Page Length n 3 4 7 na na swNumEntries i Note that each entry consists of swValidity 0 field through f
6. 7 82h 8 83h 9 84h 10 85h Switch Page If requested using the Send DiagnosticorReceive Diagnostic Result command the SESD returns the response shown in Table 3 10 Table 3 10 Switch Page Format Byte Bit Field Access 7 6 5 4 3 2 1 0 0 na na Page Code 80h 2 98 Page Length 404 4 7 swValid 8 71 Current Date in ASCII text 72 135 Boot Date in ASCII text 136 199 Firmware Last Updated Date in ASCII text 200 263 FLASH Last Updated Date in ASCII text 264 327 Boot PROM Last Updated Date in ASCII text 328 391 Firmware Version Information in ASCII text 392 395 Switch Operational Status 396 399 Switch Administrative Status 400 403 Diagnostics_Result 404 407 Number of Sensors Note na is not available ro is read only and rw is read write 3 6 8946121402 FCP and SES Commands The field swvalid is bit mapped and indicates which subsequent fields within the page are valid The bit position for subsequent fields starts from 0 as indicated in the Field column of Table 3 10 For example if the fields Current Date Boot Date and Number of Sensors are valid it contains the hex value of 0003h Sensor Table Page If requested using the Send Diagnostic or Receive Diagnostic Result command the SESD returns the response shown in Table 3 11 Table 3 11 Sensor Table Page Format Byte Bit
7. Field Access 7 6 5 4 3 2 1 0 0 na na Page Code 81h 1 na na Reserved 2 98 na na Page Length n 3 4 7 na na swNumEntries specifies the number of entries received for bytes 8 91 if the number is 5 there are 5 complete outputs for byte 8 91 8 11 na ro swValidity 0 12 15 0 ro swSensorlndex 0 16 19 1 ro swSensorType 0 20 23 2 ro swSensorStatus 0 24 27 3 ro swSensorValue 0 28 91 4 ro swSensorlnfo 0 more instances of swSensorEntry swValidity swSensorlnfo if applicable n 64 n 1 4 ro swSensorlnfo i 1 Fabric Page If requested using the Send DiagnosticorReceive Diagnostic Result command the SESD returns the response shown in Table 3 12 Table 3 12 Format of Fabric Page sym rete aes 7 T 4 8 2 T8 0 Page Code 82h 1 Reserved 2 3 Page Length 20 4 7 swValid 8946121402 3 7 FCP and SES Commands Table 3 12 Format of Fabric Page Continued eveen reas Ames O 5 Ti T5 e T9 2 15 1 ro PrincipalSwitchFlag 16 19 N o NumberOflmmediateNeighbor 20 23 NumberOfFabricISL Entries Co o Neighborhood Table Page If requested using the Send DiagnosticorReceive Diagnostic Result command the SESD returns the response shown in Table 3 13 Table 3 13 Neighborhood Table Page Format Sem maur meme 7 e 8 s T5 Ta Ti E LES 0 na na Page Co
8. MChngr ACKREQ Addr32 Addr16 ved 1Bh 1Bh 0 Q 0 0 0 7 RelAdr WBus32 Wbus16 Sync Linked Trandis CmdQu VS 0 0 0 0 0 0 0 e 0 8 15 Vendor identification STORAGETEK 16 31 Product identification Switch 32 35 Product revision level v N m p where N is a single number designating the major release number m is a single number designating the minor release number and p is a single alpha character designating a patch There may be a space indicating there s no patch For example v1 5a 8946121402 3 11 FCP and SES Commands If the field EVPD is set to 1 then the value of the page code may be set to one of the codes shown in Table 3 18 Table 3 18 Page Codes 00h Supported vital product data pages 80h Unit Serial Number Page 83h Device Identification Page If the page code is set to 00h the SESD will return codes shown in Table 3 19 Table 3 19 SESD Return Codes for 00h Byte Bit 0 Peripheral qualifier 0 Peripheral Device Type ODh 1 Page Code 00h 2 Reserved 3 Page length 3 4 5 6 If the page code is set to 80h the SESD will return codes shown in Table 3 20 Table 3 20 SESD Return Codes for 80h Byte Bit 0 Peripheral qualifier 0 1 Page Code 80h 2 Reserved 3 Page length 24 4 Product Serial Number the switch World wide Name in ASCII string format E g 10 00 00 60 69 00 01 b4
9. SCSI command is discussed in detail the diagnostics pages are defined in Table 3 7 They are particularly relevant to two commands Receive Diagnostic Results and Send Diagnostics The switch SESD supports 7 diagnostics pages Table 3 7 Diagnostics Pages Page Code Description 00h Supported Diagnostics Pages 80h Switch Page 81h Sensor Table Page 82h Fabric Page 83h Neighborhood Table Page 84h Fibre Channel Port Table Page 85h Name Server Local Table Page Table 3 8 shows the page codes 80h through 85h which are vendor specific pages and are roughly mapped from the switch Management Information Base MIB Definition for v1 6a firmware Table 3 8 Switch MIB Groups Page Code Switch MIB Group 80h System Group variables 1 8 20 21 81h System Group Sensor Table 82h Fabric Group variables 1 2 and 8 83h Fabric Group Neighborhood Table 84h Fibre Channel Port Table 85h Name Server Local Table Supported Diagnostics Pages If requested using the Send DiagnosticorReceive Diagnostic Result command the SESD returns the response shown in Table 3 9 Table 3 9 Page Code 0 Format Supported Diagnostic Pages Byte Bit 7 6 5 4 3 2 1 0 0 Page Code 00h 1 Reserved 8946121402 3 5 FCP and SES Commands Table 3 9 Page Code 0 Format Supported Diagnostic Pages Continued 2 MSB 3 Page Length 7 LSB 4 00h 5 80h 6 81h
10. implementation of SES within the Fabric Note Currently the SES standard is in DRAFT status and is subject to change See Reference Documents for a pointer to the SES Standards Committee s web site SES Management SES is an in band mechanism for managing devices such as switches within a Fabric or other enclosures SES commands are used to manage and sense the operational status of the power supplies cooling devices displays indicators individual drives and other non SCSI elements installed in a switch enclosure The command set uses the SCSI sEND DIAGNOSTIC and RECEIVE DIAGNOSTIC RESULTS commands to obtain set configuration information from the switch SES allows a SCSI entity or initiator to communicate with a switch through a standard Fiber Channel Protocol FCP connection into the Fabric The benefits are SES does not require supporting another protocol SES does not require an additional network link such as Ethernet Figure 1 1 shows the Fabric SES view The switch s Domain ID is used as the Logical Unit Number LUN address to identify each switch including the switch used for access through SES See the SES Functional Model section in Chapter 2 for more information Note The connection to the Fabric is through the switch labeled LUNS and which is also called LUNO The connection to the well known management address FFFFFAh is always labeled LUNO no matter which switch is used 89461214
11. 02 is SES Management Figure 1 1 SES Overview Fabric Domain ID 10 LUN10 Domain ID 6 LUN6 Domain ID 5 LUNS Domain ID 9 LUN9 Domain ID 2 LUN2 FCP connection via the Management Server FFFFAh LUN addressing within the Fabric can be non sequential because it is based on the switch s Domain ID Table 1 1 shows the sample LUN mapping used with Figure 1 1 Table 1 1 Example LUN Mapping Domain ID Unique LUN Value in Hex 00000000 00000000 Note that Domain ID 5 is used for both LUN 0 and 5 01020000 00000000 5 2 5 6 9 01050000 00000000 01060000 00000000 01090000 00000000 010A0000 00000000 Figure 1 1 shows that the switch in the lower left hand corner is assigned both LUNS and LUNO LUNS because the switch s Domain ID is 5 and LUNO because the client is physically connected to that switch LUN values for the first byte shown in Table 1 1 are e 00000000 00000000 the bold characters indicate the local switch e 0X0X0000 00000000 the bold characters indicate the SCSI LUN address of the other switches in the Fabric 1 2 8946121402 8946121402 SES Management Therefore if there are 5 switches in the Fabric SES reports 6 LUNS one LUN value for each switch and LUNO for the local client connection Other SCSI 3 enclosures can also run SES outside the Fabric such as JBODs RAID 5 arrays SCSI 3 hard drives and SCSI 3 tape drives These devices are i
12. Storagelek StorageNet Fibre Channel Switch 4000 SES SCSI 3 Enclosure Services User Guide 8946121402 Storagelek StorageNet Fibre Channel Switch 4000 SES SCSI 3 Enclosure Services User Guide 8946121402 Revision History Tab Level Date Description 01 08 98 Initial release 02 03 99 Manual release corresponding to Release 1 6a The U S Department of Commerce restricts the distribution of technical information contained in this document when exported outside the U S Therefore careful attention should be given to compliance with all applicable U S Export Laws if any part of this document is to be exported 1999 Storage Technology Corporation Louisville Co All rights reserved Printed in USA Address comments concerning this manual to StorageTek Technical Communications 7600 Boone Avenue North Minneapolis MN 55428 1099 USA Comments may also be submitted over the Internet by addressing them to doccomment network com Always include the complete publication number and title of the document with your comments 8946121402 About This Document Introduction Use this guide for monitoring configuring and maintaining a StorageNet Fibre Channel Switch 4000 through SCSI 3 Enclosure Services SES You should be knowledgeable about networking in general routing and bridging in particular A clearly defined network and security plan is necessary Your security plan should assess the po
13. TUS Format Byte Bit Definition 0 7 0 Reserved 1 7 0 Reserved 7 4 Reserved 3 FCP RESID UNDER 2 FCP RESID OVER 1 FCP SNS LEN VALID 0 FCP RSP LEN VALID 3 7 0 SCSI status byte from the SCSI logical unit not used The reserved bits are set to 0 by the SESD FCP RESID UNDER indicates that the FCP_RESID field is valid and contains the number of bytes expected to be transferred but were not transferred See Table 3 4 This bit is not used by SESD FCP RESID OVER indicates that the FCP_RESID field is valid and contains the number of bytes that have been truncated because the FCP DL was not sufficient See Table 3 3 This bit may be set by SESD FCP and SES Commands Table 3 6 shows the commands supported by SESD Table 3 6 Supported Operation Codes Command Operation Code Inquiry 12h Receive Diagnostics Results 1Ch Report LUNs AOh Request Sense 03h Send Diagnostic 1Dh Test Unit Ready 00h The value of the FCP LUN field command The value of FCP DI in FCP CMND specifies the logical unit for the request in each L field in FCP_CMND specifies whether there is any data parameter to be transferred to the SESD The value should be 0 for command 1 2 3 4 and 6 For command 5 the value may be 0 or the size of a diagnostic page whose page code is in the range of 80h through 85h 3 4 8946121402 FCP and SES Commands Switch Diagnostics Pages Before each
14. ary Command SPC Revision 11a X3T10 995D working draft A value of 0 specifies that all parameters are vendor specific At present the SESD only supports the vendor specific page structures as defined in the Switch Diagnostics Pages section The selfTest DevOfL and UnitO L bits are ignored by the SESD at present The Parameter List Length field specifies the length in bytes of the parameter list that shall be transferred from the SES Application client to the SESD Test Unit Ready An SES Application Client sends a Test Unit Ready command to check if the logical unit is ready The FCP_CDB format is shown in Table 3 27 Table 3 27 Test Unit Ready Command Format Byte Bit 7 6 5 4 3 2 1 0 0 Operation Code 00h 1 4 Reserved 5 Control 0 The SESD returns the status of GOOD and CHECK CONDITION and a sense key of NO SENSE and an additional sense code of NO ADDITIONAL SENSE INFORMATION 8946121402 3 15 FCP and SES Commands Reject The SESD issues a Reject command to set status to Check Condition and the appropriate values for the Sense Key Sk field Additional Sense Code Asc and Additional Sense Code Qualifier ASCQ values are as shown in Table 3 28 Table 3 28 Reject Command Format SK ASC ASCQ Explanation 04h Logical Unit not ready Enclosure Service failed Enclosure Service unavailable memory allocation problem Parameter List length error t
15. ators and Control Management ooa ace e ca e aaa a ii e A 2 3 Chapter 3 SES Commands EN EGIS TREN AS AAA AAA E ROS RGR ee d ded a 3 1 Constructs Commands and Diagnostic Pages c cena 3 1 GF IONICE siriana iones conse saetta 3 2 FOP Command Infomation Us er ci rd drid ika do A A 3 2 FCP Transfer Ready Information Unit isse sucer e XR RR nn 3 3 FCP Data Information Lf e rate a rex RE REC RRXZG CREE Re Ria p SERO d dpi e RR X da 3 3 FCP Response Information Unit suisses a pm aaa rcx Re aia REOR dee SORORE aia 3 3 PGP and SES COMISARIA LARE qu RE ASAP vee NES 3 4 Euch IES PAS ui d dq ctore CR ROO dob ca cac M dete a X doce dod 3 5 supported Diagnostics PAQES cecosest sede kei RAS x CER RS e xx ex bach RR us 3 5 POON Mos oc atat ee a d a oda da ea 3 6 SURBOF DHE PAIR irradia bead ea Tune ds 3 7 gii p T PP 3 7 Neighborhood Table PAGS cus auae s pe aaa a oppo dee DR Ros RE XR dte aa 3 8 Fibre Channel Port Table Page susce ska a a 3 8 Name Server Local Table Page iu a aere e a adole we Re cR ae 3 10 Dr p P rr 3 11 Receive Diagnose HesullS Lido deb e d eso aaa na Da a XR RR ERR XXE PRESE 3 13 Gil rar TT a a au i 3 14 PSESE SONES e eseist e Aaa ae a re d CER d A coda de e e a e dob edo x 3 14 SAR RR GEO P ue E ce a ET ed Bon ls p i cu 3 15 West AI MORI cos ma e rete eee eee aep pedo E Red dr ege ei bd ud 3 15 RR FEO A VETO TEOR A E E E A 3 16 8946121402 V vi Chapter 4 Troubleshooting E PRAIA EROR RT a S a epee Sin
16. ce hc as IT ENO 4 1 Mo acchi o EEEIEE a n dn ati tage RIA EI TRI x RP ae 4 1 AER DONDE S aoa ae ratate hi ia DER OCA AC ERA SOR d de AAA AA aaa 4 1 RNG Field NGS e ae 4244 ei asia a aci ee c ei du owes d di uec nei 4 1 Appendix A Glossary 8946121402 List of Figures Figure 1 1 Figure 2 1 Figure 2 2 8946121402 SES Overview SES Distribution SES Functional Model vii viii 8946121402 List of Tables Table 1 1 Table 2 1 Table 2 2 Table 3 1 Table 3 2 Table 3 3 Table 3 4 Table 3 5 Table 3 6 Table 3 7 Table 3 8 Table 3 9 Table 3 10 Table 3 11 Table 3 12 Table 3 13 Table 3 14 Table 3 15 Table 3 16 Table 3 17 Table 3 18 Table 3 19 Table 3 20 Table 3 21 Table 3 22 Table 3 23 Table 3 24 Table 3 25 Table 3 26 Table 3 27 Table 3 28 8946121402 EXI LUN POPOD acritico 1 2 Format of LUN recognized by SESD eee me a volu n RR enue 2 2 CURN MEDDA ood EA PIN AAA RE RIEN RP ROS 2 2 Constructs Commands and Diagnostic Pages 3 1 FCP Information Unit Descriptions llle 3 2 FOP CMND IU FFOHTIBE scissa rei Aa bd A esr ida 3 3 PEP Ror FORAL win aoai a a aia ia ea a ia i a t al 3 3 FUP STATUS Fama pui err nt ll n px eed a nc os 3 4 Supported Operation Codes i e de aa REA se 3 4 Diagnos eS PSIBS a e e aeu AAA 3 5 zu MIB ESPN aut arat E dou aci le s at QUE aed ata a ede d do 3 5 Page Code 0 Format Supported Diagnostic Pages 3 5 wil Page FOL IUBE
17. cerro ala 3 6 Sensor Table Page Formal iii dee ortae i eda 3 7 PORMEatal Fabi POSEE sas out t ii parai ire A dC pedea 3 7 Neighborhood Table Page Format anaana 3 8 Fibre Channel Port Table Page Format 3 9 Format of Name Server Local Table Page issus 3 10 Inquiry Command Formal n ceas e RR iaia rana 3 11 Inquire Dala Foral n se ses ore deas rab Fea ra RE e xy I 3 11 ID C DUE esi o ae e on doo plan db cca do UG cd C ia ct deal 3 12 SES Return Codes Tor DON iu ase sepu RR RN E Ro es la eg 3 12 BESD Astum Codes or BUM iios a a e ea ke ee a aa s eR us 3 12 SSESD Retur Codes Tor BO ausu aud ddd eke ER E ER RC i deban ds d 3 13 Receive Diagnostic Results Command Format 3 13 Report LUNs Command Format 2506600500600 ecee RR 3 14 Reported LUNS FOUTISEU iiia dor dx rr 3 14 Request Sense Command Format 00 cece eee nes 3 14 Send Diagnostic Command Format isses sete rr aa e wees 3 15 Test Unit Ready Command Format e 3 15 Reject Command Formal sd E dcs ndrin do Re Ca e d dE d 3 16 ix 8946121402 Chapter 1 Product Overview Introduction This chapter describes StorageTek s implementation of SES SCSI 3 Enclosure Services on the StorageNet Fibre Channel Switch 4000 SES implementation in a SCSI 3 based Host Adapter is up to the adapter manufacturer and StorageTek cannot determine their implementation Therefore the focus of this guide is to discuss StorageTek s
18. de 83h 1 na na Reserved 2 3 na na Page Length 2 n 3 4 7 na na swNumEntries i specifies the number of entries received for bytes 8 Note that each entry consists of swValidity 0 field through field 5 8 11 na rw swValidity 0 12 15 0 ro swNblndex 0 3 4 5 16 19 ro NswNbMyPort 0 20 23 ro swNbRemoteDomainlD 0 24 27 ro swNbRemotePort 0 28 31 ro swNbBaudRate 0 32 35 ro swNblsIState 0 more instances of swNbEntry swValidity swNblsIState if applicable n 4 n 1 ro swNblsIState i 1 Fibre Channel Port Table Page If requested using the Send Diagnostic or Receive Diagnostic Result command the SESD returns the response shown in Table 3 14 3 8 8946121402 FCP and SES Commands Table 3 14 Fibre Channel Port Table Page Format em mar aww le s e e Je T E 0 na na Page Code 84h 1 na na Reserved 2 3 na na Page Length n 3 4 7 na na swNumEntries j specifies the number of entries received Note Each entry consists of swValidity 0 field through field 27 8 11 na rw swValidity 0 12 15 0 ro swFCPortIndex 0 16 19 1 ro swFCPortType 0 20 23 2 ro swFCPortPhyStatus 0 24 27 3 ro swFCPortOpStatus 0 28 81 4 rw swFCPortAdmStatus 0 32 35 5 ro swFCPortTxWords 0 36 39 6 ro swFCPortRxWords 0 40 43 7 ro swFCPortTxFrames 0 44 47 8 ro swFCPortRxFrames 0
19. dentified by their Fabric and SCSI addresses and are assigned LUNS using standard SCSI 3 host adapter LUN addressing Note It is not this guide s intent to describe the environment outside of the Fabric 1 3 SES Management 8946121402 Chapter 2 SES Concepts Introduction This chapter uses generic terms to describe enclosure services and specific SES implementation SES instances can be distributed inside and outside of the Fabric to any enclosure capable of supporting enclosure services through an SES device SES is distributed transparently throughout the Fabric with an instance of a distributed SES Device SESD on each switch as shown in Figure 2 1 Figure 2 1 SES Distribution Fabric SES Key Installed SES Key Installed SES Key Installed SES KEY Installed FCP connection via the Management Server FFFFAh SES Functional Model Each instance may be accessed by an SES Application Client by specifying the associated unique LUN See Figure 2 2 for information on LUN addressing SES implementation also provides an SES Application Client an in band mechanism for managing any Fabric switch that it is attached to Figure 2 2 shows the SES functional model 8946121402 24 SES Functional Model Figure 2 2 SES Functional Model SES Application SES Request gt Client C SES Response IIA SES Device FCP Command FCP Port f FCP Resp
20. e parameters Transfers data Contains status and sense information Contains the diagnostic pages supported Contains status information about the switch its operational state and firmware Contains status information about the state of all sensors in the switch Contains information about the Fabric its neighbors and domain ID Contains information about the switch s neighbors in the Fabric Fibre Channel Port Table Page Contains information about the switch s Fibre Channel ports Name Server Local Table Page Contains information about the SESD Inquiry Contains information about the devices and sensors in an enclosure Receive Diagnostics Results 8946121402 Contains information returned by the SESD about an enclosure 3 1 FCP Constructs Table 3 1 Constructs Commands and Diagnostic Pages Continued Command Report LUNs Request Sense Description Contains information returned from SESD containing the LUNs attached to the SESD Used to sense information from the SESD Send Diagnostic Used to configure diagnose a logical unit Test Unit Ready Used to test an LUNs operation state Reject FCP Constructs Contains information and status about a unit s failure Before initiating any FCP request the Nx Port associated with the SES Application Client FCP Initiator must complete an N Port Login PLOGI with the Management Server in Class
21. escriptor Block The structure of up to 16 bytes in length used to communicate commands from the application client to a device server Critical Condition An enclosure condition where one or more elements inside the enclosure have failed or are outside of operational parameters The element failure makes normal operation of at least some elements in the enclosure impossible although some of the elements inside the enclosure may be able to continue normal operation Device A mechanical electrical or electronic part in an enclosure Device Server A logical unit object that executes SCSI tasks Device Service Request A request from an application client of SCSI commands to a device server Device Slot An insertion position in an enclosure for SCSI devices The position provides power signal and control connections for the SCSI device The position may also provide protection automatic insertion device status LEDs locking capability and additional features to manage SCSI devices in the enclosure Device Type The device type or device model implemented by the device server Domain ID The domain number uniquely identifies the switch in a Fabric Normally the switch domain ID is automatically assigned by the principal switch and may be any value between 0 and 31 This number may also be assigned manually Enclosure The box rack or box set that provide power mechanical protection external interfaces and cooling for the SCSI device s
22. ield 10 8 11 na ro swValidity 0 12 15 0 ro swNsIndex 0 16 19 1 ro swNsPortType 0 20 23 2 ro swNsPortID 0 24 31 3 ro swNsPortName 0 32 287 4 ro swNsPortSymbolicName 0 288 295 5 ro swNsNodeName 0 296 551 6 ro swNsNodeSymbolicName 0 552 559 7 ro swNslnitialProcesslnitiator 0 560 575 8 ro swNsClassOfServices 0 576 579 9 ro swNsClassOfServices 0 580 643 10 ro swNsFc4Types 0 more instances of swNsLocalEntry swValidity swNsFc4Types if applicable n 4 n 1 0 10 ro swNsFc4Typesl i 1 8946121402 Inquiry FCP and SES Commands An SES Application Client may send an Inquiry command to obtain information about a switch in the Fabric The format of the FCP CDB is shown in Table 3 16 Table 3 16 Inquiry Command Format Byte Bit Operation Code 12h Reserved CmdDt 0 EVPD 0 Page Code 0 Reserved Allocation Length Control 0 If the field EVPD Enable Vital Product Data is set to 0 and the value of the page code is 0 the standard Inquiry Data is returned as shown in Table 3 17 Table 3 17 Inquiry Data Format 0 Peripheral Qualifier 0 Peripheral Device Type ODh 1 RMB Reserved 0 0 2 ISO version 0 ECMA version 0 ANSI version 3 3 AERC TrmTsk NormAC Reserv Response data format 2 0 0 A 1 ed 0 4 Additional Length 31 1Fh 5 Reserved 7 Reser EncServ VS 0 MultiP
23. in SCSI impersonation in the Fabric The CDB format is shown in Table 3 23 Table 3 23 Report LUNs Command Format Byte Bit 7 6 5 4 3 o 0 Operation Code AOh 15 5 Reserved 6 9 10 The SESD reports the LUNs of associated switches with the format shown in Table 3 24 Table 3 24 Reported LUNs Format 0 3 LUN list length n 7 4 7 Reserved 8 15 LUN n 7 n LUN Request Sense An SES Application Client sends a Request Sense command to obtain sense data The CDB format is shown in Table 3 25 Table 3 25 Request Sense Command Format Byte Bit Operation Code 03h Reserved Allocation length Control 0 The SESD returns a sense key of NO SENSE and an additional sense code of NO ADDITIONAL SENSE INFORMATION 3 14 8946121402 FCP and SES Commands Send Diagnostic A SES Application Client can use a Send Diagnostic command to configure diagnose a logical unit After the command completion the SES Application Client sends a Receive Diagnostic Results command See Table 3 22 The FCP_CDB format is shown in Table 3 26 Table 3 26 Send Diagnostic Command Format Byte Bit 7 6 5 4 3 2 1 0 0 Operation Code 1Dh 2 Reserved 3 4 Parameter list length 5 Control 0 A Page Format PF bit of 1 specifies that the Send Diagnostic parameters conform to the page structure as specified in SCSI 3 Prim
24. iry 3 11 Receive Diagnostic Results 3 13 3 15 Reject 3 16 Report LUNs 3 14 Request Sense 3 14 Send Diagnostic 3 15 Test Unit Ready 3 15 Command Descriptor Block A 1 Constructs FC PH 3 2 Critical Condition A 1 D Device A l Device Server A 1 Device Service Request A 1 8946121402 Device Slot A 1 Device Type A 1 Diagnostics Pages 3 5 Domain ID A 1 E Enclosure A 1 Enclosure Services A 1 Enclosure Services Device A 1 F FCP Command Information Unit 3 2 FCP Data Information Unit Command 3 3 FCP Response Information Unit Command 3 3 FCP Transfer Ready Information Unit Command 3 3 FC PH Constructs 3 2 Field ASCQ 3 16 SK 3 16 I Initiator A 1 Inquiry Command 3 11 Inquiry Data 3 11 K Key Sense 3 16 NoSense 3 14 L Logical Unit A 2 Logical Unit Number A 2 Index 1 P Page Diagnostics 3 5 Fabric 3 7 Fibre Channel Port Table 3 8 Neighborhood Table 3 8 Sensor Table 3 7 Supported Diagnostics 3 5 Switch 3 6 Page Code Valid Bit 3 13 R Receive Diagnostic Results Command 3 13 3 15 Redundancy A 2 Reject Command 3 16 Report LUNs Command 3 14 Request Sense Command 3 14 S SCSI A 2 SCSI Device A 2 Send Diagnostic Command 3 15 Sense Additional Code Field ASC 3 16 Additional Code Qualifier 3 16 Sense Key 3 16 SilkWorm Fabric Page 3 7 Fibre Channel Port Table Page 3 8 Neighborhood Table Page 3 8 Sensor Table Page 3 7 Switch Page 3 6 SK Field 3 16 Supported Diagno
25. lient uses the RECEIVE DIAGNOSTIC RESULTS command with the PF bit set to obtain enclosure status The information returned indicates the actual enclosure state See the Receive Diagnostic Results section in Chapter 3 for more information Note The instructions from the application client may be ignored or overwritten by the enclosure service processor to ensure proper state information For example the enclosure may ignore an instruction to clear an error condition because the condition is valid or because the instruction is not supported by the enclosure 8946121402 2 3 Indicators and Control Management 2 4 8946121402 Introduction Chapter 3 SES Commands This chapter contains information and examples on managing SES including the following e FC PH constructs FCP and SES commands e Diagnostics pages Note SESD can be accessed from any Fabric switch licensed to run SES Constructs Commands and Diagnostic Pages Table 3 1 summarizes the FC PH constructs FCP commands and SES commands Table 3 1 Constructs Commands and Diagnostic Pages Command Description FCP Information Unit FCP Transfer Ready Information Unit FCP Data Information Unit FCP Response Information Unit Supported Diagnostics Pages Switch Page Sensor Table Page Fabric Page Neighborhood Table Page SCSI Command to be executed or a task management request Contains SCSI 3 data delivery servic
26. onse AAA FCP _Port Request Sequence 9 i ee 4 Response Sequence FC PH At the Fibre Channel level each SESD is accessible through the Fibre Channel well known address FFFFFAh Management Server At the SCSI 3 level it is associated with a LUN An SES Application Client can refer to any distributed SESD within the Fabric using its LUN A LUN value of 0 is always associated with the local switch that is physically attached to the SES Application Client The unique LUN value is mapped based on peripheral device addressing The bus number for each switch is set to 010000 as shown in Table 2 1 The first byte of the Target LUN is set using the Domain ID of the switch Bytes 2 7 are set to zero Table 2 1 Format of LUN recognized by SESD Byte Bit 7 0 0 0 Bus Number 010000b 1 Target or 7 Logical Unit Number LUN Table 2 2 shows the LUN mapping Table 2 2 LUN Mapping Domain ID Unique LUN Value in Hex 0 Oh 01000000 00000000 5 5h 01050000 00000000 12 010C0000 00000000 15 010F0000 00000000 25 19h 01190000 00000000 2 2 8946121402 Access to the Enclosure Services Process An SES Application Client may easily find the LUN values of all distributed SESDs inside the Fabric by using the Report LUNs command See the Report LUNs section in Chapter 3 for more information Access to the Enclosure Services Process An ap
27. oo small or too big Invalid command operation code Logical Unit not supported invalid LUN value in FCP_CDB 8946121402 Chapter 4 Troubleshooting Introduction This chapter discusses the SEND DIAGNOSTIC command error messages License Reject A license reject is generated when the SES license key is improperly entered or is not installed The following message is generated Probable cause Invalid Field Action See the Reject section in Chapter 3 for more information CHECK CONDITION CHECK CONIDITION is generated when the SES Device SESD terminates an operation because an error was encountered These error conditions can be from invalid operations warning indications and failure conditions The sense key and sense code describe the error Invalid Field Errors ILLEGAL REQUEST is generated from any invalid fields in the CDB from parameters of a SEND DIAGNOSTIC command and from the CDB of a RECEIVE DIAGNOSTIC RESULTS command The sense code identifies the location of the invalid fields parameter or CDB The following message is generated Probable cause Invalid Field Action See the Reject section in Chapter 3 for more information 8946121402 4 4 Introduction 4 2 8946121402 Appendix A Glossary Application Client The source object of the SCSI commands and destination for the command responses Byte A group of 8 bits Command D
28. plication client can monitor all enclosures capable of processing the enclosure services command set with SES instances distributed throughout a Storage Area Network SAN Enclosure services can monitor both devices inside and outside of the enclosure such as an Uninterruptable Power Supply UPS However SES pertains only to SES instances inside the Fabric An application client connects through Fiber Channel Protocol FCP using the Management Service address FFFFAh to any switch through its LUN See Figure 1 1 The enclosure services command set uses the RECEIVE DIAGNOSTIC RESULTS and SEND DIAGNOSTIC commands to any device capable of supporting SES Access Through an Enclosure Services Device The Application Client requests information from the SESD to examine status and warning information from the switch An Application Client through FCP calls the enclosure services process running on any switch as a LUN that has SES enabled The SESD sets the enclosure services bit EncServ in the INQUIRY command to indicate that it can transport enclosure services information See the Inquiry section in Chapter 3 for more information Indicators and Control Management SESD is accessed through an application client that uses the SEND DIAGNOSTIC command to transport control information to the enclosure services process The control information may include operations to perform or to modify its operating mode The application c
29. s many copies as you wish Please have the following information available when reporting a problem pem ee Serial Number Hardware Products only Product being BorderGuard RDS reported on Customer Contact Call back Telephone Number Problem Include error messages or other supporting documentation Description Impact on Is the problem an annoyance minor interruption or severe impact on your operations Customer Operations Please record the following information for future reference Customer Problem Number if assigned StorageTek Problem Number Date Reported Time Reported Comments
30. ssible risks to your network and define access policies to deal with those risks How This Guide is Organized This guide is divided into the following chapters e Chapter 1 Product Overview provides an overview of SES and SES Management e Chapter 2 SES Concepts describes the concepts associated with SES e Chapter 3 SES Commands describes FC PH constructs FCP and SES commands and diagnostics pages e Chapter 4 Troubleshooting describes command error messages The following appendix is also included in this guide e Appendix A Glossary Reference Documents The following documents contain information related to SES Fibre Channel Standards For detailed information on the Fibre Channel standards see the Fibre Channel Association web site at http www fibrechannel com StorageNet Fibre Channel Switch 4000 Installation and Reference Guide 8946119902 StorageNet Fibre Channel Switch 4000 WEB TOOLS User Guide 8946121602 StorageNet Fibre Channel Switch 4000 ZONING User Guide 8946121502 8946121402 iii Notice to the Reader The material contained in this publication is for informational purposes only and is subject to change without notice StorageTek is not responsible for the use of any product options or features not described in this publication and assumes no responsibility for any errors that may appear in this publication Refer to the revision history at the beginning of this document to de
31. stics Pages 3 5 T Target A 2 Test Unit Ready Command 3 15 Index 2 8946121402 Comment Sheet StorageTek welcomes your comments about this publication Please complete this form including your name and address and mail it to StorageTek Technical Communications Department 7600 Boone Avenue North Minneapolis Minnesota 55428 9919 USA Comments may also be submitted over the Internet by addressing them to doccomment network com Always include the complete publication number and title of the document with your comments Name Company Address City State Zip Code Publication Number and Revision Publications Title COMMENTS FOLD IST FOLD IST NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES BUSINESS REPLY MAIL FIRST CLASS MAIL PERMIT NO 19774 MPLS MN Od a o ra ae o 0 ne e POSTAGE WILL BE PAID BY ADDRESSEE ATTN TECHNICAL COMMUNICATIONS DEPARTMENT STORAGETEK 7600 BOONE AVENUE NORTH MINNEAPOLIS MN 55428 9919 lu lulu halul FOLD FOLD CUT ON VERTICAL LINE HdVL JIdYLS LON Od AdVL StorageTek Problem Reporting Please direct any product related problems or complaints to the following toll free telephone number 1 800 248 8777 Please be aware that depending on your maintenance and or warranty coverage the services delivered may be chargeable This form is provided for your convenience in gathering information for your call Make a
32. termine the revision level of this publication StorageTek does not by publication of the descriptions and technical documentation contained herein grant a license to make have made use sell sublicense or lease any equipment or programs designed or constructed in accordance with this document or programs designed or constructed in accordance with this information Customer Support For technical support please call StorageTek at 1 800 248 8777 Before calling StorageTek please have your information from the Problem Reporting form ready This form is located at the back of this manual If a problem cannot be resolved through Customer Support a Return Material Authorization RMA is issued Instructions are provided on where to return the part and how to receive a replacement part If the product is installed by the customer the customer is responsible for returning the product with freight paid to the nearest repair center 8946121402 Table of Contents Chapter 1 Product Overview Digit CAII ea aa aci ga dca arde cedo Oc cR bd cdit de Rd a ate ei te tM da cad 1 1 oes tans Mel ca cc a aaa er bsosaPexd dqQUquERBRPaSqdq ipud picaaidexd dor NU RICE Rd 1 1 Chapter 2 SES Concepts urbc a a irene T cui ai e Si aaa i da OTRS ai a ia 2 1 SES Funcional Modal iscationsara baz pasta aie 2 RA 2 1 Access to the Enclosure Services Process c ceea 2 3 Access Through an Enclosure Services Device cece een eens 2 3 Indic
Download Pdf Manuals
Related Search