ILIAS-7-Install-Tutorial for Ubuntu 20.04

Server, ILIAS and PlugIns

The Ubuntu server

  • You should update the Ubuntu server monthly:
    • apt-get update
    • apt-get upgrade
  • Upgrade ILIAS <7
    • cd /var/www/html/ilias
    • git stash
    • git pull
      • Only ILIAS 6.x :
        • cd /var/www/html/ilias
        • composer -d libs/composer install
    • Update all Languages in Adminstration
    • Update Database via https://bbs-ilias.de/ilias/setup/setup.php
  • Update ILIAS itself (ILIAS 7.x)ILIAS can be updated via git very simply:
    • cd /var/www/html/ilias
    • git config --global --add safe.directory /var/www/html/ilias
    • git stash
    • git pull
    • composer install --no-dev
    • phpĀ setup/setup.php update
    • php setup/setup.php migrate
  • If git pull was aborted, try: git stash and then git pull again

How to handle failed Updates

  • The following message indicates, that a migration failed:
    • ilFileObjectMigrationAgent.ilFileObjectToStorageMigration: Migration of File-Objects to Storage service [remaining steps: 173]
    • Try:Ā php setup/setup.php migrate --run ilFileObjectMigrationAgent.ilFileObjectToStorageMigration --steps 173

Update ILIAS PlugIns (outdated sincs ILIAS >6)

  • ILIAS plugins can be updated like ILIAS itself via git. Some examples:
    • cd Customizing/global/plugins/Services/UIComponent/UserInterfaceHook/
    • git pull
    • If git pull aborts, try git stash and git pullĀ again
  • After every update of ILIAS or ILIAS plugins, run /opt/scripts/checkrights
  • You must update the languages in Administration->languages and Administratin->PlugIns (it seems this is not necessary since 7.x)

Error handling

  • Errors with migrate command
    • Please checkout the error handling in chapter Upgrades


No comment has been posted yet.