| | 1 | = Upgrade Instructions = |
| | 2 | [[TracGuideToc]] |
| | 3 | |
| | 4 | Trac environments sometimes need to be upgraded before they can be used |
| | 5 | in a new version of Trac. This document describes the steps necessary |
| | 6 | to upgrade an environment. |
| | 7 | |
| | 8 | == From 0.7.x to 0.8 == |
| | 9 | |
| | 10 | The database schema was changed between 0.7.x and 0.8. Existing environments |
| | 11 | must be upgraded before they can be used with Trac 0.8. |
| | 12 | |
| | 13 | The following command will automatically perform the upgrade: |
| | 14 | {{{ |
| | 15 | $ trac-admin /path/to/projectenv upgrade |
| | 16 | }}} |
| | 17 | |
| | 18 | Trac environments are created with a default set of wiki pages. It's |
| | 19 | recommended to update these pages on existing environments whenever |
| | 20 | Trac is upgraded to get up-to-date documentation and additional functionality. |
| | 21 | The following command will perform the update: |
| | 22 | {{{ |
| | 23 | $ trac-admin /path/to/projectenv wiki upgrade |
| | 24 | }}} |
| | 25 | |
| | 26 | 0.8 adds a new roadmap feature which requires additional permissions. While a |
| | 27 | fresh installation will by default grant ROADMAP_VIEW and MILESTONE_VIEW |
| | 28 | permissions to anonymous, these permissions have to be granted manually when |
| | 29 | upgrading: |
| | 30 | {{{ |
| | 31 | $ trac-admin /path/to/projectenv permission add anonymous MILESTONE_VIEW |
| | 32 | $ trac-admin /path/to/projectenv permission add anonymous ROADMAP_VIEW |
| | 33 | }}} |
| | 34 | |
| | 35 | ----- |
| | 36 | See also: TracGuide, TracInstall |
