Sun Microsystems V20Z manual

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 . Appendix G contains detailed descriptions of Sensor commands. Se[...]

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 [...]

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. The Sun Fire™ V20z and Sun Fir e V40z servers and their ex[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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. These proprietary implementati[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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: #[...]

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[...]

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. SNMP provides a means to monitor and control network devices, and to manage co[...]

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[...]

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, [...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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. Note – Y ou must create a valid initial manager account before using SSH. The S[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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 . For[...]

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[...]

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[...]

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[...]

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[...]

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 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 [...]

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[...]

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[...]

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 [...]

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[...]

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 [...]

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[...]

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[...]

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 [...]

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 [...]

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 [{ [...]

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 [...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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 [...]

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[...]

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: ^[...]

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[...]

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[...]

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. Format Command format: platform set console {--serial|-s} platform This option conf[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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 [...]

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.[...]

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 [...]

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[...]

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[...]

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. 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[...]

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[...]

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[...]

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[...]

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[...]

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] [[...]

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[...]

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 . T ABLE H-1 lists the groups of sp subcommands. Note – Every command returns[...]

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[...]

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 [...]

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[...]

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[...]

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 [...]

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[...]

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 [...]

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 [...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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 | -[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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 [...]

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 [...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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:[...]

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} [...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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 [...]

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[...]

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[...]

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[...]

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 <[...]

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[...]

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[...]

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 |[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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[...]

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