Edgewall Software

Changes between Version 4 and Version 5 of 0.12/TracUpgrade


Ignore:
Timestamp:
Mar 24, 2010, 6:01:54 AM (14 years ago)
Author:
mark.m.mcmahon@…
Comment:

Saving an intermediate version before removing all 0.10 → 0.11 upgrade information.

Legend:

Unmodified
Added
Removed
Modified
  • 0.12/TracUpgrade

    v4 v5  
    99
    1010Get the new version as described in TracInstall, or your operating system specific procedure.
     11
     12{{{#!div style="background:#efe"
     13Rewrite / Remove:  Do we keep this? Should the number be changed to 0.12? Or should it be moved to TracInstall?
     14}}}
    1115
    1216If you installed a recent 0.11 version of Trac via {{{easy_install}}}, it might be the easiest to use it also to upgrade you Trac installation.
     
    2832This cleanup is not mandatory, but it makes it easier to troubleshoot issues later on, as you won't waste your time looking at code or templates from a previous release that are not being used anymore... As usual, make a backup before actually deleting things.
    2933
    30 If you had the webadmin plugin installed, you can now uninstall it as it is now part of the Trac code base.
    31 
    3234=== 2. Upgrade the Trac Environment === #UpgradetheTracEnvironment
    3335
     
    4648trac-admin /path/to/projenv upgrade --no-backup
    4749}}}
    48 
    49 If you are using custom CSS styles or modified templates in the templates directory of the TracEnvironment, you will need to convert them to the Genshi way of doing things. To continue to use your style sheet, follow the instructions at TracInterfaceCustomization#SiteAppearance.
    5050
    5151=== 3. Update the Trac Documentation === #UpdatetheTracDocumentation
     
    6868=== 5. Steps specific to a given Trac version  ===
    6969==== Upgrading to Trac 0.12 ====
     70===== Python 2.3 no longer supported =====
     71The minimum supported version of python is now 2.4
     72
     73===== SQLite v3.x required =====
    7074SQLite v2.x is no longer supported, if you happen to still use a Trac database using this format, you'll need to convert it to SQLite v3.x first. See [trac:PySqlite#UpgradingSQLitefrom2.xto3.x] for details.
    7175
     76===== Multiple Repository Support =====
    7277If you plan to add more repositories to your Trac instance, as this is now possible with the newly introduced multiple repository support, please refer to TracRepositoryAdmin#Migration.
    7378
     
    7580
    7681==== Upgrading to Trac 0.11 ====
    77 ===== Site Templates =====
    78 The templating engine has changed in 0.11, please look at TracInterfaceCustomization for more information.
     82===== Site Templates and Styles =====
     83The templating engine has changed in 0.11 to Genshi, please look at TracInterfaceCustomization for more information.
     84
     85If you are using custom CSS styles or modified templates in the `templates` directory of the TracEnvironment, you will need to convert them to the Genshi way of doing things. To continue to use your style sheet, follow the instructions at TracInterfaceCustomization#SiteAppearance.
    7986
    8087===== Trac Macros, Plugins =====
     
    8996This will create a deploy directory with the following two subdirectories: `cgi-bin` and `htdocs`. Then update your Apache configuration file `httpd.conf` with this new `trac.cgi` location and `htdocs` location.
    9097
     98===== Web Admin plugin integrated =====
     99If you had the webadmin plugin installed, you can uninstall it as it is part of the Trac code base since 0.11.
     100
    91101=== 6. Restart the Web Server === #RestarttheWebServer
    92102
     
    99109
    100110=== some core modules won't load ===
     111{{{#!div style="background:#efe"
     112To be removed? As Python 2.3 is no longer supported does it mean that this issue no longer happens?
     113}}}
     114
    101115This can happen in particular with Python 2.3 on Windows when upgrading without uninstalling first.
    102116Some modules were previously capitalized and were changed to lower case, e.g. trac/About.py became trac/about.py. You may find such messages in the Trac log:
     
    117131== Older Versions ==
    118132
    119 For upgrades from versions older than Trac 0.10, refer first to trac:wiki:0.10/TracUpgrade.
     133For upgrades from versions older than Trac 0.11, refer first to trac:wiki:0.11/TracUpgrade.
    120134
     135{{{#!div style="background:#efe"
     136Will this also apply to 0.12 -> 0.11
     137}}}
    121138Note that downgrading from Trac 0.11 to Trac 0.10.4 or 0.10.5 is easy, but has to be done manually, e.g.
    122139{{{