Manuel d'utilisation / d'entretien du produit V20Z du fabricant Sun Microsystems
Aller à la page of 254
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 .
Please Recycle Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc.
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.
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 Accou.
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.
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 .
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 Co.
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 Key.
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.
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.
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 .
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.
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.
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 Subc.
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 BIO.
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 Re.
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 Form.
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 Form.
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).
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 .
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.
xxii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004.
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.
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 Advan.
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 Networ.
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.
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, Al.
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 .
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 s.
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 .
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 contain.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
26 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004.
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.
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.
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.
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.
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.
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).
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.
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).
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 ,.
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.
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.
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.
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.
40 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004.
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.
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.
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.
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 .
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.
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 .
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.
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.
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.
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.
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 spGenericEventInfor.
52 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004 29 spVoltageEventWarning 30 spVoltageEventCritical 31 spFanEventInformational 32 spFanEventWarning 33 spFanEventCritic.
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.
54 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004.
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.
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.
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).
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 .
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 .
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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.
72 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004.
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 .
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 .
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 .
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.
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.
78 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004.
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 use.
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 .
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.
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.
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.
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.
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.
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 .
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 .
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.
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 .
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.
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.
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 .
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.
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 .
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 hardw.
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).
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.
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.
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.
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.
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 .
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 .
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 .
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 .
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.
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 Buffe.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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 .
152 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004.
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.
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.
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.
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.
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.
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.
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.
160 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004.
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 .
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.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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.
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 .
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 .
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.
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).
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.
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.
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.
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.
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 h.
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 .
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.
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 b.
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 Shado.
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 In.
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 pro.
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.
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 .
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.
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.
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 .
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.
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.
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 op.
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.
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.
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 .
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.
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.
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.
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.
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 .
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.
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 .
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.
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.
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).
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.
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).
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.
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.
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 .
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.
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 .
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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 brow.
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, usin.
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.
232 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May , 2004.
Un point important après l'achat de l'appareil (ou même avant l'achat) est de lire le manuel d'utilisation. Nous devons le faire pour quelques raisons simples:
Si vous n'avez pas encore acheté Sun Microsystems V20Z c'est un bon moment pour vous familiariser avec les données de base sur le produit. Consulter d'abord les pages initiales du manuel d'utilisation, que vous trouverez ci-dessus. Vous devriez y trouver les données techniques les plus importants du Sun Microsystems V20Z - de cette manière, vous pouvez vérifier si l'équipement répond à vos besoins. Explorant les pages suivantes du manuel d'utilisation Sun Microsystems V20Z, vous apprendrez toutes les caractéristiques du produit et des informations sur son fonctionnement. Les informations sur le Sun Microsystems V20Z va certainement vous aider à prendre une décision concernant l'achat.
Dans une situation où vous avez déjà le Sun Microsystems V20Z, mais vous avez pas encore lu le manuel d'utilisation, vous devez le faire pour les raisons décrites ci-dessus,. Vous saurez alors si vous avez correctement utilisé les fonctions disponibles, et si vous avez commis des erreurs qui peuvent réduire la durée de vie du Sun Microsystems V20Z.
Cependant, l'un des rôles les plus importants pour l'utilisateur joués par les manuels d'utilisateur est d'aider à résoudre les problèmes concernant le Sun Microsystems V20Z. Presque toujours, vous y trouverez Troubleshooting, soit les pannes et les défaillances les plus fréquentes de l'apparei Sun Microsystems V20Z ainsi que les instructions sur la façon de les résoudre. Même si vous ne parvenez pas à résoudre le problème, le manuel d‘utilisation va vous montrer le chemin d'une nouvelle procédure – le contact avec le centre de service à la clientèle ou le service le plus proche.
