rhn.conf man page

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




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


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


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:


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

Default: none


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


Define the directory used to store the kickstart trees.

Default: /var/satellite


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


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


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

Default: none


This parameter determines the HTTP proxy username.

Default: none


This parameter determines the HTTP proxy password.

Default: none


This parameter specify the SSL certificate used for communicationg with server.satellite.rhn_parent. The default SSL CA certificate points to RHN Hosted.

Default: /usr/share/rhn/RHNS-CA-CERT


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


Spacewalk/Red Hat Satellite supports network-based authentication systems via Pluggable Authentication Modules (PAM). Spacewalk/Red Hat Satellite supports LDAP, Kerberos, Directory Server and other network-based authentication systems. To enable Spacewalk/Red Hat Satellite to use PAM and your organization's authentication infrastructure, follow the steps below:

  • make sure that pam-devel package is installed
  • set the parameter pam_auth_service = rhn-satellite
  • create a file in /etc/pam.d/rhn-satellite which contains:

    For LDAP authentication on 32-bit systems:

    auth         required      /lib/security/pam_env.so
    auth         sufficient    /lib/security/pam_ldap.so no_user_check
    auth         required      /lib/security/pam_deny.so
    account      required      /lib/security/pam_ldap.so no_user_check

    For LDAP authentication on 64-bit systems:

    auth      required      /lib64/security/pam_env.so
    auth      sufficient    /lib64/security/pam_ldap.so no_user_check
    auth      required      /lib64/security/pam_deny.so
    account   required      /lib64/security/pam_ldap.so no_user_check
  • restart Spacewalk/Red Hat Satellite service

Default: none

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.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: 1024

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

Database Options


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


Determine the user for database connections.


Determine the password for database connections.


Determine the database name.


Determine the database host.


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


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



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

Spacewalk Documentation


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


Marcelo Moreira de Mello <mmello@redhat.com>

See Also

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


1 March 2011 Linux File Formats and Conventions