Previous section.

Systems Management: Distributed Software Administration
Copyright © 1997 The Open Group

NAME

swconfig - configure software

SYNOPSIS

swconfig [-p][-u][-c catalog][-f file][-t targetfile][-x option=value]
[
-X options_file][software_selections][@ targets]

DESCRIPTION

The swconfig command configures, unconfigures and reconfigures installed software on the target hosts specified on the command line for execution on those hosts.

Configuration primarily involves executing vendor-supplied configure and unconfigure scripts. These scripts configure or unconfigure the installed software. They are only executed on the target hosts that are intended to actually run the software. Software can be configured more than once by rerunning the configure scripts.

Configuration can also be done as part of the swinstall and swremove utilities.

OPTIONS

The swconfig utility supports the following options. Where there is no description, the description in Common Definition for Utilities . applies.

-c catalog

If this option is specified, then use the exported catalog structure at this path as the source of the response files.

If ask=true or ask=as_needed, the control directories in the exported catalog structure are used for both the eventual source of the response files, and the control directory where the request scripts are executed in order to create any needed response files.

-f file

-p

-t targetfile

-u
Undo configuration.

This option tells the swconfig utility to unconfigure the software, instead of configuring it.

-x option=value

-X options_file

OPERANDS

The swconfig utility supports the software_selections and targets operands described in Common Definition for Utilities .

EXTERNAL INFLUENCES

See Common Definition for Utilities for descriptions of external influences common to all utilities.

Extended Options

The swconfig utility supports the following extended options. The description in Common Definition for Utilities applies.

allow_incompatible=false

allow_multiple_versions=false

ask=false

autoselect_dependencies=true

autoselect_dependents=false

enforce_dependencies=true

installed_software_catalog=implementation_defined_valuea

logfile=implementation_defined_value

loglevel=1

reconfigure=false

select_local=true

software="

targets=

verbose=1

EXTERNAL EFFECTS

See Common Definition for Utilities .

EXTENDED DESCRIPTION

See Common Definition for Utilities for general information. There are three key phases in the swconfig utility:

  1. Selection phase

  2. Analysis phase

  3. Execution phase

Selection Phase

Software selections apply to the software installed on the target. Each specified selection is added to the selection list after it passes the following checks:

Add any dependencies to the selection list if autoselect_dependencies=true and the task is configure. Add any dependents to the selection list if the autoselect_dependents=true and the task is unconfigure.

If ask=true then execute the request scripts for the selected software as described in the swask utility. See tagmref_swask extended description.

Analysis Phase

The following checks are made:

Execution Phase

The sequential relationship between the configure operations is shown in the following list. Products are ordered by prerequisite dependencies if any. Fileset operations are also ordered by any prerequisites.

If there is no configure script for a fileset, the state of the fileset is still changed as specified above.

For unconfigure operations, the order of the products and filesets within the products is the reverse of the order of products and filesets for configure. The operations are:

If there is no unconfigure script for a fileset the state of the fileset is still changed as specified above.

Executing Configure Scripts

In this operation, swconfig executes vendor-supplied configure or unconfigure scripts.

The configure scripts are interactive; however, they may access the response file generated by an interactive request script. If any response file has been generated, it will exist in the directory pointed to by SW_CONTROL_DIRECTORY.

EXIT STATUS

See Common Definition for Utilities .

CONSEQUENCES OF ERRORS

See Common Definition for Utilities .

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index