Changes between Version 58 and Version 59 of TracUpgrade

Timestamp:

Oct 28, 2008, 12:15:07 PM (15 years ago)

Author:

Christian Boos

Comment:

The problem is not really removing the old versions (that shouldn't really matter), but rather to have a clean upgrade by stopping any server process that might prevent the files in use to be modified.

TracUpgrade

@@ -14 +14 @@
 Get the new version as described in TracInstall, or your operating system specific procedure.
 
-If you do a manual (not operating system specific) upgrade, you may also later on want to remove the existing Trac code by deleting the `trac` directory from the Python `lib/site-packages` directory. If you installed with an egg, make sure to remove all previous versions (#7625).
+If you do a manual (not operating system specific) upgrade, you should also stop any running Trac server before the installation. Doing "hot" upgrades is not advised, especially not on Windows ([Trac:ticket:7625 #7265]).
 
- ''The'' 'may' ''part here is a little disconcerting.  When should the old code be deleted and when shouldn't it?  Should it be deleted before or after installing the new version?  Is it different for minor upgrades?''
-
+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 .eggs from former versions.
 The location of the site-packages directory depends on the operating system, and the location in which Python was installed. However, the following locations are common:
  * If you’re using Linux: /usr/lib/python2.X/site-packages
@@ -24 +23 @@
 
 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 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.
 
 If you had the webadmin plugin installed, you can now uninstall it as it is now part of the Trac code base.