Mercurial > p > roundup > code
comparison doc/admin_guide.txt @ 6781:b3d4b25b4922
Add links some updates.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Tue, 12 Jul 2022 21:58:34 -0400 |
| parents | e7b4ad2c57ac |
| children | 3f60a71b0812 |
comparison
equal
deleted
inserted
replaced
| 6780:f1af67bf8fae | 6781:b3d4b25b4922 |
|---|---|
| 554 | 554 |
| 555 | 555 |
| 556 Software Upgrade | 556 Software Upgrade |
| 557 ---------------- | 557 ---------------- |
| 558 | 558 |
| 559 Always make a backup of your tracker before upgrading software. Steps you may | 559 .. _make a backup: #tracker-backup |
| 560 take: | 560 |
| 561 Always `make a backup`_ of your tracker before upgrading software. | |
| 562 Steps you may take: | |
| 561 | 563 |
| 562 1. Install pytest and ensure that the unit tests run on your system | 564 1. Install pytest and ensure that the unit tests run on your system |
| 563 (using your preferred python version):: | 565 (using your preferred python version):: |
| 564 | 566 |
| 565 pip2 install pytest | 567 pip2 install pytest |
| 574 4. Stop the tracker web and email frontends. | 576 4. Stop the tracker web and email frontends. |
| 575 5. Install the new version of the software:: | 577 5. Install the new version of the software:: |
| 576 | 578 |
| 577 python setup.py install | 579 python setup.py install |
| 578 | 580 |
| 579 6. Follow the steps in the `upgrading documentation`_ for the new version of | 581 6. Follow the steps in the `upgrading documentation`_ for all the |
| 580 the software in the copied. | 582 version between your original version and th new version. |
| 581 | 583 |
| 582 Usually you will be asked to run `roundup_admin migrate` on your tracker | 584 Usually you should run `roundup_admin -i <tracker_home> migrate` |
| 583 before you allow users to start accessing the tracker. | 585 on your tracker(s) before you allow users to start accessing the tracker. |
| 584 | 586 |
| 585 It's safe to run this even if it's not required, so just get into the | 587 It's safe to run this even if it's not required, so just get into the |
| 586 habit. | 588 habit. |
| 587 7. Restart your tracker web and email frontends. | 589 7. Restart your tracker web and email frontends. |
| 588 | 590 |
| 589 If something bad happens, you may reinstate your backup of the tracker and | 591 If something bad happens, you may reinstate your backup of the tracker and |
| 590 reinstall the older version of the sofware using the same install command:: | 592 reinstall the older version of the sofware using the same install command:: |
| 591 | 593 |
| 592 python setup.py install | 594 python setup.py install |
| 593 | |
| 594 | 595 |
| 595 .. index:: database; convert from one database backend to another | 596 .. index:: database; convert from one database backend to another |
| 596 single: roundup-admin; import and export | 597 single: roundup-admin; import and export |
| 597 | 598 |
| 598 Migrating Backends | 599 Migrating Backends |