NAME

swverify − Verify software products

SYNOPSIS

swverify [-v] [-d|-r] [-x option=value] [-X option_file] [-f software_file] [-t target_file]
[-C session_file] [-S session_file] [-Q date] [-J jobid] [software_selections] [ @  target_selections]

Remarks:

SD-UX commands are included with the HP-UX Operating System and manage software on the local host only.  To install and manage software simultaneously on multiple remote hosts (including PCs) from a central controller, you must purchase the HP OpenView Software Distributor (HP Prod. No. B1996AA) which provides extended software management, multi-site software distribution capabilities and distribution to PCs.  While most of the information in this manual page applies to both SD-UX commands and the OpenView product, some applies only to the OpenView product. Where this is the case, you will see:

The following xxx applies only to HP OpenView Software Distributor

DESCRIPTION

The swverify command verifies the software_selections at one or more target_selections (e.g. root filesystems).  When verifying installed software, swverify checks software states, dependency relationships, file existence and integrity, in addition to executing vendor-supplied verification scripts. 

The swverify command also verifies software_selections at one or more target depots.  For target depots, swverify performs all of the checks listed above, but does not execute verification scripts. 

The following sentence applies only to HP OpenView Software Distributor

For PC software verification, the swverify command also verifies software_selections at one or more target PC depots. 

The swverify command also supports these features:

• verify whether installed or configured software is compatible with the hosts on which that software is installed. 

• verify that all dependencies (prerequisites, corequisites) are being met (for installed software) or can be met (for available software). 

• execute vendor-specific verify scripts if the software products are configured.  The most important information that can be conveyed during verification is that information pertaining to the correctness of the product’s configuration - and most of this information must be presented by the vendor in the verify script. 

• report missing files, check all file attributes (ignoring writable files). These attributes include permissions, file types, size, checksum, mtime, link source and major/minor attributes. 

Options

swverify supports the following options:

-v Turns on verbose output to stdout.  (The swverify logfile is not affected by this option.)  Verbose output is enable by default, see the verbose option below. 

-d Operate on a depot rather than installed software. 

-r Operate on an alternate root rather than /.  Verify scripts are not run when verifying software in an alternate root directory.  As of HP-UX release 10.2*, -r is optional but is allowed to maintain compatibility with previous versions. 

-x option=value Set the session option to value and override the default value (or a value in an alternate options_file specified with the -X option).  Multiple -x options can be specified. 

-X option_file Read the session options and behaviors from options_file.

-f software_file Read the list of software_selections from software_file instead of (or in addition to) the command line. 

-t target_file Read the list of target_selections from target_file instead of (or in addition to) the command line. 

-C session_file Save the current options and operands to session_file. You can enter a relative or absolute path with the file name. The default directory for session files is /.sw/sessions/.  You can recall a session file with the -S option. 

-C session_file Save the current options and operands to session_file. You can enter a relative or absolute path with the file name. The default directory for session files is /.sw/sessions/.  You can recall a session file with the -S option. 

-S session_file Execute swverify based on the options and operands saved from a previous session, as defined in session_file. You can save session information to a file with the -C option. 

The -S and -J options apply only to HP OpenView Software Distributor

-Q date Schedules the job for this date.  The date’s format can be changed by modifying the file /var/adm/sw/getdate.templ.

-J jobid Executes the previously scheduled job.  This is the syntax used by the daemon to start the job. 

Operands

The swverify command supports the following syntax for each software_selection:

bundle[.product[.subproduct][.fileset]][,version]

or

product[.subproduct][.fileset][,version]

The version component supports either of these syntaxes:

[,r <op> revision][,a <op> arch][,v <op> vendor][,c <op> category]

or

[instance_id]

where <op> can be: ==, >=, <=, < or *, >, or != which performs individual comparisons on dot-separated fields.  For example, r>=BB.10.00 means choose all revisions that are greater than or equal to BB.10.00. The system will compare each dot-separated field to find matches. Software will only be selected when matches within each field are satisfied. Wildcards are not allowed with these operators. 

The = (equals) relational operator is also allowed to specify a particular version component. 

All version components are repeatable within a single specification (e.g.  r>=A.12, r<A.20). If multiple components are used, the selection must match all components.  No isspace(3) characters are allowed. 

The \* software specification selects all products. 

For complete information, see the sd(4) manual page.

The swverify command supports the following syntax for each target_selection. The : (colon) is required if both a host and directory are specified.

[host][:][/directory]

The following PC information applies only to HP OpenView Software Distributor

The swverify command also supports the syntax:

[pc_controller]

This syntax applies only to PC Controllers.  The pc_controller is a fanout server, and swverify will verify software in its PC depot. 

EXTERNAL INFLUENCES

Defaults File

In addition to the standard options, several swverify behaviors and policy options can be changed by editing the default values found in:

/var/adm/sw/defaults - the system-wide default values,

$HOME/.sw/defaults - the user-specific default values. 

Values must be specified in the defaults file using this syntax:

swverify.option=value

The default values can be overridden by specifying an options file with the -X option, or by specifying -x option=value on the command line. The policy options that apply to swverify are:

agent_auto_exit=true
Causes the target agent to automatically exit after Execute phase, or after a failed Analysis phase.  This is forced to false when the controller is using an interactive UI, or when -p (preview) is used.  This enhances network reliability and performance.  The default is true - the target agent will automatically exit when appropriate.  If set to false, the target agent will not exit until the controller ends the session. 

agent_timeout_minutes=1440
Causes a target agent to exit if it has been inactive for the specified time. The default of 1440 (24 hours) applies only when the interactive UI is used. Usually, the command line controller resets this to 10 minutes.  If you change this value to anything other than 1440, that value will be used even if the controller is using an interactive UI.  When using command line invocation of HP OpenView Software Distributor with multiple targets and you have not changed this value from 1440, the value will be reset to 9 minutes plus the number of targets.

allow_incompatible=false
Causes swverify to generate an ERROR message for each software selection which is not "compatible" with a given target.  (All of the target selections must match the list of supported systems defined for each selected product.)  If set to true, swverify generates a WARNING message instead. 

allow_multiple_versions=false
Causes swverify to generate an ERROR message for each software selection which is one of multiple versions of a product installed on the same root filesystem.  If set to false, swverify will generate a WARNING message instead. 

The following option applies only to HP OpenView Software Distributor

autoremove_job=false
Controls automatic job removal.  If the job is automatically removed, job information (job status or controller/agent logfiles) cannot be queried with swjob. 

autoselect_dependencies=true
Causes swverify to automatically verify requisites when software is being selected.  When set to true, and any software which has requisites is selected for verify, swverify makes sure that the requisites are met.  If they are not already met, they are automatically verified for you.  If set to false, automatic verifications are not made to resolve requisites. 

check_contents=true
Causes swverify to verify the timestamp, size, and checksum attributes of files.  If set to false, these attributes are not verified. 

check_permissions=true
Causes swverify to verify the mode, owner, UID, group, and GID attributes of installed files.  If set to false, these attributes are not verified. 

check_requisites=true
Causes swverify to verify that the prerequisite and corequisite dependencies of the software selections are being met.  If set to false, these checks are not performed. 

check_scripts=true
Causes swverify to run the fileset/product verify scripts for installed software.  If set to false, these scripts are not executed. 

check_volatile=false
Causes swverify to not verify those files marked as volatile (i.e. can be changed).  If set to true, volatile files are also checked (for installed software). 

enforce_dependencies=true
Requires that all dependencies specified by the software_selections be resolved at the target_selections.

The swverify command will generate an ERROR message for each unresolved dependency specified by each software selection.  If set to false, swverify will generate a WARNING message instead. 

The following option applies only to HP OpenView Software Distributor

job_title=
This is an ASCII string giving a title to a job.  It is displayed along with the job ID to provide additional identifying information about a job when swjob

logfile=/var/adm/sw/swverify.log
This is the default command log file for the swverify command. 

logdetail=false[true]
The SD loglevel and logdetail options allow you to choose what amount of information you need in your logfiles - from no detail to complete information. 
 
The loglevel=0 option allows no information to be written to the logfile.  This essentially turns off the logfile process. 
 
The logdetail=true[false] option controls the amount of detail written to the logfile.  Here are the possible combinations of loglevel and logdetail options:

loglevel=1
Controls the log level for the events logged to the command logfile, and the target agent logfile. A value of 0 prevents information from being logged.  A value of 1 enables verbose logging to the logfiles.  A value of 2 enables very verbose logging to the logfiles. 

log_mesgid=0
Controls whether numeric identification numbers are prepended to logfile messages produced by SD. A value of 0 (default) indicates no such identifiers are attached.  Values of 1-4 indicate that identifiers are attached to messages:

• 1 applies to ERROR messages only

• 2 applies to ERROR and WARNING messages

• 3 applies to ERROR, WARNING, and NOTE messages

• 4 applies to ERROR, WARNING, NOTE, and certain other logfile messages. 

mount_all_filesystems=true
By default, the swverify command attempts to automatically mount all filesystems in the /etc/checklist file at the beginning of the analysis phase, to ensure that all listed filesystems are mounted before proceeding.  This policy helps to ensure that files which may be on mounted filesystems are available to be verified. 

If set to false, the mount operation is not attempted, and no check of the current mounts is performed. 

rpc_binding_info=ncadg_ip_udp:[2121]
Defines the protocol sequence and endpoint which will be used to contact swagentd.  This value should be consistent among all hosts that work together.  See sd(5) for details on specifying this option. 

rpc_timeout=5
For HP OpenView Software Distributor, rpc_timeout=7.  Relative length of the communications timeout. This is a value in the range from 0 to 9 and is interpreted by the DCE RPC.  Higher values mean longer times; you may need a higher value for a slow or busy network.  Lower values will give faster recognition on attempts to contact hosts that are not up, or are not running the swagentd.  Each value is approximately twice as long as the preceding value.  A value of 5 is about 30 seconds for ncadg_ip_udp. 

select_local=true
If no target_selections are specified, select the default root directory /, or the default target_directory (when operating on depots), at the local host as the target of the command. 

software=
Defines the default software_selections. There is no supplied default. If there is more than software selection, they must be separated by spaces.

target_directory=/var/spool/sw
Defines the default location of the target depot.

targets=
Defines the default target_selections. There is no supplied default (see select_local above).  If there is more than target selection, they must be separated by spaces. 

verbose=1
Controls the verbosity of the swverify output (stdout).  A value of 0 disables output to stdout.  (Error and warning messages are always written to stderr).  A value of 1 enables verbose messaging to stdout. 

Session File

Each invocation of the swverify command defines a verify session.  The invocation options, source information, software selections, and target hosts are saved before the installation or copy task actually commences.  This lets you re-execute the command even if the session ends before proper completion. 

Each session is automatically saved to the file $HOME/.sw/sessions/swinstall{swcopy}.last.  This file is overwritten by each invocation of swverify. 

You can also save session information to a specific file by executing swverify with the -C session__file option. 

A session file uses the same syntax as the defaults files.  You can specify an absolute path for the session file.  If you do not specify a directory, the default location for a session file is /.sw/sessions/ . 

To re-execute a session file, specify the session file as the argument for the -S session__file option of swverify. 

Note that when you re-execute a session file, the values in the session file take precedence over values in the system defaults file.  Likewise, any command line options or parameters that you specify when you invoke swverify take precedence over the values in the session file. 

Environment Variables

The swverify program sets these environment variables for use by the verify scripts being executed:

LANG

Determines the language in which messages are displayed.  If LANG is not specified or is set to the empty string, a default value of C is used.  See lang(5) for more information. 

NOTE: The language in which the SD agent and daemon log messages are displayed is set by the system configuration variable script, /etc/rc.config.d/LANG.  For example, /etc/rc.config.d/LANG, must be set to LANG=ja_JP.SJIS or LANG=ja_JP.eucJP to make the agent and daemon log messages display in Japanese. 

SW_PATH

A PATH variable which defines a minimum set of commands available to for use in a control script. 

SW_ROOT_DIRECTORY

Defines the root directory in which the session is operating, either "/" or an alternate root directory.  This variable tells control scripts the root directory in which the products are installed.  A script must use this directory as a prefix to SW_LOCATION to locate the product’s installed files. 

SW_LOCATION

Defines the location of the product, which may have been changed from the default product directory.  When combined with the SW_ROOT_DIRECTORY, this variable tells scripts where the product files are located. 

SW_SOFTWARE_SPEC

This variable contains the fully qualified software specification of the current product or fileset.  The software specification allows the product or fileset to be uniquely identified. 

SW_CONTROL_DIRECTORY

Defines the current directory of the script being executed, either a temporary catalog directory, or a directory within in the Installed Products Database (IPD).  This variable tells scripts where other control scripts for the software are located (e.g. subscripts). 

Signals

The swverify command catches the signals SIGQUIT and SIGINT.  If these signals are received, swverify prints a message, sends a Remote Procedure Call (RPC) to the agents to wrap up, and then exits. 

RETURN VALUES

The swverify command returns:

0 The software_selections were successfully verified. 

1 The verify operation failed on all target_selections.

2 The verify operation failed on some target_selections.

DIAGNOSTICS

The swverify command writes to stdout, stderr, and to specific logfiles. 

Standard Output

The swverify command writes messages for significant events.  These include:

• a begin and end session message,

• selection, analysis, and execution task messages for each target_selection.

Standard Error

The swverify command also writes messages for all WARNING and ERROR conditions to stderr. 

Logging

The swverify command logs summary events at the host where the command was invoked.  It logs detailed events to the swagent logfile associated with each target_selection.

Command Log
The swverify command logs all stdout and stderr messages to the the logfile /var/adm/sw/swverify.log. (The user can specify a different logfile by modifying the logfile option.) 

Target Log
A swagent process performs the actual verify operation at each target_selection. When verifying installed software, the swagent logs messages to the file var/adm/sw/swagent.log beneath the root directory (e.g.  / or an alternate root directory).  When verifying available software (within a depot), the swagent logs messages to the file swagent.log beneath the depot directory (e.g.  /var/spool/sw). 

The following line applies only to HP OpenView Software Distributor

Command and target log files can be viewed using the swjob command. 

EXAMPLES

Verify the C and Pascal products installed at the local host:

swverify cc pascal

The following example applies only to HP OpenView Software Distributor

Verify the C and Pascal products on remote hosts:

swverify cc pascal @ hostA hostB hostC

Verify a particular version of HP Omniback:

swverify Omniback,1=/opt/Omniback_v2.0

Verify the entire contents of a local depot:

swverify -d \* @ /var/spool/sw

LIMITATIONS

The SunOS and SD-UX versions of swverify do not support the verification of software products on remote targets. 

The following PC information applies only to HP OpenView Software Distributor

When verifying software at a PC Controller, the swverify command operates only on the available software stored in the PC depot (configured on the PC controller).  Software installed on PC targets can be verified by packaging verify actions (using the PC Console), and distributing that package to PC targets.  The following options do not apply when verifying software at PC depots:

autoselect_dependencies

enforce_dependencies

check_requisites

mount_all_filesystems

target_directory

FILES

/var/adm/sw/

The directory which contains all of the configurable (and non-configurable) data for SD.  This directory is also the default location of logfiles. 

/usr/lib/sw/sys.defaults

Contains the master list of current SD options (with their default values). 

/var/adm/sw/defaults

Contains the active system-wide default values for some or all SD options. 

$HOME/.sw/defaults

Contains the user-specific default values for some or all SD options. 

/var/adm/sw/getdate.templ

Contains the set of date/time templates used when scheduling jobs. 

$HOME/.sw/sessions/

Contains session files automatically saved by the SD commands, or explicitly saved by the user. 

/var/adm/sw/products/

The Installed Products Database (IPD), a catalog of all products installed on a system. 

/var/spool/sw/

The default location of a target software depot. 

PC FILES

The following applies only to HP OpenView Software Distributor

...\SD\DATA\

The directory which contains all of the configurable (and non-configurable) data for SD. 

...\SD\DATA\DEPOT\

The default location of a source and target PC depot. 

AUTHOR

swverify was developed by the Hewlett-Packard Company. 

SEE ALSO

sd(4), sd(5), swacl(1M), swagentd(1M), swcluster(1M), swconfig(1M), swcopy(1M), swgettools(1M), swinstall(1M), swjob(1M), swlist(1M), swmodify(1M), swpackage(1M), swpackage(4), swreg(1M), swremove(1M), update(1M), and the HP OpenView Software Distributor Administrator’s Guide or Managing HP-UX Software with SD-UX manuals. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996