Disconnected Setup

When it is not possible to connect SUSE Manager to the internet, you can use it within a disconnected environment.

The repository mirroring tool (RMT) is available on SUSE Linux Enterprise 15 and later. RMT replaces the subscription management tool (SMT), which can be used on older SUSE Linux Enterprise installations.

In a disconnected SUSE Manager setup, RMT or SMT uses an external network to connect to SUSE Customer Center. All software channels and repositories are synchronized to a removable storage device. The storage device can then be used to update the disconnected SUSE Manager installation.

This setup allows your SUSE Manager installation to remain in an offline, disconnected environment.

Your RMT or SMT instance must be used to managed a SUSE Manager Server directly. It cannot be used to manage a second RMT or SMT instance, in a cascade.

Synchronize RMT

You can use RMT on SUSE Linux Enterprise 15 installations to manage clients running SUSE Linux Enterprise 12 or later.

We recommend you set up a dedicated RMT instance for each SUSE Manager installation.

Procedure: Setting up RMT
  1. On the RMT instance, install the RMT package:

    zypper in rmt-server
  2. Configure RMT using YaST:

    yast2 rmt
  3. Follow the prompts to complete installation. For more information on setting up RMT, see https://documentation.suse.com/sles/15-SP1/html/SLES-all/book-rmt.html.

Procedure: Synchronizing RMT with SCC
  1. On the RMT instance, list all available products and repositories for your organization:

    rmt-cli products list --all
    rmt-cli repos list --all
  2. Synchronize all available updates for your organization:

    rmt-cli sync

    You can also configure RMT to synchronize regularly using systemd.

  3. Enable the products you require. For example, to enable SLES 15:

    rmt-cli product enable sles/15/x86_64
  4. Export the synchronized data to your removable storage. In this example, the storage medium is mounted at /mnt/usb:

    rmt-cli export data /mnt/usb
  5. Export the enabled repositories to your removable storage:

rmt-cli export settings /mnt/usb

Ensure that the external storage is mounted to a directory that is writeable by the RMT user. You can change RMT user settings in the cli section of /etc/rmt.conf.

Synchronize SMT

SMT is included with SUSE Linux Enterprise 12, and can be used to manage clients running SUSE Linux Enterprise 10 or later.

SMT requires you to create a local mirror directory on the SMT instance in order to synchronize repositories and packages.

For more details on installing and configuring SMT, see https://documentation.suse.com/sles/12-SP4/html/SLES-all/book-smt.html.

Procedure: Synchronizing SMT with SCC
  1. On the SMT instance, create a database replacement file:

    smt-sync --createdbreplacementfile /tmp/dbrepl.xml
  2. Export the synchronized data to your removable storage. In this example, the storage medium is mounted at /mnt/usb:

    smt-sync --todir /mnt/usb
    smt-mirror --dbreplfile /tmp/dbrepl.xml --directory /mnt/usb \
               --fromlocalsmt -L /var/log/smt/smt-mirror-export.log
  3. Export the enabled repositories to your removable storage:

rmt-cli export settings /mnt/usb

Ensure that the external storage is mounted to a directory that is writeable by the RMT user. You can change SMT user settings in /etc/smt.conf.

Synchronize a Disconnected Server

When you have removable media loaded with your SUSE Customer Center data, you can use it to synchronize your disconnected server.

Procedure: Synchronizing a Disconnected Server
  1. Mount your removable media device to the SUSE Manager server. In this example, the mount point is /media/disk.

  2. Open /etc/rhn/rhn.conf and define the mount point by adding or editing this line:

    server.susemanager.fromdir = /media/disk
  3. Restart the Tomcat service:

    systemctl restart tomcat
  4. Refresh the local data:

    mgr-sync refresh
  5. Perform a synchronization:

    mgr-sync list channels
    mgr-sync add channel channel-label

The removable disk that you use for synchronization must always be available at the same mount point. Do not trigger a synchronization, if the storage medium is not mounted. This will result in data corruption.