Changes between Version 1 and Version 2 of TracUpgrade

Timestamp:

Dec 7, 2010, 10:14:18 PM (14 years ago)

Author:

trac

Comment:

--

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 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]).
 
+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
  * If you’re using Windows: C:\Python2.X\lib\site-packages
- * If you’re using MacOSX: /Library/Python2.X/site-packages
+ * If you’re using 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 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.
@@ -50 +53 @@
 Note that this procedure will of course leave your `WikiStart` page intact.
 
+=== Site Templates ===
+The templating engine has changed in 0.11, please look at TracInterfaceCustomization for more information.
+
 === Trac Macros, Plugins ===
-The Trac macros will need to be adapted, as the old-style wiki-macros are not supported anymore (due to the drop of ClearSilver and the HDF); they need to be converted to the new-style macros, see WikiMacros. When they are converted to the new style, they need to be placed into the plugins directory instead and not wiki-macros, which is no longer scanned for macros or plugins.
+The Trac macros will need to be adapted, as the old-style wiki-macros are not supported anymore (due to the drop of [trac:ClearSilver ClearSilver] and the HDF); they need to be converted to the new-style macros, see WikiMacros. When they are converted to the new style, they need to be placed into the plugins directory instead and not wiki-macros, which is no longer scanned for macros or plugins.
+
+=== For CGI users ===
+
+For those who run Trac under the CGI environment, run this command in order to obtain the trac.cgi file:
+{{{
+trac-admin /path/to/env deploy /deploy/directory/path
+}}}
+
+This 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.
 
 === Restart the Web Server ===
@@ -76 +91 @@
 == Older Versions ==
 
-For upgrades from former versions refer to wiki:0.10/TracUpgrade.
+For upgrades from versions older than Trac 0.10, refer first to trac:wiki:0.10/TracUpgrade.
+
+Note 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.
+{{{
+$ sqlite3 db/trac.db "update system set value=20 where name='database_version'"
+}}}
+(upgrade can be redone the normal way later on)
 
 -----