|   | 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 |