ZLM 7 mirror – zlmmirror – how to

Here are some examples of ZLM 7 ZLMmirror configurations – fresh from cvs.

There are several key changes to mirroring from ZENworks 6.x Linux Management or Red Carpet Enterprise:

– a single configuration file for all mirror services
– configuration file is now an XML document rather than a conf file

Examples will be given for mirroring from RCE/ZLM 6.x (such as update.novell.com), YaST Online Update, Red Hat Network and finally ZLM 7 upstream services.

Here is the basic structure

<ZLMMirrorConf>
<Session>

<RemoteServer>
<Base>base</Base>
<Proxy>proxy</Proxy>
<Type>type</Type>
<User>user</User>
<Password>password</Password>
</RemoteServer>

<LocalServer>
<Type>zlm</Type>
<User></User>
<Password></Password>
</LocalServer>

<Catalog>
<Name></Name>
<LocalName></LocalName>
<Folder></Folder>
<Target></Target>
<ExcludeTarget></ExcludeTarget>
<Bundle></Bundle>
<ExcludeBundle></ExcludeBundle>
</Catalog>

</Session>
</ZLMMirrorConf>

<!‑‑
*** Local section for ZENworks Linux Management 7.0 servers ***
<User> must contain the name of the local ZLM 7.0 Management
Zone administrator
<Password> must contain the administrator’s password.
‑‑>

<!‑‑ Use “zlmmirror server‑list‑catalogs” to see a full list of
catalog names available on this server. ‑‑>

Notes:

Mirroring from ZLM/RCE

This is a sample zlmmirror configuration file for mirroring from a Red Carpet Enterprise (RCE) or ZENworks Linux Management 6 server.

Required steps to mirror using this configuration file:

1. Using the <RemoteServer><Base> field, specify the URL of the remote RCE or ZLM6 server you wish to mirror.

2. Configure the <LocalServer><User> and <LocalServer><Password> fields below with the local ZLM server’s administrator name and password.

3. Specify a catalog name in the <Catalog><Name> field below. Use “zlmmirror server‑list‑catalogs” to see a full list of catalog names available on this server.

Optional steps to mirror using this configuration file:

1. If you wish to mirror to an RCE/ZLM6 server using account information from another machine, copy the user and password values from that machine into the <RemoteServer><User> and <RemoteServer><Password> fields. See the <RemoteServer> section below for more information.

2. If you wish to connect to the remote server via a proxy server, specify the proxy server URL in the <RemoteServer><Proxy> field.

3. If you wish to restrict the mirroring to certain portions of the remote catalog, you may specify those restrictions using the following fields in the <Catalog> section: <Target>, <ExcludeTarget>, <Bundle>, <ExcludeBundle>, <Package>, <ExcludePackage>

4. If you wish to mirror more than one remote catalog during this session, create another <Catalog> section.

*** RemoteServer section for Red Carpet Enterprise/ZENworks
Linux Management 6 servers ***

If this machine has not registered with the remote RCE/ZLM6
server, or you wish to use the account information from another
machine, you may copy the account information from that other
machine into the <User> and <Password> fields. The username on
a RCE/ZLM6 machine is stored in the /etc/ximian/mcookie file.
The password is stored in the /etc/ximian/partnernet file. For
ZLM7 machines, the username is stored in the
/etc/opt/novell/zenworks/zmd/deviceid file, and the password is
stored in the /etc/opt/novell/zenworks/zmd/secret file.

<Base> must contain the URL of a Red Carpet Enterprise or ZENworks
Linux Management 6 server. For example:
https://red‑carpet.ximian.com
<Proxy> (optional) may contain the URL of a proxy server.
<Type> must contain “rce” for RCE and ZLM6 servers.
<User> contains the user account to use for authenticating
to the RCE/ZLM6 server. If not specified, the contents of
/etc/opt/novell/zenworks/zmd/deviceid is used.
<Password> contains the password to use for authenticating to the
RCE/ZLM6 server. If not specified, the contents of
/etc/opt/novell/zenworks/zmd/secret is used.
‑‑>

<!‑‑
*** Catalogs configuration section ***
You may include multiple <Catalog> sections to mirror multiple
remote catalogs during a single session.

<Name> must contain the name of a catalog on the remote server.
Use “zlmmirror server‑list‑catalogs” to see a full list of
catalog names available on this server.
<LocalName> (optional) may contain the name of the local catalog
to receive the mirrored packages. If not specified, the remote
catalog name is used.
<Folder> (optional) may contain the full name of a local folder
(e.g. /folder1/folder2/folder3) in the Bundles folder of
the ZLM Data Store where mirrored catalogs and bundles will
be created. If not specified, “/zlmmirror” is used.
<Target>, <ExcludeTarget> (optional) may contain targets to
include and exclude in the mirroring. May contain regular
expressions (for example: . matches one character, .*
matches multiple characters, …).
<Bundle>, <ExcludeBundle> (optional) may contain remote bundles to
include and exclude in the mirroring. May contain regular
expressions (for example: . matches one character, .*
matches multiple characters, …).
<Package>, <ExcludePackage> (optional) may contain remote packages
to include and exclude in the mirroring. May contain regular
expressions (for example: . matches one character, .*
matches multiple characters, …).
‑‑>

‑‑‑ NEW FILE: zlmmirror‑example‑rhn‑conf.xml ‑‑‑
<ZLMMirrorConf>
<Session>
<!‑‑
This is a sample zlmmirror configuration file for mirroring
from a Red Hat Network (RHN) server.

Required steps to mirror using this configuration file:

1. Configure the <LocalServer><User> and <LocalServer><Password>
fields below with the local ZLM server’s administrator name
and password.
2. Specify a catalog name in the <Catalog><Name> field below.
Use “zlmmirror server‑list‑catalogs” to see a full list of
catalog names available on this server.

Optional steps to mirror using this configuration file:

1. If you wish to mirror to an RHN server using account
information from another machine, copy the
/etc/sysconfig/rhn/systemid file from that machine
to this server and specify the location of that file
using the <RemoteServer><SystemID> field.
2. If you wish to connect to the remote server via a proxy
server, specify the proxy server URL in the
<RemoteServer><Proxy> field.
3. If you wish to restrict the mirroring to certain portions
of the remote catalog, you may specify those restrictions
using the following fields in the <Catalog> section:
<Target>, <ExcludeTarget>, <Bundle>, <ExcludeBundle>,
<Package>, <ExcludePackage>
4. If you wish to mirror more than one remote catalog during
this session, create another <Catalog> section.
‑‑>

<!‑‑
*** RemoteServer section for Red Hat Network servers ***

If this machine has not registered with RHN, or you wish to use
the RHN account from another machine, you may copy the
/etc/sysconfig/rhn/systemid file from another machine and specify
the full path of that systemid file with the <SystemID> field.

<Proxy> (optional) may contain the URL of a proxy server.
<SystemID> (optional) the systemID file to use for authenticating
to the RHN server. If not specified,
/etc/sysconfig/rhn/systemid is used.

# YOU

This is a sample zlmmirror configuration file for mirroring
from a YaST2 Online Update (YOU) server.

Required steps to mirror using this configuration file:

1. Using the <RemoteServer><Base> field, specify the URL of the
remote YOU server you wish to mirror.
2. Configure the <LocalServer><User> and <LocalServer><Password>
fields below with the local ZLM server’s administrator name
and password.
3. Specify a catalog name in the <Catalog><Name> field below.
Use “zlmmirror server‑list‑catalogs” to see a full list of
catalog names available on this server.

Optional steps to mirror using this configuration file:

1. If you wish to mirror to an authenticated YaST2 Online Update
server using account information from another machine,
specify that information in the <RemoteServer><User> and
<RemoteServer><Password> fields.
2. If you wish to connect to the remote server via a proxy
server, specify the proxy server URL in the
<RemoteServer><Proxy> field.
3. If you wish to restrict the mirroring to certain portions
of the remote catalog, you may specify those restrictions
using the following fields in the <Catalog> section:
<Target>, <ExcludeTarget>, <Bundle>, <ExcludeBundle>
4. If you wish to mirror more than one remote catalog during
this session, create another <Catalog> section.
‑‑>

<!‑‑
*** Remote section for YaST2 Online Update servers ***

<Base> can contain any SuSE mirror, for example:
http://ftp.suse.com/pub/suse
http://ftp.suselinux.hu/pub/suse
http://distro.ibiblio.org/pub/linux/distributions/suse/suse/
<Proxy> (optional) may contain the URL of a proxy server.
<User> (optional for public YOU servers) the user name to use to
authenticate to the YOU server. If not specified, the user
contained in /etc/sysconfig/onlineupdate is used. This value
is not required to mirror from public YOU servers.
<Password> (optional for public YOU servers) the password to use to
authenticate to the YOU server. If not specified, the password
contained in /etc/sysconfig/onlineupdate is used. This value
is not required to mirror from public YOU servers.
‑‑>

# ZLM 7

This is a sample zlmmirror configuration file for mirroring
from a ZENworks Linux Management 7 server.

Required steps to mirror using this configuration file:

1. Using the <RemoteServer><Base> field, specify the URL of the
remote ZLM7 server you wish to mirror.
2. Configure the <LocalServer><User> and <LocalServer><Password>
fields below with the local ZLM server’s administrator name
and password.
3. Specify a catalog name in the <Catalog><Name> field below.
Use “zlmmirror server‑list‑catalogs” to see a full list of
catalog names available on this server.

Optional steps to mirror using this configuration file:

1. If you wish to mirror to an ZLM7 server using account
information from another machine, copy the user and password
values from that machine into the <RemoteServer><User> and
<RemoteServer><Password> fields. See the <RemoteServer>
section below for more information.
2. If you wish to connect to the remote server via a proxy
server, specify the proxy server URL in the
<RemoteServer><Proxy> field.
3. If you wish to restrict the mirroring to certain portions
of the remote catalog, you may specify those restrictions
using the following fields in the <Catalog> section:
<Target>, <ExcludeTarget>, <Bundle>, <ExcludeBundle>
4. If you wish to mirror more than one remote catalog during
this session, create another <Catalog> section.

‑‑>

<!‑‑
*** RemoteServer section for ZENworks Linux Management 7 servers ***

If this machine has not registered with the remote ZLM7
server, or you wish to use the account information from another
machine, you may copy the account information from that other
machine into the <User> and <Password> fields. The username is
stored in the /etc/opt/novell/zenworks/zmd/deviceid file, and the
password is stored in the /etc/opt/novell/zenworks/zmd/secret file.

<Base> must contain the URL of a ZENworks Linux Management 7
server.
<Proxy> (optional) may contain the URL of a proxy server.
<User> contains the user account to use for authenticating
to the ZLM7 server. If not specified, the contents of
/etc/opt/novell/zenworks/zmd/deviceid is used.
<Password> contains the password to use for authenticating to the
ZLM7 server. If not specified, the contents of
/etc/opt/novell/zenworks/zmd/secret is used.

Leave a Reply

Your email address will not be published. Required fields are marked *