diff --git a/en/projects/Makefile b/en/projects/Makefile index 65eca8dea1..07ca933c89 100644 --- a/en/projects/Makefile +++ b/en/projects/Makefile @@ -1,4 +1,4 @@ -# $FreeBSD: www/en/projects/Makefile,v 1.13 2002/11/08 14:56:50 jmallett Exp $ +# $FreeBSD: www/en/projects/Makefile,v 1.14 2002/12/09 17:31:28 rwatson Exp $ .if exists(../Makefile.conf) .include "../Makefile.conf" @@ -15,6 +15,6 @@ DOCS+= cvsweb.sgml INDEXLINK= projects.html -SUBDIR= busdma c99 mips +SUBDIR= busdma c99 gnats4 mips .include "${WEB_PREFIX}/share/mk/web.site.mk" diff --git a/en/projects/gnats4/Makefile b/en/projects/gnats4/Makefile new file mode 100644 index 0000000000..c8152cbc04 --- /dev/null +++ b/en/projects/gnats4/Makefile @@ -0,0 +1,17 @@ +# Summary for GNATS4 upgrade status +# +# $FreeBSD$ + +MAINTAINER= ceri + +.if exists(../Makefile.conf) +.include "../Makefile.conf" +.endif +.if exists(../Makefile.inc) +.include "../Makefile.inc" +.endif + +DOCS= index.sgml +DATA= style.css + +.include "${WEB_PREFIX}/share/mk/web.site.mk" diff --git a/en/projects/gnats4/index.sgml b/en/projects/gnats4/index.sgml new file mode 100644 index 0000000000..d61bb8a05f --- /dev/null +++ b/en/projects/gnats4/index.sgml @@ -0,0 +1,303 @@ + + + + + %includes; + %developers; + + + + + + + + + + + + +"> +"> +"> +"> +"> + + +freebsd-bugbusters-subscribe@FreeBSD.org"> +freebsd-bugbusters@FreeBSD.org"> +]> + + + + &title; + + + + + Project Goal + +

The aim of this project is to get the FreeBSD bug + tracking system upgraded from GNATS3 to GNATS4 with the minumum + outage, disruption and breakage.

+ +

This turns out to be reasonably easy, as long as + the interdependencies on the FreeBSD project's machines are + understood. The main aim of this page is to provide a place for + documentation of these dependencies, along with the steps required + for a successful upgrade and the order in which they should be + taken. A secondary aim is to assure interested parties that work + on this is ongoing, but is non-trivial.

+ + Project Plan + +

Initially, development is being done on the + bugmeister's local machine, but pertinent patches will be made + available at &projectbase; as they + are deemed ready.

+ + How to Contribute + +

The vast majority of the work involved will require + direct access to the FreeBSD cluster of machines, with elevated + privileges. However, there are some patches that need to be + written, so check the table below to see what still needs to be + done. If you have specific queries or patches to contribute, then + please contact + bugmeister@FreeBSD.org + with details of how you can help.

+ +

If you notice that a task is missing from the list, + then please do get in touch with the Bugmeister and let me + know!

+ + Resources and Links + + + + Status Board

+ + + +

These tasks need to be completed before the upgrade + can be started.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Task Responsible Last Updated Status Notes
Patch the databases/gnats4 port for WANT_FREEFALL_CFG. &a.ceri; 14 January 2004 &status.done; Patches
Commit the database/gnats4 patches. &a.ceri; 14 January 2004 &status.wip; Awaiting maintainer
Produce patches for www/en/cgi/query-pr.cgi and + www/en/cgi/query-pr-summary.cgi to work with GNATS 4. &unassigned;   &status.new;  
Produce configuration files for the new database. &a.ceri; 14 January 2004 &status.done;  
Set a date! &a.ceri;   &status.new;  
Arrange resource from admins@, or root access to freefall, + www and hub. &a.ceri;   &status.new;  


+ +

These tasks list the steps that must be taken during + the upgrade itself.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Task Machines Notes
Pre-build databases/gnats4. freefall, hub and www. freefall must have WANT_FREEFALL_CFG defined in + /etc/make.conf.
Stop mail coming into the gnats account. hub It's desirable to have incoming mail written to a temporary + file while the upgrade is in progress so that submissions can + be requeued once it's complete.
Comment out all the jobs in the gnats crontab.freefall  
Chmod 000 /c/gnats/gnats-adm/locks to stop further edits.freefall  
Make a backup of /c/gnats. freefall  
Commit the cgi patches. N/A  
pkg_delete the gnats3 port freefall  
Install the gnats4 port, install the new config freefall  
Submit test PRs with queue-pr. Make test edits, etc. freefall  
pkg_delete the gnats3 port hub  
Install the gnats4 port hub  
Queue a test PR on hub, and force file it on freefall hub, freefall  
pkg_delete the gnats3 port www  
Install the gnats4 port www  
Re-enable email submission hub  
Re-enable cronjobs freefall  
Requeue backed up submissions freefall  


+ + + + + + + + + + + + + + + + + + + + +
Legend
&status.new; Not yet started
&status.blocked; Blocked awaiting completion of another task
&status.wip; Work in progress
&status.done; Task completed
&status.n-a; Not planned
+ +

The original layout for this web page was borrowed from + the FreeBSD C99 Project.

+ &footer; + + diff --git a/en/projects/gnats4/style.css b/en/projects/gnats4/style.css new file mode 100644 index 0000000000..1d4d4982e8 --- /dev/null +++ b/en/projects/gnats4/style.css @@ -0,0 +1,42 @@ +/* + * $FreeBSD$ + */ + +BODY { +} + +BODY TD { + font-size: 13px; +} + +BODY SMALL { + width: 615px; + font-size: 11px; +} + +.heading { + font-size: 15px; + background-color: #cbd2ec; +} + +.section { + font-size: 15px; + font-weight: bold; + background-color: #e7e9f7; +} + +.notes { + font-size: 13px; + font-weight: normal; +} + +.main { + width: 615px; + height: auto; + text-align: justify; +} + +.list { + width: 550px; + height: auto; +} diff --git a/en/projects/projects.sgml b/en/projects/projects.sgml index 022e208455..682696f303 100644 --- a/en/projects/projects.sgml +++ b/en/projects/projects.sgml @@ -1,6 +1,6 @@ - + %includes; ]> @@ -505,6 +505,11 @@ and no hard drive is required! possible. The Tinderbox source code is maintained in the FreeBSD CVS repository in the directory src/tools/tools/tinderbox. + +
  • The FreeBSD + GNATS Upgrade pages detail the tasks, timeline and + implementation involved in upgrading the FreeBSD bug + tracking system from GNATS 3 to GNATS 4.