Changes between Version 17 and Version 18 of 1.1/TracUpgrade

Timestamp:

Aug 8, 2015, 5:23:27 AM (9 years ago)

Author:

Ryan J Ollos

Comment:

Attempt to clarify some confusing aspects of the upgrade step.

1.1/TracUpgrade

@@ -16 +16 @@
 === 2. Update the Trac Code #UpdatetheTracCode
 
-Get the new version as described in TracInstall, or your operating system specific procedure.
-
-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:
+Get the new version as described in TracInstall, or through your operating system package manager.
+
+If 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:
 
 {{{#!sh
 easy_install --upgrade Trac==1.0
 }}}
-
-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]).
 
 You 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.
@@ -32 +30 @@
  * on MacOSX: `/Library/Python/2.X/site-packages`
 
-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.
+You 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.
 
 === 3. Upgrade the Trac Environment #UpgradetheTracEnvironment
@@ -78 +76 @@
 
 ===== Python 2.5 no longer supported
-Upgrade Python to at least 2.6, but not 3.0.
+Upgrade Python to at least 2.6 or 2.7, but not 3.0 or greater.
 
 ===== Obsolete Plugins