Sun Fire V20z and Sun Fire V40z Servers--Server Management Guide
|
![Table Of Contents Table Of Contents](shared/toc01.gif) ![Previous Chapter Previous Chapter](shared/prev01.gif) ![Next Chapter Next Chapter](shared/next01.gif)
|
The inventory command reports on the inventory of hardware and software for a Sun Fire V20z or Sun Fire V40z server.
TABLE D-1 lists the inventory subcommands that you can use to retrieve specific information about hardware or software.
Note - Every subcommand returns a return code upon completion.
|
TABLE D-1 Inventory Subcommands
Subcommand
|
Description
|
inventory compare versions
|
Returns a list of all installed software packages and the version differences with those listed in a release manifest.
|
inventory get hardware
|
Returns detailed information for all field-replaceable hardware components.
|
inventory get software
|
Returns inventory information for all installed or uninstalled software.
|
inventory get remote-software
|
Returns a list of package versions available for download or installation from a running update server.
|
inventory get all
|
Returns detailed information for all hardware and software components.
|
Inventory Compare Versions Subcommand
Description: Returns a list of all installed software packages and the version differences with those listed in a release manifest or those available on a running update server. You can use this command to verify that your installation is consistent with a supported release and to determine the packages that have been updated in a new release.
Format
inventory compare versions [{-f | --file} RELEASE_MANIFEST_FILE | {{-i | --ipaddress} REMOTE_SERVER_IP] {-p | --port} REMOTE_SERVER_PORT] {-v | --verbose} [{-H | --noheader}] [{-D | --Delim <DELIMITER>}]
TABLE D-2 lists the arguments for this subcommand.
TABLE D-2 Arguments for Subcommand inventory compare versions
Argument
|
Description
|
{-f | --file}
|
The file describing all of the packages and versions within a release of software. These files are at the root directory of an unzipped NSV file and are usually accessed via the share point at /mnt.
|
{-i | --ipaddress}
|
The IP address of a running update server.
|
{-p | --port}
|
The port number used by the update server.
|
{-v | --verbose}
|
Displays additional information, including the path to the matching package on the NSV, the installed package description, and the matching manifest package description.
This option is ignored when comparing to the update server (using the -i and -p options).
|
{ -H | --noheader }
|
Suppresses column headings.
|
{ -D | --Delim }
|
Delimits columns with the specified delimiter. Headings are also delimited unless suppressed. The delimiter can be any character or string.
|
Return Codes
TABLE D-3 lists the return codes for this subcommand.
TABLE D-3 Return Codes for Subcommand inventory compare versions
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
|
Error. The remote software inventory is not available.
|
NWSE_ServiceNotAvailable
|
24
|
Requested service is not available.
|
Inventory Get Hardware Subcommand
Description: Returns information for field-replaceable hardware components. Information returned includes name, device type, attributes, OEM, manufacture date, hardware revision, serial number, and part number for the component.
Format
inventory get hardware [{-v|--verbose}] [{-H|--noheader}] [{-D|--Delim}]
To obtain the board revision, run this command:
inventory get hardware -D : |grep Motherboard|awk -F : '{print $5}'
To obtain the PRS revision, run this command:
inventory get hardware -D : |grep PRS|awk -F : '{print $5}'
Note - You also can use the sensor get command to find this information.
|
The command output, without the -v argument, includes the following information, in columns from left to right:
- Name (of device)
- Type (of device)
- Attributes (miscellaneous information about the component such as CPU speed)
- OEM (manufacturer that distributes the part)
- Manufacture Date
- HW Revision (number)
- Serial #
- Part #
Below is an example of successful output for the command, without the -v argument. (Because of space limitations here, the Hardware Revision, Part #, Serial #, and Attributes columns are omitted.)
localhost # inventory get hardware
Name Type OEM Manufacture Date
CPU 0 DIMM 0 memory 127f000000000000 2000-01-01
CPU 0 DIMM 1 memory 127f000000000000 2000-01-01
CPU 0 DIMM 2 memory 127f000000000000 2000-01-01
CPU 0 DIMM 3 memory 127f000000000000 2000-01-01
DDR 0 VRM memvrm NA
CPU 0 cpu AuthenticAMD NA
Family 15 Model 5 Stepping 1
CPU 0 VRM vrm NA
CPU 1 DIMM 0 memory 127f000000000000 2000-01-01
CPU 1 DIMM 1 memory 127f000000000000 2000-01-01
CPU 1 DIMM 2 memory 127f000000000000 2000-01-01
CPU 1 DIMM 3 memory 127f000000000000 2000-01-01
DDR 1 VRM memvrm NA
CPU 1 cpu AuthenticAMD NA
Family 15 Model 5 Stepping 1
CPU 1 VRM vrm NA
Motherbrd planar S-SCI1431 2004-10-31
PRS Software os 2005-03-16
SCSI backplane scsi_backplane NA
Additional column headings that appear in the output, if you use the -v argument, are:
- MfgAssy#
- MfgAssyRev
- FirmwareID
- FirmwareRev
- SoftwareRev
- SoftwareID
- Identifier
TABLE D-4 lists the arguments for this subcommand.
TABLE D-4 Arguments for Subcommand inventory get hardware
Argument
|
Description
|
{ -v | --verbose }
|
Displays all columns.
|
{ -H | --noheader }
|
Suppresses column headings.
|
{ -D | --Delim }
|
Delimits columns with the specified delimiter. Headings are also delimited unless suppressed. The delimiter can be any character or string.
|
Return Codes
TABLE D-5 lists the return codes for this subcommand.
TABLE D-5 Return Codes for Subcommand inventory get hardware
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.
|
Inventory Get Software Subcommand
Description: Returns the inventory information for all installed or uninstalled software (located on the optional external file system).
Format
inventory get software [{-a | --all}][{-H | --noheader}][{-D | --Delim <DELIMITER>}]
TABLE D-6 lists the arguments for this subcommand.
TABLE D-6 Arguments for Subcommand inventory get software
Argument
|
Description
|
{-a | --all}
|
(Optional) Looks in the directory /sw_images on the service processor for software packages and uninstalled software.
|
{-H | --noheader }
|
Suppresses column headings.
|
{-D | --Delim }
|
Delimits columns with the specified delimiter. Headings are also delimited unless suppressed. The delimiter can be any character or string.
|
Return Codes
TABLE D-7 lists the return codes for this subcommand.
TABLE D-7 Return Codes for Subcommand inventory get software
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.
|
Inventory Get Remote-Software Subcommand
Description: Returns a list of package versions that are available for download or for installation from a running update server.
Format
inventory get remote-software [{-D|--Delim} DELIMITER] [{-H|--noheader}] [{-i|--ipaddress} REMOTE_ADDRESS] [{-p|--port} REMOTE_PORT]
TABLE D-8 lists the arguments for this subcommand.
TABLE D-8 Arguments for Subcommand inventory get remote-software
Argument
|
Description
|
{-i | --ipaddress}
|
The IP address of a running update server.
|
{-p | --port}
|
The port number used by the update server.
|
{ -H | --noheader }
|
Suppresses column headings.
|
{ -D | --Delim }
|
Delimits columns with the specified delimiter. Headings are also delimited unless suppressed. The delimiter can be any character or string.
|
Return Codes
TABLE D-9 lists the return codes for this subcommand.
TABLE D-9 Return Codes for Subcommand inventory get remote-software
Return Code
|
ID
|
Description
|
NWSE_Success
|
0
|
Command successfully completed.
|
NWSE_InvalidUsage
|
1
|
Invalid usage: bad parameter usage, conflicting options specified.
|
NWSE_InvalidArgument
|
4
|
One or more arguments were incorrect or invalid.
|
NWSE_NotFound
|
5
|
Error. The remote software inventory is not available.
|
NWSE_ServiceNotAvailable
|
24
|
Requested service is not available.
|
Inventory Get All Subcommand
Description: Returns detailed information for all field-replaceable hardware components and all installed or uninstalled software.
Format
inventory get all {-a | --all} {-v | --verbose} [{-H | --noheader}][{-D | --Delim <DELIMITER>}]
TABLE D-10 lists the arguments for this subcommand.
TABLE D-10 Arguments for Subcommand inventory get all
Argument
|
Description
|
{-a | --all}
|
(Optional) Looks in the directory /sw_images on the Service Processor for software packages and uninstalled software.
|
{ -v | --verbose }
|
Displays all columns.
|
{ -H | --noheader }
|
Suppresses column headings.
|
{ -D | --Delim }
|
Delimits columns with the specified delimiter. Headings are also delimited unless suppressed. The delimiter can be any character or string.
|
Return Codes
TABLE D-11 lists the return codes for this subcommand.
TABLE D-11 Return Codes for Subcommand inventory get all
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.
|
Sun Fire V20z and Sun Fire V40z Servers--Server Management Guide
|
817-5249-17
|
![Table Of Contents Table Of Contents](shared/toc01.gif) ![Previous Chapter Previous Chapter](shared/prev01.gif) ![Next Chapter Next Chapter](shared/next01.gif)
|
Copyright © 2004-2007, Sun Microsystems, Inc. All Rights Reserved.