Mercurial > p > roundup > code
comparison doc/admin_guide.txt @ 4014:b80224c1f4e3
fix poor docs
| author | Richard Jones <richard@users.sourceforge.net> |
|---|---|
| date | Wed, 03 Sep 2008 09:40:58 +0000 |
| parents | 3230f9c88086 |
| children | be9122d753c5 |
comparison
equal
deleted
inserted
replaced
| 4013:a5b68d46bce8 | 4014:b80224c1f4e3 |
|---|---|
| 1 ==================== | 1 ==================== |
| 2 Administration Guide | 2 Administration Guide |
| 3 ==================== | 3 ==================== |
| 4 | 4 |
| 5 :Version: $Revision: 1.27 $ | 5 :Version: $Revision: 1.28 $ |
| 6 | 6 |
| 7 .. contents:: | 7 .. contents:: |
| 8 | 8 |
| 9 What does Roundup install? | 9 What does Roundup install? |
| 10 ========================== | 10 ========================== |
| 205 python run_tests.py | 205 python run_tests.py |
| 206 | 206 |
| 207 2. If you're using an RDBMS backend, make a backup of its contents now. | 207 2. If you're using an RDBMS backend, make a backup of its contents now. |
| 208 3. Make a backup of the tracker home itself. | 208 3. Make a backup of the tracker home itself. |
| 209 4. Stop the tracker web and email frontends. | 209 4. Stop the tracker web and email frontends. |
| 210 5. Follow the steps in the `upgrading documentation`_ for the new version of | 210 5. Install the new version of the software:: |
| 211 | |
| 212 python setup.py install | |
| 213 | |
| 214 6. Follow the steps in the `upgrading documentation`_ for the new version of | |
| 211 the software in the copied. | 215 the software in the copied. |
| 212 | 216 |
| 213 Usually you will be asked to run `roundup_admin migrate` on your tracker | 217 Usually you will be asked to run `roundup_admin migrate` on your tracker |
| 214 before you allow users to start accessing the tracker. | 218 before you allow users to start accessing the tracker. |
| 215 | 219 |
| 216 It's safe to run this even if it's not required, so just get into the | 220 It's safe to run this even if it's not required, so just get into the |
| 217 habit. | 221 habit. |
| 218 6. You may test each of the admin tool, web interface and mail gateway using | 222 7. Restart your tracker web and email frontends. |
| 219 the new version of the software. To do this, invoke the scripts directly | |
| 220 in the source directory with:: | |
| 221 | |
| 222 PYTHONPATH=. python roundup/scripts/roundup_server.py <normal arguments> | |
| 223 PYTHONPATH=. python roundup/scripts/roundup_admin.py <normal arguments> | |
| 224 PYTHONPATH=. python roundup/scripts/roundup_mailgw.py <normal arguments> | |
| 225 | |
| 226 Note that on Windows, this would read:: | |
| 227 | |
| 228 C:\sources\roundup-0.7.4> SET PYTHONPATH=. | |
| 229 C:\sources\roundup-0.7.4> python roundup/scripts/roundup_server.py <normal arguments> | |
| 230 | |
| 231 7. Once you're comfortable that the upgrade will work using that copy, you | |
| 232 should install the new version of the software:: | |
| 233 | |
| 234 python setup.py install | |
| 235 | |
| 236 8. Restart your tracker web and email frontends. | |
| 237 | 223 |
| 238 If something bad happens, you may reinstate your backup of the tracker and | 224 If something bad happens, you may reinstate your backup of the tracker and |
| 239 reinstall the older version of the sofware using the same install command:: | 225 reinstall the older version of the sofware using the same install command:: |
| 240 | 226 |
| 241 python setup.py install | 227 python setup.py install |