Version 17 (modified by 15 years ago) ( diff ) | ,
---|
Advanced options for Installing Trac on Windows
Optional Packages
In addition to the base packages listed in TracOnWindows, here are a few additional packages (Python or external tools) that can be used to improve the functionality offered on your Trac installation:
Docutils | docutils-0.4.tar.gz |
In case you don't want to use Pygments, those are the other previously supported syntax highlighters:
SilverCity | SilverCity-0.9.7.win32-py2.4.exe (or the Python 2.3 version) |
Enscript on Windows | gnuwin32 Enscript 1.6.3 |
(but really, why wouldn't you use Pygments?)
Using Other Databases
PostgreSQL for Windows
Trac can work equally well with two different Python bindings for the PostgreSQL (8.1.4) database:
PsycoPg2 | psycopg2.0.X - (2.5, 2.4, 2.3) more... |
pyPgSQL | pyPgSQL-2.5.1.win32-py2.4.exe (or the Python 2.3 version) more... |
- Create your database with UTF8 Encoding or you could get errors; see TracEnvironment for more.
mySQLDb for Windows
The recommended package for the MySqlDb Python bindings for the MySQL database is:
MySQL for Python | MySQL-python-1.2.2.win32-py2.X - (2.5, 2.4) |
Please note that working with MySQL is not recommended in general, as there are still a lot of rough edges. However, on Windows the main issues we have with MySQL tend to be less apparent: the default setup for recent installations is UTF8, Windows users are unlikely to have case-sensitivity pathname issues in their repositories (as Subversion won't let them create such paths in the first place), etc. So MySQL on Windows might well be a more viable solution than on Unix, for the time being (and seems to work fine for me). See the MySqlDb page for more details.
Using Other Web front-end
TracStandalone is not the only option on Windows.
Apache and mod_python
FIXME 3.3.1 is the recommended version
First you need to install the mod_python
package.
Pick the version that is appropriate for your version of Python and your version of Apache.
- mod_python-3.2.10.win32-py2.3-apache2.0.exe
- mod_python-3.2.10.win32-py2.4-apache2.0.exe
- mod_python-3.2.10.win32-py2.4-apache2.2.exe
Or, for a newer version of the module, you may try:
- mod_python-3.3.1.win32-py2.4-Apache2.0.exe
- mod_python-3.3.1.win32-py2.4-Apache2.2.exe
- mod_python-3.3.1.win32-py2.5-Apache2.0.exe
- mod_python-3.3.1.win32-py2.5-Apache2.2.exe
TODO check the compatibility between Apache 2.0/2.2 and the Subversion bindings. The latter are using libapr and libaprutil 0.9.12.
Then, check the regular TracModPython instructions to see how you have to modify your http.conf.
Apache and mod_wsgi
FIXME package?
First, you need to integrate mod_wsgi in your Apache installation. You can find and download pre-compiled binaries for Windows here. Choose the right one depending on the version of Apache and Python you're running. Then follow the installation instructions for this module, and eventually the TracModWSGI installations instructions. The resulting configuration (from the words of mod_wsgi
authors) is supposed to be more efficient than one using mod_python
.
Internet Information Services (IIS)
It is also possible to install Trac with IIS 6, though your mileage may vary.
By following the above, Trac will be installed as a CGI, so that will be quite slow. You might be better off following TracOnWindowsIisAjp, which looks more promising.
Authenticating Trac users against MS Windows domain controller
Running Trac in Apache, you can let your users login with their existing Windows username/password by using mod_sspi
. (If you use Subversion as a repository and access it through Apache, you can also do the same with Subversion). Download this module here, place it in the Apache modules directory, and add the following line to your httpd.conf
, with all the LoadModule
instructions:
LoadModule sspi_auth_module modules/mod_auth_sspi.so
Then add the following to the end of http.conf
, modified according to your settings:
<LocationMatch /MyTracRootURL/[^/]+/login> AuthType SSPI AuthName "Trac project management website @ MyLocalMachine" SSPIAuth On SSPIAuthoritative On SSPIDomain MyLocalDomain SSPIOfferBasic On Require valid-user </LocationMatch>
Then, if you change permissions in Trac using trac-admin.exe
, remember to declare the user bob
as MyLocalDomain\bob
(The same remark applies for your Subversion repository accessfile). Alternatively add the parameter SSPIOmitDomain On
and declare the user as bob
.
Note: If you are having problems with IE not being able to submit data to Trac (i.e. when you edit a wiki page or submit a ticket Trac doesn't modify the page or add the bug). wiki:Trac0.9/TracOnWindows has more information on this issue.