Manuals / Sun Microsystems / Computer Equipment / Server

Sun Microsystems V20Z, V40z manual Platform Get Hostname Subcommand

Models: V20Z V40z

1 254

Page 172

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

TABLE F-22lists the argument for this subcommand.

TABLE F-22Argument for Subcommand platform get hostname

ArgumentsDescription

{-H --noheader}Suppresses column headers.

Return Codes

TABLE F-23lists the return codes for this subcommand.

TABLE F-23Return Codes for Subcommand platform get hostname

Return Code	ID	Description

NWSE_Success	0	Command successfully completed.
NWSE_InvalidUsage	1	Invalid usage: bad parameter usage, conflicting
		options specified.
NWSE_NoMemory	8	Insufficient memory.
NWSE_Busy	9	Device or resource is busy.
NWSE_RPCConnected	11	RPC client already connected.
NWSE_RPCConnRefused	12	RPC connection refused.
NWSE_NoRouteToHost	13	No route to host (network down).
NWSE_HostDown	14	Host is down.

150 Sun Fire V20z and Sun Fire V40z Servers, Server Management Guide • May, 2004

Page 172

Image 172

Sun Microsystems V20Z, V40z manual Platform Get Hostname Subcommand, Table F-22lists the argument for this subcommand

Contents

Sun Microsystems, Inc Please Recycle Contents Ipmi Server Management Snmp Server Management Configuring Scripting Capabilities Using Shell ScriptsFurther Management Information Server Management Commands Summary LiloCommands Return Codes Access CommandsPage Diagnostics Commands Inventory Commands Inventory Compare Versions SubcommandIpmi Commands Format Return CodesPlatform Commands Sensor Commands Service Processor Commands 161Contents Page Contents Page Contents Page Preface How This Book Is OrganizedRelated Documentation Accessing Sun Documentation Third-Party Web SitesContacting Sun Technical Support Sun Welcomes Your CommentsPage Introduction Overview1defines the acronyms found in this document AcronymsAcronyms Server Management Service ProcessorServer-Management Interfaces Command Line Interface Snmp IntegrationServer Operator Panel 2Sun Fire V20z Server Operator Panel and Buttons2Operator Panel Buttons User Groups User TypesPart I Assigning Network Settings to the SP Initial Setup of the Service ProcessorAssigning SP Network Settings Using Dhcp Following prompt appears with the default response Press the Forward button until you reach the SP menuPress the Select button to display the SP menu options Press the Select buttonAssigning Static SP Network Settings This field can hold a value between 0SP address is now configured and the server is ready for use LCD displays the following confirmation promptPart II Securing the Service Processor Creating the Initial Manager AccountEnabling Ipmi Access on the Server Enabling Ipmi Access on a Linux-Based Server In-BandInstall IPMItool Install the openIPMI RPM file by running the commandSuccessful output should look similar to the following Confirm installation of all packages when prompted Enabling Ipmi Access on a Solaris-Based x86 Server In-BandReboot the server Enabling Ipmi LAN Access on a Linux-Based Server In-Band Enabling Ipmi LAN AccessUsing IPMItool, configure the network setting for the SP Enable Ipmi LAN access and assign a password when prompted Alternate Method for Enabling Ipmi LAN Access Out-of- BandUsing IPMItool, test the Ipmi LAN access Recompile the module by running the following commands Upgrading the Linux KernelDaisy-Chaining the Servers 5Daisy Chain ArchitectureUpdating the SP Software Site IntegrationLCD displays the first menu option Press Select or Enter to display the SP menu’s options Updating the Service Processor Base Component To update the SP base componentLog in to the SP by running the following command Run the sp command to start the update process on the SPAutoconfiguring the SP Optional Method Following message displays when autoconfiguration is running Determining SP and Platform Network MAC AddressesPage Ipmi Server Management Baseboard Management Controller ManageabilityIpmi Compliance and LAN Channel Access Usernames and PasswordsLights Out Management LOM DescriptionFurther Information Syntax1lists the options available for IPMItool Options1Options for IPMItool Expressions 2Expressions and Parameters for IPMItool 12Expressions and Parameters for IPMItool 2 Interval2Expressions and Parameters for IPMItool 3 Parameter2Expressions and Parameters for IPMItool 4 TypeIpmi Linux Kernel Device Driver LAN Interface for the BMCFiles Result returned isViewing the Ipmi System Event Log Clearing the Ipmi System Event LogIpmi Troubleshooting 3IPMI TroubleshootingPage Snmp Server Management Simple Network Management ProtocolSnmp Integration Snmp Management Information Base MIBSun Fire V20z and Sun Fire V40z Servers MIB Tree Integrating MIBs with Third-Party ConsolesConfiguring Snmp on Your Server 2SNMP Architecture and CommunicationsSnmp Agent on the Service Processor Proxy AgentSetting the Community Name AgentSetting Logging Options Using a Third-Party MIB BrowserSnmp standard tree displays in the MIB Browser Snmp Traps 1Server Event TrapsConfiguring Snmp Trap Destinations Configuring Snmp Destinations2Subcommands for Configuring Snmp Destinations Server MIB Details Events listed in -4are sent to the Snmp destination by SP-EVENT-MIB.mibSP Events 2 Enterprise Trap ID Snmp Troubleshooting 5SNMP TroubleshootingPage Configuring Scripting Capabilities Further Management InformationUsing Shell Scripts Remote Scripting Using SSHEnter the following command Configuring Multiple Systems for ScriptingGenerating Host Keys Creating Trusted Host Relationships Adding Public KeysEnabling SSH Access Using Trusted Hosts Execute the following commandSet up your host keys by executing the following command Enable access for clients by launching a Bash shellEnabling SSH Access Using Public Keys Enter your password when promptedGuidelines for Writing Server Management Command Scripts Command OutputOther Tips For Best Results Console Redirection Over Serial on a Linux-based Server Grub Lilo Securetty GettyList of gettys currently looks like the following Enabling and Configuring Bios Console Redirection Network Share Volume Structure Network Share Volume NSV CD-ROM1Network Share Volume Compressed Packages 2Extracted Files on the Network Share Volume Enabling or Disabling the SOL Feature on the Server You can enable or disable the SOL feature through the SPTo enable the feature, run the following command Serial Over LANLaunching an SOL Session Terminating 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 Using the ssh Protocol Preface each command with the following textInteractive Shell on the SP Preface TextCommands Table A-1Server Management CommandsReturn Codes Table A-2Return CodesTable A-2Return Codes Page Access Commands Table B-1Access Subcommand GroupsAccess Groups Subcommands Access Get Group SubcommandFormat Return CodesTable B-4lists the return codes for this subcommand Access Get Groups SubcommandTable B-4Return Codes for Subcommand access get groups Access Map Subcommands Access Get Map SubcommandTable B-6lists the arguments for this subcommand Table B-6Arguments for Subcommand access get mapAccess Map Subcommand Table B-7lists the return codes for this subcommandTable B-8lists the arguments for this subcommand Table B-7Return Codes for Subcommand access get mapAccess Unmap Subcommand Table B-9lists the return codes for this subcommandTable B-10lists the arguments for this subcommand Table B-9Return Codes for Subcommand access mapTable B-11lists the return codes for this subcommand Table B-11Return Codes for Subcommand access unmapAccess Directory Services Subcommands Access Disable Service SubcommandTable B-13lists the argument for this subcommand Table B-13Argument for Subcommand access disable serviceAccess Enable Service Subcommand Table B-14lists the return codes for this subcommandTable B-15lists the arguments for this subcommand Table B-16lists the return codes for this subcommandTable B-15Arguments for Subcommand access enable service Table B-16Return Codes for Subcommand access enable serviceAccess Get Services Subcommand Table B-17Arguments for Subcommand access get servicesTable B-18lists the return codes for this subcommand Table B-18Return Codes for Subcommand access get servicesAccess Trust Subcommands Access Add Trust SubcommandTable B-20lists the arguments for this subcommand Table B-20Arguments for Subcommand access add trustCopy rsakey to /etc/ssh/sshhostrsakey Access Delete Trust Subcommand Table B-21lists the return codes for this subcommandTable B-22lists the arguments for this subcommand Table B-21Return Codes for Subcommand access add trustTable B-23lists the return codes for this subcommand Access Get Trusts SubcommandTable B-23Return Codes for Subcommand access delete trust Table B-24lists the return codes for this subcommand Table B-24Return Codes for Subcommand access get trustsAccess Public Key Subcommands Access Add Public Key SubcommandTable B-26lists the arguments for this subcommand Table B-25Access Public Key SubcommandsTable B-27lists the return codes for this subcommand Access Get Public Key Users SubcommandTable B-27Return Codes for Subcommand access add public key Access Delete Public Key Subcommand Table B-28lists the return codes for this subcommandTable B-29lists the arguments for this subcommand Table B-29Arguments for Subcommand access delete public keyTable B-30lists the return codes for this subcommand Access User Subcommands Access Add User SubcommandTable B-32lists the arguments for this subcommand Table B-32Arguments for Subcommand access add userAccess Delete User Subcommand Table B-33lists the return codes for this subcommandTable B-33Return Codes for Subcommand access add user Description Deletes a userTable B-34lists the arguments for this subcommand Table B-35lists the return codes for this subcommandTable B-34Arguments for Subcommand access delete user Table B-35Return Codes for Subcommand access delete userAccess Get Users Subcommand Table B-36lists the arguments for this subcommandTable B-37lists the return codes for this subcommand Table B-36Arguments for Subcommand access get usersAccess Update Password Subcommand Description Changes the password of an existing userTable B-38lists the arguments for this subcommand Table B-39lists the return codes for this subcommandTable B-40lists the arguments for this subcommand Access Update User SubcommandTable B-40Arguments for Subcommand access update user Table B-40lists the return codes for this subcommand Table B-41Return Codes for Subcommand access update userDiagnostics Commands Table C-1Diagnostics Subcommand GroupsTable C-2lists the arguments for this subcommand Diags Cancel Tests SubcommandTable C-2Arguments for Subcommand diags cancel tests Table C-3lists the return codes for this subcommand Table C-3Return Codes for Subcommand diags cancel testsTable C-4lists the return codes for this subcommand Diags Get State SubcommandTable C-4Return Codes for Subcommand diags get state Diags Get Tests Subcommand Table C-5lists the arguments for this subcommandTable C-6lists the return codes for this subcommand Table C-5Arguments for Subcommand diags get testsTable C-7lists the arguments for this subcommand Diags Run Tests SubcommandTable C-7Arguments for Subcommand diags run tests Table C-8lists the return codes for this subcommand Table C-8Return Codes for Subcommand diags run testsTable C-9lists the return codes for this subcommand Diags Start SubcommandTable C-9Return Codes for Subcommand diags start Invalid operation for current state Table C-10lists the return codes for this subcommand Diags Terminate SubcommandTable C-10Return Codes for Subcommand diags terminate Inventory Commands Table D-1Inventory Subcommands GroupsInventory Compare Versions Subcommand Table D-2lists the arguments for this subcommandInventory Get Hardware Subcommand Table D-3lists the return codes for this subcommandTable D-4lists the arguments for this subcommand Table D-4Arguments for Subcommand inventory get hardwareTable D-5Return Codes for Subcommand inventory get hardware Table D-5lists the return codes for this subcommandReturn Codes Inventory Get Software Subcommand Table D-6lists the arguments for this subcommandTable D-7lists the return codes for this subcommand Table D-6Arguments for Subcommand inventory get softwareInventory Get All Subcommand Table D-8lists the arguments for this subcommandTable D-9lists the return codes for this subcommand Table D-8Arguments for Subcommand inventory get allIpmi Commands Table E-1IPMI Subommands GroupsIpmi Disable Channel Subcommand Description Allows you to disable one of two Ipmi channelsTable E-2lists the arguments for this subcommand Table E-3lists the arguments for this subcommandIpmi Enable Channel Subcommand Description Allows you to enable one of two Ipmi channelsTable E-4lists the arguments for this subcommand Table E-5lists the return codes for this subcommandTable E-6lists the return codes for this subcommand Ipmi Get Channels SubcommandTable E-6Return Codes for Subcommand ipmi get channels Table E-7lists the return codes for this subcommand Ipmi Disable PEF SubcommandTable E-7Return Codes for Subcommand ipmi disable pef Table E-8lists the return codes for this subcommand Ipmi Enable PEF SubcommandTable E-8Return Codes for Subcommand ipmi enable pef Ipmi Get Global Enables Subcommand Table E-9lists the return codes for this subcommandTable E-10Arguments for Subcommand ipmi set global enable Ipmi Set Global Enable SubcommandTable E-11Information about the aliases Table E-12lists the return codes for this subcommand Table E-12Return Codes for Subcommand ipmi set global enableIpmi Reset Subcommand Table E-13lists the arguments for this subcommandTable E-14lists the return codes for this subcommand Table E-13Arguments for Subcommand ipmi resetPlatform Commands Table F-1Platform Subcommand GroupsPlatform Console Subcommands Platform Console SubcommandTable F-4Common Values for Console Redirection Table F-3Common COM1 ValuesTable F-5Serial-Console Values Ecl0 Check or set the Bios settings Run the command Run the command platform set consoleTable F-6lists the return codes for this subcommand Table F-6Return Codes for Subcommand platform consoleFollowing output displays when successful Platform Get Console SubcommandTable F-8Supplementary Output Table F-9lists the return codes for this subcommand Table F-9Return Codes for Subcommand platform get consoleTable F-10Arguments for Subcommand platform set console Platform Set ConsoleTable F-11lists the return codes for this subcommand Table F-11Return Codes for Subcommand platform set consolePlatform Get OS State Subcommand Platform OS State SubcommandsDescription Retrieves the current state of the platform OS Table F-13lists the return codes for this subcommand Table F-13Return codes for Subcommand platform get os stateTable F-14lists the arguments for this subcommand Platform Set OS State SubcommandTable F-14Arguments for Subcommand platform set os state Table F-15lists the return codes for this subcommand Platform Set OS State Boot SubcommandTable F-15Return Codes for Subcommand platform set os state Table F-16lists the arguments for this subcommand Table F-17lists the return codes for this subcommandPlatform Power State Subcommands Platform Get Power State SubcommandPlatform Set Power State Subcommand Table F-19lists the return codes for this subcommandTable F-21lists the return codes for this subcommand Table F-20lists the arguments for this subcommandTable F-20Arguments for Subcommand platform set power state Platform Get Hostname Subcommand Table F-22lists the argument for this subcommandTable F-23lists the return codes for this subcommand Table F-22Argument for Subcommand platform get hostnameTable F-24lists the return codes for this subcommand Platform Get Product ID SubcommandDescription Displays the product ID for the current system Page Sensor Commands Table G-1Sensor Subcommand GroupsSensor Get Subcommand Table G-2lists the arguments for this subcommand Table G-2Arguments for Subcommand sensor getTable G-3lists the arguments for this subcommand Table G-3Return Codes for Subcommand sensor getAppendix G Sensor Commands Table G-4lists the arguments for this subcommand Sensor Set SubcommandTable G-4Arguments for Subcommand sensor set Table G-5lists the arguments for this subcommand Table G-5Return Codes for Subcommand sensor setPage Service Processor Commands Table H-1Service Processor Subcommand GroupsSP Date Subcommands SP Get Date SubcommandSubcommands in Table H-2manage the date and time on the SP Table H-2SP Date SubcommandsSP Set Date Subcommand Table H-3lists the return codes for this subcommandTable H-4lists the argument for this subcommand Description Sets the date and time on the SP RTCTable H-5lists the return codes for this command Table H-5Return Codes for Subcommand sp set dateSP DNS Subcommands SP Disable DNS SubcommandDescription Disables the DNS configuration on the SP Table H-7lists the return codes for this commandSP Enable DNS Subcommand Table H-8lists the arguments for this subcommandTable H-9lists the return codes for this subcommand Table H-8Arguments for Subcommand sp enable dnsSP Get DNS Subcommand Table H-10lists the arguments for this subcommandTable H-11lists the return codes for this subcommand Table H-10Arguments for Subcommand sp get dnsSP Events Subcommands SP Delete Event SubcommandSubcommands in Table H-12manage events on the SP Description Clears an existing event using the event IDTable H-14lists the return codes for this subcommand SP Get Events SubcommandTable H-14Return Codes for Subcommand sp delete event Table H-15lists the arguments for this subcommand Table H-16lists the return codes for this subcommandTable H-15Arguments for Subcommand sp get events Table H-16Return Codes for Subcommand sp get eventsSP Hostname Subcommands SP Get Hostname SubcommandSubcommands in Table H-17manage the SP host and domain Table H-18lists the argument for this subcommandSP Set Hostname Subcommand Table H-19lists the return codes for this subcommandTable H-20lists the argument for this subcommand Table H-19Return Codes for Subcommand sp get hostnameTable H-21lists the return codes for this subcommand Table H-21Return Codes for Subcommand sp set hostnameSP IP Subcommands SP Get IP SubcommandTable H-23lists the arguments for this subcommand IP SubcommandsSP Set IP Subcommand Table H-24lists the arguments for this subcommandDescription Sets or modifies the SP network configuration Table H-24Return Codes for Subcommand sp get ipTable H-25lists the arguments for this subcommand Table H-26lists the return codes for this subcommandTable H-25Arguments for Subcommand sp set ip Table H-26Return Codes for Subcommand sp set ipSP Jnet Address Subcommands SP Get Jnet SubcommandTable H-28lists the arguments for this subcommand Jnet SubcommandsTable H-29lists the return codes for this subcommand SP Set Jnet SubcommandTable H-29Return Codes for Subcommand sp get jnet Table H-30lists the arguments for this subcommand Table H-31lists the return codes for this subcommandTable H-30Arguments for Subcommand sp set jnet Table H-31Return Codes for Subcommand sp set jnetSP Locate Light Subcommands SP Get Locatelight SubcommandSubcommands in Table H-32manage the locatelight switch Table H-33lists the return codes for this subcommandTable H-34lists the return codes for this subcommand SP Set Locatelight SubcommandTable H-34Return Codes for Subcommand sp set locatelight SP Logfile Subcommands SP Get Logfile SubcommandSubcommands in Table H-35manage the SP log files Description Retrieves the event log file configurationSP Set Logfile Subcommand Table H-37lists the return codes for this subcommandTable H-37Return Codes for Subcommand sp get logfile Table H-38Arguments for Subcommand sp set logfileTable H-39lists the arguments for this subcommand Table H-39Return Codes for Subcommand sp set logfileSP Miscellaneous Subcommands SP Create Test Events SubcommandSubcommands in Table H-40manage miscellaneous SP functions Table H-40Miscellaneous SP SubcommandsSP Get Port 80 Subcommand Table H-41lists the return codes for this commandTable H-42lists the arguments for this subcommand Table H-41Return Codes for Subcommand sp create test eventsBios Post Codes Table H-43lists the return codes for this subcommandTable H-44lists the Post codes for the Phoenix Bios Table H-43Return Codes for Subcommand sp get port80Table H-44BIOS Post Codes Table H-44BIOS Post Codes Table H-44BIOS Post Codes Enable hardware interrupts Table H-45lists the boot block codes in Flash ROM Boot Block Codes for Flash ROMTable H-45Boot Block Codes in Flash ROM Table H-46lists the arguments for this subcommand SP Load Settings SubcommandTable H-46Arguments for Subcommand sp load settings SP Get Status Subcommand Table H-47lists the return codes for this subcommandTable H-48lists the arguments for this subcommand Description Returns the status of the overall systemTable H-49lists the return codes for this subcommand SP Get TDULog SubcommandTable H-49Return Codes for Subcommand sp get status Table H-50lists the arguments for this subcommand Table H-50Arguments for Subcommand sp get tdulogSP Reboot Subcommand Table H-52lists the return codes for this subcommandTable H-53lists the argument for this command Table H-52Return Codes for Subcommand sp get tdulogTable H-54lists the return codes for this command SP Reset SubcommandTable H-54Return Codes for Subcommand sp reboot Table H-55lists the arguments for this command Table H-55Arguments for Subcommand sp resetTable H-56list the return codes for this command Table H-56Return Codes for Subcommand sp resetSP Mount Subcommands SP Add Mount SubcommandSubcommands in Table H-57manage the SP mount points Description Creates or resets a mount pointTable H-59lists the return codes for this subcommand Table H-59Return Codes for Subcommand sp add mountTable H-60lists the arguments for this subcommand Table H-61lists the return codes for this subcommandSP Delete Mount Description Deletes a mount pointSP Get Mount Subcommand Table H-62lists the arguments for this subcommandTable H-63lists the return codes for this subcommand Description Displays the current mount points on the SPSP Get Smtp Server Subcommand SP Smtp SubcommandsSubcommands in Table H-64manage Smtp communications Table H-65lists the arguments for this subcommand Table H-66lists the return codes for this subcommandTable H-65Arguments for Subcommand sp get smtp server Table H-66Return Codes for Subcommand sp get smtp serverSP Set Smtp Server Subcommand Table H-67lists the arguments for this subcommandTable H-68lists the return codes for this subcommand Table H-67Arguments for Subcommand sp set smtp serverTable H-69Arguments for Subcommand sp get smtp sebscribers SP Get Smtp Subscribers SubcommandTable H-70Default Smtp Subscribers SP Update Smtp Subscriber Subcommand Table H-71lists the return codes for this subcommandTable H-72Arguments for Subcommand sp update smtp subscriber Table H-73Default Smtp SubscribersTable H-74lists the return codes for this command SP Add Snmp Destination Subcommand SP Snmp SubcommandsSubcommands in Table H-75manage Snmp communications Table H-77lists the return codes for this subcommand Table H-76lists the argument for this subcommandTable H-76Argument for Subcommand sp add snmp-destination Table H-78lists the arguments for this subcommand SP Delete Snmp Destination SubcommandTable H-79lists the return codes for this subcommand SP Get Snmp Destinations Subcommand Table H-80lists the return codes for this subcommandSP Set Snmp Proxy Community Subcommand SP Get Snmp Proxy Community SubcommandTable H-81lists the return codes for this subcommand Table H-82lists the argument for this subcommand Table H-83lists the return codes for this subcommandSP SSL Subcommands SP Disable SSL-Required SubcommandSubcommands in Table H-84manage SSL capabilities Table H-85lists the return codes for this commandSP Enable SSL-Required Subcommand Table H-86lists the return codes for this commandSP Get SSL Subcommand Table H-87lists the arguments for this subcommandTable H-88lists the return codes for this subcommand Table H-87Arguments for Subcommand sp get sslSP Set SSL Subcommand Table H-89lists the arguments for this subcommandTable H-90lists the return codes for this subcommand Table H-89Arguments for Subcommand sp set sslSP Update Flash All Subcommand SP Update SubcommandsSubcommands in Table H-91manage the SP flash Table H-92lists the arguments for this subcommand Table H-93lists the return codes for this subcommandTable H-92Arguments for Subcommand sp update flash all Table H-93Return Codes for Subcommand sp update flash allTable H-94lists the arguments for this subcommand SP Update Flash Applications SubcommandTable H-95lists the return codes for this subcommand SP Update Flash PIC Subcommand Table H-96lists the arguments for this subcommandTable H-97lists the return codes for this subcommand Table H-96Arguments for Subcommand sp update flash picSP Update Diags Subcommand Table H-98lists the argument for this subcommandTable H-99lists the return codes for this subcommand Table H-98Argument for Subcommand sp update diagsIndex Page Index Page Index