Changes between Version 5 and Version 6 of TracInstall


Ignore:
Timestamp:
Jun 6, 2010 2:50:38 PM (10 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracInstall

    v5 v6  
    1 {{{
    2 #!div style="margin-top: .5em; padding: 0 1em; background-color: #ffd; border:1px outset #ddc;"
    3 
    4   '''NOTE: this page is for 0.12dev (trunk), the version currently in development. For installing previous Trac versions, please refer to [[0.11/TracInstall]]'''
    5 }}}
    6 = Trac Installation Guide for 0.12dev =
     1= Trac Installation Guide for 0.12 =
    72[[TracGuideToc]]
    83
     
    9590 * an [http://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web
    9691   server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp])
    97  * A CGI-capable web server (see TracCgi), '''but usage of Trac as a cgi script
    98    is highly discouraged''', better use one of the following options,
     92 * a CGI-capable web server (see TracCgi), '''but usage of Trac as a cgi script
     93   is highly discouraged''', better use one of the previous options.
    9994   
    10095
     
    126121A few examples:
    127122
    128  - install Trac 0.12 beta1::
     123 - install Trac 0.12 rc1::
    129124   {{{
    130    easy_install Trac==0.12b1
     125   easy_install Trac==0.12rc1
    131126   }}}
    132127
     
    138133   either use a released version or install from source
    139134
     135=== Using `pip`
     136'pip' is an easy_install replacement that is very useful to quickly install python packages.
     137To get a trac installation up and running in less than 5 minutes:
     138
     139Assuming you want to have your entire pip installation in /opt/user/trac
     140
     141 -
     142{{{
     143pip -E /opt/user/trac install trac psycopg2
     144}}}
     145or
     146 -
     147{{{
     148pip -E /opt/user/trac install trac mysql-python
     149}}}
     150
     151Make sure your OS specific headers are available for pip to automatically build PostgreSQL (libpq-dev) or MySQL (libmysqlclient-dev) bindings.
     152
     153pip will automatically resolve all dependencies (like Genshi, pygments, etc.) and download the latest packages on pypi.python.org and create a self contained installation in /opt/user/trac
     154
     155All commands (tracd, trac-admin) are available in /opt/user/trac/bin . This can also be leveraged for mod_python (using PythonHandler directive) and mod_wsgi (using WSGIDaemonProcess directive)
     156
     157Additionally, you can install several trac plugins (listed [http://pypi.python.org/pypi?:action=search&term=trac&submit=search here]) through pip.
     158
     159
     160
    140161=== From source
    141162Of course, using the python-typical setup at the top of the source directory also works.
    142163
    143 You can obtain the source for a .tar.gz or .zip file corresponding to a release (e.g. Trac-0.12b1.tar.gz), or you can get the source directly from the repository (see Trac:SubversionRepository for details).
     164You can obtain the source for a .tar.gz or .zip file corresponding to a release (e.g. Trac-0.12rc1.tar.gz), or you can get the source directly from the repository (see Trac:SubversionRepository for details).
    144165
    145166{{{
     
    154175The script will also install the [wiki:TracAdmin trac-admin] command-line tool, used to create and maintain [wiki:TracEnvironment project environments], as well as the [wiki:TracStandalone tracd] standalone server.
    155176
    156 If you install from source and want to make Trac available in other languages, make sure you have installed Babel and then run this additional step before doing the `install` (or simply redo the `install` afterwards):
    157 {{{
    158 $ python ./setup.py compile_catalog -f
    159 }}}
    160 (the `-f` flag is needed as long as some translations are marked ''fuzzy'', i.e. incomplete, which will most probably be the case during the whole development period, as  strings are continuously added or modified)
    161 
     177If you install from source and want to make Trac available in other languages, make sure  Babel is installed. Only then, perform the `install` (or simply redo the `install` once again afterwards if you realize Babel was not yet installed):
     178{{{
     179$ python ./setup.py install
     180}}}
     181Alternatively, you can do a `bdist_egg` and copy the .egg from dist/ to the place of your choice, or you can create a Windows installer (`bdist_wininst`).
    162182
    163183=== Advanced Options ===