Required software: See INSTALL file for a list of required software Upgrading from 1.3 to 1.4.x =========================== 1. make backup - always recommended 2. migrate variables from config.py.templ to config.py 2. unpack iva in to zope's products directory, replacing old IVA files. Restart zope. 3. in ZMI go in to IVA folder and click 'Tools' tab located on top-left corner. 4. In ZMI go to Tools tab and click links under "Upgrading IVA from version 1.3 to 1.4" section Upgrading from 1.1 to 1.3 ========================= 1. make backup - recommended 2. edit zope.conf file and make following changes: * remove following lines %import Products.iva.timer interval 300 * delete session-delete-notify-script-path directive 3. Install any required software listed in INSTALL file 4. See section "Setting up MySQL" in INSTALL file 5. In ZMI go to Tools tab and click links under "Upgrading IVA from version 1.1 to 1.3" section Step 1 may take a long time to finish Step 2 must not fail Step 3 - special attention to MySQL configuration part Upgrading from 1.0 to 1.1 ========================= 1. make backup - recommended 2. remove all scheduled jobs related to IVA 2. See section "Edit config.py" in INSTALL file 3. See section "Edit zope.conf" in INSTALL file 4. In ZMI go to Tools tab and click links under "Upgrading IVA from version 1.0 to 1.1" section 5. restart zope, done Upgrading from 0.7.4 to 1.0 ============================= 1. make backup - strongly recommended. 2. See section "Edit config.py" in INSTALL file 3. See section "Setting up cronjob" in INSTALL file If you already have cronjob set up for IVA then the least you must do is upgrading the script file Note: If you are upgrading to 1.1 skip this 4. In ZMI go to Tools tab and click links under "Upgrading IVA from version 0.7.4 to 1.0" section 5. reload everything Upgrading from 0.7.2 to 0.7.4 ============================= 1. unpack iva in to zope's products directory, replacing old IVA files. 2. restart zope 3. in ZMI go in to IVA folder and click 'Tools' tab located on top-right corner. 4. click on reload everything link and links under "Upgrading IVA from version 0.7.x to 0.7.2" section 5. set up some scheduler - crontab on unix and scheduled task on windows for example. Python script "save_iva_stats" is in util folder, edit this and modify as you need Schedule this script to be run in every half an hour for example. You can also execute this script by command line and then go to Zope's instance home var/iva_stat folder and verify that all 4 files have accurate timestamps. See INSTALL document for crontab example of how to set up cronjob Upgrading from 0.7.1 to 0.7.2 ============================= I assume you already have IVA downloaded from http://www.htk.tlu.ee/iva 1. unpack iva in to zope's products directory, replacing old IVA files. 2. restart zope 3. in ZMI go in to IVA folder and click 'Tools' tab located on top-right corner. 4. click on reload everything link and links under "Upgrading IVA from version 0.7.x to 0.7.2" section Upgrading from 0.7 to 0.7.1 =========================== I assume you already have IVA downloaded from http://www.htk.tlu.ee/iva 1. unpack iva in to zope's products directory, replacing old IVA files. 2. restart zope 3. in ZMI go in to IVA folder and click 'Tools' tab located on top-right corner. 4. click on reload everything link and links under "Upgrading IVA from version 0.7 to 0.7.1" section Upgrading from IVA 0.6.1 to 0.7 =============================== Upgrading to IVA 0.7 is divided into two parts: 1. Exporting data from your old IVA 2. Importing data to your new IVA Preparations. Assuming that you have IVA server up & running, first thing to start the upgrade procedure is to restrict the access to IVA by all other users (this can be done by stopping Zope instance and restarting it on another port, for instance). This allows you to make a backup of data.fs file and Products folder. If something goes wrong or upgrading fails you can restore the service using these backups. Exporting data from IVA 1. Since IVA 0.6.1 exporting engine was somewhat incomplete you have to download iva-0.6.1-upgrader.tar.gz from http://www.htk.tlu.ee/iva 2. Unpack it into Zope's Products directory, replacing some files in Products/iva folder. Now restart your Zope instance. 3. When Zope is running again, enter Zope Management Interface (ZMI), open IVA folder and click on the 'Tools' tab located in top-right corner. Now click on the button 'Reload everything'. 4. Under 'Tools' tab, you should export three things: * user inner-mail messages * user events * IVA settings. 5. Now you should export all courses. There are two places you can do that. a) under 'Tools' tab, click on course name b) alternative would be to open Management section od IVA and click on the link Course Management in left menu, select the courses you want to export and click the Export button. Exported course contents will be stored as Zip-files - one zip per course - in to Zope's var directory 6. Things you have to export manually: * Knowledge types (under Knowledge Type Management in Management section of IVA) * images on the frontpage (located in images/frontpage folder in ZMI) If you have changed something, export or save them manually. Importing data to upgraded IVA instance 1. First, you should install IVA as described in installation guide (INSTALL.TXT). Note that installation guide says it's ok not to install PyXML but in case of upgrading from an older version of IVA, it is obligatory to have also PyXML installed. PIL is also strongly recommended. 2. From previous step you got bunch of zip-files - move them to your zope's import directory. 3. under course management section, first import iva server settings then courses and finally user's events and inner-mail messages. 4. Now you need to move some stuff from users assignments folder to it's webtop. type in url: http://you.server.address/iva_path/fle_users/migrate_portfolio eg. http://www.example.com:8080/IVA/fle_users/migrate_portfolio You need to run it only once. It tells you 'done' if operation was successful, if not, send us error message from error_log. Upgrading from IVA 0.6 to 0.6.1 =============================== I assume you already have IVA downloaded from http://www.htk.tlu.ee/iva 1. unpack iva in to zope's products directory, replacing old IVA files. 2. restart zope 3. in ZMI go in to IVA folder and click 'Tools' tab located on top-right corner. 4. click on reload everything button Upgrading from IVA 0.4.2 to IVA 0.6 =================================== We recommend creating a new Zope instance for testing the upgrade ... as there may occur some errors. Step 1. From http://www.htk.tlu.ee/iva download IVA 0.4.2 upgrader, basically it is IVA 0.4.2 with some extra export functionality. Unpack it to zope's products directory, replacing the IVA 0.4.2 installation. Restart your zope and under ZMI in IVA folder, click Tools tab and click on courses you wish to have in your new IVA. If you have many courses and you need them all, then you can use tools like wget to export all courses. Step 2. Now you should have many zip files in your zope's var directory. Move these zip files to your zope's import directory(../import). Download IVA from http://www.htk.tlu.ee/iva, unpack it to your zope's products directory, replacing the previous IVA directory. Better, remove the old IVA directory and then unpack the IVA 0.6 to there. Restart Zope. Log in to ZMI and add IVA. Now you should have a brand new IVA instance. For importing courses, in IVA, click 'Courses management' -> 'import course' and the top of the page, you can upload a zip file. Under that, there is a list of zip files. Note that, if you import one zip/course twice, you get two courses. Also, there are two zip files - ivamessages.zip and iva_events.zip. First zip holds Users mailboxes and second zip contains users events.