rug - Die Befehlszeilenschnittstelle für den Novell ZENworks Linux Management-Agenten.
rug ist die Befehlszeilenschnittstelle zum ZENworks Linux Management-Agenten ( Je nach eingegebenen Befehl wird über diese Schnittstelle in Verbindung mit dem ZENworks Linux Management-Daemon Software installiert, aktualisiert oder entfernt. Die Software, die installiert wird, kann aus ZENworks 7.x Linux Management-Servern, ZENworks 6.6. x Linux Management-Servern, YUM-Repositorys, aus dem ZYPP-Dienst sowie aus lokalen Dateien stammen.
Auf ZENworks Linux Management-Servern sind Softwareprogramme nach Kategorien in Katalogen, d. h. in Gruppen ähnlicher Programme, sortiert. Beispielsweise kann ein Katalog Software vom Hersteller des Betriebsssystems und ein anderer Katalog den SUSE Linux Enterprise Desktop enthalten. Sie können einzelne Kataloge abonnieren und damit steuern, welche Pakete als verfügbar angezeigt werden. Auf diese Weise verhindern Sie die versehentliche Installation unerwünschter Software. Standardmäßig erfolgen alle Vorgänge an der Software der abonnierten Kataloge. Diese Voreinstellung können Sie allerdings mit dem Flag --allow-unsubscribed ändern. Das Dienstprogramm rug bietet weitere Funktionen, wie z. B. Rollback, Sperren, Verlauf und Voreinstellungen, zur einfachen Verwaltung von Paketen und Bundles.
Je nach Typ des verwalteten Geräts kann der Speicherort des Dienstprogramms rug variieren.
Bei Geräten mit SUSE Linux Enterprise Server 10 (SLES 10) und SUSE LINUX Enterprise Desktop 10 (SLED 10) befindet sich das Dienstprogramm rug im folgenden Verzeichnis:
/usr/bin
Auf allen anderen verwalteten Geräten wird das Dienstprogramm rug im folgenden Verzeichnis installiert:
/opt/novell/zenworks/bin
Dieser Abschnitt enthält eine allgemeine Anleitung zur Formatierung und Verwendung der Befehle.
Wenn für Befehle, die ein Ordnerargument benötigen, kein Ordner angegeben ist, wird das Stammverzeichnis verwendet. Zur Angabe des Ordnerpfads geben Sie die einzelnen Ordner ausgehend vom Stammverzeichnis jeweils getrennt durch einen Schrägstrich (/) ein. Befindet sich beispielsweise ein Ordner namens folder1 direkt im Root-Verzeichnis und dieser enthält wiederum einen Unterordner namens subfolder, dann würden Sie den Pfad des Unterordners wie folgt eingeben: folder1/subfolder1. Die genannten Ordner müssen bereits vorhanden sein.
Drei Punkte weisen daraufhin, dass ein Befehl mehrere Einträge für den letzten Argumenttyp akzeptiert. Beispielsweise geben die drei Punkte im folgenden Befehl an, dass catalog-add-bundle mehrere Bundles akzeptieren kann:
rug bundle-history [optionen] [suchzeichenfolge] [...]
Bei Befehlen, die über keine befehlsspezifischen Optionen verfügen (d. h., sie akzeptieren nur die Standard-Optionsflaggen), sind in der Befehlsreferenz keine Optionen als Argumente aufgeführt. Beispielsweise listet der Referenzeintrag für den folgenden Befehl keine Optionen auf, da er nur die Standardflags akzeptiert:
rug list-updates (lu) [katalog]
Jedoch listet der folgende Befehl Optionen auf, da er eine befehlsspezifische Option (-a) aufweist:
rug bundle-history [optionen] [suchzeichenfolge] [...]
rug verfügt über eine Reihe von Befehlen (unter [befehl] im Abschnitt Syntax aufgeführt). Jeder Befehl akzeptiert die im Abschnitt Globale Optionen aufgeführten Optionsflags. Außerdem verfügen viele Befehle über spezifische Optionsflags, die mit den Befehlen aufgeführt werden.
Der am häufigsten verwendete Befehl lautet rug update. Damit laden Sie Updates herunter und installieren sie in Katalogen, für die Sie ein Abonnement besitzen.
Durchsucht die Bundle-Protokolleinträge nach den in [suchzeichenfolge] angegebenen Zeichenfolgen. Akzeptiert die folgenden Optionsflaggen:
Installiert die angegebenen Bundles. rug sucht die Bundles in den von Ihnen abonnierten Katalogen. Mithilfe von bundle-upgrade können Sie bereits installierte Bundles aktualisieren. Akzeptiert die folgenden Optionsflaggen:
HINWEIS:Die Option -N ist mit Datei-Bundles nicht verwendbar.
Listet die verfügbaren Bundles der abonnierten Kataloge auf.
Die Ausgabe für diesen Befehl wird in den folgenden Spalten wiedergegeben: „Status“, „Katalog“, „Name“, „Version“ und „Typ“. Die Spalten geben die Details für jedes Bundle an, das dem verwalteten Gerät zugewiesen oder für dieses verfügbar ist. Die Spalten „Katalog“, „Name“, „Version“ und „Typ“ geben jeweils den Katalognamen, den Bundle-Namen, die Bundle-Version und den Bundle-Typ an.
Das Feld „Status“ ist leer, wenn das Bundle nicht installiert ist, es zeigt „i“ an, wenn das Bundle installiert ist, „v“, wenn das Bundle installiert ist, jedoch eine andere Version besitzt als in der Liste angezeigt, und „*“, wenn das Bundle teilweise installiert ist.
Standardmäßig zeigt der Befehl den Namen des Anzeige-Bundles an.
Akzeptiert die folgenden Optionsflaggen:
Fügt eine Bundle-Sperrregel hinzu. Dadurch werden Änderungen am Installationszustand des Bundles verhindert, das nicht in der Sperre angegeben ist. Der Bundle-Name kann individuell, mit Platzhaltern oder sogar mit Versionsnummern angegeben werden. Der Befehl rug bla gnome* verhindert beispielsweise, dass Bundles, die mit „gnome“ beginnen, entfernt werden. Akzeptiert die folgenden Optionen:
-c, --catalog - Abzugleichender Katalog in Sperre.
Löscht die durch ihre Nummer angegebene Bundle-Sperre. Sie finden die Nummer für jede Bundle-Sperre mit dem Befehl lock-list (bll).
Listet die eingerichteten Sperren auf. Sperren werden nach ID-Nummer sortiert.
Entfernt die angegebenen Bundles. Akzeptiert die folgenden Optionsflaggen:
Sucht nach Bundles, die der Suchzeichenkette entsprechen. Akzeptiert die folgenden Optionsflaggen:
Listet die verfügbaren Bundle-Typen auf.
Aktualisiert die angegebenen Bundles. Akzeptiert die folgenden Optionsflaggen:
Listet die für die hinzugefügten Dienste verfügbaren Kataloge auf. Akzeptiert die folgenden Optionsflaggen:
-u, --uri - Zeigt die Dienst-URI an.
Abonniert die angegebenen Kataloge. Die Kataloge müssen in den von Ihnen hinzugefügten Diensten enthalten sein. Akzeptiert die folgenden Optionsflaggen:
Kündigt die angegebenen Kataloge. Akzeptiert die folgenden Optionsflaggen:
Zeigt die Dateien in einem bestimmten Datei-Bundle an. Akzeptiert die folgende Optionsflagge:
Zeigt die Pakete in einem gegebenen Bundle an. Akzeptiert die folgende Optionsflagge:
Wenn die Option „--show-nevra“ nicht festgelegt wird, wird die Ausgabe für diesen Befehl in den Spalten „Status“, „Katalog“, „Name“, „Version“ und „Architektur“ angezeigt. Diese enthalten die Details von jedem Paket, das Bestandteil des entsprechenden Bundles ist. „Katalog“, „Name“, „Version“ und „Architektur“ geben jeweils den Katalognamen, den Paketnamen, die Paketversion und die Paketarchitektur an. Das Feld „Status“ ist leer, wenn das Paket nicht installiert ist, es zeigt „i“ an, wenn das Paket installiert ist, „v“, wenn das Paket installiert ist, jedoch eine andere Version besitzt als in der Liste angezeigt.
Die Beschreibung dieser Spalten gilt auch für andere Paketbefehle.
Wenn die Option „--show-nevra“ nicht festgelegt wird, wird die Ausgabe für diesen Befehl in den Spalten „Status“, „Katalog“, „Name“, „Epoche“, „Version“ „Release“ und „Architektur“ angezeigt.
Fügt einen Checkpoint hinzu. Wird kein Datum angegeben, wird ein Checkpoint mit dem aktuellen Datum hinzugefügt.
Entfernt die angegebenen Checkpoints.
Ruft eine Liste der gespeicherten Checkpoints ab.
Ruft einen Auszug der Systeminformationen als SQLite-Datenbank ab.
Listet die Dateien in einem Paket auf.
Durchsucht den Paketverlauf nach dem angegebenen Suchbegriff. Standardmäßig werden die Paketnamen nach dem Suchbegriff durchsucht und der Paketversionsverlauf wird angezeigt. Mit den folgenden Optionsflaggen können Sie diese Standardeinstellung ändern:
Zeigt umfassende Informationen zum angegebenen Paket an. Akzeptiert die folgenden Optionsflaggen:
Listet alle Konflikte des angegebenen Pakets auf.
Listet alle veralteten Elemente des angegebenen Pakets auf.
Listet die Informationen auf, die vom angegebenen Paket bereitgestellt werden.
Listet die Paketanforderungen auf. Akzeptiert die folgenden Optionsflaggen:
Installiert die angegebenen auflösbaren Objekte. Wenn der Benutzer ein Paket unter Angabe der Version anfordert, installiert ZMD genau diese Version des Pakets. Wenn keine Paketversion angegeben wird, installiert ZMD die beste Version des Pakets. Auf SLE 10 und SLED 10-Plattformen kann der resolvableType ein Paket, ein Schema oder ein Patch sein. Standardmäßig ist Paket eingestellt. Akzeptiert die folgenden Optionsflaggen:
Zeigt die verfügbaren Updates der angegebenen Kataloge an. Wenn Sie als Argumente Kataloge angeben, wird die Liste auf die angegebenen Kataloge eingegrenzt. Falls Sie einen Katalog nicht abonniert haben, werden keine Updates als verfügbar angezeigt, selbst wenn Sie den Katalog als Argument angeben. Um die Updates eines Kanals aufzulisten, muss der Katalog abonniert sein.
Möglicherweise stimmt die Ausgabe dieses Befehls nicht mit der Liste der ausstehenden Updates auf dem Server überein. Dies liegt daran, dass die Liste auf dem Server die Updates aller verfügbaren Kataloge enthält, nicht nur die vom Client abonnierten Kataloge. Damit beide Listen übereinstimmen, müssen auf dem Client alle verfügbaren Kataloge abonniert sein.
Die folgenden Optionsflaggen werden akzeptiert:
-t, --type - Gibt den Aktualisierungstyp an.
Fügt eine Paketsperrregel hinzu. Dadurch werden Änderungen am Installationszustand des Pakets verhindert, das nicht in der Sperre angegeben ist. Der Paketname kann individuell, mit Platzhaltern oder sogar mit Versionsnummern angegeben werden.
In package_name können sich Platzhalterzeichen befinden. In der folgenden Tabelle werden die gültigen relationalen Operatoren erläutert, die in diesem Befehl mit dem Paket verwendet werden können.
Wenn Sie eine bestimmte Version eines Pakets installieren möchten, prüft ZENworks zunächst, ob die Paketversion gesperrt wurde, und installiert diese nur, wenn das nicht der Fall ist. Angenommen, alle Versionen des Pakets, die neuer sind als „X 1.7“, wurden mithilfe des Befehls rug la X >1.7 gesperrt. Wenn Sie versuchen, mithilfe des Befehls rug in X (1.9) ein Paket mit der Version X 1.9 zu installieren, schlägt die Installation fehl.
Löscht die durch ihre Nummer angegebene Paketsperre. Sie finden die Nummer für jede Sperre mit dem Befehl lock-list (ll).
Listet die eingerichteten Paketsperren auf. Sperren werden nach ID-Nummer sortiert.
Ruft das Paket ab, das die angegebene Datei enthält.
Pakete in einem bestimmten Katalog anzeigen. Wenn kein Katalog oder Kanal angegeben ist, werden die Pakete aller Kataloge aufgelistet. Akzeptiert die folgenden Optionsflaggen:
Wenn die Option „--show-nevra“ nicht festgelegt wird, wird die Ausgabe für diesen Befehl in den Spalten „Status“, „Bundle, „Name“, „Version“ und „Architektur“ angezeigt. Diese enthalten die Details von jedem Paket, das Bestandteil des entsprechenden Bundles ist. „Bundle“, „Name“, „Version“ und „Architektur“ geben jeweils den Bundle-Namen, den Paketnamen, die Paketversion und die Paketarchitektur an. Das Feld „Status“ ist leer, wenn das Paket nicht installiert ist, es zeigt „i“ an, wenn das Paket installiert ist, „v“, wenn das Paket installiert ist, jedoch eine andere Version besitzt als in der Liste angezeigt.
Die Beschreibung dieser Spalten gilt auch für andere Paketbefehle.
Wenn die Option „--show-nevra“ nicht festgelegt wird, wird die Ausgabe für diesen Befehl in den Spalten „Status“, „Bundle“, „Name“, „Epoche“, „Version“ „Release“ und „Architektur“ angezeigt.
Sucht nach Patches, die mit einem Schema übereinstimmen. Akzeptiert die folgenden Optionsflaggen:
Entfernt die angegebenen Pakete. Akzeptiert die folgenden Optionsflaggen:
Führt eine Rücksetzung der Pakettransaktionen zum angegebenen Zeitpunkt und Datum durch. Aktiviert die Rollback-Einstellung, die standardmäßig deaktiviert ist. Die folgenden Optionsflaggen werden akzeptiert:
Sucht nach Paketen, die mit einem Schema übereinstimmen. Akzeptiert die folgenden Optionsflaggen:
Wenn die Option „--show-nevra“ nicht festgelegt wird, wird die Ausgabe für diesen Befehl in den Spalten „Status“, „Katalog, „Bundle“, „Name“, „Version“ und „Architektur“ angezeigt. Diese enthalten die Details von jedem Paket, das Bestandteil des entsprechenden Bundles ist. „Katalog“, „Bundle“, „Name“, „Version“ und „Architektur“ geben jeweils den Katalognamen, den Bundle-Namen, den Paketnamen, die Paketversion und die Paketarchitektur an. Das Feld „Status“ ist leer, wenn das Paket nicht installiert ist, es zeigt „i“ an, wenn das Paket installiert ist, „v“, wenn das Paket installiert ist, jedoch eine andere Version besitzt als in der Liste angezeigt.
Die Beschreibung dieser Spalten gilt auch für andere Paketbefehle.
Wenn die Option „--show-nevra“ nicht festgelegt wird, wird die Ausgabe für diesen Befehl in den Spalten „Status“, „Katalog“, „Bundle“, „Name“, „Epoche“, „Version“ „Release“ und „Architektur“ angezeigt.
Zeigt eine Zusammenfassung der verfügbaren Aktualisierungen für jeden Katalog an.
Lädt Aktualisierungen herunter und installiert sie. Ohne Angabe von Argumenten werden die Updates aller abonnierten Kataloge installiert. Geben Sie den Katalognamen an, damit nur Aktualisierungen für die angegebenen Kataloge installiert werden. Verwenden Sie für einzelne Bundles oder Pakete den Befehl rug install. Falls Sie einen Katalog nicht abonniert haben, werden keine Aktualisierungen als verfügbar angezeigt, selbst wenn Sie den Katalog als Argument angeben. Um die Aktualisierungen eines Katalogs zu installieren, muss der Katalog abonniert sein. Akzeptiert die folgenden Optionsflaggen:
Überprüft die Systemabhängigkeiten. Falls Systemabhängigkeiten zu Konflikten führen, empfiehlt rug die Entfernung bzw. die Installation der zur Lösung der Konflikte erforderlichen Pakete. Akzeptiert die folgenden Optionsflaggen:
Listet Pakete auf, die in Konflikt mit dem angegebenen Element stehen.
Zeigt Pakete an, die die Bibliothek, das Programm oder das Paket enthalten, die bzw. das Sie als [querystring] angegeben haben.
Listet Pakete auf, die die Bibliothek, das Programm oder das Paket benötigen, die bzw. das Sie als [querystring] angegeben haben.
Zeigt die Patches in einem gegebenen Katalog an. Akzeptiert die folgenden Optionsflaggen:
Zeigt detaillierte Informationen für einen Patch an.
Zeigt detaillierte Informationen für ein Muster an.
Zeigt die Muster in einem gegebenen Katalog an. Akzeptiert die folgenden Optionsflaggen:
Listet die den Geräten zugewiesenen gültigen Richtlinien zusammen mit ihren Zeitplandetails auf.
Zeigt den Wert des angegebenen Einstellungs-Token an. Wenn kein Token angegeben ist, werden die Werte aller Einstellungen angezeigt. Akzeptiert die folgende Optionsflagge:
Legt eine Einstellungsvariable fest.
Verwenden Sie rug get, um die Einstellungen und aktuellen Werte anzuzeigen.
Zeigt detaillierte Informationen für ein Produkt an.
Zeigt die Produkte in einem gegebenen Katalog an. Akzeptiert die folgenden Optionsflaggen:
Erweitert die Whitelist-Schlüssel der Liste für einen Dienst.
Entfernt Schlüssel aus der Whitelist für einen Dienst.
Zeigt die Whitelist-Schlüssel für einen Dienst an.
Hängt ein Verzeichnis als Katalog ein. Dem Katalog werden dabei alle Pakete des Verzeichnisses hinzugefügt. Als Katalogplattform wird die Plattform des Servers vorausgesetzt. Akzeptiert die folgenden Optionsflaggen:
Aktualisiert die angegebenen Dienste. Falls kein Dienst angegeben ist, werden alle Dienste aktualisiert. Bevor eine Aktualisierung möglich ist, müssen Sie über den Befehl rug service-add einen Dienst hinzufügen. Verwenden Sie rug service-list, um die aktuelle Liste der Dienste anzuzeigen. Das Dienstargument kann die Nummer des Diensts aus der Ausgabe von service-list sein.
Registriert den Client auf dem angegebenen Server.
Fügt den angegebenen Server als Dienst hinzu. In den meisten Fällen ist die URI die URL des ZENworks Linux Management-Servers, zum Beispiel https://zlmserver. Akzeptiert die folgenden Optionsflaggen:
Löscht die angegebenen Dienste.
Listet die verfügbaren Dienste auf.
Listet die verfügbaren Diensttypen auf.
Löscht den HTTP-Cache.
Lädt ZENworks Management Daemon (zmd)-Module.
Sendet ein Ping an den ZMD-Deamon, der auf dem Client ausgeführt wird.
Startet den ZLM-Daemon neu. Akzeptiert die folgenden Optionsflaggen:
Zeigt geplante Elemente an.
Hält den ZLM-Daemon an. Akzeptiert die folgenden Optionsflaggen:
Bringt den Daemon in den inaktiven Zustand. Die folgenden Optionsflaggen werden akzeptiert:
Bereinigt das YOU-Cacheverzeichnis /var/lib/YaST2/mnt unter SLES 9, Novell Linux Desktop und OES.
Fügt einen neuen Benutzer mit dem angegebenen Benutzernamen und den angegebenen Berechtigungen hinzu. Die folgenden Berechtigungen können erteilt werden: Installieren, Sperre, Entfernen, Abonnieren, Vertrauenswürdig, Aufrüstung, Anzeigen, Superuser. Wenn Sie keine Argumente eingeben, werden Sie danach gefragt. Nach dem Hinzufügen des Benutzers wird automatisch rug user-update gestartet. Verwenden Sie dieses Tool, um zusätzliche Berechtigungen zu erteilen. Die folgenden Optionsflaggen werden akzeptiert:
Löscht die angegebenen Benutzer.
Bearbeitet einen vorhandenen Benutzer. Dieser Befehl ist interaktiv: Er listet zuerst Berechtigungen auf und zeigt dann eine Eingabeaufforderung. Geben Sie ein Plus- (+) oder Minuszeichen (-) und danach den Namen der Berechtigung ein und drücken Sie dann die Eingabetaste. Möchten Sie dem Benutzer beispielsweise die Berechtigung zur Installation von Software erteilen, dann geben Sie +install ein. Zum Speichern und Beenden drücken Sie die Eingabetaste in einer leeren Zeile. Die folgenden Berechtigungen können erteilt oder widerrufen werden: Installieren, Sperre, Entfernen, Abonnieren, Vertrauenswürdig, Aufrüstung, Anzeigen, Superuser.
Listet die Benutzer auf. Um die Benutzerliste anzeigen zu können, müssen Sie entweder über Lese- oder Superuser-Rechte verfügen. Leserechte können mithilfe der Befehle user-add oder user-edit aktiviert werden.
Die folgenden Optionen können bei jeder rug-Transaktion angewendet werden:
Normale Ausgabe (Standardmodus). Diese Einstellung liegt in etwa zwischen Debug-Ausgabe und kompakter Ausgabe.
Kompakte Ausgabe.
Keine Abkürzung.
Stille Ausgabe, druckt nur Fehlermeldungen.
Debug-Ausgabe, druckt vollständige Ausnahmenverfolgung.
Druckt die rug-Version und beendet die Anwendung.
Copyright 2005-2008, Novell, Inc.. Alle Rechte vorbehalten.
zlman (1), zmd (8), zrmservice (1), zlm-debug (1), zlmmirror (1)
Wenn Sie Probleme im Zusammenhang mit dieser Software oder seiner Dokumentation melden möchten, besuchen Sie die Seite Novell Bugzilla.