| 1 | Upgrade Instructions |
|---|
| 2 | ==================== |
|---|
| 3 | Trac environments sometimes need to be upgraded before they can be used |
|---|
| 4 | in a new version of Trac. This document describes the steps necessary |
|---|
| 5 | to upgrade an environment. |
|---|
| 6 | |
|---|
| 7 | From 0.7.x to 0.8 |
|---|
| 8 | ----------------- |
|---|
| 9 | The database schema was changed between 0.7.x and 0.8. Existing environments |
|---|
| 10 | must be upgraded before they can be used with Trac 0.8. |
|---|
| 11 | The following command will perform the upgrade: |
|---|
| 12 | |
|---|
| 13 | trac-admin /path/to/projectenv upgrade |
|---|
| 14 | |
|---|
| 15 | Trac environments are created with a default set of wiki pages. It's |
|---|
| 16 | recommended to update these pages on existing environments whenever |
|---|
| 17 | Trac is upgraded to get up-to-date documentation and additional functionality. |
|---|
| 18 | The following command will perform the update: |
|---|
| 19 | |
|---|
| 20 | trac-admin /path/to/projectenv wiki upgrade |
|---|
| 21 | |
|---|
| 22 | |
|---|
| 23 | from 0.6.x to 0.7 |
|---|
| 24 | ----------------- |
|---|
| 25 | Trac 0.7 has a new database format, requiring manual upgrade. |
|---|
| 26 | |
|---|
| 27 | Previous versions of Trac stored wiki pages, ticket, reports, |
|---|
| 28 | settings, etc. in a single SQLite database file. Trac 0.7 replaces this file |
|---|
| 29 | with a new backend storage format; the 'Trac Environment', which is a |
|---|
| 30 | directory containing an SQLite database, a human-readable configuration file, |
|---|
| 31 | log-files and attachments. |
|---|
| 32 | |
|---|
| 33 | Fear not though, old-style Trac databases can easily be converted to |
|---|
| 34 | Environments using the included "tracdb2env" program as follows: |
|---|
| 35 | |
|---|
| 36 | tracdb2env /path/to/old/project.db /path/to/new/projectenv |
|---|
| 37 | |
|---|
| 38 | tracdb2env will create a new environment and copy the information from |
|---|
| 39 | the old database to the new environment. The existing database will |
|---|
| 40 | not be modified. |
|---|
| 41 | |
|---|
| 42 | You also need to update your apache configuration: |
|---|
| 43 | change this line: |
|---|
| 44 | SetEnv TRAC_DB "/path/to/old/project.db" |
|---|
| 45 | to: |
|---|
| 46 | SetEnv TRAC_ENV "/path/to/new/projectenv" |
|---|
| 47 | |
|---|
| 48 | |
|---|
| 49 | Updating wiki pages |
|---|
| 50 | ------------------- |
|---|
| 51 | There are a set of default wiki pages included in the install, |
|---|
| 52 | automatically imported upon creating a new environment with the |
|---|
| 53 | 'trac-admin initenv' command. |
|---|
| 54 | |
|---|
| 55 | If you wish to update these pages on an already existing [older] Trac |
|---|
| 56 | environment, you can import the pages manually using trac-admin: |
|---|
| 57 | |
|---|
| 58 | trac-admin /path/to/myprojectenv wiki upgrade |
|---|
| 59 | |
|---|
| 60 | Please note that you have to repeat this step for each Trac environment |
|---|
| 61 | you wish to upgrade. |
|---|
| 62 | |
|---|
| 63 | -- |
|---|
| 64 | |
|---|
| 65 | If you have trouble upgrading Trac, please ask questions on the mailing list: |
|---|
| 66 | |
|---|
| 67 | <http://projects.edgewall.com/trac/wiki/MailingList> |
|---|
| 68 | |
|---|
| 69 | Or for other support options, see: |
|---|
| 70 | |
|---|
| 71 | <http://projects.edgewall.com/trac/wiki/TracSupport> |
|---|
