Further Management Information

C H A P T E R 4

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.

Note – You must create a valid initial manager account before using SSH. The SP includes a setup account that can be used to set up an initial manager account. This initial manager user can create additional users.

The SP includes a suite of commands that enables management and monitoring of the server; this suite of commands is referred to as server management commands. From the command line, for instance, you can write data driven scripts that automate configuration of multiple machines.

The Sun Fire V20z and Sun Fire V40z Servers Network Share Volume CD contains sample scripts for getting started, which you can access after you extract the files on the CD. See “Network Share Volume (NSV) CD-ROM” on page 68 for more information about the script locations.

Page 77

Image 77

Sun Microsystems V40z, V20Z manual Further Management Information, Configuring Scripting Capabilities

Contents

Sun Microsystems, Inc Please Recycle Contents Ipmi Server Management Further Management Information Configuring Scripting Capabilities Using Shell ScriptsSnmp Server Management Lilo Server Management Commands Summary Access Commands Commands Return CodesPage Diagnostics Commands Inventory Compare Versions Subcommand Inventory CommandsIpmi Commands Format Return Codes Platform Commands Service Processor Commands 161 Sensor Commands Contents Page Contents Page Contents Page How This Book Is Organized Preface Related Documentation Third-Party Web Sites Accessing Sun DocumentationContacting Sun Technical Support Sun Welcomes Your CommentsPage Overview Introduction Acronyms Acronyms1defines the acronyms found in this document Server-Management Interfaces Service ProcessorServer Management Snmp Integration Command Line Interface Server 2Sun Fire V20z Server Operator Panel and Buttons Operator Panel 2Operator Panel Buttons User Types User Groups Assigning SP Network Settings Using Dhcp Initial Setup of the Service ProcessorPart I Assigning Network Settings to the SP Press the Forward button until you reach the SP menu Following prompt appears with the default responsePress the Select button to display the SP menu options Press the Select button This field can hold a value between 0 Assigning Static SP Network Settings LCD displays the following confirmation prompt SP address is now configured and the server is ready for use Creating the Initial Manager Account Part II Securing the Service Processor Enabling Ipmi Access on a Linux-Based Server In-Band Enabling Ipmi Access on the Server Successful output should look similar to the following Install the openIPMI RPM file by running the commandInstall IPMItool Reboot the server Enabling Ipmi Access on a Solaris-Based x86 Server In-BandConfirm installation of all packages when prompted Using IPMItool, configure the network setting for the SP Enabling Ipmi LAN AccessEnabling Ipmi LAN Access on a Linux-Based Server In-Band Using IPMItool, test the Ipmi LAN access Alternate Method for Enabling Ipmi LAN Access Out-of- BandEnable Ipmi LAN access and assign a password when prompted Upgrading the Linux Kernel Recompile the module by running the following commands 5Daisy Chain Architecture Daisy-Chaining the Servers LCD displays the first menu option Site IntegrationUpdating the SP Software Press Select or Enter to display the SP menu’s options To update the SP base component Updating the Service Processor Base ComponentLog in to the SP by running the following command Run the sp command to start the update process on the SP Autoconfiguring the SP Optional Method Determining SP and Platform Network MAC Addresses Following message displays when autoconfiguration is runningPage Ipmi Server Management Manageability Baseboard Management Controller Usernames and Passwords Ipmi Compliance and LAN Channel Access Description Lights Out Management LOMFurther Information Syntax 1Options for IPMItool Options1lists the options available for IPMItool 2Expressions and Parameters for IPMItool 1 Expressions Interval 2Expressions and Parameters for IPMItool 2 Parameter 2Expressions and Parameters for IPMItool 3 Type 2Expressions and Parameters for IPMItool 4 LAN Interface for the BMC Ipmi Linux Kernel Device Driver Result returned is Files Clearing the Ipmi System Event Log Viewing the Ipmi System Event Log 3IPMI Troubleshooting Ipmi TroubleshootingPage Simple Network Management Protocol Snmp Server Management Snmp Management Information Base MIB Snmp Integration Integrating MIBs with Third-Party Consoles Sun Fire V20z and Sun Fire V40z Servers MIB Tree 2SNMP Architecture and Communications Configuring Snmp on Your Server Proxy Agent Snmp Agent on the Service Processor Agent Setting the Community Name Snmp standard tree displays in the MIB Browser Using a Third-Party MIB BrowserSetting Logging Options 1Server Event Traps Snmp Traps 2Subcommands for Configuring Snmp Destinations Configuring Snmp DestinationsConfiguring Snmp Trap Destinations Server MIB Details SP-EVENT-MIB.mib Events listed in -4are sent to the Snmp destination by SP Events 2 Enterprise Trap ID 5SNMP Troubleshooting Snmp TroubleshootingPage Further Management Information Configuring Scripting Capabilities Remote Scripting Using SSH Using Shell Scripts Generating Host Keys Configuring Multiple Systems for ScriptingEnter the following command Adding Public Keys Creating Trusted Host Relationships Execute the following command Enabling SSH Access Using Trusted HostsSet up your host keys by executing the following command Enable access for clients by launching a Bash shell Enter your password when prompted Enabling SSH Access Using Public Keys Command Output Guidelines for Writing Server Management Command Scripts Other Tips For Best Results Console Redirection Over Serial on a Linux-based Server Grub Lilo List of gettys currently looks like the following GettySecuretty Enabling and Configuring Bios Console Redirection 1Network Share Volume Compressed Packages Network Share Volume NSV CD-ROMNetwork Share Volume Structure 2Extracted Files on the Network Share Volume You can enable or disable the SOL feature through the SP Enabling or Disabling the SOL Feature on the ServerTo enable the feature, run the following command Serial Over LAN Terminating an SOL Session Launching an SOL SessionPress Control-E Press the C key Press the period key Press Enter Press the tilde key ~ Press the period keyPage Server Management Commands Summary Preface each command with the following text Using the ssh ProtocolInteractive Shell on the SP Preface Text Table A-1Server Management Commands Commands Table A-2Return Codes Return Codes Table A-2Return Codes Page Table B-1Access Subcommand Groups Access Commands Access Get Group Subcommand Access Groups SubcommandsFormat Return Codes Table B-4Return Codes for Subcommand access get groups Access Get Groups SubcommandTable B-4lists the return codes for this subcommand Access Get Map Subcommand Access Map SubcommandsTable B-6lists the arguments for this subcommand Table B-6Arguments for Subcommand access get map Table B-7lists the return codes for this subcommand Access Map SubcommandTable B-8lists the arguments for this subcommand Table B-7Return Codes for Subcommand access get map Table B-9lists the return codes for this subcommand Access Unmap SubcommandTable B-10lists the arguments for this subcommand Table B-9Return Codes for Subcommand access map Table B-11Return Codes for Subcommand access unmap Table B-11lists the return codes for this subcommand Access Disable Service Subcommand Access Directory Services SubcommandsTable B-13lists the argument for this subcommand Table B-13Argument for Subcommand access disable service Table B-14lists the return codes for this subcommand Access Enable Service Subcommand Table B-16lists the return codes for this subcommand Table B-15lists the arguments for this subcommandTable B-15Arguments for Subcommand access enable service Table B-16Return Codes for Subcommand access enable service Table B-17Arguments for Subcommand access get services Access Get Services Subcommand Table B-18Return Codes for Subcommand access get services Table B-18lists the return codes for this subcommand Access Add Trust Subcommand Access Trust SubcommandsTable B-20lists the arguments for this subcommand Table B-20Arguments for Subcommand access add trust Copy rsakey to /etc/ssh/sshhostrsakey Table B-21lists the return codes for this subcommand Access Delete Trust SubcommandTable B-22lists the arguments for this subcommand Table B-21Return Codes for Subcommand access add trust Table B-23Return Codes for Subcommand access delete trust Access Get Trusts SubcommandTable B-23lists the return codes for this subcommand Table B-24Return Codes for Subcommand access get trusts Table B-24lists the return codes for this subcommand Access Add Public Key Subcommand Access Public Key SubcommandsTable B-26lists the arguments for this subcommand Table B-25Access Public Key Subcommands Table B-27Return Codes for Subcommand access add public key Access Get Public Key Users SubcommandTable B-27lists the return codes for this subcommand Table B-28lists the return codes for this subcommand Access Delete Public Key SubcommandTable B-29lists the arguments for this subcommand Table B-29Arguments for Subcommand access delete public key Table B-30lists the return codes for this subcommand Access Add User Subcommand Access User SubcommandsTable B-32lists the arguments for this subcommand Table B-32Arguments for Subcommand access add user Table B-33lists the return codes for this subcommand Access Delete User SubcommandTable B-33Return Codes for Subcommand access add user Description Deletes a user Table B-35lists the return codes for this subcommand Table B-34lists the arguments for this subcommandTable B-34Arguments for Subcommand access delete user Table B-35Return Codes for Subcommand access delete user Table B-36lists the arguments for this subcommand Access Get Users SubcommandTable B-37lists the return codes for this subcommand Table B-36Arguments for Subcommand access get users Description Changes the password of an existing user Access Update Password SubcommandTable B-38lists the arguments for this subcommand Table B-39lists the return codes for this subcommand Table B-40Arguments for Subcommand access update user Access Update User SubcommandTable B-40lists the arguments for this subcommand Table B-41Return Codes for Subcommand access update user Table B-40lists the return codes for this subcommand Table C-1Diagnostics Subcommand Groups Diagnostics Commands Table C-2Arguments for Subcommand diags cancel tests Diags Cancel Tests SubcommandTable C-2lists the arguments for this subcommand Table C-3Return Codes for Subcommand diags cancel tests Table C-3lists the return codes for this subcommand Table C-4Return Codes for Subcommand diags get state Diags Get State SubcommandTable C-4lists the return codes for this subcommand Table C-5lists the arguments for this subcommand Diags Get Tests SubcommandTable C-6lists the return codes for this subcommand Table C-5Arguments for Subcommand diags get tests Table C-7Arguments for Subcommand diags run tests Diags Run Tests SubcommandTable C-7lists the arguments for this subcommand Table C-8Return Codes for Subcommand diags run tests Table C-8lists the return codes for this subcommand Table C-9Return Codes for Subcommand diags start Diags Start SubcommandTable C-9lists the return codes for this subcommand Invalid operation for current state Table C-10Return Codes for Subcommand diags terminate Diags Terminate SubcommandTable C-10lists the return codes for this subcommand Table D-1Inventory Subcommands Groups Inventory Commands Table D-2lists the arguments for this subcommand Inventory Compare Versions Subcommand Table D-3lists the return codes for this subcommand Inventory Get Hardware SubcommandTable D-4lists the arguments for this subcommand Table D-4Arguments for Subcommand inventory get hardware Return Codes Table D-5lists the return codes for this subcommandTable D-5Return Codes for Subcommand inventory get hardware Table D-6lists the arguments for this subcommand Inventory Get Software SubcommandTable D-7lists the return codes for this subcommand Table D-6Arguments for Subcommand inventory get software Table D-8lists the arguments for this subcommand Inventory Get All SubcommandTable D-9lists the return codes for this subcommand Table D-8Arguments for Subcommand inventory get all Table E-1IPMI Subommands Groups Ipmi Commands Description Allows you to disable one of two Ipmi channels Ipmi Disable Channel SubcommandTable E-2lists the arguments for this subcommand Table E-3lists the arguments for this subcommand Description Allows you to enable one of two Ipmi channels Ipmi Enable Channel SubcommandTable E-4lists the arguments for this subcommand Table E-5lists the return codes for this subcommand Table E-6Return Codes for Subcommand ipmi get channels Ipmi Get Channels SubcommandTable E-6lists the return codes for this subcommand Table E-7Return Codes for Subcommand ipmi disable pef Ipmi Disable PEF SubcommandTable E-7lists the return codes for this subcommand Table E-8Return Codes for Subcommand ipmi enable pef Ipmi Enable PEF SubcommandTable E-8lists the return codes for this subcommand Table E-9lists the return codes for this subcommand Ipmi Get Global Enables Subcommand Table E-11Information about the aliases Ipmi Set Global Enable SubcommandTable E-10Arguments for Subcommand ipmi set global enable Table E-12Return Codes for Subcommand ipmi set global enable Table E-12lists the return codes for this subcommand Table E-13lists the arguments for this subcommand Ipmi Reset SubcommandTable E-14lists the return codes for this subcommand Table E-13Arguments for Subcommand ipmi reset Table F-1Platform Subcommand Groups Platform Commands Platform Console Subcommand Platform Console Subcommands Table F-5Serial-Console Values Table F-3Common COM1 ValuesTable F-4Common Values for Console Redirection Ecl0 Run the command platform set console Check or set the Bios settings Run the commandTable F-6lists the return codes for this subcommand Table F-6Return Codes for Subcommand platform console Table F-8Supplementary Output Platform Get Console SubcommandFollowing output displays when successful Table F-9Return Codes for Subcommand platform get console Table F-9lists the return codes for this subcommand Platform Set Console Table F-10Arguments for Subcommand platform set console Table F-11Return Codes for Subcommand platform set console Table F-11lists the return codes for this subcommand Description Retrieves the current state of the platform OS Platform OS State SubcommandsPlatform Get OS State Subcommand Table F-13Return codes for Subcommand platform get os state Table F-13lists the return codes for this subcommand Table F-14Arguments for Subcommand platform set os state Platform Set OS State SubcommandTable F-14lists the arguments for this subcommand Table F-15Return Codes for Subcommand platform set os state Platform Set OS State Boot SubcommandTable F-15lists the return codes for this subcommand Table F-17lists the return codes for this subcommand Table F-16lists the arguments for this subcommand Platform Get Power State Subcommand Platform Power State Subcommands Table F-19lists the return codes for this subcommand Platform Set Power State Subcommand Table F-20Arguments for Subcommand platform set power state Table F-20lists the arguments for this subcommandTable F-21lists the return codes for this subcommand Table F-22lists the argument for this subcommand Platform Get Hostname SubcommandTable F-23lists the return codes for this subcommand Table F-22Argument for Subcommand platform get hostname Description Displays the product ID for the current system Platform Get Product ID SubcommandTable F-24lists the return codes for this subcommand Page Table G-1Sensor Subcommand Groups Sensor Commands Sensor Get Subcommand Table G-2Arguments for Subcommand sensor get Table G-2lists the arguments for this subcommand Table G-3Return Codes for Subcommand sensor get Table G-3lists the arguments for this subcommand Appendix G Sensor Commands Table G-4Arguments for Subcommand sensor set Sensor Set SubcommandTable G-4lists the arguments for this subcommand Table G-5Return Codes for Subcommand sensor set Table G-5lists the arguments for this subcommandPage Table H-1Service Processor Subcommand Groups Service Processor Commands SP Get Date Subcommand SP Date SubcommandsSubcommands in Table H-2manage the date and time on the SP Table H-2SP Date Subcommands Table H-3lists the return codes for this subcommand SP Set Date SubcommandTable H-4lists the argument for this subcommand Description Sets the date and time on the SP RTC Table H-5Return Codes for Subcommand sp set date Table H-5lists the return codes for this command SP Disable DNS Subcommand SP DNS SubcommandsDescription Disables the DNS configuration on the SP Table H-7lists the return codes for this command Table H-8lists the arguments for this subcommand SP Enable DNS SubcommandTable H-9lists the return codes for this subcommand Table H-8Arguments for Subcommand sp enable dns Table H-10lists the arguments for this subcommand SP Get DNS SubcommandTable H-11lists the return codes for this subcommand Table H-10Arguments for Subcommand sp get dns SP Delete Event Subcommand SP Events SubcommandsSubcommands in Table H-12manage events on the SP Description Clears an existing event using the event ID Table H-14Return Codes for Subcommand sp delete event SP Get Events SubcommandTable H-14lists the return codes for this subcommand Table H-16lists the return codes for this subcommand Table H-15lists the arguments for this subcommandTable H-15Arguments for Subcommand sp get events Table H-16Return Codes for Subcommand sp get events SP Get Hostname Subcommand SP Hostname SubcommandsSubcommands in Table H-17manage the SP host and domain Table H-18lists the argument for this subcommand Table H-19lists the return codes for this subcommand SP Set Hostname SubcommandTable H-20lists the argument for this subcommand Table H-19Return Codes for Subcommand sp get hostname Table H-21Return Codes for Subcommand sp set hostname Table H-21lists the return codes for this subcommand SP Get IP Subcommand SP IP SubcommandsTable H-23lists the arguments for this subcommand IP Subcommands Table H-24lists the arguments for this subcommand SP Set IP SubcommandDescription Sets or modifies the SP network configuration Table H-24Return Codes for Subcommand sp get ip Table H-26lists the return codes for this subcommand Table H-25lists the arguments for this subcommandTable H-25Arguments for Subcommand sp set ip Table H-26Return Codes for Subcommand sp set ip SP Get Jnet Subcommand SP Jnet Address SubcommandsTable H-28lists the arguments for this subcommand Jnet Subcommands Table H-29Return Codes for Subcommand sp get jnet SP Set Jnet SubcommandTable H-29lists the return codes for this subcommand Table H-31lists the return codes for this subcommand Table H-30lists the arguments for this subcommandTable H-30Arguments for Subcommand sp set jnet Table H-31Return Codes for Subcommand sp set jnet SP Get Locatelight Subcommand SP Locate Light SubcommandsSubcommands in Table H-32manage the locatelight switch Table H-33lists the return codes for this subcommand Table H-34Return Codes for Subcommand sp set locatelight SP Set Locatelight SubcommandTable H-34lists the return codes for this subcommand SP Get Logfile Subcommand SP Logfile SubcommandsSubcommands in Table H-35manage the SP log files Description Retrieves the event log file configuration Table H-37lists the return codes for this subcommand SP Set Logfile SubcommandTable H-37Return Codes for Subcommand sp get logfile Table H-38Arguments for Subcommand sp set logfile Table H-39Return Codes for Subcommand sp set logfile Table H-39lists the arguments for this subcommand SP Create Test Events Subcommand SP Miscellaneous SubcommandsSubcommands in Table H-40manage miscellaneous SP functions Table H-40Miscellaneous SP Subcommands Table H-41lists the return codes for this command SP Get Port 80 SubcommandTable H-42lists the arguments for this subcommand Table H-41Return Codes for Subcommand sp create test events Table H-43lists the return codes for this subcommand Bios Post CodesTable H-44lists the Post codes for the Phoenix Bios Table H-43Return Codes for Subcommand sp get port80 Table H-44BIOS Post Codes Table H-44BIOS Post Codes Table H-44BIOS Post Codes Enable hardware interrupts Table H-45Boot Block Codes in Flash ROM Boot Block Codes for Flash ROMTable H-45lists the boot block codes in Flash ROM Table H-46Arguments for Subcommand sp load settings SP Load Settings SubcommandTable H-46lists the arguments for this subcommand Table H-47lists the return codes for this subcommand SP Get Status SubcommandTable H-48lists the arguments for this subcommand Description Returns the status of the overall system Table H-49Return Codes for Subcommand sp get status SP Get TDULog SubcommandTable H-49lists the return codes for this subcommand Table H-50Arguments for Subcommand sp get tdulog Table H-50lists the arguments for this subcommand Table H-52lists the return codes for this subcommand SP Reboot SubcommandTable H-53lists the argument for this command Table H-52Return Codes for Subcommand sp get tdulog Table H-54Return Codes for Subcommand sp reboot SP Reset SubcommandTable H-54lists the return codes for this command Table H-55Arguments for Subcommand sp reset Table H-55lists the arguments for this command Table H-56Return Codes for Subcommand sp reset Table H-56list the return codes for this command SP Add Mount Subcommand SP Mount SubcommandsSubcommands in Table H-57manage the SP mount points Description Creates or resets a mount point Table H-59Return Codes for Subcommand sp add mount Table H-59lists the return codes for this subcommand Table H-61lists the return codes for this subcommand Table H-60lists the arguments for this subcommandSP Delete Mount Description Deletes a mount point Table H-62lists the arguments for this subcommand SP Get Mount SubcommandTable H-63lists the return codes for this subcommand Description Displays the current mount points on the SP Subcommands in Table H-64manage Smtp communications SP Smtp SubcommandsSP Get Smtp Server Subcommand Table H-66lists the return codes for this subcommand Table H-65lists the arguments for this subcommandTable H-65Arguments for Subcommand sp get smtp server Table H-66Return Codes for Subcommand sp get smtp server Table H-67lists the arguments for this subcommand SP Set Smtp Server SubcommandTable H-68lists the return codes for this subcommand Table H-67Arguments for Subcommand sp set smtp server Table H-70Default Smtp Subscribers SP Get Smtp Subscribers SubcommandTable H-69Arguments for Subcommand sp get smtp sebscribers Table H-71lists the return codes for this subcommand SP Update Smtp Subscriber Subcommand Table H-73Default Smtp Subscribers Table H-72Arguments for Subcommand sp update smtp subscriber Table H-74lists the return codes for this command Subcommands in Table H-75manage Snmp communications SP Snmp SubcommandsSP Add Snmp Destination Subcommand Table H-76Argument for Subcommand sp add snmp-destination Table H-76lists the argument for this subcommandTable H-77lists the return codes for this subcommand Table H-79lists the return codes for this subcommand SP Delete Snmp Destination SubcommandTable H-78lists the arguments for this subcommand Table H-80lists the return codes for this subcommand SP Get Snmp Destinations Subcommand Table H-81lists the return codes for this subcommand SP Get Snmp Proxy Community SubcommandSP Set Snmp Proxy Community Subcommand Table H-83lists the return codes for this subcommand Table H-82lists the argument for this subcommand SP Disable SSL-Required Subcommand SP SSL SubcommandsSubcommands in Table H-84manage SSL capabilities Table H-85lists the return codes for this command Table H-86lists the return codes for this command SP Enable SSL-Required Subcommand Table H-87lists the arguments for this subcommand SP Get SSL SubcommandTable H-88lists the return codes for this subcommand Table H-87Arguments for Subcommand sp get ssl Table H-89lists the arguments for this subcommand SP Set SSL SubcommandTable H-90lists the return codes for this subcommand Table H-89Arguments for Subcommand sp set ssl Subcommands in Table H-91manage the SP flash SP Update SubcommandsSP Update Flash All Subcommand Table H-93lists the return codes for this subcommand Table H-92lists the arguments for this subcommandTable H-92Arguments for Subcommand sp update flash all Table H-93Return Codes for Subcommand sp update flash all Table H-95lists the return codes for this subcommand SP Update Flash Applications SubcommandTable H-94lists the arguments for this subcommand Table H-96lists the arguments for this subcommand SP Update Flash PIC SubcommandTable H-97lists the return codes for this subcommand Table H-96Arguments for Subcommand sp update flash pic Table H-98lists the argument for this subcommand SP Update Diags SubcommandTable H-99lists the return codes for this subcommand Table H-98Argument for Subcommand sp update diags Index Page Index Page Index

Sun Microsystems V40z, V20Z Further Management Information, Configuring Scripting Capabilities

Models: V20Z V40z

Further Management Information

Configuring Scripting Capabilities