Sun-microsystems FIRE V40Z User Manual

Sun Microsystems, Inc.www.sun.comSubmit comments about this document at: http://www.sun.com/hwdocs/feedbackSun Fire™ V20z and Sun Fire V40z ServersSer

x Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Format 116Return Codes 116D. Inventory Commands 117Inventory Compare Ver

78 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

79APPENDIXBAccess CommandsThe access command validates a user’s authority or controls authorizationservices. Using the access command, you can retriev

80 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Access Groups SubcommandsThe subcommands in TABLE B-2 return the autho

Appendix B Access Commands 81Access Get Groups SubcommandDescription: Returns a list of the groups defined, including the standard groups.FormatComman

82 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Access Map SubcommandsThe subcommands in TABLE B-5 manage mappings bet

Appendix B Access Commands 83Return CodesTABLE B-7 lists the return codes for this subcommand.Access Map SubcommandDescription: Maps an existing site-

84 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE B-9 lists the return codes for this subcommand.Acces

Appendix B Access Commands 85Return CodesTABLE B-11 lists the return codes for this subcommand.TABLE B-11 Return Codes for Subcommand access unmapRetu

86 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Access Directory Services SubcommandsServices defines a directory-serv

Appendix B Access Commands 87Return CodesTABLE B-14 lists the return codes for this subcommand.Access Enable Service SubcommandDescription: Enables a

Contents xiReturn Codes 127IPMI Enable PEF Subcommand 128Format 128Return Codes 128IPMI Get Global Enables Subcommand 129Format 129Return Codes 129IPM

88 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004TABLE B-15 lists the arguments for this subcommand.To use ADS as a dir

Appendix B Access Commands 89Access Get Services SubcommandDescription: Returns a string containing the current naming services option (NIS orADS).For

90 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE B-18 lists the return codes for this subcommand.{-l

Appendix B Access Commands 91Access Trust SubcommandsAdding host-based trusts provides many-to-one scripting solutions. Once a hostequivalence relatio

92 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004If the login is authorized through a mapping of a directory-service gr

Appendix B Access Commands 93Return CodesTABLE B-21 lists the return codes for this subcommand.Access Delete Trust SubcommandDescription: Removes a ho

94 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE B-23 lists the return codes for this subcommand.Acce

Appendix B Access Commands 95Return CodesTABLE B-24 lists the return codes for this subcommand.TABLE B-24 Return Codes for Subcommand access get trust

96 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Access Public Key SubcommandsThe subcommands listed in TABLE B-25 allo

Appendix B Access Commands 97Return CodesTABLE B-27 lists the return codes for this subcommand.Access Get Public Key Users SubcommandDescription: Dete

xii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Platform Set OS State Subcommand 144Format 144Return Codes 145Platform

98 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE B-28 lists the return codes for this subcommand.Acce

Appendix B Access Commands 99Return CodesTABLE B-30 lists the return codes for this subcommand.TABLE B-30 Return Codes for Subcommand access delete pu

100 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Access User SubcommandsThe subcommands listed in TABLE B-31 allow you

Appendix B Access Commands 101Return CodesTABLE B-33 lists the return codes for this subcommand.Access Delete User SubcommandDescription: Deletes a us

102 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004TABLE B-34 lists the arguments for this subcommand.Return CodesTABLE

Appendix B Access Commands 103Access Get Users SubcommandDescription: Retrieves all the local users in an administrative group.FormatCommand format:ac

104 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Access Update Password SubcommandNote – This command is for managers

Appendix B Access Commands 105Access Update User SubcommandDescription: Updates the login information (password or group) for the user.FormatCommand f

106 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE B-40 lists the return codes for this subcommand.TAB

107APPENDIXCDiagnostics CommandsThe diags commands allow you to manage the diagnostics tests.TABLE C-1 lists the groups of diags subcommands.Note – Th

Contents xiiiSP Date Subcommands 162SP Get Date Subcommand 162Format 162Return Codes 163SP Set Date Subcommand 163Format 163Return Codes 164SP DNS Sub

108 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Diags Cancel Tests SubcommandDescription: Cancels one or more diagnos

Appendix C Diagnostics Commands 109Return CodesTABLE C-3 lists the return codes for this subcommand.TABLE C-3 Return Codes for Subcommand diags cancel

110 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Diags Get State SubcommandDescription: Returns the state of the platf

Appendix C Diagnostics Commands 111Diags Get Tests SubcommandDescription: Returns data describing the diagnostic tests that are available. This datain

112 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Diags Run Tests SubcommandDescription: Submits one or more diagnostic

Appendix C Diagnostics Commands 113 Test Result (for example: Passed, Failed) Details. If you specify the -v option, the Test Details are displayed,

114 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Diags Start SubcommandDescription: Starts the SP and platform-diagnos

Appendix C Diagnostics Commands 115NWSE_InvalidArgument 4 One or more arguments were incorrect or invalid.NWSE_NoPermission 6 Not authorized to perfor

116 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Diags Terminate SubcommandDescription: Terminates all diagnostics tes

117APPENDIXDInventory CommandsThe inventory command reports on the inventory of hardware and software for aSun Fire V20z server.TABLE D-1 lists the gr

xiv Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Format 172Return Codes 173SP IP Subcommands 174SP Get IP Subcommand 17

118 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Inventory Compare VersionsSubcommandDescription: Returns a list of al

Appendix D Inventory Commands 119Return CodesTABLE D-3 lists the return codes for this subcommand.Inventory Get Hardware SubcommandDescription: Return

120 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004To obtain the board revision, product ID and PRS revision, you can ru

Appendix D Inventory Commands 121Inventory Get Software SubcommandDescription: Returns the inventory information for all installed or uninstalledsoftw

122 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Inventory Get All SubcommandDescription: Returns detailed information

123APPENDIXEIPMI CommandsThe ipmi command manages the Intelligent Platform Management Interface (IPMI)functions.TABLE E-1 lists the groups of ipmi sub

124 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004IPMI Disable Channel SubcommandDescription: Allows you to disable one

Appendix E IPMI Commands 125IPMI Enable Channel SubcommandDescription: Allows you to enable one of two IPMI channels.FormatCommand format:ipmi enable

126 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004IPMI Get Channels SubcommandDescription: Displays the list of IPMI ch

Appendix E IPMI Commands 127IPMI Disable PEF SubcommandDescription: Allows you to disable platform-event filtering (PEF).FormatCommand format:ipmi dis

Contents xvFormat 183Return Codes 184SP Miscellaneous Subcommands 185SP Create Test Events Subcommand 185Format 185Return Codes 186SP Get Port 80 Subc

128 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004IPMI Enable PEF SubcommandDescription: Allows you to enable platform-

Appendix E IPMI Commands 129IPMI Get Global Enables SubcommandDescription: Displays the list of IPMI global enables and their current value.FormatComm

130 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004IPMI Set Global Enable SubcommandDescription: Allows you to set the v

Appendix E IPMI Commands 131Return CodesTABLE E-12 lists the return codes for this subcommand.msg_buf Enable Event Message Buffer Enabled/Disabledmsg_

132 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004IPMI Reset SubcommandDescription: Resets IPMI information back to def

133APPENDIXFPlatform CommandsThe platform command reports or changes some aspect of the state of theplatform.TABLE F-1 lists the groups of platform su

134 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Platform Console SubcommandsThe subcommands listed in TABLE F-2 allow

Appendix F Platform Commands 135TABLE F-3 lists common COM1 values. TABLE F-4 lists common values for consoleredirection.Note – You can change these v

136 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Under certain circumstances, it might be necessary to send a serial-b

Appendix F Platform Commands 137ExampleThe following example lists the steps you would perform to enable and run theplatform console:1. Check or set t

xvi Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Format 201Return Codes 202SP Delete Mount 203Format 203Return Codes 20

138 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Platform Get Console SubcommandDescription: Retrieves the configurati

Appendix F Platform Commands 139Return CodesTABLE F-9 lists the return codes for this subcommand.Speed Indicates the communications speed of the link.

140 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Platform Set ConsoleDescription: Enables the configuration of SP acce

Appendix F Platform Commands 141Return CodesTABLE F-11 lists the return codes for this subcommand.{-n | --noprune} Indicates that the platform console

142 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Platform OS State SubcommandsThe subcommands listed in TABLE F-12 all

Appendix F Platform Commands 143 OS shutting downWhen the platform is in the Communicating state (in which the OS is communicatingwith the SP), if th

144 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Platform Set OS State SubcommandDescription: Provides the ability to

Appendix F Platform Commands 145When the platform is in the Communicating state (in which the OS is communicatingwith the SP), if the platform drivers

146 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004TABLE F-16 lists the arguments for this subcommand.Return CodesTABLE

Appendix F Platform Commands 147Platform Power State SubcommandsThe subcommands listed in TABLE F-18 allow you to manage the platform power.The subcom

Contents xviiSP Get SNMP Destinations Subcommand 215Format 215Return Codes 215SP Get SNMP Proxy Community Subcommand 216Format 216Return Codes 216SP S

148 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE F-19 lists the return codes for this subcommand.Pla

Appendix F Platform Commands 149TABLE F-20 lists the arguments for this subcommand.The subcommand platform set power state does not affect the platfor

150 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Platform Get Hostname SubcommandDescription: Displays the host name o

Appendix F Platform Commands 151Platform Get Product ID SubcommandDescription: Displays the product ID for the current system.FormatCommand format:pla

152 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

153APPENDIXGSensor CommandsThe sensor command reports or sets the value of an environmental sensor orcontrol.TABLE G-1 lists the groups of sensor subc

154 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Sensor Get SubcommandDescription: Returns all data associated with a

Appendix G Sensor Commands 155TABLE G-2 lists the arguments for this subcommand.TABLE G-2 Arguments for Subcommand sensor getArguments Description{-i

156 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE G-3 lists the arguments for this subcommand.{-I | -

Appendix G Sensor Commands 157Note – There are some sensors whose value does not change, some that are there toprovide information in the event of a p

xviii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return Codes 224SP Update Flash PIC Subcommand 225Format 225Return C

158 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Sensor Set SubcommandDescription: Allows you to set some of the data

Appendix G Sensor Commands 159Return CodesTABLE G-5 lists the arguments for this subcommand.Note – There are some sensors whose value does not change,

160 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

161APPENDIXHService Processor CommandsThe sp command gets or sets the configuration values for the Service Processor (SP),generates or manages events

162 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Date SubcommandsThe subcommands in TABLE H-2 manage the date and t

Appendix H Service Processor Commands 163Return CodesTABLE H-3 lists the return codes for this subcommand.SP Set Date SubcommandDescription: Sets the

164 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE H-5 lists the return codes for this command.TABLE H

Appendix H Service Processor Commands 165SP DNS SubcommandsThe subcommands in TABLE H-6 manage the DNS configuration on the SP.SP Disable DNS Subcomma

166 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Enable DNS SubcommandDescription: Configures the DNS configuration

Appendix H Service Processor Commands 167SP Get DNS SubcommandDescription: Displays the current DNS configuration on the SP.FormatCommand format:sp ge

xixPrefaceThis guide explains how to manage the Sun Fire™ V20z and Sun Fire V40z servers.How This Book Is OrganizedChapter 1 provides an overview of t

168 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Events SubcommandsThe subcommands in TABLE H-12 manage events on t

Appendix H Service Processor Commands 169Return CodesTABLE H-14 lists the return codes for this subcommand.SP Get Events SubcommandDescription: Return

170 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004TABLE H-15 lists the arguments for this subcommand.Return CodesTABLE

Appendix H Service Processor Commands 171SP Hostname SubcommandsThe subcommands in TABLE H-17 manage the SP host and domain.SP Get Hostname Subcommand

172 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE H-19 lists the return codes for this subcommand.SP

Appendix H Service Processor Commands 173Return CodesTABLE H-21 lists the return codes for this subcommand.TABLE H-21 Return Codes for Subcommand sp s

174 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP IP SubcommandsThe subcommands in TABLE H-22 manage the SP network

Appendix H Service Processor Commands 175Return CodesTABLE H-24 lists the arguments for this subcommand.SP Set IP SubcommandDescription: Sets or modif

176 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004TABLE H-25 lists the arguments for this subcommand.Return CodesTABLE

Appendix H Service Processor Commands 177SP JNET Address SubcommandsThe JNET address is used for communications between the SP and the platform. Thesu

PleaseRecycleCopyright 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.Sun Microsystems, I

xx Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Appendix E contains detailed descriptions of IPMI commands. See “IPMICo

178 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE H-29 lists the return codes for this subcommand.SP

Appendix H Service Processor Commands 179TABLE H-30 lists the arguments for this subcommand.Note – If you change the default addresses of JNET using t

180 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Locate Light SubcommandsThe subcommands in TABLE H-32 manage the l

Appendix H Service Processor Commands 181SP Set Locatelight SubcommandDescription: Sets the state of the locatelight switch (which describes the state

182 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Logfile SubcommandsThe subcommands in TABLE H-35 manage the SP log

Appendix H Service Processor Commands 183Return CodesTABLE H-37 lists the return codes for this subcommand.SP Set Logfile SubcommandDescription: Confi

184 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE H-39 lists the arguments for this subcommand.TABLE

Appendix H Service Processor Commands 185SP Miscellaneous SubcommandsThe subcommands in TABLE H-40 manage miscellaneous SP functions.SP Create Test Ev

186 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE H-41 lists the return codes for this command.SP Get

Appendix H Service Processor Commands 187Return CodesTABLE H-43 lists the return codes for this subcommand.BIOS POST CodesTABLE H-44 lists the POST co

Preface xxiAccessing Sun DocumentationYou can view, print, or purchase a broad selection of Sun documentation, includinglocalized versions, at:http://

188 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 200413 Initialize PCI bus mastering devices14 Initialize keyboard control

Appendix H Service Processor Commands 18948 Check video configuration against CMOS49 Initialize PCI bus and devices4A Initialize all video adapters in

190 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 200476 Check for keyboard errors7C Set up hardware interrupt vectors7D In

Appendix H Service Processor Commands 1919E Enable hardware interrupts9F Determine number of ATA and SCSI drivesA0 Set time of dayA2 Check key lockA4

192 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Boot Block Codes for Flash ROMTABLE H-45 lists the boot block codes i

Appendix H Service Processor Commands 193SP Load Settings SubcommandDescription: Configures an SP with the same configuration as that of another SP.Yo

194 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE H-47 lists the return codes for this subcommand.SP

Appendix H Service Processor Commands 195Return CodesTABLE H-49 lists the return codes for this subcommand.SP Get TDULog SubcommandDescription: The Tr

196 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004TABLE H-50 lists the arguments for this subcommand.The register name,

Appendix H Service Processor Commands 197Return CodesTABLE H-52 lists the return codes for this subcommand.SP Reboot SubcommandDescription: Restarts t

xxii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

198 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE H-54 lists the return codes for this command.SP Res

Appendix H Service Processor Commands 199TABLE H-55 lists the arguments for this command.Note – If you change the default addresses of JNET using this

200 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesTABLE H-56 list the return codes for this command.TABLE H

Appendix H Service Processor Commands 201SP Mount SubcommandsThe subcommands in TABLE H-57 manage the SP mount points.SP Add Mount SubcommandDescripti

202 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Note – Several error messages may appear when executing an smb mount

Appendix H Service Processor Commands 203SP Delete MountDescription: Deletes a mount point.FormatCommand format:sp delete mount LOCAL_MOUNT_POINT [-q

204 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Get Mount SubcommandDescription: Displays the current mount points

Appendix H Service Processor Commands 205SP SMTP SubcommandsThe subcommands in TABLE H-64 manage SMTP communications.SP Get SMTP Server SubcommandDesc

206 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004TABLE H-65 lists the arguments for this subcommand.Return CodesTABLE

Appendix H Service Processor Commands 207SP Set SMTP Server SubcommandDescription: Configures the SP SMTP client with the information for the remoteSM

1CHAPTER1IntroductionOverviewStrong server-management capabilities are crucial to maintaining mission-criticalservers. Advance notification of problem

208 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Get SMTP Subscribers SubcommandDescription: Returns detailed infor

Appendix H Service Processor Commands 209Return CodesTABLE H-71 lists the return codes for this subcommand.SP Update SMTP Subscriber SubcommandDescrip

210 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Note – All options replace the existing values with the new value. Un

Appendix H Service Processor Commands 211Return CodesTABLE H-74 lists the return codes for this command.TABLE H-74 Return Codes for Subcommand sp upda

212 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP SNMP SubcommandsThe subcommands in TABLE H-75 manage SNMP communic

Appendix H Service Processor Commands 213TABLE H-76 lists the argument for this subcommand.Return CodesTABLE H-77 lists the return codes for this subc

214 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Delete SNMP Destination SubcommandDescription: Deletes a single SN

Appendix H Service Processor Commands 215SP Get SNMP Destinations SubcommandDescription: Displays the available SNMP destinations (IP address or host

216 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Get SNMP Proxy Community SubcommandDescription: Returns the commun

Appendix H Service Processor Commands 217TABLE H-82 lists the argument for this subcommand.There are no restrictions on the length of the community st

2 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004AcronymsTABLE 1-1 defines the acronyms found in this document.TABLE 1-1

218 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP SSL SubcommandsThe subcommands in TABLE H-84 manage SSL capabiliti

Appendix H Service Processor Commands 219SP Enable SSL-Required SubcommandDescription: Enables automatic redirect to secure HTTP URLs. With SSL enable

220 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Get SSL SubcommandDescription: Determines if automatic redirect to

Appendix H Service Processor Commands 221SP Set SSL SubcommandDescription: Allows you to use site SSL certificates in the Service Processorenvironment

222 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Update SubcommandsThe subcommands in TABLE H-91 manage the SP flas

Appendix H Service Processor Commands 223TABLE H-92 lists the arguments for this subcommand.Return CodesTABLE H-93 lists the return codes for this sub

224 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Update Flash Applications SubcommandDescription: The SP file syste

Appendix H Service Processor Commands 225SP Update Flash PIC SubcommandDescription: This command updates the PIC firmware to a newer version. An input

226 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SP Update Diags SubcommandDescription: Updates the current version of

227IndexAaccess commandsadd public key 96add trust 91add user 100delete public keys 98delete trust 93delete user 101directory services subcommands 86d

Chapter 1 Introduction 3Server ManagementThere are several options for remotely managing a Sun Fire V20z or Sun Fire V40zserver: Lights Out Managemen

228 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004diagram of server management options 5diags commandscancel tests 108ge

Index 229LILO, using for console redirection 65logging in with setup account 13LOM, see lights out managementMMAC addresses, determining 25management

230 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004updating SP software 21service processor commands, see sp commandssetu

Index 231Ttraps, server events with SNMP 48troubleshooting dump utility (TDU) 195troubleshooting IPMI 39troubleshooting SNMP 53trusted host relationsh

232 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

4 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Command Line InterfaceServer-management capabilities are available from

Chapter 1 Introduction 5FIGURE 1-1 Diagram of the Server-Management Options10/100 Mb/sGigabit EthernetSun Control StationMODULES: Health Monitoring,Li

6 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Operator PanelYou can use the operator panel to configure network settin

Chapter 1 Introduction 7The operator panel displays information on the LCD display in two lines, and yourespond to prompts or initiate actions using t

iiiContentsPreface xixHow This Book Is Organized xixRelated Documentation xxAccessing Sun Documentation xxiThird-Party Web Sites xxiContacting Sun Tec

8 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004User GroupsAdministrators can define several different user groups, or t

Chapter 1 Introduction 9Initial Setup of the Service ProcessorThis procedure describes the steps for the initial setup of the SP.Part I: Assigning Net

10 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004FIGURE 1-4 Operator Panel Buttons2. Press the Forward button until you

Chapter 1 Introduction 11Assigning Static SP Network SettingsFollow these steps to set the SP network settings using a static IP address. You mustspec

12 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Note – The Back and Forward operator panel buttons automatically scroll

Chapter 1 Introduction 13Part II: Securing the Service ProcessorAfter you install the server and configure the SP, you must create the initial manager

14 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Enabling IPMI Access on the ServerThis section contains two alternate p

Chapter 1 Introduction 15b. Install the openIPMI RPM file by running the command:# rpm -ivh openipmi*.rpmNote – The kernel driver will be compiled usi

16 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Enabling IPMI Access on a Solaris-Based x86 Server (In-Band)1. Log in t

Chapter 1 Introduction 17Enabling IPMI LAN AccessThis section contains three alternate procedures; two in-band procedures, and oneout-of-band procedur

iv Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Assigning Static SP Network Settings 11Part II: Securing the Service P

18 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Enabling IPMI LAN Access on a Solaris-Based x86 Server(In-Band)1. If th

Chapter 1 Introduction 19Upgrading the Linux KernelUpgrading the installed Linux kernel to a newer version requires you to recompilethe upgraded IPMI

20 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Daisy-Chaining the ServersYou can interconnect multiple servers in a da

Chapter 1 Introduction 21Site IntegrationWhen deploying your server, ensure that you determine the best integration strategyfor your environment.These

22 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 20042. Press the Forward button until you reach the SP menu.Menu:SP menu3.

Chapter 1 Introduction 23Updating the Service Processor Base ComponentTo update the SP base component:1. Start the spupdate server on a machine with a

24 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Autoconfiguring the SP (Optional Method)Autoconfiguration replicates th

Chapter 1 Introduction 25 If the SP does not locate an IP address, the following message appears:Unable to getSP IP addressIn this case, you must man

26 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

27CHAPTER2IPMI Server ManagementServer manufacturers today have to re-invent how each new server manages itself.The hardware and software design for o

Contents vIPMI Linux Kernel Device Driver 36LAN Interface for the BMC 36Files 37Viewing the IPMI System Event Log 38Clearing the IPMI System Event Log

28 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Baseboard Management ControllerIn order to perform autonomous platform-

Chapter 2 IPMI Server Management 29IPMI Compliance and LAN Channel AccessThe server supports IPMI through the SP software version 2.0 and later. These

30 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Lights Out Management (LOM)On these servers, Lights Out Management is p

Chapter 2 IPMI Server Management 31OptionsTABLE 2-1 lists the options available for IPMItool.TABLE 2-1 Options for IPMItoolOption Description-h Provid

32 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004ExpressionsTABLE 2-2 lists the expressions and parameters available for

Chapter 2 IPMI Server Management 33chaninfo channel Displays information about the selected channel. If nochannel is specified, the command displays i

34 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004power Performs a chassis control command to view and changethe power st

Chapter 2 IPMI Server Management 35arp respond[on|off]Sets the BMC-generated ARP responses.arp generate[on|off]Sets the BMC-generated gratuitous ARPs.

36 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004IPMI Linux Kernel Device DriverThe IPMItool application utilizes a modi

Chapter 2 IPMI Server Management 37Remote Management Control Protocol is a request-response protocol delivered usingUDP datagrams to port 623. IPMI-ov

vi Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Remote Scripting Using SSH 56Configuring Multiple Systems for Scripting

38 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Viewing the IPMI System Event LogTo view the System Event Log (SEL), us

Chapter 2 IPMI Server Management 39IPMI TroubleshootingTABLE 2-3 describes some potential issues with IPMI and provides solutions.TABLE 2-3 IPMI Troub

40 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

41CHAPTER3SNMP Server ManagementYou can manage your server using the Simple Network Management Protocol(SNMP).Simple Network Management ProtocolSimple

42 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SNMP IntegrationSNMP is an open network-management technology that enab

Chapter 3 SNMP Server Management 43Sun Fire V20z and Sun Fire V40z Servers MIB TreeFIGURE 3-1 illustrates the MIB tree:FIGURE 3-1 MIB TreeIntegrating

44 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Configuring SNMP on Your ServerNote – There are several services that a

Chapter 3 SNMP Server Management 45SNMP Agent on the Service ProcessorThe SNMP agent running on the SP facilitates the management and monitoring ofthe

46 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Setting the Community NameThe SNMP agent on the SP acts as a proxy for

Chapter 3 SNMP Server Management 47Using a Third-Party MIB BrowserThe following example demonstrates integrating the server MIBs into an SNMPnode mana

Contents viiCommands 75Return Codes 76B. Access Commands 79Access Groups Subcommands 80Access Get Group Subcommand 80Format 80Return Codes 80Access Ge

48 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004SNMP TrapsSNMP traps are network-management notifications of an event o

Chapter 3 SNMP Server Management 49Configuring SNMP Trap DestinationsAlthough SNMP traps are generated for events that occur on the SP, you mustconfig

50 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Server MIB DetailsSNMP uses object identifiers (OIDs) to provide name v

Chapter 3 SNMP Server Management 51The events listed in TABLE 3-4 are sent to the SNMP destination bySP-EVENT-MIB.mib.TABLE 3-4 SP Events (1 of 2)Ente

52 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 200429 spVoltageEventWarning30 spVoltageEventCritical31 spFanEventInformati

Chapter 3 SNMP Server Management 53SNMP TroubleshootingTABLE 3-5 describes a potential issue with SNMP and provides a solution.TABLE 3-5 SNMP Troubles

54 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

55CHAPTER4Further Management InformationConfiguring Scripting CapabilitiesA system administrator can log in to the Service Processor (SP) using secure

56 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Using Shell ScriptsAn administrator can make configuration changes for

Chapter 4 Further Management Information 57If using trusted host relationships for passwordless access, the SP must have a localuser of the same name

viii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Format 89Return Codes 90Access Trust Subcommands 91Access Add Trust S

58 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Note – Use scp to copy the files to either /tmp or to your home directo

Chapter 4 Further Management Information 59# access add public key -l PUBLIC_KEY_FILE [-u user]The public key file is your RSA or DSA key. Up to 10 us

60 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004b. Authenticate yourself for the scp command by entering the password f

Chapter 4 Further Management Information 61Guidelines for Writing Server ManagementCommand ScriptsThis section describes some basic guidelines for man

62 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Data for each column is left-aligned with at least one space between

Chapter 4 Further Management Information 63Console Redirection Over Serial on aLinux-based ServerCaution – Redirecting the console over serial is a pr

64 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004grubIf you use grub, there are three steps to enable console redirectio

Chapter 4 Further Management Information 65A working-image section in your grub configuration file should have an entry forthe kernel image to boot. T

66 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004gettyYou can run a service called getty to enable login on the serial i

Chapter 4 Further Management Information 67Enabling and Configuring BIOS ConsoleRedirectionNote – Console redirection is enabled by default in the BIO

Contents ixFormat 101Return Codes 102Access Get Users Subcommand 103Format 103Return Codes 103Access Update Password Subcommand 104Format 104Return Co

68 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Network Share Volume (NSV) CD-ROMA network share volume (NSV) structure

Chapter 4 Further Management Information 69When extracted, the compressed packages in TABLE 4-1 populate the following fileson the NSV:/mnt/nsv/diagsl

70 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Serial Over LANThe Serial Over LAN (SOL) feature lets servers transpare

Chapter 4 Further Management Information 71Note – Ensure that the baud rate value passed to the -S argument matches thespeed that was specified for th

72 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

73APPENDIXAServer Management CommandsSummaryThe service processor (SP) includes a suite of commands that enables managementand monitoring of the serve

74 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Using the ssh ProtocolYou must use ssh to execute these commands on th

Appendix A Server Management Commands Summary 75CommandsThe server management commands take arguments, perform one or more actions,and display the res

76 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004Return CodesEvery subcommand returns one or more of the following retu

Appendix A Server Management Commands Summary 77NWSE_NoPermission 6 Not authorized to perform thisoperation.NWSE_MissingArgument 7 Missing argument(s)