Sun Microsystems Sun Fire V20z Management Manual
  1. Manuals
  2. Brands
  3. Sun Microsystems Manuals
  4. Server
  5. Sun Fire V20z
  6. Management manual
Sun Microsystems Sun Fire V20z Management Manual

Sun Microsystems Sun Fire V20z Management Manual

Hide thumbs Also See for Sun Fire V20z:
Table of Contents

Advertisement

Quick Links

Download this manual See also: User Manual, Management Manual
Sun Fire™ V20z Server—
Server Management Guide
Sun Microsystems, Inc.
www.sun.com
Part No. 817-5249-10
817-5249-10, Revision A
Submit comments about this document at: http://www.sun.com/hwdocs/feedback

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Sun Fire V20z and is the answer not in the manual?

Questions and answers

Related Manuals for Sun Microsystems Sun Fire V20z

Summary of Contents for Sun Microsystems Sun Fire V20z

  • Page 1 Sun Fire™ V20z Server— Server Management Guide Sun Microsystems, Inc. www.sun.com Part No. 817-5249-10 817-5249-10, 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: Preface

    Intelligent (IPMI). See “IPMI Server Management” on page 19. Platform Management Interface Chapter 3 describes how to manage the Sun Fire V20z server through the Simple Network Management Protocol (SNMP). See “SNMP Server Management” on page 33. Chapter 4 describes the Sun Control Station (SCS) software. See “Sun Control Station”...

  • Page 4: Using Unix Commands

    Installation Guide Service Sun Fire V20z Server User Guide 817-5248-xx Accessing Sun Documentation You can view, print, or purchase a broad selection of Sun documentation, including localized versions, at: http://www.sun.com/documentation iv Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 5: Third-Party Web Sites

    Sun is interested in improving its documentation and welcomes your comments and suggestions. You can submit your comments by going to: http://www.sun.com/hwdocs/feedback Please include the title and part number of your document with your feedback: Sun Fire V20z Server—Server Management Guide, part number 817-5249-10 Preface...
  • Page 6 Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 7: Table Of Contents

    Contents Preface iii How This Book Is Organized iii Using UNIX Commands iv Related Documentation Accessing Sun Documentation iv Third-Party Web Sites v Contacting Sun Technical Support v Sun Welcomes Your Comments v Introduction 1 Overview 1 Acronyms 2 Server Management 3 Service Processor Server-Management Interfaces SNMP Integration...
  • Page 8 Updating the Service Processor Base Component 16 Autoconfiguring the SP 17 IPMI Server Management 19 Base Management Controller Manageability 20 IPMI Compliance and Channel Access on the Sun Fire V20z server Usernames and Passwords Lights Out Management (LOM) 22 Description 22 Further Information 22...
  • Page 9 SNMP Management Information Base (MIB) Sun Fire V20z Server MIB Tree 35 Integrating MIBs with Third-Party Consoles 35 Configuring SNMP on Your Sun Fire V20z Server 36 SNMP Agent on the Service Processor Proxy Agent 37 Setting the Community Name 38...
  • Page 10 Return Codes 65 Platform Get OS State Subcommand 66 Return Codes 67 Platform Set OS State Subcommand 67 Return Codes 68 SP Commands 69 SP Update Diags Subcommand 69 Return Codes 70 Sun Fire V20z Server—Server Management Guide • March 2004...
  • Page 11 SP Delete Event Subcommand 70 Return Codes 71 SP Get Events Subcommand 71 Return Codes 72 SP Get JNET Subcommand 73 Return Codes 73 SP Set JNET Subcommand 74 Return Codes 75 SP Get Locatelight Subcommand 75 Return Codes 75 SP Set Locatelight Subcommand 76 Return Codes 76 SP Add Mount Subcommand 77...
  • Page 12 SP Set SNMP Proxy Community Subcommand 86 Return Codes 86 SP Get TDULog Subcommand 87 Return Codes 88 SP Update Flash All Subcommand 89 Return Codes 89 Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 13: Introduction

    The Sun Fire™ V20z server and its extensive server-management capabilities lower costs by reducing failure and potentially eliminating hands-on management. This document describes how to perform remote management on the Sun Fire V20z server. The Sun Fire V20z server is an AMD Opteron processor-based, enterprise-class one-rack-unit (1U), two-processor (2P) server.

  • Page 14: Acronyms

    Sensor Data Record System Event Log SNMP Simple Network Management Protocol Serial Over LAN Service Processor System Setup Utility SunMC Sun Management Center UART Universal Asynchronous Receiver/Transmitter User Datagram Protocol Wide Area Network Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 15: Server Management

    Note – In this document, you might see references to a Baseboard Management Controller (BMC). A BMC is a dedicated IPMI controller. The SP found in the Sun Fire V20z server is a general-purpose, embedded CPU that contains software to emulate a BMC.

  • Page 16: Snmp Integration

    See Appendix A for a list of server-management commands that you can use with the Sun Fire V20z server, as well as a description, the command format, a list of arguments and a list of return codes for each command.
  • Page 17 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 Sun Fire V20z Server In-band Out-of-band Platform agent (In-band) SNMP agent IPMI management through IPMItool Service...

  • Page 18: Operator Panel

    Note – The SP defaults to Dynamic Host Configuration Protocol (DHCP) networking if the operator panel is not interactively engaged on the first power-up. Note – For more information about the operator panel, refer to the Sun Fire V20z Server User Guide, 817-5248-xx.
  • Page 19 The operator panel displays information on the LCD 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 20: Initial Setup Of The Service Processor

    It does not matter which port you use. The unused port can be used to daisy-chain a number of Sun Fire V20z servers to a management console. 2. If a DHCP server services the LAN, turn on the main server power switch (on the rear panel) and observe the IP address of the SP on the LCD.

  • Page 21: Part Ii: Secure The Service Processor

    2. Install the custom openIPMI Linux kernel driver from the Documentation and Support Files CD-ROM located in the directory /support/sysmgmt/. Browse to the OS variant installed on your Sun Fire V20z server. The options are: redhat/rhel3 for Red Hat Enterprise Linux, version 3 (32-bit mode uses the architecture type “i386”;...
  • Page 22 -ivh /tmp/kernel-source*.rpm 4. Install the openIPMI Linux kernel driver RPM. a. Browse to the OS variant installed on your Sun Fire V20z server. The options are: redhat/rhel3 for Red Hat Enterprise Linux, version 3 (32-bit mode uses the architecture type “i386”;...

  • Page 23: Part Iv-A: Enabling Ipmi Lan Access On A Linux-Based Server (In-Band)

    6. Test the IPMI kernel device driver and client application by running the following command: ipmitool -I open chassis status Successful output should look something like the following: " System Power: on Power Overload: false Power Interlock: inactive Main Power Fault: false Power Control Fault: false Power Restore Policy: unknown Last Power Event:...

  • Page 24: Part Iv-B: Alternate Method For Enabling Ipmi Lan Access (Out-Of-Band)

    1. Install the kernel-source RPM that matches the version of the upgraded kernel binary RPM package 2. Log in to the server and authenticate as the user root. 3. Change to the following directory: cd /usr/src/kernel-modules/openipmi Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 25: Daisy-Chaining The Sun Fire V20Z Servers

    Both external management Ethernet ports connect to the internal switch. The unused management Ethernet port can be used to daisy-chain to one of the platform Gigabit Ethernet ports or, through a crossover Ethernet cable, can be connected to another Sun Fire V20z server. Chapter 1 Introduction...

  • Page 26: Site Integration

    Site Integration When deploying your Sun Fire V20z server, ensure that you determine the best integration strategy for your environment. The Sun Fire V20z server includes 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,...
  • Page 27 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 28: Updating The Service Processor Base Component

    Refer to Appendix A for more information about the sp commands. 4. Monitor progress of the update process on the server. Messages display as the installation process progresses. When complete, the SP reboots with the new version installed. Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 29: Autoconfiguring The Sp

    SP Auto Setup? For instructions on setting an IP address, refer to the section “Defining SP Network Settings” in the Sun Fire V20z Server Installation Guide, 817-5246-xx. 2. Press the Select button. The SP attempts to locate an IP address.
  • Page 30 3. Wait until the autoconfiguration is complete, at which point the SP automatically reboots. Th following message displays when autoconfiguration is running. SP AutoConfigure in progress Note – If the autoconfiguration is unsuccessful, a failure message displays. Press any button to clear it. Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 31: 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 32: Base Management Controller

    BMC through one of three defined interfaces which are based on a set of registers shared between the platform and the BMC. Note – In the Sun Fire V20z server, the Service Processor (SP) has software that emulates a BMC.

  • Page 33: Ipmi Compliance And Channel Access On The Sun Fire V20Z Server

    IPMI Compliance and Channel Access on the Sun Fire V20z server The Sun Fire V20z server supports IPMI through the SP software version 2.0 and later. The Sun Fire V20z server meets compliance standards for IPMI version 1.5. The IPMI implementation on the Sun Fire V20z server also supports LAN channel access.

  • Page 34: Lights Out Management (Lom)

    Lights Out Management (LOM) On the Sun Fire V20z server, 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...

  • Page 35: 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 36: Expressions

    Note – The sol command is not supported in the Sun Fire V20z server, but you can enable a Serial-over-LAN feature. See “Serial Over LAN” on page 54. Expressions and Parameters for IPMItool (1 of 4)
  • Page 37 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 38 Controls the front panel identification light. The default value is 15 seconds. Enter “0” to turn it off. Note: At the time of the Sun Fire V20z server’s release, IPMItool did not support the chassis identify command. You can use the following commands: To enable the locate light: ssh -l <spuser>...
  • Page 39 Expressions and Parameters for IPMItool (4 of 4) TABLE 2-2 Expression Parameter Sub-parameter Description and examples password <pass> Sets the null user password. user Enables the user-access mode. access <on|off> Sets the LAN-channel-access mode. ipsrc <source> Sets the IP address source. As a source, you can indicate: none = unspecified static = manually configured static IP address dhcp = address obtained by BMC running DHCP...

  • Page 40: Ipmi Linux Kernel Device Driver

    To install and compile this kernel device driver, see “Initial Setup of the Service Processor” on page 8. LAN Interface for the BMC Note – In the Sun Fire V20z server, the Service Processor (SP) has software that emulates a BMC. The IPMItool LAN interface communicates with the BMC over an Ethernet LAN connection using User Datagram Protocol (UDP) under IPv4.

  • Page 41: 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.

  • Page 42: Viewing The System Event Log

    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 – To receive more verbose logging messages, you can run the following command: ssh -l <spuser> <spipaddr> sp get events Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 43: 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. IPMItool over LAN. You cannot authenticate to the Ensure that you are using the password assigned management controller using...
  • Page 44 Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 45: Snmp Server Management

    HP OpenView and CA Unicenter. The base component of an SNMP solution is the Management Information Base (MIB). The MIB is included on the Sun Fire V20z server Network Share Volume (NSV) CD-ROM. This configuration is beneficial when, for example, you have a cluster of machines serving Web content and the platform is connected to the Internet, but the SP is protected and only accessible on an internal network.

  • Page 46: Snmp Integration

    SNMP Management Information Base (MIB) The Management Information Base (MIB) is a text file that describes SNMP data as managed objects. The Sun Fire V20z server provides SNMP MIBs so that you can use any SNMP-capable network management system, such as HP OpenView Network Node Manager (NNM), Tivoli, CA Unicenter, IBM Director and so on, to manage and monitor your Sun Fire V20z server.

  • Page 47: Sun Fire V20Z Server Mib Tree

    FIGURE 3-1 Integrating MIBs with Third-Party Consoles You use the Sun Fire V20z server MIBs to integrate the management and monitoring of Sun Fire V20z server into SNMP management consoles. The Sun Fire V20z server MIB branch is a private enterprise MIB, located at object identifier (OID) 1.3.6.1.2.1.9237.

  • Page 48: Configuring Snmp On Your Sun Fire V20Z Server

    Proxy forwarder application/ProxyAgent [RFC 2271] Agent X [RFC 2741] The following diagram illustrates the SNMP architecture and communication paths between the SP and the platform. SNMP Architecture and Communications FIGURE 3-2 Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 49: Snmp Agent On The Service Processor

    Refer to the procedure for using the SNMP agent on the SP, as explained in “Integrating MIBs with Third-Party Consoles” on page 35. Note – The SNMP agent on the Sun Fire V20z server supports SNMP v1/v2c. For security reasons, there are no settable attributes in this agent.

  • Page 50: 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 Sun Fire V20z Server” on page 36.) 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 51: Using A Third-Party Mib Browser

    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 Sun Fire V20z server MIBs are placed and click Open. 5. Repeat steps 2 through 4 to load other MIBS (for example, SP-SST-MIB.mib, SP-INVENTORY-MIB.mib, SP-EVENT-MIB.mib, SP-PLATFORM-MIB.mib,...

  • Page 52: 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. The Sun Fire V20z server uses traps to signal conditions related to the server’s health, including critical conditions related to...

  • Page 53: 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 54: Sun Fire V20Z Server Mib Details

    Sun Fire V20z Server MIB Details SNMP uses object identifiers (OIDs) to provide name variables by which objects are grouped together for easier reference. The Sun Fire V20z server provides agents for the MIBs shown in TABLE 3-3 SNMP MIBs...
  • Page 55 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 56 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 Server—Server Management Guide • March 2004...

  • Page 57: Sun Control Station

    A Sun-branded product, the Sun Control Station (SCS) is a server-management solution for the Sun Fire V20z server. Note – At the time of the Sun Fire V20z server’s release, the Sun Control Station software did not support the Sun Fire V20z server. Support will be available through future releases of SCS.

  • Page 58: Services On The Sun Control Station

    The server-side component consists of two parts: a core framework that is the engine for executing control modules, and the built-in control modules themselves. These control modules can come from Sun Microsystems, Inc., from third-party vendors or from your own in-house design team. Numerous modules are available from Sun:...
  • Page 59 AllStart provides a common user interface for creating software payloads, defining client profiles, and monitoring and validating system installations and updates. This module allows you to: Select files or RPMs to load onto a client Select the distributions of different OSs to load onto a client Create customized payloads made up of files and OS distributions Create profiles containing configuration information Add clients on to which the payloads and profiles are loaded (using the Media...
  • Page 60 Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 61: Further Management Information

    C H A P T E R Further Management Information 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 Sun Fire™ V20z server or render the server unbootable if you introduce a problem in the configuration files.

  • Page 62: Grub

    Previous and Next entry, respectively. Pressing Enter then boots that entry. The parameter console=ttyS1 tells the system to send the data to the serial port first. The parameter console=tty0 tells the system to send the data to the KVM second. Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 63: Lilo

    A working-image section in your file /etc/grub.conf should have an entry for the kernel image to boot. The stock kernel entry looks like: kernel /vmlinuz-< kernelrevision > ro root=/dev/sda5 where is simply the kernel version that you are using. < kernelrevision > You need to change the stock kernel entry of your image to include the console-kernel parameters, as follows: kernel /vmlinuz-<...

  • Page 64: Getty

    1:2345:respawn:/sbin/mingetty tty1 2:2345:respawn:/sbin/mingetty tty2 3:2345:respawn:/sbin/mingetty tty3 4:2345:respawn:/sbin/mingetty tty4 5:2345:respawn:/sbin/mingetty tty5 6:2345:respawn:/sbin/mingetty tty6 securetty To add the serial-console device /dev/ttyS1 to the file /etc/securetty, run the following command: echo ttyS1 >> /etc/securetty Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 65: Enabling And Configuring Bios Console Redirection

    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 Sun Fire V20z server. 2. When prompted, press <F2> to enter BIOS setup. 3. Select the Advanced menu from the category selections along the top.

  • Page 66: Network Share Volume (Nsv) Cd-Rom

    Network Share Volume (NSV) CD-ROM A network share volume (NSV) structure is included with the Sun Fire V20z server on CD-ROM. 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, the troubleshooting dump utility and online help.

  • Page 67: Enabling Or Disabling The Sol Feature On The Server

    Enabling or Disabling the SOL Feature on the Server Note – When the SOL feature is enabled, you cannot access the Sun Fire V20z server through the external DB9 serial port (COM A). Note – The variable spuser is the user account created when securing the SP. The variable spipaddr is the IP address assigned to the SP.

  • Page 68: Launching An Sol Session

    To terminate an SOL session: 1. Press Control-e. 2. Press ‘c’. 3. Press ‘.’. You can also terminate an SOL session by terminating the ssh session: 1. Press the tilde key (~). 2. Press ‘.’. Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 69: Commands

    A P P E N D I X Commands This appendix describes the commands and subcommands mentioned in the Sun Fire™ V20z Server Installation Guide (817-5246-xx), the Sun Fire V20z Server User Guide (817-5246-xx) and this server management guide. Using the ssh Protocol You must use ssh to execute these commands on the Server Processor (SP).

  • Page 70: Preface Text

    Clears an existing event using the event ID. sp delete event Returns detailed information about all active SP events. sp get events Retrieves the JNET address. sp get jnet Sun Fire V20z Server—Server Management Guide • March 2004...
  • Page 71 Subcommands in Appendix A TABLE A-1 Subcommand Description Sets the JNET address. sp set jnet 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. sp set locatelight Creates or resets a mountpoint.

  • Page 72: Ipmi Commands

    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. NWSE_NoPermission Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 73: Ipmi Enable Channel Subcommand

    IPMI Enable Channel Subcommand Description: Allows you to enable one of two IPMI channels. Command format: ipmi enable channel {sms | lan} lists the arguments for this subcommand. TABLE A-4 Arguments for Subcommand ipmi enable channel TABLE A-4 Arguments Description The ID of the channel to enable for the System Interface;...

  • Page 74: Platform Commands

    The delimiter can be any character or string. The following output displays when successful: Rear Panel Enabled Speed Pruning Log Trigger SP Console 115200 1024KB Platform COMA 19200 64KB Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 75: Return Codes

    One of the other lines of data displays depending on whether the rear-panel serial port is connected to the platform or to the SP. describes the headings for TABLE A-7 the output columns. Headings for the Output Columns TABLE A-7 Heading Description Displays No if the external serial port is connected to the platform.

  • Page 76: Platform Set Console Subcommand

    Indicates that the platform console monitor is active. Cannot be {-e | --enable} used with: -d. Select the trigger size in KB for console-log rotation. {-l | --log}size The acceptable values for log size are between 64 and 1024 inclusive. Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 77: Return Codes

    Arguments for Subcommand platform set console TABLE A-9 Arguments Description Indicates that the platform console log should be the raw console {-n | --noprune} data. Cannot be used with: -p. Indicates that the platform console log is to be cleaned of ANSI {-p | --prune} sequences and pruned of duplicated information.

  • Page 78: Platform Get Os State Subcommand

    For more information about setting the state, refer to “Platform Set OS State Subcommand” on page 67. Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 79: Return Codes

    Return Codes lists the return codes for this subcommand. TABLE A-11 Return Codes for Subcommand platform get os state TABLE A-11 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 80: Return Codes

    RPC procedure timed out and the request may or may not have been serviced by the server. Unable to connect to the RPC server. NWSE_RPCNotConnected Not authorized to perform this operation. NWSE_NoPermission Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 81: Sp Commands

    Return Codes for Subcommand platform set os state TABLE A-13 Return Code Description Device or resource is busy. NWSE_Busy File open, missing, or read or write error occurred. NWSE_FileError Invalid operation for current state. NWSE_InvalidOpForSta SP Commands The sp command gets or sets the configuration values for the SP, and generates or manages events and notices.

  • Page 82: Return Codes

    Removes all events. [-a | --all] If the event to delete is not found, this argument specifies that no [-q | --quiet] error be returned. Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 83: Return Codes

    Return Codes lists the return codes for this subcommand. TABLE A-17 Return Codes for Subcommand sp delete event TABLE A-17 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 84: Return Codes

    Unable to connect to the RPC server. NWSE_RPCNotConnected One or more arguments were incorrect or invalid. NWSE_InvalidArgument Entity (user, service, file, path and so on) not found. NWSE_NotFound Insufficient memory. NWSE_NoMemory Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 85: Sp Get Jnet Subcommand

    SP Get JNET Subcommand Description: Retrieves the IP address of the platform JNET driver. Command format: [{-D | --delim <DELIMITER> }] sp get jnet [{-H | --noheader}] lists the arguments for this subcommand. TABLE A-20 Arguments for Subcommand sp get jnet TABLE A-20 Argument Description...

  • Page 86: Sp Set Jnet Subcommand

    JNET connection. Otherwise the connection will be out-of-sync (one address will be modified and one will be re-set to the default address.) Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 87: Return Codes

    Return Codes lists the return codes for this subcommand. TABLE A-23 Return Codes for Subcommand sp set jnet TABLE A-23 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 88: Sp Set Locatelight Subcommand

    RPC procedure timed out and the request may or may not have been serviced by the server. Unable to connect to the RPC server. NWSE_RPCNotConnected Not authorized to perform this operation. NWSE_NoPermission Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 89: Sp Add Mount Subcommand

    SP Add Mount Subcommand Description: Creates or resets a mountpoint. Command format: sp add mount [{-l | --local} MOUNTPOINT ] {-r | --remote} SERVER:FILESYSTEM [{-u|--user} USER] [{-p|--password} PASSWORD ] lists the arguments for this subcommand. TABLE A-26 Arguments for Subcommand sp add mount TABLE A-26 Argument Description...

  • Page 90: Sp Delete Mount

    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. NWSE_NoPermission Insufficient memory. NWSE_NoMemory Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 91: Sp Get Mount Subcommand

    Return Codes for Subcommand sp delete mount TABLE A-29 Return Code Description Device or resource is busy. NWSE_Busy RPC client already connected. NWSE_RPCConnected RPC connection refused. NWSE_RPCConnRefused No route to host (network down). NWSE_NoRouteToHost Host is down. NWSE_HostDown Miscellaneous error not captured by other errors. NWSE_UnknownError SP Get Mount Subcommand Description: Displays the current mount points on the SP.

  • Page 92: Return Codes

    Device or resource is busy. NWSE_Busy RPC client already connected. NWSE_RPCConnected RPC connection refused. NWSE_RPCConnRefused No route to host (network down). NWSE_NoRouteToHost Host is down. NWSE_HostDown File system is not mounted. NWSE_NotMounted Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 93: Sp Get Port 80 Subcommand

    You can also retrieve the last ten Port 80 post codes using the operator panel. For more details about using the operator-panel menus or for a complete list of the BIOS Power On Self Test (POST) codes, refer to the Sun Fire V20z Server User Guide (817-5248-xx).

  • Page 94: Sp Add Snmp Destination Subcommand

    Insufficient memory. NWSE_NoMemory RPC connection refused. NWSE_RPCConnRefused Miscellaneous error not captured by other errors. NWSE_UnknownError File open, missing, or read or write error occurred. NWSE_FileError Entity (user, service, etc.) already exists. NWSE_Exist Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 95: Sp Delete Snmp Destination Subcommand

    SP Delete SNMP Destination Subcommand Description: Deletes a single SNMP destination (either IP address or host name) Command format: sp delete snmp-destination IP ADDRESS/HOSTNAME [-a | --all] [-q | --quiet] lists the arguments for this subcommand. TABLE A-36 Arguments for Subcommand sp delete snmp-destination TABLE A-36 Arguments Description...

  • Page 96: Sp Get Snmp Destinations Subcommand

    Unable to connect to the RPC server. NWSE_RPCNotConnected Insufficient memory. NWSE_NoMemory Miscellaneous error not captured by other errors. NWSE_UnknownError File open, missing, or read or write error occurred. NWSE_FileError Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 97: Sp Get Snmp Proxy Community Subcommand

    SP Get SNMP Proxy Community Subcommand Description: Returns the community name the Service Processor is currently using to proxy the platform SNMP agent. Command format: sp get snmp proxy community COMMUNITY_STRING lists the argument for this subcommand. TABLE A-39 Argument for Subcommand sp get snmp proxy community TABLE A-39 Argument Description...

  • Page 98: Sp Set Snmp Proxy Community Subcommand

    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. Unable to connect to the RPC server. NWSE_RPCNotConnected Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 99: Sp Get Tdulog Subcommand

    SP Get TDULog Subcommand Description: The Troubleshooting Dump Utility (TDU) captures debug data. When you execute this command, this data is gathered and stored on the SP in a compressed tar file. Command format: sp get tdulog [{-f | --filename} FILENAME or STDOUT [{-c | --cpuregs} CPU REGISTERS] [{-p | --pciregs} PCI REGISTERS] [{-r | --reset} RESET PLATFORM]...
  • Page 100 NWSE_MissingArgument Miscellaneous error not captured by other errors. NWSE_UnknownError File open, missing, or read or write error occurred. NWSE_FileError File system is not mounted. NWSE_NotMounted Requested service is not available. NWSE_ServiceNotAvailable Sun Fire V20z Server—Server Management Guide • March 2004...

  • Page 101: Sp Update Flash All Subcommand

    SP Update Flash All Subcommand Description: Checks the server availability and sets environment variables for the update sp flash image components from PPCBOOT. After verifying that the update server is running, the command sets the update flag to start the full flash update at the next SP reset.
  • Page 102 Sun Fire V20z Server—Server Management Guide • March 2004...

Table of Contents