Sun Microsystems Fire 6800-4810-4800-3800 User Manual

Download

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-13 October 2001, Revision A

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

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

Preface xiii

1. Introduction to the System Controller 1

Platform and Domain Administration 1 Connecting to the System Controller 2 System Controller Navigation 2 Terminating Sessions 2

2. System Controller Syntax, Arguments, and Device Names 3

Command Syntax and Arguments 3 Command Names 4 Component Names 4 Board States for CPU/Memory Boards and I/O Assemblies 6 Board Test Status 6 Domain Status 7 Interactive Commands 8 Command Line Editing 9 Command Line History 10 Command Completion 11

iii

3. System Controller Alphabetical Command Reference 13

Command Summary 13 Alphabetical Listing of System Controller Commands 16

addboard 16 break 19 connections 21 console 23 deleteboard 25 disablecomponent 27 disconnect 31 dumpconfig 33 enablecomponent 35 flashupdate 38 help 43 history 46 password 47 poweroff 49 poweron 52 reboot 55 reset 57 restoreconfig 59 resume 62 setdate 64 setdefaults 69 setkeyswitch 71 setupdomain 76 setupplatform 81

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

showboards 86 showcomponent 90 showdate 93 showdomain 95 showenvironment 99 showkeyswitch 104 showlogs 106 showplatform 108 showresetstate 113 showsc 115 testboard 116

Glossary 119

Index 121

Contents v

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

Tables

TABLE 2-1 Components That Are Accessible From the Platform 5 TABLE 2-2 Components That Are Accessible From a Domain 5 TABLE 2-3 Board States 6 TABLE 2-4 Status Field of the showboards Command 6 TABLE 2-5 Values for the Domain Status Column in showplatform and showdomain Command

Output 7

TABLE 2-6 Command Line Editing Capabilities 9 TABLE 2-7 Keystrokes that Recall Previously Typed Command Lines 10 TABLE 2-8 Keystrokes Used to Complete System Controller Commands 11 TABLE 3-1 System Controller Command Summary 13 TABLE 3-2 Header Description for the connections Command 22

TABLE 3-3

component_name

Descriptions for the CPU/Memory Board Used in the

disablecomponent Command 28

TABLE 3-4

component_name

Descriptions for the I/O Assembly Used in the disablecomponent

Command 28

TABLE 3-5

component_name

Descriptions for the CPU/Memory Board Used in the enablecomponent

Command 35

TABLE 3-6

component_name

Descriptions for the I/O Assembly Used in the enablecomponent

Command 36

TABLE 3-7 Time Zone Abbreviations, Time Zone Name, and Offsets From Greenwich Mean Time 65 TABLE 3-8 Description of the setkeyswitch Transition 72

vii

TABLE 3-9 Results of Changing the Keyswitch From the Current Setting to a New Setting 72 TABLE 3-10 Parameter Values for the setupdomain Command 76 TABLE 3-11 setupplatform Parameter Values 82 TABLE 3-12 Output Header Definitions for the showboards and the showboards -v Command 88 TABLE 3-13 Parts for showenvironment -p TABLE 3-14 showenvironment Output Header Description 100

part

100

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

Code Samples

CODE EXAMPLE 3-1 addboard Example in the Platform Shell 18 CODE EXAMPLE 3-2 addboard Example in the Domain Shell 18 CODE EXAMPLE 3-3 break Command Example 20 CODE EXAMPLE 3-4 connections Command for the Platform Shell 22 CODE EXAMPLE 3-5 console Example and No Password Set Accessing Domain B 24 CODE EXAMPLE 3-6 console Example and A Password Set Accessing Domain A 24 CODE EXAMPLE 3-7 deleteboard Example Showing Deleting I/O Assembly 7 26 CODE EXAMPLE 3-8 deleteboard Example Showing Deleting CPU/Memory Board 3 26 CODE EXAMPLE 3-9 disablecomponent Command Example Adding sb4 to the Blacklists 30 CODE EXAMPLE 3-10 disablecomponent Command Example Adding sb0 CPU Port 3 to the Blacklist 30 CODE EXAMPLE 3-11 disablecomponent Command Example Adding sb2, CPU Port 3, and Physical Bank 0

to the Blacklists 30

CODE EXAMPLE 3-12 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 30

CODE EXAMPLE 3-13 Disconnecting a Session From the System Controller Platform Shell 32 CODE EXAMPLE 3-14 Disconnecting a Session From the System Controller Platform Console 32 CODE EXAMPLE 3-15 disconnect Example Showing Disconnecting a Session From the Domain A Shell 32 CODE EXAMPLE 3-16 dumpconfig Example 34 CODE EXAMPLE 3-17 enablecomponent Command Example Enabling CPU/Memory Board 4 37 CODE EXAMPLE 3-18 enablecomponent Command Example Enabling I/O Assembly 6 and Port 1 37 CODE EXAMPLE 3-19 flashupdate Example Updating the Active System Controller Board and the System

Controller Real Time Operating System 42

CODE EXAMPLE 3-20 flashupdate Example Updating Replacement CPU/Memory Board sb4 42 CODE EXAMPLE 3-21 help Command Example Displaying Information on the addboard Command 44 CODE EXAMPLE 3-22 help Command Example Displaying Commands Beginning With the Word show 44 CODE EXAMPLE 3-23 help Command Example Displaying Commands Beginning With the Letter A 45 CODE EXAMPLE 3-24 history Command 46 CODE EXAMPLE 3-25 password Command Example With a Password Already Set 48 CODE EXAMPLE 3-26 password Command Example With No Password Set 48 CODE EXAMPLE 3-27 poweroff Command Example Showing Powering Off sb2 51 CODE EXAMPLE 3-28 poweroff Command Example Showing Powering Off All Power Supplies, Fan Trays, and

System Boards in the Platform Shell 51

CODE EXAMPLE 3-29 poweron Example Powering On sb2 53 CODE EXAMPLE 3-30 poweron Example Showing Powering On All CPU/Memory Boards and I/O Assemblies in

Domain A 54

CODE EXAMPLE 3-31 reboot Command Example 56 CODE EXAMPLE 3-32 reset Command Example From Domain A 58 CODE EXAMPLE 3-33 reset -a Command Example From Domain A 58 CODE EXAMPLE 3-34 restoreconfig Example 60 CODE EXAMPLE 3-35 resume Command Example in Active Domain A 63 CODE EXAMPLE 3-36 setdate Command Example in the Platform Shell 67 CODE EXAMPLE 3-37 setdate -r Command Example Setting the Date From a Date Host 67 CODE EXAMPLE 3-38 setdate -t Command Example Setting the Time Zone to Pacific Standard Time Using

the Offset From Greenwich Mean Time 67

CODE EXAMPLE 3-39 setdate -t Command Example Setting the Date and Time Zone to Eastern Standard

Time Using Time Zone Abbreviations 67

CODE EXAMPLE 3-40 setdate -t Command Example Setting the Time Zone to Japan Standard Time Using

the Offset From Greenwich Mean Time 68

CODE EXAMPLE 3-41 setdate -t Command Example Setting the Time Zone to Eastern Central Time Using

Time Zone Abbreviations 68

CODE EXAMPLE 3-42 setdefaults Example 70 CODE EXAMPLE 3-43 setkeyswitch on Example 74 CODE EXAMPLE 3-44 setkeyswitch off Example 75 CODE EXAMPLE 3-45 setkeyswitch off Example Shutting Down Domain B From the Platform Shell 75

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

CODE EXAMPLE 3-46 Variables for the setupdomain Command 80 CODE EXAMPLE 3-47 setupplatform Output 84 CODE EXAMPLE 3-48 showboards Command for the Platform Shell 87 CODE EXAMPLE 3-49 showboards -a Command for the Domain Shell 89 CODE EXAMPLE 3-50 showcomponent sb4 Sample Output 91 CODE EXAMPLE 3-51 showcomponent ib6 Sample Output 92 CODE EXAMPLE 3-52 showdate Command for the Platform Shell 94 CODE EXAMPLE 3-53 showdomain Command Example 96 CODE EXAMPLE 3-54 showdomain -v Command Example 97 CODE EXAMPLE 3-55 showdomain -p bootparams Example Displaying Boot Parameter Information 98 CODE EXAMPLE 3-56 showenvironment Platform Shell and Domain Shell Example 102 CODE EXAMPLE 3-57 showkeyswitch Example Showing the Keyswitch Set to On 105 CODE EXAMPLE 3-58 showkeyswitch Example Showing the Keyswitch Set to Off 105 CODE EXAMPLE 3-59 showkeyswitch Example Showing the Keyswitch Set to Standby 105 CODE EXAMPLE 3-60 Sample Output of the showlogs Command Run After Rebooting the System 107 CODE EXAMPLE 3-61 showplatform Output for a Sun Fire 6800 System 109 CODE EXAMPLE 3-62 showplatform -v Output for a Sun Fire 6800 System 110 CODE EXAMPLE 3-63 showsc Command 115 CODE EXAMPLE 3-64 testboard Example Testing CPU/Memory Board sb0 117

Code Samples xi

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

Preface

This book describes the Sun Fire 6800/4810/4800/3800 system controller command line interface. The system controller is responsible for controlling system functions, environmental monitoring, domain control, and hardware control of the server. Using the command line interface, you can configure the platform and domains, power on and off domains, power supplies, fans, and other components. Access to the Solaris domain console is also possible using the command line interface.

Before You Read This Book

This book is written for system administrators or people who have a working knowledge of the Solaris knowledge, you should first read the Solaris User and System Administrator AnswerBooks and consider UNIX documentation URLs, see “Accessing Sun Documentation Online” on page xv.

™

operating environment. If you do not have such

system administration training. For the

How This Book Is Organized

This book contains the following chapters: Chapter 1 introduces you to the system controller and briefly describes platform

administration and domain administration. Chapter 2 explains system controller command syntax, command names, and

command arguments.

xiii

Chapter 3 provides in tabular form a summary of all of the system controller commands and describes each 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, such as board_name.

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>

schostname:SC>

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

Accessing Sun Documentation Online

A broad selection of Sun system documentation is located at:

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

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

http://docs.sun.com

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 xv

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 (805-7372-13) of your document in the subject line of your email.

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

CHAPTER

Introduction to the System Controller

The system controller consists of the System Controller board and the system controller software.

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

■ Provides system monitoring and control using SNMP for use with the Sun

Management Center 3.0 software.

For more information on the system controller, refer to the “Overview” chapter of the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual and also the Sun Fire 6800/4810/4800/3810 Systems Overview Manual.

Platform and Domain Administration

The platform administration function manages resources and services that are shared among the domains. With this function, you can configure how resources and services are configured and shared.

The domain administration function manages resources and services for a specific domain. With this function you can configure the domain, control the keyswitch position, and access the domain console.

For more information on the platform administration and domain administration functions, refer to the “Overview” chapter of the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.

Connecting to the System Controller

To connect to the system controller, refer to the “System Controller Navigation Procedures” chapter in the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.

System Controller Navigation

To navigate within the system controller, refer to the “System Controller Navigation Procedures” chapter in the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.

Terminating Sessions

To terminate system controller sessions, refer to the “System Controller Navigation Procedures” chapter in the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.

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

CHAPTER

System Controller Syntax, Arguments, and Device Names

This chapter describes the following topics:

■ “Command Syntax and Arguments” on page 3

■ “Command Names” on page 4

■ “Component Names” on page 4

■ “Board States for CPU/Memory Boards and I/O Assemblies” on page 6

■ “Board Test Status” on page 6

■ “Domain Status” on page 7

■ “Interactive Commands” on page 8

■ “Command Line Editing” on page 9

■ “Command Line History” on page 10

■ “Command Completion” on page 11

Command Syntax and Arguments

The general syntax of system controller commands is:

command_name [flags][arguments]

Arguments are the words that follow the command name and are divided into two categories:

■ Required arguments

■ Optional arguments

Optional arguments always follow the option flags on the command line. In the following example, the optional domainID argument, a, follows the option flag, -d. The boardname argument, which is sb2 in this example, is a required argument and is the board name for a CPU/Memory board.

schostname:SC> addboard -d a sb2

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.

Note – When typing system controller commands, you can type the complete

command name or type just enough of the command name to uniquely identify it.

Component Names

TABLE 2-1 shows the component names that are accessible from the platform. TABLE 2-2 shows the component names that are accessible from the domain. In both

tables, you can type the component names in either upper case or lower case.

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

Note – The components 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.

TABLE2-1 Components That Are Accessible From the Platform

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 ID/Source board ID0 Fan trays FT0, FT1, FT2, FT3 System controller SSC0, SSC1

* Power grids are not a component but a division of the Sun Fire 6800 system into two distinct halves of the system. Power supplies ps0, ps1, and ps2 comprise power grid 0. Power supplies ps3, ps4, and ps5 comprise power grid 1.

TABLE 2-2 shows the components that are accessible from a domain.

TABLE2-2 Components That Are Accessible From a Domain

Device Description Device Name

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

Chapter 2 System Controller Syntax, Arguments, and Device Names 5

Board States for CPU/Memory Boards and I/O Assemblies

TABLE 2-3 lists the board states for the CPU/Memory boards and I/O assemblies. To

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

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.

The System Controller board, ID board, power supplies, and Repeater boards do not have a State. A dash is displayed In the Board Status field for these boards and components (see

TABLE 2-4). Fan trays have a state of off, low speed, and high speed.

Board Test Status

TABLE 2-4 describes the Status field of the showboards command.

TABLE2-4 Status Field of 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. Under Test The domain is running POST (power-on self-test); testing has been

initiated using the setkeyswitch command, the testboard

command, or an SNMP operation.

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

TABLE2-4 Status Field of the showboards Command (Continued)

Test Status Description

Not Tested The board has not been tested. Degraded Certain components on the board have failed or are disabled. A

board is degraded when there are still usable parts on the board.

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

Domain Status

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

TABLE 2-5):

TABLE2-5 Values for the Domain Status Column in showplatform and showdomain

Command Output

Domain State Description

Powered Off The domain is not active and the keyswitch is in the off position. Standby The domain is not active and the keyswitch is in the standby

position. Running POST The domain is active and is running POST (power-on self-test). Active The domain is active. Active - OpenBoot

PROM Active - Booting The domain is active and is booting the Solaris operating

Active - Solaris The domain is active and is running the Solaris operating

Active - Halted The Solaris operating environment is halted in the domain. Active - Reset The domain has had an XIR reset and had not be rebooted. Active - Panicking The domain is active and is panicking. It is creating the core file. Active - Debugger The domain is active and the debugger is presently running. Not Responding The domain is not responding. Paused due to an error The domain is paused due to a hardware error.

The domain is active and is running the OpenBoot PROM.

environment.

Chapter 2 System Controller Syntax, Arguments, and Device Names 7

Special Characters

To execute multiple commands on the same line, separate them with a semicolon (;). The following example executes both the addboard and deleteboard commands.

schostname:A> addboard sb2;deleteboard sb3

A pound sign ( # ) signifies the start of a comment on the current line. The following example executes the addboard command. Everything you type after the # and before pressing the Return key is ignored.

schostname:A> addboard sb2 #this text is ignored

Interactive Commands

Some commands may prompt for confirmation before executing the command. You can disable prompting by specifying the -y or -n flags, which answer yes or no to any prompted question.

Some commands, such as setupplatform and setupdomain, are always interactive.

● When an interactive command prompts for input, do the following:

■ Press the Return key to keep the current setting, displayed in braces [ ].

■ Type a dash ( - ) to change the current setting to an empty string (if the input

type is used to define a string).

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

Command Line Editing

The system controller has a basic command line editor that allows you to edit the command line. The keys you press are not echoed on the screen.

TABLE 2-6 lists the keystrokes used to perform basic command line editing.

■ To use the Control key sequences, hold down the Control key while typing the

following character (

■ To use Escape key sequences, press and release the Escape key. Then press and

release the following character (

TABLE2-6 Command Line Editing Capabilities

Keystroke Description

Backspace (Control-h)

Delete Erases the character before the cursor. Control-U Erases the entire line. Control-C Cancels editing the command line. The command is not executed. Return Finishes editing the line. Control-b Moves backward one character. Esc-b Moves backward one word. Control-f Moves forward one character. Esc-f Moves forward one word. Control-a Moves backward to the beginning of the line. Control-e Moves forward to the end of the line. Esc-h Erases from the beginning of the word to just before the cursor.

Control-w Erases from the beginning of the word to just before the cursor.

Control-d Erases next character. Esc-d Erases from the cursor to the end of the word. Stores erased

Control-k Erases from the cursor to the end of the line. Stores erased characters

Control-u Erases the entire line. Stores erased characters in a save buffer.

TABLE 2-6).

Erases the character before the cursor.

Stores erased characters in a save buffer.

characters in a save buffer.

in a save buffer.

Chapter 2 System Controller Syntax, Arguments, and Device Names 9

TABLE2-6 Command Line Editing Capabilities (Continued)

Keystroke Description

Control-r Retypes the line. Control-q Quotes the next character. Allows you to insert Control characters. Control-y Inserts the contents of the save buffer before the cursor.

Command Line History

Each shell keeps a short history of all entered commands. To display the command line history, use the history command. After recalling the commands, you can either edit them or execute them by pressing the Return key. A history of at least eight previously typed command lines are saved.

TABLE 2-7 lists keystrokes you type to recall previously typed commands.

TABLE2-7 Keystrokes that Recall Previously Typed Command Lines

Keystroke Description

Control-p Selects and displays the previous line for subsequent editing. Control-n Selects and displays the next line for subsequent editing. Control-l Displays the entire command history list.

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

Command Completion

Using the command completion function makes it easier for you to enter long commands. After typing part of the command, use the completion keystroke (

TABLE 2-8). This action searches the list of available commands for commands

beginning with the characters you typed thus far.

■ If there is only one possible command, the remainder of the characters are entered

for you automatically.

■ If there are several possibilities, any characters that are common to all of the

possible selections are filled in.

■ If there are no defined commands starting with the given characters, the

characters are erased until there is a minimum of one selection for the remaining characters.

TABLE 2-8 lists the keystrokes to complete a command.

TABLE2-8 Keystrokes Used to Complete System Controller Commands

Key Sequence Description

Control-space Complete this command. Control-? Shows all possible matches. Control-/ Shows all possible matches.

Chapter 2 System Controller Syntax, Arguments, and Device Names 11

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

CHAPTER

System Controller Alphabetical Command Reference

This chapter lists a summary of the system controller commands designed for an end-user on the Sun Fire 6800/4810/4800/3800 systems, describes the system controller command line interface, and provides descriptions and examples for each command.

Command Summary

TABLE 3-1 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.

TABLE3-1 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 console. x connections Displays connections to the system controller to

a domain.

console Connects to a domain from the platform. x deleteboard Unassigns a board from a domain. x x disablecomponent Adds a component to the blacklist. x x disconnect Disconnects the current or specified connection. x x

TABLE3-1 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 ﬁrmware. x help Provides basic help information for commands. x x history Shows the command history with date and time

stamps.

password Sets the shell password. x x 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. x x restoreconfig Restores the system controller configuration

from a server.

resume Exits the domain shell and resumes access to the

domain console.

setdate Sets the date and time. x x setdefaults Sets the configuration to default values. x x setkeyswitch Sets the keyswitch position. x x setupdomain Configures the domain. x setupplatform Conﬁgures the platform. x showboards Shows board information. x x showcomponent Shows state of a component. x x showdate Shows the date and time. x x showdomain Displays the conﬁguration and status of the

domain.

showenvironment Shows environmental information. x x showkeyswitch Displays the virtual keyswitch setting. x x showlogs Displays the logs. x x showplatform Displays the conﬁguration and information for

the platform and status of the domains.

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

TABLE3-1 System Controller Command Summary (Continued)

Command Description Platform Shell Domain Shell

showresetstate Shows CPUs after a reset or a RED MODE trap. x showsc Shows the system controller version and uptime. x testboard Tests the CPU/Memory board. x x

Chapter 3 System Controller Alphabetical Command Reference 15

Alphabetical Listing of System Controller Commands

The following sections describe the system controller commands.

addboard

Assigns a board to a domain.

Scope

platform shell, domain shell

Syntax for the Platform Shell

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

Syntax for the Domain Shell

addboard system_board_name [system_board_name ...] addboard -h

Options/Parameters

-d specifies a domainID as an option (platform shell only). domainID is a, b, c, or d.

-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).

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

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 state, use the showboards command. For more information on board states, see “Board States for CPU/Memory Boards and I/O Assemblies” on page 6.

To assign a board to a domain using a domain shell, the board name must be listed in the Access Control List (ACL) for the current domain. When a board is listed in the ACL, the system controller software is allowed to process addboard requests on that board. The platform shell does not use the ACL and can always add boards to a domain. The platform shell can also delete boards from a domain and either ignores the ACL or overrides the ACL. You configure the ACLs and also restrict the domains a board has access to using the setupplatform command.

If a board is assigned to an active domain, the board will not be used. To unassign a board from a domain, you must halt the Solaris operating environment in the domain. For an overview of steps to perform, see the section “Assigning and Unassigning Boards” in the “Maintenance” chapter of the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.

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

Example—Platform Shell

From the platform shell to add board name sb2 to domain A (CODE EXAMPLE 3-1), type:

CODE EXAMPLE 3-1 addboard Example in the Platform Shell

schostname:SC> addboard -d a sb2

Example—Domain Shell

To assign board name sb2 to the current domain (CODE EXAMPLE 3-2), type:

CODE EXAMPLE 3-2 addboard Example in the Domain Shell

schostname:A> addboard sb2

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

break

Sends a Break signal to the domain console.