Surveys the host system for currently installed microcode or Vital Product Data (VPD).
invscout [ -v ] [ -c ] [ -r ] [ -q ] [ -k ] [ -h ]
The invscout command executes one instance of the stand-alone version of the Inventory Scout process. The invscoutd command starts the server daemon side of a client-server version.
The Inventory Scout process supports two survey types:
and two main actions that you can perform on either of the survey types:
A Microcode Survey gathers data from the host system on currently installed microcode for invscout-supported systems, devices and adapters. This command stores these data in a Microcode Survey Upload File that can be uploaded using the Internet to a Web server. Once on a Web server, a CGI compares them against a database and produces a Web page, reporting information on downlevel microcode and on how and where to obtain the latest versions of supported microcode.
A Microcode Survey also produces a Microcode Survey Formatted Text Report File. This file can be printed or displayed on a monitor and contains a subset of the information recorded in the upload file. This subset includes information about the invscout execution itself and the names and levels of currently installed microcode. The -r flag causes this report also to be sent to the screen from where the command was invoked.
All of the previous reports can contain information on the following:
A VPD Survey stores the system VPD in a VPD Survey Upload File that can be uploaded using the Internet to a Web server. Once on the server, a CGI forwards the file to a repository and produces a Web page indicating the status of the operation.
No formatted text report is available for VPD Surveys.
Survey Results Concatenation
This option concatenates the upload files from two or more executions of the Microcode Survey or the VPD Survey into a single Concatenated Upload File. This file can be uploaded using the Internet to a Web server and processed by the server CGI to give the same results as would have been obtained by uploading and processing all the component files individually. The input files can be any valid upload files, but typically, this operation is done to simplify the task of uploading the results from several host systems.
To concatenate a set of existing Microcode Survey upload files, do the following:
To concatenate a set of existing VPD Survey upload files, do the following:
Each time that invscout is invoked, the command only processes one of the two kinds of concatenation (Microcode or VPD).
This command is valid only on the POWER-based platform.
|-v||Sets the survey type to VPD (the default is Microcode). This survey type applies to both main actions (-c option).|
|-c||Sets the main action to "concatenate existing survey upload files" (the default is "perform a survey").|
|-r||For a Microcode Survey, sends a copy of the formatted text report file to the screen from which the command was invoked. This flag is ignored if either the -v or the -c flag is used.|
|-q||Suppresses most run-time messages.|
|-k||Saves temporary files when the command is complete.|
|-h||Generates a help (usage) statement. If this flag is used, all other flags are ignored.|
This command returns the following exit values:
|0||Indicates successful completion.|
|Non-zero||Indicates an error occurred.|
If an error occurs, the command writes an error log.
Only users with an effective user ID of root can execute this command.
invscout -v -c
|/usr/sbin/invscout||Contains the invscout command.|
|/var/adm/invscout/invs.ldb||Contains the invscout Logic Database.|
|/var/adm/invscout/node.mup||Microcode Survey Upload File that can be uploaded to a web server for processing. The node variable is the node name of the system represented in the file.|
|/var/adm/invscout/invs.mrp||Microcode Survey Formatted Text Report File.|
|/var/adm/invscout/node.vup||VPD Survey Upload File that can be uploaded to a web server for processing. The node variable is the node name of the system represented in the file.|
|/var/adm/invscout/invs.mic.con.inp||Microcode Survey Concatenation Input Directory.|
|/var/adm/invscout/invs.vpd.con.inp||VPD Survey Concatenation Input Directory|
|/var/adm/invscout/invs.con.mup||Microcode Survey Concatenated Upload File.|
|/var/adm/invscout/invs.con.vup||VPD Survey Concatenated Upload File.|
|/var/adm/invscout/invs.err||Error log written if the command encounters an error.|
|/var/adm/invscout/invsd.puk||Public key file.|
|/tmp||Holds invscout temporary files. These files are normally deleted when the command completes but not if the -k flag is specified.|
The invscoutd command.