Mercurial > p > roundup > code
annotate doc/maintenance.txt @ 1409:8dc60d87ab42
Fixed a backlog of bug reports, and worked on python 2.3 compatibility:
- fixed templating filter function arguments [SF#678911]
- fixed multiselect in searching [SF#676874]
- fixed parsing of content-disposition filenames [SF#675116]
- added 'h' to roundup-server optarg list [SF#674070]
- fixed doc for db.history in anydbm and rdbms_common [SF#679221]
- fixed timelog example so it handles new issues [SF#678908]
- handle missing os.fork() [SF#681046]
- fixed roundup-reminder [SF#681042]
- fixed int assumptions about Number values [SF#677762]
- added warning filter for "FutureWarning: hex/oct constants > sys.maxint will
return positive values..." (literal 0xffff0000 in portalocker.py)
- fixed ZPT code generating SyntaxWarning for assignment to None
| author | Richard Jones <richard@users.sourceforge.net> |
|---|---|
| date | Thu, 06 Feb 2003 05:43:49 +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 |