Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
documentation.suse.com / SUSE Linux Enterprise Server Documentation / Deployment Guide / Installation procedure / Registering SUSE Linux Enterprise and managing modules/extensions
Applies to SUSE Linux Enterprise Server 15 SP3

9 Registering SUSE Linux Enterprise and managing modules/extensions

To get technical support and product updates, you need to register and activate SUSE Linux Enterprise Server with the SUSE Customer Center. It is recommended to register during the installation, since this will enable you to install the system with the latest updates and patches available. However, if you are offline or want to skip the registration step, you can register at any time later from the installed system.

Modules and extensions add features to your system and allow you to customize the system according to your needs. These components also need to be registered and can be managed with YaST or command line tools. For more details also refer to the Modules and Extensions Quick Start.

Note
Note: SUSE account

Registering with the SUSE Customer Center requires a SUSE account. In case you do not have a SUSE account yet, go to the SUSE Customer Center home page (https://scc.suse.com/) to create one.

Tip
Tip: Deregistering a system

To completely deregister a system including all modules and extensions use the command line tool SUSEConnect. Deregistering a system removes its entry on the registration server and removes all repositories for modules, extensions, and the product itself.

> sudo SUSEConnect -d

9.1 Registering during the installation

The easiest and recommended way to register is to do it during the installation. It will not only allow you to install the latest patch level of SUSE Linux Enterprise Server, but you will also get access to all modules and extensions without having to provide an additional installation media. This also applies to all modules or extension you install. For details on the registration process refer to Section 8.7, “Registration”.

If the system was successfully registered during installation, YaST will add online repositories provided by SUSE Customer Center. This prevents problems if local installation sources are no longer available and ensures that you always get the latest updates from the online repositories.

9.2 Registering during automated deployment

If you deploy your instances automatically using AutoYaST, you can register the system during the installation by providing the respective information in the AutoYaST control file. Refer to Section 4.3, “System registration and extension selection” for details.

9.3 Registering from the installed system

If you have skipped the registration during the installation or want to re-register your system, you can do so at any time using the YaST module Product Registration or the command line tool SUSEConnect.

9.3.1 Registering with YaST

To register the system start YaST › Software › Product Registration. First register SUSE Linux Enterprise Server, then choose the modules and extensions you want to make available.

Important
Important: Modules and extensions

If you have installed the system by skipping the registration and installing from the SLE-15-SP3-Full-ARCH-GM-media1.iso media, make sure to register all the modules and extension you have chosen during the installation. You will only receive security updates and patches for modules and extensions that have been registered.

Procedure 9.1: Product registration with YaST
  1. Start YaST › Software › Product Registration.

    Registration dialog
  2. Provide the E-mail address associated with the SUSE account you or your organization uses to manage subscriptions. Also enter the Registration Code you received with your copy of SUSE Linux Enterprise Server.

  3. By default the system is registered with the SUSE Customer Center. Proceed to the next step to make this happen.

    If your organization provides local registration servers you can either choose one form the list of auto-detected servers or provide the URL at Register System via local RMT Server.

  4. Choose Next to start the registration process. SUSE Linux Enterprise Server is registered with the chosen server and the associated repositories are added to your system. The Extension and Module Selection dialog opens.

    Extension and Module Selection dialog
  5. Select all modules and extensions you want to make available in the system. You should at least choose the preselected modules (Basesystem Module and Server Applications Module). Also make sure to choose any additional module or extension that you have added during the installation. Note that all extensions require additional registration codes which are liable for cost. Proceed with Next.

  6. Depending on your selection, you may need to accept one or more license agreements now. All components are registered with the chosen server and the associated repositories are added to your system.

  7. The YaST package installer opens to install release-packages for each module and, depending on your choice of modules and extensions, additional packages. It is strongly recommended not to deselect any of the preselected packages; you may, however, add additional packages.

    Installation Summary screen

    Choose Accept and Finish to conclude the registration process.

9.3.2 Registering with SUSEConnect

Registering the system plus modules and extensions is also possible from the command line using SUSEConnect. For information that go beyond the scope of this section, refer to the inline documentation with man 8 SUSEConnect

Procedure 9.2: Product registration with SUSEConnect
  1. To register SUSE Linux Enterprise Server with SUSE Customer Center run SUSEConnect as follows:

    > sudo SUSEConnect -r REGISTRATION_CODE -e EMAIL_ADDRESS

    To register with a local registration server, additionally provide the URL to the server:

    > sudo SUSEConnect -r REGISTRATION_CODE -e EMAIL_ADDRESS \
    --url "https://suse_register.example.com/"

    Replace REGISTRATION_CODE with the registration code you received with your copy of SUSE Linux Enterprise Server. Replace EMAIL_ADDRESS with the E-mail address associated with the SUSE account you or your organization uses to manage subscriptions.

    This process will register the Basesystem Module and Server Applications Module and add the associated repositories to your system.

  2. SUSE Linux Enterprise Server including the two default repositories is now registered. In case you want to register additional modules or extensions, proceed as outlined in Section 9.4, “Managing modules and extensions in a running system”.

9.4 Managing modules and extensions in a running system

Even after a system is installed and registered, adding and removing modules and extensions is still possible. You can either use YaST or SUSEConnect for this task. For more details also refer to the Modules and Extensions Quick Start.

9.4.1 Adding modules and extensions with YaST

  1. Start YaST › Software › System Extensions.

    Extension and Module Selection dialog
  2. To add modules or extensions, select all components you want to install. Note that all extensions require additional registration codes which are liable for cost.

  3. All additional components are registered with the registration server and the associated repositories are added to your system.

  4. The YaST package installer opens to install release-packages for each module and, depending on your choice of modules and extensions, additional packages. It is strongly recommended not to deselect any of the preselected packages; you may, however, add additional packages.

    Choose Accept and Finish to conclude the process.

Tip
Tip: Module dependencies

Similar to software packages, which may depend on other packages to function, a module may have dependencies on other modules. If this is the case, the modules on which it depends are automatically selected for installation.

9.4.2 Deleting modules and extensions with YaST

  1. Start YaST › Software › Add-On Products.

    Installed Add-on Products dialog
  2. Choose the module or extension that should be removed and click Delete. Confirm the warning saying that all packages from the selected component will be removed.

  3. The YaST Software Manager opens and lists all installed packages from the deleted module or extension. Click Accept to remove all of them. It is strongly recommended to do so, because you will no longer get updates for packages from deleted modules or extensions. In case you keep packages, make sure to at least remove the *-release package for each module or extension that gets deleted.

    Proceed with Accept and then OK.

Warning
Warning: Deleting modules

Note that you should never delete the Basesystem Module. It is also not recommended to delete the Server Applications Module.

Warning
Warning: No updates for packages from deleted modules and extensions

If you choose to keep packages from deleted modules or extensions, you will no longer receive updates for these packages. Because this includes security fixes, keeping such packages may introduce a security risk to your system.

9.4.3 Adding/deleting modules and extensions with SUSEConnect

  1. Run SUSEConnect -list-extensions to get an overview of available extensions:

    > sudo SUSEConnect -list-extensions
    AVAILABLE EXTENSIONS AND MODULES
    
      Basesystem Module 15 SP3 x86_64 (Installed)
      Deactivate with: SUSEConnect -d -p sle-module-basesystem/15.3/x86_64
    
        Containers Module 15 SP3 x86_64
        Activate with: SUSEConnect -p sle-module-containers/15.3/x86_64
    
        Desktop Applications Module 15 SP3 x86_64
        Activate with: SUSEConnect -p sle-module-desktop-applications/15.3/x86_64
    
          Development Tools Module 15 SP3 x86_64
          Activate with: SUSEConnect -p sle-module-development-tools/15.3/x86_64
    
          SUSE Linux Enterprise Workstation Extension 15 SP3 x86_64
          Activate with: SUSEConnect -p sle-we/15.3/x86_64 -r ADDITIONAL REGCODE
    
        SUSE Cloud Application Platform Tools Module 15 SP3 x86_64
        Activate with: SUSEConnect -p sle-module-cap-tools/15.3/x86_64
    
        SUSE Linux Enterprise Live Patching 15 SP3 x86_64
        Activate with:
          SUSEConnect -p sle-module-live-patching/15.3/x86_64 -r ADDITIONAL REGCODE
    
        SUSE Package Hub 15 SP3 x86_64
        Activate with: SUSEConnect -p PackageHub/15.3/x86_64
    
        Server Applications Module 15 SP3 x86_64 (Installed)
        Deactivate with: SUSEConnect -d -p sle-module-server-applications/15.3/x86_64
    
          Legacy Module 15 SP3 x86_64
          Activate with: SUSEConnect -p sle-module-legacy/15.3/x86_64
    
          Public Cloud Module 15 SP3 x86_64
          Activate with: SUSEConnect -p sle-module-public-cloud/15.3/x86_64
    
          SUSE Enterprise Storage 6 x86_64
          Activate with: SUSEConnect -p ses/6/x86_64 -r ADDITIONAL REGCODE
    
          SUSE Linux Enterprise High Availability Extension 15 SP3 x86_64
          Activate with: SUSEConnect -p sle-ha/15.3/x86_64 -r ADDITIONAL REGCODE
    
          Web and Scripting Module 15 SP3 x86_64
          Activate with: SUSEConnect -p sle-module-web-scripting/15.3/x86_64
    
    MORE INFORMATION
    
    You can find more information about available modules here:
    https://www.suse.com/products/server/features/modules.html
  2. Run the commands in the listing for activating/deactivating a module or extension to add or delete a component. Note that adding an extensions requires additional registration codes which are liable for cost.

Warning
Warning: Deleting modules

Note that you should never delete the Basesystem Module. It is also not recommended to delete the Server Applications Module.

Important
Important: No automated installation/removal of packages

When using SUSEConnect to add or delete modules and extensions, the components get deregistered and the respective repositories or services get removed from the system. No installation or removal of packages will be done. If you want this to be done automatically, use YaST to add or delete modules and extensions.

When adding a module or extension, this means no automatic installation of default packages or patterns is performed. You need to do this manually with Zypper on the command line or by running YaST › Software Management.

When deleting a module or extension, this means no automatic cleanup will be done. All packages that belonged to the module or extension will remain installed on the system, but are longer associated with a repository and therefore will no longer receive updates. To remove these so-called orphaned packages use Zypper on the command line. zypper packages --orphaned lists these packages and zypper remove deletes one or more packages. Alternatively use YaST › Software Management to list and delete orphaned packages.

Warning
Warning: No updates for packages from deleted modules and extensions

If you choose to keep packages from deleted modules or extensions, you will no longer receive updates for these packages. Because this includes security fixes, keeping such packages may introduce a security risk to your system.

9.5 SUSEConnect keep-alive timer

From version 0.3.33, the SUSEConnect package ships with two systemd units:

  • suseconnect-keepalive.service: a service which runs the command SUSEConnect --keep-alive on demand.

  • suseconnect-keepalive.timer: a timer which runs the service suseconnect-keepalive.service once a day.

These units are responsible for keeping the system information up-to-date with the SUSE Customer Center or registration server, and to provide accurate data about subscription usage.

The command SUSEConnect --keep-alive updates the last time a system has been seen and its hardware information with the registration service.

Note
Note: The timer is enabled automatically

When the SUSEConnect package is installed or updated, and its version is equal to or greater than the one described above, the keep-alive timer will be enabled automatically.

Tip
Tip: Disabling the SUSEConnect keep-alive timer

If you prefer to not have the SUSEConnect keep-alive timer running on your system, you can disable it with systemctl:

> sudo systemctl disable --now suseconnect-keepalive.timer

Once the timer is disabled, subsequent updates to the SUSEConnect package will not reenable it.