Mercurial > p > roundup > code
annotate doc/admin_guide.txt @ 2119:cc4667ef3f12
Added the ability to toggle where error messages go.
They either go to the user (default, for backwards compatibility), the
dispatcher, or both. These are able to be toggled via settings in config.py.
Please refer to upgrading.txt for more details. (And Richard, let me know
if I've done anything wrong with this checkin. :))
| author | Eddie Parker <eparker@users.sourceforge.net> |
|---|---|
| date | Thu, 25 Mar 2004 19:27:15 +0000 |
| parents | 65b5297b488f |
| children | a276e2531321 |
| rev | line source |
|---|---|
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
1 ==================== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
2 Administration Guide |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
3 ==================== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
4 |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
5 :Version: $Revision: 1.3 $ |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
6 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
7 .. contents:: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
8 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
9 What does Roundup install? |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
10 ========================== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
11 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
12 There's two "installations" that we talk about when using Roundup: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
13 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
14 1. The installation of the software and its support files. This uses the |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
15 standard Python mechanism called "distutils" and thus Roundup's core code, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
16 executable scripts and support data files are installed in Python's |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
17 directories. On Windows, this is typically: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
18 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
19 Scripts |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
20 ``<python dir>\scripts\...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
21 Core code |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
22 ``<python dir>\lib\site-packages\roundup\...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
23 Support files |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
24 ``<python dir>\share\roundup\...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
25 |
|
2005
fc52d57c6c3e
documentation cleanup
Richard Jones <richard@users.sourceforge.net>
parents:
2003
diff
changeset
|
26 and on Unix-like systems (eg. Linux): |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
27 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
28 Scripts |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
29 ``<python root>/bin/...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
30 Core code |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
31 ``<python root>/lib-<python version>/site-packages/roundup/...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
32 Support files |
|
2068
65b5297b488f
*** empty log message ***
Richard Jones <richard@users.sourceforge.net>
parents:
2005
diff
changeset
|
33 ``<python root>/share/roundup/...`` |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
34 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
35 2. The installation of a specific tracker. When invoking the roundup-admin |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
36 "inst" (and "init") commands, you're creating a new Roundup tracker. This |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
37 installs configuration files, HTML templates, detector code and a new |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
38 database. You have complete control over where this stuff goes through |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
39 both choosing your "tracker home" and the DATABASE variable in |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
40 config.py. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
41 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
42 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
43 Users and Security |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
44 ================== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
45 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
46 Roundup holds its own user database which primarily contains a username, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
47 password and email address for the user. Roundup *must* have its own user |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
48 listing, in order to maintain internal consistency of its data. It is a |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
49 relatively simple exercise to update this listing on a regular basis, or on |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
50 demand, so that it matches an external listing (eg. unix passwd file, LDAP, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
51 etc.) |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
52 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
53 Roundup identifies users in a number of ways: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
54 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
55 1. Through the web, users may be identified by either HTTP Basic |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
56 Authentication or cookie authentication. If you are running the web |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
57 server (roundup-server) through another HTTP server (eg. apache or IIS) |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
58 then that server may require HTTP Basic Authentication, and it will pass |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
59 the ``REMOTE_USER`` variable through to Roundup. If this variable is not |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
60 present, then Roundup defaults to using its own cookie-based login |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
61 mechanism. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
62 2. In email messages handled by roundup-mailgw, users are identified by the |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
63 From address in the message. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
64 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
65 In both cases, Roundup's behaviour when dealing with unknown users is |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
66 controlled by Permissions defined in the "SECURITY SETTINGS" section of the |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
67 tracker's ``dbinit.py`` module: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
68 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
69 Web Registration |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
70 If granted to the Anonymous Role, then anonymous users will be able to |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
71 register through the web. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
72 Email Registration |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
73 If granted to the Anonymous Role, then email messages from unknown users |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
74 will result in those users being registered with the tracker. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
75 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
76 More information about how to customise your tracker's security settings |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
77 may be found in the `customisation documentation`_. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
78 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
79 Tasks |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
80 ===== |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
81 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
82 Maintenance of Roundup can involve one of the following: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
83 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
84 1. `tracker backup`_ |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
85 2. `software upgrade`_ |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
86 3. `migrating backends`_ |
|
2005
fc52d57c6c3e
documentation cleanup
Richard Jones <richard@users.sourceforge.net>
parents:
2003
diff
changeset
|
87 4. `moving a tracker`_ |
|
2003
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
88 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
89 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
90 Tracker Backup |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
91 -------------- |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
92 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
93 Stop the web and email frontends and to copy the contents of the tracker home |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
94 directory to some other place using standard backup tools. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
95 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
96 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
97 Software Upgrade |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
98 ---------------- |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
99 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
100 Always make a backup of your tracker before upgrading software. Steps you may |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
101 take: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
102 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
103 1. ensure that the unit tests run on your system |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
104 2. copy your tracker home to a new directory |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
105 3. follow the steps in the upgrading documentation for the new version of |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
106 the software |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
107 4. test each of the admin tool, web interface and mail gateway using the new |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
108 version of the software |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
109 5. stop the production web and email frontends |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
110 6. perform the upgrade steps on the existing tracker directory |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
111 7. upgrade the software |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
112 8. restart your tracker |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
113 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
114 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
115 Migrating Backends |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
116 ------------------ |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
117 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
118 1. stop the existing tracker web and email frontends (preventing changes) |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
119 2. use the roundup-admin tool "export" command to export the contents of |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
120 your tracker to disk |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
121 3. copy the tracker home to a new directory |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
122 4. change the backend used in the tracker home ``select_db.py`` file |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
123 5. delete the "db" directory from the new directory |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
124 6. use the roundup-admin "import" command to import the previous export with |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
125 the new tracker home |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
126 7. test each of the admin tool, web interface and mail gateway using the new |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
127 backend |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
128 8. move the old tracker home out of the way (rename to "tracker.old") and |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
129 move the new tracker home into its place |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
130 9. restart web and email frontends |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
131 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
132 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
133 Moving a Tracker |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
134 ---------------- |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
135 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
136 If you're moving the tracker to a similar machine, you should: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
137 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
138 1. install Roundup on the new machine and test that it works there, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
139 2. stop the existing tracker web and email frontends (preventing changes), |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
140 3. copy the tracker home directory over to the new machine, and |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
141 4. start the tracker web and email frontends on the new machine. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
142 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
143 Most of the backends are actually portable across platforms (ie. from Unix to |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
144 Windows to Mac). If this isn't the case (ie. the tracker doesn't work when |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
145 moved using the above steps) then you'll need to: |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
146 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
147 1. install Roundup on the new machine and test that it works there, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
148 2. stop the existing tracker web and email frontends (preventing changes), |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
149 3. use the roundup-admin tool "export" command to export the contents of |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
150 the existing tracker, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
151 4. copy the export to the new machine, |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
152 5. use the roundup-admin "import" command to import the tracker on the new |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
153 machine, and |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
154 6. start the tracker web and email frontends on the new machine. |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
155 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
156 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
157 ------------------- |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
158 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
159 Back to `Table of Contents`_ |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
160 |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
161 .. _`Table of Contents`: index.html |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
162 .. _`customisation documentation`: customizing.html |
|
a291bf753037
maintenance -> admin guide
Richard Jones <richard@users.sourceforge.net>
parents:
diff
changeset
|
163 |
