Mercurial > p > roundup > code
annotate doc/maintenance.txt @ 1810:1a8dffd48c1c
Add a test for looking up alternate adresses and case-insensitivity.
| author | Johannes Gijsbers <jlgijsbers@users.sourceforge.net> |
|---|---|
| date | Mon, 15 Sep 2003 19:35:53 +0000 |
| parents | 2219893cb787 |
| children | 43e1f2457bf2 |
| rev | line source |
|---|---|
| 1218 | 1 ============================ |
| 2 Maintaining Roundup Trackers | |
| 3 ============================ | |
| 4 | |
|
1397
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
5 :Version: $Revision: 1.2 $ |
| 1218 | 6 |
| 7 .. contents:: | |
| 8 :depth: 1 | |
| 9 | |
| 10 Tasks | |
| 11 ===== | |
| 12 | |
| 13 Maintenance of Roundup can involve one of the following: | |
| 14 | |
| 15 1. `tracker backup`_ | |
| 16 2. `software upgrade`_ | |
| 17 3. `migrating backends`_ | |
| 18 | |
| 19 | |
| 20 Tracker Backup | |
| 21 ============== | |
| 22 | |
| 23 Stop the web and email frontends and to copy the contents of the tracker home | |
| 24 directory to some other place using standard backup tools. | |
| 25 | |
| 26 Software Upgrade | |
| 27 ================ | |
| 28 | |
| 29 Always make a backup of your tracker before upgrading software. Steps you may | |
| 30 take: | |
| 31 | |
| 32 1. ensure that the unit tests run on your system | |
| 33 2. copy your tracker home to a new directory | |
| 34 3. follow the steps in the upgrading documentation for the new version of | |
| 35 the software | |
| 36 4. test each of the admin tool, web interface and mail gateway using the new | |
| 37 version of the software | |
| 38 5. stop the production web and email frontends | |
| 39 6. perform the upgrade steps on the existing tracker directory | |
| 40 7. upgrade the software | |
| 41 8. restart your tracker | |
| 42 | |
| 43 Migrating Backends | |
| 44 ================== | |
| 45 | |
| 46 | |
| 47 1. stop the existing tracker web and email frontends (preventing changes) | |
| 48 2. use the roundup-admin tool "export" command to export the contents of | |
| 49 your tracker to disk | |
| 50 3. copy the tracker home to a new directory | |
| 51 4. change the backend used in the tracker home ``select_db.py`` file | |
| 52 5. delete the "db" directory from the new directory | |
| 53 6. use the roundup-admin "import" command to import the previous export with | |
| 54 the new tracker home | |
| 55 7. test each of the admin tool, web interface and mail gateway using the new | |
| 56 backend | |
| 57 8. move the old tracker home out of the way (rename to "tracker.old") and | |
| 58 move the new tracker home into its place | |
| 59 9. restart web and email frontends | |
| 60 | |
| 61 | |
|
1397
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
62 Moving a Tracker |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
63 ================ |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
64 |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
65 If you're moving the tracker to a similar machine, you should: |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
66 |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
67 1. install Roundup on the new machine and test that it works there, |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
68 2. stop the existing tracker web and email frontends (preventing changes), |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
69 3. copy the tracker home directory over to the new machine, and |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
70 4. start the tracker web and email frontends on the new machine. |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
71 |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
72 Most of the backends are actually portable across platforms (ie. from Unix to |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
73 Windows to Mac). If this isn't the case (ie. the tracker doesn't work when |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
74 moved using the above steps) then you'll need to: |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
75 |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
76 1. install Roundup on the new machine and test that it works there, |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
77 2. stop the existing tracker web and email frontends (preventing changes), |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
78 3. use the roundup-admin tool "export" command to export the contents of |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
79 the existing tracker, |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
80 4. copy the export to the new machine, |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
81 5. use the roundup-admin "import" command to import the tracker on the new |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
82 machine, and |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
83 6. start the tracker web and email frontends on the new machine. |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
84 |
|
2219893cb787
info about moving trackers
Richard Jones <richard@users.sourceforge.net>
parents:
1218
diff
changeset
|
85 |
| 1218 | 86 ------------------- |
| 87 | |
| 88 Back to `Table of Contents`_ | |
| 89 | |
| 90 .. _`Table of Contents`: index.html | |
| 91 |