Befehl suma
Zweck
Erstellt eine Task für den automatischen Download von Technology Levels und Service-Packs von einem Fix-Server.
Syntax
SUMA-Task erstellen, bearbeiten und planen:
suma { { [ -x ] [-w ] } | -s CronSched } [ -a Feld=Wert ]... [ TaskID ]
SUMA-Tasks auflisten:
suma -l [ TaskID ]...
Standard-SUMA-Task auflisten und bearbeiten:
Globale SUMA-Konfigurationseinstellungen auflisten und bearbeiten:
Planung einer SUMA-Task aufheben:
suma -u TaskID
SUMA-Task löschen:
suma -d TaskID
Beschreibung
Der Befehl suma kann verwendet werden, um die folgenden Operationen für eine SUMA-Task oder -Richtlinie
auszuführen:
- Erstellen
- Bearbeiten
- Auflisten
- Planen
- Planung aufheben
- Löschen
Flags
| Element | Beschreibung |
|---|---|
| -c | Listet die globalen SUMA-Konfigurationseinstellungen auf oder bearbeitet sie. Mit dem Flag -a können Sie eine oder mehrere Konfigurationseinstellungen auf den angegebenen Wert aktualisieren. Wenn das Flag -a nicht angegeben ist, werden alle SUMA-Konfigurationseinstellungen aufgelistet. Die Konfigurationseinstellungen, die mit dem Flag -a bearbeitet werden können, sind im Folgenden beschrieben:
|
| -c (Fortsetzung) |
|
| -c (Fortsetzung) |
|
| -d | Löscht die SUMA-Task, die der angegebenen Task-ID zugeordnet ist, sowie alle Pläne für die Task, die mit dem Flag -s erstellt wurden. |
| -D | Listet Standard-SUMA-Tasks auf oder bearbeitet sie. Mit dem Flag -a können Sie eine oder mehrere Felder der zu aktualisierenden Standardtask in den angegebenen Wert aktualisieren. Wenn Sie das Flag -a nicht verwenden, wird die Standard-SUMA-Task aufgelistet. |
| -l | Listet SUMA-Tasks auf. Wenn keine Task-ID angegeben wird, werden alle SUMA-Task aufgelistet. Der Parameter Task-ID kann verwendet werden, um eine oder mehrere aufzulistende Tasks-ID anzugeben. |
| -s CronSched | Plant (terminiert) eine SUMA-Task. Wenn dieses Flag beim Erstellen einer neuen Task angegeben wird, ist eine Speicheroperation impliziert (Funktion des Flags "-w"). Der Parameter Cron-Plan ist eine in Anführungszeichen eingeschlossene und durch Leerzeichen getrennte Liste mit fünf Einträgen (Minute,
Stunde, Tag, Monat, Wochentag). Die gültigen Werte für diese Einträge sind im Folgenden aufgelistet (weitere Informationen finden Sie in der Man-Page zu crontab):
|
| -u | Hebt die Planung einer SUMA-Task auf. Dadurch werden alle Planungsinformationen für die angegebene Task-ID entfernt. |
| -w | Schreibt oder speichert eine SUMA-Task. Wenn dieses Flag anstelle des Flags -s verwendet wird, wird die Task gespeichert, sodass später Planungsinformationen hinzugefügt werden können. Wenn Sie dieses Flag zusammen mit dem Flag -x verwenden, wird die Task sofort ausgeführt und auch gespeichert. |
| -x | Gibt an, dass eine SUMA-Task sofort ausgeführt und nicht geplant werden soll. Wenn dieses Flag ohne das Flag -w verwendet wird, wird die Task nicht für die künftige Verwendung gespeichert. |
| -a Feld=Wert ... | Weist dem angegebenen Feld den angegebenen Wert zu. Für die Erstellungs- und Bearbeitungsoperationen einer SUMA-Task werden die folgenden Felder und Werte unterstützt.
|
| -a (Fortsetzung) |
|
| -a (Fortsetzung) |
|
| -a (Fortsetzung) |
|
Parameter
| Element | Beschreibung |
|---|---|
| TaskID | Gibt eine eindeutige numerische ID an, die einer Task zugeordnet ist. Diese ID wird zugewiesen, wenn eine Task erstellt wird. |
Exitstatus
| Element | Beschreibung |
|---|---|
| 0 | Der Befehl wurde erfolgreich ausgeführt. |
| >0 | Es ist ein Fehler aufgetreten. |
Beispiele
- Geben Sie Folgendes ein, um die globalen SUMA-Konfigurationseinstellungen aufzulisten:
Es wird eine Ausgabe ähnlich der folgenden angezeigt:suma -cFIXSERVER_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 - Geben Sie Folgendes ein, um die globale SUMA-Konfigurationseinstellung zu bearbeiten, um die maximale Protokolldateigröße in 2 MB zu ändern:
suma -c -a MAXLOGSIZE_MB=2 - Geben Sie Folgendes ein, um die SUMA-Taskstandardwerte aufzulisten:
Es wird eine Ausgabe ähnlich der folgenden angezeigt:suma -DDisplayName= Action=Download RqType=Latest RqName= Repeats=y DLTarget=/usr/sys/inst.images NotifyEmail=root FilterDir=/usr/sys/inst.images FilterML=7200-02 MaxDLSize=-1 Extend=y MaxFSSize=-1 - So erstellen und planen Sie eine Aufgabe, die monatlich die neuesten Korrekturen herunterlädt (z. B. am 15. eines jeden Monats um 2:30 Uhr a.m.), Geben Sie dazu den folgenden Befehl ein:
suma -s "30 2 15 * *" -a RqType=Latest \ -a DisplayName="Latest fixes - 15th Monthly"Hinweis: Für diese neu erstellte Task wird eine Task-ID zurückgegeben. In diesem Beispiel wird angenommen, dass verschiedene Standardwerte für die SUMA-Task aus dem Beispiel für suma -D verwendet werden. Wenn beispielsweise die Taskstandardeinstellung DLTarget=/usr/sys/inst.images verwendet wird, werden die installp-Images in das Verzeichnis /usr/sys/inst.images/installp/ppc heruntergeladen. - Geben Sie Folgendes ein, um SUMA-Planungsinformationen anzuzeigen, die bei der Ausführung des Befehls suma -s Cron-Plan festgelegt wurden:
crontab -l root - So erstellen und planen Sie eine Aufgabe, die einmal pro Woche nach einer bestimmten TL sucht (z. B. jeden Donnerstag um 3 a.m), herunterlädt, sobald es verfügbar ist, und E-Mail-Benachrichtigungen an Benutzer auf einem entfernten System sendet, geben Sie Folgendes ein
suma -s "0 3 * * 4" -a RqType=TL -a RqName=6100-04 \ -a NotifyEmail="bob.smith@host2,ann@host2"Hinweis: Damit diese Aufgabe eine wöchentliche Prüfung für einen TL durchführen kann, muss das Feld Wiederholungen auf y gesetzt werden. In diesem Fall wird die Task gelöscht, nachdem das TL gefunden wurde. Wenn Sie repeats=n angeben, wird nur eine einzige Prüfung durchgeführt, bevor die Task gelöscht wird. - So erstellen und planen Sie eine Aufgabe, die monatlich auf kritische Fehlerbehebungen prüft (z. B. am 20. eines jeden Monats um 4:30 Uhr a.m.), Geben Sie dazu den folgenden Befehl ein:
suma -s "30 4 20 * *" -a RqType=Latest -a RqName= \ -a RqLevel=latest -a Repeats=yHinweis: Wenn Sie Repeats=y einstellen, wird diese Aufgabe "ewig" wiederholt und nach einem erfolgreichen Download nicht gelöscht. - Um eine Aufgabe zu erstellen und zu planen, die die gesamte AIX® 7.1 mit dem 5300-11 Recommended Maintenance-Paket am Montag um 23:00 p.m in das Verzeichnis /lppsrc/5311 herunterlädt, und nach dem Download-Vorgang eine lppmgr-Clean-Operation ausführt, um alle überholten Updates, doppelten Basisebenen und widersprüchlichen Updates zu entfernen, geben Sie Folgendes ein
suma -s "0 23 * * 1" -a Action=Clean -a RqType=ML -a RqName=5300-11 \ -a DLTarget=/lppsrc/5311Hinweis: Bevor Sie eine Aufgabe mit der Angabe Action=Clean ausführen, können Sie suma -c ausführen, um die globalen SUMA-Konfigurationseinstellungen zu überprüfen, die verwendet werden, wenn Sie den Befehl lppmgr ausführen. Wenn in diesem Fall REMOVE_SUPERSEDE, REMOVE_DUP_BASE_LEVELS und REMOVE_CONFLICTING_UPDATES alle auf yes gesetzt sind, führt dies zu der zuvor beschriebenen Aktion. - Um eine Aufgabe zu erstellen und zu planen, die die gesamte AIX 7.1 mit dem 5300-11 Recommended Maintenance-Paket am Montag um 23:00 p.m in das Verzeichnis /tmp/lppsrc/5311 herunterlädt, um alle Aktualisierungen zu filtern, die bereits in /lppsrc enthalten sind, geben Sie Folgendes ein:
suma -s "0 23 * * 1" -a RqType=ML -a RqName=5300-11 \ -a DLTarget=/tmp/lppsrc/5311 -a FilterDir=/lppsrc -a FilterSysFile=/dev/nullHinweis: Nach erfolgreicher Beendigung der Aufgabe wird diese entfernt, da es sich bei RqType=TL um eine "repeat until found"-Aufgabe handelt. Wenn Repeats=n angegeben ist, wird jedoch nur eine einzige Suche nach TL 5300-03 durchgeführt. Wenn der TL nicht auf dem Fix-Server gefunden wird, wird die Task gelöscht, da sie nicht für Wiederholungen konfiguriert ist. - Geben Sie Folgendes ein, um eine Task sofort auszuführen, die eine Vorschau anzeigt, um zu prüfen, ob ein SP auf dem Fix-Server vorhanden ist,
und diese Task für spätere Planung zu erstellen und zu speichern, falls das SP noch nicht vorhanden ist:
suma -x -w -a Action=Preview -a RqType=SP -a RqName=6100-04-02Hinweis: Für diese neu erstellte Task wird eine Task-ID zurückgegeben. - Geben Sie Folgendes ein, um die neu erstellte Task aus dem vorherigen Beispiel (mit der angenommenen Task-ID 23)
sofort auszuführen und zu versuchen, das SP herunterzuladen und die Einstellung
Action=Download für die Task-ID 23 zu speichern:
suma -x -w -a Action=Download 23Hinweis: Da diese Aufgabe von der Befehlszeile aus ausgeführt wird und nicht über Cron geplant ist, wird das Feld Wiederholungen ignoriert und die Aufgabe wird nicht gelöscht, unabhängig davon, ob der SP gefunden wird. - So planen Sie die Aufgabe ID 23 so, dass sie einmal pro Woche wiederholt nach einem bestimmten SP sucht (z. B. jeden Donnerstag um 3 a.m), und laden Sie es herunter, sobald es verfügbar ist, geben Sie Folgendes ein:
suma -s "0 3 * * 4" -a Repeats=y 23Anmerkung: Diese Task wird gelöscht, wenn der SP gefunden wird. - Geben Sie Folgendes ein, um die Planung einer Task aufzuheben, die ihre Planungsinformationen
aus der Crontab-Datei im Verzeichnis /var/spool/cron/crontabs entfernt:
suma -u 23 - Geben Sie Folgendes ein, um eine Task zu löschen, die ihre Planungsinformationen ebenfalls entfernt:
suma -d 23 - Geben Sie Folgendes ein, um mehrere SUMA-Tasks aufzulisten, wobei
4und23Task-IDs darstellen:suma -l 4 23 - Geben Sie Folgendes ein, um alle SUMA-Tasks aufzulisten:
suma -l - So erstellen und planen Sie eine Aufgabe, die monatlich überprüft wird (z. B. am 15. eines jeden Monats um 2:30 Uhr a.m.) nach dem neuesten Service Pack für die angegebene FilterML zu suchen und alle herunterzuladen, die sich noch nicht im /tmp/latest repository befinden, geben Sie Folgendes ein:
suma -s "30 2 15 * *" -a RqType=Latest -a FilterML=6100-02 \ -a DLTarget=/tmp/latest -a FilterDir=/tmp/latestHinweis: Für diese neu erstellte Task wird eine Task-ID zurückgegeben.
Position
/usr/suma/bin/suma
Dateien
| Element | Beschreibung |
|---|---|
| /usr/suma/bin/suma | Enthält den Befehl suma. |
| /usr/sbin/suma | Link zu /usr/suma/bin/suma. |
| /var/adm/ras/suma.log | Enthält detaillierte Ergebnisse zum Ausführen des Befehls suma. |
| /var/adm/ras/suma_dl.log | Enthält eine Liste der heruntergeladenen Dateien. |
| /var/spool/cron/crontabs | Das Verzeichnis, das die Crontab-Datei für die Planung enthält. |