Sun Microsystems Sun Enterprise Server Release Note

Sun Enterprise Server ™ Alternate

Pathing 2.3.1 Installation and

Release Notes

Sun Microsystems, Inc. 901 San Antonio Road Palo Alto,CA 94303-4900 U.S.A. 650-960-1300

Part No. 806-4152-10 September 2000, Revision A

Send comments about this document to: docfeedback@sun.com

Copyright 2000Sun Microsystems,Inc., 901San AntonioRoad, PaloAlto, California 94303-4900U.S.A. Allrights reserved. This product ordocument isprotected bycopyright and distributedunder licensesrestricting itsuse, copying,distribution, and decompilation.

No partof thisproduct ordocument maybe reproducedin anyform byany means withoutprior writtenauthorization ofSun and itslicensors, if any.Third-party software,including fonttechnology,is copyrightedand licensedfrom Sunsuppliers.

Parts ofthe productmay bederived fromBerkeley BSDsystems, licensedfrom theUniversity of California.UNIX isa registeredtrademark in the U.S.and othercountries, exclusivelylicensed throughX/Open Company, Ltd.For NetscapeCommunicator™, thefollowing notice applies: (c) Copyright1995 NetscapeCommunications Corporation.All rightsreserved.

Sun, SunMicrosystems, theSun logo,AnswerBook2, docs.sun.com,and Solarisare trademarks,registered trademarks,or service marks of Sun Microsystems,Inc. in theU.S. andother countries.All SPARC trademarksare usedunder licenseand aretrademarks or registered trademarks of SPARCInternational, Inc.in the U.S.and othercountries. Productsbearing SPARC trademarksare basedupon anarchitecture developedby Sun Microsystems, Inc.

The OPENLOOK andSun™ GraphicalUser Interfacewas developed bySun Microsystems,Inc. forits usersand licensees. Sun acknowledges the pioneeringefforts ofXerox inresearchingand developing theconcept ofvisual orgraphical user interfaces for thecomputer industry.Sun holds anon-exclusive licensefrom Xeroxto theXerox GraphicalUser Interface,which licensealso covers Sun’slicensees whoimplement OPEN LOOK GUIsand otherwisecomply withSun’s writtenlicense agreements.

RESTRICTEDRIGHTS:Use, duplication,or disclosureby theU.S. Governmentis subject torestrictions ofFAR52.227-14(g)(2)(6/87) andFAR

52.227-19(6/87), orDFAR252.227-7015(b)(6/95) andDFAR227.7202-3(a). DOCUMENTATIONIS PROVIDED “ASIS” ANDALL EXPRESSOR IMPLIEDCONDITIONS, REPRESENTATIONSAND WARRANTIES,

INCLUDING ANYIMPLIED WARRANTYOF MERCHANTABILITY,FITNESS FORA PARTICULARPURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED,EXCEPT TOTHE EXTENTTHATSUCH DISCLAIMERSARE HELD TOBE LEGALLYINVALID.

Copyright 2000Sun Microsystems,Inc., 901San AntonioRoad, PaloAlto, Californie 94303Etats-Unis. Tous droits réservés. Ce produitou documentest protégépar uncopyright etdistribué avecdes licences quien restreignentl’utilisation, lacopie, ladistribution, etla

décompilation. Aucunepartie dece produitou documentne peutêtre reproduitesous aucuneforme, parquelque moyen quece soit,sans l’autorisation préalableet écritede Sunet deses bailleurs delicence, s’ily ena. Lelogiciel détenu pardes tiers,et quicomprend latechnologie relativeaux polices decaractères, estprotégé parun copyrightet licenciépar desfournisseurs de Sun.

Des partiesde ceproduit pourrontêtre dérivéesdes systèmesBerkeley BSDlicenciés parl’Université de Californie.UNIX estune marque déposée auxEtats-Unis etdans d’autrespays etlicenciée exclusivementpar X/Open Company,Ltd. Lanotice suivante est applicable à Netscape Communicator™:(c) Copyright1995 NetscapeCommunications Corporation.Tousdroits réservés.

Sun, SunMicrosystems, lelogo Sun,AnswerBook2, docs.sun.com,et Solarissont des marquesde fabriqueou desmarques déposées,ou marquesde service, deSun Microsystems,Inc. auxEtats-Unis etdans d’autrespays. Toutes lesmarques SPARCsont utilisées souslicence et sont desmarques defabrique oudes marquesdéposées deSPARCInternational, Inc.aux Etats-Unis etdans d’autrespays. Lesproduits portant les marques SPARC sontbasés surune architecturedéveloppée parSun Microsystems,Inc.

L’interfaced’utilisation graphiqueOPEN LOOKet Sun™a été développéepar SunMicrosystems, Inc.pour sesutilisateurs et licenciés. Sun reconnaîtles effortsde pionniers deXerox pourla rechercheet ledéveloppement duconcept desinterfaces d’utilisation visuelle ou graphique pour l’industriede l’informatique.Sun détientune licencenon exclusive deXerox surl’interface d’utilisationgraphique Xerox,cette licence couvrant égalementles licenciésde Sunqui mettenten place l’interfaced’utilisation graphiqueOPEN LOOKet qui en outre seconforment aux licences écritesde Sun.

CETTE PUBLICATIONEST FOURNIE "ENL’ETAT"ET AUCUNEGARANTIE, EXPRESSEOU IMPLICITE,N’EST ACCORDEE, YCOMPRIS DES GARANTIESCONCERNANT LAVALEURMARCHANDE, L’APTITUDE DELA PUBLICATION AREPONDRE AUNE UTILISATION PARTICULIERE, OULE FAIT QU’ELLENE SOITPASCONTREFAISANTEDE PRODUITDE TIERS. CEDENI DEGARANTIE NE S’APPLIQUERAIT PAS,DANS LAMESURE OU ILSERAIT TENUJURIDIQUEMENT NULET NONAVENU.

Please

Recycle

Sun Enterprise10000 SSPAttributions: This software iscopyrighted bythe Regents ofthe Universityof California, SunMicrosystems, Inc.,and otherparties. Thefollowing terms

apply toall ﬁlesassociated withthe softwareunless explicitly disclaimedin individualﬁles. The authorshereby grantpermission touse, copy,modify,distribute, and licensethis softwareand itsdocumentation forany purpose,

provided thatexisting copyrightnotices areretained inall copiesand that this notice isincluded verbatimin anydistributions. No written agreement, license,or royaltyfee isrequired forany ofthe authorizeduses. Modiﬁcations tothis softwaremay becopyrighted bytheir authors and neednot followthe licensingterms describedhere, providedthat the newterms areclearly indicatedon theﬁrst page ofeach ﬁlewhere they apply.

1. Alternate Pathing 2.3.1 on the Sun Enterprise servers 1

Preparing to Install or Upgrade 1

▼ To Install or Upgrade From the Web 2 ▼ To Install or Upgrade From a CD-ROM 2 ▼ To Mount a CD-ROM over NFS™ 3

Performing an Initial Installation of AP 5

ssd Patch 6

▼ To Install AP 2.3.1 Using Web Start 7 ▼ To Manually Install AP 2.3.1 9 ▼ To Configure AP 10

Installing the AP 2.3.1 AnswerBook2 Collection 16

AP 2.3.1 AnswerBook2 Collection 16

▼ To Install the AP 2.3.1 AnswerBook2 Collection 16

Before Performing an Upgrade of AP 17

Backing Up Your Server 18 Uncommitted AP Database Entries 19 Checking Other Software Documentation 19 Simultaneously Upgrading AP and Solaris Software 19

AP Database Partitions 19

Root Disk Partitions 20 ssd Patch 20

Performing an Upgrade of AP 21

▼ To Upgrade to AP 2.3.1 21

2. AP 2.3.1 on Sun Enterprise Servers 27

AP 2.3.1 on Sun Enterprise Servers 27

Installation Issues 27 General Issues 29

Supported Devices 29 SunFDDI and Gigabit Ethernet Devices 30 Sun StorEdge A3000 31 Sun StorEdge A5000 31 Sun StorEdge A7000 31 Sun StorEdge T3 31 Software Compatibility 31 Dynamic Reconfiguration (DR) Issues 32 Boot Disk Issues 32 IPMP Issues 32 Sun Fibre Channel Port Driver (usoc/fp) Issues 32 AP Documentation Locations 33

Known Bugs/RFEs 33 Fixed Bugs 33 Other Bugs 35

Fixed Other Bugs 35

vi Sun Enterprise Server Alternate Pathing 2.3.1 Installation Guide and Release Notes • September 2000

CHAPTER

Alternate Pathing 2.3.1 on the Sun Enterprise servers

This chapter contains initial installation and upgrade instructions for Alternate Pathing (AP) 2.3.1. With the introduction of AP 2.3.1, both the initial install instructions and the upgrade instructions now apply to the Sun Enterprise™ 3x00, 4x00, 5x00, 6x00 and 10000 servers.

Preparing to Install or Upgrade

The AP packages require approximately 2.7 megabytes of disk space on the server. The following table lists the total size of the AP software by file system.

TABLE1-1 AP Software Approximate File System Sizes

File System Size

/usr 317 Kbytes / 1.3 Mbytes /etc 13 Kbytes /kernel 1528 Kbytes /sbin 1481 Kbytes

AP requires that an entire disk partition with at least 300 Kbytes be dedicated to each database copy. For more detailed information on partitioning for the AP databases, see Chapter 2, “Alternate Pathing Database” in the Alternate Pathing 2.3.1 User Guide.

The installation instructions in this section assume that your system is running the Solaris 2.6, Solaris 7 or Solaris 8 operating environment. AP 2.3.1 will not run under software releases earlier than Solaris 2.6 environment.

▼ To Install or Upgrade From the Web

1. Using your web browser, go to http://www.sun.com/servers/sw/

2. Click the Enterprise Alternate Pathing (AP) link.

3. Click the Click here to download link.

The file that is then downloaded is named ap_2_3_1_sparc.zip.

4. Log in as superuser.

5. Change directory to the location where you downloaded the software:

# cd /download_directory

6. Extract the downloaded file by typing:

# unzip -v ap2_3_1_sparc.zip

The AP 2.3.1 packages are located in /download_directory/ap_2_3_1_sparc/ Product and the install and upgrade scripts are located in /download_directory/ap_2_3_1_sparc/Tools.

7. Proceed to “Performing an Initial Installation of AP” on page 5 or “Before Performing an Upgrade of AP” on page 17.

▼ To Install or Upgrade From a CD-ROM

1. Insert the “Software Supplement for the Solaris 8 Operating Environment” CDROM into the CD-ROM drive.

Allow time for the volume manager to mount the CD-ROM.

2 Sun Enterprise Server Alternate Pathing 2.3.1 Installation Guide and Release Notes • September 2000

Note – If your CD-ROM drive is not local to your system (for example, on a Sun

Enterprise 10000) and you are not familiar with remote installation using a CDROM, see “To Mount a CD-ROM over NFS™” on page 3 or refer to your Solaris System Administration Guide.

The AP 2.3.1 packages are located in:

/cdrom/cdrom0/Alternate_Pathing_2.3.1/Product

The install and upgrade scripts are located in:

/cdrom/cdrom0/Alternate_Pathing_2.3.1/Tools

2. Become superuser and cd to the Product installation directory:

# cd /cdrom/cdrom0/Alternate_Pathing_2.3.1/Product

3. Proceed to “Performing an Initial Installation of AP” on page 5 or “Before Performing an Upgrade of AP” on page 17.

▼ To Mount a CD-ROM over NFS™

1. Log in as superuser and verify that the volume manager is running on your machine:

# ps -ef | grep vold

2. If you see an entry containing /usr/sbin/vold, volume manager is running on your system.

■ If volume manager is running, skip to Step 3.

■ If volume manager is not running on your system, type:

# /etc/init.d/volmgt start

3. Check to see if NFS is running on your system:

# ps -ef | grep nfsd

Chapter 1 Alternate Pathing 2.3.1 on the Sun Enterprise servers 3

■ If you see an entry containing /usr/lib/nfs/nfsd then nfsd is running on

your system. Type:

# share -F nfs -o ro /cdrom/cdrom0/Alternate_Pathing_2.3.1

■ If nfsd is not running, type:

# /etc/init.d/nfs.server start # share -F nfs -o ro /cdrom/cdrom0/Alternate_Pathing_2.3.1

4. Log in to target machine as superuser and cd to the source machine:

# cd /net/source_machine/cdrom/cdrom0/Alternate_Pathing_2.3.1

If you cannot change to that directory and you do not have automounter on your network, create a mount point on the target machine and mount the Product directory:

# mkdir /remote_products # /usr/sbin/mount -F nfs -r source_machine:/cdrom/cdrom0/

Alternate_Pathing_2.3.1 /remote_products # cd /remote_products

5. At this point you may proceed with the install, “Performing an Initial Installation of AP” on page 5 or “Before Performing an Upgrade of AP” on page 17.

Once you have completed installation you can umount the CD-ROM using:

# umount source_machine/cdrom

4 Sun Enterprise Server Alternate Pathing 2.3.1 Installation Guide and Release Notes • September 2000

Performing an Initial Installation of AP

The initial installation instructions in this section are for environments where AP is not currently installed and configured. If any version of AP is currently installed and configured, you can use the instructions in “Before Performing an Upgrade of AP” on page 17 to install AP 2.3.1. That procedure uses scripts that save your current AP configuration, and then restores that configuration after you install the AP 2.3.1 packages.

Note – AP 2.3.1 software installation is based on your operating environment. If, at

a later date, you upgrade your Solaris operating environment, you must re-install AP 2.3.1 following the AP 2.3.1 upgrade procedure. See “Before Performing an Upgrade of AP” on page 17. For information on performing a simultaneous upgrade, see “Simultaneously Upgrading AP and Solaris Software” on page 19.

Chapter 1 Alternate Pathing 2.3.1 on the Sun Enterprise servers 5

ssd Patch

AP 2.3.1 requires an ssd(7D) patch. AP 2.3.1 installation checks for the presence of this patch. If the patch is not present then, depending on your configuration, the following message maybe displayed:

Alternate Pathing Subsystem Drivers (sparc) 2.3.1,REV=2000.05.09.11.28 Copyright 2000 Sun Microsystems, Inc. All rights reserved. ## Executing checkinstall script. Determining patch requirements... Verifying required patches are installed... Required patches not installed: 109524-01 ### ### Patch verification failed. ### Alternate Pathing 2.3.1 requires this package. ### You MUST apply the required patches before ### proceeding. ### ### PACKAGE INSTALLATION FAILED. ### checkinstall script suspends

Installation of <SUNWapdv> was suspended (administration). No changes were made to the system.

The required patches are as follows:

■ Patch 105356-15 for Solaris 2.6,

■ Patch 107458-09 for Solaris 7

■ Patch 109524-01 for Solaris 8

You can obtain these patches from SunSolve at: http://sunsolve.sun.com.

Note – For information on this patch, see Section “Fixed Other Bugs” on page 35

(Sun BugID 4295457).

You can use Web Start to install the AP 2.3.1 software and optionally the AP 2.3.1 AnswerBook2 collection or you can manually install the AP and AnswerBook packages using pkgadd.

To manually install AP 2.3.1 proceed to “To Manually Install AP 2.3.1” on page 9. To manually install the AP 2.3.1 AnswerBook see “To Install the AP 2.3.1 AnswerBook2 Collection” on page 16.

6 Sun Enterprise Server Alternate Pathing 2.3.1 Installation Guide and Release Notes • September 2000

If you have a third party volume manager installed on your system, you must deconfigure it, according to your vendor’s instructions, before installing AP 2.3.1. Once you have finished deconfiguring or if you do not have a volume manager installed, proceed to “To Install AP 2.3.1 Using Web Start” on page 7 for the Web Start procedure or “To Manually Install AP 2.3.1” on page 9 for the manual procedure.

▼ To Install AP 2.3.1 Using Web Start

You can use Web Start to perform a fresh install from CD-ROM or from files you have downloaded from the Web.

1. Log in as superuser.

2. Set the DISPLAY environment variable.

For sh(1) or ksh(1), type:

# DISPLAY=hostname:0 # export DISPLAY

Where hostname is the host name of the machine used to graphically display Web Start.

3. Change directory to the location of the AP 2.3.1 package:

■ If you downloaded software from the Web:

# cd /download_directory/ap_2_3_1_sparc/Product

■ If you are installing the upgrade from the CD-ROM: