Changes between Version 1 and Version 2 of TracInstall


Ignore:
Timestamp:
10/22/08 03:31:28 (11 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracInstall

    v1 v2  
    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