Mercurial > p > roundup > code
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 |
