********************************************************************* EMC Corporation JNI Corporation SBUS & PCI TO FIBRE CHANNEL ADAPTER RELEASE NOTES FOR SYMMETRIX

ICDA SYSTEM UPDATED: 05/03/01 ********************************************************************** This README file contains last-minute product information about the JNI 32-bit SBus Adapter (FC-1063-EMC), the 64-bit SBus Adapter (FC64-1063-EMC), and the PCI Adapter (FCI-1063-EMC). All of the items contained on this distribution CD-ROM can be found on the JNI/EMC web page (http://www.jni.com/Drivers). CAUTION: 32-bit and 64-bit drivers are not interchangeable with each host bus adapter. Please install the correct driver and refer to the list below for correct driver name. HBA Part Number Driver Name ====================== =========== FC-1063-EMC (32-bit) fca FC64-1063-EMC (64-bit) fcaw FCI-1063-EMC (32-bit PCI) fca-pci Driver Package ============== fca.pkg fcaw.pkg fca-pci.pkg

For complete installation and use instructions, please see the Symmetrix Fibre Channel Product Guide (P/N 200-999-642) and the SBus To Fibre Channel Adapter Installation Guide from JNI. This Document is divided into the following sections: I. II. III. CD-ROM CONTENTS ADAPTER ISSUES SCSI DRIVER ISSUES 1. CONFIGURATION VARIABLES 2. SUPPORTED ENVIRONMENT 3. SPECIAL CONDITIONS and INFORMATION NEW FUNCTIONALITY

IV.

********************************************************************** I. CD-ROM CONTENTS ***************

This CD-ROM contains the following: * SCSI Host Adapter Driver (HBA) - Version 2.5.17 This is a Fibre Channel PLDA-, FCP-SCSI-, and Fabric-compliant driver. It is currently qualified to support arbitrated loop and the FC Fabric (F_Port login only) for the FC-1063-EMC (32-bit SBus), the FC64-1063-EMC (64-bit SBus), and the FCI-1063-EMC (PCI bus). * A chapter from the Fibre Channel Product Guide for Solaris Sparc system. * This release.txt file II. ADAPTER ISSUES ************** 1. The following information, which is printed at boot time, does not

indicate any problems: Apr Apr Apr Apr 10 10 10 10 16:23:43 16:23:43 16:23:43 16:23:43 losao068 losao068 losao068 losao068 unix: unix: unix: unix: /kernel/drv//sparcv9/fca symbol ddi_model_convert_from multiply defined /kernel/drv//sparcv9/fcaw symbol ddi_model_convert_from multiply defined

The information is not critical and no further action need be taken. The HBA driver will function normally. This will be improved in the next driver release. 2. The SBus HBA that contains the Fcode 11.X.X will hang the Sun Ultra Enterprise (UE-3X00, UE-4X00, UE-5X00, and UE-6X00) in the following setup: 1. I/O board with 3 SBus slots 2. 3 JNI SBus adapters (any combination of the 32-bit and 64-bit) 3. Sun CPU OBP version 3.2.21 or later The setup above will cause the OBP prompt to display: {OK} Fast Data Access MMU missed After the prompt, the user cannot boot up the system. The new Fcode version 13.3.7 fixes this problem. Please contact the EMC Software Assistance Center in order to upgrade the Fcode from version 11.X.X to 13.3.7 3. To force the 64-bit SBus HBA to 32-bit mode, add this line to the "/etc/system" file: set fcaw:force32 = 1 4. Upgrading the driver from version 2.2.0.EMC will require the administrator to modify the volume-logix host adapter WWN information in the Symmetrix. The modification is important because the information about the WWN that was printed to the console at boot time is different from version 2.2.0.EMC (this information is also available in the "/var/adm/messages" file). Please contact the EMC Software Assistance Center in order to upgrade the driver from version 2.2.0.EMC. 5. Installing the sg target driver (Netbackup 3.11 from Veritas software for controlling the tape library) will panic the host OS. The sg target driver will require Patch F0800117 from Veritas. Please contact the Veritas Support Center to obtain the patch. 6. Installing the sg target driver will conflict with the st target driver, and panic the host OS. The recommended workaround is to forceload the st and sg driver permanently using the "forceload: drv/st" and "forceload: drv/sg" commands inside the "/etc/system" file. Please contact the EMC Software Assistance Center in order to make this change. 7. Doing the Dynamic Reconfiguration Attach in the UE10K with the OBP Fcode ver 12.0.0 will lose the devices that belong to the new attached System Board. Please contact the EMC Software Assistance Center in order to upgrade the OBP Fcode from version 12.0.0 to 13.3.5 or later. 8. Note: For the JNI PCI, during heavy I/Os, if the link bounces (we simulate this condition by DD the director or pulling the cable), the HBA will fill up the Tachyon IMQ when it is in the process of flushing the active commands. Some of the active commands are still in the active

queue and later on recovered through the timeout routine. However, occasionally we observe some Tachyon hang that results in more link bounces due to the Tachyon reset to recover from the hang condition. This might cause the sd_retry_count to be exhausted. 9. Note: Fcode 13.3.5 requires modification of the default-wwn in order to support the boot from the zoned fabric environment. By default, Fcode 13.3.5 reports the node WWN for the default WWN; however, the zone information requires port WWN for the zone to work. Please refer to the Fibre Channel User Guide for further information on how to modify the WWN or upgrade to Fcode 13.3.7. 10. In the case of a UE-10K booting from a Sun A5000 Storage Network Array, the combination of the Symmetrix connected through the FC switch environment, using Powerpath and Veritas VxVM, the "/etc/system" file may contain the 'forceload:ses' line. The line will load the ses (Storage Enclosure Service for Sun Storage products) and overtake the probing of devices earlier than the sd. As a result, the binding defined inside the "sd.conf" file may not work correctly. To alleviate this issue, forceload the sd prior to the ses or implement the hba_default_binding="nonjni" + setup complete binding in all of the required target "driver.conf" files (sd.conf, st.conf, etc). 11. The following messages at boot time indicate that the IP section of the 2.5.17 EMC driver is functioning; however, the IP network is not set up properly: " WARNING: Cannot create minor node for <pci1242,4643> <fca-pci> <0>" " Can't find clone devinfo node" " WARNING: Cannot create minor node for <fcaw> <fcaw> <3>" " Can't find clone devinfo node" The SCSI part of the 2.5.17 driver will function properly without any without the user needing to do anything. To disable the above messages, set ip_disable=1 in the "/kernel/drv/fcaw.conf", "/kernel/drv/fca.conf" or the "/kernel/drv/fca-pci.conf" file. 12. Fcode versions 13.3.5 and 13.3.7 can freeze the terminal console through the TTYA (also known as serial port A) if the administrator issues a "probe-scsi-all" command with many targets (more than 40). This bug will be fixed in a future release of the Fcode. III. HOST SCSI ISSUES ****************

This CD-ROM contains the 2.5.17 version of the JNI SBus and JNI PCI HBA FC-SCSI driver. 1. System Setup Recommendation for both Raw and FileSystem I/O =========================================================== sd_max_throttle *************** The sd_max_throttle variable is the maximum number of outstanding commands that the SCSI target driver (sd) will attempt to queue to the targets (Symmetrix). The default value is 256. This

variable should be set to a value less than the maximum queue depth of each LUN (Symmetrix) connected to each instance of the sd driver. This variable is set to a certain value because there exist conditions where the host executes more outstanding commands than the Symmetrix queue can handle at one time. These extra oustanding commands will be rejected with "queue-full" status. In this case the sd driver instance that receives the "queue-full" status will throttle down the execution of the command to 1 command at a time. This action will relatively degrade the performance of the system. This variable is set in the "/etc/system" file as: set sd:sd_max_throttle = nnn The value for the sd_max_throttle will depend on the Symmetrix configuration. In most configurations the value is set to 20. Please contact your EMC Software Assistance Center to determine the appropriate value for this setting. sd_io_time ********** The sd_io_time variable is the timer for the each I/O that is maintained by the HBA FC-SCSI driver. The default value is 60 seconds. This variable should be set so that I/Os will not be timed out and aborted by the FC-SCSI driver, when the required service is performed in the Symmetrix. In most configurations the value is set to 120. set sd:sd_io_time = nnn 2. SUPPORTED ENVIRONMENT ===================== JNI SBus Adapters 32-bit (FC-1063-EMC), 64-bit (FC64-1063-EMC), FCI-1063-EMC, and driver 2.5.17 have been qualified and supported to run on the following Sun Models: Ultra-SPARC, Ultra Netra, Ultra Enterprise Workstations and Servers running the Solaris 2.5.1, Solaris 2.6, Solaris 7, or Solaris 8 operating system. For detailed and the most up-to-date support matrix on the Sun platform, please contact your local sales department. The following is the required and recommended Sun patches list: Solaris 2.5.1 required patches: ============================== 103640-33 SunOS 5.5.1: kernel, nisopaccess, & libthread patch 103622-15 SunOS 5.5.1: /kernel/drv/sd driver patch 103934-17 SunOS 5.5.1: /kernel/drv/isp patch (SBus only) 105004-11 SunOS 5.5.1: pci_pci, ebus, pci and rootnex driver patch (PCI only) 103981-18 SunOS 5.5.1: glm driver patch (PCI only) Solaris 2.5.1 Recommended Patches: ================================= 104578-03 SunOS 5.5.1: pkginstall patch 103670-07 CDE 1.0.2: dtcm sdtcm_convert rpc.cmsd patch 103630-15 SunOS 5.5.1: ip ifconfig arp udp icmp patch 103663-15 SunOS 5.5.1: libresolv, in.named, named-xfer, nslookup and nstestpatch 103558-15 SunOS 5.5.1: admintool/launcher fixes + swmtool fixes and y2000 103582-24 SunOS 5.5.1: /kernel/drv/tcp and /usr/bin/netstat patch 103594-19 SunOS 5.5.1: sendmail fixes

103597-04 103603-12 103622-15 103640-33 103627-13 103680-03 103686-02 103690-13 103696-05 103699-02 103743-01 103801-07 103817-04 103866-05 103934-17 103959-12 104010-01 104212-13 104220-03 104246-08 104266-02 104283-04 104331-07 104490-06 104334-01 104516-03 104560-05 104605-09 104613-01 104650-03 104654-05 104166-04 104692-01 104708-19 104735-02 104736-04 104776-02 104795-02 104841-05 104893-02 104935-01 103738-14 104956-04 104958-01 104960-02 104968-02 105004-11 105050-01 105092-01 105299-02 105784-05 106382-01 105310-13 105324-04 105344-01 105352-01 103981-18 104595-09 106563-04 104628-05

SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS

5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1: 5.5.1:

/kernel/strmod/sockmod patch ftp, in.ftpd, in.rexecd and in.rshd patch /kernel/drv/sd driver patch kernel, nisopaccess, and libthread patch Linker patch nscd/nscd_nischeck/nss_files.so.1 patch rpc.nisd_resolv patch cron/crontab/at/atq/atrm patch /sbin/su, /usr/bin/su and /sbin/sulogin patch /usr/sbin/ping patch XFN source modifications for BIND 4.9.3 Patch for make, sccs, as /usr/bin/rdist patch BCP (binary compatibility) patch /kernel/drv/isp patch lp patch VolMgt Patch /kernel/drv/hme patch /usr/lib/nfs/mountd patch /kernel/drv/fas patch inetd patch /kernel/fs/procfs patch /usr/sbin/rpcbind patch ufsdump and ufsrestore patch lockd patch aspppd patch /kernel/fs/hsfs patch ecpp driver patch /usr/lib/newsyslog patch /usr/bin/rlogin patch automount/automountd patch /usr/lib/nfs/statd patch usr/sbin/in.talkd patch ssd, pln, soc, ssaadm and ssafirmware patch platform/sun4m/kernel/drv/sx patch /usr/bin/csh patch libvolmgt patch eeprom patch /usr/sbin/vold patch /kernel/sys/c2audit patch usr/sbin/in.rlogind patch /usr/sbin/syslogd patch usr/sbin/in.rarpd patch usr/sbin/in.rdisc patch usr/sbin/snoop patch chkey and newkey patch pci_pci, ebus, pci and rootnex driver patch usr/bin/ps and usr/ucb/ps patch usr/sbin/sysdef patch kernel/misc/nfssrv patch libbsm patch /usr/sbin/rmmount patch Patch for socal, sf driver, and luxadm ses driver patch usr/bin/gcore patch kernel/exec/elfexec patch glm driver patch prtdiag patch PAM Patch driver_aliases, driver_classes and name_to_major

105789-08 105790-23 103461-34 107756-01 104873-05 105077-06 106689-01 106905-01 106646-03 108658-02 106529-07 108497-01 108470-01 109275-01 109392-01 108802-01 103857-17

patch VIS/XIL 2.5.1: Graphics Patch Creator 2.5.1: FFB Graphics Patch Motif 1.2.3: Runtime library patch SunOS 5.5.1: /usr/bin/pax patch SunOS 5.5.1: /usr/bin/uustat and other uucp fixes SunOS 5.5.1: /kernel/fs/fifofs patch SunOS 5.5.1: /usr/sbin/in.uucpd patch SunOS 5.5.1: apropos/catman/man/whatis patch SNC 3.2: rpc.pcnfsd has security problem, also hangs and dumps core SunOS 5.5.1: Patch for sadmind SunOS 5.5.1: Shared library patch for C++ SunOS 5.5.1: ASET sets gid on /tmp,/var/tmp when med/high security SunOS 5.5.1: Possible denial of service bug SunOS 5.5.1: security: /bin/mail has buffer overflow SunOS 5.5.1: /usr/vmsys/bin/chkperm patch SunOS 5.5.1: tip has buffer overrun with security implications SunOS 5.5.1: /kernel/drv/st patch

Solaris 2.6 Required Patches: ============================ 105181-25 SunOS 5.6: Kernel update patch 105356-16 SunOS 5.6: /kernel/drv/ssd and /kernel/drv/sd patch Solaris 2.6 Recommended Patches: =============================== 105210-33 SunOS 5.6: libaio, libc and watchmalloc patch 105216-04 SunOS 5.6: /usr/sbin/rpcbind patch 105284-37 Motif 1.2.7: Runtime library patch 105357-04 SunOS 5.6: /kernel/drv/ses patch 105375-25 SunOS 5.6: sf and socal driver patch 105379-06 SunOS 5.6: /kernel/misc/nfssrv patch 105395-06 SunOS 5.6: /usr/lib/sendmail patch 105401-28 SunOS 5.6: libnsl and NIS+ commands patch 105403-03 SunOS 5.6: ypbind/ypserv patch 105407-01 SunOS 5.6: /usr/bin/volrmmount patch 105472-07 SunOS 5.6: /usr/lib/autofs/automountd patch 105529-10 SunOS 5.6: /kernel/drv/tcp patch 105552-03 SunOS 5.6: /usr/sbin/rpc.nisd_resolv patch 105562-03 SunOS 5.6: chkey and keylogin patch 105568-22 SunOS 5.6: /usr/lib/libthread.so.1 patch 105580-16 SunOS 5.6: /kernel/drv/glm patch 105591-09 SunOS 5.6: Shared library patch for C++ 105615-08 SunOS 5.6: /usr/lib/nfs/mountd patch 105642-08 SunOS 5.6: prtdiag patch 105665-03 SunOS 5.6: /usr/bin/login patch 105667-02 SunOS 5.6: /usr/bin/rdist patch 105720-12 SunOS 5.6: /kernel/fs/nfs patch 105722-05 SunOS 5.6: /usr/lib/fs/ufs/ufsdump and ufsrestore patch 105741-07 SunOS 5.6: /kernel/drv/ecpp patch 105755-08 SunOS 5.6: libresolv, in.named, named-xfer, nslookup, nstest pat ch 105780-05 SunOS 5.6: /kernel/fs/fifofs patch 105786-13 SunOS 5.6: /kernel/drv/ip patch 105800-07 SunOS 5.6: /usr/bin/admintool, y2000 patch 105847-08 SunOS 5.6: /kernel/drv/st.conf and /kernel/drv/st patch 105926-01 SunOS 5.6: /usr/sbin/static/tar patch 106040-15 SunOS 5.6: X Input and Output Method patch

106049-01 106123-04 106125-10 106193-05 106226-01 106235-06 106257-05 106271-06 106285-03 106292-11 106301-01 106429-02 106439-07 106448-01 106468-02 106495-01 106522-04 106569-01 106592-03 106625-08 106639-05 106828-01 106834-02 106882-02 106894-01 107565-02 107618-01 107733-09 107758-01 107766-01 107774-01 107991-01 108307-02 108333-02 108346-03 108468-02 108492-01 108499-01 108660-01 108804-01 108890-01 108893-01 108895-01 109266-01 109339-01 109388-01 109719-01 105600-19 105847-08

SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS

5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6:

SunOS 5.6: SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6: 5.6:

/usr/sbin/in.telnetd patch sgml patch Patch for patchadd and patchrm y2000 sysid unzip patch /usr/sbin/format patch lp patch /usr/lib/libpam.so.1 patch /usr/lib/security/pam_unix.so.1 patch /kernel/sys/msgsys patch pkgadd/pkginstall and related utilities /usr/sbin/in.ftpd patch /kernel/drv/mm patch /usr/sbin/syslogd patch /usr/sbin/ping patch /usr/bin/cu and usr/bin/uustat patch truss and truss support library patch /usr/bin/ftp patch libauth.a and libauth.so.1 patch /usr/lib/nfs/statd patch libsec.a, libsec.so.1 and /kernel/fs/ufs patch /kernel/strmod/rpcmod patch /usr/bin/date patch cp/ln/mv patch /usr/lib/nfs/nfsd patch /usr/bin/uux patch /usr/sbin/in.tftpd patch Permissions problem in /vol. Linker patch Pax incorrectly change mode of symlink target file ASET cklist reports unchanged 6-month older files as new inetd denial-of-service attack /usr/sbin/static/rcp patch keyserv fixes jserver buffer overflow patch usr/sbin/rpc.nispasswdd ldterm streams module fixes Snoop may be exploited to gain root access ASET sets the gid on /tmp, /var/tmp when setting med high Patch for sadmind tip has buffer overrun with security implications patch /usr/lib/netsvc/yp/ypxfrd patch /usr/lib/netsvc/yp/rpc.ypupdated patch /usr/sbin/rpc.bootparamd security: /bin/mail has buffer overflow nscd has a potential security problem patch /usr/vmsys/bin/chkperm arp should lose set-gid bid /kernel/drv/isp patch /kernel/drv/st.conf and /kernel/drv/st patch

Solaris 7 required patches: ========================== 106541-15 SunOS 5.7: Kernel update patch 107458-12 SunOS 5.7: dad, sd, ssd, uata drivers patch Solaris 7 Recommended Patches: =============================

106300-09 106327-08 106793-05 106938-04 106942-15 106944-03 106950-13 106952-01 106960-01 106978-10 106980-15 107018-02 107038-01 107115-05 107171-08 107259-01 107359-02 107443-13 107451-05 107454-05 107456-01 107477-03 107544-03 107587-01 107636-05 107684-01 107709-07 107792-02 107794-01 107972-01 108301-02 108327-01 108331-01 108482-02 108484-01 108551-03 108662-01 108721-02 108748-01 108750-01 108754-01 108756-01 108758-01 108760-01 108762-01 108764-01 108798-01 108838-02 109253-01 109404-01 109709-01 109744-01 109949-01 110281-01 107148-08 107460-08 106924-06 106925-06

SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS SunOS

5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7: 5.7:

Shared library patch for 64-bit C++ Shared library patch for C++ ufsdump and ufsrestore patch libresolv patch libnsl, rpc.nisd and nis_cachemgr patch /kernel/fs/fifofs and /kernel/fs/sparcv9/fifofs patch Linker patch /usr/bin/uux patch Manual Pages for patchadd.1m and patchrm.1m sysid patch libthread patch /usr/sbin/in.named patch apropos/catman/man/whatis patch LP patch Fixes for patchadd and patchrm /usr/sbin/vold patch Patch for SPARCompiler Binary Compatibility Libraries packaging utilities patch /usr/sbin/cron patch /usr/bin/ftp patch /etc/nsswitch.dns patch /usr/lib/nfs/mountd patch /usr/lib/fs/ufs/fsck patch /usr/lib/acct/lastlogin patch X Input & Output Method patch Sendmail patch libssasnmp/libssagent/snmpdx/mibiisa patch /usr/bin/pax patch ASET patch /usr/sbin/static/rcp patch /usr/sbin/in.tftpd patch /usr/bin/cu patch /usr/bin/uustat patch /usr/sbin/snoop patch aset patch /usr/sbin/rpc.nispasswdd patch Patch for sadmind admintool patch /usr/lib/nfs/statd patch /usr/lib/netsvc/yp/ypbind patch /usr/lib/netsvc/yp/ypxfrd patch /usr/lib/netsvc/yp/rpc.ypupdated patch /usr/sbin/keyserv patch /usr/sbin/rpcbind patch /usr/sbin/rpc.nisd_resolv patch /usr/sbin/rpc.bootparamd patch /usr/bin/tip patch allocate/mkdevmaps/mkdevalloc patch /usr/bin/mail patch /usr/vmsys/bin/chkperm patch /usr/sbin/arp patch /usr/lib/nfs/nfsd patch jserver buffer overflow finds expansion of {} is broken /kernel/fs/cachefs patch st driver patch isp driver patch glm driver patch

Solaris 8 required patches: ========================== 108528-06 SunOS 5.8: kernel update patch 108974-09 SunOS 5.8: dada, uata, dad, sd and scsi patch Solaris 8 Recommended Patches: ============================= 108652-27 X11 6.4.1 Xsun patch 108727-06 SunOS 5.8: /kernel/fs/nfs and /kernel/fs/sparcv9/nfs patch 108875-07 SunOS 5.8: c2audit patch 108968-02 SunOS 5.8: vol/vold/rmmount patch 108975-04 SunOS 5.8: /usr/bin/rmformat and /usr/sbin/format patch 108977-01 SunOS 5.8: libsmedia patch 108985-02 SunOS 5.8: /usr/sbin/in.rshd patch 108987-02 SunOS 5.8: Patch for patchadd and patchrm 109137-01 SunOS 5.8: /usr/sadm/install/bin/pkginstall patch 109221-06 SunOS 5.8: Patch for sysidnet 109277-01 SunOS 5.8: /usr/bin/iostat patch 109279-06 SunOS 5.8: /kernel/drv/ip patch 109320-01 SunOS 5.8: LP patch 109322-02 SunOS 5.8: libnsl patch 109472-04 SunOS 5.8: /kernel/drv/tcp patch 109740-02 SunOS 5.8: /kernel/drv/udp patch 109742-02 SunOS 5.8: /kernel/drv/icmp patch 109783-01 SunOS 5.8: /usr/lib/nfs/nfsd patch 109888-05 SunOS 5.8: platform drivers patch 109898-02 SunOS 5.8: /kernel/drv/arp patch 109951-01 SunOS 5.8: jserver buffer overflow 110283-01 SunOS 5.8: /usr/lib/fs/ufs/mkfs patch 110320-01 SunOS 5.8: /kernel/misc/sparcv9/s1394 patch 110383-01 SunOS 5.8: libnvpair patch 110416-02 SunOS 5.8: ATOK12 patch 110453-01 SunOS 5.8: admintool patch 110662-01 SunOS 5.8: ksh patch 110700-01 SunOS 5.8: automount patch 110905-01 SunOS 5.8: /usr/bin/find patch 110951-01 SunOS 5.8: /usr/sbin/tar and /usr/sbin/static/tar patch 108725-04 SunOS 5.8: st driver patch 109885-03 SunOS 5.8: glm patch 109657-03 SunOS 5.8: isp driver patch 109524-04 SunOS 5.8: ssd driver patch 3. SPECIAL CONDITIONS and INFORMATION ********************************** Condition#1 SD LINK FAILURE NOTIFICATION =========== During a cable disconnect or a link failure in the middle of I/O tranfer, ensuing command transport calls by sd to the JNI HBA driver are returned by fca, fcaw, or fca-pci with BUSY status. All outstanding commands queued on fca or fcaw will be held indefinitely (not timed out). During this link-down condition, the HBA driver (fca, fcaw, fca-pci) will not notify the target driver (sd) about the link failure. The outstanding commands will be returned to sd as aborted, only after the link is restored. Therefore, the failover software (such as Powerpath) that needs immediate notification of a link failure will not work if the configuration file fca.conf is left in its default configuration. To enable the failover feature of the driver, set the failover parameter in the driver configuration file to a value greater than 0. The lists

below are the typical settings for fca.conf (32-bit SBus), fcaw.conf (64-bit SBus), and fca-pci.conf (32-bit PCI): For Fabric environment with EMC Powerpath or Veritas DMP: ========================================================= # # # # fca driver configuration file Configuration variable recovery_attempts Type: integer, count; default: 5 Defines the number of times login_recovery is attempted before quitting recovery. recovery_attempts = 5; Configuration flag fca_nport Type: boolean; default: 0 (false) If false (0), then fca initializes on a loop If true (1), then fca initializes as an N_Port and fabric operation is enabled. fca_nport = 1;

# # # #

# Configuration variable failover # Type: integer, seconds; default: 0 # Defines the number of seconds after link failure before failing all pending commands on targets. failover = 60; For Fabric environment without EMC Powerpath or Veritas DMP: ============================================================ # # # # fca driver configuration file Configuration variable recovery_attempts Type: integer, count; default: 5 Defines the number of times login_recovery is attempted before quitting recovery. recovery_attempts = 5; Configuration flag fca_nport Type: boolean; default: 0 (false) If false (0), then fca initializes on a loop If true (1), then fca initializes as an N_Port and fabric operation is enabled. fca_nport = 1;

# # # #

# Configuration variable failover # Type: integer, seconds; default: 0 # Defines the number of seconds after link failure before failing all pending commands on targets. failover = 0; For Loop environment with EMC Powerpath or Veritas DMP: ======================================================= # # # # fca driver configuration file Configuration variable recovery_attempts Type: integer, count; default: 5 Defines the number of times login_recovery is attempted before quitting recovery. recovery_attempts = 5;

# # # #

Configuration flag fca_nport Type: boolean; default: 0 (false) If false (0), then fca initializes on a loop If true (1), then fca initializes as an N_Port and fabric operation is enabled. fca_nport = 0;

# Configuration variable failover # Type: integer, seconds; default: 0 # Defines the number of seconds after link failure before failing all pending commands on targets. failover = 60; For Loop environment without EMC Powerpath or Veritas DMP: ========================================================== # # # # fca driver configuration file Configuration variable recovery_attempts Type: integer, count; default: 5 Defines the number of times login_recovery is attempted before quitting recovery. recovery_attempts = 5; Configuration flag fca_nport Type: boolean; default: 0 (false) If false (0), then fca initializes on a loop If true (1), then fca initializes as an N_Port and fabric operation is enabled. fca_nport = 0;

# # # #

# Configuration variable failover # Type: integer, seconds; default: 0 # Defines the number of seconds after link failure before failing all pending commands on targets. failover = 0; For example, if failover is set to 60, then link failure for 60 seconds will cause the HBA driver to start rejecting commands destined for all the targets on the failed link issued by the SCSI driver. This will trigger Powerpath to failover the affected targets. If recovery_attempts is set to 5, then the driver will start rejecting commands issued by the SCSI driver if login recovery fails for a target more than 5 times. This will cause Powerpath to failover the target. Condition#2 TAPE BACKUP ENVIRONMENT =========== EMC does not support tape backup environment with this HBA driver. The environment includes any tape library unit and any tape backup software. Condition#3 VERITAS PATCH LEVEL PROBLEM =========== The following software is recommended when using Veritas VxFS with a Fibre Channel disk: - Solaris 2.5.1, apply patch 103640-24 or higher

- Solaris 2.6, apply patch 105181-09 or higher Without these levels of software patches, you may experience system hangs when running the vxbench utility. Condition #4 DYNAMIC CONFIGURATION IN UE-10K ============ The following patch in the Solaris 2.6 can fail drain-phase of the DR-detach: 106048-05 SunOS 5.6: DR/hwsp patch (Requires >= 105181-14). This failure is charaterized by the DR-detach failing with the following error in the detach window: ioctl failed: ... errno -1 Condition #5 SOLARIS 2.5.1 ============ Do not alter the maxphys value to be greater than 512KB. It is also required to have the aforementioned patches installed. Condition #6 UPGRADING THE JNI HBA DRIVER ============ Before installing the new version of the JNI HBA driver, copy the JNI configuration file (/kernel/drv/fcaw.conf, fca.conf, or fca-pci.conf) to another name. Install the new JNI HBA driver and re-copy the configuration file. Condition #7 ISSUING probe-scsi-all IN THE SERIAL TERMINAL CONSOLE ============ In the large configuration (more than 50 devices connected per HBA), issuing the "probe-scsi-all" command through the serial terminal console (TTYA) can hang the host. It is recommended to use the monitor and keyboard as the console for the large configuration for issuing the "probe-scsi-all" command. IV. NEW FUNCTIONALITY ***************** 1. MAJOR ENHANCEMENTS ****************** 1.1 OBP FCODE SUPPORT ================= The Fcode on both SBus HBAs, 32-bit and 64-bit, has been upgraded to Version 13.3.7. Instructions for upgrading the Fcode on both 32-bit and 64-bit SBus HBAs will be provided by the EMC Software Assistance Center on request. Version 13.3.7 supports self-test diagnostic, probe-scsi-all (only on the arbitrated loop mode), Dynamic Reconfiguration on the Ultra Enterprise 10000, and boot-support for the Direct Connect and Switch environments. 1.1 FABRIC SUPPORT ============== Driver version 2.5.17 continues the fabric support (F-Port login) for the switch vendors that support the Fabric Generic Services on Class 3.

1.2 PERSISTENT WORLD WIDE NAME to SCSI TARGET ID MAPPING ==================================================== This allows the user to identify targets by WWN. The mapping is preserved across the link initialization and system reboots. Refer to the technotes on how to effectively utilize this feature. The technotes can be found in the "/opt/JNIfca", "/opt/JNIfcaw" or "/opt/JNIfcaPCI" directory after installing the driver from the distributed CD-ROM. 1.3 "sd.conf" SYNTAX CHECKING UTILITY (canal) ========================================= This utility allows the user to check the syntax of the sd.conf entries and analyzes it for content and errors. A report is generated providing information regarding how a JNI HBA will map the targets defined. usage: canal <input_file> input_file: File name of configuration file to be analyzed (e.g. sd.conf, etc.) The "canal" utility can be found in the "/opt/JNIfca", "/opt/JNIfcaw", or "/opt/JNIfcaPCI" directory after installing the driver from the distributed CD-ROM. 1.4 DYNAMIC RECONFIGURATION ON ULTRA ENTERPRISE 10000 ================================================= Fcode version 13.3.7 supports the Dynamic Reconfiguration for the SBus 32-bit and 64-bit FC adapters in the UE-10K for both the Solaris 2.5.1 and the Solaris 2.6 operating systems. The current support includes Direct Connect AL, the FC-Fabric switch. Please refer to the specific patches that are required in the patch list (Section III) and the special cases. 1.5 BOOT SUPPORT FOR ARBITRATED LOOP AND FC-SWITCH ============================================== Fcode version 13.3.7 supports the Sun host boot from the Symmetrix device connected through the JNI FC-1063 and FC64-1063 HBA. Currently, boot support is available for Solaris 7 and 8. Information for setting up the boot support is available in the EMC Symmetrix Fibre Channel Product Guide (P/N 200-999-642). 2. ADDITIONAL FIXES ***************** This is a list of fixes since version 2.5.9 a. Corrected the Errata B33 problem (Tachyon chip hung during repeated switch power-cycle). b. Corrected the panic due to the GNN_FT command referencing an undefined port (NULL pointer reference).

c. Corrected a target-specific problem by checking the RES_LEN_VALID bit. - If 1 FCP_RSP_INFO field contains valid information and the FCP_RSP_LEN field is valid and non-zero and contains the count of bytes in the FCP_RSP_INFO field. - If 0 FCP_RSP_LEN is not valid. d. This driver allows the user to disable ARQ to support non-FCP compliant drives. The user should enter the following line in the "fca*.conf" file: arq_disable = 1; e. Corrected a bug that did not correctly align data transfers (writes) of 128 bytes or less. f. Corrected the memory leak associated with adapters with ip_disable=1 mixed in an environment with other fibre channel devices configured for IP. g. Duplicate device nodes were created that caused the driver to fail the ifconfig command when configuring the driver as an IP interface. h. Using Dynamic Reconfiguration could trigger a panic. A panic could also occur if adapters were removed and the system rebooted. This happened when old instances of the adapter remained in the "/etc/path_to_inst" file or the "/kernel/drv/fcaw.conf" file (an artifact of EZ Fibre). i. The response valid bit was done incorrectly. (Mask was a word when it should have been a character). j. Changed the saving of adapter properties to be compatible with the SNIA libraries. k. Driver will not allocate the MFS Buffer if ip_disable=1. This is a possible fix for some sites that encouter dma allocation problems when running heavy I/Os. l. Driver creates an internal flag in its command structure to check if the buffer is previously mapped in prior to freeing it. This is a fix for some sites that encounter system panics. m. Driver will read the FM Status register to determine if the link is down or not prior to resetting the Tachyon HBA in an attempt to unfreeze the OSM. This is a fix for the 4-port HUB configuration. 3. NEW CONFIGURATION FLAGS AND VARIABLES ************************************* The following is a list of user-tunable configuration flags and variables that have been added since release 2.0.0.EMC. These parameters are configured in the file "/kernel/drv/fca.conf" for 32-bit SBus adapters, and file "/kernel/drv/fcaw.conf" for 64-bit SBus adapters. *** DO NOT CHANGE THE DEFAULT VALUE SETTING FOR THE FOLLOWING VARIABLES *** timeout_reset_enable - this variable is a boolean, set to either "0" (false) or "1" (true). When enabled (true), and a command times

out, the driver will return an indication to the target driver that causes a SCSI RESET command to be sent to the target. public_loop - this variable is a boolean, set to either "0" (false) or "1" (true). When enabled (true), the fca initializes as an NL_Port on a public loop and fabric operation is enabled via the FL_port of the switch. busy_retry_delay - this variable is an integer specified in milliseconds, with a 10-millisecond resolution. It sets the delay between retries after a SCSI device returns a BUSY response for a command. ip_disable - this variable is a boolean, set to either "0" (false) or "1" (true). When disabled (false), the IP side of the driver is disabled. The default value is 1. qfull_retry_count - this variable defines the number of times a command is retried by the HBA if a target rejects it with a "queue full" status. qfull_retry_interval - this variable defines the number of times the HBA waits before retrying a rejected command due to "queue full". scsi_probe_delay - sets the delay before SCSI probes are allowed to occur during boot. This allows time for the driver to build a network port list for target binding. The delay is in milliseconds with a 10-millisecond resolution. The default value is 5000 (5 seconds). abort_retry_delay - this variable is an integer specified in milliseconds with a 10-millisecond resolution. It sets the delay before a command is retried due to an abort from timeout or link recovery condition. def_hba_binding - sets the default HBA binding for every target/lun instance that does not explicitly define one. - A "*" following an HBA name indicates all instances of that HBA driver. Type: string; default: "fcaw*" (means all target/lun instances will be initialized by all fcaw instances) (See JNI fca technote for details on HBA bindings) def_wwn_binding - sets the 16-digit hexidecimal default WWN binding for every target/lun instance that does not explicitly define one. - A "$" preceding the string indicates static binding enabled - A "x" in place of a digit indicates "don't care" for that digit Type: string; default: "$xxxxxxxxxxxxxxxx" (means WWN is "static don't care") (See JNI fca technote for details on wwn bindings) def_port_binding - sets the 6-digit hexidecimal default port binding for every target/lun instance that does not explicitly define one. - A "$" preceding the string indicates static binding enabled

- A "x" in place of a digit indicates "don't care" for that digit Type: string; default: "xxxxxx" (means PORT is "non-static don't care") (See JNI fca technote for details on port bindings) target_controllers - sets the maximum number of targets that can be supported per controller. The default value is 126. fca_verbose - determines how many messages are displayed directly to the console. - A "0" will quiet driver messages to the console, but still print them to the system message log. (NOTE: A "boot -v" will override this setting and make the driver verbose again.) - A "1" will make the driver print all messages to the console and to the system message log. Type: boolean; default: 1