Changes between Version 373 and Version 374 of TracInstall

Timestamp:

Aug 24, 2014, 1:04:29 AM (10 years ago)

Author:

Ryan J Ollos

Comment:

Added warnings for setuptool 5.4 through 5.6. Refs #11694.

TracInstall

@@ -92 +92 @@
 
 ==== Web Server ====
-A web server is optional because Trac is shipped with a server included, see the [#RunningtheStandaloneServer Running the Standalone Server ] section below.
+A web server is optional because Trac is shipped with a server included, see the [#RunningtheStandaloneServer Running the Standalone Server] section below.
 
 Alternatively you can configure Trac to run in any of the following environments.
@@ -144 +144 @@
    either use a released version or install from source 
 
+**Note:** If the version of your setuptools is in the range 5.4 through 5.6, the environment variable `PKG_RESOURCES_CACHE_ZIP_MANIFESTS` must be set in order to avoid significant performance degradation. More information may be found in the sections on [#RunningtheStandaloneServer Running The Standalone Server] and [#RunningTraconaWebServer Running Trac on a Web Server]. 
+
 === Using `pip`
 'pip' is an easy_install replacement that is very useful to quickly install python packages.
@@ -259 +261 @@
 $ tracd -s --port 8000 /path/to/myproject
 }}}
+
+**Note:** If the version of your setuptools is in the range 5.4 through 5.6, the environment variable PKG_RESOURCES_CACHE_ZIP_MANIFESTS must be set in order to avoid significant performance degradation. The environment variable can be set system-wide, or just for the user that runs the `tracd` process. There are several ways to accomplish this. For system-wide settings a shell script with the `export` statement may be added to `/etc/profile.d`, or the `export` statement may be added to `~/.profile` to make it effective for a user session.
+{{{
+export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
+}}}
+
+Alternatively, the variable can be set in the shell before executing `tracd`:
+{{{
+$ PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1 tracd --port 8000 /path/to/myproject
+}}}
+
 
 === Running Trac on a Web Server ===