Changes between Version 5 and Version 6 of TracInstall


Ignore:
Timestamp:
May 30, 2008 2:26:53 PM (8 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracInstall

    v5 v6  
    1111For 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).
    1212{{{
    13 sudo easy_install Pygments
    14 sudo easy_install Genshi
    15 sudo easy_install Trac
     13sudo easy_install Trac==0.11b2
    1614}}}
    1715
     
    2523   * See instructions in ["TracOnWindows/Python2.5"]
    2624 * [http://peak.telecommunity.com/DevCenter/setuptools setuptools], version >= 0.6
    27  * [http://genshi.edgewall.org/wiki/Download Genshi], version >= 0.3.6
     25 * [http://genshi.edgewall.org/wiki/Download Genshi], version >= 0.4.1
    2826 * You also need a database system and the corresponding python drivers for it.
    2927   The database can be either SQLite, PostgreSQL or ''MySQL (experimental)''.
     
    4442 * [http://initd.org/projects/psycopg2 psycopg2] or [http://pypgsql.sourceforge.net/ pyPgSQL]
    4543
     44'''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.
     45
    4646=== For MySQL ===
    4747
    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.
     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 information.
    4949
    5050 * [http://mysql.com/ MySQL], version 4.1 or later
     
    6666 * A CGI-capable web server (see TracCgi), or
    6767 * a [http://www.fastcgi.com/ FastCGI]-capable web server (see TracFastCgi), or
     68 * [http://httpd.apache.org/ Apache] with [http://code.google.com/p/modwsgi/ mod_wsgi] (see [wiki:TracModWSGI])
     69    * 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.
    6870 * [http://httpd.apache.org/ Apache] with [http://www.modpython.org/ mod_python 3.1.3+] (see TracModPython)
    6971    * 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.
    7272
    7373For 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.
     
    8787One way to install Trac is using `setuptools`.
    8888With setuptools you can install Trac from the subversion repository; for example,
    89 to install release version 0.11 do:
     89to install release version 0.11b2 do:
    9090{{{
    91 easy_install http://svn.edgewall.com/repos/trac/tags/trac-0.11
     91easy_install http://svn.edgewall.org/repos/trac/tags/trac-0.11b2
    9292}}}
    9393
     
    9999''Note: you'll need root permissions or equivalent for this step.''
    100100
    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.
     101This will byte-compile the python source code and install it as an .egg file or folder in the `site-packages` directory
     102of your Python installation. The .egg will also contain all other resources needed by standard Trac, such as htdocs and templates.
    104103
    105104The 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.
     
    118117easy_install --prefix=/path/to/installdir
    119118}}}
     119or, if installing Trac to a Mac OS X system:
     120{{{
     121easy_install --prefix=/usr/local --install-dir=/Library/Python/2.5/site-packages
     122}}}
     123
     124The 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.
    120125
    121126== Creating a Project Environment ==
     
    144149}}}
    145150
    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.
     151Then, 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:
     152{{{
     153$ tracd -s --port 8000 /path/to/myproject
     154}}}
    147155
    148156
    149157== Running Trac on a Web Server ==
    150158
    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.
     159Trac 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.
    152160
    153161If 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.
     
    160168 * TracCgi if you use the CGI or FastCGI methods.
    161169 * TracModPython if you use the mod_python method.
     170
     171== Trac 0.11 & SVN on Mac OS X Leopard (10.5) ==
     172
     173 * TracOnLeopardServer
    162174
    163175== Using Trac ==
     
    173185----
    174186See also:  TracGuide, TracCgi, TracFastCgi, TracModPython, [wiki:TracModWSGI], TracUpgrade, TracPermissions
     187