This chapter introduces the YaST configuration module for the SMT server. You can set and configure mirroring credentials, SMT database passwords, and e-mail addresses to send SMT reports to. It also lets you set the SMT job schedule, and activate or deactivate the SMT service.
To configure SMT with SMT Server Configuration, follow these steps:
Start the YaST module from
the YaST control center or by running yast
smt-server on the command line.
To activate SMT, check the option in the tab. If you want to disable SMT, uncheck this option. For more information about activating SMT with YaST, see Section 2.1, “Activating and Deactivating SMT with YaST”.
If the firewall is enabled, check .
In the section of the tab, you can set the custom server URLs. Set and test credentials for the SUSE Update service. Correct credentials are necessary to enable mirroring from the download server 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 the Update Server Credentials with YaST”.
In the tab, set the password for the SMT user in the MySQL database and enter the e-mail addresses where reports should be sent. For more information, see Section 2.3, “Setting SMT Database Password with YaST” and Section 2.4, “Setting E-mail Addresses to Receive Reports with YaST”.
In the tab, set a schedule of periodic SMT jobs, such as synchronization of updates, SUSE Customer Center registration, and SMT report generation. For more information, see Section 2.5, “Setting the SMT Job Schedule with YaST”.
If satisfied with the configuration, click . YaST adjusts the SMT configuration and starts or restarts necessary services.
If you want to abort the configuration and cancel any changes, click .
When the SMT Configuration applies configuration changes, it checks for the existence of the common server certificate. If the certificate does not exist, you will be asked if the certificate should be created.
YaST provides an easy way to activate or deactivate the SMT service. To activate SMT with YaST, follow these steps:
Open the tab of the SMT Configuration.
Check the option.
If not already configured, organization credentials should be configured before activating SMT. For more information about how to set organization credentials with YaST, see Section 2.2, “Setting the Update Server Credentials with YaST”.
Click to apply the changes and leave the SMT Configuration.
To deactivate SMT with YaST, follow these steps:
Open the tab of the SMT Configuration.
Uncheck the option.
Click to apply the changes and leave the SMT Configuration.
When activating SMT, the following important operations are performed by YaST:
The Apache configuration 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 files are created
there.
The Apache Web server is started (or reloaded if already running).
The Maria DB server is started (or reloaded if already running). The smt user and all necessary tables in the database are created as needed.
The schema of the SMT database is checked. If the database schema is outdated, 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 file 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 daemon, the Apache server and the MySQL database daemon are reloaded. Neither Apache nor MySQL are stopped, because they may be used for other purposes than the SMT service.
YaST provides an interface to set and test the download server credentials and the URL of the download server service. To do so, follow these steps:
Open the tab of the SMT
Configuration. If the credentials have been already set with YaST or
the /etc/smt.conf configuration file, they appear
in the dialog. Otherwise, the and
fields are blank.
If you do not have your credentials, visit SUSE Customer Center to obtain them. For more details, see Section 3.1, “Mirroring Credentials”.
Enter your user name in and the corresponding password in .
Click to check the credentials. YaST will try
to download a list of available repositories with the provided
credentials. If the test succeeds, the last line of the test results
will read Test result: success. If the test fails,
check the provided
credentials and try again.
Enter the . This should be the address you used to register to SUSE Customer Center.
Enter if it has not been detected automatically.
Click or continue with other configurations.
For security reasons, SMT uses its own user in the database. YaST provides an interface for setting up or changing the SMT database password. To set or change the SMT database password with YaST, follow these steps:
Open the tab of the SMT Configuration module.
Enter the . Confirm the password by re-entering it and click , or continue with other configurations.
YaST SMT provides an interface for setting up a list of e-mail addresses to which SMT reports will be sent. To edit this list of addresses, follow these steps:
Open the tab of the SMT Configuration.
The list of e-mail addresses is shown in the table. You can , , or addresses with the relevant buttons.
Click or continue with other configurations.
The comma-separated list of addresses for SMT reports is written to the
reportEmail option of the
/etc/smt.conf configuration file.
The SMT Configuration module provides an interface to
schedule periodic SMT jobs. YaST uses cron
to schedule configured jobs. If needed, cron
can be used directly. Five types of periodic jobs can be set:
Synchronizes with SUSE Customer Center, updates repositories, and downloads new updates.
Generates and sends SMT Subscription Reports to addresses defined in Section 2.4, “Setting E-mail Addresses to Receive Reports with YaST”.
Registers all clients to SUSE Customer Center that are not already registered or that changed their data since the last registration.
Cleans up queued jobs. It will remove finished or failed jobs from the job queue that are older than 8 days and remove job artifacts that remained in the database as result of an error.
To configure the schedule of SMT jobs with YaST, follow these steps:
Open the tab of the SMT Configuration. The 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, click . The dialog opens.
Choose the synchronization job to schedule. You can choose between , , , and .
Choose the of the new scheduled SMT job. Jobs can be performed , , , or (every n-th hour or every m-th minute).
Set the by entering and . In case of periodic frequency, enter the relevant periods. For weekly and monthly schedules, select or .
Click .
If you want to edit a scheduled SMT job (for example, change its frequency, time, or date), select the job in the table and click . Then change the desired parameters and click .
If you want to cancel a scheduled job and delete it from the table, select the job in the table and click .
Click to apply the settings and quit the SMT Configuration, or continue with other configurations.