2.8 - Updating the online modules [moveonline]

This section describes the procedure for updating moveonline online modules if they are hosted on a server at your institution. If the modules are hosted by QS unisolution, updates are carried out automatically by QS unisolution.

1. Update principle

Each update always includes all the changes already made. If you have not carried out certain interim updates you can simply install the latest update.

When you carry out an update, all existing parameter settings are retained and all existing data is saved.

If standard moveonline files (libraries and PHP/Java files) have been changed at your institution, please contact QS unisolution before carrying out the update.

2. Downloading and installing the update

The moveonline module update files can be downloaded from the moveon Community website at http://moveoncommunity.qs-unisolution.com..

Download the .zip file of the latest update and unpack its contents into the folder containg the move folder where moveonline is installed by replacing the corresponding sub-folders. The move/settings and move/data folders should be left unchanged.

After installing the files you must check the following rights:

• The web server needs to have read access to all the files installed.
• Read, write and execute access is required to the contents of the move/data/ directory.
• The move/libraries/fop/fop_0.93/libraries/fop file has to be executable (Unix/Linux servers only) [incoming and outgoing modules].

Then start the moveonline setup module. To do so, open the move/moveonline/setup/start.php file using your Internet browser. To access this page you will need to log in by entering the user name and password of the "moveonline_php" user for the moveonline database.

Once the access data has been entered correctly, the setup module checks the technical requirements for PHP and the database and the access rights to the various directories. If any errors are found, correct them and then click the Recheck system button. If no errors are found, click Next to open the installation/update page.

If an update is required, the Update button is enabled. Click this button to carry out the update. The update log is displayed in the next screen. Click Next to end the update.

3. Testing the modules

Once the update has been completed, the links to the various modules (outgoing, incoming, cooperations, exchanges and reports) are displayed at the bottom of the window. Click the Start button for each module to start it and check that it is working correctly.

4. Typical update under Linux

To update moveonline, the following commands have to be performed under Linux (if moveonline is installed in the directory /srv/www/htdocs/moveonline/ and the update to be installed is 3.0.15):

admin@sri:#cd /srv/www/htdocs/moveonline/
admin@sri:/srv/www/htdocs/moveonline#wget -c http://moveon.qs-unisolution.com/support/downloads/updates/moveonline_update_3.0.15.zip/download
admin@sri:/srv/www/htdocs/moveonline#unzip -o moveonline_update_3.0.15.zip
admin@sri:/srv/www/htdocs/moveonline#chmod g+x move/libraries/fop/fop_0.93/libraries/fop

You then just have to launch the setup module in your browser and click the button Update as described in part 2.

5. Particularities from version 3.0.17 onwards

In the modules incoming and outgoing, the application form is generated in PDF format using the Java FOP library. If the PDF generation did not work automatically after the initial installation of moveonline in your institution, the access path to Java may have been modified manually in the fop file. In this case, the access path must now be entered in the file settings.inc.php. To do so add the following line at the end of the file settings.inc.php:

define("FOP_PRECOMMAND", "export JAVA_HOME='/path/to/java/installation'");

This operation is only necessary if the generation of the PDF does not work after the update. Please contact QS unisolution in case of doubt.

6. Warranty

Whenever QS unisolution releases an update, the QS unisolution software warranty applies only to the new software version.