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.
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.
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!
Documentation for GNATS3 is available at http://www.gnu.org/software/gnats/doc/3_113_1/index.html.
Documentation for GNATS4 is available at http://www.gnu.org/software/gnats/doc/4_0_beta_snapshot/index.html.
Discussion relating to this project should be directed to the &a.bugbusters; mailing list. To subscribe to the list, send a message to &a.bugbusters.subscribe;.
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 | +Awaiting maintainer. It is also intended to wait for one + month after commit for shakeout. | |
| 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; | -+ | &status.blocked; | +Blocked on the CGI patches |
| 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;