Installation guide

Figure 8.2. User De let e Confirmat ion
Many other options exist for managing users. You can find instructions for them in the RHN website
chapter of the RHN Reference Guide.
8.8.2. Configuring Satellite Search
Satellite Administrators may want to configure certain search options to customize search results for
their own optimization requirements.
RHN Satellite search results can be customized via the /etc/rhn/search.rhn-search.conf file.
The following list defines the search configuration and their default values in parentheses.
search.index_work_dir : Specifies where Lucene indexes are kept
(/usr/share/rhn/search/indexes)
search.rpc_handlers : semi-colon separated list of classes to act as handlers for XMLRPC calls.
(filename>index:com .redhat.satellite.search.rpc.handlers.IndexHandler,
db:com .redhat.satellite.search.rpc.handlers.DatabaseHandler,
admin:com .redhat.satellite.search.rpc.handlers.Adm inHandler)
search.max_hits_returned : maximum number of results which will be returned for the query (500)
search.connection.driver_class : JDBC driver class to conduct databas e searches
(oracle.jdbc.driver.OracleDriver)
search.score_threshold : minimum score a result needs to be returned back as query result (.10)
search.system_score_threshold : minimum score a system search res ult needs to be returned back
as a query result (.01)
search.errata_score_threshold : minimum score an errata search result needs to be returned back
as a query result (.20)
search.errata.advisory_score_thres hold : minimum score an errata advisory result needs to be
returned back as a query result (.30)
search.min_ngram : minimum length of n-gram characters. Note that any change to this value
requires clean-index to be run, and doc-indexes need to be modified and rebuilt) (1)
search.max_ngram : maximum length of n-gram characters. Note that any change to this value
requires clean-index to be run, and doc-indexes need to be modified and rebuilt) (5)
search.doc.limit_results : type true to limit the number of results both on search.score_threshold
and restrict max hits to be below search.max_hits_returned; type false means to return all
documentation search matches (false)
search.schedule.interval : input the time in miliseconds to control the interval with which the
SearchServer polls the databas e for changes; the default is 5 minutes (300000).
search.log.explain.results : used during development and debugging. If set to true, this will log
additional information showing what influences the score of each result. (false)
8.9. Automating Synchronization
Manually synchronizing the RHN Satellite repository with Red Hat Network can be a time-intens ive task.
United States business hours tend to be the peak usage time for Red Hat Network, so synchronization
at that time may be slow. For thes e reasons, Red Hat encourages you to automate synchronization at
other times to better balance load and ensure quick synchronization. Continental United States business
hours are roughly 8:00 AM to 9:00 PM EST (UTC -5), due to four time zones, Monday through Friday.
These hours may vary seasonally by one hour. Further, Red Hat strongly recommends that
synchronization occur randomly for best performance.
This automation can be set easily by the addition of a simple cron job. To do this, edit the crontab as
root:
crontab -e
This opens the crontab in a text editor, by default Vi. Another editor can be used by first changing the
EDIT OR variable, like so: export EDIT OR=gedit.
Once opened, use the first five fields (minute, hour, day, month, and weekday) to schedule the
synchronization. Remember, hours use military time. Edit the crontab to include random synchronization,
like so:
0 1 * * * perl -le 'sleep rand 9000' && satellite-sync --email >/dev/null \
2>/dev/null
This particular job will run randomly between 1:00 a.m. and 3:30 a.m. system time each night and redirect
stdout and stderr from cron to prevent duplicating the more easily read message from
satellite-sync. Options other than --em ail can also be included. Refer to T able 6.2, “Satellite
Import/Sync Options” for the full list of options. Once you exit from the editor, the modified crontab is
installed immediately.
8.10. Implementing PAM Authentication
RHN Satellite supports network-based authentication systems s uch as LDAP and Kerberos, using
Pluggable Authentication Modules (PAM). PAM is a suite of libraries that helps s ystem administrators
integrate the Satellite with a centralized authentication mechanism, thus eliminating the need for
remembering multiple passwords.
Chapter 8. Maintenance
39