HP-UX Reference (11i v2 07/12) - 1M System Administration Commands N-Z (vol 4)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

401

402

403

404

405

406

407

408

409

410

swa-step(1M) swa-step(1M)

This command should take one option that is supplied by SWA (the URL of a ﬁle to download), and

outputs that ﬁle to its standard output. If the actual command in your environment behaves

differently, it can be wrapped by a shell script in order to provide the interface that SWA needs.

The command needs to support the protocol speciﬁed by the

catalog_source

option (default

HTTPS) for catalog retrieval and FTP for patch retrieval. See the

catalog_source

option.

Note: Externally used commands are not necessarily supported by HP, but can give considerable

ﬂexibility for your environment. For example, some external commands can authenticate using Win-

dows NT-based domain passwords to a Microsoft web proxy, which is not directly supported by

SWA.

The following command is an example:

swa report -x download_cmd=’ssh user@system curl’

This command uses SSH (see ssh(1)) to run the

curl command on a gateway system. The curl

command is an open source tool that ships with several Linux distributions.

curl may be conﬁgured,

either using a conﬁguration ﬁle on the gateway system or by command-line parameters speciﬁed as

part of the

download_cmd option.

-x ftp_proxy=${proxy}

Usage: Advanced

Applicable steps: catalog download

Proxy host and port (with optional HTTP basic authentication username and password) for accessing

content using the FTP protocol. No proxy information is speciﬁed by default.

The following format is used:

service://[user:password@]proxy-server:port

For example: ftp_proxy=http://web-proxy.mycompany.com:8088

The FTP protocol is used for patch download. Integrity of the patches is checked using MD5 secure

hashes in the catalog, for which the HTTPS protocol is recommended. See the https_proxy

option and the catalog_source

option for details.

The use of

${proxy} for this option value is substituted with the value of the proxy

option (which

is not set by default).

-x html_report=${user_dir}/report/swa_report.html

Usage: Basic

Applicable steps: report

The ﬁle containing the HTML-formatted report that is generated by the

swa report command.

This is a single ﬁle with internal hyperlinks. The HTML report may be printed to standard output

using the

stdout_report_type

option.

The use of

${user_dir} at the beginning of this option value is substituted with the value of the

user_dir option (which defaults to $HOME/.swa ).

-x https_proxy=${proxy}

Usage: Advanced

Applicable steps: catalog download

Proxy host and port (with optional HTTP basic authentication username and password) for accessing

content using the HTTPS protocol. No proxy information is speciﬁed by default.

The following format is used:

service://[user:password@]proxy-server:port

For example: https_proxy=http://web-proxy.mycompany.com:8088

If username and password are speciﬁed as authentication credentials to your proxy server, HTTP

basic authentication is used, which is a clear-text protocol, (that is, your password may be visible to

others on your network). Also, credentials speciﬁed on the command-line are visible to other local

users, and access to credentials stored in extended option ﬁles are determined by their permissions. If

your proxy server requires another type of authentication, see the -x download_cmd option.

402 Hewlett-Packard Company − 6 − HP-UX 11i Version 2: December 2007 Update