Hello,

Added as attachment the patch for BZ#496823 which includes the a man page for /etc/rhn/rhn.conf file.

0001-Adding-usr-share-man-man5-rhn.conf.5-manpage-file.patch

0002-Modifing-SPEC-file-including-new-man-page.patch


Please, review the patch. Please, let me know if we need to change something.

Thank you so much.

Kind Regards,
Marcelo Moreira de Mello

--
Marcelo Moreira de Mello
RHCA RHCSS RHCVA
Software Maintenance Engineer/SEG

gpg id: 2048R/FDB110E5
gpg fingerprint: 3BE7 EF71 4DD7 6812 D309  8F18 BD42 D095 FDB1 10E5

>From 09eff4477401399c73bad357c1e92f65fb63cd8d Mon Sep 17 00:00:00 2001
From: Marcelo Moreira de Mello <mme...@redhat.com>
Date: Mon, 28 Feb 2011 02:50:07 -0300
Subject: [PATCH 1/2] Adding usr/share/man/man5/rhn.conf.5 manpage file

---
 spacewalk/config/usr/share/man/man5/rhn.conf.5 |  253 ++++++++++++++++++++++++
 1 files changed, 253 insertions(+), 0 deletions(-)
 create mode 100644 spacewalk/config/usr/share/man/man5/rhn.conf.5

diff --git a/spacewalk/config/usr/share/man/man5/rhn.conf.5 
b/spacewalk/config/usr/share/man/man5/rhn.conf.5
new file mode 100644
index 0000000..3d3f427
--- /dev/null
+++ b/spacewalk/config/usr/share/man/man5/rhn.conf.5
@@ -0,0 +1,253 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH rhn.conf 5 "1 March 2011" Linux "File Formats and Conventions"
+.SH NAME
+rhn.conf \- Configuration file for Spacewalk/RHN Satellite Server
+.SH SYNOPSIS
+.B /etc/rhn/rhn.conf
+.SH DESCRIPTION
+.B rhn.conf 
+is a configuration file for used for several services in Spacewalk/RHN 
Satellite server.
+The file content are read by
+.B rhn-satellite (8)
+command to start the Spacewalk/RHN Satellite service. 
+.SH FORMAT
+.P
+The 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: 
+.TP
+parameter = value
+.SH OPTIONS
+.TP
+.B "traceback_mail"
+Define which mail address will be used to notify about reports, warnings and 
Web traceback errors. 
+Use comma to separate mail addresses. 
+.IP
+.B Default:
+none 
+
+.TP
+.B "mount_point"
+Define the directory used to store the RPM package files offered by software 
channels.
+Per recommendation, we suggest at least 30 GB storage per software 
+channel (including Base and child channels). 
+.IP
+.B Default:
+/var/satellite 
+
+.TP
+.B "kickstart_mount_point"
+Define the directory used to store the kickstart trees.
+.IP
+.B Default:
+/var/satellite 
+
+.TP
+.B "repomd_cache_mount_point"
+Define the directory used to store the packages, errata, channels, 
kickstart-tree and repositories metadata 
+cache information generated when using Spacewalk/RHN Satellite, which get 
regenerated, as needed, if deleted.
+These cache files are stored in 
+.B /var/cache/rhn
+and the storage needs of this directory will vary greatly. We suggest at least 
10GB of space in 
+.B /var/cache/rhn
+on Spacewalk/RHN Satellite server. Very large environments will need to 
increase the amount of space in 
+.B /var/cache/rhn 
+directory. 
+
+.IP
+.B Default:
+/var/cache
+
+.TP
+.B "server.satellite.rhn_parent"
+This parameter determines the parent RHN/RHN Satellite which packages will be 
downloaded or synced. This parameter usually points to RHN Hosted,
+.B rhn.redhat.com
+.IP
+.B Default:
+none
+
+.TP
+.B "server.satellite.http_proxy"
+This parameter determines the HTTP proxy used to download or sync packages. 
Enter the IP address or HTTP Proxy FQDN address.
+.IP
+.B Default:
+none
+
+.TP
+.B "server.satellite.http_proxy_username"
+This parameter determines the HTTP proxy username.
+.IP
+.B Default:
+none
+
+.TP
+.B "server.satellite.http_proxy_password"
+This parameter determines the HTTP proxy password.
+.IP
+.B Default:
+none
+
+.TP
+.B "server.satellite.ca_chain"
+This parameter specify the SSL certificate used in communication against
+.B server.satellite.rhn_parent. 
+The default SSL CA certificate points to RHN Hosted. 
+.IP
+.B Default:
+/usr/share/rhn/RHNS-CA-CERT
+
+.TP
+.B "debug"
+.P
+.RS
+This parameter determines debug level used by Spacewalk/RHN Satellite 
processes. 
+Please, keep in mind that raising up this value will generate a very verbose 
logs, which is only useful for debug. 
+.B Use it carefully!
+Valid values:
+.B [0-6]
+.RE
+.B
+.P
+.RS
+0 low verbosity
+.RE
+.RS
+6 high verbosity 
+.RE
+.IP
+.B Default:
+1
+
+.TP
+.B "disconnected (boolean)"
+This parameter controls if 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. To switch to connected mode, see man page
+.B rhn-satellite-activate (8).
+.IP
+.B Default:
+0
+
+.TP
+.B "enable_snapshots"
+This parameter controls if server is allow system snapshots. 
+.IP
+.B Default:
+1
+
+.SS Database Options 
+.TP
+.B "db_backend"
+Determine the database backend. Valid backends are: 
+.B postgresql
+or
+.B oracle
+.IP
+
+.TP
+.B "db_user"
+Determine the user for database connections. 
+.IP
+
+.TP
+.B "db_password"
+Determine the password for database connections. 
+.IP
+
+.TP
+.B "db_name"
+Determine the database name. 
+.IP
+
+.TP
+.B "db_host"
+Determine the database host.
+.IP
+
+.TP
+.B "db_port"
+Determine the database port.
+.IP
+
+.SH Inter-RHN Satellite Sync (ISS)
+The ability of synchronization between two Spacewalk/RHN Satellites servers
+is called Inter-RHN Satellite Sync (ISS)  which allows to synchronize channels
+from the master RHN Satellite to slave servers, simplifying the 
+process of coordinating content from one Spacewalk/RHN Satellite source to 
another or several others.
+
+.SS Master Spacewalk/RHN Satellite Servers
+
+.TP
+.B "allowed_iss_slaves"
+This parameter is used if the server is intended to be a master. Comma 
separated list of allowed 
+iss slaves. Use full qualified domain names
+.B (FQDN)
+at this option. 
+.IP
+
+.TP
+.B "disable_iss"
+If set to 1, then no slave will be able to sync from this server
+this option does not affect ability to sync to this server from
+another spacewalk (or hosted).
+.IP
+.B Default:
+0
+
+.SS Slave Spacewalk/RHN Satellite Servers
+
+.TP
+.B "iss_parent"
+This parameter determines the Spacewalk/RHN Satellite parent server. If left 
blank, 
+.B server.satellite.rhn_parent
+is taken by default.
+Only use this option if this server is intended to be a slave server.
+.IP
+
+.TP
+.B "iss_ca_chain"
+This parameter specify the SSL certificate used in communication against
+.B iss_parent
+server. This certificate 
+.I must 
+contains the
+.I SSL Common Name
+from 
+.B iss_parent
+server.
+.IP
+.B Default:
+/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT
+
+.SH FILES
+.I /etc/rhn/rhn.conf
+.RS
+Configuration file for Spacewalk/RHN Satellite server. See
+.BR rhn.conf (5)
+for further details.
+
+.SH ADDITIONAL DOCS 
+For additional documentation, please visit: 
+.P
+.RE
+.B Red Hat Network RHN Satellite Documentation
+.RS 
+http://docs.redhat.com/docs/en-US/Red_Hat_Network_Satellite/index.html
+.P
+.RE
+.B Spacewalk Documentation
+.RS
+http://spacewalk.redhat.com/documentation.html
+.P
+
+.SH BUGS
+Please, if you find a bug or want a new feature fill a bug at 
+.BI http://bugzilla.redhat.com
+
+.SH AUTHORS
+Marcelo Moreira de Mello <mme...@redhat.com>
+
+.SH "SEE ALSO"
+.BR rhn.conf (5),
+.BR rhn-activate-satellite (8),
+.BR db-control (1)
-- 
1.7.1

>From 6efa33bcdcb7ed840fc9f6ee7f973e019d948f85 Mon Sep 17 00:00:00 2001
From: Marcelo Moreira de Mello <mme...@redhat.com>
Date: Mon, 28 Feb 2011 03:00:44 -0300
Subject: [PATCH 2/2] Modifing SPEC file including new man page

---
 spacewalk/config/spacewalk-config.spec |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)

diff --git a/spacewalk/config/spacewalk-config.spec 
b/spacewalk/config/spacewalk-config.spec
index 7f7be9a..3d3ea91 100644
--- a/spacewalk/config/spacewalk-config.spec
+++ b/spacewalk/config/spacewalk-config.spec
@@ -51,6 +51,8 @@ find $RPM_BUILD_ROOT -name '*.symlink' | \
                rm -f $filename ; \
        done
 
+gzip $RPM_BUILD_ROOT/usr/share/man/man5/rhn.conf.5
+
 %clean
 rm -rf $RPM_BUILD_ROOT
 
@@ -80,6 +82,7 @@ rm -rf $RPM_BUILD_ROOT
 %attr(0755,root,root) %{_prefix}/share/rhn/satidmap.pl
 %attr(0755,root,root) %{_prefix}/share/rhn/startup.pl
 %doc LICENSE
+%doc %{_prefix}/share/man/man5/rhn.conf.5.gz
 
 %pre
 # This section is needed here because previous versions of spacewalk-config
@@ -95,6 +98,9 @@ fi
 
 
 %changelog
+* Mon Feb 28 2011 Marcelo Moreira de Mello <mme...@redhat.com> 1.4.1-1
+- 496823 - Add man page for rhn.conf 
+
 * Sat Nov 20 2010 Miroslav Suchý <msu...@redhat.com> 1.3.1-1
 - 474591 - move web data to /usr/share/nocpulse (msu...@redhat.com)
 - Bumping package versions for 1.3. (jpazdzi...@redhat.com)
-- 
1.7.1

_______________________________________________
Spacewalk-devel mailing list
Spacewalk-devel@redhat.com
https://www.redhat.com/mailman/listinfo/spacewalk-devel

Reply via email to