Documentation survey

Inter-Server Synchronization version 2

If you have more than one SUSE Multi-Linux Manager installation, you will need to copy contents between servers. Inter-Server Synchronization (ISS) allows you to export data from one server (hub) and import it on another server (peripheral). This is useful for hub deployment scenarios or disconnected setups.

1. Install Inter-Server Synchronization packages

To use ISS you need to install the inter-server-sync package on hub and peripheral servers.

2. Content synchronization

Use mgrctl term before running steps inside the server container.

Procedure: Export data on source server
  1. At the command prompt of the SUSE Multi-Linux Manager container host of the hub server, as root, enter the server container:

    mgrctl term
  2. Inside the container, execute the following steps:

    1. Execute the ISS export command. The -h option provides detailed help:

      inter-server-sync export -h

The export procedure creates an output directory with all the needed data for the import procedure.

To avoid data loss or filling up the container file system, store the data on a persistent volume (preferably /var/spacewalk). For more information about persistent volumes, see installation-and-upgrade:hardware-requirements.adoc#server-hardware-requirements.

Procedure: Copy export directory to peripheral server
  1. Contents from the hub server needs to be synchronized to the peripheral server. At the command prompt of the SUSE Multi-Linux Manager container host of the hub server, as root, enter the server container:

    mgrctl term
  2. Inside the container, execute the following steps:

    1. Synchronize to the peripheral server:

      rsync -r <PATH_EXPORTED_DIR> root@<PERIPHERAL_SERVER>:~/

When all contents is copied, start importing it.

Procedure: Import data on peripheral server
  1. At the command prompt of the SUSE Multi-Linux Manager container host of the peripheral server, as root, enter the server container:

    mgrctl term
  2. Inside the container, execute the following steps:

    1. Execute the ISS import command. The -h option provides detailed help:

      inter-server-sync import -h

3. Database connection configuration

Database connection configuration is loaded by default from /etc/rhn/rhn.conf. Properties file location can be overridden with parameter --serverConfig.

4. Known limitations

  • Hub and peripheral servers need to be on the same version.

  • Export and import organization should have exactly the same name. The organization name is case sensitive.