Edgewall Software

Changes between Version 46 and Version 47 of TracOnOsxNoFink


Ignore:
Timestamp:
Jan 11, 2016, 11:43:38 PM (8 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • TracOnOsxNoFink

    v46 v47  
    1 [[PageOutline]]
    2 
    3 = Installing Trac on Mac OS X, without Fink or MacPorts =
    4 
    5 == Subversion the easy way ==
    6 
    7 If you are using Python 2.5.x (from http://python.org/download/ or pre-installed on Leopard) and either use Apache 2.2.4 or don't need `mod_dav_svn`, your best bet is going to be get the [http://downloads.open.collab.net/binaries.html opencollab precompiled Subversion].  It has a nice installer and in my experience ''just works''.  You will still need to install the other prereqs as detailed in the [#Otherprerequisites section after next].
    8 
    9 Its Python modules seem to work with Python 2.3.5 on Tiger but emit several warnings about a C api mismatch on startup (they still pass the Trac tests though). If you want seamless integration with 2.3 or Apache 2.0, read on.
    10 
    11 == Subversion the slightly harder way ==
    12 
    13 These instructions are written specifically for building Python 2.3 bindings when you have another Python (say 2.5) installed as default.  Adjust the instances of python2.3 for another Python as appropriate (specify path if necessary). This will install under `/usr/local` which allows it to coexist with the opencollab bindings, above.
    14 
    15 Note 1: These steps require using the Terminal (`/Applications/Utilities/Terminal.app`).  Some basic commands are left out, namely extracting (for `.tgz` or `.tar.gz`, `tar -xvzf FILENAME_HERE`; for `.tbz2` or `.tar.bz2`, `tar -xvjf FILENAME_HERE`) and directory changing.  You also must be in the `admin` group, so you can run `sudo`. If you need help with these steps, just hop on our IrcChannel.
    16 
    17 Note 2: if you have a muscle memory to use `wget` to download things, you can either [http://www.statusq.org/archives/2005/02/22/610 install it] or set up a quick bash function that'll do the equivalent with curl:
    18 
    19 {{{
     1[[PageOutline(2-5,Contents,pullout)]]
     2
     3= Installing Trac on Mac OS X, without Fink or !MacPorts
     4
     5== Subversion the easy way
     6
     7If you are using Python 2.5.x (from http://python.org/download/ or pre-installed on Leopard) and either use Apache 2.2.4 or don't need `mod_dav_svn`, your best bet is going to be get the [http://downloads.open.collab.net/binaries.html opencollab precompiled Subversion]. It has a nice installer and in my experience ''just works''. You will still need to install the other prerequisites as detailed in the [#Otherprerequisites section after next].
     8
     9Its Python modules seem to work with Python 2.3.5 on Tiger but emit several warnings about a C API mismatch on startup. They still pass the Trac tests though. If you want seamless integration with 2.3 or Apache 2.0, read on.
     10
     11== Subversion the slightly harder way
     12
     13These instructions are written specifically for building Python 2.3 bindings when you have another Python (say 2.5) installed as default. Adjust the instances of Python 2.3 for another Python as appropriate (specify path if necessary). This will install under `/usr/local` which allows it to coexist with the opencollab bindings, above.
     14
     15'''Note 1''': These steps require using the Terminal (`/Applications/Utilities/Terminal.app`). Some basic commands are left out, namely extracting (for `.tgz` or `.tar.gz`, `tar -xvzf FILENAME_HERE`; for `.tbz2` or `.tar.bz2`, `tar -xvjf FILENAME_HERE`) and directory changing. You also must be in the `admin` group, so you can run `sudo`. If you need help with these steps, just hop on our IrcChannel.
     16
     17'''Note 2''': if you have a muscle memory to use `wget` to download things, you can either [http://www.statusq.org/archives/2005/02/22/610 install it] or set up a quick bash function that'll do the equivalent with curl:
     18
     19{{{#!sh
    2020$ alias wget="curl -O"
    2121}}}
    2222
    23 Note 3: if you want to use Apache 2.0, [http://developer.apple.com/tools/subversionxcode.html go ahead and build it separately].  You will lose the ability to start/stop it in the Sharing pane though.  Apache 2.2 comes with Leopard and `mod_dav_svn` can evidently be built against that without recompiling Apache. However the package above comes with a precompiled 2.2 module that may work.
     23'''Note 3''': If you want to use Apache 2.0, [http://developer.apple.com/tools/subversionxcode.html go ahead and build it separately]. You will lose the ability to start/stop it in the Sharing pane though. Apache 2.2 comes with Leopard and `mod_dav_svn` can evidently be built against that without recompiling Apache. However the package above comes with a precompiled 2.2 module that may work.
    2424
    2525Let's begin.
    2626
    27  1. If you're on Tiger, get the [https://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19681 XCode 2.4.1 dmg] (free ADC login required, check bugmenot) and install it.  XCode 2.5 seems to have a [http://osflash.org/pipermail/swfmill_osflash.org/2008-January/001665.html broken/missing libtool on Tiger]. If on Leopard, use XCode 3.0, it should work correctly. ('''FIXME: Verify''')
     27 1. If you're on Tiger, get the [https://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19681 XCode 2.4.1 dmg] (free ADC login required, check bugmenot) and install it. XCode 2.5 seems to have a [http://osflash.org/pipermail/swfmill_osflash.org/2008-January/001665.html broken/missing libtool on Tiger]. If on Leopard, use XCode 3.0, it should work correctly. ('''FIXME: Verify''')
    2828
    2929 2. [http://www.swig.org/download.html Download] and build SWIG.
    3030
    31 {{{
     31{{{#!sh
    3232$ ./configure --with-python=python2.3
    3333$ make
     
    3737With version 1.3.34, this took under 4 minutes on a lowly G4.
    3838
    39  3. [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=260&expandFolder=74 Download] and extract both `subversion` and `subversion-deps` from the same folder.  They will end up overlaying.
    40 
    41 {{{
     39 3. [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=260&expandFolder=74 Download] and extract both `subversion` and `subversion-deps` from the same folder. They will end up overlaying.
     40
     41{{{#!sh
    4242$ ./configure --without-berkeley-db --with-ssl --with-zlib PYTHON=python2.3
    4343$ make
     
    4646}}}
    4747
    48 The configure step is recursive and may look like it is looping.  Just let it sit for a while and **be patient**.  Expect a message at the end of configure about not being build with bdb support. That's fine, you don't want bdb anyway!
    49 
    50 If you want to build `mod_dav_svn`, you need to add some additional arguments here, check [http://developer.apple.com/tools/subversionxcode.html the Apple install doc] for examples as you will want to use the `apxs` and `apr` options from it..
     48The configure step is recursive and may look like it is looping. Just let it sit for a while and expect a message at the end of configure about not being build with bdb support. That's fine, you don't want bdb anyway!
     49
     50If you want to build `mod_dav_svn`, you need to add some additional arguments here, check [http://developer.apple.com/tools/subversionxcode.html the Apple install doc] for examples as you will want to use the `apxs` and `apr` options from it.
    5151
    5252With Subversion 1.4.6, the `make` steps took approximately 15 minutes each on a lowly G4.
    5353
    54  4. Add the svn bindings to your `$PYTHONPATH`.  The easiest way to do this is detailed in [http://svn.collab.net/repos/svn/trunk/subversion/bindings/swig/INSTALL the install doc] for Subversion:
    55 
    56 {{{
     54 4. Add the svn bindings to your `$PYTHONPATH`. The easiest way to do this is detailed in [http://svn.collab.net/repos/svn/trunk/subversion/bindings/swig/INSTALL the install doc] for Subversion:
     55
     56{{{#!sh
    5757$ echo /usr/local/lib/svn-python > /Library/Python/2.3/site-packages/svn-python.pth
    5858}}}
     
    6060If you are not using the bundled 2.3, figure out where your site-packages directory lives:
    6161
    62 {{{
     62{{{#!sh
    6363$ python -c 'import site; print site.sitedirs[0]'
    6464}}}
    6565
    66  5. Enjoy!
    67 
    68 == Other prerequisites ==
    69 
    70  1. setuptools (required for 0.11, doesn't hurt for 0.10)
    71 
    72 {{{
     66== Other prerequisites
     67
     68 1. setuptools (required for 0.11, doesn't hurt for 0.10):
     69
     70{{{#!sh
    7371$ wget http://peak.telecommunity.com/dist/ez_setup.py
    7472$ sudo python2.3 ez_setup.py
     
    7775Then add `/System/Library/Frameworks/Python.framework/Versions/2.3/bin` to '''the end''' of your path (presuming you want a coresident 2.5 to be primary, and will suffix all commands with the Python version).
    7876
    79 {{{
     77{{{#!sh
    8078echo 'PATH="${PATH}:/System/Library/Frameworks/Python.framework/Versions/2.3/bin"' >> ~/.bash_profile
    8179echo 'export PATH' >> ~/.bash_profile
    8280}}}
    8381
    84 '''Do not''' forget the doubled greater-than, otherwise you'll overwrite existing commands in your `.bash_profile`.  Now type `source ~/.bash_profile` to make it take effect immediately.
    85 
    86  2. pysqlite2 (both 0.10 and 0.11) can build against the bundled libsqlite3 on Tiger.  [http://pysqlite.org Download the sources], extract, and
    87 
    88 {{{
     82'''Do not''' forget the doubled greater-than, otherwise you'll overwrite existing commands in your `.bash_profile`. Now type `source ~/.bash_profile` to make it take effect immediately.
     83
     84 2. pysqlite2 (both 0.10 and 0.11) can build against the bundled libsqlite3 on Tiger. [http://pysqlite.org Download the sources], extract, and run:
     85
     86{{{#!sh
    8987$ python2.3 setup.py build
    9088$ sudo python2.3 setup.py install
     
    9391This just takes less than a minute with pysqlite 2.4.1 on a G4.
    9492
    95  3. clearsilver (0.10)
    96 
    97 {{{
     93 3. Clearsilver (0.10):
     94
     95{{{#!sh
    9896$ ./configure --prefix=/usr/local --disable-ruby --with-python=`which python2.3`
    9997$ make
     
    10199$ sudo python python/setup.py install
    102100}}}
    103 The make step will take approximately a minute to complete.  If you do not supply the full path to a python binary, it will fall back to a broken section of configure (at least using clearsilver 0.10.5) which will result in site-packages being in the install path twice.
    104 
    105 '''Note:''' On Intel-Based Mac's running Leopard, you may need to configure with "./configure --build=i386 --with-python=`which python`  --disable-ruby" if it fails to guess the architecture of neo_cgi.so during make.
    106 
    107 
    108  4. Genshi (0.11)
    109 
    110 {{{
     101
     102The make step will take approximately a minute to complete. If you do not supply the full path to a python binary, it will fall back to a broken section of configure (at least using clearsilver 0.10.5) which will result in site-packages being in the install path twice.
     103
     104'''Note:''' On Intel-Based Mac's running Leopard, you may need to configure with "./configure --build=i386 --with-python=`which python` --disable-ruby" if it fails to guess the architecture of neo_cgi.so during make.
     105
     106 4. Genshi (0.11):
     107
     108{{{#!sh
    111109$ sudo easy_install-2.3 Genshi
    112110}}}
    113111
    114  5. Pygments for syntax highlighting (0.10 with TH:TracPygments plugin, automatic on 0.11)
    115 
    116 {{{
     112 5. Pygments for syntax highlighting (0.10 with TH:TracPygments plugin, automatic on 0.11):
     113
     114{{{#!sh
    117115$ sudo easy_install-2.3 Pygments
    118116}}}
    119117
    120 == Subversion the old way ==
    121 
    122 '''These are advanced instructions.'''  You should be familiar with the Terminal, the standard configure/make process, and be intimately aware of what python versions you have on your system and the order they are in your path. If you're using Tiger/Leopard and want a simpler solution, scroll back up.
     118== Subversion the old way
     119
     120'''These are advanced instructions.''' You should be familiar with the Terminal, the standard configure/make process, and be intimately aware of what python versions you have on your system and the order they are in your path. If you're using Tiger/Leopard and want a simpler solution, scroll back up.
    123121
    124122----
    125123
    126 
    127 I have found that trying to install Trac and all its dependencies, notably subversion and the swig bindings, on OS X 10.3 without using [http://fink.sf.net/ Fink], to be surprisingly difficult and full of gotchas. With some perseverance, and considerable help from kind folks on the trac and subversion users lists, I have succeeded. In the hope that this may help others, I am documenting here what has worked for me.
     124I have found that trying to install Trac and all its dependencies, notably Subversion and the swig bindings, on OS X 10.3 without using [http://fink.sf.net/ Fink], to be surprisingly difficult and full of caveats. With some perseverance, and considerable help from kind folks on the Trac and Subversion users lists, I have succeeded. In the hope that this may help others, I am documenting here what has worked for me.
    128125
    129126This procedure intentionally specifies that subversion be installed without Berkeley DB, thus svn repositories will be only [http://svn.collab.net/repos/svn/trunk/notes/fsfs FSFS], as per current recommendation.
     
    131128The details here are quite tightly bound to the specific version of each package installed, and therefore are likely to change quickly. Please take this into account, and do not follow them blindly! Also, if you discover any incorrectness, or obsoleteness, please be so kind as to either update this document yourself, or just contact me on ''mario@ruggier.org'' about it.
    132129
    133 You should allow yourself a comfortable hour or so for this installation procedure... and that is real quick and easy when compared to the few days of frustration I spent figuring out why things were not working, due to incomplete, inconsistent, or just contradictory documentation that is currently available!
    134 
    135 == Requirements ==
     130You should allow yourself a comfortable hour or so for this installation procedure.
     131
     132== Requirements
    136133
    137134 * Apache 1.3, the one bundled with OS X 10.3
    138135 * [http://www.python.org/ Python], use the stock python 2.3 that comes with your OS X 10.3 system (in {{{/usr/bin/python}}})
    139136 * [http://www.webdav.org/neon/ neon], version 0.25.x (0.25.3 is OK)
    140  * [http://www.swig.org/ swig], version '''=''' 1.3.21, and '''not''' 1.3.24 !
     137 * [http://www.swig.org/ swig], version '''=''' 1.3.21, and '''not''' 1.3.24 !
    141138 * [http://subversion.tigris.org/ Subversion], version 1.x.x (1.2.3 is OK) (1.4 not recommended with XCode <= 2.4 see [#subversion below])
    142139 * [http://www.sqlite.org/ SQLite], version 3.x.x (3.2.5 is OK)
    143  * [http://pysqlite.org/ PySQLite], version 1.1.6, and '''not''' 2.0 and up 
     140 * [http://pysqlite.org/ PySQLite], version 1.1.6, and '''not''' 2.0 and up
    144141 * [http://clearsilver.net/ Clearsilver], version 0.9.14, and '''not''' 0.10.1
    145142 * [http://docutils.sourceforge.net/ docutils], version 0.3.x (0.3.9 is OK)
    146143 * [http://projects.edgewall.com/trac/ trac], version 0.8.x
    147144 
    148 ''Andrew Durdin says:'' I'm using OS X 10.4, and successfully installed trac with the following library versions (somewhat contrary to the notes above):
     145''Andrew Durdin says:'' I'm using OS X 10.4, and successfully installed Trac with the following library versions (somewhat contrary to the notes above):
    149146
    150147||Trac||0.9.5||
     
    158155||docutils||0.4||
    159156
    160 "Paul Yu says:"  I'm using OS X 10.4.7 Server, and successfully install trac with the following library versions:
     157''Paul Yu says:'' I'm using OS X 10.4.7 Server, and successfully installed Trac with the following library versions:
    161158
    162159||Trac||0.9.6||
     
    169166||Clearsilver||0.10.3||
    170167||docutils||Latest snapshot (8/17/2006)||
    171 I did have to mv /usr/lib/libsqlite3.0.dylib and /usr/lib/sqlite3 (directory) to *.old.  This overcame a problem with the PySQLite installation and test. see this link.  [http://lists.initd.org/pipermail/pysqlite/2006-April/000484.html]
    172 
    173 
    174 "(2007-07-23) Nico C says:"  Successfully installed on OS X 10.4.10 (Xcode 2.4.1 installed) with these versions:
     168I did have to mv /usr/lib/libsqlite3.0.dylib and /usr/lib/sqlite3 (directory) to *.old. This overcame a problem with the PySQLite installation and test. see this link. [http://lists.initd.org/pipermail/pysqlite/2006-April/000484.html]
     169
     170''Nico C (2007-07-23) says:'' Successfully installed on OS X 10.4.10 (Xcode 2.4.1 installed) with these versions:
    175171
    176172||Trac||0.10.4||
     
    184180||docutils||0.4||
    185181
    186 "(2008-03-10) Ryan Morales says: " Successfully configured TRAC 0.10.4 on MacOSX 10.4.10 with Xcode 2.5 installed.
    187 Installer versions:
     182''Ryan Morales (2008-03-10) says:'' Successfully configured Trac 0.10.4 on MacOSX 10.4.10 with Xcode 2.5 installed:
    188183
    189184||Apache||2.2.6||
     
    199194||docutils||0.4||
    200195
    201 
    202 
    203 
    204 
    205 
    206 
    207 I'm running Trac with the supplied ''tracd'' server because CGI is realy too slow and the Apache installed by Apple doesn't include ''mod_python''.
    208 
    209 == Preliminaries ==
    210 
    211 === no fink ===
     196I'm running Trac with the supplied ''tracd'' server, because the Apache installed by Apple doesn't include ''mod_python''.
     197
     198== Preliminaries
     199
     200=== no fink
    212201
    213202Preferably you do not have fink in your environment, to avoid that the various configure scripts pick up libraries to link to from under fink. So, make sure that your env path does not include any {{{/sw}}} dirs, and that the file {{{/sw/bin/init.sh}}} is not being executed from anywhere in your {{{.profile}}}.
    214203
    215 === tar over zip ===
     204=== tar over zip
    216205
    217206When downloading the various packages, and have the choice between zip or tar source archives, prefer the tar distributions as zip has sometimes given carriage return problems, resulting in bizarre errors later on.
    218207
    219 === clean-up ===
     208=== clean-up
    220209
    221210'''Note:''' you may prefer to do this clean-up step only if a first installation attempt fails.
    222211
    223212Clean out any previously installed libs and executables prior to doing the installation process. The files to remove (or rename) are:
    224 {{{
     213{{{#!sh
    225214sudo rm -rf /usr/local/apr
    226215sudo rm -f /usr/local/lib/libneon*
     
    234223
    235224Plus, if you happen to have any previous installations of the swig svn python bindings in your site packages, then remove (or rename) them:
    236 {{{
     225{{{#!sh
    237226sudo rm -rf /Library/Python/2.3/libsvn
    238227sudo rm -rf /Library/Python/2.3/svn
    239228}}}
    240229
    241 
    242 == Installing the Packages ==
     230== Installing the Packages
    243231
    244232I will only describe the essentials that are particular to OS X, and to installing without Fink. Please substitute any steps not detailed here with their generic equivalents in TracInstall.
    245233
    246 === neon ===
     234=== neon
    247235
    248236In theory you should not need to install this separately, but doing so may avoid some confusing warnings when installing subversion, due to missing entry for darwin in the neon configure script (the neon currently bundled with subversion). See this [http://subversion.tigris.org/servlets/ReadMsg?list=users&msgNo=26484 note on the svn users list] as to why we may want to install neon separately.
    249237
    250  * Get latest source tarball from (http://www.webdav.org/neon/)
    251 {{{
     238 * Get latest source tarball from (http://www.webdav.org/neon/):
     239{{{#!sh
    252240cd <neon-distribution-top-dir>
    253241./configure --with-ssl
     
    257245 * For OS 10.4, if it doesn't install try commenting out NE_HAVE_I18N and HAVE_TIMEZONE in config.h
    258246
    259 === swig ===
    260 
    261 The latest version of swig (1.3.24) will '''not''' work! You need version 1.3.21, as stated in this [http://subversion.tigris.org/servlets/ReadMsg?list=users&msgNo=26451 message on the svn users list]:  "subversion 1.1.x currently REQUIRES swig >= 1.3.19 and <= 1.3.21. Swig1.3.24 is _not_ supported."
     247=== swig
     248
     249The latest version of swig (1.3.24) will '''not''' work! You need version 1.3.21, as stated in this [http://subversion.tigris.org/servlets/ReadMsg?list=users&msgNo=26451 message on the svn users list]: "subversion 1.1.x currently REQUIRES swig >= 1.3.19 and <= 1.3.21. Swig1.3.24 is _not_ supported."
    262250
    263251 * Get source tarball for '''1.3.21''' from (http://www.swig.org/)
    264252 * See the generalized [http://svn.collab.net/repos/svn/trunk/subversion/bindings/swig/INSTALL INSTALL] procedure, from which highlights are extracted below:
    265 {{{
     253{{{#!sh
    266254cd <swig-distribution-top-dir>
    267255./configure --with-python=/usr/bin/python
     
    272260}}}
    273261 
    274 
    275 === subversion ===
    276 
    277 Get latest source tarball from (http://subversion.tigris.org/). Note that you may get a prepared package for subversion from (http://www.codingmonkeys.de/mbo/), thanks to Martin Ott. You probably will anyhow still need the tarball above though for compiling the python bindings.  Note:  The Ott package does not have everything that is needed to work with trac, so it is better to just follow the make install instructions below.  I was able to install Ott's package and then make install from the source with no ill effects.
     262=== subversion
     263
     264Get latest source tarball from (http://subversion.tigris.org/). Note that you may get a prepared package for subversion from (http://www.codingmonkeys.de/mbo/), thanks to Martin Ott. You probably will still need the tarball above though for compiling the python bindings. Note: The Ott package does not have everything that is needed to work with Trac, so it is better to just follow the make install instructions below. I was able to install Ott's package and then make install from the source with no ill effects.
    278265
    279266For 10.3:
    280 {{{
     267{{{#!sh
    281268cd <subversion-distribution-top-dir>
    282269./configure --with-zlib --with-ssl --with-neon=/usr/local --without-berkeley-db --enable-swig-bindings=python --with-swig=/usr/local/bin/swig PYTHON=/usr/bin/python
     
    286273
    287274For Mac OS X 10.4, the following works:
    288 {{{
     275{{{#!sh
    289276cd <subversion-distribution-top-dir>
    290277GXX=yes ./configure --without-berkeley-db --enable-swig-bindings=python --with-swig=/usr/local/bin/swig PYTHON=/usr/bin/python PYTHON2=/usr/bin/python2.3
     
    293280}}}
    294281
    295 '''NOTE''': make sure you download the tar archive as the zip (for subversion 1.2.3) gave problems with carraige returns, specifically in the file {{{ac-helpers/install-sh}}}. You should see something like the output below (no bizarre chars) when you do:
    296 {{{
     282'''Note''': make sure you download the tar archive as the zip (for subversion 1.2.3) gave problems with carraige returns, specifically in the file {{{ac-helpers/install-sh}}}. You should see something like the output below (no bizarre chars) when you do:
     283{{{#!sh
    297284$ grep -n ^# ac-helpers/* | grep ':1:' | grep /bin/sh | cat -vte
    298285ac-helpers/config.guess:1:#! /bin/sh$
     
    302289}}}
    303290
    304 '''''COMPATIBILITY''''': Subversion 1.4 has changed the format of the .svn/entries files in a way that XCode version <= 2.4 does not understand.  Your options are as follows:
     291'''''COMPATIBILITY''''': Subversion 1.4 has changed the format of the .svn/entries files in a way that XCode version <= 2.4 does not understand. Your options are as follows:
    305292 * You can stay at 1.3.2
    306293 * See [http://www.macupdate.com/info.php/id/22882 this workaround].
    307294 * Upgrade XCode to 2.4.1
    308295
    309 === swig svn python bindings ===
     296=== swig svn python bindings
    310297
    311298For 10.3 do:
    312 {{{
     299{{{#!sh
    313300cd <subversion-distribution-top-dir>
    314301make swig-py
     
    318305
    319306For 10.4 do:
    320 {{{
     307{{{#!sh
    321308cd <subversion-distribution-top-dir>
    322309make swig-py
     
    325312}}}
    326313
    327 === sqlite, pysqlite ===
     314=== sqlite, pysqlite
    328315
    329316 * Get sqlite latest source tarball from (http://www.sqlite.org/) and pysqlite latest source tarball from (http://pysqlite.org/)
    330317 * Follow their respectives installation instructions.
    331  * '''NOTE (sqlite)''': The sqlite OS X install instructions that I found said to configure with the '--disable-shared' option, claiming that OS X's libtool is busted and thus generates bad dynamic/shared libraries.  However, disabling shared libraries generated an error during the make install step, because one of the install scripts looks for a shared library (identified by extension .dylib) regardless of the configure options.  So, in good UNIX fashion, I ignored the instructions and tried it with the shared libraries. I did a 'make test' and all the regression tests passed, so it seems that the problem with libtool has been fixed and '--disable-shared' is no longer necessary.
    332  * '''NOTE (pysqlite)''': The build step ('python setup.py build') failed with a "No such file or directory" error on "/opt/local/lib".  I opened up setup.py and found that for OS X (and only OS X), it sets the lib path to /opt/local/lib. On my system, this was wrong, so I changed it to /usr/local/lib.
     318 * '''NOTE (sqlite)''': The sqlite OS X install instructions that I found said to configure with the '--disable-shared' option, claiming that OS X's libtool is busted and thus generates bad dynamic/shared libraries. However, disabling shared libraries generated an error during the make install step, because one of the install scripts looks for a shared library (identified by extension .dylib) regardless of the configure options. So, in good UNIX fashion, I ignored the instructions and tried it with the shared libraries. I did a 'make test' and all the regression tests passed, so it seems that the problem with libtool has been fixed and '--disable-shared' is no longer necessary.
     319 * '''NOTE (pysqlite)''': The build step ('python setup.py build') failed with a "No such file or directory" error on "/opt/local/lib". I opened up setup.py and found that for OS X (and only OS X), it sets the lib path to /opt/local/lib. On my system, this was wrong, so I changed it to /usr/local/lib.
    333320 * '''NOTE (pysqlite)''': Just to clear up any confusion regarding API versions - and this probably only applies if you're going to use SQLite 3, either installed by hand or as shipped with OS X 10.4 - PySQLite v2.0x will not work with Trac (as of 0.9-pre). Instead, get the latest stable 1.1.x (1.1.6 as of this writing) version. '''DO NOT''' install PySQLite 2.x as it is a new version that will not work with Trac.
    334321 
    335 === clearsilver ===
     322=== clearsilver
    336323
    337324 * Get the 0.9.14 ('''not the latest''') tarball from (http://www.clearsilver.net/)
    338  * Installation procedure slightly different from those given by TracOnOsx
    339 {{{
     325 * Installation procedure slightly different from those given by TracOnOsx:
     326{{{#!sh
    340327cd <clearsilver-distribution-top-dir>
    341328./configure --prefix=/usr/local --with-python=/usr/bin/python --disable-ruby
     
    3473342007-11-06 Andy W says: I have been using clearsilver 0.10.4 successfully on OS-X 10.4 installations. But On OS-X Server 10.4.10 (i386), clearsilver 0.10.4 could not build neo_cgi.so. Clearsilver 0.10.5 built and installed neo_cgi.so, but put it in a funky directory {{{/System/Library/Frameworks/Python.framework/Versions/2.3/lib/python2.3/site-packages/site-packages}}} (note the double site-packages). When I moved the library to just python2.3/site-packages, it worked.
    348335
    349 2008-3-14 Zach says: Run "sudo python python/setup.py install" after "sudo make install" and it installs to the right location.  Also, On Intel-Based Mac's running Leopard (And maybe Tiger Server from Andy's error message), you may need to configure with "./configure --build-i386 --with-python=`which python`  --disable-ruby" if it fails to guess the architecture of neo_cgi.so during make.  It defaults to /usr/local, so theres no need to tell it to install there. 
    350 
    351 === docutils ===
     3362008-03-14 Zach says: Run "sudo python python/setup.py install" after "sudo make install" and it installs to the right location. Also, On Intel-Based Mac's running Leopard (And maybe Tiger Server from Andy's error message), you may need to configure with "./configure --build-i386 --with-python=`which python` --disable-ruby" if it fails to guess the architecture of neo_cgi.so during make. It defaults to /usr/local, so theres no need to tell it to install there.
     337
     338=== docutils
    352339
    353340 * Get latest source tarball from (http://docutils.sourceforge.net/).
    354341 * Standard setuptools installation.
    355342 
    356 === trac ===
     343=== trac
    357344 
    358345 * Standard setuptools installation
     
    365352For setting up access from Apache, see TracInstall, TracOnOsx, TracMultipleProjects.
    366353
    367 == Creating a trac environment ==
     354== Creating a trac environment
    368355
    369356First choose a location for your subversion repository, e.g. {{{/var/svn/test}}}, and one for you trac environment, e.g. {{{/var/trac/test}}}.
    370357
    371 === svn repository ===
     358=== svn repository
    372359
    373360Specifying {{{fs-type}}} is actually not necessary, as we have built without bdb, thus making {{{fsfs}}} the default backend file system.
     
    378365
    379366To make sure the repository is ok, play with it a little:
    380 {{{
     367{{{#!sh
    381368cd /tmp
    382369mkdir proj
     
    391378}}}
    392379
    393 === trac environment ===
     380=== trac environment
    394381
    395382{{{
     
    419406''mario@ruggier.org''
    420407
    421 == OS X 10.5, basic Trac + clearsilver + bundled Apache ==
     408== OS X 10.5, basic Trac + clearsilver + bundled Apache
    422409
    423410By Toby Thain, mailto:toby@telegraphics.com.au
    424411
    425 === Trac ===
     412=== Trac
     413
    426414Download and extract 0.10.4, then as root,
    427415{{{
     
    434422}}}
    435423
    436 === clearsilver ===
     424=== clearsilver
     425
    437426Typically, the build is problematic. I did:
    438427{{{
     
    447436}}}
    448437
    449 === Apache2 ===
     438=== Apache2
     439
    450440Edit {{{ /etc/apache2/httpd.conf }}}, at line 115 enable '''mod_fastcgi''':
    451441{{{
     
    489479Browse to http://localhost/trac/
    490480
    491 
    492 == OSX 10.5.x Leopard, SVN 1.5.x and Trac 0.11.x ==
     481== OSX 10.5.x Leopard, SVN 1.5.x and Trac 0.11.x
    493482
    494483By Dennis Burger
    495484
    496 One addition to Toby Thain excellent tutorial about Trac on MacOS X Leopard.  When you're updating to SVN 1.5.x you'll receive the following Trac error when opening a Trac page in you're webbrowser:
     485One addition to Toby Thain excellent tutorial about Trac on MacOS X Leopard. When you're updating to SVN 1.5.x you'll receive the following Trac error when opening a Trac page in you're webbrowser:
    497486
    498487{{{
     
    518507}}}
    519508
    520 Now refresh you're webbrowser (with a Trac page) and you're good to go!
     509Now refresh your web browser with a Trac page to clear the cache.
    521510
    522511----
    523 See also:  TracGuide, TracInstall, TracOnOsx, TracInstallPlatforms, [http://www.mac-how.net Mac How]
     512See also: TracGuide, TracInstall, TracOnOsx, TracInstallPlatforms, [http://www.mac-how.net Mac How]