Edgewall Software

Changes between Version 25 and Version 26 of TracOnWindows/Advanced


Ignore:
Timestamp:
Jan 21, 2016, 11:45:22 AM (6 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • TracOnWindows/Advanced

    v25 v26  
    1 = Advanced options for Installing Trac on Windows =
     1[[PageOutline(2-5,Contents,pullout)]]
    22
    3 [[PageOutline(2-4,Overview,inline)]]
     3= Advanced options for Installing Trac on Windows
    44
    5 == Optional Packages ==
     5== Optional Packages
    66
    77In 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:
    88
    9 `easy_install`able packages:
     9Packages which can be installed using `easy_install`:
    1010 - docutils
    1111 - pygments
    1212 - pytz
    1313
    14 == Using Other Databases ==
     14== Using Other Databases
    1515
    16 === PostgreSQL for Windows ===
     16=== PostgreSQL for Windows
    1717
    1818Trac can work with the PostgreSQL (8.x or 9.x) database:
    19  - Install [http://stickpeople.com/projects/python/win-psycopg/ psycopg2]
     19 - Install [http://stickpeople.com/projects/python/win-psycopg/ psycopg2].
    2020 - Create your database with UTF8 Encoding or you could get errors; see TracEnvironment for more.
    2121
    22 === mySQLDb for Windows ===
     22=== mySQLDb for Windows
    2323
    24 The recommended package for the MySqlDb Python bindings for the MySQL database is:
     24Packages for the MySqlDb Python bindings for the MySQL database:
    2525
    26 || [http://mysql-python.sourceforge.net/ MySQL for Python] || [http://servut.us/akx/2010/09/mysqldb-windows-binaries-python-26-27/ non]-[http://www.codegood.com/archives/129 official] downloads ||
     26 * [http://mysql-python.sourceforge.net/ MySQL for Python] (Sourceforge)
     27 * [http://servut.us/akx/2010/09/mysqldb-windows-binaries-python-26-27/] (non-official download)
     28 * [http://www.codegood.com/archives/129] (non-official download)
    2729
    28 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.
     30Note that working with MySQL is ''not'' recommended in general, as there may still be unpredictable behaviour. However, on Windows the main issues with MySQL tend to be less apparent: the default setup for recent installations is UTF-8, and 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. 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.
    2931
    3032TODO: try out the [http://packages.python.org/oursql/ OurSQL] bindings.
    3133
    32 
    33 == Using Other Web front-end ==
     34== Using Other Web front-ends
    3435
    3536TracStandalone is not the only option on Windows.
     
    3738=== Apache
    3839
    39 Note that generic instructions for configuring authentication within Apache are available in the [[TracModWSGI#ConfiguringAuthentication]] page.
     40Generic instructions for configuring authentication within Apache are available in the [[TracModWSGI#ConfiguringAuthentication]] page.
    4041
    41 ==== Apache and `mod_wsgi` ====
     42==== Apache and `mod_wsgi`
    4243
    4344First, you need to integrate [http://code.google.com/p/modwsgi mod_wsgi] in your Apache installation. There are   [http://code.google.com/p/modwsgi/wiki/DownloadTheSoftware#Windows_Binary_Downloads pre-compiled binaries] available for download. Choose the right one depending on the version of Apache and Python you're running. Then follow the [http://code.google.com/p/modwsgi/wiki/InstallationOnWindows installation instructions] for this module, and the [[TracModWSGI]] installations instructions. The resulting configuration (from the words of the `mod_wsgi` author) is supposed to be more efficient than one using `mod_python`.
    4445
    45 Adjustments to the paths included in the `.wsgi` script must also be made. The Trac Environment must point to the same path as was specified with `Trac-admin path/to/env initenv`.
     46Adjustments to the paths included in the `.wsgi` script must also be made. The Trac environment must point to the same path as was specified with `Trac-admin path/to/env initenv`.
    4647
    4748The Python Egg cache directory on Windows:
    48  - If run under the user's session, the Python Egg cache can be found in `%AppData%\Roaming`, for example:
     49 - If run under the user's session, the Python egg cache can be found in `%AppData%\Roaming`, for example:
    4950{{{#!python
    5051os.environ['TRAC_ENV'] = r'C:\TracEnvironment'
    5152os.environ['PYTHON_EGG_CACHE'] = r'C:\Users\Administrator\AppData\Roaming\Python-Eggs'
    5253}}}
    53  - If run under a Window service, you should create a directory for Python Egg cache.
     54 - If run under a Window service, you should create a directory for Python egg cache:
    5455{{{#!python
    5556os.environ['TRAC_ENV'] = r'C:\TracEnvironment'
     
    5758}}}
    5859
    59 ==== Apache and `mod_python` ====
     60==== Apache and `mod_python`
    6061
    61 **Note: ** `mod_python` is no longer developed.
    62 
    63 You may try to use its last version, 3.3.1:
     62You may try to use an older version, namely 3.3.1:
    6463
    6564 - [http://www.apache.org/dist/httpd/modpython/win/3.3.1/mod_python-3.3.1.win32-py2.4-Apache2.0.exe mod_python-3.3.1.win32-py2.4-Apache2.0.exe]
     
    7069''TODO: check the compatibility between Apache 2.0/2.2 and the Subversion bindings. The latter are using libapr and libaprutil 0.9.12.''
    7170
    72 Then, check the regular TracModPython instructions to see how you have to modify your http.conf.
     71''TODO: newer versions of revived mod_python library untested.''
    7372
    74 ==== Authenticating Trac users against MS Windows domain controller ====
     73Then, check the regular TracModPython instructions to see how to modify your `http.conf` file.
    7574
    76 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 [http://sourceforge.net/projects/mod-auth-sspi here], place it in the Apache modules directory, and add the following line to your `httpd.conf`, with all the `LoadModule` instructions:
    77 {{{
     75==== Authenticating Trac users against MS Windows domain controller
     76
     77Running 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.
     78
     79Download this module [http://sourceforge.net/projects/mod-auth-sspi here], place it in the Apache modules directory, and add the following line to your `httpd.conf`, with all the `LoadModule` instructions:
     80{{{#!apache
    7881LoadModule sspi_auth_module modules/mod_auth_sspi.so
    7982}}}
     
    8184Then add the following to the end of `http.conf`, modified according to your settings:
    8285
    83 {{{
     86{{{#!apache
    8487<LocationMatch /MyTracRootURL/[^/]+/login>
    8588        AuthType SSPI
     
    9396}}}
    9497
    95 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`.
     98Then, 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`.
    9699
    97 === Internet Information Services (IIS) ===
     100=== Internet Information Services (IIS)
    98101
    99102It is also possible to install [wiki:"TracOnWindowsIis6" Trac with IIS 6], though your mileage may vary.
     
    103106With IIS 8+ it should be possible to use [http://www.hanselman.com/blog/AnnouncingRunningRubyOnRailsOnIIS8OrAnythingElseReallyWithTheNewHttpPlatformHandler.aspx HttpPlatformHandler] as a proxy to Tracd.
    104107
    105 
    106108'''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.