1 Required software

You will need to install and configure the following software:

OpenOffice.org

Subversion (minimum 1.5.3)

Python2.5

2 Install and Configure OpenOffice.org

1. Download OpenOffice.org 3.1 (Don’t use 2.4, see issue #89428).

2. Install OpenOffice.org, use the default settings.

Install Toolbar

1. Download and install ICE Toolbar

Configure OpenOffice.org

1. Open a Text Document in OpenOffice.org

2. Set Port

   1. From the ICE Toolbar, select Help

   2. Click Change Port

   3. Type 2002 in the text box

   4. Click OK

   5. Close the document and restart OpenOffice.

3. Change security setting.

   1. Open OpenOffice.org

   2. Select Tools

   3. Choose Options

   4. Under the OpenOffice.org option, choose Security

   5. Under Macro security section, click Macro Security

   6. Under Security Level tab, ensure Medium is selected

   7. Click the OK button twice to close options

3 Install and Configure Python2.5

1. Install Python 2.5 using installation wizard

2. Add the Python path to your computer:

   1. My Computer > System Properties > Advanced > Environment Variables.

   2. Find “Path” from the list and click on Edit

   3. Add C:\Python25 to the end of the list.

3.1 Installation packages

We recommend that our pre-made site-package directory be downloaded for all Windows compatible python libraries, alternatively they can be installed individually.

3.1.1 Download complete site-packages

1. Download zip file from site-packages

2. Unzip site-packages.zip into C:\Python25\Lib\

3. Check installation is successful

3.1.2 Download individual packages

Download installation packages into a single directory ( C:\packages_for_install )

cd C:\

mkdir packages_for_install

Easy Install

http://peak.telecommunity.com/dist/ez_setup.py

Paste

http://pypi.python.org/packages/2.5/P/Paste/Paste-1.6-py2.5.egg#md5=8171bddf46ebfc8c144d61262ff8544f

Cheetah

http://optusnet.dl.sourceforge.net/sourceforge/cheetahtemplate/Cheetah-2.0.1.tar.gz

Cheetah compiled namemapper

http://cheetahtemplate.org/_namemapper.pyd2.5 and rename to _namemapper.pyd2.5 (remove the version number from the end) and install it wherever your system puts Cheetah/NameMapper.py.

Gdata

http://gdata-python-client.googlecode.com/files/gdata.py-1.0.11.zip

Libxml2 and Libxslt

http://users.skynet.be/sbi/libxml-python/binaries/libxml2-python-2.6.30.win32-py2.5.exe

Image

http://effbot.org/downloads/PIL-1.1.6.win32-py2.5.exe

PySvn

http://pysvn.tigris.org/files/documents/1233/41264/py25-pysvn-svn146-1.5.3-904.exe

PyLucene

http://pylucene-win32-binary.googlecode.com/files/PyLucene-2.3.0-1.win32-py2.5.exe

JRE

Ensure current jre is installed from www.java.com

pyCurl

http://pycurl.sourceforge.net/download/pycurl-ssl-7.16.4.win32-py2.5.exe

reportLab

http://www.reportlab.org/ftp/reportlab-2.3.win32-py2.5.exe

py2exe

http://sourceforge.net/project/showfiles.php?group_id=15583

foresite

http://foresite-toolkit.googlecode.com/files/foresite-1.1.tgz

rdflib

http://rdflib.net/rdflib-2.4.1.tar.gz

3.1.3 Install packages

Open a command window and change to the directory where you have downloaded all of these packages.

cd C:\packages_for_install

ez_setup

python ez_setup.py

Paste

c:\Python25\Script\easy_install Paste-1.6-py2.5.egg

Cheetah

Unzip Cheetah into its own directory.

cd Cheetah-2.0.1

python setup.py install

Textile

easy_install -Z textile

Gdata

Unzip gdata into its own directory.

cd gdata.py-1.0.11

python setup.py install

OpenID

easy_install -Z python-openid

pyPdf

easy_install -Z pyPdf

foresite

Unzip foresite into its own directory.

cd foresite-1.1

python setup.py install

rdflib

rdflib on Windows is a more complicated and requires the use of cygwin's ming32 compiler. See instructions for SetupOnWindows

3.2 Verify the packages are installed

The Python packages can be verified by:

python

Type "help", "copyright", "credits" or "license" for more information. 
>>> import Image 
>>> import libxml2 
>>> import pysvn 
>>> import Cheetah 
>>> import paste 
>>> import gdata 
>>> import py2exe 
>>> import pyPdf 
>>> import openid 
>>> import gdata 
>>> import textile 
>>> import rdflib 
>>> import foresite 
>>> import lucene 
>>> import curl 
>>> import reportlab

4 Source code

1. Checkout the source code:

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

2. Run ICE from the source

   cd ice-source/apps/ice
   python ice2.py

5 Configure ICE

1. Go to http://localhost:8000, and a configuration page will load

2. Add subversion repository

5.1 Add document templates

1. Create a folder called templates in the root of your repository. If your content is located in C:/ICE/MyFiles, create C:/ICE/MyFiles/templates

2. Download either an OpenOffice.org template (Default.odt) and/or Word template (Default.doc) into C:/ICE/MyFiles/templates.

3. These template files form the basis of ICE documents, they can be changed or others added, as required.