Developers installation guide - Other

1 Required software
2 Python packages
- 2.1 Verify the packages are installed
3 Configure OOo
4 Source code
5 Configure ICE
- 5.1 Add a SVN repository
- 5.2 Add document templates

Due to the multiple number of other operating systems this document is a guide for installing the ICE source code and its dependencies.

1 Required software

You will need to install and configure the following software:

OpenOffice.org (use 2.3, see issue #87948 for more info)

Subversion (1.4.6 recommended)

Python 2.5

2 Python packages

Download and install the following packages:

Name	URL	Version
Image	http://www.pythonware.com/products/pil/	PIL 1.1.5
libxml2 libxslt	http://xmlsoft.org/python.html	libxml 2.6.30+, libxslt 1.1.22+ for python 2.5
pysvn	http://pysvn.tigris.org/project_downloads.html	PySVN 1.5.3 for python 2.5 and svn 1.4.6 installation kit
Cheetah templates	http://www.cheetahtemplate.org/	2.0.1
PyLucene	http://pylucene.osafoundation.org/	2.1.0 for Python25
Paste	http://pythonpaste.org/download/
Gdata	http://code.google.com/p/gdata-python-client/downloads/list	(Required for Atom Publishing)

2.1 Verify the packages are installed

The Python packages can be verified by:

run python

>>>import Image
>>>import libxslt
>>>import libxml2
>>>import pysvn
>>>import Cheetah
>>>import PyLucene
>>>import paste
>>>import gdata

3 Configure OOo

Open Configure OpenOffice.org
When the document loads select enable macros.
From the menubar select ICE...Change port
Enter 2002
Close the document and restart the application

4 Source code

Checkout the source code:

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

Run ICE from the source
```
cd ice-source/apps/ice
python ice2.py
```

5 Configure ICE

5.1 Add a SVN repository

Start the ICE server
Go to Start…Program Files…ICE 2.0…ICE server
Go to http://localhost:8000, the ‘Config editor’ page will load
Enter a SVN URL in the ‘New repository URL:’ field or fill in the information required under ‘Advanced repository settings’
Click ‘Save’ and then click ‘Close editor’.
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. In order to use the ICE templates affectively also install the word processor toolbars.

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
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.