Edgewall Software

Changes between Version 26 and Version 27 of TracOnOsx


Ignore:
Timestamp:
Feb 18, 2005, 12:46:26 AM (19 years ago)
Author:
anonymous
Comment:

Major rewrite and reorganization; hopefully fixed Fink install instructions

Legend:

Unmodified
Added
Removed
Modified
  • TracOnOsx

    v26 v27  
    1 = Installing and running Trac on Mac OS X =
     1This page describes three different ways of installing Trac on Mac OS X: by hand, by using Fink, and by using pkgsrc.
    22
    3 Fink (http://fink.sf.net/) can be used to install most of Trac's dependencies:
     3
     4= Installing By Hand (Without Fink) =
     5
     6If you don't have Fink yet or don't want it, you can build everything yourself from the source tarballs by following the instructions in TracOnOsxNoFink.
     7
     8
     9= Installing With Fink =
     10
     11If you already have [http://fink.sf.net/ Fink] and are comfortable using it, you may prefer to install Trac that way. But multiple people have noticed that SQLite currently won't install unless you enable [http://fink.sourceforge.net/faq/usage-fink.php?phpLang=en#unstable unstable packages] in Fink; the same goes for the handy trac-py23 package mentioned a little later on.
     12
     13== Updating Fink ==
     14
     15It's probably a good idea to start by making sure your Fink base system is the most current:
     16
    417{{{
    5  $ fink install sqlite sqlite-dev sqlite-shlibs
    6  $ apt-get install svn svn-client svn-swig-py23
    7 }}}
    8 If you are running Fink in unstable mode (http://fink.sourceforge.net/faq/usage-fink.php?phpLang=en#unstable), you can 'apt-get install sqlite sqlite-dev sqlite-shlibs' instead.
    9 
    10 Note that I had to have unstable enabled for the fink install sqlite... to work. JJ
    11 
    12 If you need to use a secure protocol with subversion, you need to install the -ssl variants:
    13 {{{
    14  $ apt-get install svn-client-ssl svn-ssl-swig-py23
     18$ fink selfupdate
    1519}}}
    1620
    17 The last two dependencies (pysqlite and clearsilver) can't be installed using fink,
    18 you have to download and install them manually.
     21When it's done it'll tell you to update the rest of your packages, but I think it's ok to defer that until a little later.
    1922
    20 '''trac-py23 fink package available'''
    21 Fink now has a package called trac-py23, so it can be installed in one command (make sure you are allowing unstable packages in fink preferences to make sure all dependencies are installed properly):
     23== Installing SQLite ==
     24
     25You can install SQLite this way:
     26
    2227{{{
    23  $ fink install trac-py23
     28$ fink install sqlite sqlite-dev sqlite-shlibs
    2429}}}
    2530
    26 == Clearsilver ==
     31Or, apparently, also this way:
    2732
    28 Download version 0.9.12 from http://www.clearsilver.net/. Compile it with Python
    29 support and install it in the fink prefix.
    3033{{{
    31  $ ./configure --prefix=/sw --with-python=/sw/bin/python2.3 --disable-ruby
    32  $ make install
     34$ apt-get install sqlite sqlite-dev sqlite-shlibs
    3335}}}
    34 You have to modify the hard coded /usr/local/bin/python path to /sw/bin/python2.3 (or /usr/bin/python if you're using the system Python)
     36
     37== Installing Subversion ==
     38
     39Assuming you want Subversion to support secure connections, install it this way:
     40
     41{{{
     42$ apt-get install svn-ssl svn-client-ssl svn-ssl-swig-py23
     43}}}
     44
     45If you'd rather dispense with the SSL, get the regular versions:
     46
     47{{{
     48$ apt-get install svn svn-client svn-swig-py23
     49}}}
     50
     51== Updating Fink Packages ==
     52
     53Now is I think an excellent time to have Fink update the rest of its installed packages:
     54
     55{{{
     56$ fink update-all
     57}}}
     58
     59I found that the above apt-get had given me somewhat elderly Subversion 1.0.6 binaries; after updating with Fink, I got the current (at the time of this writing) 1.1.3 version.
     60
     61== Installing Clearsilver, pysqlite, and Trac Itself ==
     62
     63It used to be that pysqlite and Clearsilver couldn't be installed using Fink;
     64instructions on how to manually download and install them are below.
     65Since then however a new Fink package has appeared which lets you
     66install these without much fuss:
     67
     68{{{
     69$ fink install trac-py23
     70}}}
     71
     72That should be all you need to do. You can now set up your [wiki:TracEnvironment Trac environment] as per the usual instructions. If you do end up needing to install pysqlite, Clearsilver and Trac manually after having installed the rest with Fink as above, read on.
     73
     74== Manually Installing Clearsilver ==
     75
     76Download version 0.9.12 of [http://www.clearsilver.net/ Clearsilver]. Compile it with Python
     77support and install it in the Fink prefix.
     78
     79{{{
     80$ ./configure --prefix=/sw --with-python=/sw/bin/python2.3 --disable-ruby
     81$ make install
     82}}}
     83
     84You have to change the hard-coded /usr/local/bin/python path to /sw/bin/python2.3 (or /usr/bin/python if you're using the system Python)
    3585on the first line of scripts/document.py when running {{{make install}}}.
    3686
    37 == pysqlite ==
     87== Manually Installing pysqlite ==
    3888
    39 The file {{{setup.py}}} in the pysqlite distribution doesn't recognize the darwin platform so you'll
    40 have to add the following lines to {{{setup.py}}} (it should be quite obvious where):
     89The file {{{setup.py}}} in the pysqlite distribution doesn't recognize the Darwin platform so you'll
     90have to add the following lines to {{{setup.py}}} (it should be quite obvious where, but don't put
     91it too late in the list of operating systems it checks):
     92
    4193{{{
    4294elif sys.platform == "darwin":
     
    50102
    51103After that modification the installation should simply be:
     104
    52105{{{
    53  $ /sw/bin/python2.3 ./setup.py install
     106$ /sw/bin/python2.3 ./setup.py install
    54107}}}
    55108
    56 == Installing Trac itself ==
     109== Manually Installing Trac Itself ==
    57110
    58111You should now be all set to install Trac using the TracInstall instructions. Make sure to use
     
    63116}}}
    64117
    65 and in your apache configuration:
     118and in your Apache configuration:
    66119
    67120{{{
     
    79132This will cause /usr/local/lib/svn-python/ to be permanently added to the Python search path.
    80133
    81 I had some problems getting Apple's personal web-server (Apache 1.3) to run trac.cgi with the correct
    82 python interpreter (/sw/bin/python2.3) so I placed this dummy {{{trac.cgi}}} in
     134If you have problems getting Apple's personal web sharing (a.k.a. Apache 1.3) to run trac.cgi with the correct
     135python interpreter (/sw/bin/python2.3), you can place this dummy {{{trac.cgi}}} in
    83136{{{/Library/WebServer/CGI-Executables/}}}:
     137
    84138{{{
    85139#! /bin/sh
     
    89143''This is required due to a bug in the way Python locates it's own library directory.  It is present in all versions of Python up to 2.3.4, but will be fixed in both 2.4 and 2.3.5.''  -- Mark Rowe
    90144
    91 Keep in mind that these instructions were written from the top of my mind and might be
    92 incomplete and contain some errors. If you find any errors please correct them by
    93 editing this page and/or contacting me -- [http://projects.edgewall.com/trac/wiki/JonasBorgstrom JonasBorgstrom]
     145These instructions were originally written off the top of
     146[wiki:JonasBorgstrom Jonas Borgstrom's] head, and rearranged
     147and rewritten quite a bit by Ryan Schmidt, and probably edited
     148and corrected by many others. If you find errors or omissions,
     149please edit the page and make the corrections. You can also
     150contact Jonas.
    94151
    95 == Alternative install methods ==
    96152
    97 === pkgsrc ===
     153= Installing using pkgsrc =
    98154
    99 As an alternative to fink and compiling by hand, you can install from pkgsrc (http://www.netbsd.org/Documentation/software/packages.html).  Yes, pkgsrc runs on Mac OS X just as well as it runs on NetBSD or Linux.
     155As an alternative to Fink and compiling by hand, you can install from [http://www.netbsd.org/Documentation/software/packages.html pkgsrc], which runs just as well on Mac OS X as it runs on NetBSD or Linux. See TracOnNetBsd for more information.
    100156
    101 See TracOnNetBsd for more information.
    102 
    103 === Installing without Fink ===
    104 
    105 If you prefer to build everything yourself from the source tarballs, without requiring Fink, see TracOnOsxNoFink.
     157Note that at least one person couldn't get this method to work at all.