INSTRUCTIONS TO INSTALL IVA 1.1 =================================== IVA Installation guide ------------------ Required software: ------------------ Zope http://www.zope.org (prefer Zope 2.8) CMF http://cmf.zope.org BTreeFolders2 http://hathawaymix.org/Software/BTreeFolder2/BTreeFolder2-1.0.1.tar.gz SecureMailHost http://plone.org/products/securemailhost --------------------- Recommended software: --------------------- PyXML http://pyxml.sourceforge.net/ PlacelessTranslationService http://sourceforge.net/projects/collective/ 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.36.2 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. 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. -------------------- Setting up sessions. -------------------- From IVA 0.7, statistics machinery is changed and is using session to store user actions in IVA. First statistics is stored in user session. When user logs out or closes browser it's session hangs around until it times out and then it will be stored. By default Zope will just drop timed out session so you'll have to set it up. 1. First you'll have to create python script in zope. In ZMI Add Script (Python) from dropdown menu anywhere you like. Add an id to script, click 'Add and Edit' button and on the next screen fill in Parameter List: sess,sessContainer --- Script start --- iva_paths = sess.get('iva_paths', []) if iva_paths: # it's IVA. otherwise it's something else and should be handled differently for x in iva_paths: path = x.split('/') iva = context for y in path: if not y: continue iva = getattr(iva, y) iva.Statistics.saveStats(sess.get(x, {})) --- Script end --- * You have to set proxy role to Manager in Proxy tab * Note that you have to keep indent otherwise it will not work. If you already have some session delete script then you'll propably want to merge these scripts. Edit zope.conf file and set following directives: * session-delete-notify-script-path put the created script's full path here. For example, if you added script in root folder with id 'sessionDeleteScript' then full path would be /sessionDeleteScript * session-timeout-minutes User's session will expire after this amount of minutes and script executed * session-resolution-seconds See comment in zope.conf * maximum-number-of-session-objects Maximum number of session objects. Don't set this too low or users can't log in and use IVA properly. After zope's restart confirm these setting in ZMI /temp_folder/session_data (assuming you have't changed the temp_folder's location in zope.conf) -------------- Edit zope.conf -------------- edit zope.conf file and add following lines: %import Products.iva.timer interval 300 This enables timerserver in zope and tells it to check after every 5 minutes(300 seconds) if there are scheduled tasks to run. This itself doesn't do anything else but checking and executing tasks Tasks have their own intervals and they will not be run too frequently. 300 seconds is recommended. Setting this too big may cause some tasks not to run when they should. 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.