Changes between Version 146 and Version 147 of TracOnWindows
- Timestamp:
- Feb 12, 2006, 11:22:40 PM (18 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracOnWindows
v146 v147 7 7 * [wiki:TracOnWindowsStandalone Trac running without Apache or IIS] using [source:trunk/README.tracd#latest tracd] and svnserve is the simplest setup. It is stripped for all optional dependencies. It might be taken as a first step to get things running. You should then be able to pick the missing steps from the Apache CGI based setup found on this page as a second step. 8 8 9 * The 'traditional' [wiki:TracOnWindows#InstallationofSubversionandTrac 0.8.4servedviaApacheCGI Apache CGI based setup] is described just below.9 * The 'traditional' [wiki:TracOnWindows#InstallationofSubversionandTracservedviaApacheCGI Apache CGI based setup] is described just below. 10 10 11 11 * Also, after installing the CGI-based setup, you may want to [wiki:TracModPython switch to using mod_python] which speeds up Trac's response times considerably. … … 13 13 If you are trying to upgrade to Trac 0.9, [wiki:TracOnWindows#UpgradingfromTrac0.84to0.9beta1onWindows see the instructions] at the end of this file. 14 14 15 == Installation of Subversion and Trac 0.8.4served via Apache CGI ==16 17 Versions used in this example ( June 2005-06-29):18 * Trac 0. 8.415 == Installation of Subversion and Trac served via Apache CGI == 16 17 Versions used in this example (Feb 2006): 18 * Trac 0.9.x 19 19 * [http://www.clearsilver.net Clearsilver 0.9.14 binaries] 20 20 * [http://www.python.org Python 2.3.5] … … 22 22 * [http://subversion.tigris.org Subversion 1.2.0] 23 23 * [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91&filter=_py.zip Python 2.3 Bindings for subversion 1.2.0] 24 * [http://www.egenix.com/files/python/eGenix-mx-Extensions.html eGenix.com mx Extensions for Python] 25 * [http://sourceforge.net/project/showfiles.php?group_id=38414 docutils 0.3.9] 26 * [http://www.sqlite.org SQLite 3.2.2] 24 * [http://www.egenix.com/files/python/eGenix-mx-Extensions.html eGenix.com mx Extensions for Python] ''(only required if using PostgreSQL)'' 25 * [http://sourceforge.net/project/showfiles.php?group_id=38414 docutils 0.3.9] (Optional) 26 * [http://www.sqlite.org SQLite 3.2.2] (optional) 27 27 * [http://initd.org/pub/software/pysqlite/releases/1.1/1.1.6/pysqlite-1.1.6.win32-py2.3.exe PySQLite 1.1.6-py2.3] 28 * [http://gnuwin32.sourceforge.net/packages/diffutils.htm Diffutils 2.8.7-1] (Optional)29 28 30 29 '''Please update this Wiki page if you find it is different from your experience.''' … … 58 57 Note: Be sure to have the MSVCP60.DLL in your PATH, otherwise Apache will refuse to start with the SVN module. 59 58 60 5. Install [http://docutils.sourceforge.net/ docutils ]61 {{{62 expand and run from the expanded docutils-xxx directory63 > C:\python23\python setup.py install64 }}}65 66 59 === Create Repository === 67 6. Create repository directory60 5. Create repository directory 68 61 {{{ 69 62 C:\> md c:\svn 70 63 }}} 71 64 72 7. Create repository 73 {{{ 74 C:\> svnadmin create --fs-type=fsfs c:\svn\repo1 75 }}} 76 77 78 ''FSFS should be the preferred Subversion Repository filesystem on Windows. The Python bindings are much more reliable in that case -- ChristianBoos'' 79 80 8. Create skeleton repository structure in c:\temp\project 65 6. Create repository 66 {{{ 67 C:\> svnadmin create c:\svn\repo1 68 }}} 69 70 7. Create skeleton repository structure in c:\temp\project 81 71 Example: 82 72 {{{ … … 93 83 }}} 94 84 95 9. Build repository tree85 8. Build repository tree 96 86 {{{ 97 87 C:\> svn import c:\temp\project file:///c:/svn/repo1 -m "Initial Load" 98 88 }}} 99 89 100 10. Create local sandbox90 9. Create local sandbox 101 91 {{{ 102 92 C:\> svn checkout file:///c:/svn/repo1 c:\project … … 104 94 105 95 === Configure Apache === 106 11. Copy files 107 {{{ 108 C:\> copy c:\progra~1\subver~1\httpd\*.* c:\progra~1\apache~1\apache2\modules 109 }}} 110 In my Subversion installation (1.2.1-r15230) the so files are located 96 10. Copy Subversion module files for Apache 111 97 {{{ 112 98 C:\> copy c:\Progra~1\Subver~1\bin\*.so c:\progra~1\apache~1\apache2\modules … … 117 103 }}} 118 104 119 1 2. Create password file (w/user 'admin')105 11. Create password file (w/user 'admin') 120 106 121 107 {{{ … … 123 109 }}} 124 110 125 1 3. Configure Apache (edit httpd.conf)126 1 3.1. [http://www.webdevelopersjournal.com/software/apache_more_config.html Restrict access/lockdown ] as appropriate127 128 1 3.2. Add Modules to httpd.conf129 130 1 3.1.1. Uncomment:111 12. Configure Apache (edit httpd.conf) 112 12.1. [http://www.webdevelopersjournal.com/software/apache_more_config.html Restrict access/lockdown ] as appropriate 113 114 12.2. Add Modules to httpd.conf 115 116 12.1.1. Uncomment: 131 117 {{{ 132 118 LoadModule dav_module modules/mod_dav.so 133 119 LoadModule dav_fs_module modules/mod_dav_fs.so 134 120 }}} 135 1 3.1.2. Add (after):121 12.1.2. Add (after): 136 122 {{{ 137 123 # Subversion … … 140 126 }}} 141 127 142 1 3.1.3. Install Apache as Service (IF NOT WORKING when installed to C:)128 12.1.3. Install Apache as Service (IF NOT WORKING when installed to C:) 143 129 {{{ 144 130 C:\Progra~1\Apache~1\Apache2\bin\Apache -k install -n "Apache2" 145 131 }}} 146 132 147 1 3.3. Add location root for multiple repositories133 12.3. Add location root for multiple repositories 148 134 {{{ 149 135 # Subversion … … 160 146 }}} 161 147 162 1 3.4. Add cgi handler, Uncomment:148 12.4. Add cgi handler, Uncomment: 163 149 {{{ 164 150 AddHandler cgi-script .cgi … … 166 152 167 153 168 1 4. Restart Apache169 170 1 5. Test your install of Subversion154 13. Restart Apache 155 156 14. Test your install of Subversion 171 157 http://[hostname]:80/svn/repo1 172 158 … … 175 161 === Create Users === 176 162 177 1 6. Add users to password file163 15. Add users to password file 178 164 {{{ 179 165 C:\> c:\progra~1\apache~1\apache2\bin\htpasswd -m c:\svn\.htaccess user … … 184 170 (Please note: pay attention to download '''exactly''' the versions mentioned here. Do '''not''' simply download the latest stable versions. Otherwise you will probably run into several issues.) 185 171 186 17. Install Subversion Python Bindings 187 Download [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91&filter=_py.zip svn-win32-1.2.X_py.zip] from the Subversion site. [[br]]Extract and copy the libsvn and svn directories to C:\Python23\Lib\site-packages [[br]][[br]]''Note : it is '''very''' important to use the python bindings for the exact version of Subversion you have installed. e.g. when running svn 1.1.4, make sure to use svn-win32-1.1.4_py.zip instead of the zip mentioned above. Otherwise, you '''will''' run into problems (loading dlls etc.)''. 172 16. Install Subversion Python Bindings 173 Download [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91&filter=_py.zip svn-win32-1.X.X_py.zip] from the Subversion site. [[br]]Extract and copy the libsvn and svn directories to C:\Python23\Lib\site-packages [[br]][[br]]''Note : it is '''very''' important to use the python bindings for the exact version of Subversion you have installed. e.g. when running svn 1.2.3, make sure to use svn-win32-1.2.3_py.zip instead of the zip mentioned above. Otherwise, you '''will''' run into problems (loading dlls etc.)''. 174 175 17. Install [http://docutils.sourceforge.net/ docutils ] (optional) 176 177 This is only required if you want to support Restructured text wiki markup 178 {{{ 179 expand and run from the expanded docutils-xxx directory 180 > C:\python23\python setup.py install 181 }}} 188 182 189 183 18. Install SQLite (optional) … … 222 216 Alternatively, grab unofficial installers for ClearSilver 0.9.14 from http://clearsilver.yi.org/. 223 217 224 21. Install eGenix.com mx Extensions for Python 218 21. Install eGenix.com mx Extensions for Python (if using PostgreSQL) 225 219 Download and install [http://www.egenix.com/files/python/eGenix-mx-Extensions.html].[[br]] 226 220 The 'initenv' command in trac-admin needs this library to create the Trac database (At least it did when using a PostgreSQL back end). … … 285 279 If you get an error here stating that libdb42.dll was not found, copy ''[SVN PATH]''\bin\libdb42.dll to ''[PYTHON PATH]''\lib\libsvn\, then try again. 286 280 287 If you get an error about execute() argument 1 on !CheckWiki.pyo, delete !CheckWiki.pyo from the c:\Python23\share\trac\templates directory. It shouldn't be there, but is when configuring 0.8.2 by hand instead of using the installer.288 289 281 If you get an error like "ImportError: No module named svn" you are missing the path to the SVN Python hooks in the PYTHONPATH environment varialbe. 290 282 … … 293 285 For example if you have your svn repository located in c:\svn\repo1 (like supposed by this tutorial), you'll probably want to name your trac database c:\trac\repo1. You would then call "python trac-admin c:/trac/repo1" in your scripts directory and enter "c:\svn\repo1" as the "path to (svn) repository". 294 286 295 27. (BUG) Load Wiki See Ticket #1648 296 (NB. This is fixed in the latest trac, so ignore this step if you installed v0.8.3 or later) 297 {{{ 298 Trac [c:/svn/trac.db]> wiki load c:/python23/share/trac/wiki-default 299 }}} 300 301 28. Add administrative permissions (the below adds all permissions for 'admin' user) 287 27. Add administrative permissions (the below adds all permissions for 'admin' user) 302 288 {{{ 303 289 Trac [c:/svn/trac.db]> … … 307 293 308 294 === Add Trac to Apache === 309 2 9. Edit httpd.conf:295 28. Edit httpd.conf: 310 296 Add: (copy this - there's a typo in Edgewall's version) 311 297 Edit PYTHONPATH to point to your install of SVN … … 384 370 385 371 386 30. Restart Apache.387 388 3 1. Hold your breath, test Trac install372 29. Restart Apache. 373 374 30. Hold your breath, test Trac install 389 375 http://[hostname]:80/cgi-bin/trac.cgi 390 376 … … 393 379 If your page seems to be lacking stylesheets, please check the alias of '''/trac''' in apache. Otherwise you've probably run into a known Apache bug described (and worked around) [http://www.apache.org/dist/httpd/binaries/win32/#xpbug here]. 394 380 395 === Optional Diffutils ===396 32. In order for Trac to display diffs, you must download and install [http://gnuwin32.sourceforge.net/packages.html diffutils]. (Be sure to download the setup executable as it will install dlls needed by diffutils for you.) After installing diffutils, you will need to add the path to the diff executable to the Windows PATH environment variable. '''Note:''' If Apache is running as a service you will need to reboot the machine for it to receive the updated PATH setting.397 398 381 === Optional Enscript === 399 33. In order for Trac to syntax highlight code, you must download and install [http://gnuwin32.sourceforge.net/packages.html Enscript]. After installing Enscript, you will need to add the path to the enscript executable to the Windows PATH environment variable. '''Note:''' If Apache is running as a service you will need to reboot the machine for it to receive the updated PATH setting. 382 31. In order for Trac to syntax highlight code, you must download and install [http://gnuwin32.sourceforge.net/packages.html Enscript]. After installing Enscript, you will need to add the path to the enscript executable to the Windows PATH environment variable. '''Note:''' If Apache is running as a service you will need to reboot the machine for it to receive the updated PATH setting. 383 384 === Optional pre- and post-commit hooks for Subversion === 385 32. In order to use pre- and post-commit hooks with Subversion on Windows, please refer to diff files described in #897, as the changes are not commited into the trunk as of version 0.8-dev. 400 386 401 387 === Finally... === 402 34. Install Subversion clients as necessary (try [http://rapidsvn.tigris.org RapidSVN] , [http://tortoisesvn.tigris.org/ TortoiseSVN] or [http://subclipse.tigris.org/ Subclipse]) 403 404 35. Don't forget to lock down the security on the box! 405 406 36. If the svn page would not work properly with saying that DLL is missing, FIRST try to reboot the system and if that does not work, copy the three DLL's - libdb42.dll - libeay32.dll - ssleay32.dll from your [Subversion]\bin directory to your system directory (most likely C:\Windows\system32). 407 408 === In addition... === 409 37. In order to use pre- and post-commit hooks with Subversion on Windows, please refer to diff files described in #897, as the changes are not commited into the trunk as of version 0.8-dev. 388 33. Install Subversion clients as necessary (try [http://rapidsvn.tigris.org RapidSVN] , [http://tortoisesvn.tigris.org/ TortoiseSVN] or [http://subclipse.tigris.org/ Subclipse]) 389 390 34. Don't forget to lock down the security on the box! 391 392 35. If the svn page would not work properly with saying that DLL is missing, FIRST try to reboot the system and if that does not work, copy the three DLL's - libdb42.dll - libeay32.dll - ssleay32.dll from your [Subversion]\bin directory to your system directory (most likely C:\Windows\system32). 410 393 411 394 == Upgrading from Trac 0.84 to 0.9-beta1 on Windows == … … 458 441 * [mailto:tim|at|igethalf.com Tim Browse] 459 442 * [mailto:sid|at|seegrid.com Sid Wiesner] 460 461 443 * [mailto:trac-svn-mail|at|elvendesigns.com Muir] 462 444 … … 493 475 ==== Guía en Español ==== 494 476 495 496 477 Guía de instalación de Trac en Windows en Español. [http://traclog.blogspot.com/ Aquí.] 497 478 Some help for Spanish speakers installing Trac for Windows.