Sun Microsystems Sun Enterprise 10000 Administrator Guide

Sun Enterprise 10000
Capacity on Demand 1.0
Administrator Guide

Sun Microsystems, Inc.

901 San Antonio Road
Palo Alto, CA 94303-4900 USA
650 960-1300 Fax [phone]

Part No.: 806-2190-10
Revision A, October 1999

Send comments about this document to: [e-mail]

Copyright 1999 Sun Microsystems,Inc.,901SanAntonioRoad,PaloAlto,California94303-4900U.S.A.Allrightsreserved.
This productordocumentisprotectedbycopyrightanddistributedunderlicensesrestrictingitsuse,copying,distribution,anddecompilation.

No part of this productordocumentmaybereproducedinanyformbyanymeanswithoutpriorwrittenauthorizationofSunanditslicensors,
if any. Third-partysoftware,includingfonttechnology,iscopyrightedandlicensedfromSunsuppliers.

Parts of the productmaybederivedfromBerkeleyBSDsystems,licensedfromtheUniversityofCalifornia.UNIXisaregisteredtrademarkin
theU.S.andothercountries,exclusivelylicensedthroughX/OpenCompany, Ltd.ForNetscapeCommunicator™,thefollowingnoticeapplies:
(c) Copyright 1995 Netscape Communications Corporation. All rights reserved.

Sun, Sun Microsystems,theSunlogo,AnswerBook2,docs.sun.com,SunEnterprise,andSolarisaretrademarks,registeredtrademarks,or
service marks of Sun Microsystems,Inc.intheU.S.andothercountries.AllSPARC trademarks areusedunderlicenseandaretrademarksor
registeredtrademarksofSPARCInternational,Inc.intheU.S.and other countries. Products bearing SPARCtrademarksarebaseduponan
architecturedevelopedbySunMicrosystems,Inc.

The OPEN LOOK and Sun™ Graphical User Interface was developed by Sun Microsystems,Inc.foritsusersandlicensees.Sunacknowledges
the pioneering effortsofXeroxinresearchinganddevelopingtheconceptofvisualorgraphicaluserinterfacesforthecomputerindustry.Sun
holds a non-exclusive license fromXeroxtotheXeroxGraphicalUserInterface,whichlicensealsocoversSun’slicenseeswhoimplementOPEN
LOOK GUIs and otherwise comply with Sun’s written license agreements.

RESTRICTEDRIGHTS:Use, duplication, or disclosurebytheU.S.GovernmentissubjecttorestrictionsofFAR 52.227-14(g)(2)(6/87) and FAR

52.227-19(6/87), or DFAR252.227-7015(b)(6/95)andDFAR227.7202-3(a).
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONSANDWARRANTIES,

INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,FITNESSFORAPARTICULARPURPOSEORNON-INFRINGEMENT,
ARE DISCLAIMED, EXCEPT TOTHEEXTENTTHAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLYINVALID.

Copyright 1999 Sun Microsystems,Inc.,901SanAntonioRoad,PaloAlto,Californie94303-4900U.S.A.Tous droitsréservés.
Ce produitoudocumentestprotégéparun copyright et distribué avec des licences qui en restreignentl’utilisation,lacopie,ladistribution,etla

décompilation. Aucune partie de ce produitoudocumentnepeutêtrereproduitesousaucuneforme,parquelquemoyenquecesoit,sans
l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers, et qui comprendlatechnologie
relativeauxpolicesdecaractères,estprotégéparuncopyrightetlicenciépardesfournisseursdeSun.

Des parties de ce produitpourrontêtredérivéesdessystèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque
déposée aux Etats-Unis et dans d’autrespaysetlicenciéeexclusivementparX/OpenCompany, Ltd. La notice suivante est applicable à
Netscape

Sun, Sun Microsystems,lelogoSun,AnswerBook2,docs.sun.com,SunEnterprise,etSolarissontdesmarquesdefabriqueoudesmarques
déposées, ou marquesdeservice,deSunMicrosystems,Inc.auxEtats-Unisetdansd’autrespays.TouteslesmarquesSPARCsontutiliséessous
licence et sont des marquesdefabriqueoudesmarques déposées de SPARCInternational,Inc.auxEtats-Uniset dans d’autres pays. Les
produitsportantlesmarquesSPARCsontbaséssurunearchitecturedéveloppéeparSunMicrosystems,Inc.

L’interfaced’utilisationgraphiqueOPENLOOKetSun™aétédéveloppéeparSunMicrosystems,Inc.poursesutilisateursetlicenciés.Sun
reconnaîtleseffortsdepionniersdeXeroxpourlarechercheetledéveloppementduconceptdesinterfacesd’utilisationvisuelleougraphique
pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xeroxsurl’interfaced’utilisationgraphiqueXerox,cettelicence
couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outreseconformentaux
licences écrites de Sun.

CETTE PUBLICATIONESTFOURNIE"ENL’ETAT"ETAUCUNEGARANTIE,EXPRESSEOUIMPLICITE,N’ESTACCORDEE,YCOMPRIS
DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDEDELAPUBLICATIONAREPONDREAUNEUTILISATION
PARTICULIERE,OULEFAIT QU’ELLE NE SOIT PASCONTREFAISANTEDEPRODUITDETIERS.CEDENIDEGARANTIENE
S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.

Communicator™:(c)Copyright1995NetscapeCommunicationsCorporation.Allrightsreserved.

Please

Recycle

Sun Enterprise 10000 SSP Attributions:
This software is copyrighted by the Regents of the University of California, Sun Microsystems, Inc., and other

parties. The following terms apply to all files associated with the software unless explicitly disclaimed in individual
files.

The authors hereby grant permission to use, copy, modify, distribute, and license this software and its documentation
for any purpose, provided that existing copyright notices are retained in all copies and that this notice is included
verbatim in any distributions. No written agreement, license, or royalty fee is required for any of the authorized uses.
Modifications to this software may be copyrighted by their authors and need not follow the licensing terms described
here, provided that the new terms are clearly indicated on the first page of each file where they apply.

IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY FOR DIRECT,
INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF
THIS SOFTWARE, ITS DOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THE AUTHORS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND THE
AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT,
UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

RESTRICTED RIGHTS: Use, duplication or disclosure by the government is subject to the restrictions as set forth
in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software Clause as DFARS 252.227-7013
and FAR 52.227-19.

This is scotty, a simple tcl interpreter with some special commands to get information about TCP/IP networks.
Copyright (c) 1993, 1994, 1995, J. Schoenwaelder, TU Braunschweig, Germany, Institute for Operating Systems and
Computer Networks. Permission to use, copy, modify, and distribute this software and its documentation for any
purpose and without fee is hereby granted, provided that this copyright notice appears in all copies. The University
of Braunschweig makes no representations about the suitability of this software for any purpose. It is provided “as
is" without express or implied warranty.

Contents

Preface vii

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

Sun Enterprise 10000 Capacity on Demand 1.0 1

Software Requirements 2
Using a Spare SSP with Capacity on Demand 2

Switching From the Main SSP to the Spare SSP 2

Configuring Capacity on Demand Resources 3
License Keys 4

Tiered Licenses 4
Obtaining a License Key 4

▼ To Obtain the Primary Host ID for Your Sun Enterprise 10000 System 5

License Certificate 5

v

Installing the License Key 5

▼ To Install License Keys for Processors on an Existing Board 6
▼ To Install License Keys for Processors On a Board that Is Not in a Domain or

On a New Board 7

Blacklisting Processors 8
Capacity on Demand Daemon 9
License Violation Actions 9

Platform Log License Violation Message Examples 10
Email License Violation Message Example 11
/etc/motd License Violation Message Example 11
Broadcast License Violation Message Example 11

License Violation Messages 12
Capacity on Demand Secure Logging 13
Using Multiple Domains 13

▼ To Shut Down One Domain and Bring Up Another 14

Upgrading the SSP Software or Solaris Operating Environment 14

▼ To Upgrade the Solaris Operating Environment 15
▼ To Upgrade the SSP Software 15

vi Sun Enterprise 10000 Capacity on Demand 1.0 Administrator Guide • October 1999

Preface

This document describes how to obtain and install processor license keys for your
Sun Enterprise™ 10000 Capacity on Demand system, and the use of other Capacity
on Demand 1.0 features.

Before You Read This Book

This manual is intended for the Sun Enterprise 10000 system administrator who is
familiar with SSP administration. Refer to the Sun Enterprise 10000 SSP 3.1.1 User
Guide and Sun Enterprise 10000 SSP 3.1.1 Reference Manual. SSP 3.1.1 is the first
release of SSP software that supports Capacity on Demand 1.0. The Sun Enterprise
10000 system administrator must also have a working knowledge of UNIX®
systems, particularly those based on the Solaris™ operating environment. If you do
not have such knowledge, you must first read the Solaris User and System
Administrator AnswerBook2™ collections provided with this system, and consider
UNIX system administration training.

vii

Using UNIX Commands

This document does not contain information on basic UNIX commands and
procedures such as shutting down the system, booting the system, and configuring
devices.

See one or more of the following for this information:

■ AnswerBook online documentation for the Solaris software environment,

particularly those dealing with Solaris system administration

■ Other software documentation that you received with your system

Typographic Conventions

TABLEP-1 Typographic Conventions

Typeface or
Symbol Meaning Examples

AaBbCc123 The names of commands, files,

and directories; on-screen
computer output.

AaBbCc123 What you type, when contrasted

with on-screen computer output.

AaBbCc123 Book titles, new words or terms,

words to be emphasized

Command-line variable; replace
with a real name or value

viii Sun Enterprise 10000 Capacity on Demand 1.0 Administrator Guide • October 1999

Edit your .login file.

ls -a to list all files.

Use

% You have mail.
% su

Password:

Read Chapter 6 in the User’s Guide.
These are called class options.
You must be superuser to do this.

To delete a file, type

rm filename