2    

ILIAS 6 and 5.4 Install-Tutorial for Ubuntu 18.04

Server and ILIAS Upgrades

Server Upgrades

  • When the Ubuntu version gets outdated and you want do a release upgrade, do not upgrade the virtual server (VPS)! Get instead a new server, install everything nad then move your files like described her (Chapter 6).

ILIAS Upgrades to a higher Version

Checkout PlugIn versions

If you need to run a plugin, you should only uprade ILIAS if the current plugin supports the new version. You should update the specific plugins like described in the chapter above and then have a look in the file plugin.php:

$ilias_min_version = "5.3.0";
$ilias_max_version = "5.4.999";

This means, the plugin can not be used for ILIAS 6 or higher. In this case, you should wait until the new version is available.

Update PlugIns

  • To update the plugins, go to every folder in /var/www/html/ilias/Customizing/global/plugins and rund the following command:
    • git pull
    • If you get a stash error, run git stash before

If you run the PlugIn ctrlmainmenu, be aware that this PlugIn will not be available for ILIAS 6. So write down your menu structure and reconstruct is the the ILIAS menu editor that came with 5.4.

  • If you get the following error, you did not deactivate the plugin as I said
    • "File : ./Customizing/global/plugins/Modules/TestQuestionPool/Questions/assStackQuestion/classes/class.ilassStackQuestionPlugin.php . does not Exist for plugin: assStackQuestion Check if your plugin is still marked as active in the DB Table 'il_plugin' but not installed anymore."
      • cd /var/www/html/ilias
      • mkdir -p Customizing/global/plugins/Modules/TestQuestionPool/Questions
      • cd Customizing/global/plugins/Modules/TestQuestionPool/Questions
      • git clone https://github.com/ilifau/assStackQuestion.git
  • You can also manually disable the plugins in the database table "ilplugin" using phpmyadmin
  • Deactivate all PlugIns before proceeding in ILIAS
  • Consider to uninstall all plugins that are not repository plugins in ILIAS (you can reinstall them later)

Backup the database

There is only one part in the upgrade process that can not get undone: The database upgrade. So you should backup it before:
  • Disable the client in ilias/setup/setup.php
  • Get the database credentials: nano /var/www/html/ilias/data/info/client.ini.php
  • mysql
  • mysq>CREATE DATABASE ilias_db_backup CHARACTER SET utf8 COLLATE utf8_general_ci;
  • mysql>GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON ilia_dbs_backup.* TO 'iliasdbuser'@'localhost';
  • mysql>exit
  • Copy content to new Database: mysqldump ilias_db | mysql ilias_db_backup
  • Change the database name in /var/www/html/ilias/data/info/client.ini.php to the name ilias_db_backup for to test if the database would do its job.
  • Got to ilias/setup/setup.php and have a look to the registercard database of your client. There should  be something like "Your database is up-to-date."  that shows, that the database seems to be OK.
  • Copy the original ILIAS database to a file for backup reasons: mysqldump ilias_db > ilias_db.sql
  • Rename the database name in the client.ini.php to the originally name and start the upgrade process
  • Enable the client in ilias/setup/setup.php
  • Check if everything runs normal

Upgrade ILIAS

  • cd /var/www/html/ilias
  • Have a look at the current branch: git branch
  • List all available branches: git branch -r
  • Choose a branch (here release 6): git checkout release_6
  • git pull
  • Go to ilias/Setup/setup.php to perform datase updates
  • Enable the client
  • Login to ILIAS and perform language updates in Administration->Languages and Administration>PlugIns

It you upgrade ILIAS from 5.4 or later to 6 or higher

  • Install Composer
    • apt-get install composer
    • cd /var/www/html/ilias
    • composer install --no-dev

After the upgrade do not forget to update all used languages in Administration->Languages



Information Message
No comment has been posted yet.