Sun Microsystems DR 10000 User Manual

Sun™ Enterprise 10000

DR Conﬁguration Guide

Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A. 650-960-1300

Part No. 816-3630-10 May 2002, Revision A

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

Copyright 2002Sun Microsystems,Inc., 4150Network Circle,Santa Clara,CA 95054U.S.A. All rightsreserved. This product ordocument isdistributed underlicenses restrictingits use,copying, distribution, anddecompilation. Nopart ofthis productor

document maybe reproducedin anyform byany meanswithout priorwritten authorization ofSun andits licensors,if any.Third-party software,including font technology, iscopyrighted andlicensed fromSun suppliers.

Parts ofthe productmay bederived fromBerkeley BSDsystems, licensedfrom theUniversity of California.UNIX isa registeredtrademark in the U.S.and othercountries, exclusivelylicensed throughX/Open Company, Ltd.

Sun, SunMicrosystems, theSun logo,AnswerBook2, docs.sun.com,Solstice DiskSuite,Sun FastEthernet, SunNetra, SunEnterprise, Sun Enterprise Volume Manager, SunStorEdge, SunUltra, OpenBoot, Solaris,and UltraSparcare trademarks,registeredtrademarks, or service marks ofSun Microsystems,Inc. inthe U.S.and othercountries. All SPARC trademarksare usedunder licenseand aretrademarks or registered trademarks ofSPARCInternational, Inc.in theU.S. andother countries. Productsbearing SPARC trademarksare basedupon anarchitecture developed bySun Microsystems,Inc.

The OPENLOOK andSun™ GraphicalUser Interfacewas developed bySun Microsystems,Inc. forits usersand licensees. Sunacknowledges 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.

Federal Acquisitions:Commercial Software—GovernmentUsers Subjectto StandardLicense Terms andConditions. DOCUMENTATION ISPROVIDED “ASIS” AND ALLEXPRESS ORIMPLIED CONDITIONS,REPRESENTATIONSAND WARRANTIES,

INCLUDING ANYIMPLIED WARRANTY OFMERCHANTABILITY, FITNESSFOR A PARTICULARPURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED,EXCEPT TOTHE EXTENTTHATSUCH DISCLAIMERSARE HELD TOBE LEGALLY INVALID.

Copyright 2002Sun Microsystems,Inc., 4150Network Circle,Santa Clara,CA 95054Etats-Unis. Tousdroitsréservés. Ce produit oudocument estdistribué avecdes licencesqui en restreignent l’utilisation, lacopie, ladistribution, etla décompilation. Aucune

partie dece produitou documentne peutêtre reproduitesous aucuneforme, parquelque moyen que ce soit,sans l’autorisationpréalable et écrite deSun etde sesbailleurs delicence, s’il yen a.Le logicieldétenu par des tiers, etqui comprendla technologierelative auxpolices de caractères,est protégépar un copyrightet licenciépar desfournisseurs deSun.

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.

Sun, SunMicrosystems, lelogo Sun,AnswerBook2, docs.sun.com,Solstice DiskSuite,Sun FastEthernet, SunNetra, SunEnterprise, Sun Enterprise Volume Manager, SunStorEdge, SunUltra, OpenBoot,Solaris, etUltraSparc sontdes marquesde fabrique oudes marquesdéposées, ou marquesde service,de SunMicrosystems, Inc.aux Etats-Uniset dansd’autres pays.Toutesles marquesSPARCsont 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 se conforment aux licences écritesde Sun.

LA DOCUMENTATIONEST FOURNIE“EN L’ETAT”ET TOUTESAUTRES CONDITIONS,DECLARATIONS ETGARANTIES EXPRESSES OU TACITES SONTFORMELLEMENT EXCLUES,DANS LAMESURE AUTORISEEPARLA LOI APPLICABLE,Y COMPRISNOTAMMENT TOUTEGARANTIE IMPLICITE RELATIVE ALA QUALITEMARCHANDE, A L’APTITUDE AUNE UTILISATIONPARTICULIERE OUA L’ABSENCEDE CONTREFAÇON.

Please

Recycle

Sun Enterprise10000 SSPAttributions: This software iscopyrighted bythe Regentsof theUniversity of California, SunMicrosystems, Inc.,and otherparties. Thefollowing terms

apply toall ﬁlesassociated withthe softwareunless explicitly disclaimedin individual ﬁles. The authorshereby grantpermission touse, copy, modify, distribute, and license thissoftware andits documentationfor anypurpose,

provided thatexisting copyrightnotices are retained in allcopies andthat thisnotice isincluded verbatim inanydistributions. Nowritten agreement, license,or royaltyfee isrequired forany ofthe authorized uses. Modiﬁcations tothis softwaremay becopyrighted by theirauthors and neednot followthe licensingterms describedhere, providedthat the newterms areclearly indicated onthe ﬁrstpage ofeach ﬁle where they apply.

IN NOEVENT SHALLTHE AUTHORSOR DISTRIBUTORSBE LIABLETO ANYPARTY FOR DIRECT, INDIRECT,SPECIAL, INCIDENTAL, OR CONSEQUENTIALDAMAGES ARISING OUTOF THEUSE OFTHIS SOFTWARE, ITS DOCUMENTATION,OR ANY DERIVATIVES THEREOF, EVEN IF THEAUTHORS HAVE BEENADVISED OFTHE POSSIBILITY OF SUCH DAMAGE.

This isscotty, asimple tclinterpreter withsome specialcommands toget information aboutTCP/IP networks.Copyright (c)1993, 1994, 1995, J. Schoenwaelder,TU Braunschweig,Germany,Institute forOperating Systemsand ComputerNetworks. Permission touse, copy, modify, and distribute thissoftware andits documentationfor anypurpose andwithout fee ishereby granted,provided thatthis copyrightnotice appears in allcopies. The Universityof Braunschweigmakes norepresentations aboutthe suitabilityof this softwarefor anypurpose. It isprovided “as is" withoutexpress orimplied warranty.

Preface vi

Before You Read This Book vi How This Book Is Organized vi Using UNIX Commands vii Typographic Conventions vii Shell Prompts vii Related Documentation viii Accessing Sun Documentation Online viii Sun Welcomes Your Comments ix

1. Configuring DR 1

DR Models 2

Enhancements in DR Model 3.0 3 Where to Execute DR Commands 3 Requirements for Multipathing in DR 3.0 3

Getting Started 3

Device Prerequisites 4 Allocating Sufficient Domain Swap Space 5 Qualifying Third-Party Device Drivers 5

Overview of DR Configuration Tasks 6

▼ To Enable the Kernel Cage 7 ▼ To Set Permanent Driver Parameters for Network Drivers 7 ▼ To Enable Device Suspension for the soc and pln Drivers 8 ▼ To Specify an Unsafe Driver List 8 ▼ To Make an Unsupported Tape Device Detach-Safe 9

Preparing for DR Detach Operations 9 Configuration Changes During DR Operations 10

Controlling Forcible Conditions that Affect System Quiescence 10

▼ To Manually Suspend a Suspend-Unsafe Device 11 ▼ To Force a System Quiescence 12

Target Memory Constraints 12 Processors 13 Network Devices 13 Remote DR Communication 14

▼ To Troubleshoot a Connection Failure During a Solaris 9 (DR Model3.0)

Operation 14

v Sun Enterprise 10000 DR Configuration Guide • May 2002

Preface

This guide describes the domain-side configuration of the Sun Enterprise 10000 server Dynamic Reconfiguration (DR) feature. For information about how to use these features, refer to the appropriate document listed in “Related Documentation” on page viii.

Before You Read This Book

This guide is intended for the Sun Enterprise 10000 system administrator who has a working knowledge of UNIX® systems, particularly those based on the Solaris™ operating environment. If you do not have such knowledge, first read the Solaris user documentation provided with this system, and consider UNIX system administration training.

Also read and be familiar with the TCP/IP and Data Communications Administration Guide that is provided with your server.

How This Book Is Organized

This guide contains one chapter that describes how to configure and reconfigure a Sun Enterprise 10000 domain before and after a DR operation.

Using UNIX Commands

This document does not contain complete information on basic UNIX commands and procedures such as shutting down the system, booting the system, and configuring devices. See the Solaris software documentation that you received with your system for this information.

Typographic Conventions

Typeface or Symbol

AaBbCc123 The names of commands, files,

AaBbCc123

AaBbCc123 Book titles, new words or terms,

Meaning Examples

Edit your .login file. and directories; on-screen computer output

What you type, when contrasted with on-screen computer output

words to be emphasized. Replace command-line variables with real names or values.

Use ls -a to list all files.

% You have mail.

% su

Password:

Read Chapter 6 in the User’s Guide.

These are called class options.

To delete a file, type rm filename.

Shell Prompts

Shell Prompt

C shell machine-name% C shell superuser machine-name# Bourne shell and Korn shell $ Bourne shell and Korn shell superuser #

vii Sun Enterprise 10000 DR Configuration Guide • May 2002

Accessing Sun Documentation Online

A broad selection of Sun system documentation is located at:

http://www.sun.com/products-n-solutions/hardware/docs

A complete set of Solaris documentation and many other titles are located at:

http://docs.sun.com

Preface viii

+ 17 hidden pages

Sun Microsystems DR 10000 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents