1rhn.conf(5) File Formats and Conventions rhn.conf(5)
2
6 rhn.conf - Configuration file for Spacewalk/Red Hat Satellite Server
7
9 /etc/rhn/rhn.conf
10
12 rhn.conf is a configuration file used for several services in Space‐
13 walk/Red Hat Satellite server.
14
16 Format of /etc/rhn/rhn.conf is very simple. Each line is either a com‐
17 ment or a directive. Comment lines start with a # and are ignored. A
18 directive line has the format below:
19 parameter = value
21
23 Spacewalk/Red Hat Satellite includes dozens other options in
24 /usr/share/rhn/config-defaults/*.conf which administrator can override
25 in /etc/rhn/rhn.conf, but *** JUST CHANGE THOSE PARAMETERS IF YOU
26 REALLY KNOW WHAT ARE YOU DOING! ***
27 The most important tunables parameters in /etc/rhn/rhn.conf are listed
30 below:
31 traceback_mail
34 Define which mail address will be used to notify about reports,
35 warnings and Web traceback errors. Use commas to separate mail
36 addresses.
37 Default: none
39 mount_point
42 Define the directory used to store the RPM package files offered
43 by software channels. As a recommendation, we suggest at least
44 30 GB storage per software channel (including Base and child
45 channels).
46 Default: /var/satellite
48 kickstart_mount_point
51 Define the directory used to store the kickstart trees.
52 Default: /var/satellite
54 repomd_cache_mount_point
57 Define the directory used to store the packages, errata, chan‐
58 nels, kickstart trees and also store the repositories metadata
59 cache information. It is generated when using Spacewalk/Red Hat
60 Satellite on demand when the client asks for thoses files.
61 These cache files are stored in /var/cache/rhn and the storage
62 needs of this directory will vary greatly. We suggest at least
63 10GB of space in /var/cache/rhn on Spacewalk/Red Hat Satellite
64 server. Very large environments will need to increase the amount
65 of space in /var/cache/rhn that directory.
66 Default: /var/cache
69 server.satellite.rhn_parent
72 This parameter determines the parent RHN Classic/Red Hat Satel‐
73 lite whose packages will be downloaded or synced. This parameter
74 usually points to RHN Hosted, rhn.redhat.com
75 Default: none
77 server.satellite.http_proxy
80 This parameter determines the HTTP proxy used to download or
81 sync packages from. Enter the IP address or HTTP Proxy FQDN
82 address.
83 Default: none
85 server.satellite.http_proxy_username
88 This parameter determines the HTTP proxy username.
89 Default: none
91 server.satellite.http_proxy_password
94 This parameter determines the HTTP proxy password.
95 Default: none
97 server.satellite.ca_chain
100 This parameter specify the SSL certificate used for communica‐
101 tiong with server.satellite.rhn_parent. The default SSL CA cer‐
102 tificate points to RHN Hosted.
103 Default: /usr/share/rhn/RHNS-CA-CERT
105 debug
108 This parameter determines debug level used by Spacewalk/Red Hat
110 Satellite processes. Please, keep in mind that raising up this
111 value will generate a very verbose logs, which is only useful
112 for debugging purposes. Use it carefully! Valid values: [0-6]
113 0 low verbosity
115 6 high verbosity
116 Default: 1
118 disconnected (boolean)
121 This parameter controls whether server is running in connected
122 or disconnected mode. When running in disconnected mode, the
123 RHN Entitlement Certificate is activated locally but not on
124 remote RHN Servers.
125 Default: 0
127 enable_snapshots (boolean)
130 This parameter controls whether server is allowed to perform
131 system snapshots.
132 Default: 1
134 pam_auth_service
137 Spacewalk/Red Hat Satellite supports network-based authentica‐
138 tion systems via Pluggable Authentication Modules (PAM). Space‐
139 walk/Red Hat Satellite supports LDAP, Kerberos, Directory Server
140 and other network-based authentication systems. To enable Space‐
141 walk/Red Hat Satellite to use PAM and your organization's
142 authentication infrastructure, follow the steps below:
143 · make sure that pam-devel package is installed
145 · set the parameter pam_auth_service = rhn-satellite
147 · create a file in /etc/pam.d/rhn-satellite which contains:
149 For LDAP authentication on 32-bit systems:
151 #%PAM-1.0
152 auth required /lib/security/pam_env.so
153 auth sufficient /lib/security/pam_ldap.so no_user_check
154 auth required /lib/security/pam_deny.so
155 account required /lib/security/pam_ldap.so no_user_check
156 For LDAP authentication on 64-bit systems:
158 #%PAM-1.0
159 auth required /lib64/security/pam_env.so
160 auth sufficient /lib64/security/pam_ldap.so no_user_check
161 auth required /lib64/security/pam_deny.so
162 account required /lib64/security/pam_ldap.so no_user_check
163 · restart Spacewalk/Red Hat Satellite service
166 Default: none
168 enable_nvrea (boolean)
171 This parameter controls whether server will allow package
172 uploads for same NVREA (Name, Version, Release, Epoch, Arch) but
173 different vendors.
174 · Spacewalk Server
176 · Default: 1
178 · Red Hat Satellite Server
180 · Default: 0
182 web.maximum_config_file_size (bytes)
185 This parameter controls which is the maximum allowed size for
186 configuration files.
187 Default: 32768
189 java.taskomatic_channel_repodata_workers (integer)
192 This parameter controls how many repodata workers should gener‐
193 ate repodata information concurrently. If the number of repo‐
194 data workers running on the system are bigger than defined on
195 java.taskomatic_channel_repodata_workers, then the job will be
196 queued.
197 Default: 2
199 taskomatic.maxmemory (integer)
202 The maximum amount of memory (MB) that Taskomatic can use. If
203 you find that Taskomatic is running out of memory, consider
204 increasing this.
205 Default: 1024
207 package_import_skip_changelog (boolean)
210 When importing packages, skip non-essential data that can make
211 the import faster (changelogs). Not recommended in production.
212 Default: 0
214 Database Options
217 db_backend
218 Determine the database backend. Valid backends are: postgresql
219 or oracle
220 db_user
222 Determine the user for database connections.
223 db_password
225 Determine the password for database connections.
226 db_name
228 Determine the database name.
229 db_host
231 Determine the database host.
232 db_port
234 Determine the database port.
235
237 The ability of synchronize two Spacewalk/Red Hat Satellites servers is
238 called Inter-Red Hat Satellite Sync (ISS) which allows to synchronize
239 channels from the master Red Hat Satellite to slave servers, simplify‐
240 ing the process of coordinating contents from one Spacewalk/Red Hat
241 Satellite source to another or several others. Note: Several options
242 that used to be available in rhn.conf are now only set by the Satellite
243 Admin in the Admin -> ISS Configuration pages in the web interface.
244 Master Spacewalk/Red Hat Satellite Servers
247 disable_iss
248 If set to 1, then no slave will be able to sync from this server
249 this option does not affect the ability to sync to this server
250 from another spacewalk (or hosted).
251 Default: 0
253
256 /etc/rhn/rhn.conf
257 Configuration file for Spacewalk/Red Hat Satellite server. See
258 rhn.conf(5) for further details.
259
262 For additional documentation, please visit:
263 Red Hat Satellite Documentation
265 http://docs.redhat.com/docs/en-US/Red_Hat_Network_Satel‐
266 lite/index.html
267 Spacewalk Documentation
269 http://www.spacewalkproject.org/documentation.html
270
272 Please, if you find a bug or want a new feature fill a bug at
273 http://bugzilla.redhat.com
274
277 Marcelo Moreira de Mello <mmello@redhat.com>
278
281 rhn.conf(5), rhn-activate-satellite(8), db-control(1), pam(8)
282Linux 1 March 2011 rhn.conf(5)