Skip to main content
Version: 2.9.0

In Place Upgrades

Introduction​

This procedure allows customers to convert openSUSE to a licensed and supported SLES OS and allows in-place upgrade options using the YAST GUI for simplified OS patch management and major release upgrades. This subscription to SLES includes patches, upgrades, and access to OS technical support if required.

Prerequisites​

  • openSUSE.

    • How to check:

      Login as admin over SSH and run the following command:

      cat /etc/os-release

  • A SLES subscription purchased from Suse.

  • Internet repository firewall configuration or proxy that allows HTTPS over port 443 to https://updates.suse.com.

How to Migrate openSUSE to SLES Licensed Subscription OS​

  1. Purchase an OS subscription from SuSE or from a third party reseller:

    Make sure to retain the email address used to purchase and the Activation Code. subscription

  2. Login to the VM as the admin user over SSH:

    ssh admin@your_vm_ip
    sudo -s

  3. Install the migration package:

    zypper in yast2-migration-sle

  4. Once the installation is complete, start YAST:

    yast

  5. Select the menu on the right for Migrate to SUSE Linux Enterprise. Migrate to SUSE Linux Enterprise

  6. Follow the on-screen steps to enter your email address and Activation Code.

  7. After completing the steps, verify your registration:

    cat /etc/os-release

    Look for the OS ID to confirm it is now SLES.

  8. Confirm the VM registration using the Product Registration menu in YAST. Product Registration menu

    info

    You should see a screen indicating that "The system is already registered." confirming that the system is registered by SUSE.

How to In-Place OS Upgrade SLES-Licensed OS​

info

Only licensed SLES appliances offer the GUI upgrade In-Place.

  1. Login as admin over SSH

    sudo -s
    yast

  2. Select the menu option:

    • Go to the right menu and choose Online Migration.

  3. Follow the GUI steps to upgrade

    info

    During the upgrade, 2 conflicts will be raised for dependencies. Choose to continue the upgrade.

    info

    The upgrade can take 30-60 minutes depending on download speeds. A reboot will be completed at the end of the upgrade.

  4. Run Superna Eyeglass installer:

    • Execute the run file after the OS upgrade to repair dependencies.

  5. Prepare for Upgrade:

    • Open the OS release file:

      nano /etc/os-release

    • Change ID_LIKE from "suse" to "suse opensuse".

    • Press Control + X to save and exit.

  6. Download the Eyeglass Upgrade Installer:

    • Get the file from the support.superna.net portal.
    • Use scp to transfer the file to the Eyeglass appliance.
    tip

    To learn more about the Eyeglass upgrade process, check out the Eyeglass Upgrade Guide

  7. Change File Mode:

    chmod 777 <name of upgrade file>

  8. Execute the Upgrade File:

    ./<name of upgrade file>

  9. Verification:

    • Once completed, login to the Eyeglass Web UI to verify the upgrade.