Version 16 (modified by 20 years ago) ( diff ) | ,
---|
Windows Installation instructions for SVN w/TRAC 0.61
Versions used in this example (Available 2004-05-13):
- Apache 2.0.49
- Python 2.3.3
- SVN 1.0.2
- SQLite 2.8.13
- PySQLite 0.5.0-py2.3
- Trac 0.6.1
Contact Daragh Fitzpatrick for more info.
Added some information to help install Trac version 0.7.1. The docs should be OK now but you can try to contact Muir for questions.
Note: This example installs to D: (for extra points)
Arm Yourself
- Get & Read book http://svnbook.red-bean.com
Install SubVersioN Pre-Requisites
- Install Python
http://www.python.org
Add D:\Python23 to path
- Install Apache http://httpd.apache.org
- Install Subversion http://subversion.tigris.org
Create Repository
- Create Repository Directory
D:\> md d:\svn
- Create Repository
D:\> svnadmin create d:\svn\repo1
- Create skeleton repository structure in d:\temp\project
Example:
/project /vendor /tags /trunk files /projectname /branches /tags /trunk files
- Build Repository Tree
D:\> svn import d:\temp\project file:///d:/svn/repo1 -m "Initial Load"
- Create local sandbox
D:\> svn checkout file:///d:/svn/repo1 d:\project
Configure Apache
- Copy files
D:\> copy d:\progra~1\subver~1\httpd\*.* d:\progra~1\apache~1\apache2\modules
You may also need to do manually transfer the DLL files from the subversion installation directory. They contain, among other things, the Berkeley DB. This is all you need to do for the DLLs:
D:\> copy d:\progra~1\subver~1\bin\*.dll d:\progra~1\apache~1\apache2\modules
- Create password file (w/user 'admin')
D:\> d:\progra~1\apache~1\apache2\bin\htpasswd -cm d:\svn\.htaccess admin
- Configure Apache (edit httpd.conf) 12.1. Restrict access/lockdown as appropriate
12.2. Add Modules to httpd.conf
12.1.1. Uncomment:
LoadModule dav_module modules/mod_dav.so LoadModule dav_fs_module modules/mod_dav_fs.so12.1.2. Add (after):
# Subversion LoadModule dav_svn_module modules/mod_dav_svn.so LoadModule authz_svn_module modules/mod_authz_svn.so
12.3. Add location root for multiple repositories
# Subversion <Location /svn> DAV svn # any /svn/foo URL will map to a repository D:/svn/foo SVNParentPath D:/svn AuthType Basic AuthName "Subversion repository" AuthUserFile d:/svn/.htaccess Require valid-user </Location>
- Restart your MACHINE
- Test your install of Subversion http://[hostname]:80/svn/repo1
Phew! Subversion is installed and working - Grab a beverage for yourself.
Setup Users
- Add users to password file
D:\> d:\progra~1\apache~1\apache2\bin\htpasswd -m d:\svn\.htaccess user
Install TRAC Prerequisites
- Install Subversion Python Bindings
(Get from same download page as Subversion)
Copy libsvn and svn directories to D:\Python23\Lib
- Install SQLite
http://www.sqlite.org
Copy sqlite.exe to D:\Program Files\SQLite
- Install PySQLite http://pysqlite.sourceforge.net
- Install TRAC http://www.edgewall.com/products/trac/
BUG As of 20040612, Trac-win32 version 0.7.1 DOES NOT include a file called siteconfig.py, which is required for the scripts to work. There are two workarounds: 1) Install 0.7 first and then install 0.7.1 on top of it or 2) Create c:\python23\lib\site-packages\trac\siteconfig.py (or wherever your installation is) yourself:
# siteconfig.py __default_templates_dir__ = 'c:\\Python23\\share\\trac\\templates' __default_htdocs_dir__ = 'c:\\Python23\\share\\trac\\htdocs' __default_wiki_dir__ = 'c:\\Python23\\share\\trac\\wiki-default'Remember to correct the paths in that file! Under no circumstances should you actually *run* 0.7. This will hopefully be fixed in the next version.
Fix a few things
- BUG Edit first line of D:\Python23\Scripts\trac-admin to have:
#!D:\Python23\python.exe
- BUG Edit first line of D:\Python23\share\trac\cgi-bin\trac.cgi to have:
#!D:\Python23\python.exe
- Copy CGI
D:\> copy d:\python23\share\trac\cgi-bin\trac.cgi d:\progra~1\apache~1\apache2\cgi-bin
- BUG not able to run trac-admin initenv… Not available in 0.6.1
Configure TRAC DB
- Run trac-admin
D:\Python23\Scripts> python trac-admin d:/svn/trac.db
- Initialize DB
Trac [d:/svn/trac.db]> initdb
Enter project name Project Enter path to repository d:\svn\repo1 Enter path to templates d:\Python23\share\trac\templates (BUG) Note error message regarding wiki-pages
If you get an error here stating that libdb42.dll was not found, copy [SVN PATH]\bin\libdb42.dll to [PYTHON PATH]\lib\libsvn\libdb42.dll, then try again.
- BUG Load Wiki
Trac [d:/svn/trac.db]> wiki load d:/python23/share/trac/wiki-default
- Add administrative permissions (the below adds all permissions for 'admin' user)
Trac [d:/svn/trac.db]> permission add admin TRAC_ADMIN
Add TRAC to Apache
- Edit httpd.conf:
Add: (copy this - there's a typo in Edgewall's version)
# TRAC Alias /trac "D:/Python23/share/trac/htdocs" <Directory "D:/Python23/share/trac/htdocs"> Options Indexes MultiViews AllowOverride None Order allow,deny Allow from all </Directory> <Location "/cgi-bin/trac.cgi"> # For 0.7 release SetEnv TRAC_ENV "d:/svn/trac.db" # for 0.6.1 release SetEnv TRAC_DB "d:/svn/trac.db" </Location> <Location "/cgi-bin/trac.cgi/login"> AuthType Basic AuthName "Project" AuthUserFile D:/svn/.htaccess Require valid-user </Location>
Alternatively you could set up the authorisation to use your NT domain login if you are running an NT Domain. This bit of Apache config replaces the <Location "/cgi-bin/trac.cgi/login"> given above.
<Location "/cgi-bin/trac.cgi/login"> #NT Domain auth config AuthType SSPI SSPIAuth On SSPIAuthoritative On SSPIOfferBasic On AuthName "Project" Require valid-user </Location>You'll also need the sspi_auth_module on your system and loaded like this…
LoadModule sspi_auth_module modules/mod_auth_sspi.so
Or compile it into Apache.
- Restart Apache
- Hold your breath, test TRAC install http://[hostname]:80/cgi-bin/trac.cgi
Finally…
- Install SVN Clients as necessary (try Rapid SVN & Tortoise SVN)
- Don't forget to lock down the security on the box!
- Now go get a *real* drink
Attachments (2)
-
trac-0.10.3-win32-install.py
(11.7 KB
) - added by 17 years ago.
All-in-one installer (not a graphical installer)
-
Step_by_Step-installation-manual.txt
(4.1 KB
) - added by 15 years ago.
A TracOnWindows step by step guide to fast get up and running. This version use windows 2003 std SP2 and Trac 0.11.2.1 with Python 2.5.4. together with the webserver tracd and authentication.
Download all attachments as: .zip