The main SMT configuration file is /etc/smt.conf. You can set most of the options with the YaSTSMT Server module. Another important configuration file is /etc/smt.d/smt-cron.conf, which contains parameters for commands launched as SMT scheduled jobs.
The /etc/smt.conf file has several sections. The [NU] section contains the update credentials and URL. The [DB] section contains the configuration of the MySQL database for SMT. The [LOCAL] section includes other configuration data. The [REPORT] section contains the configuration of SMT reports.
WARNING:The /etc/smt.conf contains passwords in clear text and its default permissions (640, root, wwwrun) make its content easily accessible with scripts running on the Apache server. Be careful with running other software on the SMT Apache server. The best policy is to use this server only for SMT.
The following options are available in the [NU] section:
URL of the update service. In most cases, it should contain the https://nu.novell.com/ URL.
URL of the update registration service. It is used by smt-sync. If this option is missing, the URL from /etc/suseRegister.conf is used as a fallback.
NUUser should contain the username for update service. For information about getting organization credentials, see Mirroring Credentials. You can set this value with the SMT Server.
NUPass is the password for the user defined in NUUser. For information about getting organization credentials, see Mirroring Credentials You can set this value with the SMT Server.
ApiType is the type of the service SMT uses, it is NCC for Micro Focus Customer Center.
The three options defined in the [DB] section are used for configuring the database for SMT. Currently, only MySQL is supported by SMT.
The first parameter of the DBI->connect Perl method used for connection to the MySQL database. The value should be in the form
dbi:mysql:database=smt;host=localhost
where smt is the name of the database and localhost is the hostname of the database server.
The user for the database. The default value is smt.
The password for the database user. You can set the password with the YaST SMT Server module.
The following options are available in the [LOCAL] section:
The base URL of the SMT server which is used to construct URLs of the repositories available on the server. This value should be set by YaST automatically during installation. The format of this option should be: https://server.domain.tld/.
You can change the URL manually. For example, the administrator may choose to use the http:// scheme instead of https:// for performance reasons. Another reason may be using an alias (configured with CNAME in DNS) instead of the hostname of the server, for example http://smt.domain.tld/ instead of http://server1.domain.tld/.
E-mail address used for registration at the Micro Focus Customer Center. The SMT administrator can set this value with the YaST SMT Server module.
Determines the path to mirror to.
If the MirrorAll option is set to true, the smt-sync script will set all repositories that can be mirrored to be mirrored (DOMIRROR flag).
If the MirrorSRC option is set to true, source RPM packages are mirrored.
NOTE: Default Value Changed with SMT 11 SP2
With SMT 11 SP2, the preset default value was changed to false. If you also want SMT to mirror source RPM packages on new installations, set MirrorSRC to true.
Upgraded systems are not affected.
Determine if the clients registered at SMT should be registered at Micro Focus Customer Center, too. If the forwardRegistration option is set to true, client registrations will be forwarded to Micro Focus Customer Center. If the forwardRegistration option is set to false, no client registrations will be sent to Micro Focus Customer Center.
Specify a delay in seconds before registration of clients at Micro Focus Customer Center. The value is a random number between 0 and 450, generated by the YaST SMT Server module. The purpose of this random delay is to prevent a high load on the Micro Focus Customer Center server that would occur if all smt-register cron jobs connected at the same time.
If you do not want to use global proxy settings, specify the proxy to be used for HTTP connection here. Use the following form: http://proxyexample.com.:3128.
If the proxy settings are not configured in /etc/smt.conf, the global proxy settings configured in /etc/syconfig/proxy are used. You can configure the global proxy settings with the YaST Proxy module.
The HTTPProxy also applies to the smt-mirror-sle9 script.
If you do not want to use global proxy settings, specify the proxy to be used for HTTPS connection here. Use the form : http://proxyexample.com.:3128.
If the proxy settings are not configured in /etc/smt.conf, the global proxy settings configured in /etc/syconfig/proxy are used. You can configure the global proxy settings with the YaST Proxy module.
The HTTPSProxy also applies to the smt-mirror-sle9 script.
If your proxy requires authentication, specify a user name and password here, using the username:password format.
If the proxy settings are not configured in /etc/smt.conf, the global proxy settings configured in /etc/syconfig/proxy are used. You can configure the global proxy settings with the YaST Proxy module.
HINT: Global User Authentication Setting
If you configure the global proxy settings with YaST, manually copy /root/.curlrc to the home directory of the smt and adjust the permissions with the following commands as root:
cp /root/.curlrc /var/lib/smt/ chown smt:www /var/lib/smt/.curlrc
Neither the ProxyUser value nor the global proxy authentication settings apply to the smt-mirror-sle9 script. For user authentication in smt-mirror-sle9 write the following in the $HOME/.wgetrc file: proxy_user=username proxy_password=password.
Specify an authentication type to access the repository. There are three possible types:
none - no authentication is required. This is the default value
lazy - only username and password are checked. A valid user can access all repositories.
strict - checks also if the user has access to the repository.
Specify a user name of a Unix user under which all smt commands will run.
Specify the ID of the GPG key to sign modified repositories. The user specified under smtUser needs to have access to the key. If this option is not set, the modified repositories will be unsigned.
The following options are available in the [REST] section:
If set to 1, turns administrative access to the SMT RESTService on. Default value is 0.
Specify the user name which the REST-Admin uses to login. Default value is RESTroot.
Specify the password for the REST-Admin user. The option has no default value. An empty password is invalid.
The following options are available in the [JOBQUEUE] section:
Specify the maximum age of finished non-persistent jobs in days. Default value is 8.
The following options are available in the [REPORT] section:
A comma separated list of e-mail addresses to send SMT status reports to. You can set this list with the YaST SMT Server module.
From field of report e-mails. If not set, the default root@hostname.domainname will be used.
Relay mail server. If empty, e-mails are sent directly.
Port of the relay mail server set in mailServer.
User name for authentication to the mail server set in mailServer.
Password for authentication to the mail server set in mailServer.
Each product to be mirrored by the smt-mirror-sle9 command has a separate predefined YOU9-* section in the /etc/smt.conf configuration file. /etc/smt.conf is not configured via the SMT database like the smt-mirror command, all configuration is contained in /etc/smt.conf.
A product to be mirrored. For example Novell-Linux-Desktop.
Comma-separated list of architectures to be mirrored. For example i386,x86_64. Remove any architectures that do not need to be mirrored.
The version of the product to be mirrored, for example 9.
If you want to mirror this product, set mirror to true.
If you want to mirror this product, provide credentials in the user:password format. Note that these credentials differ from the mirroring credentials used for SLES 10 and 11. You need to use the NCC login credentials here.
Example 8-1 smt.conf
[NU] NUUrl = https://nu.novell.com/ NURegUrl = https://secure-www.novell.com/center/regsvc/ NUUser = exampleuser NUPass = examplepassword ApiType = NCC [DB] config = dbi:mysql:database=smt;host=localhost user = smt pass = smt [LOCAL] # Default should be http://server.domain.top/ url = http://smt.example.com/ # This email address is used for registration at NCC nccEmail = exampleuser@example.com MirrorTo = /srv/www/htdocs MirrorAll = false MirrorSRC = false forwardRegistration = true rndRegister = 127 # The hook script that should be called before the smt-mirror script removes its lock mirror_preunlock_hook = # The hook script that should be called after the smt-mirror script removed its lock mirror_postunlock_hook = # specify proxy settings here, if you do not want to use the global proxy settings # If you leave these options empty the global options are used. # # specify which proxy you want to use for HTTP connection # in the form http://proxy.example.com:3128 HTTPProxy = # specify which proxy you want to use for HTTPS connection # in the form http://proxy.example.com:3128 HTTPSProxy = # specify username and password if your proxy requires authentication # in the form username:password ProxyUser = # # require authentication to access the repository? # Three possible authtypes can be configured here # 1) none : no authentication required (default) # 2) lazy : check only username and password. A valid user has access to all repositories # 3) strict : check also if this user has access to the repository. # requiredAuthType = none # # the smt commands should run with this unix user # smtUser = smt # # ID of the GPG key to be used to sign modified (filtered) repositories. # The key must be accessible by the user who runs SMT, i.e. the user specified # in the 'smtUser' configuration option. # # If empty, the modified repositories will be unsigned. # signingKeyID = # # This string is send in HTTP requests as UserAgent. # If the key UserAgent does not exist, a default is used. # If UserAgent is empty, no UserAgent string is set. # #UserAgent= # Organization credentials for this SMT server. # These are currently only used to get list of all available repositories # from https://your.smt.url/repo/repoindex.xml # Note: if authenticated as a client machine instead of these mirrorUser, # the above URL returns only repositories relevant for that client. mirrorUser = mirrorPassword = [REST] # Enable administrative access to the SMT RESTService by setting enableRESTAdminAccess=1 # default: 0 enableRESTAdminAccess = 0 # Define the username the REST-Admin uses for login # default: RESTroot RESTAdminUser = RESTroot # Define the password for the REST-Admin (note: empty password is invalid) # default: <empty> RESTAdminPassword = [JOBQUEUE] # maximum age of finished (non-persistent) jobs in days # default: 8 maxFinishedJobAge = 8 # comma separated list of JobQueue status IDs that should be interpreted as successful # See smt-job --help for more information about possible Status IDs # Please note: An empty string will be interpreted as default (1,4). # default: 1,4 # useful: 1,4,6 jobStatusIsSuccess = 1,4 [REPORT] # comma separated list of eMail addresses where the status reports will be sent to reportEmail = exampleuser@example.com # from field of report mails - if empty it defaults to "root@<hostname>.<domainname>" reportEmailFrom = # relay mail server - leave empty if mail should be sent directly mailServer = mailServerPort = # mail server authentication - leave empty if not required mailServerUser = mailServerPassword = [YOU9-SLES-SDK] mirror_prod = SLES-SDK mirror_archs = i386,ia64,ppc,s390,s390x,x86_64 mirror_version = 9 mirror = false credentials = [YOU9-SUSE-CORE] mirror_prod = SUSE-CORE mirror_archs = i386,ia64,ppc,s390,s390x,x86_64 mirror_version = 9 mirror = false credentials = [YOU9-SUSE-SLES] mirror_prod = SUSE-SLES mirror_archs = i386,ia64,ppc,s390,s390x,x86_64 mirror_version = 9 mirror = false credentials =
The /etc/smt.d/smt-cron.conf configuration file contains options of the SMT commands launched as SMT scheduled jobs set with YaST (see Setting the SMT Job Schedule with YaST). Cron is used to launch these scheduled jobs. The cron table is located in the /etc/cron.d/novell.com-smt file.
Contains parameters of the smt ncc-sync command, if called as a part of an SMT scheduled job via cron. The default value is "-L /var/log/smt/smt-ncc-sync.log --mail".
Contains parameters of the smt mirror command, if called as a part of an SMT scheduled job via cron. The default value is "-L /var/log/smt/smt-mirror.log --mail" .
Contains parameters of the smt register command, if called as a part of an SMT scheduled job via cron. The default value is "-r -L /var/log/smt/smt-register.log --mail" .
Contains parameters of the smt report command, if called as a part of an SMT scheduled job via cron. The default value is "--mail --attach -L /var/log/smt/smt-report.log" .
Contains parameters for smt jobqueue cleanup, if called as a part of an SMT scheduled job via cron. The default value is "--mail -L /var/log/smt/smt-jobqueuecleanup.log".