suma Command

Purpose

Creates a task to automate the download of technology levels and service packs from a fix server.

Syntax

To create, edit, or schedule a Service Update Management Assistant (SUMA) task:

suma { { [ -x ] [ -w ] } | -s CronSched } [ -a Field=Value ]... [ TaskID ]

To list SUMA tasks:

suma -l [ TaskID ]...

To list or edit the default SUMA task:

suma -D [ -a Field=Value ]...

To list or edit the SUMA global configuration settings:

suma -c [ -a Field=Value ]...

To unschedule a SUMA task:

suma -u TaskID

To delete a SUMA task:

suma -d TaskID 

Description

Flags

Parameters

Exit Status

Examples

1. To list the SUMA global configuration settings, run the following command:

   suma -c

   Output similar to the following output is displayed:

   FIXSERVER_PROTOCOL=https
   DOWNLOAD_PROTOCOL=http
   DL_TIMEOUT_SEC=180
   DL_RETRY=1
   HTTP_PROXY=
   HTTPS_PROXY=
   SCREEN_VERBOSE=LVL_INFO
   NOTIFY_VERBOSE=LVL_INFO
   LOGFILE_VERBOSE=LVL_VERBOSE
   MAXLOGSIZE_MB=1
   REMOVE_CONFLICTING_UPDATES=yes
   REMOVE_DUP_BASE_LEVELS=yes
   REMOVE_SUPERSEDE=yes
   TMPDIR=/var/suma/tmp 

2. To edit the SUMA global configuration setting to change the maximum log file size to 2 MB, run the following command:

   suma -c -a MAXLOGSIZE_MB=2

3. To list the SUMA task defaults, run the following command:

   suma -D 

   Output similar to the following output is displayed:

   DisplayName=
   Action=Download
   RqType=Latest
   RqName=
   Repeats=y
   DLTarget=/usr/sys/inst.images
   NotifyEmail=root
   FilterDir=/usr/sys/inst.images
   FilterML=7300-02
   MaxDLSize=-1
   Extend=y
   MaxFSSize=-1

4. To create and schedule a task that downloads the latest fixes monthly (for example, on the 15th of every month at 2:30 AM.), run the following command:

   suma -s "30 2 15 * *" -a RqType=Latest \
   -a DisplayName="Latest fixes - 15th Monthly"

   Note: A task ID is returned for this newly created task. This example assumes that some of the SUMA task defaults are used, as displayed in the suma -D example. For example, when the task default of DLTarget=/usr/sys/inst.images, the installp images are downloaded into the /usr/sys/inst.images/installp/ppc directory.
5. To view SUMA scheduling information that is set up by running a suma -s CronSched command, run the following command:

   crontab -l root

6. To create and schedule a task that checks for a specific TL once a week (for example, every Thursday at 3 AM.), downloads it when it becomes available, and sends email notifications to users on a remote system, run the following command:

   suma -s "0 3 * * 4" -a RqType=TL -a RqName=6100-04 \
   -a NotifyEmail="bob.smith@host2,ann@host2"

   Note: To make a weekly check for a TL, the Repeats field needs to be set to y. In this case, after the TL is found, the task is deleted. If Repeats=n, only a single check occurs before deleting the task.
7. To create and schedule a task that checks for critical fixes monthly (for example, on the 20th of every month at 4:30 AM.), run the following command:

   suma -s "30 4 20 * *" -a RqType=Latest -a RqName= \
   -a RqLevel=latest -a Repeats=y 

   Note: By setting Repeats=y, this task 'repeats forever' and is not deleted after a successful download.
8. To create and schedule a task that downloads the entire AIX Version 7.1 with the 5300-11 Recommended Maintenance package into the /lppsrc/5311 directory on Monday at 11:00 PM, and runs an lppmgr command clean operation after the download operation to remove any superseded updates, duplicate base levels, and conflicting updates, run the following command:

   suma -s "0 23 * * 1" -a Action=Clean -a RqType=ML -a RqName=5300-11 \
   -a DLTarget=/lppsrc/5311

   Note: Before running a task that specifies Action=Clean, you can run suma -c to verify the SUMA global configuration settings that are used when you run lppmgr command. In this case, having REMOVE_SUPERSEDE, REMOVE_DUP_BASE_LEVELS, and REMOVE_CONFLICTING_UPDATES all set to yes results in the action described earlier.
9. To create and schedule a task that downloads the entire AIX Version 7.1 with the 5300-11 Recommended Maintenance package into the /tmp/lppsrc/5311 directory on Monday at 11:00 PM, filtering against any updates already contained in /lppsrc, run the following command:

   suma -s "0 23 * * 1" -a RqType=ML -a RqName=5300-11 \
   -a DLTarget=/tmp/lppsrc/5311 -a FilterDir=/lppsrc -a FilterSysFile=/dev/null 

   Note: After the task is successfully completed, the task is removed because RqType=TL is a repeat until found task. However, if Repeats=n, only a single check for the 5300-03 TL is made, and if the TL is not found on the fix server, the task is deleted because it is set up not to repeat.
10. To immediately execute a task that performs a preview to check whether an SP exists on the fix server, and to create and save this task for later scheduling if the SP does not yet exist, run the following command:

    suma -x -w -a Action=Preview -a RqType=SP -a RqName=6100-04-02

    Note: A task ID is returned for this newly created task.
11. To immediately execute the newly created task from the earlier example (assume task ID 23 was returned) and attempt to download the SP and save the Action=Download setting for task ID 23, run the following command:

    suma -x -w -a Action=Download 23

    Note: Because this task is being run from the command line, and not scheduled through cron, the Repeats field are ignored and this task is not deleted regardless of whether the SP is found.
12. To schedule task ID 23 to repeatedly check for a specific SP once a week (for example, every Thursday at 3 AM.), and download it when it becomes available, run the following command:

    suma -s "0 3 * * 4" -a Repeats=y 23

    Note: This task is deleted when the SP is found.
13. To unschedule a task that removes its scheduling information from the crontab file in the /var/spool/cron/crontabs directory, run the following command:

    suma -u 23

14. To delete a task that also removes its scheduling information if it exists, run the following command:

    suma -d 23

15. To list multiple SUMA tasks, where 4 and 23 represent task IDs, run the following command:

    suma -l 4 23

16. To list all SUMA tasks, run the following command:

    suma -l

17. To create and schedule a task that checks monthly (for example, on the 15th of every month at 2:30 AM.) for the latest service pack on the specified FilterML, and download any that are not already in the /tmp/latest repository, run the following command:

    suma -s "30 2 15 * *" -a RqType=Latest -a FilterML=6100-02 \
    -a DLTarget=/tmp/latest -a FilterDir=/tmp/latest

    Note: A task ID is returned for this newly created task.

Location

/usr/suma/bin/suma

Files