Changes between Initial Version and Version 1 of TracOnOsxServerNoFink

Timestamp:

Jul 18, 2006, 2:08:25 PM (18 years ago)

Author:

thibaud.guillaume-gentil@…

Comment:

first add

TracOnOsxServerNoFink

@@ +1 @@
+[[PageOutline(2-4)]]
+= Trac + SVN Installation on Mac OS X Server  10.4.7 =
+
+== Requirements ==
+
+Mac OS X Server 10.4.7 + XCode 2.3 ([http://developer.apple.com/tools/xcode/ Download])
+
+||[http://projects.edgewall.com/trac/ Trac]||0.9.6||
+||[http://www.python.org/ Python]||2.3.5 (as installed with OS X 10.4.7)||
+||[http://httpd.apache.org/ Apache]||2.0.58||
+||[http://www.modpython.org/ mod_python]||3.2.8||
+||[http://www.swig.org/ Swig]||1.3.29||
+|| [http://subversion.tigris.org/ Subversion]||1.3.2||
+||[http://www.sqlite.org/ SQLite]||3.1.3 (as installed with OS X 10.4.7)||
+||[http://pysqlite.org/ PySQLite]||2.2.2||
+||[http://clearsilver.net/ Clearsilver]||0.10.3||
+||[http://docutils.sourceforge.net/ Docutils]||0.4||
+
+== Preliminaries == 
+
+Install Mac OS X Server 10.4.7 and XCode 2.3
+
+Download all binaries and untar it in the folder {{{/usr/local/temp}}}  (for example)
+
+== Binairies Installation ==
+'''The order of installation it's very important respect it, please!'''
+
+=== Swig ===
+
+{{{
+cd <swig-distribution-top-dir>
+./configure --with-python=/usr/bin/python
+make 
+sudo make install
+}}}
+
+=== Apache 2 ===
+
+{{{
+cd <apache2-distribution-top-dir>
+./configure --enable-mods-shared=most --enable-ssl --with-mpm=worker --without-berkeley-db –-enable-so
+make
+sudo make install
+}}}
+
+=== mod_python ===
+
+{{{
+cd <mod_python-distribution-top-dir>
+./configure --with-apxs=/usr/local/apache2/bin/apxs --with-python=/usr/bin/python
+make
+sudo make install
+}}}
+
+=== Subversion === 
+
+{{{
+cd <subversion-distribution-top-dir>
+./configure -prefix=/usr/local  --without-berkeley-db --enable-swig-bindings=python \
+    --with-swig=/usr/local/bin/swig PYTHON2=/System/Library/Frameworks/Python.framework/Versions/2.3/ \
+    --mandir=/usr/local/share/man --with-ssl  --with-apxs=/usr/local/apache2/bin/apxs --with-zlib \
+    --enable-swig-bindings=no --with-apr=/usr/local/apache2 --with-apr-util=/usr/local/apache2
+make
+sudo make install
+}}}
+
+swig svn python bindings
+
+{{{
+cd <subversion-distribution-top-dir>
+make swig-py
+sudo make install-swig-py
+echo /usr/local/lib/svn-python > /Library/Python/2.3/site-packages/svn-python.pth
+}}}
+
+=== PySQLite ===
+
+{{{
+cd <pysqlite-distribution-top-dir>
+sudo python setup.py install
+}}}
+
+=== Clearsilver ===
+
+{{{
+cd <clearsilver-distribution-top-dir>
+./configure --prefix=/usr/local --with-python=/usr/bin/python --disable-ruby
+make
+# >>> here modify first line of scripts/document.py to use same python  (#!/usr/bin/ python)
+sudo make install 
+}}}
+
+=== Docutils ===
+
+{{{
+cd < docutils-distribution-top-dir>
+sudo python setup.py install
+}}}
+
+== Trac + SVN Configuration ==
+
+First choose a location for your subversion repository, e.g. {{{/var/svn/your_project}}}, and one for you trac environment, e.g. {{{/var/trac/your_project}}}. 
+
+You may need to manage access rights on the trac env directory tree. This may be done by first creating a unix group dedicated to this trac project, e.g. {{{trac}}}, and assigning the various users to this group. The apache {{{www}}} user should be one of these. If you need a nice description of how to do this, look at the [http://developer.apple.com/internet/opensource/cvsoverview.html Apple CVSOverview] (then search for the text "create a new group" or "!NetInfo Manager"). 
+
+In my configuration Apache2 is the {{{nobody}}} user so you can try:
+
+{{{
+sudo chgrp -R nobody /var/trac
+sudo chmod -R 770 /var/trac
+sudo chgrp -R nobody /var/svn
+sudo chmod -R 770 /var/svn
+}}}
+
+=== SVN Repository === 
+
+{{{
+svnadmin create /var/svn/your_project
+}}}
+
+Subversion executables are installed into /usr/local/bin, which is not in the default path in Mac OS X Server v10.4. To add /usr/local/bin to a user's default path, create a .profile file in your home directory (or simply add the line if you already have a .profile file):
+
+{{{
+cd ~
+echo 'export PATH="$PATH:/usr/local/bin"' >> .profile
+}}}
+
+To make sure the repository is ok, play with it a little:
+{{{
+cd /tmp
+mkdir proj
+cd proj
+mkdir trunk branches tags
+cd ..
+svn import proj file:///var/svn/your_project -m "Import First"
+rm -r proj
+svn co file:///var/svn/your_project proj
+cd proj
+svn update 
+}}}
+
+=== Trac Environment === 
+
+{{{
+trac-admin /var/trac/your_project initenv
+}}}
+
+Your {{{trac-admin}}} binary may not be in your search path - if {{{trac-admin}}} isn't found, try:
+
+{{{
+cd ~
+echo 'export PATH="$PATH:/System/Library/Frameworks/Python.framework/Versions/Current/bin/trac*"' >> .profile
+}}}
+
+== Apache2 Configuration and Right Access ==
+
+=== apache httpd.conf ===
+
+Open and edit  {{{httpd.conf}}} in {{{/usr/local/apache2/conf}}}
+
+Add this module (if not already exist) at line ~265
+
+{{{
+LoadModule dav_svn_module     modules/mod_dav_svn.so
+LoadModule authz_svn_module   modules/mod_authz_svn.so
+
+LoadModule python_module modules/mod_python.so
+}}}
+
+Add and configure access to Trac and SVN path at line ~1040
+
+{{{
+<Location /your_project/>
+   SetHandler mod_python
+   PythonHandler trac.web.modpython_frontend 
+   PythonOption TracEnv /var/trac/your_project
+</Location>
+
+<Location "/your_project/login">
+  AuthType Basic
+  AuthName "emersion"
+  AuthUserFile /var/trac/your_project/.htpasswd
+  Require valid-user
+</Location>
+
+<Location /your_project/svn>
+    DAV svn
+    SVNPath /var/svn/eMersion 
+   
+    AuthzSVNAccessFile /var/svn/your_project/conf/authz
+    
+    AuthType Basic
+    AuthName "Reférentiel Subversion"
+    AuthUserFile /var/trac/your_project/.htpasswd
+    Require valid-user
+</Location>
+}}}
+
+=== Trac and SVN .htpasswd ===
+
+Trac ans SVN can share the same {{{.htpasswd}}}, but you can separate it if you want.
+
+create the {{{.htpasswd}}} in {{{/var/trac/your_project/}}}, for exampe:
+
+{{{
+[users]
+YourName:8d2yxeC7vAkiQ
+HisName:7$4k2Ci4QoVFc
+}}}
+
+{{{[users]}}} is important for the AuthzSVNAccessFile.
+
+For generate password you can use [http://www.engr.sjsu.edu/daluu/scripts/htpasswd.php this web site]
+
+=== SVN authz ===
+
+Edit the file {{{authz}}}  in {{{/var/svn/your_project/conf/}}}, for example:
+
+{{{
+[groups]
+admin = YourName
+
+[/]
+@admin = rw
+HisName = r
+* =
+}}}
+
+for more details on this configuration's file please [http://svnbook.red-bean.com/en/1.2/svn-book.html#svn.serverconfig.httpd.authz read this]
+
+=== Start apache2 ===
+
+Now you can start apache2:
+
+{{{
+sudo /usr/local/apache2/bin/apachectl start
+}}}
+
+You can check if everything is working well:
+
+ * for trac [http://localhost:80/your_project]
+ * for svn direct access [http://localhost:80/your_project/svn]
+
+For external access please make your own apache's configuration
+
+thibaud.guillaume-gentil [at] epfl.ch