Changes between Initial Version and Version 1 of TracOnWindows


Ignore:
Timestamp:
Sep 20, 2004, 6:01:32 PM (16 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracOnWindows

    v1 v1  
     1== Windows Installation instructions for SVN w/TRAC ==
     2
     3Versions used in this example (Available 2004-05-13):
     4 * Apache 2.0.49
     5 * Python 2.3.3
     6 * SVN 1.0.2
     7 * SQLite 2.8.13
     8 * PySQLite 0.5.0-py2.3
     9 * Trac 0.6.1
     10
     11Email [mailto:[email protected] Daragh Fitzpatrick] for more info,
     12or if you changed this page (since this Wiki does not support watch/subscription)
     13----
     14Note: This example installs to D:
     15
     16=== Arm Yourself ===
     171. Get & Read book
     18  http://svnbook.red-bean.com
     19
     20=== Install SubVersioN Pre-Requisites ===
     212. Install Python
     22  http://www.python.org
     23  [[br]]Add D:Python to path
     24
     253. Install Apache
     26  http://httpd.apache.org
     27
     284. Install Subversion
     29  http://subversion.tigris.org
     30
     31=== Create Repository ===
     325. Create Repository Directory
     33{{{
     34D:> md d:svn
     35}}}
     36
     376. Create Repository
     38{{{
     39D:> svnadmin create d:svn
     40epo1
     41}}}
     42
     437. Create skeleton repository structure in d:   empproject
     44  Example:
     45{{{
     46/project
     47  /vendor
     48    /tags
     49    /trunk
     50      files
     51  /projectname
     52    /branches
     53    /tags
     54    /trunk
     55      files
     56}}}
     57
     588. Build Repository Tree
     59{{{
     60D:> svn import d:       empproject file:///d:/svn/repo1 -m "Initial Load"
     61}}}
     62
     639. Create local sandbox
     64{{{
     65D:> svn checkout file:///d:/svn/repo1 d:project
     66}}}
     67
     68=== Configure Apache ===
     69
     7010. Copy files
     71{{{
     72D:> copy d:progra~1subver~1httpd*.* d:progra~1apache~1apache2modules
     73}}}
     74
     7511. Create password file (w/user 'admin')
     76{{{
     77D:> d:progra~1apache~1apache2inhtpasswd -cm d:svn.htaccess admin
     78}}}
     79
     8012. Configure Apache (edit httpd.conf)
     81  12.1. Restrict access/lockdown as appropriate
     82
     83  12.2. Add Modules to httpd.conf
     84
     85    12.1.1. Uncomment:
     86{{{
     87LoadModule dav_module modules/mod_dav.so
     88}}}
     89    12.1.2. Add (after):
     90{{{
     91# Subversion
     92LoadModule dav_svn_module modules/mod_dav_svn.so
     93}}}
     94
     95  12.3. Add location root for multiple repositories
     96{{{
     97# Subversion
     98<Location /svn>
     99  DAV svn
     100  # any /svn/foo URL will map to a repository D:/svn/foo
     101  SVNParentPath D:/svn
     102  AuthType Basic
     103  AuthName "Subversion repository"
     104  AuthUserFile d:/svn/.htaccess
     105  Require valid-user
     106</Location>
     107}}}
     108
     10913. Restart your MACHINE
     110
     11114. Test your install of Subversion
     112  http://[hostname]:80/svn/repo1
     113
     114Phew! Subversion is installed and working - Grab a beverage for yourself.
     115----
     116
     117=== Setup Users ===
     11815. Add users to password file
     119{{{
     120D:> d:progra~1apache~1apache2inhtpasswd -m d:svn.htaccess user
     121}}}
     122
     123=== Install TRAC Prerequisites ===
     12416. Install Subversion Python Bindings
     125  (Get from same download page as Subversion)
     126  [[br]]Copy libsvn and svn directories to D:Python23Lib
     127
     12817. Install SQLite
     129  http://www.sqlite.org
     130  [[br]]Copy sqlite.exe to D:Program FilesSQLite
     131
     13218. Install PySQLite
     133  http://pysqlite.sourceforge.net
     134
     13519. Install TRAC
     136  http://www.edgewall.com/products/trac/
     137
     138=== Fix a few things ===
     13920. (BUG) Edit first line of D:Python23Scripts  rac-admin to have:
     140{{{
     141
     142#!D:Python23python.exe
     143}}}
     144
     14521. (BUG) Edit first line of D:Python23share    raccgi-bin      rac.cgi to have:
     146{{{
     147
     148#!D:Python23python.exe
     149}}}
     150
     15122. Copy CGI
     152{{{
     153D:> copy d:python23share        raccgi-bin      rac.cgi d:progra~1apache~1apache2cgi-bin
     154}}}
     155
     15623. (BUG) not able to run trac-admin initenv...  Not available in 0.6.1
     157
     158=== Configure TRAC DB ===
     159
     16024. Run trac-admin
     161{{{
     162D:Python23Scripts> python trac-admin d:/svn/trac.db
     163}}}
     164
     16525. Initialize DB
     166{{{
     167Trac [d:/svn/trac.db]> initdb
     168}}}
     169{{{
     170  Enter project name
     171    Project
     172  Enter path to repository
     173    d:svn
     174epo1
     175  Enter path to templates
     176    d:Python23share     rac     emplates
     177  (BUG) Note error message regarding wiki-pages
     178}}}
     179
     18026. (BUG) Load Wiki
     181{{{
     182Trac [d:/svn/trac.db]> wiki load d:/python23/share/trac/wiki-default
     183}}}
     184
     18527. Add administrative permissions
     186{{{
     187Trac [d:/svn/trac.db]> permission add admin TICKET_ADMIN
     188Trac [d:/svn/trac.db]> permission add admin REPORT_CREATE
     189Trac [d:/svn/trac.db]> permission add admin REPORT_MODIFY
     190Trac [d:/svn/trac.db]> permission add admin REPORT_DELETE
     191Trac [d:/svn/trac.db]> permission add admin REPORT_ADMIN
     192Trac [d:/svn/trac.db]> permission add admin WIKI_DELETE
     193Trac [d:/svn/trac.db]> permission add admin WIKI_ADMIN
     194Trac [d:/svn/trac.db]> permission add admin CONFIG_VIEW
     195Trac [d:/svn/trac.db]> permission add admin TRAC_ADMIN
     196}}}
     197
     198=== Add TRAC to Apache ===
     199
     20028. Edit httpd.conf:
     201  Add: (copy this - there's a typo in Edgewall's version)
     202{{{
     203# TRAC
     204Alias /trac "D:/Python23/share/trac/htdocs"
     205<Directory "D:/Python23/share/trac/htdocs">
     206  Options Indexes MultiViews
     207  AllowOverride None
     208  Order allow,deny
     209  Allow from all
     210</Directory>
     211
     212<Location "/cgi-bin/trac.cgi">
     213  SetEnv TRAC_DB "d:/svn/trac.db"
     214</Location>
     215
     216<Location "/cgi-bin/trac.cgi/login">
     217  AuthType Basic
     218  AuthName "Project"
     219  AuthUserFile D:/svn/.htaccess
     220  Require valid-user
     221</Location>
     222}}}
     223
     22429. Restart Apache
     225
     22630. Hold your breath, test TRAC install
     227  http://[hostname]:80/cgi-bin/trac.cgi
     228
     229=== Finally... ===
     23031. Install SVN Clients as necessary (try [http://rapidsvn.tigris.org Rapid SVN] & [http://tortoisesvn.tigris.org/ Tortoise SVN])
     231
     23232. Don't forget to lock down the security on the box!
     233
     23433. Now go get a *real* drink
     235----
     236Email [mailto:[email protected] Daragh Fitzpatrick] with any questions!
     237----