Manuals / Sun Microsystems / Computer Equipment / Server

Sun Microsystems V40z, V20Z manual Table A-2Return Codes

Models: V20Z V40z

1 254

Page 99

TABLE A-2Return Codes	(2 of 2)

Return Code	ID	Description

NWSE_NoPermission	6	Not authorized to perform this
		operation.
NWSE_MissingArgument	7	Missing argument(s).
NWSE_NoMemory	8	Insufficient memory.
NWSE_Busy	9	Device or resource is busy.
NWSE_NotImplemented	10	Function not implemented.
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.
NWSE_UnknownError	15	Miscellaneous error not captured
		by other errors.
NWSE_GatewayOffNet	16	Gateway address is not on
		network.
NWSE_NetMaskIncorrect	17	An inappropriate netmask was
		specified.
NWSE_FileError	18	File open, file missing, or a read
		or write error occurred.
NWSE_Exist	19	Entity (user, service or other)
		already exists.
NWSE_NotRecognized	20	Request not understood.
NWSE_NotMounted	21	File system is not mounted.
NWSE_InvalidOpForState	22	Invalid operation for current
		state.
NWSE_TimedOut	23	Operation timed out.
NWSE_ServiceNotAvailable	24	Requested service is not available.
NWSE_DeviceError	25	Unable to read or write to the
		device.
NWSE_LimitExceeded	26	Limit has been exceeded.

Appendix A Server Management Commands Summary 77

Page 99

Image 99

Sun Microsystems V40z, V20Z manual Table A-2Return Codes

Contents

Sun Microsystems, Inc Please Recycle Contents Ipmi Server Management Configuring Scripting Capabilities Using Shell Scripts Snmp Server ManagementFurther Management Information Lilo Server Management Commands SummaryAccess Commands Commands Return CodesPage Diagnostics Commands Format Return Codes Inventory CommandsInventory Compare Versions Subcommand Ipmi CommandsPlatform Commands Service Processor Commands 161 Sensor CommandsContents Page Contents Page Contents Page How This Book Is Organized PrefaceRelated Documentation Sun Welcomes Your Comments Accessing Sun DocumentationThird-Party Web Sites Contacting Sun Technical SupportPage Overview IntroductionAcronyms 1defines the acronyms found in this documentAcronyms Service Processor Server ManagementServer-Management Interfaces Snmp Integration Command Line InterfaceServer 2Sun Fire V20z Server Operator Panel and Buttons Operator Panel2Operator Panel Buttons User Types User GroupsInitial Setup of the Service Processor Part I Assigning Network Settings to the SPAssigning SP Network Settings Using Dhcp Press the Select button Following prompt appears with the default responsePress the Forward button until you reach the SP menu Press the Select button to display the SP menu optionsThis field can hold a value between 0 Assigning Static SP Network SettingsLCD displays the following confirmation prompt SP address is now configured and the server is ready for useCreating the Initial Manager Account Part II Securing the Service ProcessorEnabling Ipmi Access on a Linux-Based Server In-Band Enabling Ipmi Access on the ServerInstall the openIPMI RPM file by running the command Install IPMItoolSuccessful output should look similar to the following Enabling Ipmi Access on a Solaris-Based x86 Server In-Band Confirm installation of all packages when promptedReboot the server Enabling Ipmi LAN Access Enabling Ipmi LAN Access on a Linux-Based Server In-BandUsing IPMItool, configure the network setting for the SP Alternate Method for Enabling Ipmi LAN Access Out-of- Band Enable Ipmi LAN access and assign a password when promptedUsing IPMItool, test the Ipmi LAN access Upgrading the Linux Kernel Recompile the module by running the following commands5Daisy Chain Architecture Daisy-Chaining the ServersSite Integration Updating the SP SoftwareLCD displays the first menu option Press Select or Enter to display the SP menu’s options Run the sp command to start the update process on the SP Updating the Service Processor Base ComponentTo update the SP base component Log in to the SP by running the following commandAutoconfiguring the SP Optional Method Determining SP and Platform Network MAC Addresses Following message displays when autoconfiguration is runningPage Ipmi Server Management Manageability Baseboard Management ControllerUsernames and Passwords Ipmi Compliance and LAN Channel AccessSyntax Lights Out Management LOMDescription Further InformationOptions 1lists the options available for IPMItool1Options for IPMItool 2Expressions and Parameters for IPMItool 1 ExpressionsInterval 2Expressions and Parameters for IPMItool 2Parameter 2Expressions and Parameters for IPMItool 3Type 2Expressions and Parameters for IPMItool 4LAN Interface for the BMC Ipmi Linux Kernel Device DriverResult returned is FilesClearing the Ipmi System Event Log Viewing the Ipmi System Event Log3IPMI Troubleshooting Ipmi TroubleshootingPage Simple Network Management Protocol Snmp Server ManagementSnmp Management Information Base MIB Snmp IntegrationIntegrating MIBs with Third-Party Consoles Sun Fire V20z and Sun Fire V40z Servers MIB Tree2SNMP Architecture and Communications Configuring Snmp on Your ServerProxy Agent Snmp Agent on the Service ProcessorAgent Setting the Community NameUsing a Third-Party MIB Browser Setting Logging OptionsSnmp standard tree displays in the MIB Browser 1Server Event Traps Snmp TrapsConfiguring Snmp Destinations Configuring Snmp Trap Destinations2Subcommands for Configuring Snmp Destinations Server MIB Details SP-EVENT-MIB.mib Events listed in -4are sent to the Snmp destination bySP Events 2 Enterprise Trap ID 5SNMP Troubleshooting Snmp TroubleshootingPage Further Management Information Configuring Scripting CapabilitiesRemote Scripting Using SSH Using Shell ScriptsConfiguring Multiple Systems for Scripting Enter the following commandGenerating Host Keys Adding Public Keys Creating Trusted Host RelationshipsEnable access for clients by launching a Bash shell Enabling SSH Access Using Trusted HostsExecute the following command Set up your host keys by executing the following commandEnter your password when prompted Enabling SSH Access Using Public KeysCommand Output Guidelines for Writing Server Management Command ScriptsOther Tips For Best Results Console Redirection Over Serial on a Linux-based Server Grub Lilo Getty SecurettyList of gettys currently looks like the following Enabling and Configuring Bios Console Redirection Network Share Volume NSV CD-ROM Network Share Volume Structure1Network Share Volume Compressed Packages 2Extracted Files on the Network Share Volume Serial Over LAN Enabling or Disabling the SOL Feature on the ServerYou can enable or disable the SOL feature through the SP To enable the feature, run the following commandPress Enter Press the tilde key ~ Press the period key Launching an SOL SessionTerminating an SOL Session Press Control-E Press the C key Press the period keyPage Server Management Commands Summary Preface Text Using the ssh ProtocolPreface each command with the following text Interactive Shell on the SPTable A-1Server Management Commands CommandsTable A-2Return Codes Return CodesTable A-2Return Codes Page Table B-1Access Subcommand Groups Access CommandsReturn Codes Access Groups SubcommandsAccess Get Group Subcommand FormatAccess Get Groups Subcommand Table B-4lists the return codes for this subcommandTable B-4Return Codes for Subcommand access get groups Table B-6Arguments for Subcommand access get map Access Map SubcommandsAccess Get Map Subcommand Table B-6lists the arguments for this subcommandTable B-7Return Codes for Subcommand access get map Access Map SubcommandTable B-7lists the return codes for this subcommand Table B-8lists the arguments for this subcommandTable B-9Return Codes for Subcommand access map Access Unmap SubcommandTable B-9lists the return codes for this subcommand Table B-10lists the arguments for this subcommandTable B-11Return Codes for Subcommand access unmap Table B-11lists the return codes for this subcommandTable B-13Argument for Subcommand access disable service Access Directory Services SubcommandsAccess Disable Service Subcommand Table B-13lists the argument for this subcommandTable B-14lists the return codes for this subcommand Access Enable Service SubcommandTable B-16Return Codes for Subcommand access enable service Table B-15lists the arguments for this subcommandTable B-16lists the return codes for this subcommand Table B-15Arguments for Subcommand access enable serviceTable B-17Arguments for Subcommand access get services Access Get Services SubcommandTable B-18Return Codes for Subcommand access get services Table B-18lists the return codes for this subcommandTable B-20Arguments for Subcommand access add trust Access Trust SubcommandsAccess Add Trust Subcommand Table B-20lists the arguments for this subcommandCopy rsakey to /etc/ssh/sshhostrsakey Table B-21Return Codes for Subcommand access add trust Access Delete Trust SubcommandTable B-21lists the return codes for this subcommand Table B-22lists the arguments for this subcommandAccess Get Trusts Subcommand Table B-23lists the return codes for this subcommandTable B-23Return Codes for Subcommand access delete trust Table B-24Return Codes for Subcommand access get trusts Table B-24lists the return codes for this subcommandTable B-25Access Public Key Subcommands Access Public Key SubcommandsAccess Add Public Key Subcommand Table B-26lists the arguments for this subcommandAccess Get Public Key Users Subcommand Table B-27lists the return codes for this subcommandTable B-27Return Codes for Subcommand access add public key Table B-29Arguments for Subcommand access delete public key Access Delete Public Key SubcommandTable B-28lists the return codes for this subcommand Table B-29lists the arguments for this subcommandTable B-30lists the return codes for this subcommand Table B-32Arguments for Subcommand access add user Access User SubcommandsAccess Add User Subcommand Table B-32lists the arguments for this subcommandDescription Deletes a user Access Delete User SubcommandTable B-33lists the return codes for this subcommand Table B-33Return Codes for Subcommand access add userTable B-35Return Codes for Subcommand access delete user Table B-34lists the arguments for this subcommandTable B-35lists the return codes for this subcommand Table B-34Arguments for Subcommand access delete userTable B-36Arguments for Subcommand access get users Access Get Users SubcommandTable B-36lists the arguments for this subcommand Table B-37lists the return codes for this subcommandTable B-39lists the return codes for this subcommand Access Update Password SubcommandDescription Changes the password of an existing user Table B-38lists the arguments for this subcommandAccess Update User Subcommand Table B-40lists the arguments for this subcommandTable B-40Arguments for Subcommand access update user Table B-41Return Codes for Subcommand access update user Table B-40lists the return codes for this subcommandTable C-1Diagnostics Subcommand Groups Diagnostics CommandsDiags Cancel Tests Subcommand Table C-2lists the arguments for this subcommandTable C-2Arguments for Subcommand diags cancel tests Table C-3Return Codes for Subcommand diags cancel tests Table C-3lists the return codes for this subcommandDiags Get State Subcommand Table C-4lists the return codes for this subcommandTable C-4Return Codes for Subcommand diags get state Table C-5Arguments for Subcommand diags get tests Diags Get Tests SubcommandTable C-5lists the arguments for this subcommand Table C-6lists the return codes for this subcommandDiags Run Tests Subcommand Table C-7lists the arguments for this subcommandTable C-7Arguments for Subcommand diags run tests Table C-8Return Codes for Subcommand diags run tests Table C-8lists the return codes for this subcommandDiags Start Subcommand Table C-9lists the return codes for this subcommandTable C-9Return Codes for Subcommand diags start Invalid operation for current state Diags Terminate Subcommand Table C-10lists the return codes for this subcommandTable C-10Return Codes for Subcommand diags terminate Table D-1Inventory Subcommands Groups Inventory CommandsTable D-2lists the arguments for this subcommand Inventory Compare Versions SubcommandTable D-4Arguments for Subcommand inventory get hardware Inventory Get Hardware SubcommandTable D-3lists the return codes for this subcommand Table D-4lists the arguments for this subcommandTable D-5lists the return codes for this subcommand Table D-5Return Codes for Subcommand inventory get hardwareReturn Codes Table D-6Arguments for Subcommand inventory get software Inventory Get Software SubcommandTable D-6lists the arguments for this subcommand Table D-7lists the return codes for this subcommandTable D-8Arguments for Subcommand inventory get all Inventory Get All SubcommandTable D-8lists the arguments for this subcommand Table D-9lists the return codes for this subcommandTable E-1IPMI Subommands Groups Ipmi CommandsTable E-3lists the arguments for this subcommand Ipmi Disable Channel SubcommandDescription Allows you to disable one of two Ipmi channels Table E-2lists the arguments for this subcommandTable E-5lists the return codes for this subcommand Ipmi Enable Channel SubcommandDescription Allows you to enable one of two Ipmi channels Table E-4lists the arguments for this subcommandIpmi Get Channels Subcommand Table E-6lists the return codes for this subcommandTable E-6Return Codes for Subcommand ipmi get channels Ipmi Disable PEF Subcommand Table E-7lists the return codes for this subcommandTable E-7Return Codes for Subcommand ipmi disable pef Ipmi Enable PEF Subcommand Table E-8lists the return codes for this subcommandTable E-8Return Codes for Subcommand ipmi enable pef Table E-9lists the return codes for this subcommand Ipmi Get Global Enables SubcommandIpmi Set Global Enable Subcommand Table E-10Arguments for Subcommand ipmi set global enableTable E-11Information about the aliases Table E-12Return Codes for Subcommand ipmi set global enable Table E-12lists the return codes for this subcommandTable E-13Arguments for Subcommand ipmi reset Ipmi Reset SubcommandTable E-13lists the arguments for this subcommand Table E-14lists the return codes for this subcommandTable F-1Platform Subcommand Groups Platform CommandsPlatform Console Subcommand Platform Console SubcommandsTable F-3Common COM1 Values Table F-4Common Values for Console RedirectionTable F-5Serial-Console Values Ecl0 Table F-6Return Codes for Subcommand platform console Check or set the Bios settings Run the commandRun the command platform set console Table F-6lists the return codes for this subcommandPlatform Get Console Subcommand Following output displays when successfulTable F-8Supplementary Output Table F-9Return Codes for Subcommand platform get console Table F-9lists the return codes for this subcommandPlatform Set Console Table F-10Arguments for Subcommand platform set consoleTable F-11Return Codes for Subcommand platform set console Table F-11lists the return codes for this subcommandPlatform OS State Subcommands Platform Get OS State SubcommandDescription Retrieves the current state of the platform OS Table F-13Return codes for Subcommand platform get os state Table F-13lists the return codes for this subcommandPlatform Set OS State Subcommand Table F-14lists the arguments for this subcommandTable F-14Arguments for Subcommand platform set os state Platform Set OS State Boot Subcommand Table F-15lists the return codes for this subcommandTable F-15Return Codes for Subcommand platform set os state Table F-17lists the return codes for this subcommand Table F-16lists the arguments for this subcommandPlatform Get Power State Subcommand Platform Power State SubcommandsTable F-19lists the return codes for this subcommand Platform Set Power State SubcommandTable F-20lists the arguments for this subcommand Table F-21lists the return codes for this subcommandTable F-20Arguments for Subcommand platform set power state Table F-22Argument for Subcommand platform get hostname Platform Get Hostname SubcommandTable F-22lists the argument for this subcommand Table F-23lists the return codes for this subcommandPlatform Get Product ID Subcommand Table F-24lists the return codes for this subcommandDescription Displays the product ID for the current system Page Table G-1Sensor Subcommand Groups Sensor CommandsSensor Get Subcommand Table G-2Arguments for Subcommand sensor get Table G-2lists the arguments for this subcommandTable G-3Return Codes for Subcommand sensor get Table G-3lists the arguments for this subcommandAppendix G Sensor Commands Sensor Set Subcommand Table G-4lists the arguments for this subcommandTable G-4Arguments for Subcommand sensor set Table G-5Return Codes for Subcommand sensor set Table G-5lists the arguments for this subcommandPage Table H-1Service Processor Subcommand Groups Service Processor CommandsTable H-2SP Date Subcommands SP Date SubcommandsSP Get Date Subcommand Subcommands in Table H-2manage the date and time on the SPDescription Sets the date and time on the SP RTC SP Set Date SubcommandTable H-3lists the return codes for this subcommand Table H-4lists the argument for this subcommandTable H-5Return Codes for Subcommand sp set date Table H-5lists the return codes for this commandTable H-7lists the return codes for this command SP DNS SubcommandsSP Disable DNS Subcommand Description Disables the DNS configuration on the SPTable H-8Arguments for Subcommand sp enable dns SP Enable DNS SubcommandTable H-8lists the arguments for this subcommand Table H-9lists the return codes for this subcommandTable H-10Arguments for Subcommand sp get dns SP Get DNS SubcommandTable H-10lists the arguments for this subcommand Table H-11lists the return codes for this subcommandDescription Clears an existing event using the event ID SP Events SubcommandsSP Delete Event Subcommand Subcommands in Table H-12manage events on the SPSP Get Events Subcommand Table H-14lists the return codes for this subcommandTable H-14Return Codes for Subcommand sp delete event Table H-16Return Codes for Subcommand sp get events Table H-15lists the arguments for this subcommandTable H-16lists the return codes for this subcommand Table H-15Arguments for Subcommand sp get eventsTable H-18lists the argument for this subcommand SP Hostname SubcommandsSP Get Hostname Subcommand Subcommands in Table H-17manage the SP host and domainTable H-19Return Codes for Subcommand sp get hostname SP Set Hostname SubcommandTable H-19lists the return codes for this subcommand Table H-20lists the argument for this subcommandTable H-21Return Codes for Subcommand sp set hostname Table H-21lists the return codes for this subcommandIP Subcommands SP IP SubcommandsSP Get IP Subcommand Table H-23lists the arguments for this subcommandTable H-24Return Codes for Subcommand sp get ip SP Set IP SubcommandTable H-24lists the arguments for this subcommand Description Sets or modifies the SP network configurationTable H-26Return Codes for Subcommand sp set ip Table H-25lists the arguments for this subcommandTable H-26lists the return codes for this subcommand Table H-25Arguments for Subcommand sp set ipJnet Subcommands SP Jnet Address SubcommandsSP Get Jnet Subcommand Table H-28lists the arguments for this subcommandSP Set Jnet Subcommand Table H-29lists the return codes for this subcommandTable H-29Return Codes for Subcommand sp get jnet Table H-31Return Codes for Subcommand sp set jnet Table H-30lists the arguments for this subcommandTable H-31lists the return codes for this subcommand Table H-30Arguments for Subcommand sp set jnetTable H-33lists the return codes for this subcommand SP Locate Light SubcommandsSP Get Locatelight Subcommand Subcommands in Table H-32manage the locatelight switchSP Set Locatelight Subcommand Table H-34lists the return codes for this subcommandTable H-34Return Codes for Subcommand sp set locatelight Description Retrieves the event log file configuration SP Logfile SubcommandsSP Get Logfile Subcommand Subcommands in Table H-35manage the SP log filesTable H-38Arguments for Subcommand sp set logfile SP Set Logfile SubcommandTable H-37lists the return codes for this subcommand Table H-37Return Codes for Subcommand sp get logfileTable H-39Return Codes for Subcommand sp set logfile Table H-39lists the arguments for this subcommandTable H-40Miscellaneous SP Subcommands SP Miscellaneous SubcommandsSP Create Test Events Subcommand Subcommands in Table H-40manage miscellaneous SP functionsTable H-41Return Codes for Subcommand sp create test events SP Get Port 80 SubcommandTable H-41lists the return codes for this command Table H-42lists the arguments for this subcommandTable H-43Return Codes for Subcommand sp get port80 Bios Post CodesTable H-43lists the return codes for this subcommand Table H-44lists the Post codes for the Phoenix BiosTable H-44BIOS Post Codes Table H-44BIOS Post Codes Table H-44BIOS Post Codes Enable hardware interrupts Boot Block Codes for Flash ROM Table H-45lists the boot block codes in Flash ROMTable H-45Boot Block Codes in Flash ROM SP Load Settings Subcommand Table H-46lists the arguments for this subcommandTable H-46Arguments for Subcommand sp load settings Description Returns the status of the overall system SP Get Status SubcommandTable H-47lists the return codes for this subcommand Table H-48lists the arguments for this subcommandSP Get TDULog Subcommand Table H-49lists the return codes for this subcommandTable H-49Return Codes for Subcommand sp get status Table H-50Arguments for Subcommand sp get tdulog Table H-50lists the arguments for this subcommandTable H-52Return Codes for Subcommand sp get tdulog SP Reboot SubcommandTable H-52lists the return codes for this subcommand Table H-53lists the argument for this commandSP Reset Subcommand Table H-54lists the return codes for this commandTable H-54Return Codes for Subcommand sp reboot Table H-55Arguments for Subcommand sp reset Table H-55lists the arguments for this commandTable H-56Return Codes for Subcommand sp reset Table H-56list the return codes for this commandDescription Creates or resets a mount point SP Mount SubcommandsSP Add Mount Subcommand Subcommands in Table H-57manage the SP mount pointsTable H-59Return Codes for Subcommand sp add mount Table H-59lists the return codes for this subcommandDescription Deletes a mount point Table H-60lists the arguments for this subcommandTable H-61lists the return codes for this subcommand SP Delete MountDescription Displays the current mount points on the SP SP Get Mount SubcommandTable H-62lists the arguments for this subcommand Table H-63lists the return codes for this subcommandSP Smtp Subcommands SP Get Smtp Server SubcommandSubcommands in Table H-64manage Smtp communications Table H-66Return Codes for Subcommand sp get smtp server Table H-65lists the arguments for this subcommandTable H-66lists the return codes for this subcommand Table H-65Arguments for Subcommand sp get smtp serverTable H-67Arguments for Subcommand sp set smtp server SP Set Smtp Server SubcommandTable H-67lists the arguments for this subcommand Table H-68lists the return codes for this subcommandSP Get Smtp Subscribers Subcommand Table H-69Arguments for Subcommand sp get smtp sebscribersTable H-70Default Smtp Subscribers Table H-71lists the return codes for this subcommand SP Update Smtp Subscriber SubcommandTable H-73Default Smtp Subscribers Table H-72Arguments for Subcommand sp update smtp subscriberTable H-74lists the return codes for this command SP Snmp Subcommands SP Add Snmp Destination SubcommandSubcommands in Table H-75manage Snmp communications Table H-76lists the argument for this subcommand Table H-77lists the return codes for this subcommandTable H-76Argument for Subcommand sp add snmp-destination SP Delete Snmp Destination Subcommand Table H-78lists the arguments for this subcommandTable H-79lists the return codes for this subcommand Table H-80lists the return codes for this subcommand SP Get Snmp Destinations SubcommandSP Get Snmp Proxy Community Subcommand SP Set Snmp Proxy Community SubcommandTable H-81lists the return codes for this subcommand Table H-83lists the return codes for this subcommand Table H-82lists the argument for this subcommandTable H-85lists the return codes for this command SP SSL SubcommandsSP Disable SSL-Required Subcommand Subcommands in Table H-84manage SSL capabilitiesTable H-86lists the return codes for this command SP Enable SSL-Required SubcommandTable H-87Arguments for Subcommand sp get ssl SP Get SSL SubcommandTable H-87lists the arguments for this subcommand Table H-88lists the return codes for this subcommandTable H-89Arguments for Subcommand sp set ssl SP Set SSL SubcommandTable H-89lists the arguments for this subcommand Table H-90lists the return codes for this subcommandSP Update Subcommands SP Update Flash All SubcommandSubcommands in Table H-91manage the SP flash Table H-93Return Codes for Subcommand sp update flash all Table H-92lists the arguments for this subcommandTable H-93lists the return codes for this subcommand Table H-92Arguments for Subcommand sp update flash allSP Update Flash Applications Subcommand Table H-94lists the arguments for this subcommandTable H-95lists the return codes for this subcommand Table H-96Arguments for Subcommand sp update flash pic SP Update Flash PIC SubcommandTable H-96lists the arguments for this subcommand Table H-97lists the return codes for this subcommandTable H-98Argument for Subcommand sp update diags SP Update Diags SubcommandTable H-98lists the argument for this subcommand Table H-99lists the return codes for this subcommandIndex Page Index Page Index

TABLE A-2Return Codes