Changes between Version 2 and Version 3 of TracInstall


Ignore:
Timestamp:
Dec 12, 2010, 12:08:15 PM (9 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracInstall

    v2 v3  
    11= Trac Installation Guide for 0.11 =
    22[[TracGuideToc]]
    3 
    4   '''NOTE: this page is now for 0.11, which will be released soon. For installing previous Trac versions, please refer to wiki:0.10/TracInstall.'''
    53
    64Trac is written in the Python programming language and needs a database, [http://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], or [http://mysql.com/ MySQL]. For HTML rendering, Trac uses the [http://genshi.edgewall.org Genshi] templating system.
     
    119For the quick install, make sure you have [http://python.org Python-2.5], [http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install easy_install] and SQlite-3.3.4 installed (or above).
    1210{{{
    13 sudo easy_install Pygments
    14 sudo easy_install Genshi
    15 sudo easy_install Trac
     11sudo easy_install Trac==0.11
    1612}}}
    1713
     
    2521   * See instructions in ["TracOnWindows/Python2.5"]
    2622 * [http://peak.telecommunity.com/DevCenter/setuptools setuptools], version >= 0.6
    27  * [http://genshi.edgewall.org/wiki/Download Genshi], version >= 0.3.6
     23 * [http://genshi.edgewall.org/wiki/Download Genshi], version >= 0.4.1
    2824 * You also need a database system and the corresponding python drivers for it.
    2925   The database can be either SQLite, PostgreSQL or ''MySQL (experimental)''.
     
    4440 * [http://initd.org/projects/psycopg2 psycopg2] or [http://pypgsql.sourceforge.net/ pyPgSQL]
    4541
     42'''Warning''': PostgreSQL 8.3 uses a strict type checking mechanism. To use Trac with the 8.3 Version of PostgreSQL, you will need [http://trac.edgewall.org/changeset/6512 trac-0.11] or later.
     43
    4644=== For MySQL ===
    4745
    48 '''Warning''': MySQL support is currently ''still'' experimental. That means it works for some people, but several issues remain, in particular regarding the use of unicode and the key length in the repository cache. See MySqlDb for more detailed informations.
     46'''Warning''': MySQL support is currently ''still'' experimental. That means it works for some people, but several issues remain, in particular regarding the use of unicode and the key length in the repository cache. See MySqlDb for more detailed information.
    4947
    5048 * [http://mysql.com/ MySQL], version 4.1 or later
     
    6664 * A CGI-capable web server (see TracCgi), or
    6765 * a [http://www.fastcgi.com/ FastCGI]-capable web server (see TracFastCgi), or
     66 * [http://httpd.apache.org/ Apache] with [http://code.google.com/p/modwsgi/ mod_wsgi] (see [wiki:TracModWSGI])
     67    * This should work with Apache 1.3, 2.0 or 2.2 and promises to deliver more performance than using mod_python. A little less mature than mod_python.
    6868 * [http://httpd.apache.org/ Apache] with [http://www.modpython.org/ mod_python 3.1.3+] (see TracModPython)
    6969    * When installing mod_python the development versions of Python and Apache are required (actually the libraries and header files)
    70  * [http://httpd.apache.org/ Apache] with [http://code.google.com/p/modwsgi/ mod_wsgi] (see [wiki:TracModWSGI])
    71     * While mod_wsgi is very new and somewhat experimental, this should work with Apache 1.3, 2.0 or 2.2 and promises to deliver more performance than using mod_python.
    7270
    7371For those stuck with Apache 1.3, it is also possible to get Trac working with [http://www.modpython.org/ mod_python 2.7] (see [wiki:TracModPython2.7 TracModPython2.7]). This guide hasn't been updated since 0.84, so it may or may not work.
     
    8785One way to install Trac is using `setuptools`.
    8886With setuptools you can install Trac from the subversion repository; for example,
    89 to install release version 0.11 do:
     87to install release version 0.11b2 do:
    9088{{{
    91 easy_install http://svn.edgewall.com/repos/trac/tags/trac-0.11
     89easy_install http://svn.edgewall.org/repos/trac/tags/trac-0.11b2
    9290}}}
    9391
     
    9997''Note: you'll need root permissions or equivalent for this step.''
    10098
    101 This will byte-compile the python source code and install it in the `site-packages` directory
    102 of your Python installation. The directories `cgi-bin`, `templates`, `htdocs`, `wiki-default` and `wiki-macros` are all copied to `$prefix/share/trac/`. `conf` and `plugins` stub directories are also created under `$prefix/share/trac/`.
    103 On Linux, the default value of `$prefix` is `/usr`, so the installation will be to `/usr/share/trac`, whereas the BSDs use `/usr/local`. Other Unix or Unix-like systems might use a similar prefix or something like `/opt`, please see your system's documentation for details.
     99This will byte-compile the python source code and install it as an .egg file or folder in the `site-packages` directory
     100of your Python installation. The .egg will also contain all other resources needed by standard Trac, such as htdocs and templates.
    104101
    105102The 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.
     
    118115easy_install --prefix=/path/to/installdir
    119116}}}
     117or, if installing Trac to a Mac OS X system:
     118{{{
     119easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages
     120}}}
     121
     122The above will place your `tracd` and `trac-admin` commands into `/usr/local/bin` and will install the Trac libraries and dependencies into `/Library/Python/2.5/site-packages`, which is Apple's preferred location for third-party Python application installations.
    120123
    121124== Creating a Project Environment ==
     
    144147}}}
    145148
    146 Then, fire up a browser and visit `http://localhost:8000/`. You should get a simple listing of all environments that tracd knows about. Follow the link to the environment you just created, and you should see Trac in action.
     149Then, fire up a browser and visit `http://localhost:8000/`. You should get a simple listing of all environments that tracd knows about. Follow the link to the environment you just created, and you should see Trac in action. If you only plan on managing a single project with trac you can have the standalone server skip the environment list by starting it like this:
     150{{{
     151$ tracd -s --port 8000 /path/to/myproject
     152}}}
    147153
    148154
    149155== Running Trac on a Web Server ==
    150156
    151 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.
     157Trac 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.
    152158
    153159If 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.
     
    160166 * TracCgi if you use the CGI or FastCGI methods.
    161167 * TracModPython if you use the mod_python method.
     168
     169== Trac 0.11 & SVN on Mac OS X Leopard (10.5) ==
     170
     171 * TracOnLeopardServer
    162172
    163173== Using Trac ==
     
    173183----
    174184See also:  TracGuide, TracCgi, TracFastCgi, TracModPython, [wiki:TracModWSGI], TracUpgrade, TracPermissions
     185