Changes between Version 6 and Version 7 of TracInstall


Ignore:
Timestamp:
Feb 21, 2016, 9:52:37 PM (3 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracInstall

    v6 v7  
    3030As you must be using Python 2.5, 2.6 or 2.7, you already have the SQLite database bindings bundled with the standard distribution of Python: the `sqlite3` module.
    3131
    32 Optionally, you may install a newer version of [pypi:pysqlite pysqlite] than the one provided by the Python distribution. See [trac:PySqlite#ThePysqlite2bindings PySqlite] for details.
     32Optionally, you may install a newer version of [http://pypi.python.org/pypi/pysqlite pysqlite] than the one provided by the Python distribution. See [trac:PySqlite#ThePysqlite2bindings PySqlite] for details.
    3333
    3434==== For the PostgreSQL database #ForPostgreSQL
     
    112112The [TracAdmin trac-admin] command-line tool, used to create and maintain [TracEnvironment project environments], as well as the [TracStandalone tracd] standalone server are installed along with Trac. There are several methods for installing Trac.
    113113
     114It is assumed throughout this guide that you have elevated permissions as the `root` user, or by prefixing commands with `sudo`. The umask `0022` should be used for a typical installation on a Unix-based platform.
     115
    114116=== Using `easy_install`
    115117
    116 Trac can be installed from [https://pypi.python.org/pypi/Trac PyPI] or the Subversion repository using [pypi:setuptools setuptools].
     118Trac can be installed from [https://pypi.python.org/pypi/Trac PyPI] or the Subversion repository using [http://pypi.python.org/pypi/setuptools setuptools].
    117119
    118120A few command-line examples:
     
    129131   either use a released version or install from source.
    130132
    131 More information can be found on the [trac:setuptools] page.
     133More information can be found on the [trac:wiki:setuptools setuptools] page.
    132134
    133135{{{#!div style="border: 1pt dotted; margin: 1em"
    134 **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].
     136**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].
    135137}}}
    136138
     
    246248== Deploying Trac
    247249
     250{{{#!div style="border: 1pt dotted; margin: 1em"
     251**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.
     252
     253If 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.
     254
     255To 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`.
     256{{{#!sh
     257export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
     258}}}
     259
     260Alternatively, the variable can be set in the shell before executing `tracd`:
     261{{{#!sh
     262$ PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1 tracd --port 8000 /path/to/myproject
     263}}}
     264
     265If 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`.
     266}}}
     267
    248268=== Running the Standalone Server
    249269
     
    256276{{{#!sh
    257277$ tracd -s --port 8000 /path/to/myproject
    258 }}}
    259 
    260 {{{#!div style="border: 1pt dotted; margin: 1em"
    261 **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.
    262 
    263 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`.
    264 {{{#!sh
    265 export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
    266 }}}
    267 
    268 Alternatively, the variable can be set in the shell before executing `tracd`:
    269 {{{#!sh
    270 $ PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1 tracd --port 8000 /path/to/myproject
    271 }}}
    272278}}}
    273279
     
    276282Trac provides various options for connecting to a "real" web server:
    277283 - [TracFastCgi FastCGI]
    278  - [wiki:TracModWSGI mod_wsgi]
    279  - [TracModPython mod_python]
     284 - [wiki:TracModWSGI Apache with mod_wsgi]
     285 - [TracModPython Apache with mod_python]
    280286 - //[TracCgi CGI]: should not be used, as it degrades performance//
    281287
     
    325331
    326332<Directory "/path/to/www/trac/htdocs">
    327   Order allow,deny
    328   Allow from all
     333  # For Apache 2.2
     334  <IfModule !mod_authz_core.c>
     335    Order allow,deny
     336    Allow from all
     337  </IfModule>
     338  # For Apache 2.4
     339  <IfModule mod_authz_core.c>
     340    Require all granted
     341  </IfModule>
    329342</Directory>
    330343}}}
     
    344357
    345358<Directory "/path/to/projectenv/htdocs">
    346   Order allow,deny
    347   Allow from all
     359  # For Apache 2.2
     360  <IfModule !mod_authz_core.c>
     361    Order allow,deny
     362    Allow from all
     363  </IfModule>
     364  # For Apache 2.4
     365  <IfModule mod_authz_core.c>
     366    Require all granted
     367  </IfModule>
    348368</Directory>
    349369}}}