conf/conf.d-README | 32 +++++++++++++++- conf/reflector.conf | 74 ++----------------------------------- conf/reflector.conf-README | 90 ++++++++++++++++++++++++++++++++++++++++++++- 3 files changed, 124 insertions(+), 72 deletions(-)

New commits: commit 02f217233c6387183d85c1521e00ac9ff122f307 Author: Robert 'Bob' Jensen bob@fedoraunity.org Date: Sat Sep 18 15:08:20 2010 -0500

Working on Configuration README files.

diff --git a/conf/conf.d-README b/conf/conf.d-README index 3ef8a09..cc159fb 100644 --- a/conf/conf.d-README +++ b/conf/conf.d-README @@ -1 +1,31 @@ -README conf.d \ No newline at end of file +README conf.d + +This file is to explain the fields expected in the .repo files contained in the conf.* directories. I am using the included local.repo file as an example. + +# The Repo Nick Name +[personal-repo] +# The Repo Name that is printed in Verbose mode (Not sure it is actually being used.) +name = Personal - $release - $arch +# Is the repo enabled? 0/1 +enabled = 0 +# The repo directory relative to the basedir set in /etc/reflectr.conf +repodir = myrepo/$release/$arch/ +# Do we want to run repoview on this repo? 0/1 repoview is configured in /etc/reflector/pluginconf.d/repoview.conf This option may not yet be developed. +repoview = 0 +# The distro collection, could be fedora, centos, el... +collection = fedora +# Distro Release version, should be space delimited. +release = 13 14 +# What architectures are available, note that these are not the arch that will be sync'd that is set in the main config file. +availarch = x86_64 i386 ppc +# Should we gpgcheck the files we sync? 0/1 This option may not yet be developed. +gpgcheck = 0 +# location of the GPG key to use. example file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora +gpgkey = +# Is this a local repo? 0/1 If it is we need to run createrepo. This option may not yet be developed. +local = 1 +# Items to exclude from a repo. An example is drpms in Fedora Updates, drpms are sync'd using it's own repo. +exclude = +# The link for the rsync directory on the mirror of your choice, muliple mirrors my be listed for failover on new lines. +sourceurl = + diff --git a/conf/reflector.conf b/conf/reflector.conf index 085121d..7e5ed94 100644 --- a/conf/reflector.conf +++ b/conf/reflector.conf @@ -1,91 +1,25 @@ -# This file should end up documented at some point +# See reflector.conf-README for documentation at this point.

[main]

-# These would not normally be configured by an enduser, I don't think they -# belong in this file. lockdir = /var/cache/reflector -#confdir = /etc/reflector/conf.centos -#confdir = /etc/reflector/conf.d -confdir = /etc/reflector/conf.fedora - -# These are user configurable options. -# This is the root of your mirror. -#basedir = /media/USB/Mirror +confdir = /etc/reflector/conf.d basedir = /var/www/mirror - -# Location of the log file. -# We will need to set this directory/file owned and writable by the reflector -# group when we package. logfile = /var/log/reflector/reflector.log - -# Select the architectures you want to sync for. There is also a runtime -# option (-a --arch) that is not being picked up to override this setting. -# The default options for getting all are "arch = x86_64 i386 ppc source" -# i686 is also needed for getting LiveMedia. -#arch = x86_64 i386 ppc i686 -#arch = source x86_64 i386 i686 arch = x86_64 i386 i686 -#arch = x86_64 -#arch = i386 i686 -#arch = i386 - -# This option is for when running from say cron. Set this option to yes when -# running from cron, when running manually you might want some feedback. We -# override this using the -q runtime option. quiet = no - -# Do you want rsync to clean up old packages --delete --delete-after this is -# done in the second pass. rsync-cleanup = yes -# Other rsync options for your personal taste -# the default is "rsync-options = -agH" rsync-options = -agH rsync-timeout = -bwlimit = - +bwlimit = mailto = bob@bobjensen.com smtp-server = localhost - -# Hardlinking saves a lot of space on your disk. -# We need to check this option in the app, if true then add the rsync option or -# execute the external app. hardlink = yes -#hardlink = no - -# createrepo Creates a common metadata repository. -# I believe this is only needed for "Local" or "Personal" repos. -# Not sure what this option is. createrepo-options = -p - -# repoview Creates a set of static HTML pages in a yum repository. If yes read the plugin conf file /etc/reflector/pluginconf.d/repoview.conf repoview = yes - -# I think all this moves to the plugin conf file. For now they live here -# because I do not know how to implement a plugin with a config file. -# Not sure what the htmldir option is for, need to check this out in the old -# code, also I think we would want to be able to set an option for the -# templates used, repoviewtmpl would be the option for that. repoview-options = htmldir = /var/www/repoview/html -# Use an alternative directory with kid templates instead of the default: -# ./templates. The template directory must contain four required template -# files: index.kid, group.kid, package.kid, rss.kid and the "layout" dir -# which will be copied into the repoview directory. repoviewtmpl = /var/www/repoview/template - -# Do you want to verify your mirror integrity before the second pass to delete -# obsolite files and update the repodata? -# Not sure this is needed, in the past we have seen broken repodata come from -# upstream, I would think this might prevent that if run between the two -# passes if the repo is broken we don't update the meta data. This will not -# work. With the old and new files the repo would always validate... need to -# come up with another idea. repoclosure = no -# Perhaps verifytree would be better, not sure yet verifytree = no - -# The group of all reflector users, at the end of our full run I think we will -# need to chgrp all our files to the reflector group, unless we can find a way -# to do this in rsync. -group = reflector +group = reflector \ No newline at end of file diff --git a/conf/reflector.conf-README b/conf/reflector.conf-README index 3e7db22..65bd1fb 100644 --- a/conf/reflector.conf-README +++ b/conf/reflector.conf-README @@ -1 +1,89 @@ -README reflector.conf \ No newline at end of file +README reflector.conf + +# This file should end up documented at some point + +[main] + +# These would not normally be configured by an enduser, I don't think they +# belong in this file. +lockdir = /var/cache/reflector +confdir = /etc/reflector/conf.d + +# These are user configurable options. +# This is the root of your mirror. +basedir = /var/www/mirror + +# Location of the log file. +# We will need to set this directory/file owned and writable by the reflector +# group when we package. +logfile = /var/log/reflector/reflector.log + +# Select the architectures you want to sync for. There is also a runtime +# option (-a --arch) that is not being picked up to override this setting. +# The default options for getting all are "arch = x86_64 i386 ppc source" +# i686 is also needed for getting LiveMedia. +arch = x86_64 i386 i686 + +# This option is for when running from say cron. Set this option to yes when +# running from cron, when running manually you might want some feedback. We +# override this using the -q runtime option. +quiet = no + +# Do you want rsync to clean up old packages --delete --delete-after this is +# done in the second pass. This should be made to accept yes,y,1/no,n,0 +rsync-cleanup = yes +# Other rsync options for your personal taste +# the default is "rsync-options = -agH" +rsync-options = -agH +rsync-timeout = +# Limit the bandwith available to the sync, we need to check the rsync man +# page, this is not functioning correctly. +bwlimit = + +mailto = you@yourdomain.tld +smtp-server = localhost + +# Hardlinking saves a lot of space on your disk. +# We need to check this option in the app, if true then add the rsync option or +# execute the external app. Currently freedups, will be freedup once it is +# reviewed and in Fedora/EPEL. This should be made to accept yes,y,1/no,n,0 +hardlink = yes +#hardlink = no + +# createrepo Creates a common metadata repository. +# I believe this is only needed for "Local" or "Personal" repos. +# Not sure what this option is. +createrepo-options = -p + +# repoview Creates a set of static HTML pages in a yum repository. If yes read +# the plugin conf file /etc/reflector/pluginconf.d/repoview.conf +repoview = yes + +# I think all this moves to the plugin conf file. For now they live here +# because I do not know how to implement a plugin with a config file. +# Not sure what the htmldir option is for, need to check this out in the old +# code, also I think we would want to be able to set an option for the +# templates used, repoviewtmpl would be the option for that. +repoview-options = +htmldir = /var/www/repoview/html +# Use an alternative directory with kid templates instead of the default: +# ./templates. The template directory must contain four required template +# files: index.kid, group.kid, package.kid, rss.kid and the "layout" dir +# which will be copied into the repoview directory. +repoviewtmpl = /var/www/repoview/template + +# Do you want to verify your mirror integrity before the second pass to delete +# obsolite files and update the repodata? +# Not sure this is needed, in the past we have seen broken repodata come from +# upstream, I would think this might prevent that if run between the two +# passes if the repo is broken we don't update the meta data. This will not +# work. With the old and new files the repo would always validate... need to +# come up with another idea. +repoclosure = no +# Perhaps verifytree would be better, not sure yet +verifytree = no + +# The group of all reflector users, at the end of our full run I think we will +# need to chgrp all our files to the reflector group, unless we can find a way +# to do this in rsync. +group = reflector