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

2 SMT Server Configuration

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:

  1. Start the YaST module SMT Server Configuration from the YaST control center or by running yast smt-server on the command line.

  2. To activate SMT, check the Enable Subscription Management Tool Service (SMT) option in the Customer Center Access 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”.

  3. If the firewall is enabled, check Open Port in Firewall.

  4. In the Customer Center Configuration section of the Customer Center Access tab, choose which service should be used (Novell Customer Center or SUSE Customer Center) and, if necessary, set the custom server URLs. Set and test credentials for the NU (Novell 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 and your SMT server URL. For more information, see Section 2.2, “Setting NU Credentials with YaST”.

  5. In the Database and Reporting 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”.

  6. In the Scheduled SMT Jobs tab, set a schedule of periodic SMT jobs, such as synchronization of updates, Novell Customer Center registration, and SMT report generation. For more information, see Section 2.5, “Setting the SMT Job Schedule with YaST”.

  7. If satisfied with the configuration, click OK. YaST adjusts the SMT configuration and starts or restarts necessary services.

    If you want to abort the configuration and cancel any changes, click Cancel.

    Note
    Note

    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.

2.1 Activating and Deactivating SMT with YaST

YaST provides an easy way to activate or deactivate the SMT service. To activate SMT with YaST, follow these steps:

  1. Open the Customer Center Access tab of the SMT Configuration .

  2. Check the Enable Subscription Management Tool service (SMT) option.

    Note
    Note

    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 NU Credentials with YaST”.

  3. Click Finish to apply the changes and leave the SMT Configuration.

To deactivate SMT with YaST, follow these steps:

  1. Open the Customer Center Access tab of the SMT Configuration.

  2. Uncheck the Enable Subscription Management Tool service (SMT) option.

  3. Click Finish 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 MySQL 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.

2.2 Setting NU Credentials with YaST

YaST provides an interface to set and test NU credentials and the URL of the NU service. To do so, follow these steps:

Setting NU Credentials with YaST
Figure 2.1: Setting NU Credentials with YaST
  1. Open the Customer Center Access tab of the SMT Configuration (NU Configuration). If the credentials have been already set with YaST or the /etc/smt.conf configuration file, they appear in the dialog. Otherwise, the User and Password fields are blank.

  2. If you do not have your credentials, visit Novell Customer Center to obtain them. For more details, see Section 3.1, “Mirroring Credentials”.

  3. Enter your NU username in User and the corresponding password in Password.

  4. Click Test 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.

    Successful Test of NU Credentials
    Figure 2.2: Successful Test of NU Credentials
  5. Enter the NCC E-mail Used for Registration. This should be the address you used to register to Novell Customer Center.

    Enter Your SMT Server URL if it has not been detected automatically.

  6. Click OK or continue with other configurations.

2.3 Setting SMT Database Password with YaST

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:

  1. Open the Database and Reporting tab of the SMT Configuration module.

  2. Enter the SMT Database Password for SMT User. Confirm the password by reentering it and click OK, or continue with other configurations.

2.4 Setting E-mail Addresses to Receive Reports with YaST

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:

  1. Open the Database and Reporting tab of the SMT Configuration.

  2. The list of e-mail addresses is shown in the table. You can Add, Edit, or Delete addresses with the relevant buttons.

  3. Click OK 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.

2.5 Setting the SMT Job Schedule with YaST

The SMT Configuration module provides an interface to schedule periodical SMT jobs. YaST uses cron to schedule configured jobs. If needed, cron can be used directly. Five types of periodical jobs can be set:

Synchronization of Updates

Synchronizes with Novell Customer Center, updates repositories, and downloads new updates.

Generation of Reports

Generates and sends SMT Subscription Reports to addresses defined in Section 2.4, “Setting E-mail Addresses to Receive Reports with YaST”.

NCC Registration

Registers all clients to Novell Customer Center that are not already registered or that changed their data since the last registration.

Job Queue Cleanup

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.

Uploading Support Configs

Uploading support configs is only available, when the SMT-support package is installed and manually added. To add it, click Add, then select Uploading Support Configs from the Job to Run list.

SMT Job Schedule Configuration
Figure 2.3: SMT Job Schedule Configuration

To configure the schedule of SMT jobs with YaST, follow these steps:

  1. Open the Scheduled SMT Jobs 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.

  2. If you want to add a scheduled SMT job, click Add. The Adding New SMT Scheduled Job dialog opens.

    Choose the synchronization job to schedule. You can choose between Synchronization of Updates, Report Generation, NCC Registration, Job Queue Cleanup, and Uploading Support Configs.

    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 relevant periods. For weekly and monthly schedules, select Day of the Week or Day of the Month.

    click Add.

  3. 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 Edit. Then change the desired parameters and click OK.

  4. If you want to cancel a scheduled job and delete it from the table, select the job in the table and click Delete.

  5. Click OK to apply the settings and quit the SMT Configuration, or continue with other configurations.

Print this page