Sun Microsystems V20Z Bedienungsanleitung

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254

Zur Seite of

Richtige Gebrauchsanleitung

Die Vorschriften verpflichten den Verkäufer zur Übertragung der Gebrauchsanleitung Sun Microsystems V20Z an den Erwerber, zusammen mit der Ware. Eine fehlende Anleitung oder falsche Informationen, die dem Verbraucher übertragen werden, bilden eine Grundlage für eine Reklamation aufgrund Unstimmigkeit des Geräts mit dem Vertrag. Rechtsmäßig lässt man das Anfügen einer Gebrauchsanleitung in anderer Form als Papierform zu, was letztens sehr oft genutzt wird, indem man eine grafische oder elektronische Anleitung von Sun Microsystems V20Z, sowie Anleitungsvideos für Nutzer beifügt. Die Bedingung ist, dass ihre Form leserlich und verständlich ist.

Was ist eine Gebrauchsanleitung?

Das Wort kommt vom lateinischen „instructio”, d.h. ordnen. Demnach kann man in der Anleitung Sun Microsystems V20Z die Beschreibung der Etappen der Vorgehensweisen finden. Das Ziel der Anleitung ist die Belehrung, Vereinfachung des Starts, der Nutzung des Geräts oder auch der Ausführung bestimmter Tätigkeiten. Die Anleitung ist eine Sammlung von Informationen über ein Gegenstand/eine Dienstleistung, ein Hinweis.

Leider widmen nicht viele Nutzer ihre Zeit der Gebrauchsanleitung Sun Microsystems V20Z. Eine gute Gebrauchsanleitung erlaubt nicht nur eine Reihe zusätzlicher Funktionen des gekauften Geräts kennenzulernen, sondern hilft dabei viele Fehler zu vermeiden.

Was sollte also eine ideale Gebrauchsanleitung beinhalten?

Die Gebrauchsanleitung Sun Microsystems V20Z sollte vor allem folgendes enthalten:
- Informationen über technische Daten des Geräts Sun Microsystems V20Z
- Den Namen des Produzenten und das Produktionsjahr des Geräts Sun Microsystems V20Z
- Grundsätze der Bedienung, Regulierung und Wartung des Geräts Sun Microsystems V20Z
- Sicherheitszeichen und Zertifikate, die die Übereinstimmung mit entsprechenden Normen bestätigen

Warum lesen wir keine Gebrauchsanleitungen?

Der Grund dafür ist die fehlende Zeit und die Sicherheit, was die bestimmten Funktionen der gekauften Geräte angeht. Leider ist das Anschließen und Starten von Sun Microsystems V20Z zu wenig. Eine Anleitung beinhaltet eine Reihe von Hinweisen bezüglich bestimmter Funktionen, Sicherheitsgrundsätze, Wartungsarten (sogar das, welche Mittel man benutzen sollte), eventueller Fehler von Sun Microsystems V20Z und Lösungsarten für Probleme, die während der Nutzung auftreten könnten. Immerhin kann man in der Gebrauchsanleitung die Kontaktnummer zum Service Sun Microsystems finden, wenn die vorgeschlagenen Lösungen nicht wirksam sind. Aktuell erfreuen sich Anleitungen in Form von interessanten Animationen oder Videoanleitungen an Popularität, die den Nutzer besser ansprechen als eine Broschüre. Diese Art von Anleitung gibt garantiert, dass der Nutzer sich das ganze Video anschaut, ohne die spezifizierten und komplizierten technischen Beschreibungen von Sun Microsystems V20Z zu überspringen, wie es bei der Papierform passiert.

Warum sollte man Gebrauchsanleitungen lesen?

In der Gebrauchsanleitung finden wir vor allem die Antwort über den Bau sowie die Möglichkeiten des Geräts Sun Microsystems V20Z, über die Nutzung bestimmter Accessoires und eine Reihe von Informationen, die erlauben, jegliche Funktionen und Bequemlichkeiten zu nutzen.

Nach dem gelungenen Kauf des Geräts, sollte man einige Zeit für das Kennenlernen jedes Teils der Anleitung von Sun Microsystems V20Z widmen. Aktuell sind sie genau vorbereitet oder übersetzt, damit sie nicht nur verständlich für die Nutzer sind, aber auch ihre grundliegende Hilfs-Informations-Funktion erfüllen.

Inhaltsverzeichnis der Gebrauchsanleitungen

  • Seite 1

    Sun Microsystems, Inc. www .sun.com Submit comments about this document at: http://www.sun.com/hwdocs/feedback Sun Fire ™ V20z and Sun Fire V40z Ser v ers Ser v er Management Guide P ar t No . 817-5249-11 May , 2004, Revision A[...]

  • Seite 2

    Please Recycle Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual pr operty rights relating to technology that is described in this document. In particular , and without limitation, these intellectual property rights may include one or more o[...]

  • Seite 3

    iii Contents Preface xix How This Book Is Organized xix Related Documentation xx Accessing Sun Documentation xxi Third-Party Web Sites xxi Contacting Sun Technical Support xxi Sun Welcomes Your Comments xxi 1. Introduction 1 Overview 1 Acronyms 2 Server Management 3 Service Processor 3 Server-Management Interfaces 3 SNMP Integration 4 Operator Pane[...]

  • Seite 4

    iv Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Assigning Static SP Network Settings 1 1 Part II: Securing the Service Processor 13 Creating the Initial Manager Account 13 Enabling IPMI Access on the Server 14 Enabling IPMI Access on a Linux-Based Server (In-Band) 14 Enabling IPMI Access on a Solaris-Based x86 Serv[...]

  • Seite 5

    Contents v IPMI Linux Kernel Device Driver 36 LAN Interface for the BMC 36 Files 37 V iewing the IPMI System Event Log 38 Clearing the IPMI System Event Log 38 IPMI Troubleshooting 39 3. SNMP Server Management 41 Simple Network Management Protocol 41 SNMP Integration 42 SNMP Management Information Base (MIB) 42 Sun Fire V20z and Sun Fir e V40z Serv[...]

  • Seite 6

    vi Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Remote Scripting Using SSH 56 Configuring Multiple Systems for Scripting 57 Generating Host Keys 57 Creating T rusted Host Relationships 58 Adding Public Keys 58 Generating a Host Key Pair 59 Enabling SSH Access Using T rusted Hosts 59 Enabling SSH Access Using Public[...]

  • Seite 7

    Contents vii Commands 75 Return Codes 76 B. Access Commands 79 Access Groups Subcommands 80 Access Get Group Subcommand 80 Format 80 Return Codes 80 Access Get Groups Subcommand 81 Format 81 Return Codes 81 Access Map Subcommands 82 Access Get Map Subcommand 82 Format 82 Return Codes 83 Access Map Subcommand 83 Format 83 Return Codes 84 Access Unma[...]

  • Seite 8

    viii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Format 89 Return Codes 90 Access T rust Subcommands 91 Access Add T rust Subcommand 91 Format 91 Generating Host Keys 92 Return Codes 93 Access Delete T rust Subcommand 93 Format 93 Return Codes 94 Access Get T rusts Subcommand 94 Format 94 Return Codes 95 Access Pu[...]

  • Seite 9

    Contents ix Format 101 Return Codes 102 Access Get Users Subcommand 103 Format 103 Return Codes 103 Access Update Password Subcommand 104 Format 104 Return Codes 104 Access Update User Subcommand 105 Format 105 Return Codes 106 C. Diagnostics Commands 107 Diags Cancel T ests Subcommand 108 Format 108 Return Codes 109 Diags Get State Subcommand 1 10[...]

  • Seite 10

    x Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Format 1 16 Return Codes 1 16 D. Inventory Commands 1 17 Inventory Compare V ersions Subcommand 1 18 Format 1 18 Return Codes 1 19 Inventory Get Hardwar e Subcommand 1 19 Format 1 19 Return Codes 120 Inventory Get Software Subcommand 121 Format 121 Return Codes 121 Inv[...]

  • Seite 11

    Contents xi Return Codes 127 IPMI Enable PEF Subcommand 128 Format 128 Return Codes 128 IPMI Get Global Enables Subcommand 129 Format 129 Return Codes 129 IPMI Set Global Enable Subcommand 130 Format 130 Return Codes 131 IPMI Reset Subcommand 132 Format 132 Return Codes 132 F . Platform Commands 133 Platform Console Subcommands 134 Platform Console[...]

  • Seite 12

    xii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Platform Set OS State Subcommand 144 Format 144 Return Codes 145 Platform Set OS State Boot Subcommand 145 Format 145 Return Codes 146 Platform Power State Subcommands 147 Platform Get Power State Subcommand 147 Format 147 Return Codes 148 Platform Set Power State Su[...]

  • Seite 13

    Contents xiii SP Date Subcommands 162 SP Get Date Subcommand 162 Format 162 Return Codes 163 SP Set Date Subcommand 163 Format 163 Return Codes 164 SP DNS Subcommands 165 SP Disable DNS Subcommand 165 Return Codes 165 SP Enable DNS Subcommand 166 Format 166 Return Codes 166 SP Get DNS Subcommand 167 Format 167 Return Codes 167 SP Events Subcommands[...]

  • Seite 14

    xiv Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Format 172 Return Codes 173 SP IP Subcommands 174 SP Get IP Subcommand 174 Format 174 Return Codes 175 SP Set IP Subcommand 175 Format 175 Return Codes 176 SP JNET Address Subcommands 177 SP Get JNET Subcommand 177 Format 177 Return Codes 178 SP Set JNET Subcommand 1[...]

  • Seite 15

    Contents xv Format 183 Return Codes 184 SP Miscellaneous Subcommands 185 SP Create T est Events Subcommand 185 Format 185 Return Codes 186 SP Get Port 80 Subcommand 186 Format 186 Return Codes 187 BIOS POST Codes 187 Boot Block Codes for Flash ROM 192 SP Load Settings Subcommand 193 Format 193 Return Codes 194 SP Get Status Subcommand 194 Format 19[...]

  • Seite 16

    xvi Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Format 201 Return Codes 202 SP Delete Mount 203 Format 203 Return Codes 203 SP Get Mount Subcommand 204 Format 204 Return Codes 204 SP SMTP Subcommands 205 SP Get SMTP Server Subcommand 205 Format 205 Return Codes 206 SP Set SMTP Server Subcommand 207 Format 207 Retu[...]

  • Seite 17

    Contents xvii SP Get SNMP Destinations Subcommand 215 Format 215 Return Codes 215 SP Get SNMP Proxy Community Subcommand 216 Format 216 Return Codes 216 SP Set SNMP Proxy Community Subcommand 216 Format 216 Return Codes 217 SP SSL Subcommands 218 SP Disable SSL-Required Subcommand 218 Format 218 Return Codes 218 SP Enable SSL-Required Subcommand 21[...]

  • Seite 18

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

  • Seite 19

    xix Pr eface This guide explains how to manage the Sun Fire™ V20z and Sun Fir e V40z servers. How This Book Is Or ganized Chapter 1 provides an overview of the ways in which a user can manage the servers. See “Introduction” on page 1 . Chapter 2 describes how to manage the servers through the Intelligent Platform Management Interface (IPMI). [...]

  • Seite 20

    xx Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Appendix E contains detailed descriptions of IPMI commands. See “IPMI Commands” on page 123 . Appendix F contains detailed descriptions of Platform commands. See “Platform Commands” on page 133 . Appendix G contains detailed descriptions of Sensor commands. Se[...]

  • Seite 21

    Preface xxi Accessing Sun Documentation Y ou can view , print, or purchase a broad selection of Sun documentation, including localized versions, at: http://www.sun.com/documentation Thir d-Party W eb Sites Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or [...]

  • Seite 22

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

  • Seite 23

    1 CHAPTER 1 Intr oduction Overview Strong server-management capabilities are crucial to maintaining mission-critical servers. Advance notification of problems and rapid diagnosis and corr ection are critical functions to an environment in which a few servers bear the bulk of the workload. The Sun Fire™ V20z and Sun Fir e V40z servers and their ex[...]

  • Seite 24

    2 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Acr onyms T ABLE 1- 1 defines the acronyms found in this document. T ABLE 1-1 Acr onyms Acron ym Explanation ACPI Advanced Configuration and Power Interface ARP Address Resolution Pr otocol BMC Baseboard Management Contr oller CRU Customer-Replaceable Unit DPC Direct P[...]

  • Seite 25

    Chapter 1 Introduction 3 Server Management There ar e several options for remotely managing a Sun Fire V20z or Sun Fir e V40z server: ■ Lights Out Management (LOM) through IPMItool ■ Simple Network Management Protocol (SNMP) Service Pr ocessor The Sun Fire V20z and Sun Fir e V40z servers include a dedicated chipset for complete operating-system[...]

  • Seite 26

    4 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Command Line Interface Server-management capabilities are available from the command line. See Appendix B for a list of server-management commands that you can use with these servers, as well as a description, the command format, a list of arguments and a list of retur[...]

  • Seite 27

    Chapter 1 Introduction 5 FIGURE 1-1 Diagram of the Server-Management Options 10/100 Mb/s Gigabit Ethernet Sun Control Station MODULES: Health Monitoring, Lights Out Management, Software Management, AllStart and others Server IPMI management through IPMItool OpenIPMI (Linux) LIPMI (Solaris™) Third-Party Management SNMP-based solutions (HP Open Vie[...]

  • Seite 28

    6 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Operator Panel Y ou can use the operator panel to configure network settings for the SP . See FIGURE 1-2 or FIGURE 1-3 for the operator panel location on your server . Note – The SP defaults to Dynamic Host Configuration Protocol (DHCP) networking if the operator pan[...]

  • Seite 29

    Chapter 1 Introduction 7 The operator panel displays information on the LCD display in two lines, and you respond to pr ompts or initiate actions using the following buttons: If a menu or data-entry screen displays for more than 30 seconds with no action taken, the menu or data entry is cancelled and the display returns to the idle/background state[...]

  • Seite 30

    8 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 User Gr oups Administrators can define several differ ent user groups, or types, on the server . Capabilities of the different user types ar e defined in T ABLE 1-3 . For example, when you log in to the system the first time using the setup account, the first thing you[...]

  • Seite 31

    Chapter 1 Introduction 9 Initial Setup of the Service Pr ocessor This procedur e describes the steps for the initial setup of the SP . Part I: Assigning Network Settings to the SP This section contains two alternate methods you can use to define SP network settings: ■ “Assigning SP Network Settings Using DHCP” on page 9 ■ “Assigning Stati[...]

  • Seite 32

    10 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 FIGURE 1-4 Operator Panel Buttons 2. Press the Forward button until you reach the SP menu: Menu: SP menu 3. Press the Select button to display the SP menu options. SP Menu: Set SP IP info? 4. Press the Select button. The following prompt appears with the default respo[...]

  • Seite 33

    Chapter 1 Introduction 11 Assigning Static SP Network Settings Follow these steps to set the SP network settings using a static IP address. Y ou must specify a subnet mask and default gateway . This example uses the following sample settings: IP Address: 192.168.1.2 Subnet Mask: 255.255.255.0 Default Gateway: 192.168.1.254 1. Press any operator pan[...]

  • Seite 34

    12 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Note – The Back and Forward operator panel buttons automatically scroll, r epeating the action as long as the button is held down. 8. Repeat Step 6 and Step 7 for each f ield until the desired IP address is displayed, then use the Enter button combination to save th[...]

  • Seite 35

    Chapter 1 Introduction 13 Part II: Securing the Service Pr ocessor After you install the server and configur e the SP , you must create the initial manager account to secure and access the server . Y ou can then perform initial configuration of the server and create additional user accounts. Creating the Initial Manager Account A setup account is i[...]

  • Seite 36

    14 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Enabling IPMI Access on the Server This section contains two alternate procedures; one for a Linux-based server and one for a Solaris-based x86 server . Use the procedur e that corresponds to your OS: ■ “Enabling IPMI Access on a Linux-Based Server (In-Band)” on[...]

  • Seite 37

    Chapter 1 Introduction 15 b. Install the openIPMI RPM f ile by running the command: # rpm -ivh openipmi*.rpm Note – The kernel driver will be compiled using the kernel-source code during installation. 5. Install IPMItool. IPMItool is the command-line-interface (CLI) server-management client. ■ If the installed Linux distribution uses the 32-bit[...]

  • Seite 38

    16 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Enabling IPMI Access on a Solaris-Based x86 Server (In-Band) 1. Log in to the server and authenticate as the user root. 2. Run the following command to install the LIPMI Solaris x86 kernel driver and the IPMItool management control application. These files ar e locate[...]

  • Seite 39

    Chapter 1 Introduction 17 Enabling IPMI LAN Access This section contains three alternate procedur es; two in-band procedures, and one out-of-band procedure. Use the pr ocedure that corresponds to your OS: ■ “Enabling IPMI LAN Access on a Linux-Based Server (In-Band)” on page 17 ■ “Enabling IPMI LAN Access on a Solaris-Based x86 Server (In[...]

  • Seite 40

    18 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Enabling IPMI LAN Access on a Solaris-Based x86 Server (In-Band) 1. If the server is powered off, boot the local OS. 2. Log in to the server and authenticate as the user root. 3. Using IPMItool, conf igure the network setting for the SP by using the following commands[...]

  • Seite 41

    Chapter 1 Introduction 19 Upgrading the Linux Kernel Upgrading the installed Linux kernel to a newer version requires you to r ecompile the upgraded IPMI kernel device driver . 1. Install the kernel-source RPM that matches the version of the upgraded kernel binary RPM package. 2. Log in to the server and authenticate as the user root. 3. Change to [...]

  • Seite 42

    20 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Daisy-Chaining the Servers Y ou can interconnect multiple servers in a daisy chain configuration by using the SP connectors to form a management LAN as shown in FIGURE 1-5 . This figure also shows how the servers are connected to external LANs using the platform gigab[...]

  • Seite 43

    Chapter 1 Introduction 21 Site Integration When deploying your server , ensure that you determine the best integration strategy for your environment. These servers include network connections for the service processor (SP) that ar e separate from network connections for the platform. This allows you to configur e the server so that the SP is connec[...]

  • Seite 44

    22 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 2. Press the Forward button until you reach the SP menu. Menu: SP menu 3. Press Select or Enter to display the SP menu’ s options. SP Menu: Set SP IP info? 4. Press the Forward button until you reach the Update SP Flash menu option. SP Menu: Update SP Flash? 5. Pres[...]

  • Seite 45

    Chapter 1 Introduction 23 Updating the Service Processor Base Component T o update the SP base component: 1. Start the spupdate server on a machine with a Java Runtime Environment (JRE) by running the following command: # java -jar spupdate.jar -f f ilename [ -p port ] The spupdate.jar file is located in the spupdate folder of the Network Share V o[...]

  • Seite 46

    24 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Autoconfiguring the SP (Optional Method) Autoconfiguration r eplicates the majority of configuration files fr om an SP that has already been conf igured to another SP , so that the two servers have identical configurations, except for the host name and IP address. For[...]

  • Seite 47

    Chapter 1 Introduction 25 ■ If the SP does not locate an IP address, the following message appears: Unable to get SP IP address In this case, you must manually enter an IP address before you pr ess the Select operator panel button to start autoconfiguration. 3. W ait until the autoconf iguration is complete, at which point the SP automatically re[...]

  • Seite 48

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

  • Seite 49

    27 CHAPTER 2 IPMI Server Management Server manufacturers today have to re-invent how each new server manages itself. The hardwar e and software design for one server does not necessarily work with another . Every server supplier provides basic monitoring and data collection functions but no two do it exactly the same. These proprietary implementati[...]

  • Seite 50

    28 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Baseboar d Management Contr oller In order to perform autonomous platform-management functions, the processor runs embedded software or f irmware. T ogether , the processor and its contr olling firmwar e are referred to as the Baseboar d Management Controller (BMC), w[...]

  • Seite 51

    Chapter 2 IPMI Server Management 29 IPMI Compliance and LAN Channel Access The server supports IPMI through the SP software version 2.0 and later . These servers meet compliance standards for IPMI version 1.5. The IPMI implementation on these servers also support LAN channel access. (Refer to the IPMI specification version 1.5 for details.) The LAN[...]

  • Seite 52

    30 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Lights Out Management (LOM) On these servers, Lights Out Management is performed through IPMItool, a utility for controlling IPMI-enabled devices. Description IPMItool is a simple command-line interface (CLI) to servers that support the Intelligent Platform Management[...]

  • Seite 53

    Chapter 2 IPMI Server Management 31 Options T ABLE 2-1 lists the options available for IPMItool. T ABLE 2-1 Options for IPMItool Option Description -h Provides help on basic usage fr om the command line. -c Makes the output suitable for parsing, where possible, by separating fields with commas instead of spaces. -g Attempts to make IPMI-over-LAN co[...]

  • Seite 54

    32 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Expressions T ABLE 2-2 lists the expressions and parameters available for IPMItool. Note – For each of these expressions, the beginning command is always ipmitool , followed by the expression and parameter(s). Note – The sol command is not supported in these serve[...]

  • Seite 55

    Chapter 2 IPMI Server Management 33 chaninfo channel Displays information about the selected channel. If no channel is specified, the command displays information about the channel currently being used. EXAMPLES: ipmitool -I open chaninfo Channel 0xf info: Channel Medium Type: System Interface Channel Protocol Type: KCS Session Support: session-les[...]

  • Seite 56

    34 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 power Performs a chassis control command to view and change the power state. status Shows the current status of the chassis power . on Powers on the chassis. off Powers off chassis into the soft off state (S4/S5 state). NOTE: This command does not initiate a clean shu[...]

  • Seite 57

    Chapter 2 IPMI Server Management 35 arp respond [on|off] Sets the BMC-generated ARP responses. arp generate [on|off] Sets the BMC-generated gratuitous ARPs. arp interval [seconds] s Sets the interval for the BMC-generated gratuitous ARPs. auth level ,... type ,... This command sets the valid authtypes for a given auth level. Levels can be: callback[...]

  • Seite 58

    36 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 IPMI Linux Kernel Device Driver The IPMItool application utilizes a modified MontaV ista OpenIPMI kernel device driver found on the Sun Fire V20z and Sun Fire V40z Servers Documentation and Support Files CD. The driver has been modified to use an alternate base hardwa[...]

  • Seite 59

    Chapter 2 IPMI Server Management 37 Remote Management Control Protocol is a r equest-response protocol delivered using UDP datagrams to port 623. IPMI-over-LAN uses version 1 of the RMCP to support management both before installing the OS on the server , or if the server will not have an OS installed. The LAN interface is an authenticated, multi-se[...]

  • Seite 60

    38 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 V iewing the IPMI System Event Log T o view the System Event Log (SEL), use IPMItool. The out-of-band command is: # ipmitool -I lan -H spipaddr -P ipmipasswd sel list The in-band command (using OpenIPMI on a Linux-based server or LIPMI on a Solaris-based server) is: #[...]

  • Seite 61

    Chapter 2 IPMI Server Management 39 IPMI T roubleshooting T ABLE 2-3 describes some potential issues with IPMI and provides solutions. T ABLE 2-3 IPMI T roubleshooting Issue Solution Y ou cannot connect to the management controller using IPMItool over LAN. V erify the network connection to the management controller and its IP addr ess and verify th[...]

  • Seite 62

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

  • Seite 63

    41 CHAPTER 3 SNMP Server Management Y ou can manage your server using the Simple Network Management Protocol (SNMP). Simple Network Management Pr otocol Simple Network Management Protocol (SNMP) is a network-management protocol used almost exclusively in TCP/IP networks. SNMP provides a means to monitor and control network devices, and to manage co[...]

  • Seite 64

    42 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SNMP Integration SNMP is an open network-management technology that enables the management of networks and entities connected to the network. W ithin the SNMP architecture is a collection of network-management stations and managed nodes. Network-management stations ex[...]

  • Seite 65

    Chapter 3 SNMP Server Management 43 Sun Fire V20z and Sun Fir e V40z Servers MIB T ree FIGURE 3-1 illustrates the MIB tree: FIGURE 3-1 MIB T ree Integrating MIBs with Third-Party Consoles Y ou use the server ’s MIBs to integrate the management and monitoring of the server into SNMP management consoles. The MIB branch is a private enterprise MIB, [...]

  • Seite 66

    44 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Conf iguring SNMP on Y our Server Note – There ar e several services that are supplied by the SNMP agent on the server . Depending on your business needs and the configuration of your current off ice network and management environment, you might want to take advanta[...]

  • Seite 67

    Chapter 3 SNMP Server Management 45 SNMP Agent on the Service Processor The SNMP agent running on the SP facilitates the management and monitoring of the server . The SNMP agent can be used to query various types of SP information. Refer to FIGURE 3-1 for a list of the MIBs; refer to T ABLE 3-3 for a detailed description of the MIBs. There is no co[...]

  • Seite 68

    46 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Setting the Community Name The SNMP agent on the SP acts as a proxy for the SNMP agent running on the platform. (Refer to “Configuring SNMP on Y our Server” on page 44 .) T o properly proxy , you must use the community string. The community string needed to do so [...]

  • Seite 69

    Chapter 3 SNMP Server Management 47 Using a Third-Party MIB Br owser The following example demonstrates integrating the server MIBs into an SNMP node manager . 1. From the Manager Preferences menu, choose Load/Unload MIBS: SNMP . 2. Locate and select the SP-MasterAgent-MIB.mib. 3. Click Load. 4. Specify the directory in which the server MIBs are pl[...]

  • Seite 70

    48 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SNMP T raps SNMP traps are network-management notifications of an event occurring at a managed network node. These events can identify problems in the network, machines up or down, and so on. These servers use traps to signal conditions related to the server ’s heal[...]

  • Seite 71

    Chapter 3 SNMP Server Management 49 Configuring SNMP T rap Destinations Although SNMP traps are generated for events that occur on the SP , you must configur e where these traps are to be sent. There is no default destination for traps. Y ou can use the server-management subcommands (see T ABLE 3-2 ) on the SP to configur e SNMP destinations. For m[...]

  • Seite 72

    50 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Server MIB Details SNMP uses object identifiers (OIDs) to provide name variables by which objects ar e grouped together for easier r eference. These servers pr ovide agents for the MIBs shown in T ABLE 3-3 : T ABLE 3-3 SNMP MIBs MIB OID Description SP-MasterAgent-MIB [...]

  • Seite 73

    Chapter 3 SNMP Server Management 51 The events listed in T ABLE 3-4 are sent to the SNMP destination by SP-EVENT-MIB.mib . T ABLE 3-4 SP Events (1 of 2) Enterprise T rap ID Event 1 spGenericEventInformational 2 spGenericEventWarning 3 spGenericEventCritical 4 spTemperatureEventInformational 5 spTemperatureEventWarning 6 spTemperatureEventCritical 7[...]

  • Seite 74

    52 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 29 spVoltageEventWarning 30 spVoltageEventCritical 31 spFanEventInformational 32 spFanEventWarning 33 spFanEventCritical 37 spPlatformStateChangeEventInformational 38 spPlatformStateChangeEventWarning 39 spPlatformStateChangeEventCritical 40 spPlatformBIOSEventInforma[...]

  • Seite 75

    Chapter 3 SNMP Server Management 53 SNMP T roubleshooting T ABLE 3-5 describes a potential issue with SNMP and provides a solution. T ABLE 3-5 SNMP T roubleshooting Issue Solution SNMP queries to the SP time out. The platform OS requir es both the NPS driver suite RPM and an active SNMP daemon sharing the SP’s community string.[...]

  • Seite 76

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

  • Seite 77

    55 CHAPTER 4 Further Management Information Conf iguring Scripting Capabilities A system administrator can log in to the Service Processor (SP) using secure shell (SSH) and issue commands, or more commonly , write a shell script that remotely invokes these operations. Note – Y ou must create a valid initial manager account before using SSH. The S[...]

  • Seite 78

    56 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Using Shell Scripts An administrator can make configuration changes for a single SP by using SSH to log in and run commands. For a multi-system environment in which conf igurations for all SPs must be synchronized, you can automate configuration changes. As a Unix/Lin[...]

  • Seite 79

    Chapter 4 Fur ther Management Information 57 If using trusted host relationships for passwor dless access, the SP must have a local user of the same name as the remote user (or the r emote user should be a member of a directory service gr oup that is mapped to a local SP administrative group). Y ou can also add your public key file instead of creat[...]

  • Seite 80

    58 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Note – Use scp to copy the files to either /tmp or to your home directory . The sp commands will then install the file specif ied on the command line. Creating T rusted Host Relationships Adding a trusted host relationship is one way to allow for passwordless access[...]

  • Seite 81

    Chapter 4 Fur ther 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 users can install public keys; only one key per user is allowed. Admin-level users can only add their own public key . Manager-level users can add a public key for any local user . If the user is no[...]

  • Seite 82

    60 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 b. Authenticate yourself for the scp command by entering the password for your manager-level user . c. Add the client key to the set of trusted hosts for this SP . # ssh sp.test.com access add trust -c client.test.com -k /tmp/ssh_host_dsa_key.pub d. Authenticate you[...]

  • Seite 83

    Chapter 4 Fur ther Management Information 61 Guidelines for W riting Server Management Command Scripts This section describes some basic guidelines for managing your systems by writing scripts for remote execution on one or more SPs. ■ Shell Scripts: Y ou should be familiar with standard shell scripting. Refer to “Using Shell Scripts” on page[...]

  • Seite 84

    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 columns. Numeric data might be right-aligned. ■ The -D argument allows you to specify a delimiter character when scripting. This is very useful in parsing fields with white space. ■ If all li[...]

  • Seite 85

    Chapter 4 Fur ther Management Information 63 Console Redir ection Over Serial on a Linux-based Server Caution – Redirecting the console over serial is a procedur e intended for advanced users of Linux only . Y ou can seriously disrupt the proper functioning of the server or render the server unbootable if you introduce a problem in the conf igura[...]

  • Seite 86

    64 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 grub If you use grub , there ar e three steps to enable console redir ection over serial; these steps all involve editing the grub configuration f ile: ■ If you are using Red Hat Linux, the grub f ile is /etc/grub.conf . ■ If you are using SUSE Linux, the grub f i[...]

  • Seite 87

    Chapter 4 Fur ther Management Information 65 A working-image section in your grub configuration f ile should have an entry for the kernel image to boot. The stock kernel entry looks like: kernel /vmlinuz- kernel_revision ro root=/dev/sda5 where kernel_r evision is simply the kernel version that you are using. 1. Change the stock kernel entry of you[...]

  • Seite 88

    66 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 getty Y ou can run a service called getty to enable login on the serial interface. T o enable getty , append the following line to the list of gettys in the /etc/inittab file: 7:12345:respawn:/sbin/agetty 9600 ttyS0 Note – It does not matter where you append this li[...]

  • Seite 89

    Chapter 4 Fur ther Management Information 67 Enabling and Conf iguring BIOS Console Redir ection Note – Console redir ection is enabled by default in the BIOS. If the default settings have been changed in the BIOS, the following procedure explains how to change the console-redir ection settings. 1. Boot or reboot the server . 2. When prompted, pr[...]

  • Seite 90

    68 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Network Shar e V olume (NSV) CD-ROM A network share volume (NSV) structur e is included with the server on the Sun Fire V20z and Sun Fire V40z Servers Network Share V olume CD. Although the SP functions normally without access to an external f ile system, a file syste[...]

  • Seite 91

    Chapter 4 Fur ther Management Information 69 When extracted, the compressed packages in T ABLE 4-1 populate the following files on the NSV : /mnt/nsv/ diags logs scripts snmp spupdate sw_images (this folder appears after you extract one of the OS-specific Zip files) T ABLE 4-2 Extracted Files on the Network Shar e V olume File Name Description di[...]

  • Seite 92

    70 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Serial Over LAN The Serial Over LAN (SOL) feature lets servers transparently redirect the serial character stream fr om the baseboard Universal Asynchronous Receiver/T ransmitter (UAR T) to and from the remote-client system over LAN. Serial over LAN has the following [...]

  • Seite 93

    Chapter 4 Fur ther Management Information 71 Note – Ensure that the baud rate value passed to the -S argument matches the speed that was specified for the serial r edirection featur e of the BIOS and the speed used for your boot loader and OS configuration. Disabling the SOL feature T o disable the feature, run the following command: # ssh -l spu[...]

  • Seite 94

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

  • Seite 95

    73 APPENDIX A Server Management Commands Summary The service processor (SP) includes a suite of commands that enables management and monitoring of the server; this suite of commands is referr ed to as the server management commands. Note – This appendix provides an overview of the server management command types that are available on the SP . For[...]

  • Seite 96

    74 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Using the ssh Pr otocol Y ou must use ssh to execute these commands on the service processor (SP). Ther e are two ways to do this: ■ Use the interactive shell on the SP . ■ Preface each command with a set piece of text. Interactive Shell on the SP T o use the inte[...]

  • Seite 97

    Appendix A Ser ver Management Commands Summary 75 Commands The server management commands take arguments, perform one or more actions, and display the result or text to the standar d output device. Commands are gr ouped by similar function; each command has numerous subcommands supporting functions within that grouping . Note – Every command (exc[...]

  • Seite 98

    76 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes Every subcommand returns one or more of the following r eturn codes upon completion. Refer to the following appendices in this user guide for each subcommand and the corresponding r eturn codes for that subcommand. sensor Reports or sets the value of an e[...]

  • Seite 99

    Appendix A Ser ver Management Commands Summary 77 NWSE_NoPermission 6 Not authorized to perform this operation. NWSE_MissingArgument 7 Missing ar gument(s). NWSE_NoMemory 8 Insuff icient memory . NWSE_Busy 9 Device or resour ce is busy . NWSE_NotImplemented 10 Function not implemented. NWSE_RPCConnected 1 1 RPC client already connected. NWSE_RPCCon[...]

  • Seite 100

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

  • Seite 101

    79 APPENDIX B Access Commands The access command validates a user ’s authority or controls authorization services. Using the access command, you can retrieve information about user groups, add a user to or delete a user from a gr oup, and specify a mapping between site-defined administrative gr oups and the administrative groups that are used to [...]

  • Seite 102

    80 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Access Gr oups Subcommands The subcommands in T ABLE B-2 return the authorization group for a specific user or a list of defined gr oups. Access Get Gr oup Subcommand Description: Returns the authorization group for the specified user . Format Command format: access g[...]

  • Seite 103

    Appendix B Access Commands 81 Access Get Gr oups Subcommand Description: Returns a list of the groups def ined, including the standard groups. Format Command format: access get groups Return Codes T ABLE B-4 lists the return codes for this subcommand. T ABLE B-4 Return Codes for Subcommand access get groups Return Code ID Description NWSE_Success 0[...]

  • Seite 104

    82 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Access Map Subcommands The subcommands in T ABLE B-5 manage mappings between existing site-specified groups and one of the standar d administrative groups. Access Get Map Subcommand Description: Returns the names of all the site-specified gr oups mapped to a specific [...]

  • Seite 105

    Appendix B Access Commands 83 Return Codes T ABLE B-7 lists the return codes for this subcommand. Access Map Subcommand Description: Maps an existing site-specified group name (the dir ectory-services group) to one of the standar d administrative groups. Format Command format: access map {-d | --dsgroup} DIRECTORY-SERVICES-GROUP {-g | --group} LOCA[...]

  • Seite 106

    84 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE B-9 lists the return codes for this subcommand. Access Unmap Subcommand Description: Removes the directory service group and administrative gr oup mapping. Format Command format: access unmap [-a | --all] DIRECTORY-SERVICES-GROUP T ABLE B-10 lists [...]

  • Seite 107

    Appendix B Access Commands 85 Return Codes T ABLE B-1 1 lists the return codes for this subcommand. T ABLE B-11 Return Codes for Subcommand access unmap Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicting options specified. NWSE_RPCTimeout 2 Request was issued[...]

  • Seite 108

    86 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Access Dir ectory Services Subcommands Services defines a dir ectory-services mechanism that determines the group memberships for a user . Remote users gain access to the Service Processor features only through these gr oup mappings that relate a directory-services gr[...]

  • Seite 109

    Appendix B Access Commands 87 Return Codes T ABLE B-14 lists the return codes for this subcommand. Access Enable Service Subcommand Description: Enables a directory service (either NIS or ADS) to name-service lookup system on the SP . Format Command format: access enable service nis {-d | --domain} DOMAIN NAME {-s | --server } SERVER access enable [...]

  • Seite 110

    88 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 T ABLE B-15 lists the arguments for this subcommand. T o use ADS as a directory service on the SP , you must create an active dir ectory account. The name-service library on the SP uses this account to authenticate itself to the LDAP interface of the active directory [...]

  • Seite 111

    Appendix B Access Commands 89 Access Get Services Subcommand Description: Returns a string containing the current naming services option (NIS or ADS). Format Command format: access get services [ {-t | --type } nis [{-d | --domain} | {-s | --server}] [-H | --noheader]] [{-D | --delim <DELIMITER> }] access get services [ {-t | --type } ads [{ [...]

  • Seite 112

    90 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE B-18 lists the return codes for this subcommand. {-l | --ID} For ADS only: Returns the ADS logon ID. Only one of the parameters -o and -l are permitted at a time. {-o | --ou} For ADS only: Returns the organization unit information. Only one of the [...]

  • Seite 113

    Appendix B Access Commands 91 Access T rust Subcommands Adding host-based trusts provides many-to-one scripting solutions. Once a host equivalence relationship has been cr eated with a client, users on that client can remotely execute commands on the SP without being prompted for a password. T ABLE B-19 lists the commands related to trusted host re[...]

  • Seite 114

    92 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 If the login is authorized through a mapping of a directory-service gr oup, the ssh command is executed as the proxy user on the SP , either rmonitor , radmin or rmanager . Support is available for SSH protocol version 2 key types (RSA or DSA) only . If DNS is enabled[...]

  • Seite 115

    Appendix B Access Commands 93 Return Codes T ABLE B-21 lists the return codes for this subcommand. Access Delete T rust Subcommand Description: Removes a host-based trust relationship for the specified host. Format Command format: access delete trust CLIENT HOSTNAME [-a | --all] [-q | --quiet] T ABLE B-22 lists the arguments for this subcommand. T [...]

  • Seite 116

    94 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE B-23 lists the return codes for this subcommand. Access Get T rusts Subcommand Description: Requests a list of hosts involved in trust relationships with the SP . Format Command format: access get trusts T ABLE B-23 Return Codes for Subcommand acce[...]

  • Seite 117

    Appendix B Access Commands 95 Return Codes T ABLE B-24 lists the return codes for this subcommand. T ABLE B-24 Return Codes for Subcommand access get trusts Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicting options specified. NWSE_RPCTimeout 2 Request was is[...]

  • Seite 118

    96 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Access Public Key Subcommands The subcommands listed in T ABLE B-25 allow you to manage public keys and public-key users. Access Add Public Key Subcommand Description: Installs a public key for SSH authentication which enables SSH logins and remote command execution w[...]

  • Seite 119

    Appendix B Access Commands 97 Return Codes T ABLE B-27 lists the return codes for this subcommand. Access Get Public Key Users Subcommand Description: Determines which users have public keys installed. Format Command format: access get public key users T ABLE B-27 Return Codes for Subcommand access add public key Return Code ID Description NWSE_Suc[...]

  • Seite 120

    98 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE B-28 lists the return codes for this subcommand. Access Delete Public Key Subcommand Description: All users can execute this command to remove their own public key . Manager-level users can execute this command to remove the public key for any user[...]

  • Seite 121

    Appendix B Access Commands 99 Return Codes T ABLE B-30 lists the return codes for this subcommand. T ABLE B-30 Return Codes for Subcommand access delete public key Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicting options specified. NWSE_RPCTimeout 2 Request[...]

  • Seite 122

    100 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Access User Subcommands The subcommands listed in T ABLE B-31 allow you to manage a single user or group of users. Access Add User Subcommand Description: Adds the specified local user to the specif ied group with the specif ied user ID and password. Format Command f[...]

  • Seite 123

    Appendix B Access Commands 101 Return Codes T ABLE B-33 lists the return codes for this subcommand. Access Delete User Subcommand Description: Deletes a user: Format Command format: access delete user USERNAME [-a | --all] [-q | --quiet] T ABLE B-33 Return Codes for Subcommand access add user Return Code ID Description NWSE_Success 0 Command succes[...]

  • Seite 124

    102 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 T ABLE B-34 lists the arguments for this subcommand. Return Codes T ABLE B-35 lists the return codes for this subcommand. T ABLE B-34 Arguments for Subcommand access delete user Argument Description USERNAME Specifies the name of the user to r emove. This argument is[...]

  • Seite 125

    Appendix B Access Commands 103 Access Get Users Subcommand Description: Retrieves all the local users in an administrative group. Format Command format: access get users {-g | --group} [{-H | noheader}][{-D | --delim <DELIMITER>}] T ABLE B-36 lists the arguments for this subcommand. Return Codes T ABLE B-37 lists the return codes for this sub[...]

  • Seite 126

    104 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Access Update Passwor d Subcommand Note – This command is for managers to change other users’ passwords; all users can change their own passwords. Description: Changes the password of an existing user . Format Command format: access update password {-p | --passwo[...]

  • Seite 127

    Appendix B Access Commands 105 Access Update User Subcommand Description: Updates the login information (password or group) for the user . Format Command format: access update user {-u | --user} USER {-p | --password} PASSWORD {-g | --group} GROUP T ABLE B-40 lists the arguments for this subcommand. Note – The -p and -g arguments ar e optional bu[...]

  • Seite 128

    106 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE B-40 lists the return codes for this subcommand. T ABLE B-41 Return Codes for Subcommand access update user Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicti[...]

  • Seite 129

    107 APPENDIX C Diagnostics Commands The diags commands allow you to manage the diagnostics tests. T ABLE C-1 lists the groups of diags subcommands. Note – The diagnostics commands are also provided in the Sun Fir e V20z Server User Guide , 817-5248. Note – Every command returns a r eturn code upon completion. T ABLE C-1 Diagnostics Subcommand G[...]

  • Seite 130

    108 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Diags Cancel T ests Subcommand Description: Cancels one or more diagnostic tests, resulting in the deletion of results data. Format Command format: diags cancel tests [[{ -t | --test} TEST HANDLE] [{-a|--all}] [{-H | --noheader}]] T ABLE C-2 lists the arguments for t[...]

  • Seite 131

    Appendix C Diagnostics Commands 109 Return Codes T ABLE C-3 lists the return codes for this subcommand. T ABLE C-3 Return Codes for Subcommand diags cancel tests Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicting options specified. NWSE_RPCTimeout 2 Request w[...]

  • Seite 132

    110 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Diags Get State Subcommand Description: Returns the state of the platform-diagnostics control server . Format Command format: diags get state If the result r eturned from the command is that the platform is up and r eady for diagnostics, then you can submit platform [...]

  • Seite 133

    Appendix C Diagnostics Commands 111 Diags Get T ests Subcommand Description: Returns data describing the diagnostic tests that are available. This data includes the specific test name and the module to which the test applies. Format Command format: di ags get tests [{ -a | --all}] [{-H | --noheader}]] [{-D | --delim <DELIMITER> }] T ABLE C-5 [...]

  • Seite 134

    112 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Diags Run T ests Subcommand Description: Submits one or more diagnostic tests for execution. Format Command format: diags run tests [ [{ -n | --name} TEST NAME ] [{-a| --all}] [-H | --noheader] [-P | --noprogress] [{-m | --module} MODULE NAME] [-v | --verbose] T ABLE[...]

  • Seite 135

    Appendix C Diagnostics Commands 113 ■ T est Result (for example: Passed, Failed) ■ Details. If you specify the -v option, the T est Details are displayed, indicating detailed information about the test, such as high, low and nominal values, actual values, and so on. Upon failure, the Failure Details ar e displayed with a text message indicating[...]

  • Seite 136

    114 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Diags Start Subcommand Description: Starts the SP and platform-diagnostics framework. Y ou must execute this command before running any tests. After r unning this command, you can immediately run Service Processor tests or wait for the subcommand diags get state to r[...]

  • Seite 137

    Appendix C Diagnostics Commands 115 NWSE_InvalidArgument 4 One or more ar guments were incorrect or invalid. NWSE_NoPermission 6 Not authorized to perform this operation. NWSE_InvalidOpForState 22 Invalid operation for curr ent state. T ABLE C-9 Return Codes for Subcommand diags start Return Code ID Description[...]

  • Seite 138

    116 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Diags T erminate Subcommand Description: T erminates all diagnostics tests and the diagnostics session. Format Command format: diags terminate Return Codes T ABLE C-10 lists the return codes for this subcommand. T ABLE C-10 Return Codes for Subcommand diags terminate[...]

  • Seite 139

    117 APPENDIX D Inventory Commands The inventory command reports on the inventory of hardwar e and software for a Sun Fire V20z server. T ABLE D-1 lists the groups of inventory subcommands that you can use to retrieve specific information about hardwar e or software. Note – Every command returns a r eturn code upon completion. T ABLE D-1 Inventory[...]

  • Seite 140

    118 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Inventory Compar e V ersions Subcommand Description: Returns a list of all installed software packages and the version differ ences with those listed in a release manifest. Y ou can use this command to verify that your installation is consistent with a supported rele[...]

  • Seite 141

    Appendix D Inventory Commands 119 Return Codes T ABLE D-3 lists the return codes for this subcommand. Inventory Get Har dware Subcommand Description: Returns detailed information for all field-replaceable har dware components. By default, the name, type, OEM, manufacture date, hardware r evision and part number display for each component. Format Co[...]

  • Seite 142

    120 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 T o obtain the board r evision, product ID and PRS r evision, you can run the following commands: inventory get hardware -D '|' | awk -F '|' '/PRS/{print $8}' inventory get hardware -D '|' | awk -F '|' '/PRS/{pri[...]

  • Seite 143

    Appendix D Inventory Commands 121 Inventory Get Softwar e Subcommand Description: Returns the inventory information for all installed or uninstalled software (located on the optional external file system). Format Command format: inventory get software [{-a | --all}][{-H | --noheader}] [{-D | --delim <DELIMITER> }] T ABLE D-6 lists the argumen[...]

  • Seite 144

    122 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Inventory Get All Subcommand Description: Returns detailed information for all field-replaceable har dware components and all installed or uninstalled software. Format Command format: inventory get all {-a | --all} {-v | --verbose} [{-H | --noheader}] [{-D | --delim [...]

  • Seite 145

    123 APPENDIX E IPMI Commands The ipmi command manages the Intelligent Platform Management Interface (IPMI) functions. T ABLE E-1 lists the groups of ipmi subcommands. Note – Every command returns a r eturn code upon completion. T ABLE E-1 IPMI Subommands Groups Subcommand Description ipmi disable channel Disables one of two IPMI channels. ipmi en[...]

  • Seite 146

    124 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 IPMI Disable Channel Subcommand Description: Allows you to disable one of two IPMI channels. Format Command format: ipmi disable channel {sms | lan} T ABLE E-2 lists the arguments for this subcommand. Return Codes T ABLE E-3 lists the arguments for this subcommand. T[...]

  • Seite 147

    Appendix E IPMI Commands 125 IPMI Enable Channel Subcommand Description: Allows you to enable one of two IPMI channels. Format Command format: ipmi enable channel {sms | lan} T ABLE E-4 lists the arguments for this subcommand. Return Codes T ABLE E-5 lists the return codes for this subcommand T ABLE E-4 Arguments for Subcommand ipmi enable channel [...]

  • Seite 148

    126 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 IPMI Get Channels Subcommand Description: Displays the list of IPMI channels and whether they are enabled or disabled. Format Command format: ipmi get channels Return Codes T ABLE E-6 lists the return codes for this subcommand . T ABLE E-6 Return Codes for Subcommand[...]

  • Seite 149

    Appendix E IPMI Commands 127 IPMI Disable PEF Subcommand Description: Allows you to disable platform-event filtering (PEF). Format Command format: ipmi disable pef Return Codes T ABLE E-7 lists the return codes for this subcommand . T ABLE E-7 Return Codes for Subcommand ipmi disable pef Return Code ID Description NWSE_Success 0 Command successfull[...]

  • Seite 150

    128 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 IPMI Enable PEF Subcommand Description: Allows you to enable platform-event filtering (PEF). Format Command format: ipmi enable pef Return Codes T ABLE E-8 lists the return codes for this subcommand . T ABLE E-8 Return Codes for Subcommand ipmi enable pef Return Code[...]

  • Seite 151

    Appendix E IPMI Commands 129 IPMI Get Global Enables Subcommand Description: Displays the list of IPMI global enables and their current value. Format Command format: ipmi get global enables Return Codes T ABLE E-9 lists the return codes for this subcommand . T ABLE E-9 Return Codes for Subcommand ipmi get global enables Return Code ID Description N[...]

  • Seite 152

    130 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 IPMI Set Global Enable Subcommand Description: Allows you to set the value of several IPMI global-enable variables. Format Command format: ipmi set global enable {-n |--name} GLOBAL_NAME {{-e|--enabled} | {-d|--disabled}} T ABLE E-10 lists the arguments for this subc[...]

  • Seite 153

    Appendix E IPMI Commands 131 Return Codes T ABLE E-12 lists the return codes for this subcommand. msg_buf Enable Event Message Buffer Enabled/ Disabled msg_buf_interrupt Enable the Event Message Buffer Full Enabled/ Disabled msg_queue_interrupt Enable Receive Message Queue Interrupt Enabled/ Disabled Enabled T ABLE E-12 Return Codes for Subcommand [...]

  • Seite 154

    132 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 IPMI Reset Subcommand Description: Resets IPMI information back to default factory settings. Format Command format: ipmi reset {-s | –-sdrr} {-c | –-config} {-p | –-password} {-a | –-all} T ABLE E-13 lists the arguments for this subcommand. Return Codes T ABL[...]

  • Seite 155

    133 APPENDIX F Platform Commands The platform command reports or changes some aspect of the state of the platform. T ABLE F-1 lists the groups of platform subcommands. Note – Every command returns a r eturn code upon completion. T ABLE F-1 Platform Subcommand Groups Subcommand Group Description platform console Manages access to the platform seri[...]

  • Seite 156

    134 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Platform Console Subcommands The subcommands listed in T ABLE F-2 allow you to manage access to the platform serial console. Platform Console Subcommand Description: For remote-management capability , this command provides access to the platform serial console. Used [...]

  • Seite 157

    Appendix F Platform Commands 135 T ABLE F-3 lists common COM1 values. T ABLE F-4 lists common values for console redir ection. Note – Y ou can change these values, as long as they are the same as serial-port values for the operating system (OS). If your operating system supports the COM2-4 values, you can set these for the BIOS settings. The seri[...]

  • Seite 158

    136 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Under certain circumstances, it might be necessary to send a serial-br eak sequence to the platform OS (for example, to simulate the SysRq key when CONFIG_MAGIC_SYSRQ is defined and enabled in a Linux kernel). T o perform this operation, use the following sequence: ^[...]

  • Seite 159

    Appendix F Platform Commands 137 Example The following example lists the steps you would perform to enable and run the platform console: 1. Check or set the BIOS settings. 2. Run the command: platform set console -s sp -S 19200 -e 3. Run the command: platform set console Return Codes T ABLE F-6 lists the return codes for this subcommand. T ABLE F-6[...]

  • Seite 160

    138 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Platform Get Console Subcommand Description: Retrieves the configuration information regar ding the Service Processor (SP) access to the platform serial console. Format Command format: platform get console [{-H|--noheader}] [ {-D | --delim <DELIMITER> }] T ABLE[...]

  • Seite 161

    Appendix F Platform Commands 139 Return Codes T ABLE F-9 lists the return codes for this subcommand. Speed Indicates the communications speed of the link. Prune Indicates whether ANSI escape code and duplicate information pruning is enabled. Log Trigger Indicates the approximate size at which log rotation occurs (for example, when the file console.[...]

  • Seite 162

    140 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Platform Set Console Description: Enables the configuration of SP access to the platform serial console, sets the speed of the connection and limits the size of the log files created. Format Command format: platform set console {--serial|-s} platform This option conf[...]

  • Seite 163

    Appendix F Platform Commands 141 Return Codes T ABLE F-1 1 lists the return codes for this subcommand. {-n | --noprune} Indicates that the platform console log should be the raw console data. Cannot be used with: -p . {-p | --prune} Indicates that the platform console log is to be cleaned of ANSI sequences and pruned of duplicated information. Cann[...]

  • Seite 164

    142 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Platform OS State Subcommands The subcommands listed in T ABLE F-12 allow you to manage the operating system (OS). The subcommand platform set os state reboot causes the platform to turn on and boot the OS if the platform is off, but r eboots the OS if the platform i[...]

  • Seite 165

    Appendix F Platform Commands 143 ■ OS shutting down When the platform is in the Communicating state (in which the OS is communicating with the SP), if the platform drivers are uninstalled, the SP r emains in the Communicating state even though it can no longer communicate with the platform. Refer to “Platform Set OS State Subcommand” on page [...]

  • Seite 166

    144 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Platform Set OS State Subcommand Description: Provides the ability to reboot the platform into the default OS, BIOS setup or BIOS update, or to shut down the platform. Rebooting to BIOS setup allows you to configur e the BIOS parameters while BIOS update allows you t[...]

  • Seite 167

    Appendix F Platform Commands 145 When the platform is in the Communicating state (in which the OS is communicating with the SP), if the platform drivers are uninstalled, the SP r emains in the Communicating state even though it can no longer communicate with the platform. Refer to “Platform Get OS State Subcommand” on page 142 for a list of pos[...]

  • Seite 168

    146 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 T ABLE F-16 lists the arguments for this subcommand. Return Codes T ABLE F-17 lists the return codes for this subcommand. T ABLE F-16 Arguments for Subcommand platform set os state boot Arguments Description {-f | --forced} Results in a hard power off. This option is[...]

  • Seite 169

    Appendix F Platform Commands 147 Platform Power State Subcommands The subcommands listed in T ABLE F-18 allow you to manage the platform power . The subcommand platform set power state does not affect the platform if the platform is already on; if the platform is off, it powers on and boots the OS. In other words, the subcommand platform set power [...]

  • Seite 170

    148 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE F-19 lists the return codes for this subcommand. Platform Set Power State Subcommand Description: Provides the ability to turn the platform power on or off fr om within a script. However , there are equivalent, less-destructive commands available.[...]

  • Seite 171

    Appendix F Platform Commands 149 T ABLE F-20 lists the arguments for this subcommand. The subcommand platform set power state does not affect the platform if the platform is already on; if the platform is off, it powers on and boots the OS. In other words, the subcommand platform set power state ensures that the platform is on, but does not reboot [...]

  • Seite 172

    150 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Platform Get Hostname Subcommand Description: Displays the host name of the current primary platform. The data is refr eshed only when the platform is rebooted. Format Command format: platform get hostname [{-H|--noheader}] T ABLE F-22 lists the argument for this sub[...]

  • Seite 173

    Appendix F Platform Commands 151 Platform Get Pr oduct ID Subcommand Description: Displays the product ID for the curr ent system. Format Command format: platform get product-id Note – Y ou can also retrieve the product ID, boar d revision number and PRS revision number by running the subcommands sensor get and inventory get hardware . Return Cod[...]

  • Seite 174

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

  • Seite 175

    153 APPENDIX G Sensor Commands The sensor command reports or sets the value of an envir onmental sensor or control. T ABLE G-1 lists the groups of sensor subcommands. Note – Every command returns a r eturn code upon completion. Note – There ar e some sensors whose value does not change, some that are there to provide information in the event of[...]

  • Seite 176

    154 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Sensor Get Subcommand Description: Returns all data associated with a sensor . By default, only the sensor ID and its current value are displayed. Y ou can specify on the command line the order of the data output. Note – The identifier f ield is always displayed fi[...]

  • Seite 177

    Appendix G Sensor Commands 155 T ABLE G-2 lists the arguments for this subcommand. T ABLE G-2 Arguments for Subcommand sensor get Arguments Description {-i | --id} SENSOR_ID, PRODUCT-ID, BOARD-REVISION, PRS-REVISION Specifies the sensor for which the data is desir ed. Y ou can specify this argument multiple times, in which case the sensor data is r[...]

  • Seite 178

    156 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE G-3 lists the arguments for this subcommand. {-I | --noid} Suppr esses the display of the sensor ID column. By default, this column always displays when more than one sensor is selected. [-H | --noheader] Suppresses the column headings. { -D | --d[...]

  • Seite 179

    Appendix G Sensor Commands 157 Note – There ar e some sensors whose value does not change, some that are there to provide information in the event of a problem, and others to facilitate the proper operation of the software. Many of these sensors do not have a r elated component (parent) associated with them. For example, the die-temperature senso[...]

  • Seite 180

    158 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Sensor Set Subcommand Description: Allows you to set some of the data associated with a specific sensor or a class of sensors. Format Command format: sensor set [{-i | --id} SENSOR_ID [{-i | --id} SENSOR_ID] …] {[{-C | --crithigh} VALUE] [[{-c | --critlow} VALUE] [[...]

  • Seite 181

    Appendix G Sensor Commands 159 Return Codes T ABLE G-5 lists the arguments for this subcommand. Note – There ar e some sensors whose value does not change, some that are there to provide information in the event of a problem, and others to facilitate the proper operation of the software. Many of these sensors do not have a r elated component (par[...]

  • Seite 182

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

  • Seite 183

    161 APPENDIX H Service Pr ocessor Commands The sp command gets or sets the configuration values for the Service Processor (SP), generates or manages events and notices; or adds or modifies subscribers, event routes and email-notif ication groups for the SP event manager . T ABLE H-1 lists the groups of sp subcommands. Note – Every command returns[...]

  • Seite 184

    162 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Date Subcommands The subcommands in T ABLE H-2 manage the date and time on the SP . SP Get Date Subcommand Description: Retrieves the date and time from the SP R TC. Format Command format: sp get date SNMP Manages SNMP functions. SSL Manages SSL capabilities. Upda[...]

  • Seite 185

    Appendix H Ser vice Processor Commands 163 Return Codes T ABLE H-3 lists the return codes for this subcommand. SP Set Date Subcommand Description: Sets the date and time on the SP RTC. Format Command format: sp set date DATE_STRING T ABLE H-4 lists the argument for this subcommand. Y ou can use this command to initially set the platform R TC after [...]

  • Seite 186

    164 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE H-5 lists the return codes for this command. T ABLE H-5 Return Codes for Subcommand sp set date Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicting options s[...]

  • Seite 187

    Appendix H Ser vice Processor Commands 165 SP DNS Subcommands The subcommands in T ABLE H-6 manage the DNS configuration on the SP . SP Disable DNS Subcommand Description: Disables the DNS configuration on the SP . sp disable dns When the SP is configur ed to use Dynamic Host Control Protocol (DHCP), DHCP automatically configur es DNS settings. Cha[...]

  • Seite 188

    166 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Enable DNS Subcommand Description: Configur es the DNS configuration on the SP . Because applications do not see updated DNS resolver conf igurations (in /etc/resolv.conf ) until they are r estarted, this command restarts server processes that depend on DNS. This [...]

  • Seite 189

    Appendix H Ser vice Processor Commands 167 SP Get DNS Subcommand Description: Displays the current DNS conf iguration on the SP . Format Command format: sp get dns [{-n | --nameserver } | -s | --searchdomain } | {-H | --noheader }] [ {-D | --delim <DELIMITER> }] T ABLE H-10 lists the arguments for this subcommand. Return Codes T ABLE H-1 1 li[...]

  • Seite 190

    168 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Events Subcommands The subcommands in T ABLE H-12 manage events on the SP . SP Delete Event Subcommand Description: Clears an existing event using the event ID. Format Command format: sp delete event { EVENT ID | {-a | --all}} [-q | --quiet] T ABLE H-13 lists the [...]

  • Seite 191

    Appendix H Ser vice Processor Commands 169 Return Codes T ABLE H-14 lists the return codes for this subcommand. SP Get Events Subcommand Description: Returns detailed information about all active SP events. By default, event ID, last update, component, severity and a message are displayed. Administrators can view detailed information about all the [...]

  • Seite 192

    170 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 T ABLE H-15 lists the arguments for this subcommand. Return Codes T ABLE H-16 lists the return codes for this subcommand. T ABLE H-15 Arguments for Subcommand sp get events Argument Description {-i | --id} Specifies to display only information about this event; other[...]

  • Seite 193

    Appendix H Ser vice Processor Commands 171 SP Hostname Subcommands The subcommands in T ABLE H-17 manage the SP host and domain. SP Get Hostname Subcommand Description: Displays the current host name and optionally the domain name of the SP . This name is used by many of the networking programs to identify the machine. It is also used to identify a[...]

  • Seite 194

    172 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE H-19 lists the return codes for this subcommand. SP Set Hostname Subcommand Description: Resets the host name or domain name of the SP to the specified name. This name is used by many of the networking programs to identify the machine. Format Comm[...]

  • Seite 195

    Appendix H Ser vice Processor Commands 173 Return Codes T ABLE H-21 lists the return codes for this subcommand. T ABLE H-21 Return Codes for Subcommand sp set hostname Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicting options specified. NWSE_InvalidArgument [...]

  • Seite 196

    174 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP IP Subcommands The subcommands in T ABLE H-22 manage the SP network configuration. SP Get IP Subcommand Description: Retrieves the ethernet-based network-configuration information for the SP , including IP address, network mask and gateway . In addition, it indica[...]

  • Seite 197

    Appendix H Ser vice Processor Commands 175 Return Codes T ABLE H-24 lists the arguments for this subcommand. SP Set IP Subcommand Description: Sets or modifies the SP network configuration. Format Command format: sp set ip dhcp [--nowait] sp set ip static {-i | --ipaddress} IP_ADDRESS [{-n | --netmask} NETMASK ] [{-g | --gateway} GATEWAY} ] [-w | -[...]

  • Seite 198

    176 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 T ABLE H-25 lists the arguments for this subcommand. Return Codes T ABLE H-26 lists the return codes for this subcommand. T ABLE H-25 Arguments for Subcommand sp set ip Argument Description {-i | --ipaddress} Specifies the IP addr ess you wish to set. {-n | --netmask[...]

  • Seite 199

    Appendix H Ser vice Processor Commands 177 SP JNET Addr ess Subcommands The JNET address is used for communications between the SP and the platform. The subcommands in T ABLE H-27 manage the SP JNET address. SP Get JNET Subcommand Description: Retrieves the IP address of the platform JNET driver . Format Command format: sp get jnet [{-H | --noheade[...]

  • Seite 200

    178 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE H-29 lists the return codes for this subcommand. SP Set JNET Subcommand Description: Sets or modifies the SP and platform network addresses for JNET . Because of the fir ewall between these drivers, you must specify both addresses at the same time[...]

  • Seite 201

    Appendix H Ser vice Processor Commands 179 T ABLE H-30 lists the arguments for this subcommand. Note – If you change the default addresses of JNET using this command and then re-install the platform operating system or reset the SP through the subcommand sp reset to default-settings , you must re-issue the subcommand sp set jnet to re-establish t[...]

  • Seite 202

    180 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Locate Light Subcommands The subcommands in T ABLE H-32 manage the locatelight switch. SP Get Locatelight Subcommand Description: Reads the value of the locatelight switch (which represents the state of the front and r ear panel identification lights). The possibl[...]

  • Seite 203

    Appendix H Ser vice Processor Commands 181 SP Set Locatelight Subcommand Description: Sets the state of the locatelight switch (which describes the state of the front and r ear panel identification lights). Format Command format: sp set locatelight {blink | off} Return Codes T ABLE H-34 lists the return codes for this subcommand. T ABLE H-34 Return[...]

  • Seite 204

    182 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Logf ile Subcommands The subcommands in T ABLE H-35 manage the SP log files. SP Get Logf ile Subcommand Description: Retrieves the event log file configuration. Format Command format: sp get logfile [-H | --noheader] [{-D | --delim <DELIMITER> }] T ABLE H-36[...]

  • Seite 205

    Appendix H Ser vice Processor Commands 183 Return Codes T ABLE H-37 lists the return codes for this subcommand. SP Set Logf ile Subcommand Description: Configur es the event log file that is the destination of all Event Manager events and notices. Format Command format: sp set logfile [ {-f | --file} FILENAME ] [ {-s | --size} SIZE ] Y ou must spec[...]

  • Seite 206

    184 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE H-39 lists the arguments for this subcommand. T ABLE H-39 Return Codes for Subcommand sp set logfile Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicting opti[...]

  • Seite 207

    Appendix H Ser vice Processor Commands 185 SP Miscellaneous Subcommands The subcommands in T ABLE H-40 manage miscellaneous SP functions. SP Cr eate T est Events Subcommand Description: This command helps you test and validate different types of configurations that you might be considering for the SP (for example, conf igurations involving event fo[...]

  • Seite 208

    186 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE H-41 lists the return codes for this command. SP Get Port 80 Subcommand Description: Retrieves the last Port 80 post code from the PRS Port80 register . The register is written by platform BIOS during platform boot. This command is used to debug p[...]

  • Seite 209

    Appendix H Ser vice Processor Commands 187 Return Codes T ABLE H-43 lists the return codes for this subcommand. BIOS POST Codes T ABLE H-44 lists the POST codes for the Phoenix BIOS. T ABLE H-43 Return Codes for Subcommand sp get port80 Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad [...]

  • Seite 210

    188 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 13 Initialize PCI bus mastering devices 14 Initialize keyboard contr oller 16 BIOS ROM checksum 17 Initialize cache before memory autosize 18 8254 programmable interrupt timer initialization 1A 8237 DMA controller initialization 1C Reset programmable interrupt contr [...]

  • Seite 211

    Appendix H Ser vice Processor Commands 189 48 Check video configuration against CMOS 49 Initialize PCI bus and devices 4A Initialize all video adapters in system 4B QuietBoot start (optional) 4C Shadow video BIOS ROM 4E Display BIOS copyright notice 4F Initialize MultiBoot 50 Display CPU type and speed 51 Initialize EISA board 52 T est keyboard 54 [...]

  • Seite 212

    190 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 76 Check for keyboard err ors 7C Set up hardwar e interrupt vectors 7D Initialize Intelligent System Monitoring 7E Initialize coprocessor if pr esent 80 Disable onboard super I/O ports and IRQs 81 Late POST device initialization 82 Detect and install external RS232 p[...]

  • Seite 213

    Appendix H Ser vice Processor Commands 191 9E Enable hardwar e interrupts 9F Determine number of A T A and SCSI drives A0 Set time of day A2 Check key lock A4 Initialize typematic rate A8 Erase F2 prompt AA Scan for F2 key stroke AC Enter setup AE Clear boot flag B0 Check for errors B1 Inform RomPilot about the end of POST B2 POST done - prepare to[...]

  • Seite 214

    192 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Boot Block Codes for Flash ROM T ABLE H-45 lists the boot block codes in Flash ROM. C7 Initialize notebook docking late C8 Force check (optional) C9 Extended checksum (optional) CA Redirect Int 15h to enable r emote keyboard CB Redirect Int 13 to Memory T echnologies[...]

  • Seite 215

    Appendix H Ser vice Processor Commands 193 SP Load Settings Subcommand Description: Configur es an SP with the same configuration as that of another SP . Y ou can also perform autoconfiguration from the operator panel to perform this same function. For more information, see “Autoconfiguring the SP (Optional Method)” on page 24 . Format Command [...]

  • Seite 216

    194 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE H-47 lists the return codes for this subcommand. SP Get Status Subcommand Description: Returns the status of the overall system. Format Command format: sp get status T ABLE H-48 lists the arguments for this subcommand. T ABLE H-47 Return Codes for[...]

  • Seite 217

    Appendix H Ser vice Processor Commands 195 Return Codes T ABLE H-49 lists the return codes for this subcommand. SP Get TDULog Subcommand Description: The T roubleshooting Dump Utility (TDU) captures debug data. When you execute this command, this data is gathered and stored on the Service Pr ocessor in a compressed tar f ile. Format Command format:[...]

  • Seite 218

    196 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 T ABLE H-50 lists the arguments for this subcommand. The register name, addr ess and data are logged to a f ile. For example, the information for CPU0 is shown in T ABLE H-51 . T ABLE H-50 Arguments for Subcommand sp get tdulog Argument Description {-f | --filename} [...]

  • Seite 219

    Appendix H Ser vice Processor Commands 197 Return Codes T ABLE H-52 lists the return codes for this subcommand. SP Reboot Subcommand Description: Restarts the SP . This command is useful in emergency situations in which you may not have physical access to a machine. Format Command format: sp reboot [ {-f | --forced} ] T ABLE H-53 lists the argument[...]

  • Seite 220

    198 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE H-54 lists the return codes for this command. SP Reset Subcommand Description: Restores selected settings of the SP to the default factory configuration. The SP configuration f iles are stored in the directory /pstore . When you boot the system, t[...]

  • Seite 221

    Appendix H Ser vice Processor Commands 199 T ABLE H-55 lists the arguments for this command. Note – If you change the default addresses of JNET using this command and then re-install the platform operating system or reset the SP by r unning the subcommand sp reset to default-settings , you must re-issue the subcommand sp set jnet to re-establish [...]

  • Seite 222

    200 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Return Codes T ABLE H-56 list the return codes for this command. T ABLE H-56 Return Codes for Subcommand sp reset Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conf licting options sp[...]

  • Seite 223

    Appendix H Ser vice Processor Commands 201 SP Mount Subcommands The subcommands in T ABLE H-57 manage the SP mount points. SP Add Mount Subcommand Description: Creates or resets a mount point. Format Command format: sp add mount [{-l | --local} MOUNTPOINT ] {-r | --remote} SERVER:FILESYSTEM [{-u|--user} USER] [{-p|--password} PASSWORD ] T ABLE H-58[...]

  • Seite 224

    202 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Note – Several error messages may appear when executing an smb mount while mounting windows partitions. Check that the mount succeeded after the call by running the subcommand sp get mount . The requir ed formats for remote NFS and SMB mounts ar e as follows: ■ F[...]

  • Seite 225

    Appendix H Ser vice Processor Commands 203 SP Delete Mount Description: Deletes a mount point. Format Command format: sp delete mount LOCAL_MOUNT_POINT [-q | --quiet] T ABLE H-60 lists the arguments for this subcommand. Return Codes T ABLE H-61 lists the return codes for this subcommand. T ABLE H-60 Arguments for Subcommand sp delete mount Argument[...]

  • Seite 226

    204 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Get Mount Subcommand Description: Displays the current mount points on the SP . Format Command format: sp get mounts [{-l | --local} MOUNTPOINT ] [-H | --noheader] [{-D | --delim <DELIMITER> }] T ABLE H-62 lists the arguments for this subcommand. Return Code[...]

  • Seite 227

    Appendix H Ser vice Processor Commands 205 SP SMTP Subcommands The subcommands in T ABLE H-64 manage SMTP communications. SP Get SMTP Server Subcommand Description: Retrieves the SMTP server information, including the from address. Format Command format: sp get smtp server [-H | --noheader] [ {-D | --delim <DELIMITER> }] NWSE_NoRouteToHost 13[...]

  • Seite 228

    206 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 T ABLE H-65 lists the arguments for this subcommand. Return Codes T ABLE H-66 lists the return codes for this subcommand. T ABLE H-65 Arguments for Subcommand sp get smtp server Argument Description { -H | --noheader } Suppresses column headings. { -D | --delim } Del[...]

  • Seite 229

    Appendix H Ser vice Processor Commands 207 SP Set SMTP Server Subcommand Description: Configur es the SP SMTP client with the information for the remote SMTP server , including the address and optional port number . Format Command format: sp set smtp server [{-f | --from} FROM FIELD ] IP OR HOSTNAME OF SMTP SERVER T ABLE H-67 lists the arguments fo[...]

  • Seite 230

    208 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Get SMTP Subscribers Subcommand Description: Returns detailed information about one or all SMTP subscribers. Format Command format: sp get smtp subscribers [{-n | --name} < NAME >] [-H | noheader] [{-D | --delim <DELIMITER> }] T ABLE H-69 lists the arg[...]

  • Seite 231

    Appendix H Ser vice Processor Commands 209 Return Codes T ABLE H-71 lists the return codes for this subcommand. SP Update SMTP Subscriber Subcommand Description: Updates the information for an existing SMTP subscriber . Format Command format: sp update smtp subscriber {-n | --name} NAME {-r | --recipients} ADDRESS LIST T ABLE H-72 lists the argumen[...]

  • Seite 232

    210 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 Note – All options replace the existing values with the new value. Unspecif ied options leave existing settings as they are. For example, if you only specify the -r option for an existing subscriber , the existing email addr ess list is replaced with the new list s[...]

  • Seite 233

    Appendix H Ser vice Processor Commands 211 Return Codes T ABLE H-74 lists the return codes for this command. T ABLE H-74 Return Codes for Subcommand sp update smtp subscriber Return Code ID Description NWSE_Success 0 Command successfully completed. NWSE_InvalidUsage 1 Invalid usage: bad parameter usage, conflicting options specified. NWSE_RPCTimeou[...]

  • Seite 234

    212 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP SNMP Subcommands The subcommands in T ABLE H-75 manage SNMP communications. SP Add SNMP Destination Subcommand Description: Adds a single SNMP destination (either IP address or host name). Format Command format: sp add snmp-destination IP ADDRESS/HOSTNAME T ABLE H[...]

  • Seite 235

    Appendix H Ser vice Processor Commands 213 T ABLE H-76 lists the argument for this subcommand. Return Codes T ABLE H-77 lists the return codes for this subcommand. T ABLE H-76 Argument for Subcommand sp add snmp-destination Arguments Description IP ADDRESS/HOSTNAME Specifies the IP address or name of the host for the destination you wish to add. Th[...]

  • Seite 236

    214 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Delete SNMP Destination Subcommand Description: Deletes a single SNMP destination (either IP address or host name). Format Command format: sp delete snmp-destination { IP_ADDRESS/HOSTNAME | {-a | --all} [-q | --quiet] T ABLE H-78 lists the arguments for this subco[...]

  • Seite 237

    Appendix H Ser vice Processor Commands 215 SP Get SNMP Destinations Subcommand Description: Displays the available SNMP destinations (IP address or host name) to which the SP is configur ed to send. Many networking programs use this information to identify the machine. Format Command format: sp get snmp-destinations Return Codes T ABLE H-80 lists t[...]

  • Seite 238

    216 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Get SNMP Pr oxy Community Subcommand Description: Returns the community name the SP is currently using to proxy the platform SNMP agent. Format Command format: sp get snmp proxy community Return Codes T ABLE H-81 lists the return codes for this subcommand. SP Set [...]

  • Seite 239

    Appendix H Ser vice Processor Commands 217 T ABLE H-82 lists the argument for this subcommand. There ar e no restrictions on the length of the community strings; common names are private and public . The default name of the community string is private . If you run the subcommand sp get snmp proxy community without setting it, the return valule is p[...]

  • Seite 240

    218 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP SSL Subcommands The subcommands in T ABLE H-84 manage SSL capabilities. SP Disable SSL-Requir ed Subcommand Description: Disables automatic redirect to secur e HTTP URLs. W ith SSL disabled, HTTP requests ar e serviced directly without r edirecting to HTTPS. HTTPS[...]

  • Seite 241

    Appendix H Ser vice Processor Commands 219 SP Enable SSL-Requir ed Subcommand Description: Enables automatic redirect to secur e HTTP URLs. W ith SSL enabled, HTTP requests ar e automatically redirected to equivalent HTTPS r equests to maintain site security . SSL version 0.9.6j is supported. Format Command format: sp enable ssl-required Return Cod[...]

  • Seite 242

    220 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Get SSL Subcommand Description: Determines if automatic redirect to secur e HTTP is required or optional, and whether Apache W eb Server is using factory or user-supplied SSL certificate files. Format Command format: sp get ssl [{-H | noheader}] [{-D | --delim <[...]

  • Seite 243

    Appendix H Ser vice Processor Commands 221 SP Set SSL Subcommand Description: Allows you to use site SSL certificates in the Service Processor environment. This command allows you to r eplace the Server Certificate in the SP V alue-Add image with your own internally-generated certificate and to restore the factory settings. Format Command format: s[...]

  • Seite 244

    222 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Update Subcommands The subcommands in T ABLE H-91 manage the SP flash. SP Update Flash All Subcommand Note – Before using this command you must start the Java Update Server . For instructions on starting Java Update Server , see “Updating the Service Processor[...]

  • Seite 245

    Appendix H Ser vice Processor Commands 223 T ABLE H-92 lists the arguments for this subcommand. Return Codes T ABLE H-93 lists the return codes for this subcommand. T ABLE H-92 Arguments for Subcommand sp update flash all Argument Description {-i | --serverip} The IP address of the r emote server on which the Java spUpdate program is running. {-p |[...]

  • Seite 246

    224 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Update Flash Applications Subcommand Description: The SP file system is divided into two componenets: Base and V alue-Add. The Base component includes the repository and the V alue-Add component includes the application software. This command copies the file Value[...]

  • Seite 247

    Appendix H Ser vice Processor Commands 225 SP Update Flash PIC Subcommand Description: This command updates the PIC firmwar e to a newer version. An input PIC-update image file is pr ovided. Format Command format: sp update flash pic {-f | --filename} FULL PATH OF THE FILE | [{-v | --version}] T ABLE H-96 lists the arguments for this subcommand. Re[...]

  • Seite 248

    226 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 SP Update Diags Subcommand Description: Updates the current version of diagnostics available. While the SP functions normally without access to an external file system, a f ile system is requir ed to enable several features, including diagnostics. The SP software use[...]

  • Seite 249

    227 Index A access commands add public key 96 add trust 91 add user 100 delete public keys 98 delete trust 93 delete user 101 directory services subcommands 86 disable service 86 enable service 87 get group 80 get groups 81 get map 82 get public key users 97 get services 89 get trusts 94 get users 103 groups subcommands 80 map 83 map subcommands 82[...]

  • Seite 250

    228 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May , 2004 diagram of server management options 5 diags commands cancel tests 108 get state 1 10 get tests 1 1 1 run tests 1 12 start 1 14 subcommands summary table 107 terminate 1 16 documentation, related xx E enabling IPMI access 14 enabling IPMI LAN access 17 F flash ROM b[...]

  • Seite 251

    Index 229 LILO, using for console redir ection 65 logging in with setup account 13 LOM, see lights out management M MAC addresses, determining 25 management information base (MIB) for SNMP 42 MIB browser 47 MIB tree diagram 42 N network share volume extracted content 68 structure 68 O operator panel buttons functions defined 7 illustration 6 organ[...]

  • Seite 252

    230 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May , 2004 updating SP software 21 service processor commands, see sp commands setup account, logging in 13 shell scripts, using 55 simple network management protocol, see SNMP interface SNMP interface agent on the SP 45 Agent X 46 architectur e diagram 4 4 community name, set[...]

  • Seite 253

    Index 231 T traps, server events with SNMP 48 troubleshooting dump utility (TDU) 195 troubleshooting IPMI 39 troubleshooting SNMP 53 trusted host relationship, scripting 58 types of users, defined 8 U updating service processor softwar e 21 updating SP base component 23 user groups, def ined 8 user types, defined 8[...]

  • Seite 254

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