Installing LeMill on Mac OS X 10.5
In this learning resource we describe in a details how to install LeMill on Mac OS X 10.5. These guidelines are ment for people who want to install the development version of LeMill and all the software that is required by LeMill to their laptop or desktop. If you are a system administrator who wants to install LeMill on a server you should look at the official INSTALL.txt.
Technically LeMill is a customization of content management system Plone which requires Zope and Python. LeMill has been developed since 2005 and it does not currently support the latest versions of Plone (and Zope and Python). Several combinations of older versions are tested and supported. For Mac OS X 10.5 we suggest the following combination:
- Python 2.4.4
- Zope 2.9.10
- Plone 2.5.3
During the installation of these components you need to use a compiler to compile Zope. To test if you have a compiler you should type the following command to the Terminal:
gcc -dumpversion
As a result the system should display the version of gcc compiler or an error message. Mac OS 10.5 developer tools contain gcc compiler version 4.0.1. If you get an error message, then you should install XCode Tools. You will find the installer from the Mac OS X Install Disc that came with your computer. You can follow the default options when installing XCode Tools. If you need more detailed help to install the compiler, then you can read the "How do I install Apple Developer Tools on my Mac?" by Dave Taylor.
Installing Python and related libraries
Mac OS X 10.5 comes with Python 2.5.1 installed. This version is not suitable for LeMill. You have to download and install Python 2.4.4 and Python Imaging Library 1.1.5. Ready-made binary packages can be downloaded from:
- http://pythonmac.org/packages/py24-fat/dmg/python-2.4.4-maco
sx2006-10-18.dmg - http://pythonmac.org/packages/py24-fat/dmg/PIL-1.1.5-py2.4-m
acosx10.4.dmg
These packages contain standard OS X installers, so you can install them by following the default options.
The second Python library that you have to add is ElementTree. There is no binary package, so you have to build it from the source code. Copy the following lines to the Terminal:
cd ~/Downloads
curl -O http://effbot.org/media/downloads/elementtree-1.2.6-20050316 .tar.gz
tar -xvzf elementtree-1.2.6-20050316.tar.gz
cd elementtree-1.2.6-20050316
/usr/local/bin/python setup.py install
Installing Zope
After installing Python you can continue by downloading, compiling and installing Zope. For that you should copy the following lines to the Terminal:
cd ~/Downloads
curl -O http://www.zope.org/Products/Zope/2.9.10/Zope-2.9.10-final.t gz
tar -xvzf Zope-2.9.10-final.tgz
cd Zope-2.9.10-final
./configure --with-python=/usr/local/bin/python --prefix=/opt/Zope-2.9.10
make
sudo make install
After installing Zope you should set up a Zope instance. You must enter the following command to the Terminal to do that:
sudo /opt/Zope-2.9.10/bin/mkzopeinstance.py
Then Zope will ask for the location of the instance, username and password. We suggest the following directory and username:
Directory: ~/zope-2.9.10/
Username: root
Password:
Verify password:
Next you should change the owner for Zope instance. Replace username with your username:
cd ~/zope-2.9.10/
sudo chown -R username .
When that is done you can run Zope from the Terminal:
~/zope-2.9.10/bin/runzope
Start a web browser on the same machine on which you installed Zope and visit the URL http://localhost:8080/. If everything went correctly you should see the Zope Quick Start page.
Installing Plone
When you have installed Zope successfully you can continue with installing Plone. To do this you should copy the following lines to the Terminal:
cd ~/Downloads
curl -O https://launchpadlibrarian.net/10618346/Plone-2.5.3-final.ta
r.gz
tar -xvzf Plone-2.5.3-final.tar.gz
mv Plone-2.5.3-final/*/ ~/zope-2.9.10/Products/
Next you should restart Zope so that it will recognize Plone. Press Ctrl+C in the Terminal window where Zope is running and start the Zope again. If the Plone installation was successful you will see a lot of new products (including Plone Site) in the select menu at http://localhost:8080/manage.
Installing Subversion
To get the latest development version of LeMill you must have a Subversion client. It can be downloaded from http://www.collab.net/downloads/community/ and installed with a typical OSX installer application.
Getting the latest LeMill code
To get the latest LeMill code you should move to the Products folder of your Zope instance and do the checkout:
cd ~/zope-2.9.10/Products/
svn checkout https://lemill.org/svn-cal/trunk LeMill
Installing LeMill
Using your browser go to the ZMI (Zope Management Interface) at http://localhost:8080/manage. On the main window, open the drop-down menu on the right and select "Plone Site" to create a new Plone environment. In the following form you will choose the id for the environment (it can be "lemill"). You must also select from the "Extension Profiles" box the profile "LeMill" so that instead of a normal Plone site you get a LeMill site. After this you should be able to access your LeMill by going to http://localhost:8080/lemill (if you entered "lemill" as an id).
Congratulations, now you can start exploring the latest version of LeMill!
