Deploy SUSE Manager 5.0 Server

This guide outlines the deployment process for the SUSE Manager 5.0 Server. To successfully deploy, you will:

Task: Server Deployment
  1. Download installation media

  2. Install SLE Micro 5.5 on a bare-metal machine.

  3. Register SLE Micro 5.5 during installation

  4. Register SUSE Manager 5.0 Server as an extension during installation

  5. Update the system

  6. Deploy the server with mgradm

  7. Access the webui and sync your first channel

1. Hardware Requirements for SUSE Manager

This table shows the software and hardware requirements for deploying SUSE Manager Server on your bare metal machine. For the purposes of this guide your machine should have 16GB of RAM, and at least 200 GB of disk space.

Table 1. Software and Hardware Requirements
Software and Hardware Recommended

Operating System:

SLE Micro 5.5

CPU:

4 64-bit CPU cores

RAM:

16 GB

Disk Space:

200 GB

Channel Requirements

50 GB per SUSE or openSUSE product

360 GB per Red Hat product

Swap space:

3 GB

Supported operating system for the Server Container Host

The supported operating system for the container host is SLE Micro 5.5.

Container host

A container host is a server equipped with a container engine like Podman, which lets it manage and deploy containers. These containers hold applications and their essential parts, such as libraries, but not a full operating system, making them lightweight. This setup ensures applications run the same way in different environments. The container host supplies the necessary resources such as CPU, memory, and storage for these containers.

Server deployment mandates the use of a fully qualified domain name (FQDN). In the absence of automatic DNS provision of an FQDN by your router or network, the deployment process will not proceed successfully. An FQDN typically follows the format <host>.<domain>.com.

For instance:

  • suma.example.com

  • suma.fritz.box

  • suma.container.lab

For additional details, refer to the section on network requirements in the Installation and Upgrade Guide, available at Network Requirements.

2. SLE Micro 5.5 Installation

Procedure: Download the Installation Media
  1. Locate the SLE Micro 5.5 installation media at https://www.suse.com/download/sle-micro/.

  2. You will need an account with SUSE Customer Center and must be logged in to download the ISO.

  3. Download the following file: SLE-Micro-5.5-DVD-x86_64-GM-Media1.iso

  4. Prepare a USB fash disk or DVD for installation.

  5. Insert a DVD or a bootable USB stick containing the installation image for SLE Micro 5.5.

  6. Boot or reboot your system.

    For detailed documentation on preparing your machines OS (virtual or physical), see SLE Micro 5.5 Deployment Guide.

Procedure: SLE Micro 5.5 Installation
  1. Use the arrow keys to select Installation.

  2. Adjust Keyboard and language. Click the checkbox to accept the License Agreement.

  3. Click Next to continue.

  4. Select your registration method. For this example we will register the server with SUSE Customer Center.

    SUSE Manager as an extension

    The SUSE Manager 5.0 container is installed as an extension. Therefore, in addition to acquiring SUSE Customer Center registration keys for SLE Micro 5.5, you will also need SUSE Customer Center registration codes for the following extensions:

    • SUSE Manager 5.0 Server

    • SUSE Manager 5.0 Proxy

    • Retail Branch Server

  5. Enter your SUSE Customer Center Email address.

  6. Enter your registration code for SLE Micro 5.5.

  7. Click Next to continue.

  8. On the Extension and Module Selection page uncheck the Hide Development Versions checkbox.

  9. Select the SUSE Manager 5.0 Server extension Checkbox.

  10. Click Next to continue.

  11. Enter your SUSE Manager 5.0 Server extension registration code.

  12. Click Next to continue.

  13. On the NTP Configuration page click Next.

  14. On the Authentication for the System page enter a password for the root user. Click Next.

  15. On the Installation Settings page click Install.

This concludes installation of SLE Micro 5.5 and SUSE Manager 5.0 Server as an extension.

2.1. Update the system

  1. Login as root.

  2. Run transactional-update:

    transactional-update
  3. Reboot the system.

  4. Login as root.

  5. Enter the transactional shell:

    transactional-update shell
  6. Install the container utilities:

    transactional-update pkg install mgradm mgrctl mgradm-bash-completion mgrctl-bash-completion
  7. Reboot the system.

3. Deploy with mgradm

Procedure: Deploy SUSE Manager 5.0 with mgradm
  1. From the terminal run the following command replacing <suma.example.com> with your fully qualified domain name.

    mgradm install podman <suma.example.com>
  2. Enter a certificate and administrator account password when prompted.

    The administrator account password must be at least 5 characters and less than 48 characters in length.

  3. Press Enter.

  4. Enter the email address of the administration account. Press Enter.

  5. Wait for deployment to complete.

  6. Open a browser and proceed to your servers FQDN, or IP address.

In this guide you learned how to deploy SUSE Manager 5.0 Server as a container.

4. Synchronize with SUSE Customer Center

This section covers synchronizing with SCC from the Web UI and adding your first client channel.

Procedure: Entering Organization Credentials
  1. In the SUSE Manager Web UI, select Admin  Setup Wizard.

  2. From the Setup Wizard page select the Organization Credentials tab.

  3. Click Add a new credential.

  4. In the dialog, enter Username and Password, and confirm with Save.

When the credentials are confirmed with a green check-mark icon, proceed with Procedure: Synchronizing with SUSE Customer Center.

Procedure: Synchronizing with SUSE Customer Center
  1. In the Web UI, navigate to Admin  Setup Wizard.

  2. From the Setup Wizard page select the SUSE Products tab. If you previously registered with SUSE Customer Center a list of products will populate the table. This operation could take up to a few minutes. You can monitor the progress of the operation in section on the right Refresh the product catalog from SUSE Customer Center. The table of products lists architecture, channels, and status information. For more information, see Wizard.

    admin suse products
  3. Use Filter by product description and Filter by architecture to filter the list of displayed products. If your SUSE Linux Enterprise client is based on x86_64 architecture scroll down the page and select the check box for this channel now.

    • Add channels to SUSE Manager by selecting the check box to the left of each channel. Click the arrow symbol to the left of the description to unfold a product and list available modules.

    • Click Add Products at the top of the page to start product synchronization.

After adding the channel, SUSE Manager will schedule the channel to be synchronized. This can take a long time as SUSE Manager will copy channel software sources from the SUSE repositories located at SUSE Customer Center to the local /var/lib/containers/storage/volumes/var-spacewalk/ directory of your server.

When the channel is fully synchronized, the bootstrap repository for it will be automatically created. This is necessary for the successful bootstrapping of a client. This completes the SUSE Manager installation and configuration, with channel preparations for bootstrapping clients.

When the channel synchronization process is complete, you can continue with the client registration. For more instructions, see Client Registration.

5. Entering the container for management

To get to a shell inside the container, run the following on the host:

mgrctl term