Edgewall Software

Changes between Version 1 and Version 2 of 1.5/TracInstall


Ignore:
Timestamp:
Jun 3, 2020, 8:57:36 AM (2 months ago)
Author:
Ryan J Ollos
Comment:

Require setuptools > 5.6. Refs #13310.

Legend:

Unmodified
Added
Removed
Modified
  • 1.5/TracInstall

    v1 v2  
    1919 * [https://www.python.org/ Python], version >= 2.7 and < 3.0
    2020   (note that we dropped the support for Python 2.6 in this release)
    21  * [https://pypi.org/project/setuptools setuptools], version >= 0.6
     21 * [https://pypi.org/project/setuptools setuptools], version > 5.6
    2222 * [https://pypi.org/project/Jinja2 Jinja2], version >= 2.9.3
    23 
    24 {{{#!div style="border: 1pt dotted; margin: 1em"
    25 **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].
    26 }}}
    2723
    2824You also need a database system and the corresponding python bindings. The database can be either SQLite, PostgreSQL or MySQL.
     
    208204== Deploying Trac
    209205
    210 {{{#!div style="border: 1pt dotted; margin: 1em"
    211 **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.
    212 
    213 If 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.
    214 
    215 To 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`.
    216 {{{#!sh
    217 export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
    218 }}}
    219 
    220 Alternatively, the variable can be set in the shell before executing `tracd`:
    221 {{{#!sh
    222 $ PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1 tracd --port 8000 /path/to/myproject
    223 }}}
    224 
    225 If 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`.
    226 }}}
    227 
    228206=== Running the Standalone Server
    229207