Changes between Version 1 and Version 2 of TracUpgrade

Timestamp:

06/03/10 15:59:45 (14 years ago)

Author:

zeiss

Comment:

Importing pages from "/var/lib/svn/trac/etsicheck2" using ​WikiImport plugin.

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 should also stop any running Trac server before the installation. Doing "hot" upgrades is not advised, especially not on Windows ([trac:ticket:7625 #7265]).
+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.
 
-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/Python/2.X/site-packages
+ * If you’re using MacOSX: /Library/Python2.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.
@@ -53 +50 @@
 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 [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.
+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.
 
 === Restart the Web Server ===
@@ -91 +76 @@
 == Older Versions ==
 
-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)
+For upgrades from former versions refer to wiki:0.10/TracUpgrade.
 
 -----