Edgewall Software

Changes between Version 1 and Version 2 of 0.10/TracInstall


Ignore:
Timestamp:
Dec 6, 2007, 3:22:22 PM (16 years ago)
Author:
Christian Boos
Comment:

Updated from TracInstall@216 (last 0.10 version)

Legend:

Unmodified
Added
Removed
Modified
  • 0.10/TracInstall

    v1 v2  
    22[[TracGuideToc]]
    33
    4 Trac is a lightweight project management tool that is implemented as a web-based application. Trac is written in the Python programming language and needs a database (either [http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], or [http://mysql.com/ MySQL] works). For HTML rendering, Trac uses the [http://www.clearsilver.net/ ClearSilver] templating system.
     4Trac is a lightweight project management tool that is implemented as a web-based application. Trac is  written in the Python programming language and needs a database (either [http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], or [http://mysql.com/ MySQL] works). For HTML rendering, Trac uses the [http://www.clearsilver.net/ ClearSilver] templating system.
    55
    66What follows are generic instructions for installing and setting up Trac and its requirements. While you can find instructions for installing Trac on specific systems at TracInstallPlatforms on the main Trac site, please be sure to '''first read through these general instructions''' to get a good understanding of the tasks involved.
     
    1616     ClearSilver up to 10.3 and Python 2.5 don't seem to get along, so you'll probably have more luck with Python 2.4.  Note about it in [http://www.mail-archive.com/trac-dev@googlegroups.com/msg00034.html this mail exchange].
    1717     ''To follow-up on that thread, with Trac 0.11dev (i.e. current trunk since r3832), Clearsilver is no longer needed. Yay. See instructions in ["TracOnWindows/Python2.5"] [[br]]  -- ChristianBoos''
    18    * You can fix the problem with Python 2.5 (x_64) relativley simple, cause Clearsilver installed neo_cgi.so in the path /usr/lib/python2.5/site-packages instead of /usr/lib64/python2.5/site-packages. To solve the Problem i have just made a link in /usr/lib64/python2.5/site-packages with ''ln -s /usr/lib/python2.5/site-packages/neo_cgi.so neo_cgi.so'' to get it to run, just move the file to the correct location should solve it too.[[br]] -- !KarlHeinzMarbaise
     18   * You can fix the problem with Python 2.5 (x_64) relatively easily because Clearsilver installed neo_cgi.so in the path /usr/lib/python2.5/site-packages instead of /usr/lib64/python2.5/site-packages. To solve the problem, make a link in /usr/lib64/python2.5/site-packages with ''ln -s /usr/lib/python2.5/site-packages/neo_cgi.so neo_cgi.so'' or just move the file to the correct location.[[br]] -- !KarlHeinzMarbaise
     19  * For '''OS X 10.5''' ('''Leopard''') make a link:[[br]]
     20    ''sudo ln -s /urs/lib/python2.5/site-packages/neo-cgi.so /Library/Python/2.5/site-packages''[[br]]
     21    after you install clearsilver.[[br]] -- Samvel
    1922 * You also need a database system and the corresponding python drivers for it.
    2023   The database can be either SQLite, PostgreSQL or ''MySQL (experimental)''.
     
    3942
    4043 * [http://www.postgresql.org/ PostgreSQL]
    41  * [http://initd.org/projects/psycopg2 psycopg2] or [http://pypgsql.sourceforge.net/ pyPgSQL]
     44 * [http://initd.org/projects/psycopg2 psycopg2] (preferred) or [http://pypgsql.sourceforge.net/ pyPgSQL] (but see #5096)
    4245
    4346''Note: PostgreSQL support requires Trac version 0.9 or later.''
     
    8184 * [http://silvercity.sourceforge.net/ SilverCity] and/or [http://www.gnu.org/software/enscript/enscript.html Enscript] for [wiki:TracSyntaxColoring syntax highlighting].
    8285    * Note that !SilverCity 0.9.6 has a [http://sourceforge.net/tracker/index.php?func=detail&aid=1424436&group_id=45693&atid=443739 bug] that breaks Python syntax highlighting in Trac. Until an update is made available, we recommend using version 0.9.5.
     86    * Note that !SilverCity 0.9.7 marks the bug listed above - Fixed!
    8387
    8488'''Attention''': The various available versions of these dependencies are not necessarily interchangable, so please pay attention to the version numbers above. If you are having trouble getting Trac to work please double-check all the dependencies before asking for help on the MailingList or IrcChannel.
     
    8892== Installing Trac ==
    8993
    90 Like most Python programs, the Trac Python package is installed by running the following command at the top of the source directory (you must issue this command from the source directory; the installation will not work properly is you run setup.py from a different directory) :
     94Like most Python programs, the Trac Python package is installed by running the following command at the top of the source directory (you must issue this command from the source directory; the installation will not work properly if you run setup.py from a different directory) :
    9195{{{
    9296$ python ./setup.py install
     
    143147== Running Trac on a Web Server ==
    144148
    145 Trac provides three options for connecting to a “real” web server: [wiki:TracCgi CGI], [wiki:TracFastCgi FastCGI] and [wiki:TracModPython mod_python]. For decent performance, it is recommended that you use either FastCGI or mod_python.
    146 
    147 If you're not afraid of running development code, you can also try running Trac on [wiki:TracModWSGI mod_wsgi]. This should deliver even better performance than mod_python, but the module is not considered stable just yet.
     149Trac provides four options for connecting to a “real” web server: [wiki:TracCgi CGI], [wiki:TracFastCgi FastCGI], [wiki:TracModWSGI mod_wsgi] and [wiki:TracModPython mod_python]. For decent performance, it is recommended that you use either mod_wsgi, FastCGI or mod_python.
    148150
    149151== Configuring Authentication ==
     
    153155 * TracStandalone if you use the standalone server, `tracd`.
    154156 * TracCgi if you use the CGI or FastCGI methods.
     157 * [wiki:TracModWSGI TracModWSGI] if you use the mod_wsgi method.
    155158 * TracModPython if you use the mod_python method.
    156159