Changes between Version 5 and Version 6 of TracInstall


Ignore:
Timestamp:
Jan 7, 2023, 1:40:18 PM (16 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracInstall

    v5 v6  
    1 = Trac Installation Guide for 1.4
     1= Trac Installation Guide for 1.5
    22[[TracGuideToc]]
    33
    … …  
    1616To install Trac, the following software packages must be installed:
    1717
    18  * [https://www.python.org/ Python], version >= 2.7 and < 3.0
    19    (note that we dropped the support for Python 2.6 in this release)
    20  * [https://pypi.org/project/setuptools setuptools], version >= 0.6
     18 * [https://www.python.org/ Python], version >= 3.5
     19 * [https://pypi.org/project/setuptools setuptools], version > 5.6
    2120 * [https://pypi.org/project/Jinja2 Jinja2], version >= 2.9.3
    22 
    23 {{{#!div style="border: 1pt dotted; margin: 1em"
    24 **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].
    25 }}}
    2621
    2722You also need a database system and the corresponding python bindings. The database can be either SQLite, PostgreSQL or MySQL.
    … …  
    3732You need to install the database and its Python bindings:
    3833 * [https://www.postgresql.org/ PostgreSQL], version 9.1 or later
    39  * [https://pypi.org/project/psycopg2 psycopg2], version 2.0 or later
     34 * [https://pypi.org/project/psycopg2 psycopg2], version 2.5 or later
    4035
    4136See [trac:DatabaseBackend#Postgresql DatabaseBackend] for details.
    … …  
    5449==== Subversion
    5550
    56 [https://subversion.apache.org/ Subversion], 1.6.x or later and the '''''corresponding''''' Python bindings.
     51[https://subversion.apache.org/ Subversion], 1.14.x or later and the '''''corresponding''''' Python bindings.
    5752
    5853There are [https://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. See [trac:TracSubversion#GettingSubversion getting Subversion] for more information.
    … …  
    9287==== Other Python Packages
    9388
    94  * [http://babel.pocoo.org Babel], version 0.9.6 or >= 1.3,
     89 * [http://babel.pocoo.org Babel], version >= 2.2,
    9590   needed for localization support
    9691 * [http://pytz.sourceforge.net pytz] to get a complete list of time zones,
    … …  
    9893   an internal time zone implementation. Installing Babel
    9994   will install pytz.
    100  * [http://docutils.sourceforge.net docutils], version >= 0.3.9
    101    for WikiRestructuredText.
    102  * [http://pygments.org Pygments] for
    103    [TracSyntaxColoring syntax highlighting].
    104  * [https://pypi.org/project/textile Textile] for rendering the [https://github.com/textile/python-textile Textile markup language].
     95 * [http://docutils.sourceforge.net docutils],
     96   version >= 0.14, for WikiRestructuredText.
     97 * [http://pygments.org Pygments], version >= 1.0,
     98   for [TracSyntaxColoring syntax highlighting].
     99 * [https://pypi.org/project/textile Textile],
     100   version >= 2.3,
     101   for rendering the [https://github.com/textile/python-textile Textile markup language].
    105102 * [https://pypi.org/project/passlib passlib] on Windows to decode [TracStandalone#BasicAuthorization:Usingahtpasswdpasswordfile htpasswd formats] other than `SHA-1`.
    106103 * [https://pypi.org/project/pyreadline pyreadline] on Windows for trac-admin [TracAdmin#InteractiveMode command completion].
    … …  
    119116
    120117=== Using `pip`
    121 `pip` is the modern Python package manager and is included in Python 2.7.9 and later. Use [https://bootstrap.pypa.io/get-pip.py get-pip.py] to install `pip` for an earlier version of Python.
    122 
    123 {{{#!sh
    124 $ pip install Trac
    125 }}}
    126 
    127 `pip` will automatically resolve the //required// dependencies (Jinja2 and setuptools) and download the latest packages from pypi.org.
     118`pip` is the modern Python package manager and is included in Python distributions. `pip` will automatically
     119resolve the //required// dependencies (Jinja2 and
     120setuptools) and download the latest packages from pypi.org.
    128121
    129122You can also install directly from a source package. You can obtain the source in a tar or zip from the [trac:TracDownload] page. After extracting the archive, change to the directory containing `setup.py` and run:
    … …  
    143136$ pip install https://download.edgewall.org/trac/Trac-latest-dev.tar.gz
    144137}}}
    145 * Install the unreleased 1.2-stable from subversion:
     138* Install the unreleased 1.4-stable from subversion:
    146139{{{#!sh
    147140$ pip install svn+https://svn.edgewall.org/repos/trac/branches/1.2-stable
    … …  
    206199
    207200== Deploying Trac
    208 
    209 {{{#!div style="border: 1pt dotted; margin: 1em"
    210 **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.
    211 
    212 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.
    213 
    214 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`.
    215 {{{#!sh
    216 export PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1
    217 }}}
    218 
    219 Alternatively, the variable can be set in the shell before executing `tracd`:
    220 {{{#!sh
    221 $ PKG_RESOURCES_CACHE_ZIP_MANIFESTS=1 tracd --port 8000 /path/to/myproject
    222 }}}
    223 
    224 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`.
    225 }}}
    226201
    227202=== Running the Standalone Server