JLdL 10Mar05.

Although the programs multi-apt-get-chroot and multi-dpkg-chroot are meant
to be executed only on the cluster server, these programs do depend on the
client package cluster-tools-client being correctly installed on the nodes
of the cluster. This is so because these tools need the anchoring programs
to be available at the nodes.

This establishes a dependency of a package on one machine with a package
on other machines, which is a rather unusual thing.  Here we discuss the
issue of how to install these packages under various circumstances.

If you are installing your cluster from scratch, the packages will already
be there, because they are in the package lists for the server and for the
nodes.  In this case the cluster-tools-client package will be in the first
node, and will be passed to all subsequent nodes by the cloning process.

If you already have a remotely-booted cluster up and running and are using
hard-linked filesystems, but have not installed these packages before, you
should proceed in this order:

1) Install the cluster-tools-server package in the cluster server and
   configure it correctly.

2) Use the multi-apt-get-remote tool to install the cluster-tools-client
   package on the nodes.

From that point on you should be able to use the multi-apt-get-chroot and
multi-dpkg-chroot tools.

If you are upgrading to a newer version in which changes to the anchoring
programs have made the old ones incompatible with the new tools, then you
must proceed in this order:

1) Use the existing tools to upgrade the cluster-tools-client package on
   the nodes.

2) Upgrade the cluster-tools-server package on the server and fix the
   configuration if there is any need.

If this fails for some reason, you can always use the multi-apt-get-remote
tool to upgrade the cluster-tools-client package on the nodes.

Note that if your cluster does not use hard-linked filesystems, then you
cannot use the multi-apt-get-chroot and multi-dpkg-chroot tools.

