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 server.

TABLE D-1 lists the groups of inventory subcommands that you can use to retrieve specific information about hardware or software.


TABLE D-1 Inventory Subcommands Groups

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 all

Returns detailed information for all hardware and software components.




Note - Every command returns a return code upon completion.




Inventory Compare Versions Subcommand

Description: Returns a list of all installed software packages and the version differences with those listed in a release manifest. 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

Command format:

inventory compare versions {-f | --file} RELEASE_MANIFEST_FILE {-v | --verbose} 

TABLE D-2 lists the arguments for this subcommand.


TABLE D-2 Arguments for Subcommand inventory compare versions

Arguments

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.

{-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.


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.



Inventory Get Hardware Subcommand

Description: Returns detailed information for all field-replaceable hardware components. By default, the name, type, OEM, manufacture date, hardware revision and part number display for each component.

Format

Command format:

inventory get hardware {-v | --verbose} [{-H | --noheader}][{-D | --delim <DELIMITER>}]

TABLE D-4 lists the arguments for this subcommand.


TABLE D-4 Arguments for Subcommand inventory get hardware

Arguments

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.


To obtain the board revision, product ID and PRS revision, you can run the following commands:

inventory get hardware -D '|' | awk -F '|' '/PRS/{print $8}'
inventory get hardware -D '|' | awk -F '|' '/PRS/{print $7}' | awk '{print $4}'
inventory get hardware -D '|' | awk -F '|' '/PRS/{print $6}' 

You can also obtain this information by running the sensor get command.

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

Command 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

Arguments

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 All Subcommand

Description: Returns detailed information for all field-replaceable hardware components and all installed or uninstalled software.

Format

Command format:

inventory get all {-a | --all} {-v | --verbose} [{-H | --noheader}][{-D | --delim <DELIMITER>}] 

TABLE D-8 lists the arguments for this subcommand.


TABLE D-8 Arguments for Subcommand inventory get all

Arguments

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-9 lists the return codes for this subcommand.


TABLE D-9 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.