Novell SUSE Linux Enterprise Subscription Management Tool Guide
SUSE Linux Enterprise
www.novell.com10 SP2
September23,2008 Subscription Management Tool Guide
Subscription Management Tool Guide
List of Authors: Jakub Friedl
All content is copyright © Novell, Inc.
Legal Notice
This manual is protected under Novell intellectual property rights. By reproducing, duplicating or
distributing this manual you explicitly agree to conform to the terms and conditions of this license
agreement.
This manual may be freely reproduced, duplicated and distributed either as such or as part of a bundled
package in electronic and/or printed format, provided however that the following conditions are fullled:
That this copyright notice and the names of authors and contributors appear clearly and distinctively
on all reproduced, duplicated and distributed copies. That this manual, specically for the printed
format, is reproduced and/or distributed for noncommercial use only. The express authorization of
Novell, Inc must be obtained prior to any other use of any manual or part thereof.
For Novell trademarks, see the Novell Trademark and Service Mark list http://www.novell
.com/company/legal/trademarks/tmlist.html. * Linux is a registered trademark of
Linus Torvalds. All other third party trademarks are the property of their respective owners. A trademark
symbol (®, ™ etc.) denotes a Novell trademark; an asterisk (*) denotes a third party trademark.
All information found in this book has been compiled with utmost attention to detail. However, this
does not guarantee complete accuracy. Neither Novell, Inc., SUSE LINUX Products GmbH, the authors,
nor the translators shall be held liable for possible errors or the consequences thereof.
Contents
1 SMT Installation 1
1.1 Installation During the Initial Installation Process . . . . . . . . . . . . 1
1.2 Installation On Top of an Already Installed System . . . . . . . . . . . 2
1.3 SMT Conguration Wizard . . . . . . . . . . . . . . . . . . . . . . 3
2 Conguring SMT Using YaST 5
2.1 Activating and Deactivating SMT with YaST . . . . . . . . . . . . . . . 6
2.2 Setting NU Credentials with YaST . . . . . . . . . . . . . . . . . . . 8
2.3 Setting SMT Database Password with YaST . . . . . . . . . . . . . . . 9
2.4 Setting E-mail Addresses to Receive Reports with YaST . . . . . . . . . 10
2.5 Setting the SMT Job Schedule with YaST . . . . . . . . . . . . . . . 10
3 Mirroring Installation and Update Sources Using SMT 13
3.1 Getting Mirror Credentials . . . . . . . . . . . . . . . . . . . . . 13
3.2 Managing Software Catalogs with SMT . . . . . . . . . . . . . . . . 14
3.3 The /srv/www/htdocs Structure . . . . . . . . . . . . . . . . . . . 19
3.4 Using Test Environment . . . . . . . . . . . . . . . . . . . . . . 20
4 Managing Client Machines With SMT 21
4.1 Listing Registered Clients . . . . . . . . . . . . . . . . . . . . . . 21
4.2 Deleting Registrations . . . . . . . . . . . . . . . . . . . . . . . 21
4.3 Manual Registration of Clients at Novell Customer Center . . . . . . . . 22
4.4 Scheduling Periodic Registrations of Clients at Novell Customer Center . . 22
5 SMT Reports 25
5.1 Report Schedule and Recipients . . . . . . . . . . . . . . . . . . . 25
5.2 Types of SMT Reports . . . . . . . . . . . . . . . . . . . . . . . 26
5.3 Report Output Formats and Targets . . . . . . . . . . . . . . . . . 26
6 SMT Tools and Conguration Files 29
6.1 Important Scripts and Tools . . . . . . . . . . . . . . . . . . . . 29
6.2 SMT Conguration Files . . . . . . . . . . . . . . . . . . . . . . 37
6.3 Server Certicates . . . . . . . . . . . . . . . . . . . . . . . . . 44
7 Conguring Clients to Use SMT 49
7.1 Using Kernel Parameters to Access an SMT Server . . . . . . . . . . . 50
7.2 Conguring Clients Using AutoYaST Prole . . . . . . . . . . . . . . 51
7.3 Conguring Clients Using the clientSetup4SMT.sh Script . . . . . . . . . 52
7.4 Registering Clients Against SMT Test Environment . . . . . . . . . . . 53
SMT Installation
SMT is distributed as an add-on product for SUSE Linux Enterprise Server 10 SP2
system. To install it, install the SUSE Linux Enterprise Server 10 SP2 base system.
You can choose to install the SMT add-on together with your base system during the
initial installation process, or you can install the SMT add-on on top of an already installed base system at any later time.
1.1 Installation During the Initial Installation Process
To install SMT add-on together with your base system during the initial installation
process, follow these steps:
Start SUSE Linux Enterprise Server 10 SP2 installation as usual. For more infor-
1
mation, see the SUSE Linux Enterprise Server documentation.
To include the SMT add-on product, check the Include Add-On Products from
2
Separate Media option in the Installation Mode dialog in the System Analysis
step and click Next.
1
In the next dialog, click Add and, if you are installing SMT from a CD medium,
3
select CD as the source type. If you are installing from a different source, such
as NFS or HTTP, choose the appropriate source type. Click Next.
SMT Installation 1
If you are installing from CD, insert the SMT add-on product CD. If you are in-
4
stalling from a different source, provide the necessary source. Click Continue.
Conrm the SMT license agreement and click Next.
5
The SMT add-on product is displayed in the overview. Continue with the instal-
6
lation as usual. Make sure, that the SMT: Subscription Management Tool for SLE
installation pattern is selected automatically and do not remove it.
A two-step SMT Conguration Wizard is shown during the nal steps of the in-
7
stallation workow. Congure SMT as described in Section 1.3, “SMT Congu-
ration Wizard” (page 3) 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:
Start YaST and select Software > Add-On Product.
1
If you are installing SMT from a CD medium, select CD as the source type. If
2
you are installing from a different source, such as NFS or HTTP, choose the appropriate source type. Click Next.
If you are installing from CD, insert the SMT add-on product CD. If you are in-
3
stalling from a different source, provide the necessary source. Click Continue.
Conrm the SMT license agreement and click Next.
4
Click Accept to install the SMT: Subscription Management Tool for SLE pattern.
5
The SMT Conguration Wizard is launched. See Section 1.3, “SMT Conguration
6
Wizard” (page 3).
2 Subscription Management Tool Guide
1.3 SMT Conguration Wizard
During the installation of SMT the two-step SMT Conguration Wizard is launched,
irrespective of the used installation method. Congure SMT using this wizard. However,
you will be able to change the conguration later using the YaST SMT Conguration
module.
The Enable Subscription Management Tool service (SMT) option is checked by
1
default. Uncheck it only if you want to disable the installed SMT.
If the rewall is enabled, check Open Port in Firewall to allow access to the
SMT service from remote computers.
Enter your Novell Customer Center mirroring credentials in NU User and NU
Password. NU stands for Novell Update. If you do not know your Novell Customer Center credentials, refer to Section 3.1, “Getting Mirror Credentials”
(page 13). 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 congured. It is lled in automatically.
Press Next to continue to the second conguration step.
For security reasons, SMT uses a special user in the database. Set the SMT
2
Database Password in the respective elds. The password should not be empty.
Enter all e-mail addresses SMT should send reports to using the Add button. You
are also able to Edit or Delete any incorrect or needless addresses.
Press Next.
If the current MySQL root password is empty—as in any freshly installed sys-
3
tem— you will be asked to enter a New MySQL Root Password.
SMT Installation 3
Conguring SMT Using YaST
SMT can be activated and congured using a graphical interface. A special YaST
module has been created for this purpose. The YaST SMT Conguration module can
be used to congure mirroring credentials, SMT database passwords and e-mail addresses to send SMT reports to, or to set the SMT job schedule, and activate or deactivate
the SMT service.
To congure SMT using the YaST SMT Conguration module, follow these steps:
To start YaST SMT module with text (ncurses) interface, run the yast smt
1
command as root.
To start the YaST SMT module with graphical interface, run yast2 smt as
root or open YaST Control Center and select SMT Conguration in the Network
Services section.
To activate SMT, check the Enable Subscription Management Tool Service
2
(SMT) option in the Customer Center Access tab. If you want to disable SMT,
uncheck this option. For more information about activating SMT using YaST,
see Section 2.1, “Activating and Deactivating SMT with YaST” (page 6)
In the Customer Center Access tab, set and test credentials for the NU (Novell
3
Update) service. Correct credentials are necessary to enable mirroring from NU
and determine the products that should be mirrored. Also set the e-mail address
used for the registration and the URL of your SMT server. For more information,
see Section 2.2, “Setting NU Credentials with YaST” (page 8).
2
Conguring SMT Using YaST 5
In the Database and Reporting tab, set the password for the SMT user in the
4
MySQL database and enter the e-mail addresses where reports should be sent to.
For more information, see Section 2.3, “Setting SMT Database Password with
YaST” (page 9) and Section 2.4, “Setting E-mail Addresses to Receive Reports
with YaST” (page 10).
In the Scheduled SMT Jobs tab, set a schedule of periodic SMT jobs, such as
5
synchronization of updates, Novell Customer Center registration, or SMT report
generation. For more information, see Section 2.5, “Setting the SMT Job
Schedule with YaST” (page 10).
If satised with the conguration, click Finish. YaST adjusts the SMT congu-
6
ration and starts or restarts necessary services.
If you want to abort the conguration and cancel any changes, click Abort.
NOTE
When the YaST SMT module applies conguration changes, it checks for
the existence of the common server certicate. If the certicate does
not exist, you will be asked whether the certicate should be created
and the YaST CA Management module will be started, if you approve.
2.1 Activating and Deactivating SMT with YaST
YaST provides an easy way to activate or deactivate the SMT service. To activate SMT
service using YaST, follow these steps:
Open the Customer Center Access tab of the YaST SMT Conguration module.
1
Check the Enable Subscription Management Tool service (SMT) option.
2
NOTE
Note that if not already congured, mirroring credentials should be
congured before activating SMT. For more information about how to
6 Subscription Management Tool Guide
set mirroring credentials using YaST, see Section 2.2, “Setting NU Creden-
tials with YaST” (page 8).
Click Finish to apply the changes and leave YaST SMT Conguration module.
3
To deactivate SMT service using YaST, follow these steps:
Open the Customer Center Access tab of the YaST SMT Conguration module.
1
Uncheck the Enable Subscription Management Tool service (SMT) option.
2
Click Finish to apply the changes and leave YaST SMT Conguration module.
3
When activating SMT, the following important operations are performed by YaST:
• The Apache conguration is changed by creating symbolic links in the /etc/
apache2/conf.d/ directory. Links to the /etc/smt.d/nu_server.conf
and /etc/smt.d/smt_mod_perl.conf les are created there.
• The Apache Web server is started or reloaded if already running.
• The MySQL server is started or reloaded if already running. If it does not exist,
smt user and necessary tables in the database are created.
• The schema of the SMT database is checked. If the database schema is obsolete,
the SMT database is upgraded to conform to the current schema.
• Cron is adjusted by creating a symbolic link in the /etc/cron.d/ directory. A
link to the /etc/smt.d/novell.com-smt le is created there.
When deactivating SMT, the following important operations are performed by YaST:
• Symbolic links created upon SMT activation in the /etc/apache2/conf.d/
and /etc/cron.d/ directories are deleted.
• The Cron, Apache Web and MySQL servers are reloaded. Neither Apache nor
MySQL are stopped, because they may be used for other purposes than the SMT
service.
Conguring SMT Using YaST 7
2.2 Setting NU Credentials with YaST
YaST provides a comfortable interface to set and test NU credentials and the URL of
the NU service. To do so, follow these steps:
Figure 2.1
Open the Customer Center Access tab of the YaST SMT Conguration module.
1
If the credentials have been already set using YaST or the /etc/smt.conf
conguration le, they appear in the dialog. Otherwise, the NU User and NU
Password elds are blank.
Setting NU Credentials with YaST
If you do not have your credentials, visit Novell Customer Center to obtain them.
2
For more information, see Section 3.1, “Getting Mirror Credentials” (page 13).
Enter your NU username in NU User and the corresponding password in NU
3
Password.
Press Test to check the credentials. YaST will try to download a list of available
4
repositories using the provided credentials. If the test succeeded, the last line of
8 Subscription Management Tool Guide
the test results will read Test result: success. If the test fails, check the
provided credentials and try again.
Figure 2.2
Enter the NCC E-mail Used for Registration. This should be the address you
5
used to register to Novell Customer Center.
Enter Your SMT Server URL if it has not been detected automatically.
Press Finish or continue with other congurations.
6
Succesful Test of NU Credentials
2.3 Setting SMT Database Password with YaST
For security reasons, SMT uses its own user in the database. YaST provides a comfortable interface for setting up or changing the SMT database password. To set or change
the SMT database password using YaST follow these steps:
Open the Database and Reporting tab of the YaST SMT module.
1
Enter the SMT Database Password for smt User. Conrm the password by
2
reentering it and press Finish or continue with other congurations.
Conguring SMT Using YaST 9
2.4 Setting E-mail Addresses to Receive Reports with YaST
YaST SMT Conguration module provides a comfortable interface for setting up a list
of e-mail addresses SMT reports will be sent to. To edit the list of addresses to receive
the reports, follow these steps:
Open the Database and Reporting tab of the YaST SMT Conguration module.
1
The list of e-mail addresses to send reports to is shown in the table. You can Add,
2
Edit, or Delete addresses using the respective buttons.
Press Finish or continue with other congurations.
3
The comma separated list of adresses SMT reports should be sent to is written to the
reportEmail option of the /etc/smt.conf conguration le.
2.5 Setting the SMT Job Schedule with YaST
The YaST SMT Conguration module provides a comfortable interface to schedule
periodical SMT jobs. YaST uses cron to schedule congured jobs. If needed, cron
can be used directly. Three types of periodical jobs can be set:
Synchronization of Updates
Synchronizes with Novell Customer Center, updates catalogs, and downloads new
updates.
Report Generation
Generates and sends SMT reports to addresses dened in Section 2.4, “Setting E-
mail Addresses to Receive Reports with YaST” (page 10).
NCC Registration
Registers all clients to Novell Customer Center that are not already registered or
that changed their data since the last registration.
10 Subscription Management Tool Guide
Figure 2.3
To congure the schedule of SMT jobs using YaST, follow these steps:
Open the Scheduled SMT Jobs tab of the YaST SMT Conguration module. The
1
table contains a list of all scheduled jobs, their type, frequency, date, and time
to run. You can add, delete or edit these scheduled events.
If you want to add a scheduled SMT job, press Add. The Adding New SMT
2
Scheduled Job dialog opens.
Setting SMT Job Schedule with YaST
Choose the synchronization job to schedule. You can choose between Synchronization of Updates, Report Generation, and NCC Registration.
Choose the Frequency of the new scheduled SMT job. Jobs can be performed
Daily, Weekly, Monthly, or Periodically (every n-th hour or every m-th minute).
Set the Job Start Time by entering Hour and Minute. In case of periodical frequency, enter the respective periods. For weekly and monthly schedules, select
Day of the Week or Day of the Month.
Press Add.
If you want to edit a scheduled SMT job, for example, change its frequency,
3
time, or date, select the job in the table and press Edit. Then change any parameters as if you were creating a new schedule and press OK.
Conguring SMT Using YaST 11
If you want to cancel a scheduled job and delete it from the table, select the job
4
in the table and press Delete.
Press Finish to apply the settings and quit the YaST SMT Conguration module
5
or continue with other congurations.
12 Subscription Management Tool Guide
Mirroring Installation and Update Sources Using SMT
SMT provides the possibility to mirror installation and update sources locally and to
bypass per-machine downloads and the bandwidth charges that go with it.
3.1 Getting Mirror Credentials
Before creating local mirrors of the repositories, you need to have proper mirror credentials. You can get these credentials from the Novell Customer Center by following these
steps:
Visit Novell Customer Center at http://www.novell.com/center and
1
log in.
Click on My Products. The list of product families is shown.
2
Expand any product family by clicking on its name. You can also expand all
3
product families by clicking on the icon showing the arrow with two converse
arrowheads (with the Expand All Product Families tooltip). Products in the expanded families are shown.
Double click on any specic product in the list to show detailed information
4
about the product.
3
In the Downloads section, click on the Mirror Credentials link.
5
Mirroring Installation and Update Sources Using SMT 13
The credentials and mirror sites will be listed. These values are the same for all
6
users and subscriptions for a specic company.
Figure 3.1
NU Credentials in Novell Customer Center
The obtained credentials should be set in the YaST SMT module or manually written
in the /etc/smt.conf le. For more information about conguring NU credentials
using YaST, see Chapter 2, Conguring SMT Using YaST (page 5). For more infor-
mation about the /etc/smt.conf le, see Section 6.2.1, “/etc/smt.conf” (page 37)
3.2 Managing Software Catalogs with SMT
This section describes tools and procedures for viewing information about software
catalogs available through SMT, conguring these catalogs and setting new custom
catalogs.
14 Subscription Management Tool Guide
Loading...