zlmmirror (1)

Name

zlmmirror - Spiegelt Software-Bundles und -Kataloge ganz oder teilweise von entfernten ZENworks® Linux Management-, Yast Online Updates-, Novell Updates-, YUM- und RedHat Network-Servern auf Ihren lokalen ZENworks Linux Management-Server oder in ein lokales Verzeichnis. Detaillierte Informationen zum Spiegeln von Dell-Aktualisierungspaketen auf Ihren ZENworks-Server finden Sie im Abschnitt über das Spiegeln von Software im ZENworks 7.3 Linux Management-Verwaltungshandbuch.

Syntax

zlmmirror [befehl] [optionen] [argumente]

Dieser Befehl liest die erforderlichen Informationen zur Verbindung eines lokalen und eines Fernservers aus einer XML-Konfigurationsdatei. Genauere Informationen zum Erstellen der zlmmirror-Konfigurationsdateien finden Sie im ZENworks 7.3 Linux Management-Verwaltungshandbuch.

Beschreibung

zlmmirror ermöglicht Ihnen die Verbindung mit einem Fernserver und das Kopieren von Softwarekatalogen, -Bundles oder -paketen vom Fernserver auf Ihren eigenen Server mithilfe einiger einfacher Befehle. Die Software kann von den folgenden Servern gespiegelt werden:

  • ZENworks Linux Management

  • Dell-Aktualisierungspakete (DUPs)

  • YaST Online Updates

  • Red Hat Network

  • Red Carpet® Enterprise™ oder ZENworks 6.x Linux Management

  • Novell Updates

  • YUM

Novell®, Dell, SUSE und RedHat verwalten alle Server der entsprechenden Typen. Das ermöglicht Ihnen die einfache Spiegelung der für Sie interessanten Kataloge und Bundles, ohne diese Repositorys zu verwalten oder zu aktualisieren. Spiegeln ist die bevorzugte Methode zum Erhalt der meisten der von Ihnen verteilten Software-Programme auf verwaltete Geräte.

Während des Ausführens stellt zlmmirror eine Verbindung mit dem Fernserver, dem lokalen Server und dem zlman-Programm her und beglaubigt sich dabei jedes Mal. Es sollte auf demselben System wie zlman und der Rest der ZENworks Linux Management-Server ausgeführt werden und erfordert Administratorrechte.

Befehle

Alle der folgenden Befehle akzeptieren die im Abschnitt GLOBALE OPTIONEN aufgeführten Optionsflags. Außerdem werden einzelne Optionen akzeptiert, die für jeden Befehl aufgelistet sind.

Konfigurationsbefehle

Mit diesen Befehlen erstellen, konvertieren und validieren Sie zlmmirror-Konfigurationsdateien.

conf-convert (cc) [Optionen] [zu konvertierende Datei] [Name der konvertierten Datei]

Konvertiert die angegebene rcmirror.conf-Konfigurationsdatei in das neue XML-Format.

conf-generate (cg) [Optionen] [Zieldateiname]

Erstellt eine neue leere Konfigurationsdatei mit allen möglichen Feldern.

conf-validate (cv) [Optionen] [Dateiname]

Überprüft die Konfigurationsdatei auf Fehler und zeigt die analysierten Konfigurationsinformationen an.

Katalog- und Bundle-Befehle

Mit diesen Befehlen zeigen Sie die Kataloge, Bundles und Pakete auf dem Fernserver an.

bundle-list-packages (blp) [optionen] [bundle] [katalog]

Listet die verfügbaren Pakete im angegebenen Bundle auf. Akzeptiert die folgenden Optionsflaggen:

  • -c,--conf=[Dateiname] - Gibt die zu verwendende Konfigurationsdatei an, andernfalls wird die Standarddatei (/etc/opt/novell/zenworks/zlmmirror.xml) verwendet.
  • -t,--target - Schränkt die Liste auf das angegebene Ziel ein.
catalog-list-bundles (clb) [Optionen] [Katalog]

Listet die verfügbaren Bundles im angegebenen Katalog auf. Akzeptiert die folgenden Optionsflaggen:

  • -c,--conf=[Dateiname] - Gibt die zu verwendende Konfigurationsdatei an, andernfalls wird die Standarddatei (/etc/opt/novell/zenworks/zlmmirror.xml) verwendet.
  • -t,--target - Schränkt die Liste auf das angegebene Ziel ein.
catalog-list-packages (clp) [Optionen] [Katalog]

Listet die verfügbaren Pakete im angegebenen Katalog auf. Akzeptiert die folgenden Optionsflaggen:

  • -c,--conf=[Dateiname] - Gibt die zu verwendende Konfigurationsdatei an, andernfalls wird die Standarddatei (/etc/opt/novell/zenworks/zlmmirror.xml) verwendet.
  • -t,--target - Schränkt die Liste auf das angegebene Ziel ein.
server-list-bundles (slb) [Optionen]

Listet die verfügbaren Bundles auf dem Fernserver auf. Akzeptiert die folgenden Optionsflaggen:

  • -p,--packages - Für RCE-Server, bezieht nur Patch-Bundles ein. (Paketsatz-Bundles werden nicht mit einbezogen.)
  • -c,--conf=[Dateiname] - Gibt die zu verwendende Konfigurationsdatei an, andernfalls wird die Standarddatei (/etc/opt/novell/zenworks/zlmmirror.xml) verwendet.
  • -t,--target - Schränkt die Liste auf das angegebene Ziel ein.
server-list-catalogs (slc) [Optionen]

Listet die verfügbaren Kataloge auf dem Fernserver auf. Akzeptiert die folgenden Optionsflaggen:

  • -c,--conf=[Dateiname] - Gibt die zu verwendende Konfigurationsdatei an, andernfalls wird die Standarddatei (/etc/opt/novell/zenworks/zlmmirror.xml) verwendet.
  • -t,--target - Schränkt die Liste auf das angegebene Ziel ein.
server-list-packages (slp) [Optionen]

Listet die verfügbaren Pakete auf dem Fernserver auf. Akzeptiert die folgenden Optionsflaggen:

  • -c,--conf=[Dateiname] - Geben Sie die zu verwendende Konfigurationsdatei an, andernfalls wird die standardmäßige Datei (/etc/opt/novell/zenworks/zlmmirror.xml) verwendet.
  • -t,--target - Schränkt die Liste auf das angegebene Ziel ein.

Spiegelbefehl

Mit diesem Befehl führen Sie den eigentlichen Spiegelungsvorgang aus der Datei zlmmirror.xml durch.

mirror (m) [Optionen]

Führt eine Spiegelung durch. Akzeptiert die folgenden Optionsflaggen:

  • -n, --dryrun - Druckt die zu spiegelnden oder einzubeziehenden Pakete. Es wird keine Spiegelung durchgeführt.
  • -r, --re-download - Lädt die Inhalte erneut herunter, selbst wenn sie bereits gespiegelt wurden.
  • -p, --packagesets - Für RCE- und NU-Server, es werden nur Patch-Bundles einbezogen. (Paketsatz-Bundles werden nicht mit einbezogen).
  • -s, --sync-local - Für einen entfernten ZENworks Linux Management-Server, synchronisiert das Repository des lokalen Servers mit dem Repository des Fernservers.
  • --force-nevra - Lässt zu, dass ein neues Paket mit Konflikt durch NEVRA (Name, Epoche, Version, Release und Architektur) ein vorhandenes Paket überschreibt.
  • -c, --conf=[Dateiname] - Gibt die zu verwendende Konfigurationsdatei an. Wenn keine Konfigurationsdatei angegeben wird, wird die Standarddatei (/etc/opt/novell/zenworks/zlmmirror.xml) verwendet.
  • --category=[Wert] - Gibt Werte wie Sicherheit, Empfohlen oder Optional an. Dieser Wert hat Vorrang vor den Werten, die Sie in der Spiegelungs-Konfigurationsdatei angeben. Dieser Befehl ist für RCE- und NU-Server anwendbar.
  • -o, --remove-obsolete-patches - Entfernt die gespiegelten YOU-Patch-Bundles vom lokalen ZENworks-Server, wenn die Bundles im YOU-Repository veraltet sind. Wenn die YOU-Patch-Bundles in einen Ordner gespiegelt werden, der die veralteten Patches enthält, so werden die veralteten Patches aus diesem Ordner entfernt. Diese Option ist nur für den YOU-Server anwendbar.
  • -g, --retain-guid - Behält die Bundle-GUID beim Spiegeln von Bundles zwischen ZENworks Linux Management Servern bei, die sich in verschiedenen Verwaltungszonen befinden. Standardmäßig werden die Bundles im Verzeichnis Bundles/zlmmirror erstellt. Wenn auf dem lokalen Server ein Bundle mit demselben Namen vorhanden ist, so wird bei der Spiegelung dieses Bundles vom Fernserver die Bundle-GUID nicht beibehalten. Wenn Sie Bundles vom Fernserver aus spiegeln, wird nur das aktuell bereitgestellte Bundle an den lokalen Server gespiegelt. Eine neue Version des Bundles wird am lokalen Server erstellt, unabhängig von der bereitgestellten Version des Bundles am Fernserver.

Optionen

-h , --help

Zeigt eine Hilfemeldung an.

--log=[protokolldatei]

Protokolliert Meldungen in einer Datei. Wenn keine Protokolldatei angegeben wird, wird die Standarddatei (/var/opt/novell/log/zenworks/zlmmirror.log) verwendet.

-v , --Umfassend

Zeigt eine umfassende Ausgabe an.

--version

Druckt zlmmirror-Versionsinformationen und beendet das Programm.

--remote-timeout=[Sekunden]

Verbindungszeitüberschreitung des Fernservers (Sekunden)

Dateien

/etc/opt/novell/zenworks/zlmmirror.xml

Die standardmäßige Konfigurationsdatei.

Sie müssen für jeden gespiegelten Fernserver eine unterschiedliche XML-Konfiguration erstellen. Eine Vorlagen-XML-Datei kann mit dem Befehl conf-generate erstellt werden. Im ZENworks Linux Management-Verwaltungshandbuch finden Sie genauere Anweisungen zum Spiegeln.

Im Folgenden werden die Abschnitte in der zlmmirror-XML-Konfigurationsdatei beschrieben. Folgende Parameter müssen genau spezifiziert werden: der Fernserver (auf dem sich die zu spiegelnde Software befindet), der lokale Server (der ZLM-Server, auf den die Software gespiegelt wird) sowie die zu spiegelnden Kataloge, Bundles und Pakete.

Fernserver

Der Fernserver wird wie folgt festgelegt:

  • <RemoteServer>
  • <Base>https://zlm.novell.com/</Base>
  • <Type>zlm</Type>
  • <User>Administrator</User>
  • <Password>letmein</Password>
  • </RemoteServer>

Basis - Pfad des zu spiegelnden Servers, je nach Typ im folgenden Format:

  • ZLM: https://server

  • DELL: http://ftp.dell.com

  • RCE: https://server/pfad

  • YaST:http(s)://server/pfad oder ftp://server/pfad

  • RHN: http(s)://server/pfad

  • NU: https://nu.novell.com/repo

  • YUM: YUM-Respositorys für SUSE wie http://poincare.suse.de/testrepo/

Type - Typ des zu spiegelnden Servers.

  • ZLM: Novell ZENworks 7 Linux Management

  • DELL: Dell-Aktualisierungspaket-FTP-Server

  • RCE: Red Carpet Enterprise oder ZENworks 6.x Linux Management

  • YaST: YaST-Onlineaktualisierungen

  • RHN: Red Hat Network

  • NU: Novell Updates

  • YUM: Yellow Dog Updater, modifiziert

User - Bei der Verbindung mit dem Fernserver zu verwendender Benutzername. Wenn kein Benutzer angegeben ist, ruft zlmmirror den Benutzernamen je nach Typ von folgendem Ort ab:

  • ZLM: Für SLES 9 und OES unter/etc/opt/novell/zenworks/zmd/deviceid und für SLES 10 und SLED 10 unter /etc/zmd/deviceid

  • RCE: /etc/ximian/mcookie

  • YaST: /etc/sysconfig/onlineupdate

  • NU: Für SLES 9 und OES unter /etc/opt/novell/zenworks/zmd/deviceid und für SLES 10 und SLED 10 unter /etc/zmd/deviceid

  • YUM: Es ist keine Authentifizierung erforderlich.

Lassen Sie dieses Element bei einer Verbindung mit einem RHN- oder Dell-Server leer.

Password - Bei der Verbindung mit dem Fernserver zu verwendendes Passwort. Wenn kein Passwort angegeben ist, ruft zlmmirror das Passwort je nach Typ von folgendem Ort ab:

  • ZLM: Für SLES 9 und OES unter /etc/opt/novell/zenworks/zmd/secret und für SLES 10 und SLED 10 unter /etc/zmd/secret

  • RCE: /etc/ximian/partnernet

  • YaST:/etc/sysconfig/onlineupdate

  • NU: Für SLES 9 und OES unter /etc/opt/novell/zenworks/zmd/secret und für SLES 10 und SLED 10 unter /etc/zmd/secret

  • YUM: Es ist keine Authentifizierung erforderlich.

Lassen Sie dieses Element bei einer Verbindung mit einem RHN- oder Dell-Server leer.

Proxy - Die Angabe dieses Konfigurationselements ist optional; es wird für einen Internet-Proxyserver verwendet. Sie können dieses Element an einer beliebigen Stelle im Abschnitt RemoteServer einfügen. Wenn für den Internet-Proxyserver eine Authentifizierung erforderlich ist, verwenden Sie folgende Syntax:

<Proxy>http://benutzername:password@server:port</Proxy>

Ist keine Authentifizierung erforderlich, verwenden Sie folgende Syntax:

<Proxy>https://server:port</Proxy>

SystemID – Zum Spiegeln vom RHN-Server aus müssen Sie der zlmmirror-Konfigurationsdatei das SystemID-Konfigurationselement hinzufügen. Sie können die Datei systemid verwenden, die eine gültige Authentifizierung für den RHN-Server aufweist. Sie müssen den vollständigen Pfad der Datei systemid angeben, die sich auf dem ZENworks-Server befindet. Das Format entspricht in etwa dem im folgenden Beispiel:

<SystemID> /etc/opt/novell/zenworks/zlmmirror-example-rhn-conf.xml</SystemID>

Lokaler Server

Der lokale Server wird wie folgt festgelegt:

  • <LocalServer>
  • <Base></Base>
  • <Type>zlm</Type>
  • <User>Administrator></User>
  • <Password>letmein</Password>
  • </LocalServer>

Base - Wenn das Typ-Attribut ZLM lautet, lassen Sie dieses Feld leer. Falls das Typ-Attribut STATIC lautet, geben Sie den Pfad des lokalen Verzeichnisses, in das die Pakete kopiert werden sollen, im folgenden Format ein: /pfad/im/dateisystem.

Type - Typ der auszuführenden Spiegelung

  • ZLM: Spiegelt Kataloge und Bundles direkt auf den ZENworks Linux Management-Server. Nach der Spiegelung werden die gespiegelten Kataloge und Bundles im ZENworks Control Center angezeigt.

    ZLM-Spiegelungen können nicht auf Sekundärservern durchgeführt werden.

  • STATIC: Spiegelt die Pakete in das Dateisystem des ZENworks Linux Management-Servers, fügt ZENworks die gespiegelten Pakete jedoch nicht hinzu.

    Auf Sekundärservern können nur statische Spiegelungen durchgeführt werden.

User - Der bei der Verbindung mit dem (lokalen) ZENworks Linux Management-Server zu verwendende Benutzername. Wenn das Standard-Administratorkonto verwendet werden soll, müssen Sie den Benutzernamen Administrator eingeben.

Password - Das Passwort für das unter User angegebene Konto. Wenn Sie das Administratorkonto verwenden, geben Sie das gleiche Passwort ein, das Sie während der Serverinstallation angegeben haben.

Kataloge, Bundles und Pakete

Jedes Bundle oder Paket, das Sie spiegeln möchten, muss sich in einem Katalog auf dem Fernserver befinden. Zur Spiegelung eines Katalogs, eines Bundles oder eines Pakets benötigen Sie daher nur das Element Katalog. Eine Konfigurationsdatei kann mehrere Katalogelemente enthalten. Außerdem muss jeder Katalog, den Sie spiegeln möchten, über einen eigenen Eintrag verfügen.

  • <Catalog>
  • <Name>Red Carpet 2</Name>
  • <LocalName>Red Carpet 2</LocalName>
  • <Target>sles-9-i586</Target>
  • <Package>lib.*</Package>
  • </Catalog>

Lokaler Name - Name des Katalogs, in dem die gespiegelte Software platziert werden soll. Wenn kein lokaler Name angegeben wird, wird der Katalogname aus dem Ursprungsserver verwendet. Der lokale Name für den Katalog sollte nicht identisch mit dem für den <Katalogname>-Patchordner reservierten Namen sein.

Ordner - Legt den eDir-Ordner fest (z. B. /Ordner1/Ordner2), in dem Bundles und Kataloge erstellt und aktualisiert werden. Wenn dieser Ordner nicht angegeben ist, werden die Kataloge und Bundles im Ordner /zlmmirror erstellt und aktualisiert.

Target - Beschränkt die Spiegelung in diesem Katalog auf Pakete und Patches, die die angegebenen Zielplattformen unterstützen. Wenn keine Zielplattform angegeben ist, werden Pakete für alle Plattformen gespiegelt. Diese Option kann mehrmals vorhanden sein. Sie kann direkt einen Zielnamen enthalten, aber auch eine reguläre Ausdruckszeichenfolge, die alle übereinstimmenden Zielnamen auswählt. Um beispielsweise Ziele einzuschließen, die mit sles beginnen, wie sles-9-i586, verwenden Sie den regulären Ausdruck <Target>sles*</Target>.

ExcludeTarget - Für diese Option gilt das Gleiche wie für Target. Allerdings werden bei dieser Option Pakete und Patches, die die angegebenen Zielplattformen unterstützen, von der Spiegelung ausgeschlossen. ExcludeTarget wird nach Target ausgeführt. Plattformen, die in ExcludeTarget aufgeführt werden, sind daher definitiv ausgeschlossen, selbst wenn sie zuvor in Target genannt wurden. Um beispielsweise Ziele auszuschließen, die mit i586 enden, wie sles-9-i586, verwenden Sie den regulären Ausdruck <ExcludeTarget>.*i586</ExcludeTarget>.

Bundle - Beschränkt den Spiegelungsvorgang am Katalog auf die angegebenen Bundles. Wenn kein Bundle angegeben wird, werden alle Bundles gespiegelt. Diese Option ist nur für ZLM- und YaST-Quellserver gültig. Diese Option kann mehrmals angegeben werden. Sie kann entweder einen Paketnamen enthalten oder eine reguläre Ausdruckszeichenfolge, die alle übereinstimmenden Paketnamen auswählt. Weitere Informationen zu regulären Ausdrücken finden Sie im folgenden Hinweis.

LocalBundleName - Benennt den Bundle-Namen lokal um. Dies gilt nur für die RCE-, NU- und RHN-Dienste, in denen ein Katalog auf dem Fernserver nur ein Bundle besitzt. Wenn Sie <LocalBundleName> angeben, dürfen Sie das <Bundle>-Tag nicht angeben. Dieses Tag ist nicht anwendbar, wenn Sie OES vom RCE-Dienst aus mit mehr als einem Bundle pro Katalog spiegeln.

ExcludeBundle - Für diese Option gilt das Gleiche wie für Bundle. Allerdings werden bei dieser Option die Pakete und Patches der angegebenen Bundles von der Spiegelung ausgeschlossen. Diese Option wird nur von ZLM- und YaST-Ursprungsservern unterstützt. Die Option kann mehrmals vorhanden sein. Sie kann direkt einen Bundle-Namen enthalten, aber auch eine reguläre Ausdruckszeichenfolge zur Auswahl aller übereinstimmenden Bundle-Namen. ExcludeBundle wird nach Bundle ausgeführt. Bundles, die in ExcludeBundle aufgeführt werden, sind daher definitiv ausgeschlossen, selbst wenn sie zuvor in Bundle genannt wurden. Weitere Informationen zu regulären Ausdrücken finden Sie im folgenden Hinweis.

Paket - Beschränkt die Spiegelung für den Katalog auf die angegebenen Pakete. Wenn kein Paket angegeben wird, werden alle Pakete gespiegelt. Diese Option kann mehrmals vorhanden sein. Sie kann direkt einen Paketnamen enthalten, aber auch eine reguläre Ausdruckszeichenfolge, die alle übereinstimmenden Paketnamen auswählt. Diese Option wird nicht für Patch-Bundles unterstützt. Filtern von Paketen in einem Patch-Bundle wird nicht für entfernte RCE-, YaST- und NU-Server unterstützt. Weitere Informationen zu regulären Ausdrücken finden Sie im folgenden Hinweis.

ExcludePackage - Für diese Option gilt das Gleiche wie für Package. Allerdings werden bei dieser Option die angegebenen Pakete von der Spiegelung ausgeschlossen. Diese Option kann mehrmals vorhanden sein. Sie kann direkt einen Paketnamen enthalten, aber auch eine reguläre Ausdruckszeichenkette, die alle übereinstimmenden Paketnamen auswählt. Diese Option wird für YOU-Patches nicht unterstützt. ExcludePackage wird nach Package ausgeführt. Pakete, die in ExcludePackage aufgeführt werden, sind daher definitiv ausgeschlossen, selbst wenn sie zuvor in Package genannt wurden. Weitere Informationen zu regulären Ausdrücken finden Sie im folgenden Hinweis.

Kategorie - Beschränkt den Spiegelungsvorgang am Katalog auf die angegebenen Kategorien der Patch-Bundles. Wenn keine Kategorie angegeben wird, werden alle Patch-Bundles gespiegelt. Gültige Werte sind Empfohlen, Optional und Sicherheit. Dieses Tag eignet sich nur für SLES 10-, SLED 10- und OES 2-Server der Typen RCE und NU.

ServicePackGroups - Es sind ausschließlich boolesche Werte verwendbar (true oder false). Standardmäßig wird für <ServicePackGroups> true festgelegt und es werden automatisch Bundle-Gruppen erstellt. Diese Option wird nur für YOU-Patches unterstützt.

AutoDeploy - Die Spiegelung des Pakets auf ein vorhandenes Bundle erzeugt eine neue Version des Bundles und stellt diese auf dem Server bereit. Wenn für AutoDeploy falsch festgelegt wird, beschränkt die Spiegelung die Bereitstellung des neuen Bundles. Es sind nur boolesche Werte gültig (true oder false). Standardmäßig wird für die Option true festgelegt.

CreateMonolithicBundle - Erstellt automatisch monolithische Paket-Bundles, die ausschließlich aus den neuesten Paket-RPMs bestehen. Ein separates monolithisches Bundle wird für jede Service Pack-Version erstellt und ein separates monolithisches Bundle mit den Aktualisierungen nach der neuesten Service Pack-Version. Es sind ausschließlich boolesche Werte verwendbar (true oder false). Standardmäßig ist die Option auf true gesetzt. Diese Option wird nur für YOU-Patches unterstützt.

FilterPatchRPM - Beschränkt die Spiegelung der YOU-Patch-Bundles, um alle Pakete vom Typ .patch.rpm zu filtern. Diese Option erzeugt ein entsprechendes RPM-Paket-Bundle auf dem lokalen Server. Es sind nur boolesche Werte gültig (true oder false). Standardmäßig wird für die Option false festgelegt. Diese Option wird nur für YOU-Patches unterstützt.

HINWEIS:Die Verwendung von regulären Ausdrücken (regexes) hat sich in ZENworks 7.3 Linux Management geändert. ZENworks Linux Management verwendet keine Platzhalterzeichenabgleiche. In ZENworks Linux Management 6.6.x können Sie eine Platzhalterausdrucks-Zeichenkette statt einer regulären Ausdruckszeichenkette verwenden. In ZENworks 7.3 Linux Management sollten Sie <Bundle>patch- verwenden.*</Bundle> verwenden, um alle Bundles zu spiegeln, die mit dem Namen patch- beginnen. ZENworks Linux Management unterstützt alle regulären Ausdrücke von Java. Weitere Informationen über reguläre Ausdrücke in Java finden Sie in der Java-Dokumentation.

Autoren

Copyright 2005-2009, Novell, Inc.. Alle Rechte vorbehalten.

Siehe auch

rug (1), zlman (1), zmd (8), zlm-debug (1), zrmservice (1)

Wenn Sie Probleme im Zusammenhang mit dieser Software oder seiner Dokumentation melden möchten, besuchen Sie die Seite Novell Bugzilla.