A P P E N D I X D

Inventory Commands

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.