Add a page detailing the progress and tasks involved with the GNATS4
upgrade.
This commit is contained in:
Ceri Davies
parent
5e354e35f0
commit
3146146825
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/www/; revision=19659
5 changed files with 370 additions and 3 deletions
|
|
@ -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)
|
.if exists(../Makefile.conf)
|
||||||
.include "../Makefile.conf"
|
.include "../Makefile.conf"
|
||||||
|
|
@ -15,6 +15,6 @@ DOCS+= cvsweb.sgml
|
||||||
|
|
||||||
INDEXLINK= projects.html
|
INDEXLINK= projects.html
|
||||||
|
|
||||||
SUBDIR= busdma c99 mips
|
SUBDIR= busdma c99 gnats4 mips
|
||||||
|
|
||||||
.include "${WEB_PREFIX}/share/mk/web.site.mk"
|
.include "${WEB_PREFIX}/share/mk/web.site.mk"
|
||||||
|
|
|
||||||
17
en/projects/gnats4/Makefile
Normal file
17
en/projects/gnats4/Makefile
Normal file
|
|
@ -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"
|
||||||
303
en/projects/gnats4/index.sgml
Normal file
303
en/projects/gnats4/index.sgml
Normal file
|
|
@ -0,0 +1,303 @@
|
||||||
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" [
|
||||||
|
<!ENTITY base CDATA "../..">
|
||||||
|
<!ENTITY projectbase "http://people.freebsd.org/~ceri/gnats4">
|
||||||
|
<!ENTITY date "$FreeBSD$">
|
||||||
|
<!ENTITY title "FreeBSD GNATS Upgrade">
|
||||||
|
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
|
||||||
|
<!ENTITY % developers SYSTEM "../../developers.sgml"> %developers;
|
||||||
|
<!ENTITY unassigned "Unassigned">
|
||||||
|
<!-- Originally based on www/en/projects/mips/index.sgml -->
|
||||||
|
|
||||||
|
<!-- Please pass all changes through ceri@FreeBSD.org -->
|
||||||
|
|
||||||
|
<!ENTITY imagebase "&base;/gifs">
|
||||||
|
|
||||||
|
<!-- XXX: workaround for SGML expansion. -->
|
||||||
|
<!ENTITY nbsp SDATA "[nbsp ]">
|
||||||
|
|
||||||
|
<!-- Status levels -->
|
||||||
|
<!ENTITY status.blank " ">
|
||||||
|
<!ENTITY status.blocked "<img src='&imagebase;/blocked.png' width='22' height='22' alt='Blocked'>">
|
||||||
|
<!ENTITY status.done "<img src='&imagebase;/done.png' width='22' height='22' alt='Done'>">
|
||||||
|
<!ENTITY status.new "<img src='&imagebase;/not_started.png' width='22' height='22' alt='Not Started'>">
|
||||||
|
<!ENTITY status.n-a "<img src='&imagebase;/not_planned.png' width='22' height='22' alt='Not Planned'>">
|
||||||
|
<!ENTITY status.wip "<img src='&imagebase;/in_progress.png' width='22' height='22' alt='In progress'>">
|
||||||
|
|
||||||
|
<!-- Ugly, but saves time. -->
|
||||||
|
<!ENTITY a.bugbusters.subscribe "<a href='mailto:freebsd-bugbusters-subscribe@FreeBSD.org'>freebsd-bugbusters-subscribe@FreeBSD.org</a>">
|
||||||
|
<!ENTITY a.bugbusters "<a href='mailto:freebsd-bugbusters@FreeBSD.org'>freebsd-bugbusters@FreeBSD.org</a>">
|
||||||
|
]>
|
||||||
|
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<title>&title;</title>
|
||||||
|
<link rel="stylesheet" href="./style.css">
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body bgcolor="#ffffff">
|
||||||
|
<img src="&imagebase;/project_goal.png" width="229" height="36"
|
||||||
|
alt="Project Goal">
|
||||||
|
|
||||||
|
<p class="main">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.</p>
|
||||||
|
|
||||||
|
<p class="main">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 <em>is</em> ongoing, but is non-trivial.</p>
|
||||||
|
|
||||||
|
<img src="&imagebase;/project_plan.png" width="229" height="36"
|
||||||
|
alt="Project Plan">
|
||||||
|
|
||||||
|
<p class="main">Initially, development is being done on the
|
||||||
|
bugmeister's local machine, but pertinent patches will be made
|
||||||
|
available at <a href="&projectbase;">&projectbase;</a> as they
|
||||||
|
are deemed ready.</p>
|
||||||
|
|
||||||
|
<img src="&imagebase;/how_to_contribute.png" width="229" height="36"
|
||||||
|
alt="How to Contribute">
|
||||||
|
|
||||||
|
<p class="main">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
|
||||||
|
<a href="mailto:bugmeister@FreeBSD.org">bugmeister@FreeBSD.org</a>
|
||||||
|
with details of how you can help.</p>
|
||||||
|
|
||||||
|
<p class="main">If you notice that a task is missing from the list,
|
||||||
|
then please do get in touch with the Bugmeister and let me
|
||||||
|
know!</p>
|
||||||
|
|
||||||
|
<img src="&imagebase;/resources_and_links.png" width="229" height="36"
|
||||||
|
alt="Resources and Links">
|
||||||
|
|
||||||
|
<ul class="list">
|
||||||
|
<li><p>Documentation for GNATS3 is available at
|
||||||
|
<a href="http://www.gnu.org/software/gnats/doc/3_113_1/index.html">
|
||||||
|
http://www.gnu.org/software/gnats/doc/3_113_1/index.html.</a></p></li>
|
||||||
|
<li><p>Documentation for GNATS4 is available at
|
||||||
|
<a href="http://www.gnu.org/software/gnats/doc/4_0_beta_snapshot/index.html">
|
||||||
|
http://www.gnu.org/software/gnats/doc/4_0_beta_snapshot/index.html.</a></p></li>
|
||||||
|
<li><p><a name="mailinglist">Discussion relating to</a>
|
||||||
|
this project should be directed to the &a.bugbusters; mailing list.
|
||||||
|
To subscribe to the list, send a message to &a.bugbusters.subscribe;.</p></li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<img src="&imagebase;/status_board.png" width="229" height="36"
|
||||||
|
alt="Status Board"><br><br>
|
||||||
|
|
||||||
|
<!-- Tasks should be sorted in order in which we expect/need them
|
||||||
|
to happen. -->
|
||||||
|
|
||||||
|
<p class="main">These tasks need to be completed before the upgrade
|
||||||
|
can be started.</p>
|
||||||
|
|
||||||
|
<table border="3" cellpadding="2" cellspacing="0">
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<th class="heading"> Task </th>
|
||||||
|
<th class="heading"> Responsible </th>
|
||||||
|
<th class="heading"> Last Updated </th>
|
||||||
|
<th class="heading"> Status </th>
|
||||||
|
<th class="heading"> Notes </th>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Patch the databases/gnats4 port for WANT_FREEFALL_CFG. </td>
|
||||||
|
<td> &a.ceri; </td>
|
||||||
|
<td> 14 January 2004 </td>
|
||||||
|
<td> &status.done; </td>
|
||||||
|
<td> <a href="&projectbase;/port/">Patches</a> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Commit the database/gnats4 patches. </td>
|
||||||
|
<td> &a.ceri; </td>
|
||||||
|
<td> 14 January 2004 </td>
|
||||||
|
<td> &status.wip; </td>
|
||||||
|
<td> Awaiting maintainer </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Produce patches for www/en/cgi/query-pr.cgi and
|
||||||
|
www/en/cgi/query-pr-summary.cgi to work with GNATS 4. </td>
|
||||||
|
<td> &unassigned; </td>
|
||||||
|
<td> </td>
|
||||||
|
<td> &status.new; </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Produce configuration files for the new database. </td>
|
||||||
|
<td> &a.ceri; </td>
|
||||||
|
<td> 14 January 2004 </td>
|
||||||
|
<td> &status.done; </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Set a date! </td>
|
||||||
|
<td> &a.ceri; </td>
|
||||||
|
<td> </td>
|
||||||
|
<td> &status.new; </td>
|
||||||
|
<td> </td>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Arrange resource from admins@, or root access to freefall,
|
||||||
|
www and hub. </td>
|
||||||
|
<td> &a.ceri; </td>
|
||||||
|
<td> </td>
|
||||||
|
<td> &status.new; </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
</table><br><br>
|
||||||
|
|
||||||
|
<p class="main">These tasks list the steps that must be taken during
|
||||||
|
the upgrade itself.</p>
|
||||||
|
|
||||||
|
<table border="3" cellpadding="2" cellspacing="0">
|
||||||
|
<tr>
|
||||||
|
<th class="heading"> Task </th>
|
||||||
|
<th class="heading"> Machines </th>
|
||||||
|
<th class="heading"> Notes </th>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Pre-build databases/gnats4. </td>
|
||||||
|
<td> freefall, hub and www. </td>
|
||||||
|
<td> freefall must have WANT_FREEFALL_CFG defined in
|
||||||
|
/etc/make.conf. </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Stop mail coming into the gnats account. </td>
|
||||||
|
<td>hub</td>
|
||||||
|
<td> 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. </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Comment out all the jobs in the gnats crontab.</td>
|
||||||
|
<td>freefall</td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Chmod 000 /c/gnats/gnats-adm/locks to stop further edits.</td>
|
||||||
|
<td>freefall</td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Make a backup of /c/gnats. </td>
|
||||||
|
<td>freefall</td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Commit the cgi patches. </td>
|
||||||
|
<td> N/A </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> pkg_delete the gnats3 port </td>
|
||||||
|
<td> freefall </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Install the gnats4 port, install the new config </td>
|
||||||
|
<td> freefall </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Submit test PRs with queue-pr. Make test edits, etc. </td>
|
||||||
|
<td> freefall </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> pkg_delete the gnats3 port </td>
|
||||||
|
<td> hub </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Install the gnats4 port </td>
|
||||||
|
<td> hub </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Queue a test PR on hub, and force file it on freefall </td>
|
||||||
|
<td>hub, freefall</td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> pkg_delete the gnats3 port </td>
|
||||||
|
<td> www </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Install the gnats4 port </td>
|
||||||
|
<td> www </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Re-enable email submission </td>
|
||||||
|
<td> hub </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Re-enable cronjobs </td>
|
||||||
|
<td> freefall </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td> Requeue backed up submissions </td>
|
||||||
|
<td> freefall </td>
|
||||||
|
<td> </td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
</table><br><br>
|
||||||
|
|
||||||
|
<table border="3" cellpadding="2" cellspacing="0">
|
||||||
|
<tr>
|
||||||
|
<th colspan="2" class="heading">Legend</th>
|
||||||
|
<tr>
|
||||||
|
<td> &status.new; </td>
|
||||||
|
<td> Not yet started </td>
|
||||||
|
</tr><tr>
|
||||||
|
<td> &status.blocked; </td>
|
||||||
|
<td> Blocked awaiting completion of another task </td>
|
||||||
|
</tr><tr>
|
||||||
|
<td> &status.wip; </td>
|
||||||
|
<td> Work in progress </td>
|
||||||
|
</tr><tr>
|
||||||
|
<td> &status.done; </td>
|
||||||
|
<td> Task completed </td>
|
||||||
|
</tr><tr>
|
||||||
|
<td> &status.n-a; </td>
|
||||||
|
<td> Not planned </td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
<p><small>The original layout for this web page was borrowed from
|
||||||
|
the FreeBSD C99 Project.</small></p>
|
||||||
|
&footer;
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
42
en/projects/gnats4/style.css
Normal file
42
en/projects/gnats4/style.css
Normal file
|
|
@ -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;
|
||||||
|
}
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
|
||||||
<!ENTITY base CDATA "..">
|
<!ENTITY base CDATA "..">
|
||||||
<!ENTITY date "$FreeBSD: www/en/projects/projects.sgml,v 1.154 2003/12/16 21:57:58 ceri Exp $">
|
<!ENTITY date "$FreeBSD: www/en/projects/projects.sgml,v 1.155 2004/01/13 22:29:10 ceri Exp $">
|
||||||
<!ENTITY title "FreeBSD Development Projects">
|
<!ENTITY title "FreeBSD Development Projects">
|
||||||
<!ENTITY % includes SYSTEM "../includes.sgml"> %includes;
|
<!ENTITY % includes SYSTEM "../includes.sgml"> %includes;
|
||||||
]>
|
]>
|
||||||
|
|
@ -505,6 +505,11 @@ and no hard drive is required!</li>
|
||||||
possible. The Tinderbox source code is maintained in the
|
possible. The Tinderbox source code is maintained in the
|
||||||
FreeBSD CVS repository in the directory <a
|
FreeBSD CVS repository in the directory <a
|
||||||
href="http://cvsweb.FreeBSD.org/src/tools/tools/tinderbox/">src/tools/tools/tinderbox</a>.</li>
|
href="http://cvsweb.FreeBSD.org/src/tools/tools/tinderbox/">src/tools/tools/tinderbox</a>.</li>
|
||||||
|
|
||||||
|
<li><a name="gnats4" href="./gnats4/index.html">The FreeBSD
|
||||||
|
GNATS Upgrade</a> pages detail the tasks, timeline and
|
||||||
|
implementation involved in upgrading the FreeBSD bug
|
||||||
|
tracking system from GNATS 3 to GNATS 4.</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue