comparison doc/upgrading.txt @ 5944:d7e6bcde5cbe

Final touchups python -> Python, reconcile config file names.
author John Rouillard <rouilj@ieee.org>
date Tue, 22 Oct 2019 17:08:16 -0400
parents 29d428927362
children 5148e46dd314
comparison
equal deleted inserted replaced
5943:52bf078368e8 5944:d7e6bcde5cbe
25 25
26 Upgrade tracker's config.ini file 26 Upgrade tracker's config.ini file
27 -------------------------------------- 27 --------------------------------------
28 Once you have installed the new roundup, use: 28 Once you have installed the new roundup, use:
29 29
30 roundup-admin -i /path/to/tracker updateconfig new_init_file.ini 30 roundup-admin -i /path/to/tracker updateconfig newconfig.ini
31 31
32 to generate a new ini file preserving all your settings. You can then 32 to generate a new ini file preserving all your settings. You can then
33 merge any local comments from the tracker's ``config.ini`` into 33 merge any local comments from the tracker's ``config.ini`` into
34 ``new_init_file.ini``. Compare the old and new files and configure set 34 ``newconfig.ini``. Compare the old and new files and configure any new
35 any new settings as you want. Then replace ``config.ini`` with the new 35 settings as you want. Then replace ``config.ini`` with the
36 ini file. 36 ``newconfig.ini`` file.
37 37
38 Python 3 support 38 Python 3 support
39 ---------------- 39 ----------------
40 40
41 Many of the ``.html`` and ``.py`` files from Roundup that are copied 41 Many of the ``.html`` and ``.py`` files from Roundup that are copied
49 you do not need to export and import, but need to delete the 49 you do not need to export and import, but need to delete the
50 ``db/otks`` and ``db/sessions`` files when changing Python version. 50 ``db/otks`` and ``db/sessions`` files when changing Python version.
51 If using the ``postgresql`` backend, you do not need to export and 51 If using the ``postgresql`` backend, you do not need to export and
52 import and no other special database-related steps are needed. 52 import and no other special database-related steps are needed.
53 53
54 Octal values in config.ini change from the python 2 representation 54 Octal values in config.ini change from the Python 2 representation
55 with a leading ``0`` (``022``). They now use a leading ``0o`` 55 with a leading ``0`` (``022``). They now use a leading ``0o``
56 (``0o22``). Note that the ``0o`` format is properly handled under 56 (``0o22``). Note that the ``0o`` format is properly handled under
57 python 2. You can use the ``newfile.ini`` generated using 57 python 2. You can use the ``newconfig.ini`` generated using ``python3
58 ``python3 roundup-admin ... updateconfig newfile.ini`` 58 roundup-admin -i ... updateconfig newconfig.ini`` if you want to go
59 if you want to go back to using python 2. 59 back to using python 2. (Note going back to Python 2 will require
60 the same steps as moving from 2 to 3 except using Python 3 to perform
61 the export.)
60 62
61 PGP mail processing 63 PGP mail processing
62 ------------------- 64 -------------------
63 65
64 Roundup now uses the ``gpg`` module instead of ``pyme`` to process PGP 66 Roundup now uses the ``gpg`` module instead of ``pyme`` to process PGP

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