Page 1 Sun Fire V20z and Sun Fire V40z Servers ™ Server Management Guide Sun Microsystems, Inc. www.sun.com Part No. 817-5249-11 May, 2004, Revision A Submit comments about this document at: http://www.sun.com/hwdocs/feedback...
Page 2 Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, États-Unis. Tous droits réservés. Sun Microsystems, Inc. a les droits de propriété intellectuelle relatants à la technologie qui est décrite dans ce document. En particulier, et sans la limitation, ces droits de propriété...
Page 3: Table Of Contents
Contents Preface xix How This Book Is Organized Related Documentation xx Accessing Sun Documentation xxi Third-Party Web Sites xxi Contacting Sun Technical Support xxi Sun Welcomes Your Comments xxi Introduction 1 Overview 1 Acronyms Server Management Service Processor 3 Server-Management Interfaces SNMP Integration 4 Operator Panel User Groups 8...
Page 4 Assigning Static SP Network Settings Part II: Securing the Service Processor Creating the Initial Manager Account 13 Enabling IPMI Access on the Server 14 Enabling IPMI Access on a Linux-Based Server (In-Band) Enabling IPMI Access on a Solaris-Based x86 Server (In-Band) Enabling IPMI LAN Access Enabling IPMI LAN Access on a Linux-Based Server (In-Band) Enabling IPMI LAN Access on a Solaris-Based x86 Server (In-Band)
Page 5 IPMI Linux Kernel Device Driver LAN Interface for the BMC Files 37 Viewing the IPMI System Event Log Clearing the IPMI System Event Log 38 IPMI Troubleshooting SNMP Server Management 41 Simple Network Management Protocol SNMP Integration SNMP Management Information Base (MIB) Sun Fire V20z and Sun Fire V40z Servers MIB Tree 43 Integrating MIBs with Third-Party Consoles 43 Configuring SNMP on Your Server...
Page 6 Remote Scripting Using SSH Configuring Multiple Systems for Scripting 57 Generating Host Keys Creating Trusted Host Relationships Adding Public Keys Generating a Host Key Pair Enabling SSH Access Using Trusted Hosts Enabling SSH Access Using Public Keys Guidelines for Writing Server Management Command Scripts 61 Command Output 61 Other Tips For Best Results Console Redirection Over Serial on a...
Page 7 Commands 75 Return Codes Access Commands 79 Access Groups Subcommands Access Get Group Subcommand Format 80 Return Codes 80 Access Get Groups Subcommand Format 81 Return Codes 81 Access Map Subcommands Access Get Map Subcommand Format 82 Return Codes 83 Access Map Subcommand 83 Format 83 Return Codes 84...
Page 8 Format 89 Return Codes 90 Access Trust Subcommands Access Add Trust Subcommand Format 91 Generating Host Keys 92 Return Codes 93 Access Delete Trust Subcommand Format 93 Return Codes 94 Access Get Trusts Subcommand 94 Format 94 Return Codes 95 Access Public Key Subcommands Access Add Public Key Subcommand Format 96...
Page 9 Format 101 Return Codes 102 Access Get Users Subcommand Format 103 Return Codes 103 Access Update Password Subcommand Format 104 Return Codes 104 Access Update User Subcommand Format 105 Return Codes 106 Diagnostics Commands 107 Diags Cancel Tests Subcommand Format 108 Return Codes 109 Diags Get State Subcommand Format 110...
Page 10 Format 116 Return Codes 116 Inventory Commands 117 Inventory Compare Versions Subcommand Format 118 Return Codes 119 Inventory Get Hardware Subcommand Format 119 Return Codes 120 Inventory Get Software Subcommand Format 121 Return Codes 121 Inventory Get All Subcommand Format 122 Return Codes 122 IPMI Commands 123 IPMI Disable Channel Subcommand...
Page 11 Return Codes 127 IPMI Enable PEF Subcommand Format 128 Return Codes 128 IPMI Get Global Enables Subcommand Format 129 Return Codes 129 IPMI Set Global Enable Subcommand Format 130 Return Codes 131 IPMI Reset Subcommand Format 132 Return Codes 132 Platform Commands 133 Platform Console Subcommands Platform Console Subcommand...
Page 12 Platform Set OS State Subcommand 144 Format 144 Return Codes 145 Platform Set OS State Boot Subcommand Format 145 Return Codes 146 Platform Power State Subcommands Platform Get Power State Subcommand Format 147 Return Codes 148 Platform Set Power State Subcommand Format 148 Return Codes 149 Platform Get Hostname Subcommand...
Page 13 SP Date Subcommands SP Get Date Subcommand Format 162 Return Codes 163 SP Set Date Subcommand Format 163 Return Codes 164 SP DNS Subcommands SP Disable DNS Subcommand Return Codes 165 SP Enable DNS Subcommand Format 166 Return Codes 166 SP Get DNS Subcommand Format 167 Return Codes 167...
Page 14 Format 172 Return Codes 173 SP IP Subcommands SP Get IP Subcommand Format 174 Return Codes 175 SP Set IP Subcommand Format 175 Return Codes 176 SP JNET Address Subcommands SP Get JNET Subcommand Format 177 Return Codes 178 SP Set JNET Subcommand Format 178 Return Codes 179 SP Locate Light Subcommands...
Page 15 Format 183 Return Codes 184 SP Miscellaneous Subcommands SP Create Test Events Subcommand Format 185 Return Codes 186 SP Get Port 80 Subcommand Format 186 Return Codes 187 BIOS POST Codes Boot Block Codes for Flash ROM SP Load Settings Subcommand Format 193 Return Codes 194 SP Get Status Subcommand...
Page 16 Format 201 Return Codes 202 SP Delete Mount Format 203 Return Codes 203 SP Get Mount Subcommand Format 204 Return Codes 204 SP SMTP Subcommands 205 SP Get SMTP Server Subcommand Format 205 Return Codes 206 SP Set SMTP Server Subcommand Format 207 Return Codes 207 SP Get SMTP Subscribers Subcommand...
Page 17 SP Get SNMP Destinations Subcommand 215 Format 215 Return Codes 215 SP Get SNMP Proxy Community Subcommand Format 216 Return Codes 216 SP Set SNMP Proxy Community Subcommand Format 216 Return Codes 217 SP SSL Subcommands SP Disable SSL-Required Subcommand Format 218 Return Codes 218 SP Enable SSL-Required Subcommand...
Page 18 Return Codes 224 SP Update Flash PIC Subcommand Format 225 Return Codes 225 SP Update Diags Subcommand Format 226 Return Codes 226 xviii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 19: Preface
Preface This guide explains how to manage the Sun Fire™ V20z and Sun Fire V40z servers. How This Book Is Organized Chapter 1 provides an overview of the ways in which a user can manage the servers. “Introduction” on page Chapter 2 describes how to manage the servers through the Intelligent Platform Management Interface (IPMI).
Page 20: Related Documentation
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. See “Sensor Commands” on page 153.
Page 21: Accessing Sun Documentation
Accessing Sun Documentation You can view, print, or purchase a broad selection of Sun documentation, including localized versions, at: http://www.sun.com/documentation Third-Party Web 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 liable for any content, advertising, products or other materials that are available on or through such sites or resources.
Page 22 xxii Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 23: Introduction
C H A P T E R Introduction Overview Strong server-management capabilities are crucial to maintaining mission-critical servers. Advance notification of problems and rapid diagnosis and correction are critical functions to an environment in which a few servers bear the bulk of the workload.
Page 24: Acronyms
Acronyms defines the acronyms found in this document. TABLE 1-1 Acronyms TABLE 1-1 Acronym Explanation ACPI Advanced Configuration and Power Interface Address Resolution Protocol Baseboard Management Controller Customer-Replaceable Unit Direct Platform Control Field-Replaceable Unit grub Grand Unified Bootloader IPMI Intelligent Platform Management Interface Keyboard Controller Style Keyboard, video, and mouse Local Area Network...
Page 25: Server Management
Server Management There are several options for remotely managing a Sun Fire V20z or Sun Fire V40z server: Lights Out Management (LOM) through IPMItool Simple Network Management Protocol (SNMP) Service Processor The Sun Fire V20z and Sun Fire V40z servers include a dedicated chipset for complete operating-system independence and maximum availability of server-management functions.
Page 26: Snmp Integration
Command Line Interface Server-management capabilities are available from the command line. 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 return codes for each command. SSH and Scripting Capabilities A system administrator can log in to the Service Processor using SSH and issue commands, or more commonly, write a shell script that remotely invokes these...
Page 27 Sun Control Station IPMItool Third-Party Management MODULES: Health Monitoring, CLI LOM SNMP-based solutions Lights Out Management, Software (HP Open View, Management, AllStart and others CA UniCenter, etc.) (LOM) Platform NICs Service Processor NIC Gigabit Ethernet 10/100 Mb/s Server In-band Out-of-band Platform (In-band) SNMP...
Page 28: Operator Panel
Operator Panel You can use the operator panel to configure network settings for the SP. See for the operator panel location on your server. FIGURE 1-2 FIGURE 1-3 Note – The SP defaults to Dynamic Host Configuration Protocol (DHCP) networking if the operator panel is not interactively engaged on the first power-up. Operator panel buttons Operator panel display Sun Fire V20z Server Operator Panel and Buttons...
Page 29 The operator panel displays information on the LCD display in two lines, and you respond to prompts or initiate actions using the following buttons: Operator Panel Buttons TABLE 1-2 Buttons Function Back/No Select Forward/Yes Enter Cancel 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.
Page 30: User Groups
User Groups Administrators can define several different user groups, or types, on the server. Capabilities of the different user types are defined in TABLE 1-3 For example, when you log in to the system the first time using the setup account, the first thing you must do is set up the initial manager account so that other user accounts can be managed.
Page 31: Initial Setup Of The Service Processor
Initial Setup of the Service Processor This procedure 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”...
Page 32 Back Select Forward Press both for Cancel Press both for Enter Operator Panel Buttons FIGURE 1-4 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.
Page 33: Assigning Static Sp Network Settings
Assigning Static SP Network Settings Follow these steps to set the SP network settings using a static IP address. You 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.
Page 34 Note – The Back and Forward operator panel buttons automatically scroll, repeating the action as long as the button is held down. 8. Repeat Step 6 Step 7 for each field until the desired IP address is displayed, then use the Enter button combination to save the IP Address. The process continues to the next network setting, the Subnet Mask.
Page 35: Part Ii: Securing The Service Processor
Part II: Securing the Service Processor After you install the server and configure the SP, you must create the initial manager account to secure and access the server. You can then perform initial configuration of the server and create additional user accounts. Creating the Initial Manager Account A setup account is included with each server.
Page 36: Enabling Ipmi Access On The Server
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 procedure that corresponds to your OS: “Enabling IPMI Access on a Linux-Based Server (In-Band)” on page 14 “Enabling IPMI Access on a Solaris-Based x86 Server (In-Band)”...
Page 37 b. Install the openIPMI RPM file 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 “i386” architecture, run the following command: # rpm -ivh ipmitool*.i386.rpm If the installed Linux distribution uses the 64-bit “x86_64”...
Page 38: Enabling Ipmi Access On A Solaris-Based X86 Server (In-Band)
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 are located on the Documentation and Support Files CD in the /support/sysmgmt/solaris9 directory.
Page 39: Enabling Ipmi Lan Access
Enabling IPMI LAN Access This section contains three alternate procedures; two in-band procedures, and one out-of-band procedure. Use the procedure 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-Band)” on page 18 “Alternate Method for Enabling IPMI LAN Access (Out-of-Band)”...
Page 40: Enabling Ipmi Lan Access On A Solaris-Based X86 Server (In-Band)
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, configure the network setting for the SP by using the following commands.
Page 41: Upgrading The Linux Kernel
Upgrading the Linux Kernel Upgrading the installed Linux kernel to a newer version requires you to recompile 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.
Page 42: Daisy-Chaining The Servers
Daisy-Chaining the Servers You can interconnect multiple servers in a daisy chain configuration by using the SP connectors to form a management LAN as shown in . This figure also FIGURE 1-5 shows how the servers are connected to external LANs using the platform gigabit connectors.
Page 43: Site Integration
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 are separate from network connections for the platform. This allows you to configure the server so that the SP is connected to an isolated, management network and is not accessible from the production network.
Page 44 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.
Page 45: Updating The Service Processor Base Component
Updating the Service Processor Base Component To 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 filename [ -p port ] The spupdate.jar file is located in the spupdate folder of the Network Share Volume (NSV).
Page 46: Autoconfiguring The Sp (Optional Method)
Autoconfiguring the SP (Optional Method) Autoconfiguration replicates the majority of configuration files from an SP that has already been configured to another SP, so that the two servers have identical configurations, except for the host name and IP address. For example, after you configure a single SP (set up users, hosts, certificates, mounts and so on), you then run autoconfiguration on each additional SP so that the settings are identical.
Page 47: Determining Sp And Platform Network Mac Addresses
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 press the Select operator panel button to start autoconfiguration. 3.
Page 48 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 49: Ipmi Server Management
C H A P T E R IPMI Server Management Server manufacturers today have to re-invent how each new server manages itself. The hardware 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.
Page 50: Baseboard Management Controller
Baseboard Management Controller In order to perform autonomous platform-management functions, the processor runs embedded software or firmware. Together, the processor and its controlling firmware are referred to as the Baseboard Management Controller (BMC), which is the core of the IPMI structure. Tightly integrating an IPMI BMC and management software with platform firmware facilitates a total management solution.
Page 51: Ipmi Compliance And Lan Channel Access
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 channel access is disabled by default.
Page 52: Lights Out Management (Lom)
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 Interface (IPMI) v1.5 specification. It provides the ability to: Read the Sensor Data Record (SDR) and print sensor values Display the contents of the System Event Log (SEL)
Page 53: Options
Options lists the options available for IPMItool. TABLE 2-1 Options for IPMItool TABLE 2-1 Option Description Provides help on basic usage from the command line. Makes the output suitable for parsing, where possible, by separating fields with commas instead of spaces. Attempts to make IPMI-over-LAN communications more robust.
Page 54: Expressions
Expressions lists the expressions and parameters available for IPMItool. TABLE 2-2 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 servers, but you can enable a Serial-over-LAN feature.
Page 55 Expressions and Parameters for IPMItool (2 of 4) TABLE 2-2 Expression Parameter Sub-parameter Description and examples 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...
Page 56 Expressions and Parameters for IPMItool (3 of 4) TABLE 2-2 Expression Parameter Sub-parameter Description and examples power Performs a chassis control command to view and change the power state. status Shows the current status of the chassis power. Powers on the chassis. Powers off chassis into the soft off state (S4/S5 state).
Page 57 Expressions and Parameters for IPMItool (4 of 4) TABLE 2-2 Expression Parameter Sub-parameter Description and examples arp respond Sets the BMC-generated ARP responses. [on|off] arp generate Sets the BMC-generated gratuitous ARPs. [on|off] arp interval Sets the interval for the BMC-generated gratuitous ARPs. [seconds] s auth level,...
Page 58: Ipmi Linux Kernel Device Driver
IPMI Linux Kernel Device Driver The IPMItool application utilizes a modified MontaVista 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 hardware address and modified device IO registration.
Page 59: Files
Remote Management Control Protocol is a request-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-session connection;...
Page 60: Viewing The Ipmi System Event Log
Viewing the IPMI System Event Log To 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: # ipmitool -I open sel list Note –...
Page 61: Ipmi Troubleshooting
IPMI Troubleshooting describes some potential issues with IPMI and provides solutions. TABLE 2-3 IPMI Troubleshooting TABLE 2-3 Issue Solution You cannot connect to the Verify the network connection to the management management controller using controller and its IP address and verify the channel is IPMItool over LAN.
Page 62 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 63: Snmp Server Management
C H A P T E R SNMP Server Management You can manage your server using the Simple Network Management Protocol (SNMP). Simple Network Management Protocol 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 configurations, statistics collection, performance and security on a network.
Page 64: Snmp Integration
SNMP Integration SNMP is an open network-management technology that enables the management of networks and entities connected to the network. Within the SNMP architecture is a collection of network-management stations and managed nodes. Network-management stations execute management applications, which monitor and control managed nodes.
Page 65: Sun Fire V20Z And Sun Fire V40Z Servers Mib Tree
Sun Fire V20z and Sun Fire V40z Servers MIB Tree illustrates the MIB tree: FIGURE 3-1 MIB Tree FIGURE 3-1 Integrating MIBs with Third-Party Consoles You 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, located at object identifier (OID) 1.3.6.1.2.1.9237.
Page 66: Configuring Snmp On Your Server
Configuring SNMP on Your Server Note – There are several services that are supplied by the SNMP agent on the server. Depending on your business needs and the configuration of your current office network and management environment, you might want to take advantage of these services.
Page 67: Snmp Agent On The Service Processor
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 for a list of the MIBs; refer to for a detailed description FIGURE 3-1 TABLE 3-3...
Page 68: Setting The Community Name
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 Your Server” on page 44.) To properly proxy, you must use the community string. The community string needed to do so is the value defined when you configured the platform for SNMP.
Page 69: Using A Third-Party Mib Browser
Using a Third-Party MIB Browser 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 placed and click Open. 5.
Page 70: Snmp Traps
SNMP Traps 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 health, including critical conditions related to physical components, the return to a normal state for these components, and other situations related to the state of the software running on the SP (for example, network settings being reconfigured).
Page 71: Configuring Snmp Trap Destinations
Configuring SNMP Trap Destinations Although SNMP traps are generated for events that occur on the SP, you must configure where these traps are to be sent. There is no default destination for traps. You can use the server-management subcommands (see ) on the SP to TABLE 3-2 configure SNMP destinations.
Page 72: Server Mib Details
Server MIB Details SNMP uses object identifiers (OIDs) to provide name variables by which objects are grouped together for easier reference. These servers provide agents for the MIBs shown in TABLE 3-3 SNMP MIBs TABLE 3-3 Description SP-MasterAgent-MIB .1.3.6.1.4.1.9237 Creates the main trunk of the server MIB .mib tree.
Page 73 The events listed in are sent to the SNMP destination by TABLE 3-4 SP-EVENT-MIB.mib. SP Events (1 of 2) TABLE 3-4 Enterprise Trap ID Event spGenericEventInformational spGenericEventWarning spGenericEventCritical spTemperatureEventInformational spTemperatureEventWarning spTemperatureEventCritical spVoltageEventInformational spVoltageEventWarning spVoltageEventCritical spFanEventInformational spFanEventWarning spFanEventCritical spPlatformMachineCheckEventInformational spPlatformMachineCheckEventWarning spPlatformMachineCheckEventCritical spPlatformStateChangeEventInformational spPlatformStateChangeEventWarning spPlatformStateChangeEventCritical...
Page 74 SP Events (2 of 2) TABLE 3-4 Enterprise Trap ID Event spVoltageEventWarning spVoltageEventCritical spFanEventInformational spFanEventWarning spFanEventCritical spPlatformStateChangeEventInformational spPlatformStateChangeEventWarning spPlatformStateChangeEventCritical spPlatformBIOSEventInformational spPlatformBIOSEventWarning spPlatformBIOSEventCritical Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 75: Snmp Troubleshooting
SNMP Troubleshooting describes a potential issue with SNMP and provides a solution. TABLE 3-5 SNMP Troubleshooting TABLE 3-5 Issue Solution SNMP queries to the SP time out. The platform OS requires both the NPS driver suite RPM and an active SNMP daemon sharing the SP’s community string.
Page 76 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 77: Further Management Information
C H A P T E R Further Management Information Configuring 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.
Page 78: Using Shell Scripts
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 configurations for all SPs must be synchronized, you can automate configuration changes. As a Unix/Linux administrator, you can use SSH, trusted host relationships or public key authentication, and Unix/Linux shell scripting to automate tasks that need to be performed on multiple SPs.
Page 79: Configuring Multiple Systems For Scripting
If using trusted host relationships for passwordless access, the SP must have a local user of the same name as the remote user (or the remote user should be a member of a directory service group that is mapped to a local SP administrative group). You can also add your public key file instead of creating a trusted host relationship to be authenticated via SSH.
Page 80: Creating Trusted Host Relationships
Note – Use scp to copy the files to either /tmp or to your home directory. The sp commands will then install the file specified on the command line. Creating Trusted Host Relationships Adding a trusted host relationship is one way to allow for passwordless access and thus is a means for one-to-many scripting.
Page 81: Generating A Host Key Pair
# 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.
Page 82: Enabling Ssh Access Using Public Keys
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.
Page 83: Guidelines For Writing Server Management Command Scripts
Guidelines for Writing 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: You should be familiar with standard shell scripting. Refer to “Using Shell Scripts”...
Page 84: Other Tips For Best Results
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 lines have the same number and type of data values, each row is printed to a separate line so variable data can be parsed easily.
Page 85: Console Redirection Over Serial On A Linux-Based Server
Console Redirection Over Serial on a Linux-based Server Caution – Redirecting the console over serial is a procedure intended for advanced users of Linux only. You can seriously disrupt the proper functioning of the server or render the server unbootable if you introduce a problem in the configuration files. Note –...
Page 86: Grub
grub If you use grub, there are three steps to enable console redirection over serial; these steps all involve editing the grub configuration file: If you are using Red Hat Linux, the grub file is /etc/grub.conf. If you are using SUSE Linux, the grub file is /boot/grub/menu.1st. Note –...
Page 87: Lilo
A working-image section in your grub configuration file 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_revision is simply the kernel version that you are using. 1. Change the stock kernel entry of your image to include the console-kernel parameters, as follows: kernel /vmlinuz-kernel_revision ro root=/dev/sda5 console=ttyS0,9600 console=tty0...
Page 88: Getty
getty You can run a service called getty to enable login on the serial interface. To 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 line in the list. Note –...
Page 89: Enabling And Configuring Bios Console Redirection
Enabling and Configuring BIOS Console Redirection Note – Console redirection 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-redirection settings. 1. Boot or reboot the server. 2.
Page 90: Network Share Volume (Nsv) Cd-Rom
Network Share Volume (NSV) CD-ROM A network share volume (NSV) structure is included with the server on the Sun Fire V20z and Sun Fire V40z Servers Network Share Volume CD. Although the SP functions normally without access to an external file system, a file system is required to enable several features, including event log files, software updates, diagnostics, and the troubleshooting dump utility.
Page 91 When extracted, the compressed packages in populate the following files TABLE 4-1 on the NSV: /mnt/nsv/ diags logs scripts snmp spupdate sw_images (this folder appears after you extract one of the OS-speciﬁc Zip ﬁles) Extracted Files on the Network Share Volume TABLE 4-2 File Name Description...
Page 92: Serial Over Lan
Serial Over LAN The Serial Over LAN (SOL) feature lets servers transparently redirect the serial character stream from the baseboard Universal Asynchronous Receiver/Transmitter (UART) to and from the remote-client system over LAN. Serial over LAN has the following benefits compared to a serial interface: Eliminates the need for a serial concentrator.
Page 93: Launching An Sol Session
Note – Ensure that the baud rate value passed to the -S argument matches the speed that was specified for the serial redirection feature of the BIOS and the speed used for your boot loader and OS configuration. Disabling the SOL feature To disable the feature, run the following command: # ssh -l spuser spipaddr platform set console -s platform Launching an SOL Session...
Page 94 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 95: Server Management Commands Summary
A P P E N D I X 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 referred to as the server management commands. Note –...
Page 96: Using The Ssh Protocol
Using the ssh Protocol You must use ssh to execute these commands on the service processor (SP). There 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 To use the interactive shell: Log into and authenticate on the interactive shell by running the command:...
Page 97: Commands
Commands The server management commands take arguments, perform one or more actions, and display the result or text to the standard output device. Commands are grouped by similar function; each command has numerous subcommands supporting functions within that grouping Note – Every command (except help) returns a return code upon completion. See “Return Codes”...
Page 98: Return Codes
Server Management Commands TABLE A-1 Command Description sensor Reports or sets the value of an environmental sensor or control. Appendix G, “Sensor Commands.” Allows the authorized user to manage and monitor the SP configurations, such as networking, external file system, SNMP, SMTP, SSL, event logs and so on.
Page 99 Return Codes (2 of 2) TABLE A-2 Return Code Description NWSE_NoPermission Not authorized to perform this operation. NWSE_MissingArgument Missing argument(s). NWSE_NoMemory Insufficient memory. NWSE_Busy Device or resource is busy. NWSE_NotImplemented Function not implemented. NWSE_RPCConnected RPC client already connected. NWSE_RPCConnRefused RPC connection refused. NWSE_NoRouteToHost No route to host (network down).
Page 100 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 101: Access Commands
A P P E N D I X 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 group, and specify a mapping between site-defined administrative groups and the administrative groups that are used to authorize actions on the Service Processor.
Page 102: Access Groups Subcommands
Access Groups Subcommands The subcommands in return the authorization group for a specific user or TABLE B-2 a list of defined groups. Access Group Subcommands TABLE B-2 Subcommand Description Returns the authorization group for the specified user. access get group Returns a list of the groups defined, including the standard access get groups groups.
Page 103: Access Get Groups Subcommand
Access Get Groups Subcommand Description: Returns a list of the groups defined, including the standard groups. Format Command format: access get groups Return Codes lists the return codes for this subcommand. TABLE B-4 Return Codes for Subcommand access get groups TABLE B-4 Return Code Description...
Page 104: Access Map Subcommands
Access Map Subcommands The subcommands in manage mappings between existing site-specified TABLE B-5 groups and one of the standard administrative groups. Access Map Subcommands TABLE B-5 Subcommand Description Returns the names of all the site-specified groups mapped to a specific access get map administrative group.
Page 105: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-7 Return Codes for Subcommand access get map TABLE B-7 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 106: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-9 Return Codes for Subcommand access map TABLE B-9 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 107: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-11 Return Codes for Subcommand access unmap TABLE B-11 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 108: Access Directory Services Subcommands
Access Directory Services Subcommands Services defines a directory-services mechanism that determines the group memberships for a user. Remote users gain access to the Service Processor features only through these group mappings that relate a directory-services group to a local Service-Processor administrative group. Therefore, using the command access map, the administrator must set up the appropriate directory-services configuration and create mappings from the directory-services groups to local Service-Processor administrative groups.
Page 109: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-14 Return Codes for Subcommand access disable service TABLE B-14 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 110: Return Codes
lists the arguments for this subcommand. TABLE B-15 Arguments for Subcommand access enable service TABLE B-15 Argument Description Specifies the domain name. {-d | --domain} Specifies the server. {-s | --server} For ADS only: Specifies the ADS keytab file name. {-k | --keytab} For ADS only: Specifies the organizational unit under which the {-o | --ou}...
Page 111: Access Get Services Subcommand
Return Codes for Subcommand access enable service TABLE B-16 Return Code Description Unable to connect to the RPC server. NWSE_RPCNotConnected One or more arguments were incorrect or invalid. NWSE_InvalidArgument Entity (user, service, file, path, etc.) was not found. NWSE_NotFound Not authorized to perform this operation. NWSE_NoPermission File open, file missing, or a read or write error NWSE_FileError...
Page 112: Return Codes
Arguments for Subcommand access get services TABLE B-17 Argument Description For ADS only: Returns the ADS logon ID. Only one of the {-l | --ID} parameters -o and -l are permitted at a time. For ADS only: Returns the organization unit information. {-o | --ou} Only one of the parameters -o and -l are permitted at a time.
Page 113: Access Trust Subcommands
Access Trust Subcommands Adding host-based trusts provides many-to-one scripting solutions. Once a host equivalence relationship has been created with a client, users on that client can remotely execute commands on the SP without being prompted for a password. lists the commands related to trusted host relationships. TABLE B-19 Access Trust Subcommands TABLE B-19...
Page 114: Generating Host Keys
If the login is authorized through a mapping of a directory-service group, 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 on the SP, the client machine must be specified with its DNS name, (and not the IP address).
Page 115: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-21 Return Codes for Subcommand access add trust TABLE B-21 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 116: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-23 Return Codes for Subcommand access delete trust TABLE B-23 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 117: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-24 Return Codes for Subcommand access get trusts TABLE B-24 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 118: Access Public Key Subcommands
Access Public Key Subcommands The subcommands listed in allow you to manage public keys and TABLE B-25 public-key users. Access Public Key Subcommands TABLE B-25 Subcommand Description Installs a public key for SSH authentication. access add public key Determines which users have public keys installed. access get public key users Removes a user’s public key.
Page 119: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-27 Return Codes for Subcommand access add public key TABLE B-27 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting options NWSE_InvalidUsage specified. Request was issued, but was not serviced by the server. NWSE_RPCTimeout RPC procedure timed out and the request may or may not have been serviced by the server.
Page 120: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-28 Return Codes for Subcommand access get public key users TABLE B-28 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 121: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-30 Return Codes for Subcommand access delete public key TABLE B-30 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting options NWSE_InvalidUsage specified. Request was issued, but was not serviced by the server. NWSE_RPCTimeout RPC procedure timed out and the request may or may not have been serviced by the server.
Page 122: Access User Subcommands
Access User Subcommands The subcommands listed in allow you to manage a single user or group of TABLE B-31 users. Access User Subcommands TABLE B-31 Subcommand Description Adds the specified local user to the specified group. access add user Deletes the specified user. access delete user Retrieves all the users in an administrative group or all access get users...
Page 123: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-33 Return Codes for Subcommand access add user TABLE B-33 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 124: Return Codes
lists the arguments for this subcommand. TABLE B-34 Arguments for Subcommand access delete user TABLE B-34 Argument Description Specifies the name of the user to remove. This argument is USERNAME repeatable to remove multiple users at one time. Removes all user accounts. The manager-level user executing the [-a | --all] command is not removed.
Page 125: Access Get Users Subcommand
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>}] lists the arguments for this subcommand. TABLE B-36 Arguments for Subcommand access get users TABLE B-36 Argument Description...
Page 126: Access Update Password Subcommand
Access Update Password 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 | --password} PASSWORD {u | --user} USER lists the arguments for this subcommand.
Page 127: Access Update User Subcommand
Return Codes for Subcommand access update password TABLE B-39 Return Code Description One or more arguments were incorrect or invalid. NWSE_InvalidArgument Entity (user, service, file, path or other) was not found. NWSE_NotFound Not authorized to perform this operation. NWSE_NoPermission Access Update User Subcommand Description: Updates the login information (password or group) for the user.
Page 128: Return Codes
Return Codes lists the return codes for this subcommand. TABLE B-40 Return Codes for Subcommand access update user TABLE B-41 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 129: Diagnostics Commands
A P P E N D I X Diagnostics Commands The diags commands allow you to manage the diagnostics tests. lists the groups of diags subcommands. TABLE C-1 Note – The diagnostics commands are also provided in the Sun Fire V20z Server User Guide, 817-5248.
Page 130: Diags Cancel Tests Subcommand
Diags Cancel Tests 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}]] lists the arguments for this subcommand. TABLE C-2 Note –...
Page 131: Return Codes
Return Codes lists the return codes for this subcommand. TABLE C-3 Return Codes for Subcommand diags cancel tests TABLE C-3 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 132: Diags Get State Subcommand
Diags Get State Subcommand Description: Returns the state of the platform-diagnostics control server. Format Command format: diags get state If the result returned from the command is that the platform is up and ready for diagnostics, then you can submit platform diagnostic tests for execution. Success Text message –...
Page 133: Diags Get Tests Subcommand
Diags Get Tests 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: ags get tests [{ -a | --all}] [{-H | --noheader}]] [{-D | --delim <DELIMITER>}] lists the arguments for this subcommand.
Page 134: Diags Run Tests Subcommand
Return Codes for Subcommand diags get tests TABLE C-6 Return Code Description One or more arguments were incorrect or invalid. NWSE_InvalidArgument Not authorized to perform this operation. NWSE_NoPermission Missing argument(s). NWSE_MissingArgument Diags Run Tests Subcommand Description: Submits one or more diagnostic tests for execution. Format Command format: diags run tests [ [{ -n | --name} TEST NAME ] [{-a| --all}]...
Page 135: Return Codes
Test Result (for example: Passed, Failed) Details. If you specify the -v option, the Test 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 are displayed with a text message indicating the cause of failure.
Page 136: Diags Start Subcommand
Diags Start Subcommand Description: Starts the SP and platform-diagnostics framework. You must execute this command before running any tests. After running this command, you can immediately run Service Processor tests or wait for the subcommand diags get state to return the result platform diags available, at which point you can run platform tests.
Page 137: Not Authorized To Perform This Operation
Return Codes for Subcommand diags start TABLE C-9 Return Code Description One or more arguments were incorrect or invalid. NWSE_InvalidArgument Not authorized to perform this operation. NWSE_NoPermission Invalid operation for current state. NWSE_InvalidOpForState Appendix C Diagnostics Commands...
Page 138: Diags Terminate Subcommand
Diags Terminate Subcommand Description: Terminates all diagnostics tests and the diagnostics session. Format Command format: diags terminate Return Codes lists the return codes for this subcommand. TABLE C-10 Return Codes for Subcommand diags terminate TABLE C-10 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage...
Page 139: Inventory Commands
A P P E N D I X Inventory Commands The inventory command reports on the inventory of hardware and software for a Sun Fire V20z server. lists the groups of inventory subcommands that you can use to retrieve TABLE D-1 specific information about hardware or software.
Page 140: Inventory Compare Versions Subcommand
Inventory Compare Versions Subcommand Description: Returns a list of all installed software packages and the version differences with those listed in a release manifest. You can use this command to verify that your installation is consistent with a supported release and to determine the packages that have been updated in a new release.
Page 141: Return Codes
Return Codes lists the return codes for this subcommand. TABLE D-3 Return Codes for Subcommand inventory compare versions TABLE D-3 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 142: Return Codes
To obtain the board revision, product ID and PRS revision, you can run the following commands: inventory get hardware -D '|' | awk -F '|' '/PRS/{print $8}' inventory get hardware -D '|' | awk -F '|' '/PRS/{print $7}' | awk '{print $4}' inventory get hardware -D '|' | awk -F '|' '/PRS/{print $6}' You can also obtain this information by running the sensor get command.
Page 143: Inventory Get Software Subcommand
Inventory Get Software 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>}] lists the arguments for this subcommand. TABLE D-6 Arguments for Subcommand inventory get software TABLE D-6...
Page 144: Inventory Get All Subcommand
Inventory Get All Subcommand Description: Returns detailed information for all field-replaceable hardware components and all installed or uninstalled software. Format Command format: {-v | --verbose} inventory get all {-a | --all} [{-H | --noheader}] [{-D | --delim <DELIMITER>}] lists the arguments for this subcommand. TABLE D-8 Arguments for Subcommand inventory get all TABLE D-8...
Page 145: Ipmi Commands
A P P E N D I X IPMI Commands The ipmi command manages the Intelligent Platform Management Interface (IPMI) functions. lists the groups of ipmi subcommands. TABLE E-1 IPMI Subommands Groups TABLE E-1 Subcommand Description Disables one of two IPMI channels. ipmi disable channel Enables one of two IPMI channels.
Page 146: Ipmi Disable Channel Subcommand
IPMI Disable Channel Subcommand Description: Allows you to disable one of two IPMI channels. Format Command format: ipmi disable channel {sms | lan} lists the arguments for this subcommand. TABLE E-2 Arguments for Subcommand ipmi disable channel TABLE E-2 Arguments Description The ID of the channel to disable for the System Interface;...
Page 147: Ipmi Enable Channel Subcommand
IPMI Enable Channel Subcommand Description: Allows you to enable one of two IPMI channels. Format Command format: ipmi enable channel {sms | lan} lists the arguments for this subcommand. TABLE E-4 Arguments for Subcommand ipmi enable channel TABLE E-4 Arguments Description The ID of the channel to enable for the System Interface;...
Page 148: Ipmi Get Channels Subcommand
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 lists the return codes for this subcommand TABLE E-6 Return Codes for Subcommand ipmi get channels TABLE E-6 Return Code Description...
Page 149: Ipmi Disable Pef Subcommand
IPMI Disable PEF Subcommand Description: Allows you to disable platform-event filtering (PEF). Format Command format: ipmi disable pef Return Codes lists the return codes for this subcommand TABLE E-7 Return Codes for Subcommand ipmi disable pef TABLE E-7 Return Code Description Command successfully completed.
Page 150: Ipmi Enable Pef Subcommand
IPMI Enable PEF Subcommand Description: Allows you to enable platform-event filtering (PEF). Format Command format: ipmi enable pef Return Codes lists the return codes for this subcommand TABLE E-8 Return Codes for Subcommand ipmi enable pef TABLE E-8 Return Code Description Command successfully completed.
Page 151: Ipmi Get Global Enables Subcommand
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 lists the return codes for this subcommand TABLE E-9 Return Codes for Subcommand ipmi get global enables TABLE E-9 Return Code Description...
Page 152: Ipmi Set Global Enable Subcommand
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}} lists the arguments for this subcommand. TABLE E-10 provides information about the aliases. TABLE E-11 Arguments for Subcommand ipmi set global enable TABLE E-10...
Page 153: Return Codes
Information about the aliases TABLE E-11 Alias Name String Values Default Enable Event Message Buffer Enabled/ msg_buf Disabled Enable the Event Message Buffer Enabled/ msg_buf_interrupt Full Disabled Enable Receive Message Queue Enabled/ Enabled msg_queue_interrupt Interrupt Disabled Return Codes lists the return codes for this subcommand. TABLE E-12 Return Codes for Subcommand ipmi set global enable TABLE E-12...
Page 154: Ipmi Reset Subcommand
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} lists the arguments for this subcommand. TABLE E-13 Arguments for Subcommand ipmi reset TABLE E-13 Arguments Description...
Page 155: Platform Commands
A P P E N D I X Platform Commands The platform command reports or changes some aspect of the state of the platform. lists the groups of platform subcommands. TABLE F-1 Platform Subcommand Groups TABLE F-1 Subcommand Group Description Manages access to the platform serial console.
Page 156: Platform Console Subcommands
Platform Console Subcommands The subcommands listed in allow you to manage access to the platform TABLE F-2 serial console. Platform Console Subcommands TABLE F-2 Subcommand Description Provides access to the platform serial console. platform console Retrieves the configuration of the Service Processor (SP) access platform get console to the platform serial console.
Page 157 lists common COM1 values. lists common values for console TABLE F-3 TABLE F-4 redirection. Common COM1 Values TABLE F-3 I/O Device Configuration Serial port A Enabled Base I/O address Interrupt IRQ 4 Common Values for Console Redirection TABLE F-4 Console Redirection Com Port Address On-board COM A Console connection...
Page 158 Serial-Console Values TABLE F-5 Character Function Forces an attach read/write. Groups information. Information dump. Toggles logging on/off. Breaks the sequence list. Sends a break per configuration file. Sends a specific break sequence. l1-9 Re-opens the tty and log file. Replays the last 60 lines. Replays the last 20 lines.
Page 159: Return Codes
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 lists the return codes for this subcommand.
Page 160: Platform Get Console Subcommand
Platform Get Console Subcommand Description: Retrieves the configuration information regarding the Service Processor (SP) access to the platform serial console. Format Command format: {-D | --delim platform get console [{-H|--noheader}] [ <DELIMITER>}] lists the arguments for this subcommand. TABLE F-7 Arguments for Subcommand platform get console TABLE F-7 Arguments...
Page 161: Return Codes
Supplementary Output TABLE F-8 Column Description Indicates the communications speed of the link. Speed Indicates whether ANSI escape code and duplicate information pruning Prune is enabled. Indicates the approximate size at which log rotation occurs (for example, Log Trigger when the file console.0 is removed, the current log is moved to console.0 and a new log file is opened).
Page 162: Platform Set Console
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 configures the external serial port so that it is connected to the platform serial console.
Page 163: Return Codes
Arguments for Subcommand platform set console TABLE F-10 Arguments Description Indicates that the platform console log should be the raw {-n | --noprune} console data. Cannot be used with: -p. Indicates that the platform console log is to be cleaned of {-p | --prune} ANSI sequences and pruned of duplicated information.
Page 164: Platform Os State Subcommands
Platform OS State Subcommands The subcommands listed in allow you to manage the operating TABLE F-12 system (OS). Platform OS State Subcommands TABLE F-12 Subcommand Description Retrieves the current state of the platform OS (for platform get os state example, running, booting, off and so on). Reboots the platform into the default OS, BIOS setup or platform set os state BIOS update, or shuts down the platform.
Page 165: Return Codes
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 remains in the Communicating state even though it can no longer communicate with the platform. Refer to “Platform Set OS State Subcommand”...
Page 166: Platform Set Os State Subcommand
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 configure the BIOS parameters while BIOS update allows you to reflash the BIOS image.
Page 167: Return Codes
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 remains in the Communicating state even though it can no longer communicate with the platform. Refer to “Platform Get OS State Subcommand”...
Page 168: Return Codes
lists the arguments for this subcommand. TABLE F-16 Arguments for Subcommand platform set os state boot TABLE F-16 Arguments Description Results in a hard power off. This option is ignored. {-f | --forced} Allows you to reflash the BIOS image. [-b | --bios] Suppresses interative warning messages.
Page 169: Platform Power State Subcommands
Platform Power State Subcommands The subcommands listed in allow you to manage the platform power. TABLE F-18 Platform Power State Subcommands TABLE F-18 Subcommand Description Provides the ability to determine the platform power state platform get power state (for example, whether it is on or off). Provides the ability to turn the platform power on or off.
Page 170: Return Codes
Return Codes lists the return codes for this subcommand. TABLE F-19 Return codes for Subcommand platform get power state TABLE F-19 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting options NWSE_InvalidUsage specified. Request was issued, but was not serviced by the server. NWSE_RPCTimeout RPC procedure timed out and the request may or may not have been serviced by the server.
Page 171: Return Codes
lists the arguments for this subcommand. TABLE F-20 Arguments for Subcommand platform set power state TABLE F-20 Arguments Description If specified, the command returns immediately instead of {-W |--nowait} waiting for the operation to complete. Results in a hard power off. {-f | --forced} Specifies the maximum time to wait for the operation to {-t |--timeout}...
Page 172: Platform Get Hostname Subcommand
Platform Get Hostname Subcommand Description: Displays the host name of the current primary platform. The data is refreshed only when the platform is rebooted. Format Command format: platform get hostname [{-H|--noheader}] lists the argument for this subcommand. TABLE F-22 Argument for Subcommand platform get hostname TABLE F-22 Arguments Description...
Page 173: Platform Get Product Id Subcommand
Platform Get Product ID Subcommand Description: Displays the product ID for the current system. Format Command format: platform get product-id Note – You can also retrieve the product ID, board revision number and PRS revision number by running the subcommands sensor get and inventory get hardware.
Page 174 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 175: Sensor Commands
A P P E N D I X Sensor Commands The sensor command reports or sets the value of an environmental sensor or control. lists the groups of sensor subcommands. TABLE G-1 Sensor Subcommand Groups TABLE G-1 Subcommand Group Description Returns all data associated with a sensor.
Page 176: Sensor Get Subcommand
Sensor Get Subcommand Description: Returns all data associated with a sensor. By default, only the sensor ID and its current value are displayed. You can specify on the command line the order of the data output. Note – The identifier field is always displayed first, unless you suppress it with the -I option.
Page 177 lists the arguments for this subcommand. TABLE G-2 Arguments for Subcommand sensor get TABLE G-2 Arguments Description SENSOR_ID, PRODUCT-ID, BOARD-REVISION, {-i | --id} PRS-REVISION Specifies the sensor for which the data is desired. You can specify this argument multiple times, in which case the sensor data is reported in the order specified.
Page 178: Return Codes
Arguments for Subcommand sensor get TABLE G-2 Arguments Description Suppresses the display of the sensor ID column. By default, this {-I | --noid} column always displays when more than one sensor is selected. Suppresses the column headings. [-H | --noheader] Delimits columns with the specified delimiter.
Page 179 Note – There are 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 related component (parent) associated with them.
Page 180: Sensor Set Subcommand
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] [{-W | --warnhigh] VALUE] [{-w | --warnlow} VALUE] [{-v | --value} {on|off}] | {-r | --reset}} sensor set [{-t | --type] TYPE_ID] {[{-C | --crithigh} VALUE]...
Page 181: Return Codes
Arguments for Subcommand sensor set TABLE G-4 Arguments Description Sets the value of the sensor. {-v | --value} Resets all thresholds for the specified sensor(s) to the factory {-r | --reset} defaults. Resets all thresholds for all sensors to the factory defaults. {-R | --resetall} Return Codes lists the arguments for this subcommand.
Page 182 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...
Page 183: Service Processor Commands
A P P E N D I X Service Processor 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-notification groups for the SP event manager. lists the groups of sp subcommands.
Page 184: Sp Date Subcommands
Service Processor Subcommand Groups TABLE H-1 Subcommand Description Manages SNMP functions. SNMP Manages SSL capabilities. Sets the update flag to start the full flash update or copies the Update Flash Value-Add file to the Value-Add component of the SP flash. SP Date Subcommands The subcommands in manage the date and time on the SP.
Page 185: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-3 Return Codes for Subcommand sp get date TABLE H-3 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting options NWSE_InvalidUsage specified. Not authorized to perform this operation. NWSE_NoPermission Insufficient memory.
Page 186: Return Codes
Return Codes lists the return codes for this command. TABLE H-5 Return Codes for Subcommand sp set date TABLE H-5 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. One or more arguments were incorrect or invalid. NWSE_InvalidArgument Not authorized to perform this operation.
Page 187: Sp Dns Subcommands
SP DNS Subcommands The subcommands in manage the DNS configuration on the SP. TABLE H-6 SP DNS Subcommands TABLE H-6 Subcommand Description Disables the DNS configuration on the SP. sp disable dns Configures the DNS configuration on the SP. sp enable dns Displays the current DNS configuration on the SP.
Page 188: Sp Enable Dns Subcommand
SP Enable DNS Subcommand Description: Configures the DNS configuration on the SP. Because applications do not see updated DNS resolver configurations (in /etc/resolv.conf) until they are restarted, this command restarts server processes that depend on DNS. This currently includes the sshd daemon and the Security Manager.
Page 189: Sp Get Dns Subcommand
SP Get DNS Subcommand Description: Displays the current DNS configuration on the SP. Format Command format: sp get dns [{-n | --nameserver } | -s | --searchdomain } | {-D | --delim <DELIMITER>}] {-H | --noheader }] [ lists the arguments for this subcommand. TABLE H-10 Arguments for Subcommand sp get dns TABLE H-10...
Page 190: Sp Events Subcommands
SP Events Subcommands The subcommands in manage events on the SP. TABLE H-12 SP Events Subcommands TABLE H-12 Subcommand Description Clears an existing event using the event ID. sp delete event Returns detailed information about all active SP events. sp get events SP Delete Event Subcommand Description: Clears an existing event using the event ID.
Page 191: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-14 Return Codes for Subcommand sp delete event TABLE H-14 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 192: Return Codes
lists the arguments for this subcommand. TABLE H-15 Arguments for Subcommand sp get events TABLE H-15 Argument Description Specifies to display only information about this event; otherwise {-i | --id} information for all existing events returns. Specifies to display the history of either one or all events. {-d | --detail} Specifies to display all columns.
Page 193: Sp Hostname Subcommands
SP Hostname Subcommands The subcommands in manage the SP host and domain. TABLE H-17 SP Hostname Subcommands TABLE H-17 Subcommand Description Displays the current host name and optionally the domain name of sp get hostname the SP. Resets the host name or domain name of the SP to the specified sp set hostname name.
Page 194: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-19 Return Codes for Subcommand sp get hostname TABLE H-19 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Insufficient memory. NWSE_NoMemory Device or resource is busy. NWSE_Busy RPC client already connected.
Page 195: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-21 Return Codes for Subcommand sp set hostname TABLE H-21 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. One or more arguments were incorrect or invalid. NWSE_InvalidArgument Not authorized to perform this operation.
Page 196: Sp Ip Subcommands
SP IP Subcommands The subcommands in manage the SP network configuration. TABLE H-22 SP IP Subcommands TABLE H-22 Subcommand Description Retrieves the ethernet-based network configuration information for sp get ip the SP. Sets or modifies the SP network configuration. sp set ip SP Get IP Subcommand Description: Retrieves the ethernet-based network-configuration information for the SP, including IP address, network mask and gateway.
Page 197: Return Codes
Return Codes lists the arguments for this subcommand. TABLE H-24 Return Codes for Subcommand sp get ip TABLE H-24 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Insufficient memory. NWSE_NoMemory Device or resource is busy. NWSE_Busy RPC client already connected.
Page 198: Return Codes
lists the arguments for this subcommand. TABLE H-25 Arguments for Subcommand sp set ip TABLE H-25 Argument Description Specifies the IP address you wish to set. {-i | --ipaddress} Specifies the netmask; the default value is 255.255.255.0. {-n | --netmask} Specifies the gateway;...
Page 199: Sp Jnet Address Subcommands
SP JNET Address Subcommands The JNET address is used for communications between the SP and the platform. The subcommands in manage the SP JNET address. TABLE H-27 SP JNET Subcommands TABLE H-27 Subcommand Description Retrieves the JNET address. sp get jnet Sets the JNET address.
Page 200: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-29 Return Codes for Subcommand sp get jnet TABLE H-29 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Insufficient memory. NWSE_NoMemory Device or resource is busy. NWSE_Busy Host is down.
Page 201: Return Codes
lists the arguments for this subcommand. TABLE H-30 Arguments for Subcommand sp set jnet TABLE H-30 Argument Description Specifies the IP address for the platform. {-p | --platform} Specifies the IP address for the SP. {-s | --sp} 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 the JNET connection.
Page 202: Sp Locate Light Subcommands
SP Locate Light Subcommands The subcommands in manage the locatelight switch. TABLE H-32 SP Locatelight Subcommands TABLE H-32 Subcommand Description Reads the value of the locatelight switch (which represents sp get locatelight the state of the front and rear panel identification lights). Sets the state of the locatelight switch.
Page 203: Sp Set Locatelight Subcommand
SP Set Locatelight Subcommand Description: Sets the state of the locatelight switch (which describes the state of the front and rear panel identification lights). Format Command format: sp set locatelight {blink | off} Return Codes lists the return codes for this subcommand. TABLE H-34 Return Codes for Subcommand sp set locatelight TABLE H-34...
Page 204: Sp Logfile Subcommands
SP Logfile Subcommands The subcommands in manage the SP log files. TABLE H-35 SP Logfile Subcommands TABLE H-35 Subcommand Description Retrieves the event-log file configuration. sp get logfile Configures the event log file that is the destination of all Event sp set logfile Manager events and notices.
Page 205: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-37 Return Codes for Subcommand sp get logfile TABLE H-37 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 206: Return Codes
Return Codes lists the arguments for this subcommand. TABLE H-39 Return Codes for Subcommand sp set logfile TABLE H-39 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 207: Sp Miscellaneous Subcommands
SP Miscellaneous Subcommands The subcommands in manage miscellaneous SP functions. TABLE H-40 Miscellaneous SP Subcommands TABLE H-40 Subcommand Description Tests and validates different types of configurations you may sp create test events be considering for the SP. Retrieves the last port 80 postcode from the PRS Port80 sp get port 80 register.
Page 208: Return Codes
Return Codes lists the return codes for this command. TABLE H-41 Return Codes for Subcommand sp create test events TABLE H-41 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting options NWSE_InvalidUsage specified. Request was issued, but was not serviced by the server. NWSE_RPCTimeout RPC procedure timed out and the request may or may not have been serviced by the server.
Page 209: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-43 Return Codes for Subcommand sp get port80 TABLE H-43 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Not authorized to perform this operation. NWSE_NoPermission Insufficient memory.
Page 210 BIOS POST Codes TABLE H-44 POST Code Description Initialize PCI bus mastering devices Initialize keyboard controller BIOS ROM checksum Initialize cache before memory autosize 8254 programmable interrupt timer initialization 8237 DMA controller initialization Reset programmable interrupt controller Test DRAM refresh Test 8742 keyboard controller Set ES segment register to 4GB Enable gate A20 line...
Page 211 BIOS POST Codes TABLE H-44 POST Code Description Check video configuration against CMOS Initialize PCI bus and devices Initialize all video adapters in system QuietBoot start (optional) Shadow video BIOS ROM Display BIOS copyright notice Initialize MultiBoot Display CPU type and speed Initialize EISA board Test keyboard Set key click if enabled...
Page 212 BIOS POST Codes TABLE H-44 POST Code Description Check for keyboard errors Set up hardware interrupt vectors Initialize Intelligent System Monitoring Initialize coprocessor if present Disable onboard super I/O ports and IRQs Late POST device initialization Detect and install external RS232 ports Configure non-MCD IDE controllers Detect and install external parallel ports Initialize PC compatible PnP ISA devices...
Page 213 BIOS POST Codes TABLE H-44 POST Code Description Enable hardware interrupts Determine number of ATA and SCSI drives Set time of day Check key lock Initialize typematic rate Erase F2 prompt Scan for F2 key stroke Enter setup Clear boot flag Check for errors Inform RomPilot about the end of POST POST done - prepare to boot operating system...
Page 214: Boot Block Codes For Flash Rom
BIOS POST Codes TABLE H-44 POST Code Description Initialize notebook docking late Force check (optional) Extended checksum (optional) Redirect Int 15h to enable remote keyboard Redirect Int 13 to Memory Technologies Devices such as ROM, RAM, PCMCIA, and serial disk Redirect Int 10h to enable remote serial video Re-map I/O and memory for PCMCIA Initialize digitizer and display message...
Page 215: Sp Load Settings Subcommand
Boot Block Codes in Flash ROM TABLE H-45 Post Code Description Shadow Boot Block System memory test Initialize interrupt vectors Initialize Run Time Clock Initialize video Initialize System Management Manager Output one beep Clear Huge Segment Boot to mini DOS Boot to Full DOS SP Load Settings Subcommand Description: Configures an SP with the same configuration as that of another SP.
Page 216: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-47 Return Codes for Subcommand sp load settings TABLE H-47 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. One or more arguments were incorrect or invalid. NWSE_InvalidArgument Not authorized to perform this operation.
Page 217: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-49 Return Codes for Subcommand sp get status TABLE H-49 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 218 lists the arguments for this subcommand. TABLE H-50 Arguments for Subcommand sp get tdulog TABLE H-50 Argument Description Optional. The name of the output file to which the log files are {-f | --filename} copied, or the fully qualified path name. File names cannot contain the backward relative path reference (..) or the less than symbol (<).
Page 219: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-52 Return Codes for Subcommand sp get tdulog TABLE H-52 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Entity (user, service, file, path or other) was not NWSE_NotFound found.
Page 220: Return Codes
Return Codes lists the return codes for this command. TABLE H-54 Return Codes for Subcommand sp reboot TABLE H-54 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 221 lists the arguments for this command. TABLE H-55 Arguments for Subcommand sp reset TABLE H-55 Argument Description Resets all SP settings to their default configuration. {-a | --all} When the SP reboots, the settings are reset to their default values. Resets other system configuration settings to their default {-c | --config} configuration.
Page 222: Return Codes
Return Codes list the return codes for this command. TABLE H-56 Return Codes for Subcommand sp reset TABLE H-56 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting options NWSE_InvalidUsage specified. Request was issued, but was not serviced by the server. NWSE_RPCTimeout RPC procedure timed out and the request may or may not have been serviced by the server.
Page 223: Sp Mount Subcommands
SP Mount Subcommands The subcommands in manage the SP mount points. TABLE H-57 SP Mount Subcommands TABLE H-57 Subcommand Description Creates or resets a mount point. sp add mount Deletes the specified mount point. sp delete mount Displays the current mount points on the SP. sp get mounts SP Add Mount Subcommand Description: Creates or resets a mount point.
Page 224: Return Codes
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 required formats for remote NFS and SMB mounts are as follows: For NFS: server_name:server_exported_mountpoint For SMB: //server_name/windows_share_name Return Codes...
Page 225: Sp Delete Mount
SP Delete Mount Description: Deletes a mount point. Format Command format: sp delete mount LOCAL_MOUNT_POINT [-q | --quiet] lists the arguments for this subcommand. TABLE H-60 Arguments for Subcommand sp delete mount TABLE H-60 Argument Description Specifies the mount point to remove. If you do not specify the LOCAL MOUNT POINT local mount point, /mnt is implicit as the default value.
Page 226: Sp Get Mount Subcommand
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>}] lists the arguments for this subcommand. TABLE H-62 Arguments for Subcommand sp get mount TABLE H-62 Arguments Description...
Page 227: Sp Smtp Subcommands
Return Codes for Subcommand sp get mount TABLE H-63 Return Code Description No route to host (network down). NWSE_NoRouteToHost Host is down. NWSE_HostDown File system is not mounted. NWSE_NotMounted SP SMTP Subcommands The subcommands in manage SMTP communications. TABLE H-64 SP SMTP Subcommands TABLE H-64 Subcommand...
Page 228: Return Codes
lists the arguments for this subcommand. TABLE H-65 Arguments for Subcommand sp get smtp server TABLE H-65 Argument Description Suppresses column headings. { -H | --noheader } Delimits columns with the specified delimiter. Headings are { -D | --delim } also delimited unless suppressed.
Page 229: Sp Set Smtp Server Subcommand
SP Set SMTP Server Subcommand Description: Configures 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 lists the arguments for this subcommand.
Page 230: Sp Get Smtp Subscribers Subcommand
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>}] lists the arguments for this subcommand. TABLE H-69 lists the default SMTP subscribers.
Page 231: Return Codes
Return Codes lists the return codes for this subcommand. TABLE H-71 Return Codes for Subcommand sp get smtp subscribers TABLE H-71 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 232 Note – All options replace the existing values with the new value. Unspecified options leave existing settings as they are. For example, if you only specify the -r option for an existing subscriber, the existing email address list is replaced with the new list specified in the command.
Page 233: Return Codes
Return Codes lists the return codes for this command. TABLE H-74 Return Codes for Subcommand sp update smtp subscriber TABLE H-74 Return Code Description Command successfully completed. NWSE_Success Invalid usage: bad parameter usage, conflicting NWSE_InvalidUsage options specified. Request was issued, but was not serviced by the NWSE_RPCTimeout server.
Page 234: Sp Snmp Subcommands
SP SNMP Subcommands The subcommands in manage SNMP communications. TABLE H-75 SP SNMP Subcommands TABLE H-75 Subcommand Description sp add snmp destination Adds an SNMP destination. sp delete snmp destination Deletes the SNMP destination. sp get snmp destinations Displays the available SNMP destinations (IP address or hostname) to which the Service Processor is configured to send.
Page 235: Return Codes
lists the argument for this subcommand. TABLE H-76 Argument for Subcommand sp add snmp-destination TABLE H-76 Arguments Description Specifies the IP address or name of the host for the destination IP ADDRESS/HOSTNAME you wish to add. This argument is repeatable to add multiple destinations at one time;...
Page 236: Sp Delete Snmp Destination Subcommand
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] lists the arguments for this subcommand. TABLE H-78 Arguments for Subcommand sp delete snmp-destination TABLE H-78 Arguments...
Page 237: Sp Get Snmp Destinations Subcommand
Return Codes for Subcommand sp delete snmp-destination TABLE H-79 Return Code Description RPC connection refused. NWSE_RPCConnRefused Miscellaneous error not captured by other errors. NWSE_UnknownError File open, file missing, or a read or write error NWSE_FileError occurred. SP Get SNMP Destinations Subcommand Description: Displays the available SNMP destinations (IP address or host name) to which the SP is configured to send.
Page 238: Sp Get Snmp Proxy Community Subcommand
SP Get SNMP Proxy 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 lists the return codes for this subcommand. TABLE H-81 Return Codes for Subcommand sp get snmp proxy community TABLE H-81 Return Code...
Page 239: Return Codes
lists the argument for this subcommand. TABLE H-82 Argument for Subcommand sp set snmp proxy community TABLE H-82 Argument Description Specifies the name of the community to configure. COMMUNITY STRING There are no restrictions on the length of the community strings; common names are private and public.
Page 240: Sp Ssl Subcommands
SP SSL Subcommands The subcommands in manage SSL capabilities. TABLE H-84 SP SSL Subcommands TABLE H-84 Subcommand Description Disables forced use of the secure HTTP (https) protocol. sp disable ssl-required Enables forced use of the secure HTTP (https) protocol. sp enable ssl-required Determines if the Apache Web server is using sp get ssl factory-supplied files or user-supplied files.
Page 241: Sp Enable Ssl-Required Subcommand
Return Codes for Subcommand sp disable ssl-required TABLE H-85 Return Code Description Insufficient memory. NWSE_NoMemory File open, file missing, or a read or write error NWSE_FileError occurred. Requested service is not available. NWSE_ServiceNotAvailable SP Enable SSL-Required Subcommand Description: Enables automatic redirect to secure HTTP URLs. With SSL enabled, HTTP requests are automatically redirected to equivalent HTTPS requests to maintain site security.
Page 242: Sp Get Ssl Subcommand
SP Get SSL Subcommand Description: Determines if automatic redirect to secure HTTP is required or optional, and whether Apache Web Server is using factory or user-supplied SSL certificate files. Format Command format: sp get ssl [{-H | noheader}] [{-D | --delim <DELIMITER>}] lists the arguments for this subcommand.
Page 243: Sp Set Ssl Subcommand
SP Set SSL Subcommand Description: Allows you to use site SSL certificates in the Service Processor environment. This command allows you to replace the Server Certificate in the SP Value-Add image with your own internally-generated certificate and to restore the factory settings.
Page 244: Sp Update Subcommands
SP Update Subcommands The subcommands in manage the SP flash. TABLE H-91 SP Flash Subcommands TABLE H-91 Subcommand Description Sets the update flag to start the full flash update on the sp update flash all next reset of the SP. Copies the file Value-Add to the Value-Add sp update flash applications component of the SP flash.
Page 245: Return Codes
lists the arguments for this subcommand. TABLE H-92 Arguments for Subcommand sp update flash all TABLE H-92 Argument Description The IP address of the remote server on which the Java spUpdate {-i | --serverip} program is running. Optional: The port number on the remote server on which the Java {-p | --port} spUpdate program is listening for SP flash update requests.
Page 246: Sp Update Flash Applications Subcommand
SP Update Flash Applications Subcommand Description: The SP file system is divided into two componenets: Base and Value-Add. The Base component includes the repository and the Value-Add component includes the application software. This command copies the file Value-Add to the Value-Add component of the SP flash.
Page 247: Sp Update Flash Pic Subcommand
SP Update Flash PIC Subcommand Description: This command updates the PIC firmware to a newer version. An input PIC-update image file is provided. Format Command format: sp update flash pic {-f | --filename} FULL PATH OF THE FILE | [{-v | --version}] lists the arguments for this subcommand.
Page 248: Sp Update Diags Subcommand
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 file system is required to enable several features, including diagnostics. The SP software uses a default version of diagnostics. However, if a new version is released and stored on the Network Share Volume, you must explicitly point to that new version to use it.
Page 249 Index access commands base component of SP, updating 23 add public key 96 baseboard management controller, IPMI 28 add trust 91 BIOS POST codes table 187 add user 100 BIOS settings for console redirection 67 delete public keys 98 BMC, see baseboard management controller delete trust 93 boot block codes for flash ROM 192 delete user 101...
Page 250 diagram of server management options 5 subcommand summary table 117 diags commands IP address, DHCP setting 9 cancel tests 108 IP address, static setting 11 get state 110 IPMI access get tests 111 enabling 14 run tests 112 in-band enabling on Linux server 14 start 114 in-band enabling on Solaris x86 server 16 subcommands summary table 107...
Page 251 LILO, using for console redirection 65 POST codes table 187 logging in with setup account 13 propagating SP settings 24 LOM, see lights out management public keys for scripting 58 MAC addresses, determining 25 related documentation xx management information base (MIB) for SNMP 42 return codes summary table 76 MIB browser 47 MIB tree diagram 42...
Page 252 updating SP software 21 get smtp subscribers 208 get snmp proxy community 216 service processor commands, see sp commands get snmp-destinations 215 setup account, logging in 13 get ssl 220 shell scripts, using 55 get status 194 simple network management protocol, see SNMP get tdulog 195 interface hostname subcommand summary table 171...
Page 253 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 updating service processor software 21 updating SP base component 23 user groups, defined 8 user types, defined 8 Index...
Page 254 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004...

This manual is also suitable for:

Sun fire v40z

Sun Microsystems Sun Fire V20z Management Manual

Preface

1 Introduction

2 IPMI Server Management

3 SNMP Server Management

4 Further Management Information

Server Management Commands Summary

Access Commands

Diagnostics Commands

Inventory Commands

IPMI Commands

Platform Commands

Sensor Commands

Service Processor Commands

Quick Links

Troubleshooting

Need help?

Questions and answers

Related Manuals for Sun Microsystems Sun Fire V20z

Summary of Contents for Sun Microsystems Sun Fire V20z