Edgewall Software

Changes between Version 26 and Version 27 of 0.12/TracInstall


Ignore:
Timestamp:
Sep 5, 2014, 1:45:55 AM (6 years ago)
Author:
Ryan J Ollos
Comment:

Backported the warning about Setuptools versions from the 1.0 documentation.

Legend:

Unmodified
Added
Removed
Modified
  • 0.12/TracInstall

    v26 v27  
    160160For upgrades, reading the TracUpgrade page is mandatory, of course.
    161161
     162{{{#!div style="border: 1pt dotted; margin: 1em"
     163**Setuptools Warning:** 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].
     164}}}
     165
    162166=== From source
    163167If you want more control, you can download the source in archive form, or do a checkout from one of the official [[Trac:TracRepositories|source code repositories]].
     
    272276{{{
    273277$ tracd -s --port 8000 /path/to/myproject
     278}}}
     279
     280{{{#!div style="border: 1pt dotted; margin: 1em"
     281**Setuptools Warning:** 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 for just the user that runs the `tracd` process. There are several ways to accomplish this in addition to what is discussed here, and depending on the distribution of your OS.
     282
     283To be effective system-wide a shell script with the `export` statement may be added to `/etc/profile.d`. To be effective for a user session the `export` statement may be added to `~/.profile`.
     284{{{#!sh
     285export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
     286}}}
     287
     288Alternatively, the variable can be set in the shell before executing `tracd`:
     289{{{#!sh
     290$ PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1 tracd --port 8000 /path/to/myproject
     291}}}
    274292}}}
    275293