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