Summary of the content on the page No. 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-13
October 2001, Revision A
Send comments about this document to:docfeedback@sun.com
Summary of the content on the page No. 2
Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road • Palo Alto, CA 94303 USA. All rights reserved. This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. P
Summary of the content on the page No. 3
Contents 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 1
Summary of the content on the page No. 4
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 Comm
Summary of the content on the page No. 5
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
Summary of the content on the page No. 6
vi Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001
Summary of the content on the page No. 7
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 theshowboards Command 6 TABLE 2-5 Values for the Domain Status Column inshowplatform andshowdomain 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
Summary of the content on the page No. 8
TABLE 3-9 Results of Changing the Keyswitch From the Current Setting to a New Setting 72 TABLE 3-10 Parameter Values for thesetupdomain Command 76 TABLE 3-11 setupplatform Parameter Values 82 TABLE 3-12 Output Header Definitions for theshowboards and theshowboards -v Command 88 TABLE 3-13 Parts forshowenvironment -p part 100 TABLE 3-14 showenvironment Output Header Description 100 viii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001
Summary of the content on the page No. 9
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
Summary of the content on the page No. 10
CODE EXAMPLE 3-20 flashupdate Example Updating Replacement CPU/Memory Boardsb4 42 CODE EXAMPLE 3-21 help Command Example Displaying Information on theaddboard Command 44 CODE EXAMPLE 3-22 help Command Example Displaying Commands Beginning With the Wordshow 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 Exam
Summary of the content on the page No. 11
CODE EXAMPLE 3-46 Variables for thesetupdomain 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 EX
Summary of the content on the page No. 12
xii Sun Fire 6800/4810/4800/3800 System Controller Command Reference Manual • October 2001
Summary of the content on the page No. 13
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 R
Summary of the content on the page No. 14
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, Edit your .login file. and directories; on-screen Use ls -a to list all files. computer output AaBbCc123 What you type, when % su contrasted with on-screen Password: computer output AaBbCc123 Book titles, new words or terms, Read Chapter 6 in the User’s Guide. words to be emphasized These are ca
Summary of the content on the page No. 15
Related Documentation Application Title Part Number Service Sun Fire 6800/4810/4800/3800 Systems 805-7363 Service Manual Service Sun Fire 4810/4800/3800 System Cabinet 806-6781 Mounting Guide System Administration Sun Fire 6800/4810/4800/3800 Systems 805-7373 Platform Administration Manual 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 titl
Summary of the content on the page No. 16
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
Summary of the content on the page No. 17
CHAPTER 1 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 u
Summary of the content on the page No. 18
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
Summary of the content on the page No. 19
CHAPTER 2 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 Arg
Summary of the content on the page No. 20
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
