Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
Applies to Subscription Management Tool 11.3

1 SMT Installation

SMT is an add-on product for SUSE Linux Enterprise Server 11 systems. You can either install the SMT add-on together with your SUSE Linux Enterprise Server base system during the initial installation process, or on top of an already-installed base system at any later time. SMT can be obtained free of charge from https://download.suse.com/.

If you install SMT on top of SLES with the latest maintenance patches applied, you may get dependency errors in some cases if you do not also use the latest SMT patches. To avoid those dependency errors, re-run Novell Customer Center (Novell Customer Center) Configuration in YaST right after you have added the SMT installation repository to your system, but before you install any packages from SMT. This way the SMT update repository will be properly available to your system.

It is recommended to to check for SMT updates available immediately after installing the product. SUSE continuously releases maintenance updates for SMT, and newer packages are likely to be available compared to those installed from media, for example using the zypper patch command.

Note
Note: Installation Scope

SMT is a LAMP (Linux, Apache, MySQL, PHP) based application. During the installation, Apache and MySQL will automatically be installed if missing.

1.1 Installation During the Initial Installation Process

To install the SMT add-on together with your base system during the initial installation process, follow these steps:

  1. Start the SUSE Linux Enterprise Server 11 installation as usual. For more information, see the SUSE Linux Enterprise Server documentation coming with the base product.

  2. To include the SMT add-on product, check the I would like to install an additional Add On product option during the installation and, if you are installing SMT from a local ISO image, select Local ISO Image as the media type (repository). If you are installing from a different source, such as CD, NFS, or HTTP, choose the appropriate type. Then click Next.

  3. If you are installing from a CD, insert the SMT add-on product CD. If you are installing from a different source, provide the necessary repository information.

  4. Confirm the SMT license agreement and click Next.

  5. The SMT add-on product is displayed in the overview. Continue with the installation as usual. Make sure that the SMT: Subscription Management Tool for SLE installation pattern is selected automatically and do not remove it.

  6. A two-step SMT Configuration Wizard is shown during the final steps of the installation workflow. Configure SMT as described in Section 1.3, “SMT Configuration Wizard” and continue with the SUSE Linux Enterprise Server installation as usual.

1.2 Installation on Top of an Already Installed System

To install SMT on top of an already-installed base system, follow these steps:

  1. Start YaST and select Software › Add-On Product. Then click Add.

  2. If you are installing SMT from a local ISO image, select Local ISO Image as the media type (repository). If you are installing from a different source, such as CD, NFS, or HTTP, choose the appropriate type. Then click Next.

  3. If you are installing from a CD, insert the SMT add-on product CD. If you are installing from a different source, provide the necessary repository information.

  4. Confirm the SMT license agreement and click Next.

  5. Click Accept to install the SMT: Subscription Management Tool for SLE pattern.

    Depending on the scope of already installed packages, the software manager will add more packages to resolve all dependencies. Confirm these Automatic Changes to perform the installation.

  6. The SMT Configuration Wizard is launched. See Section 1.3, “SMT Configuration Wizard”.

1.3 SMT Configuration Wizard

During the installation of SMT the two-step SMT Configuration Wizard is launched, regardless of the used installation method. Configure SMT using this wizard. You are able to change the configuration later using the YaST SMT Server Configuration module— see Chapter 2, SMT Server Configuration.

  1. The Enable Subscription Management Tool service (SMT) option is checked by default. Uncheck it only if you want to disable the installed SMT.

    If the firewall is enabled, check Open Port in Firewall to allow access to the SMT service from remote computers.

    Enter your Novell Customer Center organization credentials in User and Password. If you do not know your Novell Customer Center credentials, refer to Section 3.1, “Mirroring Credentials”. Test the entered credentials by pressing the Test button. SMT will connect to the Customer Center server using the provided credentials and download some testing data.

    Enter the e-mail address you have used for the Novell Customer Center registration into NCC E-mail Used for Registration.

    Your SMT Server URL should contain the URL of the SMT server being configured. It is populated automatically.

    Press Next to continue to the second configuration step.

  2. For security reasons, SMT requires a separate user to connect to the database. With the Database Password for smt User widget set the database password for that user. Confirm it in the following field.

    Enter all e-mail addresses that SMT should send reports to using the Add button. You are also able to Edit or Delete any incorrect or obsolete addresses.

    Then click Next.

  3. If the current MySQL root password is empty—as in any freshly installed system—you will be asked to enter a New MySQL Root Password.

1.4 Update of SMT From Previous Versions

This section contains the information about upgrading from the previous versions of SMT.

1.4.1 Update from Subscription Management Tool 11 SP2

There are two ways of upgrading SMT 11 SP2 to SMT 11 SP3:

  • Perform the on-line migration, using the wagon tool. For more information, refer to the general documentation for SUSE Linux Enterprise Server.

  • When upgrading SLES 11 to SP3 via booting the installation media, add the SMT add-on product. This will make sure that the SMT packages get updated together with SLES 11.

1.4.1.1 MySQL Database Migration

SLES11-SP3 introduces the upgrade of the MySQL database to version 5.5. This upgrade involves a change of the database format and the database needs to be converted accordingly.

After the MySQL database is upgraded, the database engine is not running. The database needs to be converted and MySQL started to continue using SMT. To migrate the MySQL database, run following commands as root:

touch /var/lib/mysql/.force_upgrade
rcmysql restart

We strongly recommend to back up the database before migrating it.

1.4.2 Update from Subscription Management Tool 10

In general, the update from SMT 10 is not supported. This is a list of issues that might occur if the update is performed:

1.4.2.1 Configuration Changes

Authentication of Access

There is a new optional value requiredAuthType in /etc/smt.conf to specify if authentication should be required to access the update repositories. If the value is not present in /etc/smt.conf, behavior is unchanged from SMT 10. See the SMT 11 manual for further details.

Registration URL Specific for SMT 11

SMT 11 does not use the registration URL from /etc/suseRegister.conf anymore, but reads the value [NU] NURegUrl from /etc/smt.conf. If the value is not present in /etc/smt.conf, the value from /etc/suseRegister.conf is used as a fallback.

Update of apache2 Configuration

The installed version of /etc/apache2/conf.d/nu_server.conf and /etc/apache2/conf.d/smt_mod_perl.conf will be replaced with a newer version.

1.4.2.2 Changes Related to Dropping Privileges by SMT Scripts

smt User

By default, all SMT scripts run under a new, unprivileged user named smt. The user can be defined in smt.conf.

Permissions of Files and Repositories

In SMT 10, all files and repositories were owned by root. In SMT 11, the smt user needs write access to these repositories. To fix up the permissions, use the changeSMTUserPermissions.sh script shipped as part of the SMT package.

Proxy Settings

The YaST proxy module writes the proxy information to /root/.curlrc. In SMT 11 the scripts are running with privileges dropped, therefore the .curlrc file in the home directory of the used user (smt by default) must be edited. Otherwise use smt.conf to define the proxy settings.

1.5 Migration between SUSE Customer Center and Novell Customer Center

SMT can talk to only one registration service (SUSE Customer Center, Novell Customer Center, alternatively also SUSE Lifecycle Management Server). The switch between the registration servers can be done either via a YaST module or command-line tools.

Before performing the switch between customer centers, make sure that the target customer center serves all products that are registered against SMT. Both YaST and the command-line tools perform a check to find out whether all products can be served with the new registration server. If it is not possible, the only option is to install two parallel SMT instances and to synchronize products from both SUSE Customer Center and Novell Customer Center.

To perform the migration to SUSE Customer Center via command-line, use:

smt ncc-scc-migration

If you need to revert back from SCC to NCC, use:

smt scc-ncc-migration

The migration itself is time-consuming and during the migration process the SMT server may not be able to serve clients that are already registered.

The migration process itself changes the registration server and the proper type of API in the configuration files. No further (configuration) changes are needed on the SMT.

To migrate between Novell Customer Center and SUSE Customer Center via YaST, use the YaST smt-server module.

After migration is done, it is needed to re-synchronize SMT with the customer center. It is recommended to assure that the repositories are up-to-date. This can be done using the following commands:

   smt sync
   smt mirror

1.6 Enabling SLP Announcements

SMT already includes the SLP service description file (/etc/slp.reg.d/smt.reg). In order to enable SLP announcements of the SMT service, open respective ports in your firewall and enable the SLP service.

sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_SERVICES_EXT_TCP "427"
sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_SERVICES_EXT_UDP "427"
insserv slpd
rcslpd start
Print this page