comparison doc/upgrading.txt @ 6170:dadcb4fe9f1d

Ading index entries.
author John Rouillard <rouilj@ieee.org>
date Fri, 15 May 2020 21:22:41 -0400
parents de9d602c8ce6
children 5522c950a2e4
comparison
equal deleted inserted replaced
6169:6523edf235d4 6170:dadcb4fe9f1d
1026 merged into a more full featured logging config file for 1026 merged into a more full featured logging config file for
1027 your tracker if you wish. It will create a new file in the 1027 your tracker if you wish. It will create a new file in the
1028 current working directory called 'httpd.log' and will rotate 1028 current working directory called 'httpd.log' and will rotate
1029 the log file at 500K and keep two old copies of the file. 1029 the log file at 500K and keep two old copies of the file.
1030 1030
1031 .. index:: Upgrading; 1.5.0 to 1.5.1
1032
1031 Migrating from 1.5.0 to 1.5.1 1033 Migrating from 1.5.0 to 1.5.1
1032 ============================= 1034 =============================
1033 1035
1034 User data visibility 1036 User data visibility
1035 -------------------- 1037 --------------------
1074 1076
1075 self.client.add_error_message(...) 1077 self.client.add_error_message(...)
1076 1078
1077 The new calls escape the passed string by default and avoid XSS security 1079 The new calls escape the passed string by default and avoid XSS security
1078 issues. 1080 issues.
1081
1082 .. index:: Upgrading; 1.4.20 to 1.4.21
1079 1083
1080 Migrating from 1.4.20 to 1.4.21 1084 Migrating from 1.4.20 to 1.4.21
1081 =============================== 1085 ===============================
1082 1086
1083 The ``_generic.calendar.html`` page of the instance has been updated to include 1087 The ``_generic.calendar.html`` page of the instance has been updated to include
1100 1104
1101 to invoke the xmlrpc handler. This allows us to send xml 1105 to invoke the xmlrpc handler. This allows us to send xml
1102 data to roundup for other handlers (e.g. REST, SOAP ...) 1106 data to roundup for other handlers (e.g. REST, SOAP ...)
1103 in the future. 1107 in the future.
1104 1108
1109
1110 .. index:: upgrading; 1.4.19 to 1.4.20
1111
1105 Migrating from 1.4.19 to 1.4.20 1112 Migrating from 1.4.19 to 1.4.20
1106 =============================== 1113 ===============================
1107 1114
1108 Roundup used to allow certain HTML-Tags in OK- and Error-messages. Since 1115 Roundup used to allow certain HTML-Tags in OK- and Error-messages. Since
1109 these messages are passed via the URL (due to roundup redirecting after 1116 these messages are passed via the URL (due to roundup redirecting after
1125 1132
1126 If you have not modified any roundup messages, you need not do anything, 1133 If you have not modified any roundup messages, you need not do anything,
1127 the templates shipped with roundup did not use HTML tags in messages for 1134 the templates shipped with roundup did not use HTML tags in messages for
1128 highlighting. 1135 highlighting.
1129 1136
1137
1138 .. index:: upgrading; 1.4.17 to 1.4.18
1130 1139
1131 Migrating from 1.4.17 to 1.4.18 1140 Migrating from 1.4.17 to 1.4.18
1132 =============================== 1141 ===============================
1133 1142
1134 There was a bug in 1.4.17 where files were unlinked from issues if a 1143 There was a bug in 1.4.17 where files were unlinked from issues if a
1167 list of files attached to an issue should be files 5, 17, 23 for issue42 1176 list of files attached to an issue should be files 5, 17, 23 for issue42
1168 you will set this using 1177 you will set this using
1169 1178
1170 roundup-admin -i /path/to/your/tracker set issue42 files=5,17,23 1179 roundup-admin -i /path/to/your/tracker set issue42 files=5,17,23
1171 1180
1181 .. index:: upgrading; 1.4.x to 1.4.17
1182
1172 Migrating from 1.4.x to 1.4.17 1183 Migrating from 1.4.x to 1.4.17
1173 ============================== 1184 ==============================
1174 1185
1175 There is a new config-option `migrate_passwords` in section `web` to 1186 There is a new config-option `migrate_passwords` in section `web` to
1176 auto-migrate passwords at web-login time to a more secure storage 1187 auto-migrate passwords at web-login time to a more secure storage
1226 if db.security.roleHasSearchPermission(cl,p,role): 1237 if db.security.roleHasSearchPermission(cl,p,role):
1227 roles.append(role) 1238 roles.append(role)
1228 print(" roles may search:", ', '.join(roles)) 1239 print(" roles may search:", ', '.join(roles))
1229 1240
1230 1241
1242 .. index:: upgrading; 1.4.x to 1.4.12
1243
1231 Migrating from 1.4.x to 1.4.12 1244 Migrating from 1.4.x to 1.4.12
1232 ============================== 1245 ==============================
1233 1246
1234 Item creation now checks the "Create" permission instead of the "Edit" 1247 Item creation now checks the "Create" permission instead of the "Edit"
1235 permission for individual properties. If you have modified your tracker 1248 permission for individual properties. If you have modified your tracker
1274 1287
1275 If you have made local changes to those files you'll need to manually work 1288 If you have made local changes to those files you'll need to manually work
1276 the differences in to your versions or ignore the changes. 1289 the differences in to your versions or ignore the changes.
1277 1290
1278 1291
1292 .. index:: upgrading; 1.4.x to 1.4.11
1293
1279 Migrating from 1.4.x to 1.4.11 1294 Migrating from 1.4.x to 1.4.11
1280 ============================== 1295 ==============================
1281 1296
1282 Close potential security hole 1297 Close potential security hole
1283 ----------------------------- 1298 -----------------------------
1334 1349
1335 The instructions for doing so won't be present in your tracker unless you copy 1350 The instructions for doing so won't be present in your tracker unless you copy
1336 the ``_generic.index.html`` template from the roundup distribution in 1351 the ``_generic.index.html`` template from the roundup distribution in
1337 ``share/roundup/templates/classic/html`` to your tracker's ``html`` directory. 1352 ``share/roundup/templates/classic/html`` to your tracker's ``html`` directory.
1338 1353
1354
1355 .. index:: upgrading; 1.4.x to 1.4.9
1339 1356
1340 Migrating from 1.4.x to 1.4.9 1357 Migrating from 1.4.x to 1.4.9
1341 ============================= 1358 =============================
1342 1359
1343 Customized MailGW Class 1360 Customized MailGW Class
1391 Some previous versions of this upgrading document missed ``method="POST"`` 1408 Some previous versions of this upgrading document missed ``method="POST"``
1392 in the change to the "retire" link in the user management list 1409 in the change to the "retire" link in the user management list
1393 in section `Migrating from 1.4.x to 1.4.7`_. 1410 in section `Migrating from 1.4.x to 1.4.7`_.
1394 Make sure the change is done as listed below in this document. 1411 Make sure the change is done as listed below in this document.
1395 1412
1413
1414 .. index:: upgrading; 1.4.x to 1.4.7
1396 1415
1397 Migrating from 1.4.x to 1.4.7 1416 Migrating from 1.4.x to 1.4.7
1398 ============================= 1417 =============================
1399 1418
1400 Several security issues were addressed in this release. Some aspects of your 1419 Several security issues were addressed in this release. Some aspects of your
1472 # Default: no 1491 # Default: no
1473 allow_html_file = no 1492 allow_html_file = no
1474 1493
1475 1494
1476 1495
1496 .. index:: upgrading; 1.4.2 to 1.4.3
1497
1477 Migrating from 1.4.2 to 1.4.3 1498 Migrating from 1.4.2 to 1.4.3
1478 ============================= 1499 =============================
1479 1500
1480 If you are using the MySQL backend you will need to replace some indexes 1501 If you are using the MySQL backend you will need to replace some indexes
1481 that may have been created by version 1.4.2. 1502 that may have been created by version 1.4.2.
1484 with a name ending in "_key_retired_idx". You should then re-add them with 1505 with a name ending in "_key_retired_idx". You should then re-add them with
1485 the same spec except the key column name needs a size. So an index on 1506 the same spec except the key column name needs a size. So an index on
1486 "_user (__retired, _name)" should become "_user (__retired, _name(255))". 1507 "_user (__retired, _name)" should become "_user (__retired, _name(255))".
1487 1508
1488 1509
1510 .. index:: upgrading; 1.4.x to 1.4.2
1511
1489 Migrating from 1.4.x to 1.4.2 1512 Migrating from 1.4.x to 1.4.2
1490 ============================= 1513 =============================
1491 1514
1492 You should run the "roundup-admin migrate" command for your tracker once 1515 You should run the "roundup-admin migrate" command for your tracker once
1493 you've installed the latest codebase. 1516 you've installed the latest codebase.
1501 or are using anydbm). 1524 or are using anydbm).
1502 1525
1503 It's safe to run this even if it's not required, so just get into the 1526 It's safe to run this even if it's not required, so just get into the
1504 habit. 1527 habit.
1505 1528
1529
1530 .. index:: upgrading; 1.3.3 to 1.4.0
1506 1531
1507 Migrating from 1.3.3 to 1.4.0 1532 Migrating from 1.3.3 to 1.4.0
1508 ============================= 1533 =============================
1509 1534
1510 Value of the "refwd_re" tracker configuration option (section "mailgw") 1535 Value of the "refwd_re" tracker configuration option (section "mailgw")
1529 following database indexes on the database by hand:: 1554 following database indexes on the database by hand::
1530 1555
1531 CREATE INDEX words_by_id ON __words (_textid); 1556 CREATE INDEX words_by_id ON __words (_textid);
1532 CREATE UNIQUE INDEX __textids_by_props ON __textids (_class, _itemid, _prop); 1557 CREATE UNIQUE INDEX __textids_by_props ON __textids (_class, _itemid, _prop);
1533 1558
1559 .. index:: upgrading; 1.2.x to 1.3.0
1560
1534 Migrating from 1.2.x to 1.3.0 1561 Migrating from 1.2.x to 1.3.0
1535 ============================= 1562 =============================
1536 1563
1537 1.3.0 Web interface changes 1564 1.3.0 Web interface changes
1538 --------------------------- 1565 ---------------------------
1539 1566
1540 Some of the HTML files in the "classic" and "minimal" tracker templates 1567 Some of the HTML files in the "classic" and "minimal" tracker templates
1541 were changed to fix some bugs and clean them up. You may wish to compare 1568 were changed to fix some bugs and clean them up. You may wish to compare
1542 them to the HTML files in your tracker and apply any changes. 1569 them to the HTML files in your tracker and apply any changes.
1543 1570
1571
1572 .. index:: upgrading; 1.1.2 to 1.2.0
1544 1573
1545 Migrating from 1.1.2 to 1.2.0 1574 Migrating from 1.1.2 to 1.2.0
1546 ============================= 1575 =============================
1547 1576
1548 1.2.0 Sorting and grouping by multiple properties 1577 1.2.0 Sorting and grouping by multiple properties
1570 * Templates that diplay new headlines for each group of items with 1599 * Templates that diplay new headlines for each group of items with
1571 equal group properties can now use the modified ``batch.propchanged`` 1600 equal group properties can now use the modified ``batch.propchanged``
1572 method that can take several properties which are checked for 1601 method that can take several properties which are checked for
1573 changes. See the example in the classic template which makes use of 1602 changes. See the example in the classic template which makes use of
1574 ``batch.propchanged``. 1603 ``batch.propchanged``.
1604
1605 .. index:: upgrading; 1.1.0 to 1.1.1
1575 1606
1576 Migrating from 1.1.0 to 1.1.1 1607 Migrating from 1.1.0 to 1.1.1
1577 ============================= 1608 =============================
1578 1609
1579 1.1.1 "Clear this message" 1610 1.1.1 "Clear this message"
1601 1632
1602 If you implemented the "clear this message" in your 1.1.0 tracker, then you 1633 If you implemented the "clear this message" in your 1.1.0 tracker, then you
1603 should change it to the above and it will work much better! 1634 should change it to the above and it will work much better!
1604 1635
1605 1636
1637 .. index:: upgrading; 1.0.x to 1.1.0
1638
1606 Migrating from 1.0.x to 1.1.0 1639 Migrating from 1.0.x to 1.1.0
1607 ============================= 1640 =============================
1608 1641
1609 1.1 Login "For Session Only" 1642 1.1 Login "For Session Only"
1610 ---------------------------- 1643 ----------------------------
1651 tal:content="structure string:$m <br/ > " /> 1684 tal:content="structure string:$m <br/ > " />
1652 <a class="form-small" tal:attributes="href string:issue${context/id}" 1685 <a class="form-small" tal:attributes="href string:issue${context/id}"
1653 i18n:translate="">clear this message</a> 1686 i18n:translate="">clear this message</a>
1654 </p> 1687 </p>
1655 1688
1689
1690 .. index:: upgrading; 0.8.x to 1.0
1656 1691
1657 Migrating from 0.8.x to 1.0 1692 Migrating from 0.8.x to 1.0
1658 =========================== 1693 ===========================
1659 1694
1660 1.0 New Query Permissions 1695 1.0 New Query Permissions
1692 so it looks like:: 1727 so it looks like::
1693 1728
1694 for cl in 'issue', 'file', 'msg', 'keyword': 1729 for cl in 'issue', 'file', 'msg', 'keyword':
1695 1730
1696 1731
1732 .. index:: upgrading; 0.8.0 to 0.8.3
1733
1697 Migrating from 0.8.0 to 0.8.3 1734 Migrating from 0.8.0 to 0.8.3
1698 ============================= 1735 =============================
1699 1736
1700 0.8.3 Nosy Handling Changes 1737 0.8.3 Nosy Handling Changes
1701 --------------------------- 1738 ---------------------------
1706 directory of the source to your tracker's ``templates`` directory. 1743 directory of the source to your tracker's ``templates`` directory.
1707 1744
1708 If you have modified the ``nosyreaction.py`` file from the standard 1745 If you have modified the ``nosyreaction.py`` file from the standard
1709 version, you will need to roll your changes into the new file. 1746 version, you will need to roll your changes into the new file.
1710 1747
1748
1749 .. index:: upgrading; 0.7.1 to 0.8.0
1711 1750
1712 Migrating from 0.7.1 to 0.8.0 1751 Migrating from 0.7.1 to 0.8.0
1713 ============================= 1752 =============================
1714 1753
1715 You *must* fully uninstall previous Roundup version before installing 1754 You *must* fully uninstall previous Roundup version before installing
1863 1902
1864 See the `administration guide`_ for information about configuring the new 1903 See the `administration guide`_ for information about configuring the new
1865 logging implemented in 0.8.0. 1904 logging implemented in 0.8.0.
1866 1905
1867 1906
1907 .. index:: upgrading; 0.7.2 to 0.7.3
1908
1868 Migrating from 0.7.2 to 0.7.3 1909 Migrating from 0.7.2 to 0.7.3
1869 ============================= 1910 =============================
1870 1911
1871 0.7.3 Configuration 1912 0.7.3 Configuration
1872 ------------------- 1913 -------------------
1876 directory defaults to the ``TEMPLATES`` configuration variable. You may 1917 directory defaults to the ``TEMPLATES`` configuration variable. You may
1877 define a new variable, ``STATIC_FILES`` which overrides this value for 1918 define a new variable, ``STATIC_FILES`` which overrides this value for
1878 static files. 1919 static files.
1879 1920
1880 1921
1922 .. index:: upgrading; 0.7.0 to 0.7.2
1923
1881 Migrating from 0.7.0 to 0.7.2 1924 Migrating from 0.7.0 to 0.7.2
1882 ============================= 1925 =============================
1883 1926
1884 0.7.2 DEFAULT_TIMEZONE is now required 1927 0.7.2 DEFAULT_TIMEZONE is now required
1885 -------------------------------------- 1928 --------------------------------------
1889 1932
1890 # You may specify a different default timezone, for use when users do not 1933 # You may specify a different default timezone, for use when users do not
1891 # choose their own in their settings. 1934 # choose their own in their settings.
1892 DEFAULT_TIMEZONE = 0 # specify as numeric hour offest 1935 DEFAULT_TIMEZONE = 0 # specify as numeric hour offest
1893 1936
1937 .. index:: upgrading; 0.7.0 to 0.7.1
1894 1938
1895 Migrating from 0.7.0 to 0.7.1 1939 Migrating from 0.7.0 to 0.7.1
1896 ============================= 1940 =============================
1897 1941
1898 0.7.1 Permission assignments 1942 0.7.1 Permission assignments
1917 db.security.addPermissionToRole('Anonymous', p) 1961 db.security.addPermissionToRole('Anonymous', p)
1918 1962
1919 next to the existing ``'User'`` lines for the Permissions you wish to 1963 next to the existing ``'User'`` lines for the Permissions you wish to
1920 assign to the anonymous user. 1964 assign to the anonymous user.
1921 1965
1966
1967 .. index:: upgrading; versions earlier than 0.7
1922 1968
1923 Migrating from 0.6 to 0.7 1969 Migrating from 0.6 to 0.7
1924 ========================= 1970 =========================
1925 1971
1926 0.7.0 Permission assignments 1972 0.7.0 Permission assignments

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