close
    Warning:
    BrowserModule failed with ConfigurationError: Look in the Trac log for more information.
  
 
      
      
        
      
      
      
        - Timestamp:
- 
          Jul 9, 2015, 8:37:31 AM (10 years ago)
        
- Author:
- 
          trac
        
- Comment:
- 
          
--
 
        
          Legend:
          
            - Unmodified
- Added
- Removed
- Modified
 
  
    - 
      
      
        
          
        
        
          
            | v3 | v4 |  |  
            | 1 | 1 | = Upgrade Instructions = |  
            | 2 | 2 | [[TracGuideToc]] |  
            | 3 |  | [[PageOutline(2- 3,,inline,unnumbered)]] |  
            |  | 3 | [[PageOutline(2-4,,inline,unnumbered)]] |  
            | 4 | 4 |  |  
            | 5 | 5 | == Instructions == |  
            | … | … |  |  
            | 15 | 15 | Get the new version as described in TracInstall, or your operating system specific procedure. |  
            | 16 | 16 |  |  
            | 17 |  | If you already have a 0.1 1version of Trac installed via `easy_install`, it might be easiest to also use `easy_install` to upgrade your Trac installation: |  
            | 18 |  |  |  
            | 19 |  | {{{  |  
            | 20 |  | # easy_install --upgrade Trac== 0.12 |  
            |  | 17 | If you already have a 0.12 version of Trac installed via `easy_install`, it might be easiest to also use `easy_install` to upgrade your Trac installation: |  
            |  | 18 |  |  
            |  | 19 | {{{ |  
            |  | 20 | # easy_install --upgrade Trac==1.0 |  
            | 21 | 21 | }}} |  
            | 22 | 22 |  |  
            | … | … |  |  
            | 74 | 74 |  |  
            | 75 | 75 | === 6. Steps specific to a given Trac version  === |  
            |  | 76 |  |  
            |  | 77 | ==== Upgrading from Trac 0.12 to Trac 1.0 ==== #to1.0 |  
            |  | 78 |  |  
            |  | 79 | ===== Python 2.4 no longer supported ===== |  
            |  | 80 | The minimum supported version of python is now 2.5 |  
            |  | 81 |  |  
            |  | 82 | ===== Subversion components not enabled by default for new installations |  
            |  | 83 | The Trac components for Subversion support are no longer enabled by default. To enable the svn support, you need to make sure the `tracopt.versioncontrol.svn` components are enabled, for example by setting the following in the TracIni: |  
            |  | 84 | {{{ |  
            |  | 85 | [components] |  
            |  | 86 | tracopt.versioncontrol.svn.* = enabled |  
            |  | 87 | }}} |  
            |  | 88 | The upgrade procedure should take care of this and change the TracIni appropriately, unless you already had the svn components explicitly disabled. |  
            |  | 89 |  |  
            |  | 90 |  |  
            |  | 91 | ===== Attachments migrated to new location |  
            |  | 92 | Another step in the automatic upgrade will change the way the attachments are stored. If you're a bit paranoid, you might want to take a backup of the `attachments` directory before upgrading (but if you are, you already did a full copy of the environment, no?). In case the `attachments` directory contains some files which are //not// attachments, the last step of the migration to the new layout will fail: the deletion of the now unused `attachments` directory can't be done if there are still files and folders in it. You may ignore this error, but better go have a look to these files, move them elsewhere and remove the `attachments` directory manually to cleanup the environment. The attachments themselves are now all located in your environment below the `files/attachments` directory. |  
            |  | 93 |  |  
            |  | 94 | ===== Behavior of `[ticket] default_owner` changed |  
            |  | 95 | Prior to 1.0, the owner field of new tickets always defaulted to `[ticket] default_owner` when the value was not empty. If the value was empty, the owner field defaulted to to the Component's owner. In 1.0 and later, the `default_owner` must be set to `< default >` to make new tickets default to the Component's owner. This change allows the `default_owner` to be set to an empty value if no default owner is desired. |  
            |  | 96 |  |  
            |  | 97 |  |  
            | 76 | 98 | ==== Upgrading from Trac 0.11 to Trac 0.12 ==== |  
            | 77 | 99 |  |  
            | … | … |  |  
            | 92 | 114 | ===== Resynchronize the Trac Environment Against the Source Code Repository ===== |  
            | 93 | 115 |  |  
            | 94 |  | Each [TracEnvironment Trac environment] must be resynchronized against the source code repository in order to avoid errors such as "[ http://trac.edgewall.org/ticket/6120 No changeset ??? in the repository]" while browsing the source through the Trac interface: |  
            |  | 116 | Each [TracEnvironment Trac environment] must be resynchronized against the source code repository in order to avoid errors such as "[trac:#6120 No changeset ??? in the repository]" while browsing the source through the Trac interface: |  
            | 95 | 117 |  |  
            | 96 | 118 | {{{ |  
            | … | … |  |  
            | 103 | 125 | While you can keep the same synchronization as in 0.11 adding the post-commit hook as outlined in TracRepositoryAdmin#Synchronization and TracRepositoryAdmin#ExplicitSync will allow more efficient synchronization and is more or less required for multiple repositories. |  
            | 104 | 126 |  |  
            | 105 |  | Note that if you were using the `trac-post-commit-hook`, ''you're strongly advised to upgrade it'' to the new hook documented in the above references , as the old hook will not work with anything else than the default repository and even for this case, it won't trigger the appropriate notifications. |  
            |  | 127 | Note that if you were using the `trac-post-commit-hook`, ''you're strongly advised to upgrade it'' to the new hook documented in the above references and [TracWorkflow#Howtocombinethetracopt.ticket.commit_updaterwiththetestingworkflow here], as the old hook will not work with anything else than the default repository and even for this case, it won't trigger the appropriate notifications. |  
            | 106 | 128 |  |  
            | 107 | 129 | ===== Authz permission checking ===== |  
            | … | … |  |  
            | 171 | 193 |  |  
            | 172 | 194 | === Changing Database Backend === |  
            | 173 |  | ==== SQLite to PostgreSQL ==== |  
            | 174 |  |  |  
            | 175 |  | The [http://trac-hacks.org/wiki/SqliteToPgScript sqlite2pg] script on [http://trac-hacks.org trac-hacks.org] has been written to assist in migrating a SQLite database to a PostgreSQL database |  
            |  | 195 |  |  
            |  | 196 | The [http://trac-hacks.org/wiki/TracMigratePlugin TracMigratePlugin] on [http://trac-hacks.org trac-hacks.org] has been written to assist in migrating between SQLite, MySQL and PostgreSQL databases. |  
            | 176 | 197 |  |  
            | 177 | 198 | === Upgrading from older versions of Trac === #OlderVersions |