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)
|
||||
.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"
|
||||
|
|
|
|||
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" [
|
||||
<!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 % 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
|
||||
FreeBSD CVS repository in the directory <a
|
||||
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>
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue