About this document

Purpose

This document describes the installation of ICE on Mac OS X 10.6.4 with native Python 2.6.1. For inclusion of conversion services, please see ICE-Service information.

Audience

Software developers and users with a technical knowledge of Mac OSX.

Requirements

This document assumes knowledge of basic command-line tools.

You will need root access to your system in order to install the required software.

Note

Proxy users: SVN access to content (installation packages or ICE repositories), may require changing the SVN proxy settings inside the SVN server setting files when switching between accessing an internal svn repository and an external svn repository.

References

For more detailed information about Subversion repositories see the Subversion website at http://subversion.tigris.org

This version date

June 10, 2010

1 Required software

OpenOffice.org

Download and install OpenOffice.org

2 Install packages

Before doing any installing make sure you have Xcode installed, it is available on your OS disk and is needed to build the packages.

The packages need to be compiled and installed as 32-bit in order to be compatible with OpenOffice.org PyUNO. This can be done by using the following environment variable.

export VERSIONER_PYTHON_PREFER_32_BIT=yes

2.1 pysvn 1.7.2

curl -O http://pysvn.barrys-emacs.org/source_kits/pysvn-1.7.2.tar.gz

tar zxvf pysvn-1.7.2.tar.gz

cd pysvn-1.7.2/Source

python setup.py backport

python setup.py configure --arch=i386

make

sudo mkdir /Library/Python/2.6/site-packages/pysvn

sudo cp pysvn/__init__.py /Library/Python/2.6/site-packages/pysvn

sudo cp pysvn/_pysvn_2_6.so /Library/Python/2.6/site-packages/pysvn

2.2 libxml2 (system version)

export LIBXML2_VERSION=`xml2-config --version`

curl -O http://xmlsoft.org/sources/libxml2-$LIBXML2_VERSION.tar.gz

tar zxvf libxml2-$LIBXML2_VERSION.tar.gz

cd libxml2-$LIBXML2_VERSION/python

unset LIBXML2_VERSION

sudo python setup.py install

2.3 libjpeg (for PIL)

curl -O http://www.ijg.org/files/jpegsrc.v8a.tar.gz

tar zxvf jpegsrc.v8a.tar.gz

cd jpeg-8a

./configure CFLAGS="-arch i386"

make

sudo make install

2.4 ImageMagick

http://www.imagemagick.org/script/binary-releases.php#macosx

(put in PATH)

2.5 ExifTool

http://www.sno.phy.queensu.ca/~phil/exiftool/ExifTool-8.16.dmg

2.6 PyLucene 3.0.1-1

curl -O http://apache.etoak.com/lucene/pylucene/pylucene-3.0.1-1-src.tar.gz

tar zxvf pylucene-3.0.1-1-src.tar.gz

cd pylucene-3.0.1-1/jcc

python setup.py build

sudo python setup.py install

cd ..

vi Makefile

(uncomment Mac OS X  (Python 2.5, Java 1.5) section)

make

sudo make install

2.7 Foresite

wget http://foresite-toolkit.googlecode.com/files/foresite-1.2.tgz

tar xzvf foresite-1.2.tgz

cd ${FORESITE_SRC_DIR}

sudo python setup.py install

2.8 Python-Openid

http://github.com/openid/python-openid/downloads and download tarball

Unpack tarball and cd into directory

sudo python setup.py install

2.9 Py2app

We used version 0.4.4

svn co http://svn.pythonmac.org/py2app/py2app/trunk/ py2app

cd py2app

sudo python setup.py install

2.10 Easy install remaining packages

curl -O http://peak.telecommunity.com/dist/ez_setup.py

sudo python ez_setup.py -U setuptools

sudo easy_install -Z pil cheetah paste gdata py2app reportlab lxml==2.2.6 rdflib pycurl pypdf textile

2.11 Verify the packages are installed

The Python packages can be verified by:

python
import lxml
import textile
import openid
import rdflib
import foresite
import gdata
import libxml2
import lucene
import paste
import py2app
import pysvn
import Cheetah
import Image
import reportlab
import pycurl
import pypdf

3 Configure OOo

1. Open Configure OpenOffice.org

2. Click OK to enable macros.

3. Change Macro settings to Medium or Low

   Tools > Options > Security > Macro Security > Select Medium or Low > OK

4. Restart OpenOffice

5. From the menu, select ICE...Change port

6. Enter 2002

7. Close the document

8. Restart the OpenOffice

9. To edit documents using ICE styles install the word processor toolbars.

4 Source code

1. Checkout the source code:

   svn co http://ice.usq.edu.au/svn/ice/trunk ice-source

2. Run ICE from the source

   cd ice-source/apps/ice
   ./ice.sh

5 Configure ICE

ICE uses a subversion repository to access it's content for editing, you will need to have the URL for the location of the subversion repository before proceeding.

See how to setup an ICE repository.

5.1 Configure ICE

1. Start the ICE server – see 4 (above)

2. Go to http://localhost:8000/edit-config

   Config editor page will load

3. Enter SVN URL in the ‘New repository URL:’ field or fill in the information required under ‘Advanced repository settings’

4. Click ‘Save’ and then click ‘Close editor’.

5. Enter your username and password for the SVN URL provided.

   ICE will then checkout the content from the given SVN URL.

5.2 Add document templates

Before you can create documents using ICE you will need to add some ICE templates.

1. Create a folder called ‘templates’ in the root of your repository. For example if your content was located in ~\ICE\MyFiles make the directory ~\ICE\MyFiles\templates

2. Download either an OpenOffice.org template (Default.odt) and/or Word template (Default.doc) into the templates directory you just added. Change these files or add others into the template directory as required.

   You should now be able to create new files using the “Add” tab in ICE.