Mercurial > p > roundup > code
annotate doc/admin_guide.txt @ 2174:e19b391b6b95
*** empty log message ***
| author | Richard Jones <richard@users.sourceforge.net> |
|---|---|
| date | Thu, 01 Apr 2004 00:36:24 +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 |
