INSTRUCTIONS TO INSTALL IVA 1.1
===================================

IVA Installation guide

------------------
Required software:
------------------
Zope 2.10.x                         http://www.zope.org
CMF 2.x                             http://cmf.zope.org 
SecureMailHost 1.1                  http://plone.org/products/securemailhost
PlacelessTranslationService 1.4.x   http://plone.org/products/pts

mysql-python    http://sourceforge.net/projects/mysql-python
ZMySQLDA        http://sourceforge.net/projects/mysql-python
MySQL 5.0.1 or higher               http://www.mysql.com

---------------------
Recommended software:
---------------------
PyXML                       http://pyxml.sourceforge.net/
PIL	                        http://www.pythonware.com/products/pil/ 
                                with jpeg and freetype-2 support
	                        jpeg-6b libraries can be found at ftp://ftp.uu.net/graphics/jpeg/
                                freetype-2 can be found from http://freetype.sourceforge.net
                                Please refer to PIL INSTALL document for details.
ZWiki	                        http://www.zwiki.org (Currently, ZWiki 0.60.0 recommended)

It is strongly advised to install these packages.

----------------------------
Software needed by WordMaps:
----------------------------
TeX 		3.14159 (Web2C 7.3.1)
LaTeX2e		<2000/06/01> (Included with most TeX distributions)
dvips		dvipsk 5.86 (Included with most TeX distributions)
GhostScript	6.52 (2001-10-20)
Netpbm		9.24

If you don't install these then only one little part of wordmaps don't work otherwise it's ok.


General installation procedure consists of four steps:

1. See that your system has installed Python (preferrably ver.2.3) and Zope (preferrably ver. 2.8.1).
2. Install IVA product on your Zope server. 
3. Configure IVA
4. Install an instance of IVA on your Zope server.
If you have already Zope installed on your system, skip the step 1 (however, need to check the version compatibility as with Python).

Detailed guidelines for installation:

Step 1. Install Zope and all required software
==============================================

Download Zope from http://www.zope.org/Products 
Please see zope installation instructions.
Install recommended software. You'll have to consult with each package's installation instructions but
general rule: Zope products go into zope's products directory and others are installed into system.
Note that IVA works fine without PIL, PyXML and CMF but then some features may give errors or are disabled.
PIL is used in various places all over IVA, PyXML is only for import-export functionality.

Setting up MySQL
----------------
Starting from IVA 1.3, MySQL server is a required component.
You need to have MySQL 5.0.1 or higher.
Follow these steps:
* create database:
  example: create database iva;
* create user:
  example: GRANT ALL PRIVILEGES ON iva.* TO 'iva'@'localhost' IDENTIFIED BY 'secretpassword';

Installing mysql-python and ZMySQLDA
------------------------------------
mysql-python is a python package. usually installed with the 
following command: python setup.py install
ZMySQLDA is a Zope package. place ZMySQLDA folder in to Products folder.

Step 2. Install IVA product
===========================

Download the latest IVA tarball at http://www.htk.tlu.ee/iva
Unpack it to a temporary directory - tar xfzv iva-0.7.1.tgz 
Move created directories to zope products directory (typically /usr/local/zope/lib/python/Products)

Step 3. Configuring IVA
=======================

--------------
Edit config.py
--------------
Go to iva directory
Rename or copy config.py.templ to config.py
Edit config.py file inside iva directory.
Restart Zope: inside the Zope Management Interface, or ZMI (typically http://localhost:8080/manage), click on Restart button under Control Panel.

Step 4. Install an instance of IVA
==================================

Restart Zope: inside the Zope Management Interface, or ZMI (typically http://localhost:8080/manage), click on Restart button under Control Panel.
Log into Zope Management Interface (typically http://localhost:8080/manage) as manager. 
Create an instance of IVA by selecting IVA from pull-down menu Select type to add... 
Select settings for new IVA instance and click Add.

Configure MySQL connection inside IVA
-------------------------------------
After adding IVA you will be redirected to page where you can configure MySQL connection parameters.
Fill it, save it and you're done.