Edgewall Software

Changes between Version 424 and Version 425 of TracInstall


Ignore:
Timestamp:
Sep 23, 2015, 10:44:15 PM (9 years ago)
Author:
Ryan J Ollos
Comment:

Reword section on PKG_RESOURCES_CACHE_ZIP_MANIFESTS.

Legend:

Unmodified
Added
Removed
Modified
  • TracInstall

    v424 v425  
    135135
    136136{{{#!div style="border: 1pt dotted; margin: 1em"
    137 **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].
     137**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 [#DeployingTrac Deploying Trac].
    138138}}}
    139139
     
    249249== Deploying Trac
    250250
     251{{{#!div style="border: 1pt dotted; margin: 1em"
     252**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.
     253
     254If running `tracd`, 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.
     255
     256To 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`.
     257{{{#!sh
     258export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
     259}}}
     260
     261Alternatively, the variable can be set in the shell before executing `tracd`:
     262{{{#!sh
     263$ PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1 tracd --port 8000 /path/to/myproject
     264}}}
     265
     266If running the Apache web server, !Ubuntu/Debian users should add the `export` statement to `/etc/apache2/envvars`. !RedHat/CentOS/Fedora should can add the `export` statement to `/etc/sysconfig/httpd`.
     267}}}
     268
    251269=== Running the Standalone Server
    252270
     
    259277{{{#!sh
    260278$ tracd -s --port 8000 /path/to/myproject
    261 }}}
    262 
    263 {{{#!div style="border: 1pt dotted; margin: 1em"
    264 **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.
    265 
    266 To be effective system-wide a shell script with the `export` statement may be added to `/etc/profile.d`.  !Ubuntu/Debian users can add the `export` statement to `/etc/apache2/envvars`. !RedHat/CentOS/Fedora users can add the `export` statement to `/etc/sysconfig/httpd`. To be effective for a user session the `export` statement may be added to `~/.profile`.
    267 {{{#!sh
    268 export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
    269 }}}
    270 
    271 Alternatively, the variable can be set in the shell before executing `tracd`:
    272 {{{#!sh
    273 $ PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1 tracd --port 8000 /path/to/myproject
    274 }}}
    275279}}}
    276280