-c |
Lists or edits the SUMA global configuration
settings. The -a flag allows one or more configuration setting
to be updated to the specified value. When used without the -a flag,
all SUMA configuration settings are listed. The configuration
settings that can be edited with the -a flag are as follows:
- FIXSERVER_PROTOCOL
- When communicating with the fix server, this specifies that the
transfer utilizes https (secure). The https protocol is the only supported
protocol and cannot be changed. Default value: https Allowable
value: https
- DOWNLOAD_PROTOCOL
- When downloading file sets, this specifies whether the transfer
utilizes http, or https (secure) transfers. The http protocol takes
advantage of multi-threaded performance and utilizes the download
director protocol (ddp). The https protocol is single-threaded. Default
value: http Allowable values: http, https
- DL_TIMEOUT_SEC
- Specifies the time in seconds to wait for a response from the
fix server during a download operation. Default value: 180 Allowable
values: Whole numbers greater than zero.
- HTTP_PROXY and HTTPS_PROXY
- Proxy server and port to use for the HTTP or HTTPS transfers.
The SUMA command shares the proxy connectivity settings with the Electronic Service Agent™. The HTTP or HTTPS proxy service configuration can be set
up through the SMIT Create/Change Service Configuration menus
(use fastpath smitty srv_conn) that allow the server specifications
such as IP address, port number, and an optional user ID and password.
SUMA no longer supports the settings of the HTTP_PROXY and HTTPS_PROXY
parameters. Default value: blank (disabled) Allowable value: blank
|
-c (Continued) |
- SCREEN_VERBOSE
- Specifies a verbosity level for logging information to stdout
and stderr. Used when the suma command is run from the command
line or the SMIT interface. It is not applicable for scheduled tasks
run from cron. Default value: LVL_INFO Allowable
values:
- LVL_OFF : No information is displayed or logged.
- LVL_ERROR : Displays error messages and other
highly important messages.
- LVL_WARNING : Displays warning messages in addition
to LVL_ERROR messages.
- LVL_INFO : Displays informational messages in
addition to LVL_WARNING messages.
- LVL_VERBOSE : Displays verbose informational
messages in addition to LVL_INFO messages.
- LVL_DEBUG : Displays debug output. This setting
is for debugging purposes and should not be used for normal operations.
- NOTIFY_VERBOSE
- Specifies a verbosity level for the information sent in an email
notification. Only applies to scheduled tasks run from cron.Default
value: LVL_INFO Allowable values: LVL_OFF, LVL_ERROR, LVL_WARNING, LVL_INFO, LVL_VERBOSE, LVL_DEBUG (refer
to the SCREEN_VERBOSE setting
for value descriptions)
- LOGFILE_VERBOSE
- Specifies a verbosity level for the information that is logged
to the log file (/var/adm/ras/suma.log). Note: An LVL_OFF
setting will still log information to the download log file (/var/adm/ras/suma_dl.log).Default
value: LVL_VERBOSE Allowable values: LVL_OFF, LVL_ERROR, LVL_WARNING, LVL_INFO, LVL_VERBOSE, LVL_DEBUG (refer
to the SCREEN_VERBOSE setting
for value descriptions)
- MAXLOGSIZE_MB
- The maximum size (in MB) that a log file is allowed to reach.
Default value: 1 Allowable values: Whole numbers
greater than zero.
- REMOVE_CONFLICTING_UPDATES
- Specifies if lppmgr should remove conflicting updates that
have the same level as base images (lppmgr -u flag) when run
during a clean action. Default value: yes Allowable
values: yes, no
- REMOVE_DUP_BASE_LEVELS
- Specifies whether lppmgr should remove duplicate base levels
(lppmgr -b flag) when run during a clean action. Default value: yes Allowable
values: yes, no
|
-c (Continued) |
- REMOVE_SUPERSEDE
- Specifies whether lppmgr should remove superseded file
set updates (lppmgr -x flag) when run during a clean action.
Default value: yes Allowable values: yes, no
- TMPDIR
- Specifies the directory to store temporary files. Default value: /var/suma/tmp Allowable
values: Any directory that currently exists.
|
-d |
Deletes the SUMA task associated with the given TaskID and
any schedules for this task that were created with the -s flag. |
-D |
Lists or edits the default SUMA task. The -a flag
allows one or more Fields of the default task to be updated
to the specified Value. When used without the -a flag,
the default SUMA task will be listed. |
-l |
Lists SUMA tasks. When used without a TaskID,
all SUMA tasks will be listed. The TaskID can be used to specify
one or more task IDs to list. |
-s CronSched |
Schedules a SUMA task. If specified when a new
task is being created, a save is implied (-w flag functionality).
The CronSched is a list of five space-separated entries (minute,
hour, day, month, weekday) contained in quotation marks. The valid
values for these entries are as follows (see the crontab man
page for additional details): - Minute: 0 - 59
- Hour: 0 - 23
- Day: 1 - 31
- Month: 1 - 12
- Weekday: 0 - 6 (for Sunday - Saturday)
|
-u |
Unschedules a SUMA task. This removes any scheduling
information for the specified TaskID. |
-w |
Writes or saves a SUMA task. If used instead
of the -s flag, the task is saved, allowing scheduling information
to be added later. If used with the -x flag, the task is run
immediately and also saved. |
-x |
Specifies that a SUMA task should be run immediately
and not scheduled. If used without the -w flag, the task is
not saved for future use. |
-a Field=Value ... |
Assigns the specified Value to the specified Field.
For the create or edit operation on a SUMA task, the following are
the supported Fields and Values. - RqType
- When suma is run with an RqType of Latest,
the RqType is the only required field. See example 1 for the
default values that will be used in this case. Other RqType values
(TL, SP, ML, PTF) require specification
of additional Field=Value information.
- ML
- Specifies a request to download a specific maintenance or technology
level. An example is 5300-11.
- TL
- Specifies a request to download a specific technology level. An
example is 6100-03.
- PTF
- Specifies a request to download a PTF. An example is U813941.
Only certain PTFs may be downloaded as an individual file set. For
example, PTFs containing bos.rte.install, bos.alt_disk_install.rte,
or PTFs that come out in between Service Packs. Otherwise, the TL or SP must
be downloaded.
- SP
- Specifies a request to download a specific service pack. An example
is 6100-02-04.
- Latest
- Specifies a request to download the latest fixes. This RqType value
returns the latest service pack of the TL specified in FilterML.
|
-a (Continued) |
- RqName
- The specific name of the item requested (for example, 6100-03 or 6100-04-03).
The RqName field should be blank when RqType equals Latest.
- Repeats
- Specifies whether the task is executed once and does not remain
on the system, repeats until the item is found, or repeats forever.
The Repeats field only applies to scheduled tasks run from
cron that have an Action of Download, Clean,
or Metadata. If run from the command line or if Action is Preview,
this field is ignored, and no task is removed.
- y
- Sets up a repeating task, and requires that the task has been
assigned a CronSched with the -s flag. When the RqType equals TL, SP, PTF,
or ML, the task is removed as soon as the item is found. When RqType equals Latest,
the task is set up to repeat forever.
- n
- Specifies that the task is executed once and does not remain on
the system.
|
-a (Continued) |
- DisplayName
- Indicates the display name for this SUMA task (for example,
Download Latest for 6100-04"). This is used when viewing existing
SUMA tasks in SMIT.
- Action
-
- Preview
- Specifies that a download preview is performed. No file sets are
downloaded.
- Download
- Specifies that file sets are downloaded into the DLTarget based
on the policy.
- Clean
- Specifies that file sets are downloaded into the DLTarget based
on the policy, followed by a clean operation. The lppmgr command
is used to clean file sets that are not needed from the DLTarget.
The three configurable lppmgr flag options listed in the SUMA
global configuration settings are:
- Metadata
- Specifies that metadata files are downloaded instead of file set
updates. The following RqType values are supported:
- TL
- Downloads metadata for a specific technology level.
- SP
- Downloads metadata for a specific service pack.
- Latest
- Downloads metadata for all service packs for the technology level
that is specified for the FilterML flag.
- DLTarget
- Contains the directory location where the downloaded files are
stored. If this field is not specified, it is given the value /usr/sys/inst.images and
the files are stored in a directory based on the image type; for example /usr/sys/inst.images/installp/ppc or /usr/sys/inst.images/RPMS/ppc.
- NotifyEmail
- Contains one or more e-mail addresses (multiple addresses should
be comma-separated) that are sent a notification e-mail after a file
set download or preview. A notification is sent only if the task
is scheduled for execution at a future time (CronSched has
been specified).
|
-a (Continued) |
- FilterDir
- Specifies the name of a fix repository directory to filter against
so that duplicate fixes are not downloaded. This allows a directory
other than the DLTarget to be filtered against. For example,
you may filter against a NIM lpp_source without having to download
into this directory. If left blank, the DLTarget is used.
- FilterML
- Specifies a technology level to filter against; for example, 6100-03.
If not specified, the value returned by oslevel -r on the local
system is used.
- MaxDLSize
- The maximum allowable amount of data to be downloaded by any single
policy execution, in MB. If it is determined that the download operation
exceeds this size, no download occurs. A value of "unlimited" or -1 can
be specified to indicate no upper limit on the amount of data to be
downloaded.
- Extend
- Specifying y automatically extends the filesystem
where the DLTarget resides. If n is specified and
additional space is required for the download, no download occurs.
- MaxFSSize
- The maximum allowable size to which the DLTarget filesystem
can be extended, in MB. If it is determined that the download operation
exceeds this limit, no download occurs. A value of "unlimited" or -1 can
be specified to indicate no upper limit on the size of the filesystem
(that is, the filesystem can be expanded until physical disk space
is exhausted).
|