Sun Microsystems Sun Fire 4810, Sun Fire 3800, Sun Fire 6800, Sun Fire 4800 Command Reference Manual

Download

Page 1

Sun Fire

™

6800/4810/4800/3800

System Controller

Command Reference Manual

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

Part No. 805-7372-11 April 2001, Revision A

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

Page 2

This product or documentis protectedby copyrightand distributed under licenses restrictingits use,copying, distribution, and decompilation. No part ofthis productor documentmay be reproduced inany form by any meanswithout priorwritten authorization of Sun and itslicensors, ifany.Third-party software,including fonttechnology,is copyrightedand licensedfrom Sunsuppliers.

Parts of the product maybe derivedfrom BerkeleyBSD systems,licensed fromthe University of California. UNIX is a registered trademarkin the U.S. and other countries, exclusively licensed through X/OpenCompany, Ltd.

Sun, Sun Microsystems,the Sunlogo, AnswerBook2,docs.sun.com, OpenBoot,Sun Fire,and Solarisare trademarks, registeredtrademarks, or service marks of Sun Microsystems,Inc. inthe U.S.and othercountries. AllSPARCtrademarks areused under license and aretrademarks or registeredtrademarks ofSPARCInternational, Inc. in the U.S. and other countries. Productsbearing SPARCtrademarks arebased uponan architecturedeveloped bySun Microsystems,Inc.UNIX is a registered trademarkin theUnited Statesand othercountries, exclusivelylicensed throughX/Open Company,Ltd.

The OPEN LOOK and Sun™ Graphical User Interface was developedbySun Microsystems,Inc. forits usersand licensees.Sun acknowledges the pioneering effortsof Xeroxin researchingand developing the concept of visual orgraphical userinterfaces forthe computerindustry.Sun holds a non-exclusive license fromXerox tothe XeroxGraphical User Interface, which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements.

Federal Acquisitions: CommercialSoftware—Government UsersSubject toStandard License TermsandConditions. DOCUMENTATION IS PROVIDED “AS IS”AND ALL EXPRESS OR IMPLIEDCONDITIONS, REPRESENTATIONSAND WARRANTIES,

INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Copyright 2001 Sun Microsystems, Inc.,901 SanAntonio Road• PaloAlto, CA94303 Etats-Unis.Tousdroits réservés. Ce produit oudocument estprotégé par un copyright et distribué avec des licences quien restreignentl’utilisation, la copie, la distribution,et la

décompilation. Aucune partie de ce produit oudocument nepeut êtrereproduitesous aucuneforme, parquelque moyenque cesoit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs delicence, s’ily ena. Lelogiciel détenupar destiers, etqui comprendla technologie relativeaux policesde caractères,est protégépar un copyright et licencié par des fournisseurs de Sun.

Des parties de ce produitpourront êtredérivées des systèmes Berkeley BSDlicenciés parl’Université deCalifornie. UNIXest unemarque déposée aux Etats-Uniset dansd’autres pays et licenciée exclusivement par X/Open Company, Ltd.

Sun, Sun Microsystems,le logoSun, AnswerBook2,docs.sun.com, OpenBoot,Sun Fire,,et Solarisdes marquesde fabrique ou des marques déposées, ou marquesde service,de SunMicrosystems, Inc.aux Etats-Uniset dansd’autres pays. Touteslesmarques SPARCsont utiliséessous licence et sont des marquesde fabriqueou desmarques déposées deSPARCInternational, Inc.aux Etats-Uniset dans d’autrespays. Les produitsportant lesmarques SPARCsont baséssur unearchitecture développée par Sun Microsystems,Inc. UNIXest unemarque enregistree aux Etats-Unis et dans d’autrespays etlicenciée exclusivementpar X/OpenCompany Ltd.

L’interfaced’utilisation graphique OPEN LOOK et Sun™ a été développéepar SunMicrosystems, Inc.pour sesutilisateurs etlicenciés. Sun reconnaîtles effortsde pionniersde Xeroxpour la rechercheet ledéveloppement duconcept desinterfaces d’utilisationvisuelle ougraphique pour l’industrie de l’informatique. Sun détient une licence non exclusive deXerox surl’interface d’utilisationgraphique Xerox,cette licence couvrant également leslicenciés deSun quimettent enplace l’interfaced’utilisation graphiqueOPEN LOOKet quien outrese conformentaux licences écrites de Sun.

CETTE PUBLICATION EST FOURNIE "EN L’ETAT" ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.

Please

Recycle

Page 3

Preface xv

1. Introduction to the System Controller 1

Platform Administration 2

Platform Shell 2 Platform Console 2

Domain Administration 3

Domain Shell and Domain Console 3

Accessing the System Controller Main Menu 5

Accessing the System Controller Main Menu Using telnet 5

▼ To Access the System Controller Main Menu and Enter the Platform Shell

Using telnet 5

▼ ToAccesstheSystemControllerMainMenuandEnteraDomainShellUsing

telnet 6

Accessing the System Controller Main Menu Using the Serial Port 9

▼ To Access the System Controller Main Menu if You Connected the System

Controller Serial Port to an ASCII Terminal 9

▼ ToAccess the System Controller Main Menu if You Connected the Serial Port

to a Network Terminal Server (NTS) 9

▼ To Obtain the Domain Shell Prompt From the Domain Console Prompt 10

iii

Page 4

System Controller Navigation 10

▼ To Enter the Domain Console From the Domain Shell If the Domain Is

Inactive 13

▼ To Enter the Domain Shell From the Domain Console 14 ▼ To Get Back to the Domain Console From the Domain Shell 14 ▼ To Enter a Domain From the Platform Shell 15 ▼ To Terminate a Session With telnet If You Are Connected to the Ethernet

Port 15

▼ To Terminate a Session With tip If You Are Connected to the Serial Port 16

2. System Controller Alphabetical Command Reference 17

System Controller Syntax, Command Names, Command Arguments, and

Comments 17 Command Syntax 17

Command Names 18 Command Arguments 18 Device Names 18 Board States 19 Status 20 Comments 20 Clearing an Entry 21

System Controller Command Summary 21 Status 23 Domain States 24

iv Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 5

Alphabetical Listing of System Controller Commands 25

addboard 25 break 28 connections 30 console 32 deleteboard 35 disablecomponent 37 disconnect 41 dumpconfig 43 enablecomponent 46 flashupdate 49 help 56 history 58 password 59 poweroff 61 poweron 64 reboot 67 reset 69 restoreconfig 72 resume 74 setdate 75 setdefaults 79 setkeyswitch 81 setupdomain 85 setupplatform 90 showboards 94 showcomponent 98

Contents v

Page 6

showdate 101 showdomain 103 showenvironment 107 showkeyswitch 111 showlogs 113 showplatform 115 showsc 120 testboard 121

Glossary 123

Index 125

vi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 7

Figures

FIGURE 1-1 Navigating Between the Platform Shell and the Domain Shell 11 FIGURE 1-2 Navigating Between the Domain Shell, the OpenBoot PROM, and the Solaris Operating

Environment 12

FIGURE 1-3 Navigating Between the OpenBoot PROM and the Domain Shell 13

vii

Page 8

viii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 9

Tables

TABLE 1-1 Maximum Number of Active Domains by System Type and Partition Mode 4 TABLE 2-1 Devices That Can Be Managed in the Platform Shell 18 TABLE 2-2 Devices That Can Be Managed in a Domain 19 TABLE 2-3 Board States 19 TABLE 2-4 Status Field Displayed in the showboards Command 20 TABLE 2-5 System Controller Command Summary 21 TABLE 2-6 Status Field Displayed in the showboards Command 23 TABLE 2-7 Header Description for CODE EXAMPLE 2-4 31

TABLE 2-8

component_name

Descriptions for the CPU/Memory Board Used in the

disablecomponent Command 38

TABLE 2-9

component_name

Descriptions for the I/O Assembly Used in the disablecomponent

Command 38

TABLE 2-10 dumpconfig Example 45

TABLE 2-11

component_name

Descriptions for the CPU/Memory Board Used in the enablecomponent

Command 46

TABLE 2-12

component_name

Descriptions for the I/O Assembly Used in the enablecomponent

Command 47

TABLE 2-13 enablecomponent Command Example Enabling CPU/Memory Board 4 48 TABLE 2-14 poweron Command Example Showing Powering On CPU/Memory Board 2 66 TABLE 2-15 poweron Command Example Showing Powering On I/O Assembly 7 66

Page 10

TABLE 2-16 poweron Command Example Showing Powering On All CPU/Memory Boards and I/O

Assemblies in Domain A 66

TABLE 2-17 Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich Mean Time 76 TABLE 2-18 setdate Command Example in the Platform Shell 77 TABLE 2-19 setkeyswitch Values and Description 82 TABLE 2-20 Results of Changing the Keyswitch From the Current Setting to a New Setting 82 TABLE 2-21 setkeyswitch on Example 84 TABLE 2-22 setkeyswitch off Example 84 TABLE 2-23 setkeyswitch off Example Shutting Down Domain B From the Platform Shell 84 TABLE 2-24 Parameter Values for the setupdomain Command 87 TABLE 2-25 setupplatform Parameter Values 91 TABLE 2-26 Output Header Definitions for the showboards -v Command 96

TABLE 2-27 showenvironment -p TABLE 2-28 showenvironment Output Header Description 108 TABLE 2-29 Definitions of Headings for Status of All Domains in CODE EXAMPLE 2-62 119 TABLE 2-30 testboard Example Testing CPU/Memory Board 0 122

part

Descriptions 108

x Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 11

Code Samples

CODE EXAMPLE 1-1 Accessing the System Controller With telnet and Entering the Platform Shell 6 CODE EXAMPLE 1-2 Accessing a Domain Shell Using the telnet Command 7 CODE EXAMPLE 1-3 Accessing a Domain Shell From the Domain Console 8 CODE EXAMPLE 1-4 Accessing a Domain Shell From the Domain Console 10 CODE EXAMPLE 1-5 Obtaining a Domain Shell From the Domain Console 14 CODE EXAMPLE 2-1 addboard Example in the Platform Shell 26 CODE EXAMPLE 2-2 addboard Example in the Domain Shell 27 CODE EXAMPLE 2-3 break Command Example in the Domain Shell 29 CODE EXAMPLE 2-4 connections Command for the Platform Shell 31 CODE EXAMPLE 2-5 console Example With the -d Option and No Password Assigned Accessing Domain

B 33

CODE EXAMPLE 2-6 console Example Without the -d Option and No Password Assigned Accessing Domain

B 33

CODE EXAMPLE 2-7 console Example With the -d Option and A Password Assigned Accessing Domain A 33 CODE EXAMPLE 2-8 console Example Without the -d Option and A Password Assigned Accessing Domain

A 34

CODE EXAMPLE 2-9 deleteboard Example Showing Deleting I/O Assembly 7 36 CODE EXAMPLE 2-10 deleteboard Example Showing Deleting CPU/Memory Board 3 36 CODE EXAMPLE 2-11 disablecomponent Command Example Adding sb4 to the Blacklists 40 CODE EXAMPLE 2-12 disablecomponent Command Example Adding sb0 CPU Port 3 to the Blacklist 40 CODE EXAMPLE 2-13 disablecomponent Command Example Adding sb2, CPU Port 3, and Physical Bank 0

to the Blacklists 40

Page 12

CODE EXAMPLE 2-14 disablecomponent Command Example Adding I/O Assembly 9, Port 0 and Bus 1 and

Also I/O Assembly 8, I/O Card 2 to the Blacklists 40

CODE EXAMPLE 2-15 Disconnecting a Session From the System Controller Platform Shell 42 CODE EXAMPLE 2-16 Disconnecting a Session From the System Controller Platform Console 42 CODE EXAMPLE 2-17 disconnect Example Showing Disconnecting a Session From the Domain A Shell 42 CODE EXAMPLE 2-18 enablecomponent Command Example Enabling I/O Assembly 6 and Port 1 48 CODE EXAMPLE 2-19 Example of the flashupdate Command Entering Single-User Mode 52 CODE EXAMPLE 2-20 flashupdate Example Updating the Active System Controller Board and the System

Controller Real Time Operating System 54

CODE EXAMPLE 2-21 flashupdate Example Updating System Boards (CPU/Memory Boards and I/O

Assemblies) 54

CODE EXAMPLE 2-22 flashupdate Example Updating CPU/Memory Board 4 54 CODE EXAMPLE 2-23 flashupdate Example Updating I/O Assembly 8 54 CODE EXAMPLE 2-24 flashupdate Example Updating the System Controller Real Time Operating System 55 CODE EXAMPLE 2-25 help Command Example Displaying Information on the addboard Command 57 CODE EXAMPLE 2-26 help Command Example Displaying Commands Beginning With the Word show 57 CODE EXAMPLE 2-27 help Command Example Displaying Commands Beginning With the Letter A 57 CODE EXAMPLE 2-28 history Command 58 CODE EXAMPLE 2-29 password Command Example With No Password Set 60 CODE EXAMPLE 2-30 password Command Example With a Password Already Set 60 CODE EXAMPLE 2-31 poweroff Command Example Showing Powering Off CPU/Memory Board 2 63 CODE EXAMPLE 2-32 poweroff Command Example Showing Powering Off All Power Supplies and Currently

Controllable Boards in the Platform Shell 63

CODE EXAMPLE 2-33 poweroff Command Example Showing Powering Off All CPU/Memory Boards and I/O

Assemblies in Domain A 63

CODE EXAMPLE 2-34 poweroff Command Example Showing Powering Off

I/O Assembly 7 63

CODE EXAMPLE 2-35 reset Command Example From Domain A 71 CODE EXAMPLE 2-36 reset -a Command Example From Domain A 71 CODE EXAMPLE 2-37 reset Command Example Resetting ssc0 From ssc1 in the Platform Shell 71 CODE EXAMPLE 2-38 restoreconfig Example 73 CODE EXAMPLE 2-39 resume Command Example in Domain A 74

xii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 13

CODE EXAMPLE 2-40 setdate -r Command Example Setting the Date From a Date Host 78 CODE EXAMPLE 2-41 setdate -t Command Example Setting the Time Zone to Pacific Standard Time Using

the Offset From Greenwich Mean Time 78

CODE EXAMPLE 2-42 setdate -t Command Example Setting the Time Zone to Eastern Standard Time Using

Time Zone Abbreviations and Also Setting the Date 78

CODE EXAMPLE 2-43 setdate -t Command Example Setting the Time Zone to Japan Standard Time Using

the Offset From Greenwich Mean Time 78

CODE EXAMPLE 2-44 setdate -t Command Example Setting the Time Zone to Eastern Central Time Using

Time Zone Abbreviations 78

CODE EXAMPLE 2-45 setdefaults Example 80 CODE EXAMPLE 2-46 Variables for the setupdomain Command 86 CODE EXAMPLE 2-47 Output From setupplatform Command 93 CODE EXAMPLE 2-48 showboards Command for the Platform Shell 95 CODE EXAMPLE 2-49 showboards -v Command for the Platform Shell 95 CODE EXAMPLE 2-50 showboards Command for the Domain Shell 97 CODE EXAMPLE 2-51 showcomponent sb4 Sample Output 99 CODE EXAMPLE 2-52 showcomponent ib6 Sample Output 100 CODE EXAMPLE 2-53 showdate Command for the Platform Shell 102 CODE EXAMPLE 2-54 showdate Command for the Domain Shell 102 CODE EXAMPLE 2-55 showdomain Command Example 104 CODE EXAMPLE 2-56 showdomain -v Command Example 105 CODE EXAMPLE 2-57 showdomain -p bootparams Example Displaying Boot Parameter Information 106 CODE EXAMPLE 2-58 showenvironment Platform Shell and Domain Shell Example 110 CODE EXAMPLE 2-59 showkeyswitch Example Showing the Keyswitch Set to On 112 CODE EXAMPLE 2-60 showkeyswitch Example Showing the Keyswitch Set to Off 112 CODE EXAMPLE 2-61 showkeyswitch Example Showing the Keyswitch Set to Standby 112 CODE EXAMPLE 2-62 showplatform Output for a Sun Fire 6800 System 116 CODE EXAMPLE 2-63 showplatform -v Output for a Sun Fire 6800 System 117 CODE EXAMPLE 2-64 showsc Command 120

Code Samples xiii

Page 14

xiv Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 15

Preface

This book describes how to use the system controller command line interface, which controls the system functions and provides environmental monitoring plus domain and hardware control. With the system controller software, you can configure the platform and domains, as well as power on and off domains, power supplies, fans, and other components. The system controller also provides a platform console and a domain console.

Before You Read This Book

This book is for system administrators, who have a working knowledge of the

™

Solaris first read the Solaris User and System Administrator AnswerBooks and consider UNIX

operating environment. If you do not have such knowledge, you should

system administration training.

How This Book Is Organized

This book contains the following chapters: Chapter 1 introduces you to the system controller. It explains the platform shell and

the domain shell. It also describes the responsibilities of the platform administrator and the domain administrator. It provides step-by-step procedures on how to enter the platform shell and the domain shell of the system controller, how to navigate within the system controller, between the system controller and the Solaris operating environment, and between the OpenBoot explains how to terminate a system controller session.

™

PROM and the system controller. It also

Page 16

Chapter 2 explains system controller command syntax, command names, and command arguments. It also provides in tabular form a summary of all of the system controller commands and provides complete descriptions, with syntax, and examples for each system controller command.

Typographic Conventions

Typeface Meaning Examples

AaBbCc123 The names of commands, files,

and directories; on-screen computer output

AaBbCc123

AaBbCc123 Book titles, new words or terms,

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

words to be emphasized

Edit your .login file. Use ls -a to list all files.

% su Password:

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

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

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 # Platform shell Domain shell schostname:A> or B>, C>, D>

xvi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

schostname:SC>

Page 17

Accessing Sun Documentation Online

The docs.sun.comsmweb site enables you to access a select group of Sun technical documentation on the Web. You can browse the docs.sun.com archive or search for a specific book title or subject at:

http://docs.sun.com

Ordering Sun Documentation

fatbrain.com, an Internet professional bookstore, stocks select product documentation from Sun Microsystems, Inc.

For a list of documents and how to order them, visit the Sun Documentation Center on fatbrain.com at:

http://www.fatbrain.com/documentation/sun

Preface xvii

Page 18

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can email your comments to Sun at:

docfeedback@sun.com

Please include the part number of your document, which is on the title page, in the subject line of your email.

xviii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 19

CHAPTER

Introduction to the System Controller

This chapter introduces you to the system controller. It explains the platform shell and the domain shell. It describes the responsibilities of the platform administrator and the domain administrator . It provides step-by-step procedures and illustrations on how to navigate with the system controller and between the system controller and the Solaris operating environment and the OpenBoot PROM. It also explains how to terminate a system controller session.

The system controller consists of the System Controller board and the system controller software. The system controller provides communication pathways between the system controller and domains.

The system controller software does the following:

■ Monitors and controls the system

■ Manages hardware

■ Configures domains

■ Provides the date and time to the Solaris operating environment

■ Provides the clock signal used on all system boards

■ Provides a platform console and a domain console

The following topics are covered in this chapter:

■ “Platform Administration” on page 2

■ “Domain Administration” on page 3

■ “Accessing the System Controller Main Menu” on page 5

■ “System Controller Navigation” on page 10

Page 20

Platform Administration

The platform administration function provides services for the domain and provides access to hardware available within the platform. With this function, you can manage hardware resources across domains.

Some of the functions include:

■ Logically grouping hardware to create domains with the addboard and

deleteboard commands

■ Setting passwords with the password command

■ Monitoring and controlling power to the components within a platform.

■ Configuring the system controller, the network, loghosts, and SNMP

■ Defining the maximum number of domains a system can support

■ Defining access control for CPU/Memory boards and I/O assemblies

Platform Shell

With the platform shell, you can use commands that pertain to the platform. Specifically, the platform shell is the operating environment for the platform administrator, and is the shell where platform tasks can be performed.

You can access the platform shell with a telnet session (if your system controller is networked) and/or a serial connection. Log messages go to the platform shell’s serial (RS-232) connection (console). The prompt is schostname:SC>.

Platform Console

A platform console is a platform shell that is connected through the serial (RS-232) port.

The platform console provides messages specific to the platform. However, the platform console does not show the Solaris operating environment messages. These messages are displayed in the domain console.

2 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 21

Domain Administration

Some of the he domain administrator’s responsibilities include:

■ Controlling the virtual domain keyswitch. A domain administrator can put the

keyswitch in on, off, diag, standby, or secure keyswitch positions.

■ Managing the domain using the Sun

Sun Fire 6800/4810/4800/3800 systems.

■ Recovering from errors

■ Setting the date, time, and time zone with the setdate command. You can set

each domain a different setting.

■ Configuring domain specific parameter values with the setupdomain command.

Domain Shell and Domain Console

This section presents information on these topics:

■ “Domain Shell” on page 3

■ “Domain Console” on page 4

■ “Connecting to a Domain” on page 4

■ “Maximum Number of Domains” on page 4

Domain Shell

™

Management Center software for the

If . . . You are connected to . . .

the Solaris operating environment or the OpenBoot PROM is not active in the domain (domain keyswitch is set to standby or off, which means the domain is inactive)

Domain shell. The prompt is

schostname:domainID>. For example, schostname:A>.

Chapter 1 Introduction to the System Controller 3

Page 22

Domain Console

If . . . You can access . . .

the Solaris operating environment is running or the domain is in OpenBoot PROM mode, which means the domain is

active

Domain console (ok, login, #,or% prompts). Additionally, you can also see POST output, enter the debugger, or enter the OpenBoot PROM

Connecting to a Domain

When you connect to a domain, if the domain is active you will be connected to the domain console. Otherwise, you will be connected to the domain shell.

Maximum Number of Domains

TABLE 1-1 lists the maximum number of domains you can have per system type

depending on the partition mode set with the setupplatform command.

TABLE1-1 Maximum Number of Active Domains by System Type and Partition Mode

System Name

Maximum Number of Active Domains in Single Partition Mode

Maximum Number of Active Domains in Dual Partition Mode

Sun Fire 6800 system 2 (A-B) 4 (A-D)* Sun Fire 4810 system 2 (A,C) 2 (A, C)* Sun Fire 4800 system 2 (A,C) 2 (A, C)* Sun Fire 3800 system 2 (A,C) 2 (A, C)*

With the Sun Fire 6800 system, domains A and B are in partition 0 and domains C and D are in partition 1. With the Sun Fire 4810/4800/3800 systems, domain A is in partition 0 and domain C is in partition 1.

For additional information on Repeater boards and domains in both single partition mode and dual partition mode, see “Repeater Board” on page 98.

4 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 23

Accessing the System Controller Main Menu

This section describes the following:

■ “Accessing the System Controller Main Menu Using telnet” on page 5

■ “Accessing the System Controller Main Menu Using the Serial Port” on page 9

Accessing the System Controller Main Menu Using telnet

This section describes:

■ “To Access the System Controller Main Menu and Enter the Platform Shell Using

telnet” on page 5

■ “To Access the System Controller Main Menu and Enter a Domain Shell Using

telnet” on page 6

▼ To Access the System Controller Main Menu and

Enter the Platform Shell Using telnet

1. Access the system controller main menu by typing telnet schostname .

where: schostname is the system controller host name. The system controller main menu is displayed (

example shows entering the platform shell.

Chapter 1 Introduction to the System Controller 5

CODE EXAMPLE 1-1). The following

Page 24

CODE EXAMPLE 1-1 Accessing the System Controller With telnet and Entering the

% telnet schostname Trying xxx.xxx.xxx.xxx Connected to schostname-sc0. Escape character is ’^]’.

System Controller schostname-sc0

Type 0 for Platform Shell

Type 1 for domain A Type 2 for domain B

Type 3 for domain C Type 4 for domain D

Input: 0

Platform Shell

schostname-sc0

Platform Shell

2. Type 0 to enter the platform shell.

You can also type P or p to enter the platform shell. The system controller prompt for the platform or shell you connected to is

displayed.

schostname:SC>.

CODE EXAMPLE 1-1 shows entering the platform shell whose prompt is

▼ To Access the System Controller Main Menu and

Enter a Domain Shell Using telnet

1. Access the system controller main menu by typing telnet schostname .

where: schostname is the system controller host name.

The system controller main menu is displayed ( The following example shows entering the domain A shell.

6 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

CODE EXAMPLE 1-2).

Page 25

CODE EXAMPLE 1-2 Accessing a Domain Shell Using the telnet Command

% telnet schostname Trying xxx.xxx.xxx.xxx Connected to schostname-sc0. Escape character is ’^]’.

System Controller schostname-sc0:

Type 0 for Platform Shell

Type 1 for domain A Type 2 for domain B

Type 3 for domain C Type 4 for domain D

Input: 1

Connected to Domain A

Domain Shell for Domain A

schostname:A>

2. Enter a domain. Type 1, 2, 3,or4 (or alternatively a, b, c, d,orA, B, C, D) to enter the proper domain shell.

The system controller prompt for the domain shell you connected to is displayed.

CODE EXAMPLE 1-2 shows entering the domain A shell whose prompt is

schostname:A>.

3. If the domain is active (the domain keyswitch is set to on, diag, or secure which means you are running the Solaris operating environment, are in the OpenBoot PROM, or are running POST), perform the following steps:

a. Press and hold the CTRL key while pressing the ] key, to get to the telnet>

prompt.

Chapter 1 Introduction to the System Controller 7

Page 26

b. At the telnet> prompt type send break (see CODE EXAMPLE 1-3).

CODE EXAMPLE 1-3 Accessing a Domain Shell From the Domain Console

ok Ctrl-] telnet> send break

schostname:A>

8 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 27

Accessing the System Controller Main Menu Using the Serial Port

With the serial port, you can connect to one of three types of devices:

■ ASCII terminal

■ Network terminal server (NTS)

■ Workstation

The procedure is different for each type of device.

▼ To Access the System Controller Main Menu if

You Connected the System Controller Serial Port to an ASCII Terminal

1. Connect the system controller serial port to an ASCII terminal.

The system controller main menu is displayed.

2. From the main menu type 0 to enter the platform shell.

You can also type P or p to enter the platform shell (

CODE EXAMPLE 1-1).

▼ To Access the System Controller Main Menu if

You Connected the Serial Port to a Network Terminal Server (NTS)

1. Connect the system controller serial port to a Network Terminal Server (NTS).

2. Type the following telnet command at the Solaris operating environment prompt:

machinename% telnet NTShostname|IPaddress [port]

The system controller main menu is displayed.

3. Type 0 to enter the platform shell.

You can also type P or p, instead of typing 0, to enter the platform shell (

CODE EXAMPLE 1-1).

Chapter 1 Introduction to the System Controller 9

Page 28

▼ To Obtain the Domain Shell Prompt From the

Domain Console Prompt

If the domain is active and the domain keyswitch is set to on, diag, or secure (you are running the Solaris operating environment, are in the OpenBoot PROM, or are running POST), perform the following steps:

1. Press and hold the CTRL key while pressing the ] key, to get to the telnet> prompt.

2. At the telnet> prompt type send break.

CODE EXAMPLE 1-4 shows a connection to domain A.

CODE EXAMPLE 1-4 Accessing a Domain Shell From the Domain Console

ok Ctrl-] telnet> send break

schostname:A>

System Controller Navigation

This section explains how to navigate between the:

■ System controller platform

■ System controller domain console

■ System controller domain shell

To return to the origin shell, use the disconnect command. In a domain shell to connect to the domain console, use the resume command. To connect to a domain shell from the platform shell, use the console command.

CODE EXAMPLE 1-1 shows how to navigate between the platform shell, the domain

shell, the domain console by using the console and disconnect commands.

FIGURE 1-1 also illustrates how to connect to both the domain shell and platform shell

from the Solaris operating environment by using the telnet command.

10 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 29

Type: telnet schostname 500x

Domain shell

disconnect

Type:

disconnect

Type:

Type: telnet schostname 5000

Type:

disconnect

Type: console

domainID

Platform shell

FIGURE 1-1 Navigating Between the Platform Shell and the Domain Shell

where: In the telnet command in

FIGURE 1-1, 5000 is the platform shell.

x is:

■ 1 for domain A

■ 2 for domain B

■ 3 for domain C

■ 4 for domain D

In the console command, domainID is a, b, c, or d.

Note – By typing telnet schostname 500x, you directly enter the platform shell or

one of the domain shells. You will bypass the system controller main menu.

FIGURE 1-2 illustrates how to navigate between the Solaris operating environment,

the OpenBoot PROM, and the domain shell.

FIGURE 1-2 assumes that the Solaris

operating environment is running.

Chapter 1 Introduction to the System Controller 11

Page 30

Solaris operating

environment login:

OpenBoot PROM ok

Press: CTRL ]

At the telnet>

prompt type:

send break

Domain shell schostname:domainID

FIGURE 1-2 Navigating Between the Domain Shell, the OpenBoot PROM, and the Solaris

Note – Note that in FIGURE 1-2 typing the break command suspends the Solaris

operating environment.

FIGURE 1-3 illustrates how to navigate between the OpenBoot PROM and the domain

shell. This figure assumes that the Solaris operating environment is not running.

Type: resume Type: break

Operating Environment

12 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 31

OpenBoot PROM ok

Domain shell

schostname:domainID

FIGURE 1-3 Navigating Between the OpenBoot PROM and the Domain Shell

When you enter a domain console, you will be connected with the Solaris operating environment console. If either POST or the OpenBoot PROM is running, you will be connected with either the POST or the OpenBoot PROM output.

▼ To Enter the Domain Console From the Domain

Shell If the Domain Is Inactive

Press: CTRL ]

At the telnet>

prompt type:

send break

Type: resume

● Type setkeyswitch on in the domain shell.

schostname:A> setkeyswitch on

The domain console is only available when the domain is active. To make the domain active, you must turn the keyswitch on. You will be automatically switched from the domain shell to the domain console.

This action powers on and initializes the domain. The domain will go through POST and then the OpenBoot PROM. If the OpenBoot PROM auto-boot? parameter is set to true, the Solaris operating environment will boot.

Chapter 1 Introduction to the System Controller 13

Page 32

▼ To Enter the Domain Shell From the Domain

Console

1. Press and hold the CTRL key while pressing the ] key to get to the telnet> prompt (

2. Type send break at the telnet prompt.

The schostname:A> (or B>, C>, D>) prompt is displayed.

CODE EXAMPLE 1-5 Obtaining a Domain Shell From the Domain Console

ok Ctrl-] telnet> send break

schostname:A>

CODE EXAMPLE 1-5).

▼ To Get Back to the Domain Console From the

Domain Shell

1. Type resume::

schostname:A> resume

2. Press the Enter key to get a prompt.

If the domain is not active, (the Solaris operating environment or the OpenBoot PROM is not running), the system controller stays in the domain shell.

Domain A is not active.

schostname:A>

14 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 33

▼ To Enter a Domain From the Platform Shell

Note – This example shows entering an inactive domain.

● Type:

schostname:SC> console -d a

Connected to Domain A

Domain Shell for Domain A

schostname:A>

If the OpenBoot PROM is running, you are returned to the domain A console. If the keyswitch is set to off or standby, you are returned to the domain A shell.

Note – To enter another domain, type the proper domainID b, c,ord, instead of

typing a.

▼ To Terminate a Session With telnet If You Are

Connected to the Ethernet Port

● Type the disconnect command at the domain shell prompt.

schostname:A> disconnect

Connection closed by foreign host. machine_name_prompt%

Your system controller session terminates.

Chapter 1 Introduction to the System Controller 15

Page 34

▼ To Terminate a Session With tip If You Are

Connected to the Serial Port

If you are connected to the System Controller board with the serial port, use the disconnect command to terminate the system controller session then use a tip (Transfer Internet Protocol) command to terminate your tip session.

1. Type disconnect to disconnect from the system controller session.

2. At the Solaris operating environment prompt, type ~. to terminate your tip session.

schostname:A> disconnect

Connection closed by foreign host. machine_name_prompt% ~.

Your system controller session terminates.

16 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 35

CHAPTER

System Controller Alphabetical Command Reference

This chapter describes system controller command line interface, command syntax, and command arguments. It provides, in tabular form, a summary of all of the system controller commands. It also provides complete descriptions and examples for each system controller command.

System Controller Syntax, Command Names, Command Arguments, and Comments

Command Syntax

The general syntax of system controller commands is:

command_name [option flags] [arguments]

Note – The system controller commands can be partially typed if what is typed is

enough to make the command unique.

Page 36

Command Names

Most system controller commands are in the form of verbnoun. Command names are in the English language. System controller commands are case insensitive.

Command Arguments

Some system controller commands have arguments and some system controller commands do not have arguments. Depending on the command, some arguments are followed by flags and others are not. A few examples include:

■ help

■ help -v

■ showboards sb0

■ showboards -v sb0

Device Names

TABLE 2-1 shows the device names that can be managed in the platform shell. You can

type the device names in either upper case or lower case in both

TABLE 2-5.

TABLE 2-1 and

Note – The devices in TABLE 2-1 and TABLE 2-2 depend on the system you have. For

example, only the Sun Fire 6800 system can have six power supplies and six CPU/Memory boards. In a domain, you can manage devices only if they are assigned to a domain.

TABLE2-1 Devices That Can Be Managed in the Platform Shell

Device Description Device Name

Power grids GRID0, GRID1 Power supplies PS0, PS1, PS2, PS3, PS4, PS5 CPU/Memory boards SB0, SB1, SB2, SB3, SB4, SB5 I/O assemblies IB6, IB7, IB8, IB9 Repeater boards RP0, RP1, RP2, RP3 Fan trays FT0, FT1, FT2, FT3 System controller SC0, SC1

18 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 37

TABLE 2-2 shows the devices that can be managed in a domain.

TABLE2-2 Devices That Can Be Managed in a Domain

Device Description Device Name

CPU/Memory boards SB0, SB1, SB2, SB3, SB4, SB5 I/O Assemblies IB6, IB7, IB8, IB9

Board States

TABLE 2-3 lists the board states. These board states are displayed by the showboards

command. For some commands, such as addboard and deleteboard, you need to determine the board state with showboards before you can execute the addboard or deleteboard command.

TABLE2-3 Board States

Board States Description

Available The board is not assigned to any domain. Assigned The board belongs to a domain, but the hardware has not been

configured or it is not in use.

Active The board is being actively used by the domain to which it has been

assigned. You cannot reassign an active board.

To determine the board state, use the showboards command and look under the State header.

Chapter 2 System Controller Alphabetical Command Reference 19

Page 38

Status

TABLE 2-4 describes the Status field displayed in the showboards command.

TABLE2-4 Status Field Displayed in the showboards Command

Test Status Description

Passed All board components passed testing. Failed The board failed testing and is not usable. This could also indicate

corrupt or incompatible firmware.

OK The component is functioning properly (power supply, fan tray, or

Repeater board). Under Test The domain is running POST (power-on self-test). Not Tested The board is not been tested. Degraded Certain components on the board have failed or are disabled. A

board is in degraded mode when there are still usable parts on the

board.

- The slot is empty or not applicable for this device.

Comments

You can separate system controller commands with a semicolon (;) on the same line. For example:

schostname:

SC> addboard -d a sb2;deleteboard sb3

In the previous example, both the addboard and deleteboard commands are executed.

A pound sign ( # ) signifies the start of a comment on the current line. For example:

schostname:SC> addboard -d a sb2 #this text is ignored

In the previous example, the addboard command is executed. Everything you type after the # and before pressing the Return key is ignored.

20 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 39

If you type the following line, board sb2 is added to domain A and the deleteboard command is not executed.

schostname:SC> addboard -d a sb2 # deleteboard sb2

Another example of the pound sign (#) signifying the start of a comment at the beginning of a command line is:

schostname:SC> # this text is ignored

Clearing an Entry

You use the dash ( - ) to clear the entry in a command.

System Controller Command Summary

TABLE 2-5 lists and describes the system controller commands and how you can

access them. Many commands are accessible from both the platform shell and the domain shell. The system controller commands may differ in how they are used, the effect of the command, and the scope of the command between the platform and domain shells.

TABLE2-5 System Controller Command Summary

Command Description Platform Shell Domain Shell

addboard Assigns a board to a domain. x x break Sends a Break signal to the domain. x connections Displays connections to the system

controller or to a domain.

console Connects to a domain from the platform

shell.

deleteboard Unassigns a board or a slot from a domain. x x disablecomponent Adds a component to the blacklist. x x disconnect Disconnects the current specified

connection.

Chapter 2 System Controller Alphabetical Command Reference 21

Page 40

TABLE2-5 System Controller Command Summary (Continued)

Command Description Platform Shell Domain Shell

dumpconfig Saves the system controller configuration to

a server.

enablecomponent Deletes a component from the blacklist. x x flashupdate Updates the ﬂash PROMs on CPU/Memory

x boards, I/O assemblies, and the System Controller boards.

help Provides basic help information for system

xx controller commands.

history Shows the command history with date and

xx time stamps.

password Sets the shell password. There are separate

xx passwords for the platform connection and each domain connection.

poweroff Powers off components. x x poweron Powers on components. x x reboot Reboots the system controller. x reset Resets the domain in the domain shell or

xx the other system controller in the platform shell.

restoreconfig Restores the system controllerconfiguration

x from a server.

resume Exits the domain shell and resumes access

to the domain console.

setdate Sets the time, date, and time zone for the

xx platform and each domain.

setdefaults Resets the system controller to the default

xx values.

setkeyswitch Changes the keyswitch position. x x setupdomain Configures domain specific variables. x setupplatform Conﬁgures platform speciﬁc variables. x showboards Shows status, assignment, and board

xx information for boards in the system.

showcomponent Displays detailed information about a

xx component.

showdate Displays the time, date, and the timezone for

xx the platform or for domains.

22 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 41

TABLE2-5 System Controller Command Summary (Continued)

Command Description Platform Shell Domain Shell

showdomain Displays the conﬁguration and status of the

domain.

showenvironment Displays the current environmental status,

temperatures, currents, and voltages.

showkeyswitch Displays the virtual keyswitch setting. x x showlogs Displays the logs. x x showplatform Displays the conﬁguration of the platform,

the status of a domain, and SNMP information.

showsc Displays the system controller uptime and

version.

testboard Tests the CPU/Memory board you specify at

the command line.

Status

TABLE 2-6 describes the Status field displayed in the showboards command.

TABLE2-6 Status Field Displayed in the showboards Command

Test Status Description

Passed All board components passed tests. Failed A component fails when there are no usable parts on the board. OK The component is functioning properly (power supply, fan tray, or

Repeater board). Under Test The domain is running POST (power-on self-test). Not Tested No testing has been done. – (dash) The slot is empty or disabled. Not applicable for this device. Degraded Certain components on the board have failed or are in the blacklist.

A board is in degraded mode when there are still usable parts on the

board.

Chapter 2 System Controller Alphabetical Command Reference 23

Page 42

Domain States

In the showplatform and showdomain commands, one of the fields in the command output is domain status. The major values of domain status are:

■ Active-Solaris

■ Active-OpenBoot PROM

■ Active-Booting

■ Running POST

■ Standby

■ Powered off

24 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 43

Alphabetical Listing of System Controller Commands

The following sections describe the system controller commands.

addboard

Assigns a board or a slot to a domain.

Scope

platform shell, domain shell

Syntax

addboard -d domainID system_board_name [system_board_name ...] addboard -h

Options/Parameters

-h displays help for this command. system_board_name is the board to be added. Possible values for system_board_name

are sb0–sb5 (CPU/Memory board) or ib6 - ib9 (I/O assembly).

-d domainID is the domain where the board will be added. The domainID is a, b, c, or d.

Chapter 2 System Controller Alphabetical Command Reference 25

Page 44

Description

Assigns system_board_name to the specified domain within the platform shell or to the current domain. The board state must be Available. To display the board states, use the showboards command. For more information on board states, see “Board States” on page 19.

In order to assign a board to a domain, the board name must be listed in the Access Control List (ACL) for domain shells. When a board is listed in the ACL, the system controller software is allowed to process addboard requests on that board.

The Access Control List (ACL) is ignored in the platform shell. The platform shell always has permission to add or delete boards. Even if a board is not in the domain’s ACL, when you type the addboard command from the platform shell, this overrides the ACL.

If a board is not present, the command assigns ownership of the slot to the specified domain.

Example—Platform Shell

To add board name sb2 to domain A, type:

CODE EXAMPLE 2-1 addboard Example in the Platform Shell

schostname:SC> addboard -d a sb2

Although a message is sent to the Solaris operating environment about a new board being added, there is not a client in the Solaris operating environment that reads these messages. Therefore, these messages will not be seem by the Solaris operating environment.

26 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 45

Example—Domain Shell

To add board name sb2 to the current domain, type:

CODE EXAMPLE 2-2 addboard Example in the Domain Shell

schostname:A> addboard sb2

If you cannot assign a board to a domain in the domain shell, this is most likely because the board is not listed in the ACL. See the “Description“ section for more information. Another possibility is that the domain is currently in use. An error message will tell you the reason why you can not perform the operation.

Chapter 2 System Controller Alphabetical Command Reference 27

Page 46

break

Sends a break signal to the domain console.

Scope

domain shell

Syntax

break [-y|-n] break -h

Options/Parameters

-h displays help for this command.

-y answers yes to the warning message. Does not prompt for confirmation.

-n answers no to the warning message. Does not execute this command if

confirmation is requested.

Description

Sends a Break signal to the domain console.

Note – This command pauses the Solaris operating environment.

When the Solaris operating environment is running in the domain, the usual effect of the break signal is to force entry into OpenBoot PROM or the debugger. The Solaris operating environment will ignore the break signal if the keyswitch is set to secure.

Example

CODE EXAMPLE 2-3 shows using the break command to pause the Solaris operating

environment and enter the OpenBoot PROM.

CODE EXAMPLE 2-3 break Command Example in the Domain Shell

schostname:A> break

Chapter 2 System Controller Alphabetical Command Reference 29

Page 48

connections

Displays connections to the system controller or a domain.

Scope

platform shell, domain shell

Syntax for the Platform Shell

connections [-d domainID] connections -h

Syntax for the Domain Shell

connections [-h]

Options/Parameters

-h displays help for this command.

-d domainID shows connections to the specified domain (a, b, c, or d).

Description

Displays hosts currently connected to the system controller. The platform shell shows the connections to the platform shell and to each domain shell (or to the specified domain). The domain shell displays the information shown in

CODE EXAMPLE 2-4, which is described in TABLE 2-7.

Example—Platform Shell

CODE EXAMPLE 2-4 connections Command for the Platform Shell

schostname:SC> connections

ID Hostname Idle Connected on Connected to

-- -------- ---- ------------ -----------1 XXXXXXX - Jan 01 00:00 Platform 2 XXX - Jan 01 00:21 A

TABLE 2-7 describes the headers in the output for CODE EXAMPLE 2-4.

TABLE2-7 Header Description for CODE EXAMPLE 2-4

Header Column in

CODE EXAMPLE 2-4 Description

ID Connection ID. This is a unique number. Use this number to

disconnect a specific session.

Hostname Source of the connection for this session. If the value is

localhost, the connection was established through the platform.

Idle Amount of time the session is sitting without any activity. Displays

a dash ( - ) if the session is active.

Connected on Date and time the connection was initiated. The format is

Mon dd hh:mm.

Connected to Shell or console this session is connected to. Possible values are

Platform or domainIDs a, b, c, or d.

Chapter 2 System Controller Alphabetical Command Reference 31

Page 50

console

Connects to a domain from the platform.

Scope

platform shell

Syntax

console [-d] domainID console -h

Options/Parameters

-h displays help for this command. [-d] domainID is the domain to connect to and is a, b, c,ord. The -d parameter is

optional and does not need to precede the domainID.

Description

Opens a domain connection. You use the console command to navigate from the platform to a domain. If a password was created for connecting to this domain, you must enter the password.

Examples—Platform Shell

When there is no password initialized for this domain:

CODE EXAMPLE 2-5 console Example With the -d Option and No Password Assigned

Accessing Domain B

schostname:SC> console -d b

Connected to Domain B

Domain Shell for Domain B

schostname:B>

When there is no password initialized for this domain, you could also type:

CODE EXAMPLE 2-6 console Example Without the -d Option and No Password

Assigned Accessing Domain B

schostname:SC> console b

Connected to Domain B

Domain Shell for Domain B

schostname:B>

When a password is set for this domain:

CODE EXAMPLE 2-7 console Example With the -d Option and A Password Assigned

Accessing Domain A

schostname:SC> console -d a

Password:

Permission Granted Connected to Domain A

Domain Shell for Domain A

schostname:A>

Chapter 2 System Controller Alphabetical Command Reference 33

Page 52

When a password is set for this domain, you could also type:

CODE EXAMPLE 2-8 console Example Without the -d Option and A Password Assigned

Accessing Domain A

schostname:SC> console a

Password:

Permission Granted Connected to Domain A

schostname:A>

34 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 53

deleteboard

Unassigns a board or a slot from the domain where it is currently assigned.

Scope

platform shell, domain shell

Syntax for the Platform Shell and the Domain Shell

deleteboard system_board_name [system_board_name ...] deleteboard [-h]

Options/Parameters

-h displays help for this command. system_board_name is the board to be deleted. Values are sb0 to sb5 (CPU/Memory

board) and ib6 to ib9 (I/O assembly).

Description

Unassigns a board from the domain where it is currently assigned. The CPU/Memory board or the I/O assembly board status must be in the Assigned state. The board name must be listed in the Access Control List (ACL) for domain shell from which you want to unassign the board.

Type the showboards command to display the board state. A slot does not need to be occupied with a board before you can unassign it from a domain.

Example—Platform Shell

To delete I/O assembly ib7, type:

CODE EXAMPLE 2-9 deleteboard Example Showing Deleting I/O Assembly 7

schostname:SC> deleteboard ib7

The platform shell always has permission to add or delete boards.

Example—Domain Shell

To delete CPU/Memory board sb3 from the current domain, domain A, type:

CODE EXAMPLE 2-10 deleteboard Example Showing Deleting CPU/Memory Board 3

schostname:A> deleteboard sb3

The domain shell can delete boards only from the current domain.

36 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 55

disablecomponent

Adds a component to the blacklist.

Scope

platform shell, domain shell

Syntax

disablecomponent component_name [component_name . . .] disablecomponent -h

Options/Parameters

-h displays help for this command. component_name is (see

■ system_board_name/port/physical_bank/logical_bank for the CPU/Memory board

■ system_ board_name/port/bus for an I/O assembly

■ system_board_name/card for an I/O assembly

TABLE 2-8 and TABLE 2-9):

Note – You can use partial component names.

Chapter 2 System Controller Alphabetical Command Reference 37

Page 56

TABLE2-8 component_name Descriptions for the CPU/Memory Board Used in the

disablecomponent Command

Board or Device Component Name

CPU system board_name/port/physical_bank/logical_bank CPU/Memory

SB0, SB1, SB2, SB3, SB4, SB5

boards

system_board_name)

( Ports on the

P0, P1, P2, P3

CPU/Memory board Physical memory

B0, B1 banks on CPU/Memory boards

Logical banks on

L0, L1, L2, L3 CPU/Memory boards

TABLE2-9 component_name Descriptions for the I/O Assembly Used in the

disablecomponent Command

Board or Device Component Name

I/O assembly

board_name/port/bus or board_name/card system

I/O assemblies

system_board_name)

( Ports on the I/O

IB6, IB7, IB8, IB9

P0, P1 assembly

Buses on the I/O

B0, B1 assembly

I/O cards in the I/O assembly

38 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

C0, C1, C2, C3, C4, C5, C6, C7—the number of cards varies with the

I/O assembly

Page 57

Description

This command adds a component to the blacklist. Blacklisting provides a list of system board components that will not be tested and will not be configured into the domain when you change the domain’s keyswitch from an inactive state to an active state or when the domain is rebooted.

The blacklists are stored in non-volatile memory. Blacklist a component or device if you believe it may be failing intermittently.

Devices can be the following (see

■ CPU ports (CPU processors)

■ Physical and logical memory banks

■ I/O ports

■ I/O buses

■ I/O cards

TABLE 2-8 and TABLE 2-9):

The platform shell blacklists supersede the domain shell blacklists. For example, if a component is disabled in the platform shell, it will always be disabled in all domains.

Blacklisting from the platform shell applies to all domains. Blacklisting in a domain applies only to the current domain. If you disable a component in a domain and then move the component to another domain, the component is not disabled.

Examples

This example of the disablecomponent command adds system_board_name sb4 to the blacklist.

CODE EXAMPLE 2-11 disablecomponent Command Example Adding sb4 to the

Blacklists

schostname:A> disablecomponent sb4

This example of the disablecomponent command adds system_board_name sb0 and CPU port 3 to the blacklist. Note that any memory banks on this CPU processor port are unreachable and are implicitly disabled.

CODE EXAMPLE 2-12 disablecomponent Command Example Adding sb0 CPU Port 3 to

the Blacklist

schostname:A> disablecomponent sb0/p3

This example of the disablecomponent command adds system_board_name sb2, CPU processor port 3, physical bank 0 to the blacklists. Note that any logical banks belonging to this physical bank are disabled.

CODE EXAMPLE 2-13 disablecomponent Command Example Adding sb2, CPU Port 3,

and Physical Bank 0 to the Blacklists

schostname:A> disablecomponent sb2/p3/b0

This example of the disablecomponent command adds system_board_name ib9, port 0, bus 1 and board_name ib8, I/O card 2 to the blacklists. Disabling I/O card 2 shuts down the power to that I/O card.

CODE EXAMPLE 2-14 disablecomponent Command Example Adding I/O Assembly 9,

Port 0 and Bus 1 and Also I/O Assembly 8, I/O Card 2 to the Blacklists

schostname:A> disablecomponent ib9/p0/b1 ib8/c2

40 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 59

disconnect

Disconnects the current or specified connection.

Scope

platform shell, domain shell

Syntax for the Platform Shell

disconnect [ID] disconnect -h

Syntax for the Domain Shell

disconnect [-h]

Options/Parameters

-h displays help for this command. ID (platform shell only) is the connection to be terminated. ID is the number

displayed under the heading ID for the connections command.

Description

Terminates a connection to the system controller. If this command is used with no arguments, it disconnects the current session. For illustrations of the disconnect command, see

If the connection was initiated from another system, you will be returned to the remote host. If the session was initiated from the platform shell, this command displays the platform shell prompt. If you are connected from the serial port, then you will return to the main menu.

FIGURE 1-1 in “System Controller Navigation” on page 10.

Examples

To disconnect a session from the system controller platform shell with a telnet connection (

CODE EXAMPLE 2-15 Disconnecting a Session From the System Controller Platform Shell

schostname:SC> disconnect

Connection closed by foreign host.

If you are connected to the system controller platform console with the serial connection, you will see the following after typing disconnect:

CODE EXAMPLE 2-15), type:

CODE EXAMPLE 2-16 Disconnecting a Session From the System Controller Platform

Console

schostname:SC> disconnect

Type 0 for Platform Shell

Type 1 for domain A Type 2 for domain B

Type 3 for domain C Type 4 for domain D

Input:

To disconnect a session from a system controller domain shell, type:

CODE EXAMPLE 2-17 disconnect Example Showing Disconnecting a Session From the

Domain A Shell

schostname:A> disconnect

Connection closed by foreign host.

Note – When you disconnect from a domain shell, you will obtain the parent shell

prompt (either the remote host prompt or the platform shell prompt).

42 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 61

dumpconfig

Saves the platform and domain configurations to a server.

Scope

platform shell

Syntax

dumpconfig -f url dumpconfig -h

Options/Parameters

-h displays help for this command.

-f specifies the URL, which can only be ftp. For example: ftp://userid:password@host/path ftp://host/path

Note – The hostname you enter must be a complete host name (not a partial one).

Note – The directory specified in the URL path must have write permission,

including user access. Also, make sure that the data files are present in the URL.

Chapter 2 System Controller Alphabetical Command Reference 43

Page 62

Description

Use this command after you complete the initial configuration of the platform and the domains. This command saves the system controller configuration to a server. The data files include schostname .nvci and schostname.tod.

Caution – Run this command when you change platform or domain configurations.

For more information, see the following bulleted list of system controller commands that change the configuration. Also, run this command whenever you change the hardware configuration.

Invoking this command is very important because if the System Controller board fails and you did not use this command to save the platform and domain configurations, you will have to manually reconfigure the platform and the domains.

Run the dumpconfig command again after configuration changes are made to the system controller, for example with the following system controller commands:

■ setupdomain

■ setupplatform

■ setdate

■ addboard

■ deleteboard

■ enablecomponent

■ disablecomponent

■ password

■ setkeyswitch

or whenever you change the hardware configuration. By running again this command, the new platform and domain configurations are saved to a server.

This command is intended to be used as part of the procedure in replacing a failed System Controller board. You should not use this command to revert to an old configuration. The showplatform, showdomain, and showboards system controller commands display all of the configuration and can be used as a reference.

If you need to replace the System Controller board, this configuration information can be used to restore the platform and domain configurations to the replacement System Controller board.

Example

TABLE2-10 dumpconfig Example

schostname:SC> dumpconfig -f ftp://hostname/path_name

Created: ftp://host/path_name/schostname.nvci Created: ftp://

host/path_name/schostname.tod

Chapter 2 System Controller Alphabetical Command Reference 45

Page 64

enablecomponent

Deletes a component from the blacklist.

Scope

platform shell, domain shell

Syntax

enablecomponent component_name [component_name . . .] enablecomponent -h

Options/Parameters

-h displays help for this command. component_name is (

■ system_board_name/port/physical_bank/logical_bank for CPU/Memory boards

■ system_board_name/port/bus for an I/O assembly

■ system_board_name/card for an I/O assembly

TABLE2-11 component_name Descriptions for the CPU/Memory Board Used in the

TABLE 2-11 and TABLE 2-12):

enablecomponent Command

Board or Device Component Name

CPU system board_name/port/physical_bank/logical_bank CPU/Memory

boards

system_board_name)

( Ports on the

CPU/Memory board Physical memory

banks on CPU/Memory boards

Logical banks on CPU/Memory boards

SB0, SB1, SB2, SB3, SB4, SB5

P0, P1 ,P2, P3

B0, B1

L0, L1, L2, L3

46 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 65

TABLE2-12 component_name Descriptions for the I/O Assembly Used in the

enablecomponent Command

Board or Device Component Name

I/O assembly system

I/O assemblies

system_board_name)

( Ports on the I/O

assembly Buses on the I/O

assembly I/O cards in the I/O

assembly

board_name/port/bus or board_name/card

IB6, IB7, IB8, IB9

P0, P1

B0, B1

C0, C1, C2, C3, C4, C5, C6, C7—the number of cards varies with the I/O assembly

Description

Removes a component from the blacklist. Blacklisting provides a list of system board components that will not be tested and will not be configured into the domain when you change the keyswitch setting from an inactive state to an active state or when the domain is rebooted. The blacklists are stored in non-volatile memory.

Components can be the following:

■ CPU ports (CPU processors)

■ Physical and logical memory banks

■ I/O ports

■ I/O buses

■ I/O cards

Using this command, the platform shell blacklists supersede the domain shell blacklists. For example, if a component is enabled in the platform shell, it will be enabled in all domains.

To enable a component that you previously disabled with the disablecomponent command in one or more shells or the platform, you must enable it in the same shells it was disabled.

Chapter 2 System Controller Alphabetical Command Reference 47

Page 66

Examples

This example of the enablecomponent command enables CPU/Memory board sb4. This removes CPU/Memory board sb4 from the blacklist.

TABLE2-13 enablecomponent Command Example Enabling CPU/Memory Board 4

schostname:A> enablecomponent sb4

This example of the enablecomponent command enables I/O assembly 6, port 1. This removes port 1 of I/O assembly 6 from the blacklist.

CODE EXAMPLE 2-18 enablecomponent Command Example Enabling I/O Assembly 6

schostname:A> enablecomponent ib6/p1

and Port 1

48 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 67

flashupdate

Updates the flash PROMs in the system controller and the system boards (CPU/Memory boards and I/O assemblies). The source flash image can be on a server or another board of the same type.

Scope

platform shell

Syntax

Options/Parameters

-h displays help for this command.

-y does not prompt for confirmation.

-n does not execute this command if confirmation is required.

-f speciﬁes a URL as the source of the ﬂash images

url is the URL to the directory containing the flash images.

where:

ftp://hostname/path ftp://[userid:password@]hostname/path

(userid:password@ is dependent on the system setup)

http://hostname/path http://[userid:password@]hostname/path

The hostname you enter must be a complete host name (not a partial one).

board is the board name.

Chapter 2 System Controller Alphabetical Command Reference 49

Page 68

-c specifies a board as the source of flash images.

■ source_board is the source board for the flash images.

■ destination_board is the destination board for the flash images.

-u automatically updates all of the boards from the board with the highest revision. all updates the system controller and all system boards (CPU/Memory boards and

I/O assemblies). This option does not update the system controller real time operating system (rtos).

system_boards are all CPU/Memory boards and I/O assemblies. scapp updates the current system controller. Updating the system controller reboots

the system controller twice. To update the other system controller, you must run the flashupdate command from the other system controller. Use showsc to determine which system controller is active.

rtos updates the real time operating system for the system controller. This action reboots the system controller twice.

domainID (a, b, c or d) is the domain where the flash PROMs on the board will be updated.

Caution – Any boards without power will not be updated.

Description

Updates the flash PROMs on the System Controller board, CPU/Memory board, I/O assembly, and the port of the system controller. There are no flash PROMs on Repeater boards.

When you update the flash images, if you can do so, make sure the images are compatible. To verify the compatibility of the versions of scapp, CPU/Memory board, and I/O assembly PROMs, use the showboards -p proms command. There is currently no method to determine that the scapp and rtos versions are compatible. Check all versions before you upgrade with the flashupdate command. If you fail to check all versions, the domains may crash or the system controller would fail to reboot normally.

50 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 69

All boards that are specified must be powered on and must be capable of being updating with the flashupdate command. Otherwise, the flashupdate command will not execute. Boards that are in a secure domain will not be updated.

Any time boards, the scapp,orrtos images are upgraded, check the Release Notes for any notes or special procedures.

Caution – Under normal circumstances, the flashupdate command will complete

successfully. However, if the flashupdate command is terminated abnormally (such as a power failure, a failed network connection, and so on), the system controller goes into single user mode.

CODE EXAMPLE 2-19 is a sample output showing the system controller entering single-

user mode.

Chapter 2 System Controller Alphabetical Command Reference 51

Page 70

CODE EXAMPLE 2-19 Example of the flashupdate Command Entering Single-User Mode

RTOS version: 17 ScApp version: 5.11.3 SC POST diag level: min

Auto Flashupdate S_errno_ECONNREFUSED http://

hostname/5.11.1/sgrtos.flash: cannot open file

Retrieving: http:/

hostname/5.11.1/sgrtos.flash

Flashupdate failed.

Single User Mode

The date is Thursday, February 15, 2001, 9:22:00 AM PST.

Feb 15 09:22:03 schostname Chassis-Port.SC: WARNING: hostid information is missing Feb 15 09:22:03 schostname Chassis-Port.SC: Clock source: 75MHz Feb 15 09:22:05 schostname Chassis-Port.SC: Starting Maintenance Thread

Platform Shell

schostname:SC> schostname:SC> help

Platform Shell commands:

dumpconfig -- save the system controller configuration to a server flashupdate -- update flash prom images help -- show help for a command or list commands history -- show shell command history reboot -- reboot the system controller reset -- reset the other system controller restoreconfig -- restore the system controller configuration from a server

schostname:SC>

To bring the system controller out of single-user mode and back into its normal operating mode, type the flashupdate command with a valid URL or use the reboot command to boot the system controller with an older firmware version.

52 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 71

flashupdate Command Platform Shell—Examples

Note – In the following examples, since the output is very long, only the command

syntax you type is in the code box.

Note – For the flashupdate all, flashupdate all rtos, flashupdate

scapp, and the flashupdate rtos commands, all of these commands cause the

system controller to reboot twice—one time to upgrade and one time to boot the new firmware.

■ To update the flash PROMs on the system controller and all CPU/Memory boards

and I/O assemblies, make sure that all boards and assemblies are powered on. If a board or assembly is powered off, the flashupdate operation will fail. Type:

schostname:SC> flashupdate -f ftp://host/path all

That command reboots the system controller.

■ To update the flash PROMs on all CPU/Memory boards, I/O assemblies, and the

system controller real time operating system (rtos), type:

schostname:SC> flashupdate -f ftp://host/path all rtos

That command reboots the system controller.

■ To update the flash PROMs on the system controller, perform this procedure from

the platform console or watch the console output. Type:

schostname:SC> flashupdate -f ftp://host/path scapp

That command reboots the system controller.

Chapter 2 System Controller Alphabetical Command Reference 53

Page 72

■ To update the active System Controller board and the system controller real time

operating system (rtos), perform this procedure from the platform console or watch the console output. Type:

CODE EXAMPLE 2-20 flashupdate Example Updating the Active System Controller

Board and the System Controller Real Time Operating System

schostname:SC> flashupdate -f ftp://host/path scapp rtos

This reboots the system controller.

■ To upgrade the flash PROMs on all CPU/Memory boards and I/O assemblies

(system boards), make sure that all boards and assemblies are powered on. If a board or assembly is powered off, the flashupdate operation will fail. Type:

CODE EXAMPLE 2-21 flashupdate Example Updating System Boards (CPU/Memory

Boards and I/O Assemblies)

schostname:SC> flashupdate -f ftp://host/path systemboards

Reboot the domain containing the system boards that were updated in order to take advantage of the new features and bug fixes.

■ To upgrade the flash PROMs on CPU/Memory board 4 (SB4), type:

CODE EXAMPLE 2-22 flashupdate Example Updating CPU/Memory Board 4

schostname:SC> flashupdate -f ftp://host/path sb4

Reboot the domain containing the CPU/Memory board that was updated in order to take advantage of the new features and bug fixes.

■ To upgrade the flash PROMs on I/O assembly 8 (IB8), type:

CODE EXAMPLE 2-23 flashupdate Example Updating I/O Assembly 8

schostname:SC> flashupdate -f ftp://host/path ib8

Reboot the domain containing the I/O assembly that was updated in order to take advantage of the new features and bug fixes.

54 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 73

■ To update the system controller real time operating system ( rtos), perform this

procedure from the platform console or watch the console output. Type:

CODE EXAMPLE 2-24 flashupdate Example Updating the System Controller Real Time

Operating System

schostname:SC> flashupdate -f ftp://host/path rtos

This reboots the system controller.

Chapter 2 System Controller Alphabetical Command Reference 55

Page 74

help

Without arguments, lists currently available system controller commands. When an argument is supplied, displays command usage of what you specified and a short description.

Scope

platform shell, domain shell

Syntax

help [command_name]|[partial_command_name] help -h

Options/Parameters

-h displays help for this command.

command_name is the name of the system controller command. partial_command_name can be one letter of the command or a portion of the

command name, such as show.

Description

The help command, without arguments, lists currently available commands in the system controller. When an argument is supplied, the help command displays a list of commands that begin with the specified argument. If only one command if found, full help is displayed. Otherwise, a short description is displayed for each command, beginning with the specified argument.

The help command is shell sensitive. It displays help information for the current shell only.

Examples

To display help information on the addboard command::

CODE EXAMPLE 2-25 help Command Example Displaying Information on the addboard

Command

schostname:SC> help addboard

addboard -- assign a board to a domain

Usage: addboard -d <domain> <board> ... addboard -h

-d -- the domain to assign the board to

-h -- display this help message

To display all commands in the platform shell beginning with show:

CODE EXAMPLE 2-26 help Command Example Displaying Commands Beginning With the

Word show

schostname:SC> help show

showboards -- show board information showcomponent -- show state of a component showdate -- show the current date and time for the domain showenvironment -- show environment sensors showkeyswitch -- show the keyswitch position showlogs -- show the logs

To display all commands in the platform shell beginning with the letter a:

CODE EXAMPLE 2-27 help Command Example Displaying Commands Beginning With the

Letter A

schostname:SC> help a

addboard -- assign a board to a domain

Usage: addboard -d <domain> <board> ... addboard -h

-d -- the domain to assign the board to

-h -- display this help message

Chapter 2 System Controller Alphabetical Command Reference 57

Page 76

history

Shows the command history with date and time stamps.

Scope

platform shell, domain shell

Syntax

history [-h]

Options/Parameters

-h displays help for this command.

Description

Shows the command history with date and time stamps for when the commands were executed. This command is shown for your shell and displays the last twenty commands only.

Example

CODE EXAMPLE 2-28 history Command

schostname:SC> history

1 : showboards May 07 10:39:14 2 : showdate May 07 10:39:30 3 : history May 07 10:39:47

58 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 77

password

Sets the password for the platform or the domain.

Scope

platform shell, domain shell

Syntax—Platform Shell

password [-d domainID] password -h

Syntax—Domain Shell

password password -h

Options/Parameters

-h displays help for this command.

-d

-domainID is domain a, b, c, or d.

Description

Sets the password for the platform or the domain. There are separate passwords for each domain and for the platform. If you set a password, entering the password is required for access.

It is very important to set the password for the platform and each domain even if a domain is not being used. This prevents people from creating and activating unauthorized domains.

Prior to allowing the password to be changed, the current password will be authenticated. Changed passwords take effect immediately. The old password will no longer be accepted.

You can remove the password by pressing Return at the Enter new password and Enter new password again prompts.

Chapter 2 System Controller Alphabetical Command Reference 59

Page 78

OpenBoot PROM passwords are different from the platform and domain passwords. The OpenBoot PROM in each domain supports the OpenBoot PROM security mode, which is a standard feature of the OpenBoot PROM software. For more information on the OpenBoot PROM security mode password, see your OpenBoot PROM documentation.

Examples

You will see the following prompt (CODE EXAMPLE 2-29), when a password is already set and you type the password command at either the platform shell or the domain shell.

CODE EXAMPLE 2-29 password Command Example With No Password Set

schostname:SC> password

Enter new password: Enter new password again:

schostname:SC>

If currently there is not a password assigned to the shell you are entering, you will not be prompted for the current password (

CODE EXAMPLE 2-30 password Command Example With a Password Already Set

schostname:SC> password

Enter current password: Enter new password: Enter new password again:

schostname:SC>

60 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

CODE EXAMPLE 2-30).

Page 79

poweroff

Powers off a component (power grid, power supply, board, fan tray), or a list of components.

Scope

platform shell, domain shell

Syntax for the Platform Shell

poweroff [-y|-n] all|grid#|device_name [device_names . . . ] poweroff -h

Syntax for the Domain Shell

poweroff [-y|-n] all|device_name [device_names . . . ] poweroff -h

Options/Parameters

-h displays help for this command.

-y will answer yes to any questions. This option is potentially hazardous. You can

forcefully power off a component with the -y option.

-n answers no to any questions. You cannot forcefully power off a component with

the -n option. For a list of devices you power off, see the “Description” section.

Chapter 2 System Controller Alphabetical Command Reference 61

Page 80

Description

Powers off a component or a list of components. You must specify device_name(s). The components that can be powered off in the platform shell are:

■ all turns off all currently controllable boards.

■ Power grid (grid0, grid1). The Sun Fire 6800 system has two power grids: grid0

and grid1. Grid 1 controls power supplies ps3, ps4, and ps5. All other mid-range systems have one power grid, grid0. This grid controls power supplies ps0, ps1, and ps2.

■ Power supply (ps0 - ps5)

■ CPU/Memory board (sb0 - sb5)

■ I/O assembly (ib6 - ib9)

■ Repeater board (rp0 - rp3)

■ Fan tray (ft0 - ft3)

The components that can be powered off in a domain shell are:

■ CPU/Memory board (sb0 - sb5)

■ I/O assembly (ib6 - ib9)

For the domain shell, the specified board must be in the current domain. All slots listed by showboards can be powered off except for system controllers

(SSC0 and SSC1) and the ID board. A powered-off component will not be monitored. Use the showboards command to display the power status of each board.

You can power off any component except when the board is in the Active state (see the showboards command to display the board state). When a component is in the Active state, you are asked to confirm with a warning of the consequences. If a board is active, a warning is displayed on the console advising you that the entire domain will go down.

If a board is active in a domain and you forcefully power off a device (board), the keyswitch for the domain will be set to standby. To change the keyswitch setting, use the setkeyswitch command.

Repeater boards do not have an Active state. You cannot power off a Repeater board because it is being used by the domain.

If the power supplies are needed to supply power to the boards and fans, you cannot power off the power supplies. If you power off a power supply, there might be insufficient power to support the current load.

If the fan trays are needed to cool the system, you cannot power them off because powering off fan trays result in insufficient cooling of the system.

62 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 81

Examples

To power off CPU/Memory board, sb2 from the platform shell, type:

CODE EXAMPLE 2-31 poweroff Command Example Showing Powering Off

schostname:SC> poweroff sb2

CPU/Memory Board 2

To power off all power supplies and currently controllable boards, type:

CODE EXAMPLE 2-32 poweroff Command Example Showing Powering Off All Power

schostname:SC> poweroff all

Supplies and Currently Controllable Boards in the Platform Shell

To power off all CPU/Memory boards and I/O assemblies in domain A, type:

CODE EXAMPLE 2-33 poweroff Command Example Showing Powering Off All

schostname:A> poweroff all

CPU/Memory Boards and I/O Assemblies in Domain A

To power off I/O assembly, ib7 from domain A, type:

CODE EXAMPLE 2-34 poweroff Command Example Showing Powering Off

schostname:A> poweroff ib7

I/O Assembly 7

Note – From the domain shell, you cannot power off power supplies, fan trays,

Repeater boards, or power grids. To power off these components, connect to the platform shell.

Chapter 2 System Controller Alphabetical Command Reference 63

Page 82

poweron

Powers on a component (power grid, power supply, board, fan tray, or a list of components).

Scope

platform shell, domain shell

Syntax for the Platform Shell

poweron all|grid#|device_name [device_names . . . ] poweron -h

Syntax for the Domain Shell

poweron all|device_name [device_names . . . ] poweron -h

Options/Parameters

-h displays help for this command. For the grids and devices you can power on, see the “Description” section.

64 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 83

Description

Powers on a device or a list of devices You must specify device_name(s). The components that can be powered on in the platform shell are:

■ all is all power supplies and boards.

■ Power grid (grid0, grid1). The Sun Fire 6800 system has two power grids: grid0

and grid1. Grid 1 controls power supplies ps3, ps4, and ps5. All of the other midrange systems have one power grid, grid0. All other mid-range systems have one power grid, grid0. This grid controls power supplies ps0, ps1, and ps2.

■ Power supply (ps0 - ps5)

■ CPU/Memory board (sb0 - sb5)

■ I/O assembly (ib6 - ib9)

■ Repeater board (rp0 - rp3)

■ Fan tray (ft0 - ft3)

The components that can be powered on in a domain shell are:

■ all powers on all CPU/Memory boards and I/O assemblies in the domain

■ CPU/Memory board (sb0 - sb5)

■ I/O assembly (ib6 - ib9)

For the domain shell, the board status must be assigned to the current domain. You can power on any component except when the board is in the Active state (see the showboards command to display the board state). When a component is in the Active state, you are asked to confirm with a warning of the consequences. Repeater boards do not have an Active state.

The fan trays power on automatically if any power supply is on. With the Sun Fire 6800/4810/4800 systems the power supplies power on automatically if a power supply in the same power grid is on. With the Sun Fire 3800 system, if grid power is on and the power supply switch is turned to the on position and the power cord is connected, the power supply powers on automatically.

Examples

To power on CPU/Memory board, sb2 from the platform shell, type:

TABLE2-14 poweron Command Example Showing Powering On CPU/Memory Board 2

schostname:SC> poweron sb2

To power on I/O assembly, ib7, type:

TABLE2-15 poweron Command Example Showing Powering On I/O Assembly 7

schostname:SC> poweron ib7

To power on CPU/Memory boards and I/O assemblies in the domain, type:

TABLE2-16 poweron Command Example Showing Powering On All CPU/Memory

Boards and I/O Assemblies in Domain A

schostname:A> poweron all

Note – From the domain shell, you cannot power on power supplies, Repeater

boards, fan trays, or power grids. To power on these components, use the platform shell.

66 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 85

reboot

Reboots the system controller.

Scope

platform shell

Syntax

reboot [-y|-n] reboot -h

Options/Parameters

-y does not prompt for confirmation.

-n does not execute this command, confirmation is requested.

-h displays help for this command.

Description

Reboots the system controller. The reboot command will not change any configuration settings. Active domains will continue to run.

If you reboot the system controller while the keyswitch operation is in progress, the keyswitch is set to standby when the system controller completes rebooting.

Example

To reboot the system controller, type:

schostname:SC> reboot

To reboot the system controller with the -n option, type:

schostname:SC> reboot -n

Are you sure you want to reboot the System Controller now? no (-n)

The -n option prompts you with the Areyousure...prompt to answer. Type y if you are sure you want to reboot the system controller. Type n if you do not want to reboot the system controller at this time.

68 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 87

reset

Resets the domain (in a domain shell) or the other system controller (in the platform shell).

Scope

platform shell, domain shell

Syntax for the Platform Shell

reset [-y|-n] sscx reset -h

Syntax for the Domain Shell

Note – In the domain shell, typing reset, without options, is the same as typing

reset -x.

reset [-y|-n][-x|-a] reset -h

Options/Parameters—Platform Shell

-y answers yes to the question asked (executes the command).

-n answers no to the question asked (does not execute the command).

-h displays help for this command.

sscx(xis 0 or 1) performs a hardware reset of the other system controller.

Caution – The second System Controller board is installed in the system for clock

failover. Do not use the second System Controller board unless it is necessary to reset the primary System Controller board.

Chapter 2 System Controller Alphabetical Command Reference 69

Page 88

Options/Parameter—Domain Shell

-h displays help for this command.

-x resets via XIR (externally initiated reset). Uses XIR to try to obtain diagnostic data

(default).

-a reset is equivalent to the OpenBoot PROM reset-all command.

-y resets even if the domain is active.

-n does not reset if the domain is active.

Description—Platform Shell

To perform software reset on the other System Controller board, use ssc1 if you are using ssc0. If you are using ssc1, use ssc0. Clock failover will be automatically enabled after the reset is complete. Messages will be displayed on the platform console.

Description—Domain Shell

Resetting the domain is not allowed if the keyswitch is in the secure, off, or standby positions.

By default, reset uses XIR (externally initiated reset) to reset the CPU processors in the domain. The externally initiated reset forces control of the domain into the OpenBoot PROM and begins the OpenBoot PROM error reset recovery actions. The error reset recovery actions preserve most domain states to allow collecting data needed for debugging the hardware and software, including a Solaris operating environment core file. The OpenBoot PROM error reset recovery actions are controlled by setting the OpenBoot PROM error-reset-recovery configuration variable. For the definition of this variable and the various settings, see Section , “setupdomain” on page 2-85.

TABLE 2-24 in

You cannot reset a domain that has been paused. The domain is paused automatically when hardware detects an error. Messages on the domain console indicate that the domain is paused. To rectify this situation, turn the keyswitch off with setkeyswitch off. Then, turn the keyswitch on with setkeyswitch on.

Examples

To reset the domain (from a domain shell), type::

CODE EXAMPLE 2-35 reset Command Example From Domain A

schostname:A> reset

This command uses XIR (externally initiated reset) to try to obtain diagnostic data. To perform the equivalent operation as the OpenBoot PROM reset-all command,

type:

CODE EXAMPLE 2-36 reset -a Command Example From Domain A

schostname:A> reset -a

To reset system controller ssc0 from ssc1, type:

CODE EXAMPLE 2-37 reset Command Example Resetting ssc0 From ssc1 in the

Platform Shell

schostname:SC> reset ssc0

Chapter 2 System Controller Alphabetical Command Reference 71

Page 90

restoreconfig

Restores the platform and domain configurations from a server.

Scope

platform shell

Syntax

restoreconfig [-y|-n] -f url restoreconfig -h

Options/Parameters

-h displays help for this command.

-y does not prompt for confirmation.

-n does not execute this command is confirmation is required.

-f specifies a URL to restore from. url is the directory containing the data files. The supported protocols are ftp and

http. For example:

ftp://[userid:password]@hostnam/path ftp://hostname/path http://[userid:password]@hostnam/path http://hostname/path

Note – The hostname you enter must be a complete host name (not a partial one).

Description

Restores the platform and domain configurations based on two data files: schostanme.nvci and schostname.tod at the specified URL. This process requires that the Solaris operating environment must be halted in each domain. Also, all domains must be powered off with the setkeyswitch off command.

72 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 91

Use this command when the System Controller board failed and after a working System Controller board is installed. You can also use this command when you want to restore the previous system controller configuration.

When the system controller configuration is restored, the system controller is rebooted. Set the date and time for the platform and for each domain using the setdate command.

The domains should be restored to their state when the configuration was stored. For example, if a domain was active, it should be activated immediately. After running the restoreconfig command, check the state of the domains.

Example

CODE EXAMPLE 2-38 shows an example of the restoreconfig command with the

required -f option

CODE EXAMPLE 2-38 restoreconfig Example

schostname:SC> restoreconfig -f ftp://host/path

The system controller will be rebooted when the restore is complete. The date will need to be set in the platform and each domain.

Do you want to restore the system controller configuration now [no] yes

Retrieving: ftp://host/ Retrieving: ftp://host/ Verifying data NVCI has been restored TOD has been restored

Restore complete. The system controller is being rebooted. The date will need to be set in the platform and each domain.

Software Reset . . .

path/schostname.nvci path/schostname.tod

Chapter 2 System Controller Alphabetical Command Reference 73

Page 92

resume

Exits the domain shell and resumes access to the domain console.

Scope

domain shell

Syntax

resume resume -h

Options/Parameters

-h displays help for this command.

Description

Exits the domain shell and resumes access to the domain console.

Example

CODE EXAMPLE 2-39 resume Command Example in Domain A

Domain A Shell

schostname:A> showboards

Slot Pwr Component Type State Status Domain

---- --- -------------- ------ ------ -----SB0 On CPU Board Active Passed A IB6 On PCI I/O Board Active Passed A

schostname:A> resume

74 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 93

setdate

Sets the date, time, and time zone for the platform and for domains.

Scope

platform shell, domain shell

Syntax

setdate [-v] [-t tz] [mmdd]HHMM[[cc]yy[.SS] setdate [-v] [-r datehost] setdate [-v] -t tz setdate [-v] -t GMT<+|->offset from GMT ( setdate -h

TABLE 2-17)

Options/Parameters

-t tz sets the time zone using the time zone abbreviation (see TABLE 2-17). Only non- daylight savings time zones can be set. If you are in an area with daylight time or summer time, this is set automatically.

-t GMT<+|->offset from Greenwich Mean Time—GMT (see mm = month number, dd = day number in the month, HH = hour number (24-hour

system), MM = minute number, cc = century minus 1, yy = last two digits of the year number, and SS = second number. For the century minus 1 value, use 21 (Twenty first century) minus 1, which yields 20.

-r datehost sets the current time using rdate. The host must be a valid system.

-v is verbose mode. Displays detailed information about the time zone that is set.

-h displays help for this command.

TABLE 2-17).

Chapter 2 System Controller Alphabetical Command Reference 75

Page 94

TABLE2-17 Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich

Mean Time

Time Zone Abbreviation Time Zone Name

Offset From Greenwich Mean Time (GMT)

ACT Australian central time GMT+9.5 AET Australian eastern time GMT+10 AGT Argentina standard time GMT-3 ART Arabic (Egypt) standard time GMT+2 AST Alaska standard time GMT-9 BET Brazil eastern time GMT-3 BST Bangladesh standard time GMT+6 CAT Central African time GMT+2 CNT Canada Newfoundland time GMT-3.5 CST Central standard time GMT-6 CTT China Taiwan time GMT+8 EAT Eastern African time GMT+3 ECT European central time GMT+1 EET Eastern European time GMT+2 EST Eastern standard time GMT-5 HST Hawaii standard time GMT-10 IET Indiana eastern standard time GMT-5 IST India standard time GMT+5.5 JST Japan standard time GMT+9 MET Middle East time GMT+3.5 MIT Midway Islands time GMT-11 MST Mountain standard time GMT-7 NET Near East time GMT+4 NST New Zealand standard time GMT+12 PLT Pakistan Lahore time GMT+5 PNT Phoenix standard time GMT-7 PRT Puerto Rico and U S. Virgin Islands time GMT-4

76 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 95

TABLE2-17 Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich

Mean Time (Continued)

Time Zone Abbreviation Time Zone Name

PST Pacific standard time GMT-8 SST Solomon standard time GMT+11 UTC Universal Time Coordinated GMT+0 VST Vietnam standard time GMT+7

Offset From Greenwich Mean Time (GMT)

Description

Sets the date and time for the platform and domains. This command, when invoked from the platform, will have no effect on the date and time in each domain and vice versa. You can set up to five different times and time zones; one time and time zone for the platform and different times and time zones for each of the four domains.

If your time zone area is using daylight or summer time, this is set automatically.

Note – You cannot set the date from the system controller in a domain while the

Solaris operating environment is running. To set the date while the Solaris operating environment is running, use the Solaris operating environment date command.

Examples

When you type the setdate command from the platform, this sets the date and time for the platform. When you type the setdate command from the domain, this sets the date and time for the domain.

To set the date and time on the platform to Thursday, April 20, 2001, at 18 hours 15 minutes and 10 seconds, type:

TABLE2-18 setdate Command Example in the Platform Shell

schostname:SC> setdate 042018152001.10

Thu Apr 20 18:15:10 PST 2001

Chapter 2 System Controller Alphabetical Command Reference 77

Page 96

To set the date from a date host:

CODE EXAMPLE 2-40 setdate -r Command Example Setting the Date From a Date Host

schostname:SC> setdate -r datehost

To set the time zone to Pacific Standard Time (PST), using the offset from Greenwich mean time—GMT, and the date and time on the platform to Thursday, April 20, 2001, at 18 hours 15 minutes and 10 seconds (

TABLE 2-17), type:

CODE EXAMPLE 2-41 setdate -t Command Example Setting the Time Zone to Pacific

Standard Time Using the Offset From Greenwich Mean Time

schostname:SC> setdate -t GMT-8 042018152001.10

Thu Apr 20 18:15:10 PST 2001

To set the time zone to Eastern Standard Time (EST), using the time zone abbreviations, and the date and time on the platform to Thursday, April 20, 2001, at 18 hours 15 minutes and 10 seconds (

CODE EXAMPLE 2-42 setdate -t Command Example Setting the Time Zone to Eastern

TABLE 2-17), type:

Standard Time Using Time Zone Abbreviations and Also Setting the Date

schostname:SC> setdate -t EST 042018152001.10

Thu Apr 20 18:15:10 EST 2001

To set just the time zone for Japan Standard Time using offsets from Greenwich Mean Time—GMT (

CODE EXAMPLE 2-43 setdate -t Command Example Setting the Time Zone to Japan

TABLE 2-17) and not the date and time, type:

Standard Time Using the Offset From Greenwich Mean Time

schostname:SC> setdate -t GMT+9

Thu Apr 20 18:15:10 GMP+9 2001

To set just the time zone for European Central Time using the time zone abbreviations (

CODE EXAMPLE 2-44 setdate -t Command Example Setting the Time Zone to Eastern

TABLE 2-17) and not the date and time, type:

Central Time Using Time Zone Abbreviations

schostname:SC> setdate -t ECT

Thu Apr 20 18:15:10 ECT 2001

78 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 97

setdefaults

Sets the default configuration values.

Caution – This is a destructive command. Use with caution and care.

Scope

platform shell, domain shell

Syntax

setdefaults [-y|-n] [-a] setdefaults -h

Options/Parameters

-y does not prompt for confirmation. The option reboots the system and sets the defaults.

-n does not execute the command if confirmation is requested.

-a adds missing parameters.

-h displays help for this command.

Chapter 2 System Controller Alphabetical Command Reference 79

Page 98

Description

This command does the following:

■ Sets the system controller to the default values. When invoked for a domain, this

command sets the defaults for that domain only. When invoked from the platform, this command sets the defaults for all domains and the platform.

■ Erases all platform and domain configurations (platform).

■ Removes passwords (domain and platform).

Caution – This command requires that all domains are inactive (not running the

OpenBoot PROM, POST, or the Solaris operating environment) and the virtual keyswitch be set to off.

Example

CODE EXAMPLE 2-45 setdefaults Example

schostname:SC> setdefaults

WARNING!

You are about to reset all configuration data to default values. All domain configurations, ACLs, users and data buffers will be lost.

The System Controller will be REBOOTED after the defaults are set.

Do you want to restore the default values and reboot now? [no]

If you answer yes, the system controller is rebooted after the defaults are set. If you answer no, the default values are not restored. If a password is set for the platform shell, the password will be required.

80 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Page 99

setkeyswitch

Changes the position of the virtual keyswitch to the specified value.

Scope

platform shell, domain shell

Syntax for the Platform Shell

setkeyswitch [-y|-n] -d domainID off setkeyswitch -h

Syntax for the Domain Shell

Options/Parameters

-h displays help for this command.

-y does not prompt for conﬁrmation.

-n does not execute this command is conﬁrmation is requested.

-d domainID (platform shell only) is the domain ID of the domain you want power off ( a, b, c,ord).

Chapter 2 System Controller Alphabetical Command Reference 81

Page 100

For setkeyswitch parameters and descriptions, see TABLE 2-19.

TABLE2-19 setkeyswitch Values and Description

Value Description

off Changes the board state of all the boards belonging to a domain to the

Assigned board status and places the boards in low-power mode, which allows you to remove the boards from the system. The domain will not be initialized at system power-on.

on Powers on and initializes the domain. The system controller brings the

domain into OpenBoot PROM through POST. If the OpenBoot PROM has auto-boot? set to true, then the Solaris operating environment boots automatically.

standby Changes the board state of all the boards belonging to a domain to the

Assigned board state and turns on the boards. The domain will not be initialized at system power on, but the boards that comprise the domain will be powered on.

diag Similar to the setkeyswitch on command except the POST verbose mode

is set to on and the POST diagnostic level is set to maximum.

secure Similar to the setkeyswitch on command except that the break command

and the reset commands are ignored. CPU/Memory board and I/O assembly flash PROM updates are not allowed.

TABLE 2-20 shows the results when you change a keyswitch setting.

TABLE2-20 Results of Changing the Keyswitch From the Current Setting to a New Setting

Current Keyswitch New Keyswitch Setting Result

off off Keyswitch position not changed. off standby Changes the board state of all the boards belonging to a

domain to Assigned and powers on all of the boards. The domain will not be initialized at system power on.

off on Powers on and initializes the domain. The domain will go

through POST and the OpenBoot PROM. The Solaris operating environment boots automatically unless you have set the OpenBoot PROM auto-boot? set to false.

off diag Similar to on, except POST verbose and diagnostic level is to

set to maximum. The domain will boot from the diag-device.

off secure Similar to on, except the reset and break commands are

ignored by the domain shell.

on secure break and reset are ignored.

82 Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • April 2001

Sun Microsystems Sun Fire 4810, Sun Fire 3800, Sun Fire 6800, Sun Fire 4800 Command Reference Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

Figures

Tables

Code Samples

Preface

Before You Read This Book

How This Book Is Organized

Typographic Conventions

Shell Prompts

Related Documentation

Accessing Sun Documentation Online

Ordering Sun Documentation

Sun Welcomes Your Comments

Introduction to the System Controller

Platform Administration

Platform Shell

Platform Console

Domain Administration

Domain Shell and Domain Console

Domain Shell

Domain Console

Connecting to a Domain

Maximum Number of Domains

Accessing the System Controller Main Menu

Accessing the System Controller Main Menu Using telnet

Accessing the System Controller Main Menu Using the Serial Port

System Controller Navigation

▼ To Enter a Domain From the Platform Shell

System Controller Alphabetical Command Reference

System Controller Syntax, Command Names, Command Arguments, and Comments

Command Syntax

Command Names

Command Arguments

Device Names

Board States

Status

Comments

Clearing an Entry

System Controller Command Summary

Status

Domain States

Alphabetical Listing of System Controller Commands

addboard

Scope

Syntax

Options/Parameters

Description

See Also

Example—Platform Shell

Example—Domain Shell

break

Scope

Syntax

Options/Parameters

Description

See Also

Example

connections

Scope

Syntax for the Platform Shell

Syntax for the Domain Shell

Options/Parameters

Description

See Also

Example—Platform Shell

console

Scope

Syntax

Options/Parameters

Description

See Also

Examples—Platform Shell

deleteboard

Scope

Syntax for the Platform Shell and the Domain Shell

Options/Parameters