-Explanation of configuration files options for katie
-====================================================
+Explanation of configuration files options for dak
+==================================================
DB
--
| };
Name (required): The name of the PostgreSQL database which has been created
-for katie.
+for dak.
Host (required): The name of the host on which the database is located. If
the database is local, Host should be blank.
| {
| Root "/org/ftp.debian.org/ftp/";
| Pool "/org/ftp.debian.org/ftp/pool/";
-| Templates "/org/ftp.debian.org/katie/templates/";
+| Templates "/org/ftp.debian.org/dak/templates/";
| PoolRoot "pool/";
| Override "/org/ftp.debian.org/scripts/override/";
| Lists "/org/ftp.debian.org/database/dists/";
| Log "/org/ftp.debian.org/log/";
| Morgue "/org/ftp.debian.org/morgue/";
-| MorgueReject "reject";
| QueueBuild "/org/incoming.debian.org/buildd/";
| UrgencyLog "/org/ftp.debian.org/testing/urgencies/";
| Queue
Root (required): Specifies the path of the root of the FTP archive.
-Pool (required): This variable specifies the path of the pool directory.
-Debian packages will be placed in the pool by kelly after they have been
-accepted by jennifer.
+Pool (required): This variable specifies the path of the pool
+directory. Debian packages will be placed in the pool by 'dak
+process-accepted' after they have been accepted by dak
+process-unchecked.
-Templates (required): katie sends various mails and uses templates from
+Templates (required): dak sends various mails and uses templates from
this directory.
PoolRoot (required): This variable specifies the basename of the pool
directory.
Override (optional): This directory optionally stores override files (used
-by denise).
+by 'dak make-overrides').
Lists (optional): This directory holds file lists used by apt-ftparchive to
-generate Packages and Sources files (used by jenna).
+generate Packages and Sources files (used by 'dak make-suite-file-list').
Log (required): Log files are put in this directory.
Morgue (required): Removed files are moved there. The morgue has various
sub-directories, including (optionally) those defined by
-Shania::MorgueSubDir and Rhona::MorgueSubDir.
+Clean-Queues::MorgueSubDir and Clean-Suites::MorgueSubDir.
-MorgueReject (required): if katie cannot move a rejected package to
-Dir::Queue::Reject, it will try to move it to the Dir::MorgueReject
-directory located under Dir::Morgue.
-
-QueueBuild (optional): This variable is only relevant if any suites
-are to be auto built, i.e. if Dinstall::QueueBuildSuites has any
-values.
-
-UrgencyLog (optional): If this directory is specified, kelly will store the
-urgency value of each upload. This is mainly used for britney (the testing
-script).
+UrgencyLog (optional): If this directory is specified, 'dak
+process-accepted' will store the urgency value of each upload. This
+is mainly used for britney (the testing script).
Queue (required): This sub-tree defines important directories for the
incoming queue. The following variables have to be set: Accepted, Byhand
Announce (optional): controls where "Installed foo" mails are sent.
-CodeName, Origin and Description (optional): This settings are used by ziyi
-and put in the Release files.
+CodeName, Origin and Description (optional): This settings are used by
+'dak generate-releases' and put in the Release files.
-OverrideCodeName (optional): used by Denise.
+OverrideCodeName (optional): used by 'dak make-overrides'.
Priority (optional) determines which suite is used for the Maintainers file
-as generated by charisma/da_mkmaintainers (highest wins).
+as generated by 'dak make-maintainers' (highest wins).
CopyChanges (optional): if this variable is present it should be a path
into the archive (i.e. "Dir::RootDir"); any upload targeted for a suite
with this config option present will have the .changes file copied into
that path.
-CopyKatie (optional): if this is present it should be an absolute path; any
+CopyDotDak (optional): if this is present it should be an absolute path; any
upload targeted for a suite with this config option present will have the
-.katie file copied into that path. This option is similar to CopyChanges
+.dak file copied into that path. This option is similar to CopyChanges
and will most often be used with it; they're seperate because .changes
-files are mirrored and .katie files aren't, so the paths will usually be
+files are mirrored and .dak files aren't, so the paths will usually be
different.
There are more optional variables, such as VersionChecks. Please see
-katie.conf for examples.
+dak.conf for examples.
================================================================================
| Dinstall
| {
-| PGPKeyring "/org/keyring.debian.org/keyrings/debian-keyring.pgp";
-| GPGKeyring "/org/keyring.debian.org/keyrings/debian-keyring.gpg";
| SigningKeyring "/org/ftp.debian.org/s3kr1t/dot-gnupg/secring.gpg";
| SendmailCommand "/usr/sbin/sendmail -odq -oi -t";
| MyEmailAddress "Debian Installer <installer@ftp-master.debian.org>";
| MyAdminAddress "ftpmaster@debian.org";
-| MyHost "debian.org"; // used for generating user@my_host addresses in e.g. manual_reject()
| MyDistribution "Debian";
| BugServer "bugs.debian.org";
| PackagesServer "packages.debian.org";
| TrackingServer "packages.qa.debian.org";
-| LockFile "/org/ftp.debian.org/katie/lock";
+| LockFile "/org/ftp.debian.org/dak/lock";
| Bcc "archive@ftp-master.debian.org";
-| GroupOverrideFilename "override.group-maint";
| FutureTimeTravelGrace 28800; // 8 hours
| PastCutoffYear "1984";
| BXANotify "false";
-| QueueBuildSuites
-| {
-| unstable;
-| };
| };
-PGPKeyring and GPGKeyring (required): filenames of the PGP and GnuPG
-keyrings to be used by katie respectively.
-
-SigningKeyring (optional): this is the private keyring used by ziyi.
+SigningKeyring (optional): this is the private keyring used by 'dak
+generate-releases'.
SendmailCommand (required): command to call the MTA.
MyAdminAddress (required): used as a contact address in mails.
MyDistribution (required): this variable is used in emails sent out by
-katie and others. It should indicate the name of the distribution.
+dak and others. It should indicate the name of the distribution.
-BugServer (required): is used by katie and melanie when closing bugs.
+BugServer (required): is used by 'dak process-unchecked' and 'dak rm'
+when closing bugs.
-PackagesServer (requried): used by melanie when carbon-copying a bug close
-mail to a package maintainer.
+PackagesServer (required): used by 'dak rm' and 'dak override' when
+carbon-copying a bug close mail to a package maintainer.
-TrackingServer (optional): used by katie and melanie to send messages for
-the maintainer also to an alias for people tracking a specific source
-package.
+TrackingServer (optional): used by 'dak process-unchecked' and 'dak
+rm' to send messages for the maintainer also to an alias for people
+tracking a specific source package.
LockFile (required): contains the filename of the lockfile used by dinstall
when in action mode (i.e. not using -n/--no-action).
All sent mail is blind carbon copied to the email address in Bcc if it's
not blank.
-GroupOverrideFilename (optional): this is the override file which contains
-the list of email addresses which, if part of the Maintainer field, cause
-uploads to always be treated as maintainer uploads.
-
FutureTimeTravelGrace (required): specifies how many seconds into the
future timestamps are allowed to be inside a deb before being rejected.
BXANotify (optional): a boolean (default: no); if true (Debian-specific)
BXA notification is sent. The template for the BXA notification is located
-in Dir::Templates/lisa.bxa_notification and should be changed if this
+in Dir::Templates/process-new.bxa_notification and should be changed if this
option is set.
OverrideDisparityCheck (optional): a boolean (default: no); if true,
-jennifer compares an uploads section/priority with the overrides and whines
+dak process-unchecked compares an uploads section/priority with the overrides and whines
at the maintainer if they differ.
CloseBugs (optional): a boolean (default: no); if true the automated bug
closing feature of dinstall is activated.
-QueueBuildSuites (optional): a list of suites which should be auto
-build.
-
QueueBuild is a boolean; if true it activates support
for auto-building from accepted.
Use with caution.
SkipTime (required): an integer value which is the number of seconds that a
-file must be older than (via it's last modified timestamp) before jennifer
+file must be older than (via it's last modified timestamp) before dak process-unchecked
will REJECT rather than SKIP the package.
+KeyAutoFetch (optional): boolean (default: false), which if set (and
+not overriden by explicit argument to check_signature()) will enable
+auto key retrieval. Requires KeyServer and SigningKeyIds variables be
+set. NB: you should only enable this variable on production systems
+if you have strict control of your upload queue.
+
+KeyServer (optional): keyserver used for key auto-retrieval
+(c.f. KeyAutoFetch).
+
================================================================================
Archive
| };
| };
-OriginServer and PrimaryMirror (required): used melanie's bug closing mail
+OriginServer and PrimaryMirror (required): used 'dak rm's bug closing mail
templates. The host name and it's OriginServer and Description are part of
the SQL database in the 'archive' table.
================================================================================
-Component
----------
-
-Mandatory. List of all components, e.g.
-
-| Component
-| {
-| main
-| {
-| Description "Main";
-| MeetsDFSG "true";
-| };
-| };
-
-All three values go into the SQL database's 'component' table.
-MeetsDFSG is currently unused.
-
-================================================================================
-
Section
-------
================================================================================
-OverrideType
-------------
-
-Mandatory. List of al valid override types, e.g.
-
-| OverrideType
-| {
-| deb;
-| dsc;
-| udeb;
-| };
-
-The type goes into the 'override_type' table in the SQL database.
-
-================================================================================
-
Location
--------
in Archive.
[Note: yes, this is horrible, it dates back to the original `import
- the existent archive into the SQL Database' script (neve) and
+ the existent archive into the SQL Database' script ('dak import-archive') and
isn't otherwise used. It should be revisted at some stage.]
================================================================================
uploaded with an urgency not listed here, it will be rejected.
================================================================================
-
---
-James Troup <james@nocrew.org>, Horsforth, Leeds
-Wed, 26 Sep 2001 03:20:39 +0100
projects / dak.git / blobdiff