Edgewall Software

Changes between Version 17 and Version 18 of 1.1/TracUpgrade


Ignore:
Timestamp:
Aug 8, 2015, 5:23:27 AM (7 years ago)
Author:
Ryan J Ollos
Comment:

Attempt to clarify some confusing aspects of the upgrade step.

Legend:

Unmodified
Added
Removed
Modified
  • 1.1/TracUpgrade

    v17 v18  
    1616=== 2. Update the Trac Code #UpdatetheTracCode
    1717
    18 Get the new version as described in TracInstall, or your operating system specific procedure.
    19 
    20 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:
     18Get the new version as described in TracInstall, or through your operating system package manager.
     19
     20If you already an earlier version of Trac installed via `easy_install`, it might be easiest to also use `easy_install` to upgrade your Trac installation:
    2121
    2222{{{#!sh
    2323easy_install --upgrade Trac==1.0
    2424}}}
    25 
    26 If you do a manual (not operating system-specific) upgrade, you should also stop any running Trac servers before the installation. Doing "hot" upgrades is not advised, especially on Windows ([trac:#7265]).
    2725
    2826You may also want to remove the pre-existing Trac code by deleting the `trac` directory from the Python `lib/site-packages` directory, or remove Trac `.egg` files from former versions.
     
    3230 * on MacOSX: `/Library/Python/2.X/site-packages`
    3331
    34 You may also want to remove the Trac `cgi-bin`, `htdocs`, `templates` and `wiki-default` directories that are commonly found in a directory called `share/trac`. The exact location depends on your platform. This cleanup is not mandatory, but makes it easier to troubleshoot issues later on, as your installation is uncluttered by code or templates from a previous release that is not used anymore. As usual, make a backup before actually removing things.
     32You may also want to remove the directory in which your static resources are [TracInstall#cgi-bin deployed]. The exact location depends on your platform. This cleanup is not mandatory, but makes it easier to troubleshoot issues later on, as your installation is uncluttered by code or templates from a previous release that is not used anymore. As usual, make a backup before actually removing things.
    3533
    3634=== 3. Upgrade the Trac Environment #UpgradetheTracEnvironment
     
    7876
    7977===== Python 2.5 no longer supported
    80 Upgrade Python to at least 2.6, but not 3.0.
     78Upgrade Python to at least 2.6 or 2.7, but not 3.0 or greater.
    8179
    8280===== Obsolete Plugins