rhn.conf man page

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

server.satellite.ca_chain

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

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

pam_auth_service

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:

#%PAM-1.0
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:

#%PAM-1.0
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

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_H…

Spacewalk Documentation

http://www.spacewalkproject.org/documen…

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)

Info

1 March 2011 Linux File Formats and Conventions