zlmmirror - mirrors bundles and catalogs of software, in whole or in part, from remote ZENworks Linux Management, Yast® Online Updates, and RedHat Network servers, to your local ZENworks® Linux Management server or to a local directory.
zlmmirror <command> [--options] [arguments]
This command reads the information necessary to connect to the local and remote server from an XML configuration file. Detailed information on creating zlmmirror configuration files is included in the ZENworks Linux Management Administration Guide.
zlmmirror enables you to connect to a remote server and copy software catalogs, bundles, or packages from the remote server to your server using a few simple commands. Software can be mirrored from the following servers:
Novell, SUSE, and RedHat each maintain servers of their respective types, enabling you to simply mirror the catalogs and bundles you are interested in without needing to maintain or update these repositories. Mirroring is the preferred method of obtaining the majority of the software you distribute to managed devices.
During use, zlmmirror connects to the remote server, the local server, and to the zlman program, authenticating itself each time. It should be run on the same system as zlman and the rest of the ZENworks Linux Management server, and requires root privileges.
All of the commands below accept the option flags listed in the GLOBAL OPTIONS section. In addition, they accept individual options as listed with each command.
Configuration Commands:
These commands are used to create, convert, and validate zlmmirror configuration files.
Catalog and Bundle Commands:
These commands allow you to view the catalogs, bundles, and packages on the remote server.
Mirror Command:
The mirror command is used to perform the actual mirroring operation contained in the zlmmirror.xml.
/etc/opt/novell/zenworks/zlmmirror.xml
The default configuration file. A template XML file can be created using the conf-generate command.
You must create a different XML configuration for each remote server you mirror. See the ZENworks Linux Management Administration Guide for detailed instructions on mirroring. The following is a description of the sections contain in zlmmirror XML configuration file. You must provide details on the remote server containing the software you want to mirror, and the local server, which is your ZLM server receiving the mirrored software, as well as information on the catalogs, bundles, and packages you want mirrored.
Remote Server:
The remote server is specified according to the following:
<RemoteServer> <Base>https://zlm.novell.com/</Base> <Type>zlm</Type> <User /> <Password /> </RemoteServer>
Base - Path to the server you want to mirror, in the following format depending on Type: ZLM: https://server, RCE: https://server/path, YAST: http(s)://server/path or ftp://server/path, RHN: http(s)://server/path.
Type - Type of server you want to mirror. ZLM: ZENworks 7 Linux Management, RCE: Red Carpet Enterprise, or ZENworks 6.x Linux Management, YAST: Yast Online Updates, RHN: RedHat Network.
User - Name to use when connecting to the remote server. If no user is specified, zlmmirror reads the identity from the following location depending on Type: ZLM: /etc/opt/novell/zenworks/zmd/deviceid, RCE: /etc/ximian/mcookie, YAST: /etc/sysconfig/onlineupdate, When connecting to an RHN server, leave this element empty.
Password - Password to use when connecting to the remote server. If no password is specified, zlmmirror reads the password from the following location depending on Type: ZLM: /etc/opt/novell/zenworks/zmd/secret, RCE: /etc/ximian/partnernet, YAST: /etc/sysconfig/onlineupdate, When connecting to an RHN server, leave this element empty.
Local Server:
The local server is specified according to the following:
<LocalServer> <Base></Base> <Type>zlm</Type> <User>Administrator</User> <Password>password</Password> </LocalServer>
Base - If the Type attribute is ZLM, leave this field empty. If the Type attribute is STATIC, enter the path to the local directory where you want the packages copied, in the following format: /path/on/filesystem.
Type - Type of mirroring you want performed: ZLM: Mirrors catalogs and bundles directly to your ZENworks Linux Management server. After mirroring, mirrored catalogs and bundles are displayed in the ZENworks Control Center. STATIC: Mirrors packages to the filesystem of your ZENworks Linux Management server, but does not add them to ZENworks.
User - Name to use when connecting to your ZENworks Linux Management (local) server. The Administrator user should be specified if you want to use the default administrator account.
Password - Password for the account provided in User. If using the Administrator account, this is the password you specified during the server installation.
Catalogs, Bundles and Packages:
Each bundle and package you want to mirror must be contained in a catalog on the remote server, so Catalog is the only section necessary to mirror a catalog, bundle, or package. A configuration file can have multiple Catalog elements, and each catalog you want to mirror must have its own entry.
<Catalog> <Name>Red Carpet 2</Name> <LocalName>Red Carpet 2</LocalName> <Target>sles-9-i586</Target> <Package>lib.*</Package> </Catalog>
Local Name - Name of catalog you want the mirrored software placed in. If no Local Name is specified, the catalog name from the source server is used.
Folder - Specifies the eDir folder (e.g. /folder1/folder2) where bundles and catalogs are created and updated. If not specified, the catalogs and bundles will be created and updated in the /zlmmirror folder.
Target - Restricts the mirroring operation on this catalog to packages and patches that support the specified target platform(s). If no target is specified, packages for all platforms are mirrored. This element can be specified multiple times, and can contain either a target name or a regular expression string for wildcard matching of target names.
ExcludeTarget - Same as Target, except packages and patches supporting the specified target platform(s) are excluded. ExcludeTarget is performed after Target, so platforms appearing in a Target and ExcludeTarget are ultimately excluded.
Bundle - Restricts the mirroring operation on this catalog to the specified bundle(s). If not specified, all bundles are mirrored. This option is valid only for ZLM and YAST source servers, and can be specified multiple times and can contain either a bundle name or a regular expression string for wildcard matching of bundle names.
ExcludeBundle - Same as Bundle, except packages and patches contained in the specified bundle(s) are excluded. This option is valid only for ZLM and YAST source servers, and can be specified multiple times and can contain either a bundle name or a regular expression string for wildcard matching of bundle names. ExcludeBundle is performed after Bundle, so bundles appearing in a Bundle and ExcludeBundle are ultimately excluded.
Package - Restricts the mirroring operation on this catalog to the specified package(s). If not specified, all package(s) are mirrored. This option is valid only for ZLM and YAST source servers, and can be specified multiple times and can contain either a bundle name or a regular expression string for wildcard matching of bundle names.
ExcludePackage - Same as Package, except specified package(s) are excluded. This option is valid only for ZLM and YAST source servers, and can be specified multiple times and can contain either a bundle name or a regular expression string for wildcard matching of bundle names. ExcludePackage is performed after Package, so packages appearing in a Package and ExcludePackage are ultimately excluded.
Copyright 2005, Novell, Inc. All rights reserved. http://www.novell.com