comparison doc/upgrading.txt @ 7047:d3593cbb8e6f

Add overview of upgrading steps. Also capitalize roundup.
author John Rouillard <rouilj@ieee.org>
date Tue, 15 Nov 2022 20:31:39 -0500
parents bd2c3b2010c3
children 3359dc1dabb0
comparison
equal deleted inserted replaced
7046:7442bc16724f 7047:d3593cbb8e6f
17 If a specific version transition isn't mentioned here (eg. 0.6.7 to 0.6.8) 17 If a specific version transition isn't mentioned here (eg. 0.6.7 to 0.6.8)
18 then you don't need to do anything. If you're upgrading from 0.5.6 to 18 then you don't need to do anything. If you're upgrading from 0.5.6 to
19 0.6.8 though, you'll need to check the "0.5 to 0.6" and "0.6.x to 0.6.3" 19 0.6.8 though, you'll need to check the "0.5 to 0.6" and "0.6.x to 0.6.3"
20 steps. 20 steps.
21 21
22 General steps:
23
24 1. Make note of your current Roundup version.
25 2. Take your Roundup installation offline (web, email,
26 cron scripts, roundup-admin etc.)
27 3. Backup your Roundup instance
28 4. Install a new version of Roundup
29 5. Make version specific changes as described below for
30 each version transition. If you are starting at 1.5.0
31 and installing to 2.3, you need to make the changes for **all**
32 versions starting at 1.5 and ending at 2.3. E.G.
33 1.5.0 -> 1.5.1, 1.5.1 -> 1.6.0, ..., 2.1.0 -> 2.2.0,
34 2.2.0 -> 2.3.0.
35 6. Run ``roundup-admin -i <tracker_home> migrate`` for
36 **all** your trackers. This will update the database if
37 it is required.
38 7. Bring your Roundup instance back online
39 8. Test
40
22 **IMPORTANT** The v1.5.x releases of Roundup were the last to support 41 **IMPORTANT** The v1.5.x releases of Roundup were the last to support
23 Python v2.5 and v2.6. Starting with the v1.6 releases of Roundup 42 Python v2.5 and v2.6. Starting with the v1.6 releases of Roundup
24 Python version 2.7 that is newer than 2.7.2 is required to run 43 Python version 2.7 that is newer than 2.7.2 is required to run
25 roundup. Starting with Roundup version 2.0.0 we also support Python 3 44 Roundup. Starting with Roundup version 2.0.0 we also support Python 3
26 versions newer than 3.4. 45 versions newer than 3.4.
27 46
28 Contents: 47 Contents:
29 48
30 .. contents:: 49 .. contents::

Roundup Issue Tracker: http://roundup-tracker.org/