rhn.conf(5)

NAME
rhn.conf - Configuration file for Spacewalk/Red Hat Satellite Server

SYNOPSIS
/etc/rhn/rhn.conf

DESCRIPTION
rhn.conf is a configuration file used for several services in Spacewalk/Red Hat Satellite server.

FORMAT

Format of /etc/rhn/rhn.conf is very simple. Each line is either a comment or a directive. Comment lines start with a # and are ignored. A directive line has the format below:

parameter = value

OPTIONS

Spacewalk/Red Hat Satellite includes dozens other options in /usr/share/rhn/config-defaults/*.conf which administrator can override in /etc/rhn/rhn.conf, but *** JUST CHANGE THOSE PARAMETERS IF YOU REALLY KNOW WHAT ARE YOU DOING! ***

The most important tunables parameters in /etc/rhn/rhn.conf are listed below:

traceback_mail
    Define which mail address will be used to notify about reports, warnings and Web traceback errors. Use commas to separate mail addresses.

    Default: none

mount_point
    Define the directory used to store the RPM package files offered by software channels. As a recommendation, we suggest at least 30 GB storage per software channel (including Base and child channels).

    Default: /var/satellite

kickstart_mount_point
    Define the directory used to store the kickstart trees.

    Default: /var/satellite

repomd_cache_mount_point
    Define the directory used to store the packages, errata, channels, kickstart trees and also store the repositories metadata cache information. It is generated when using Spacewalk/Red Hat Satellite on demand when the client asks for thoses files. These cache files are stored in /var/cache/rhn and the storage needs of this directory will vary greatly. We suggest at least 10GB of space in /var/cache/rhn on Spacewalk/Red Hat Satellite server. Very large environments will need to increase the amount of space in /var/cache/rhn that directory.

    Default: /var/cache

server.satellite.rhn_parent
    This parameter determines the parent RHN Classic/Red Hat Satellite whose packages will be downloaded or synced. This parameter usually points to RHN Hosted, rhn.redhat.com

    Default: none

server.satellite.http_proxy
    This parameter determines the HTTP proxy used to download or sync packages from. Enter the IP address or HTTP Proxy FQDN address.

    Default: none

server.satellite.http_proxy_username
    This parameter determines the HTTP proxy username.

    Default: none

server.satellite.http_proxy_password
    This parameter determines the HTTP proxy password.

    Default: none

debug

    This parameter determines debug level used by Spacewalk/Red Hat Satellite processes. Please, keep in mind that raising up this value will generate a very verbose logs, which is only useful for debugging purposes. Use it carefully! Valid values: [0-6]

    0 low verbosity
    6 high verbosity

    Default: 1

disconnected (boolean)
    This parameter controls whether server is running in connected or disconnected mode. When running in disconnected mode, the RHN Entitlement Certificate is activated locally but not on remote RHN Servers.

    Default: 0

enable_snapshots (boolean)
    This parameter controls whether server is allowed to perform system snapshots.

    Default: 1

enable_nvrea (boolean)
    This parameter controls whether server will allow package uploads for same NVREA (Name, Version, Release, Epoch, Arch) but different vendors.

    •   Spacewalk Server

        •   Default: 1

    •   Red Hat Satellite Server

        •   Default: 0

web.maximum_config_file_size (bytes)
    This parameter controls which is the maximum allowed size for configuration files.

    Default: 32768

java.taskomatic_channel_repodata_workers (integer)
    This parameter controls how many repodata workers should generate repodata information concurrently. If the number of repodata workers running on the system are bigger than defined on java.taskomatic_channel_repodata_workers, then the job will be queued.

    Default: 2

taskomatic.java.maxmemory (integer)
    The maximum amount of memory (MB) that Taskomatic can use. If you find that Taskomatic is running out of memory, consider increasing this.

    Default: 4096

taskomatic.java.initmemory (integer)
    The initial amount of memory (MB) that Taskomatic is allocated on start-up.

    Default: 256

java.message_queue_thread_pool_size (integer)
    Size of the thread pool used for the message queue.

    Default: 5

salt_presence_ping_timeout (integer)
    SUSE Manager presence timeout for Salt minions (main timeout, in seconds).

    Default: 4

salt_presence_ping_gather_job_timeout (integer)
    SUSE Manager presence timeout for Salt minions (gather job timeout, in seconds).

    Default: 1

package_import_skip_changelog (boolean)
    When importing packages, skip non-essential data that can make the import faster (changelogs). Not recommended in production.

    Default: 0

java.smtp_server
    This parameter defines the server Satellite will use as its SMTP server.

    Default: localhost

  Database Options

db_backend
    Determine the database backend. Valid backends are: postgresql or oracle

db_user
    Determine the user for database connections.

db_password
    Determine the password for database connections.

db_name
    Determine the database name.

db_host
    Determine the database host.

db_port
    Determine the database port.

Inter-Red Hat Satellite Sync (ISS)
The ability of synchronize two Spacewalk/Red Hat Satellites servers is called Inter-Red Hat Satellite Sync (ISS) which allows to synchronize channels from the master Red Hat Satellite to slave servers, simplifying the process of coordinating contents from one Spacewalk/Red Hat Satellite source to another or several others. Note: Several options that used to be available in rhn.conf are now only set by the Satellite Admin in the Admin -> ISS Configuration pages in the web interface.

  Master Spacewalk/Red Hat Satellite Servers

disable_iss
    If set to 1, then no slave will be able to sync from this server this option does not affect the ability to sync to this server from another spacewalk (or hosted).

    Default: 0

FILES
/etc/rhn/rhn.conf
    Configuration file for Spacewalk/Red Hat Satellite server. See rhn.conf(5) for further details.

ADDITIONAL DOCS
For additional documentation, please visit:

Red Hat Satellite Documentation
    http://docs.redhat.com/docs/en-US/Red_Hat_Network_Satellite/index.html

Spacewalk Documentation
    http://www.spacewalkproject.org/documentation.html

BUGS
Please, if you find a bug or want a new feature fill a bug at http://bugzilla.redhat.com

AUTHORS
Marcelo Moreira de Mello <mmello@redhat.com>

SEE ALSO
rhn.conf(5), rhn-activate-satellite(8), db-control(1), pam(8)