Sun Fire V20z and Sun Fire V40z Servers--Server Management Guide
|
|
The platform command reports or changes some aspect of the state of the platform.
TABLE F-1 lists the platform subcommands.
Note - Every subcommand returns a return code upon completion.
|
TABLE F-1 Platform Subcommand
Subcommand
|
Description
|
platform console
|
Manages access to the platform serial console.
|
platform os state
|
Manages the current state of the operating system (OS).
|
platform power state
|
Manages the state of the platform power.
|
platform get hostname
|
Displays the host name of the current primary platform.
|
platform get mac
|
Returns the MAC addresses for the two on-board platform NICs.
|
platform get product id
|
Displays the product ID for the current system.
|
Platform Console Subcommands
The subcommands listed in TABLE F-2 allow you to manage access to the platform serial console.
TABLE F-2 Platform Console Subcommands
Subcommand
|
Description
|
platform console
|
Provides access to the platform serial console.
|
platform get console
|
Retrieves the configuration of the service processor (SP) access to the platform serial console.
|
platform set console
|
Configures the SP access to the platform serial console.
|
Platform Console Subcommand
Description: For remote-management capability, this command provides access to the platform serial console. Used in conjunction with the subcommand platform set console and the appropriate BIOS and platform OS settings, this command enables you to view the platform serial console while logged in to the SP.
Format
platform console
You must configure the BIOS settings using the BIOS Setup utility. To refresh the BIOS Setup screen, press the Control-R keys. Choose the Advanced tab to set the configuration.
TABLE F-3 lists common COM1 values. TABLE F-4 lists common values for console redirection.
TABLE F-3 Common COM1 Values
I/O Device Configuration
|
Value
|
Serial port A
|
Enabled
|
Base I/O address
|
3F8
|
Interrupt
|
IRQ 4
|
TABLE F-4 Common Values for Console Redirection
Console Redirection
|
Value
|
Com Port Address
|
On-board COM A
|
Console connection
|
Direct
|
Baud Rate
|
19.2K
|
Flow Control
|
None
|
Console Type
|
ANSI
|
Table listing the common values for console redirection and a description of each.
Note - You can change these values, as long as they are the same as serial-port values for the operating system (OS). If your operating system supports the COM2-4 values, you can set these for the BIOS settings.
|
The serial-console settings in the platform OS should be set to match the BIOS settings.
Enter the following while you are connected to the console:
^Ec character
Where ^E represents the Control-E keys and character is one of the entries in TABLE F-5.
TABLE F-5 Serial-Console Values
Character
|
Function
|
.
|
Disconnects an attach read/write.
|
b
|
Sends a broadcast message.
|
c
|
Toggles flow control.
|
d
|
Takes down a console.
|
e
|
Changes the escape sequence.
|
f
|
Forces an attach read/write.
|
g
|
Groups information.
|
i
|
Dumps information.
|
L
|
Toggles logging on/off.
|
l?
|
Breaks the sequence list.
Note: The first character is a lowercase L.
|
l0
|
Sends a break per configuration file.
Note: The first character is a lowercase L.
|
l1-9
|
Sends a specific break sequence.
Note: The first character is a lowercase L.
|
o
|
Re-opens the tty and log file.
|
p
|
Replays the last 60 lines.
|
r
|
Replays the last 20 lines.
|
s
|
Activates spy read only.
|
u
|
Shows the host status.
|
v
|
Shows the version information.
|
w
|
Shows who is logged on to this console.
|
x
|
Shows the console baud information.
|
z
|
Suspends the connection.
|
<cr>
|
Ignores/aborts the command.
|
?
|
Prints this message.
|
^R
|
Replays the last line.
|
\ooo
|
Sends the character by octal code.
|
Under certain circumstances, it might be necessary to send a serial-break sequence to the platform OS (for example, to simulate the SysRq key when CONFIG_MAGIC_SYSRQ is defined and enabled in a Linux kernel).
To perform this operation, use the following sequence:
^Ecl0
Where ^Ecl0 represents the Control-E keys, followed by the lowercase letter "C," the lowercase letter "L," and the numeral "0".)
The platform console command responds by displaying the string [halt sent], confirming that the break sequence has been generated.
In the event that console output becomes corrupted, ^Ecd ^Eco usually restores proper operation. This problem is normally due to flow-control issues.
Example
The following example lists the steps you would perform to enable and run the platform console command:
1. Check or set the BIOS settings.
2. Run the command:
platform set console -s sp -S 19200 -e
3. Run the command:
platform set console
Return Codes
TABLE F-6 lists the return codes for this subcommand.
TABLE F-6 Return Codes for Subcommand platform console
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
Platform Get Console Subcommand
Description: Retrieves the configuration information regarding the SP access to the platform serial console.
Format
platform get console [{-H|--noheader}] [{-D | --Delim <DELIMITER>}]
TABLE F-7 lists the arguments for this subcommand.
TABLE F-7 Arguments for Subcommand platform get console
Argument
|
Description
|
{-H |--noheader}
|
Suppresses column headers.
|
{ -D | --Delim }
|
Delimits columns with the specified delimiter. Headings are also delimited unless suppressed. The delimiter can be any character or string.
|
The following list shows examples of the output from the successful execution of this command.
- Platform serial port directed to rear panel:
Rear Panel
Platform COMA
- Platform serial port directed to SP; SP serial port directed to rear panel, platform console disabled:
Rear PanelConsole Redirection
SP ConsoleDisabled
- Platform console enabled:
Rear PanelConsole Redirection
SpeedPruningLog Trigger
19200No244 KB
SP ConsoleEnabled
If the external serial port is not connected to the platform and is connected to the SP console, you can access the platform serial console using the platform console subcommand.
TABLE F-8 lists the information that is displayed, depending on whether the rear-panel serial port is connected to the platform or to the SP.
TABLE F-8 Displayed Data for Subcommand platform get console
Column
|
Description
|
Enabled
|
Displays No if the external serial port is connected to the platform. Otherwise, the external serial port is connected to the SP console; you can access the platform serial console through the SP command line by running the subcommand platform console.
|
Speed
|
Indicates the communications speed of the link.
|
Prune
|
Indicates whether ANSI escape code and duplicate information pruning is enabled.
|
Log Trigger
|
Indicates the approximate size at which log rotation occurs (for example, when the file console.0 is removed, the current log is moved to console.0 and a new log file is opened).
Pruning of log-file contents happens only when rotation occurs. The minimum size for a log file is 64 KB; the maximum size is 1024 KB.
|
Return Codes
TABLE F-9 lists the return codes for this subcommand.
TABLE F-9 Return Codes for Subcommand platform get console
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
Platform Set Console Subcommand
Description: Enables you to configure access of the SP to the platform serial console, set the speed of the connection, and limit the size of the log files created.
Format
Two options are available:
- Configure the external serial port so that it is connected to the platform serial console (default configuration).
- Configure the external serial port so that it is connected to the Service Processor serial console.
The default configuration of the external serial port connects it to the platform serial console. Use the following syntax for the default configuration:
platform set console {--serial|-s} platform
Use the following syntax to configure the external serial port so that it connects to the SP serial console. With this configuration, you can access the platform serial console through the command line of the SP by running the platform console subcommand.
platform set console {--serial|-s} sp {{--enable|-e}|{--disable|-d}}][{{--prune|-p}|{--noprune|-n}}][{--speed|-S} {1200|2400|4800|9600|19200|38400|115200}][{--log|-l} size]
TABLE F-10 lists the arguments for this subcommand.
Note - If -s is set to platform, none of the following arguments can be used.
|
TABLE F-10 Arguments for Subcommand platform set console
Argument
|
Description
|
{-S | --speed}
{1200|2400|4800|9600|
19200|38400|115200}
|
Selects the port speed for the platform console. BIOS, the platform OS, and the console must all be configured for the same speed.
|
{-d | --disable}
|
Indicates that the platform console monitor is inactive. Cannot be used with: -e.
|
{-e | --enable}
|
Indicates that the platform console monitor is active. Cannot be used with: -d.
|
{-l | --log} size
|
Select the trigger size in KB for console log rotation.
The acceptable values for log size are between 64 and 1024 inclusive.
|
{-n | --noprune}
|
Indicates that the platform console log should be the raw console data. Cannot be used with: -p.
|
{-p | --prune}
|
Indicates that the platform console log is to be cleaned of ANSI sequences and pruned of duplicated information. Cannot be used with: -n.
|
{-s | --serial}
{sp|platform}
|
Specifies whether the serial port is connected to the platform COMA port, or the SP serial console.
Cannot be used with: -e [platform] -d [platform]
-p [platform] -n [platform] -S [platform] -l [platform].
|
Return Codes
TABLE F-11 lists the return codes for this subcommand.
TABLE F-11 Return Codes for Subcommand platform set console
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_InvalidArgument
|
4
|
One or more arguments were incorrect or invalid.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
NWSE_NoMemory
|
8
|
Insufficient memory.
|
NWSE_DeviceError
|
25
|
Unable to read or write to the device.
|
Platform OS State Subcommands
The subcommands listed in TABLE F-12 enable you to manage the operating system (OS).
TABLE F-12 Platform OS State Subcommands
Subcommand
|
Description
|
platform get os state
|
Retrieves the current state of the platform OS (for example, running, booting, off and so on).
|
platform set os state reboot
|
Reboots the platform into the default OS, BIOS Setup or BIOS Update, or shuts down the platform.
|
platform set os state boot
|
Serves as an alias for the subcommand platform set os state reboot and only functions when the platform power state is off.
|
platform set os state shutdown
|
Shuts down the platform.
|
platform set os state update bios
|
Allows updating the platform BIOS with a new local or remote BIOS image file.
|
If the platform is off, the subcommand platform set os state reboot causes the platform to turn on and boot the OS. If the platform is already running, this command reboots the OS. The subcommand platform set os state reboot waits for the platform to boot.
The subcommand platform set power state ensures that the platform is running. It will not affect the platform if it is running; if the platform is off, it will power on and boot the OS. The subcommand platform set power state waits only for the power to come on. (Refer to Platform Power State Subcommands.)
Platform Get OS State Subcommand
Description: Retrieves the current state of the platform OS.
Format
platform get os state
The values for the current state include:
- Off
- On
- Communicating
- Diagnostics
- Sleeping
- BIOS booting
- BIOS setup
- OS booting
- OS shutting down
When the platform is in the Communicating state (in which the OS is communicating with the SP), if the platform drivers are uninstalled, the SP remains in the Communicating state even though it can no longer communicate with the platform.
Refer to Platform Set OS State Subcommands for more information about setting the state.
Return Codes
TABLE F-13 lists the return codes for this subcommand.
TABLE F-13 Return Codes for Subcommand platform get os state
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request might or might not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
Platform Set OS State Subcommands
This group of subcommands provides the ability to reboot the platform into the default OS, BIOS Setup, or BIOS Update, or to shut down the platform. Rebooting to BIOS Setup enables you to configure the BIOS parameters while BIOS Update enables you to reflash the BIOS image.
In order to shut down the platform, the platform drivers must be installed (unless you use the -f argument). Using this subcommand, you can smoothly shut down the platform and allow the OS to shut off power.
Platform Set OS State Reboot
Description: Enables you to reboot the platform. If the platform is running, this subcommand reboots the OS.
Format
platform set os state reboot [{-W | --nowait}][{-b | --bios}] [{-d | --device}][{-f|--forced}] [-q | --quiet]
TABLE F-14 lists the arguments for this subcommand.
TABLE F-14 Arguments for Subcommand platform set os state reboot
Argument
|
Description
|
[-W | --nowait]
|
If specified, the subcommand returns immediately instead of waiting for the operation to complete.
|
[-b | --bios]
|
Returns to BIOS Setup. Allows you to change BIOS settings. Cannot be used with -d.
|
[-d | --device]
|
Causes the BIOS to first attempt to use the specified device as a boot device, before returning to the configured BIOS boot order. Currently, the only supported device argument is network. Specifying -device network will cause the BIOS to attempt a network boot via the Preboot Execution Environment (PXE). Cannot be used with the -b argument.
|
{-f | --forced}
|
Results in a hard power off. It either forces the power off, or resets the server:
- After a time-out of several minutes, if the platform has not responded, or
- Immediately, if the platform is not in the running OS state (no drivers have been installed or the server has crashed).
|
[-q | --quiet]
|
Suppresses interactive warning messages. No error messages are blocked.
|
Return Codes
TABLE F-15 lists the return codes for this subcommand.
TABLE F-15 Return Codes for Subcommand platform set os state reboot
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
NWSE_Busy
|
9
|
Device or resource is busy.
|
NWSE_FileError
|
18
|
File open, file missing, or a read or write error occurred.
|
NWSE_InvalidOpForState
|
22
|
Invalid operation for current state.
|
Platform Set OS State Boot
Description: Serves as an alias for the subcommand platform set os state reboot. It functions only when the platform power state is off.
Format
platform set os state boot [{-W | --nowait}][{-b | --bios}] [{-d|--device}] [{-f|--forced}] [-q | --quiet]
TABLE F-16 lists the arguments for this subcommand.
TABLE F-16 Arguments for Subcommand platform set os state boot
Argument
|
Description
|
[-W | --nowait]
|
If specified, the subcommand returns immediately instead of waiting for the operation to complete.
|
[-b | --bios]
|
Boots to BIOS Setup instead of the OS. Cannot be used with -d.
|
[-d|--device]
|
Causes the BIOS to first attempt to use the specified device as a boot device, before returning to the configured BIOS boot order. Currently, the only supported device argument is network. Specifying "-device network" will cause the BIOS to attempt a network boot via the Preboot Execution Environment (PXE). Cannot be used with the -b argument.
|
{-f | --forced}
|
Results in a hard power off. This option is ignored
|
[-q | --quiet]
|
Suppresses interactive warning messages. No error messages are blocked.
|
Return Codes
TABLE F-17 lists the return codes for this subcommand.
TABLE F-17 Return Codes for Subcommand platform set os state boot
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
NWSE_Busy
|
9
|
Device or resource is busy.
|
NWSE_InvalidOpForState
|
22
|
Invalid operation for current state.
|
Platform Set OS State Shutdown
Description: Enables you to shut down the platform. This action requires that the platform drivers be installed, unless you execute this subcommand with the argument -f.
Format
platform set os state shutdown [{-W | --nowait}] [{-f|--forced}] [-q | --quiet]
TABLE F-18 lists the arguments for this subcommand.
TABLE F-18 Arguments for Subcommand platform set os state shutdown
Argument
|
Description
|
[-W | --nowait]
|
If specified, the subcommand returns immediately instead of waiting for the operation to complete.
|
{-f | --forced}
|
Results in a hard power off. It either forces the power off, or resets the server:
- After a time-out of several minutes, if the platform has not responded, or
- Immediately, if the platform is not in the running OS state (no drivers have been installed or the server has crashed).
|
[-q | --quiet]
|
Suppresses interactive warning messages. No error messages are blocked.
|
Return Codes
TABLE F-19 lists the return codes for this subcommand.
TABLE F-19 Return Codes for Subcommand platform set os state shutdown
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
NWSE_Busy
|
9
|
Device or resource is busy.
|
NWSE_FileError
|
18
|
File open, file missing, or a read or write error occurred.
|
NWSE_InvalidOpForState
|
22
|
Invalid operation for current state.
|
Platform Set OS State Update-BIOS
Description: Enables you to update the platform BIOS with a new local or remote BIOS image file.
Format
platform set os state update-bios {-f| --filename} BIOS IMAGE {-i| --ipaddress} REMOTE_ADDRESS {-r| --remote} REMOTE_VERSION [{-p| --port} REMOTE_PORT] [{-W| --nowait}] [{-q| --quiet}]
TABLE F-20 lists the arguments for this subcommand.
TABLE F-20 Arguments for Subcommand platform set os state update-bios
Argument
|
Description
|
{-f | --filename}
|
Indicates the name of the file containing the new BIOS image to be used for updating the BIOS.
|
{-i | --ipaddress}
|
The IP address of the server on which the update server (Java application) is running.
|
{-r | --remote}
|
Specifies a version (for example, V1.2.3.4) or use LATEST to update using the latest version available on the update server.
|
{-p | --port}
|
Optional. The port number on the remote server on which the java sp update program is listening for SP flash update requests.
If the port number is not provided, the command tries to connect to the default port. The default port number is 52708.
|
[-W | --nowait]
|
If specified, the subcommand returns immediately instead of waiting for the operation to complete.
|
[-q | --quiet]
|
Suppresses interactive warning messages. No error messages are blocked.
|
If the platform is off, the subcommand platform set os state reboot causes the platform to turn on and boot the OS. If the platform is already running, this command reboots the OS. The subcommand platform set os state reboot waits for the platform to boot.
The subcommand platform set power state ensures that the platform is running. It will not affect the platform if it is running; if the platform is off, it will power on and boot the OS. The subcommand platform set power state waits only for the power to come on. (Refer to Platform Power State Subcommands.)
Return Codes
TABLE F-21 lists the return codes for this subcommand.
TABLE F-21 Return Codes for Subcommand platform set os state update-bios
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_NotFound
|
5
|
Entity (user, service, file, path or other) was not found.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
NWSE_FileError
|
18
|
File open, file missing, or a read or write error occurred.
|
NWSE_InvalidOpForState
|
22
|
Invalid operation for current state.
|
NWSE_ServiceNotAvailable
|
24
|
Requested service is not available.
|
Platform Power State Subcommands
The subcommands listed in TABLE F-22 enable you to manage the platform power.
TABLE F-22 Platform Power State Subcommands
Subcommand
|
Description
|
platform get power state
|
Provides the ability to determine the platform power state (for example, whether it is on or off).
|
platform set power state
|
Provides the ability to turn the platform power on or off.
|
The subcommand platform set power state does not affect the platform if the platform is already on; if the platform is off, it powers on and boots the OS. In other words, the subcommand platform set power state ensures that the platform is on, but does not reboot the platform if it is not on.
The subcommand platform set os state waits for the platform to boot; the subcommand platform set power state only waits for the power to come on.
Platform Get Power State Subcommand
Description: Provides the ability to determine the platform power state from within a script (whether the platform is on or off).
Format
platform get power state
Return Codes
TABLE F-23 lists the return codes for this subcommand.
TABLE F-23 Return codes for Subcommand platform get power state
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
Platform Set Power State Subcommand
Description: Enables you to turn the platform power on or off from within a script. This subcommand does not notify the platform OS of the request through the supplied channels.
The subcommand platform set power state either removes power abruptly, or forces the platform into a panic shutdown.
It is the same as pressing the Power button for less than one second or for more than five seconds (-f argument).
Note - Equally effective, less-destructive commands are available. If the platform drivers are installed, use the subcommand platform set os state shutdown to shut down the server gracefully. For more information, see Platform Set OS State Shutdown.
|
Format
platform set power state [{-W|--nowait}] [{-f|--forced}] [{-t|--timeout} TIME] {off|on|cycle}
TABLE F-24 lists the arguments for this subcommand.
TABLE F-24 Arguments for Subcommand platform set power state
Argument
|
Description
|
{-W | --nowait}
|
If specified, the command returns immediately instead of waiting for the operation to complete.
|
{-f | --forced}
|
Results in a hard power off.
|
{-t | --timeout}
|
Specifies the maximum time to wait for the operation to complete (in seconds).
|
{off | on | cycle}
|
Specifies whether to turn the platform power on or off or to cycle. Specifying the cycle argument causes platform power to be turned off, then on.
|
If the platform is off, the subcommand platform set os state reboot causes the platform to turn on and boot the OS. If the platform is already running, this command reboots the OS. The subcommand platform set os state reboot waits for the platform to boot. (Refer to Platform Set OS State Subcommands.)
The subcommand platform set power state ensures that the platform is running. It will not affect the platform if the platform is running; if the platform is off, it will power on and boot the OS. The subcommand platform set power state waits only for the power to come on.
Return Codes
TABLE F-25 lists the return codes for this subcommand.
TABLE F-25 Return Codes for Subcommand platform set power state
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_RPCTimeout
|
2
|
Request was issued, but was not serviced by the server. RPC procedure timed out and the request may or may not have been serviced by the server.
|
NWSE_RPCNotConnected
|
3
|
Unable to connect to the RPC server.
|
NWSE_NoPermission
|
6
|
Not authorized to perform this operation.
|
NWSE_MissingArgument
|
7
|
Missing argument(s).
|
NWSE_TimedOut
|
23
|
Operation timed out.
|
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
platform get hostname [{-H|--noheader}]
TABLE F-26 lists the argument for this subcommand.
TABLE F-26 Argument for Subcommand platform get hostname
Argument
|
Description
|
{-H | --noheader}
|
Suppresses column headers.
|
Return Codes
TABLE F-27 lists the return codes for this subcommand.
TABLE F-27 Return 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.
|
Platform Get MAC Subcommand
Description: Returns the MAC addresses for the two on-board platform network interface cards (NICs).
Format
platform get mac
Return Codes
TABLE F-27 lists the return codes for this subcommand.
TABLE F-28 Return Codes for Subcommand platform get mac
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_ServiceNotAvailable
|
24
|
Requested service is not available.
|
Platform Get Product-ID Subcommand
Description: Displays the product ID for the current system.
Format
platform get product-id
Note - You can also retrieve the product ID, board revision number, and Power and Reset Sequencer (PRS) revision number by running the subcommands sensor get and inventory get hardware.
|
Return Codes
TABLE F-29 lists the return codes for this subcommand.
TABLE F-29 Return Codes for Subcommand platform get product-id
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_NotFound
|
5
|
Entity (user, service, file, path or other) was not found.
|
NWSE_FileError
|
18
|
File open, file missing, or a read or write error occurred.
|
NWSE_ServiceNotAvailable
|
24
|
Requested service is not available.
|
Sun Fire V20z and Sun Fire V40z Servers--Server Management Guide
|
817-5249-17
|
|
Copyright © 2004-2007, Sun Microsystems, Inc. All Rights Reserved.