ILIAS 8 Install Tutorial for Ubuntu 22.04

Prepare the servers

Lets have a look how we can transfer our ILIAS data from an old Ubuntu 16.04 to a new 18.04 

DNS-Settings

  • You have to servers with different IPs
  • Set the following subdomains:
    • The IP of the old source server:
      • 16.bbs-ilias.de
    • The IP of the new target server:
      • 18.bbs-ilias.de
      • chat18.bbs-ilias.de
      • pad18.bbs-ilias.de
      • etc.

Wait at least 24 hours

Prepare the source Server

  • Create a vhost for the subdomain 16.bbs.ilias.conf. Just copy the existing bbs.ilias.conf to 16.bbs.ilias.conf and change the first and the buttom lines
  • Enable the file
  • Run certbot to get the SSL cert
  • Test the subdomain. All ILIAS services should run normal. There should be no difference between bbs-ilias.de or 16.bbs-ilias.de
  • Tell the user that the system will be only available via the subdomain for some hours
  • All users must use now this subdomain
  • Have a look at the file /var/www/html/index.php it redirects correct
  • Go to /etc/apache2/sites-available and edit both bbs-ilias.conf and bbs-ilias-le-ssl.conf and add this line in both files like this (line5):
1
2
3
4
5
<VirtualHost kivinet.de:80>
        ServerAdmin admin@bbs-ilias.de
        ServerName www.bbs-ilias.de
        ServerAlias bbs-ilias.de
        Redirect / https://16.bbs-ilias.de/

If you  get SSL errors, repeat certbot. Maybe you have to wait some hours more.

E-Mail-Settings

  • Create a gmail.com account
  • Login
  • Visit https://myaccount.google.com/lesssecureapps?pli=1 and switch this on
  • Change the RDNS/PTRS entry in your DNS system to the new target server (18.)
  • Now the old source server (16.) is not able to send mails anymore. We can fix this with ssmtp:
    • Login to the source server (16.)
    • apt install ssmtp
    • Get an e-mail-account like gmx.de or gmail.com
    • Enter your crendentials: nano /etc/ssmtp/ssmtp.conf
      • Example:
1
2
3
4
5
6
7
8
root=myadress@gmail.com
mailhub=smtp.gmail.com:587
UseSTARTTLS=YES
#UseTLS=Yes
AuthUser=myadress
AuthPass=mypass
FromLineOverride=YES
hostname=gmail.com
  • GMX is also an alternative. If one does not work, try the otherone. In GMX, external SMTP must also be activated first. 
  • Example for GMX: 
1
2
3
4
5
6
7
8
root=myname@gmx.de
mailhub=mail.gmx.net:587
rewriteDomain=gmx.net
hostname=gmx.net
UseSTARTTLS=YES
AuthUser=myname@gmx.de
AuthPass=mypass
FromLineOverride=YES
  • Send a testmail: echo "ILIAS is the best system" | mailx -s "Test-Mail" wolfgang.huebsch@gmx.de

Prepare the target server

  • Install the server like described in this tutorial. Use the subdomain 18.bbs-ilias.de for this
  • Set up all other vhosts for the subdomains above (pad18 und chat18)
  • If the source server runs fully with 16.bbs-ilias.de und the targetserver with 18.bbs-ilias.de, update the DNS entry of the main domain bbs-ilias.de with the new IP
  • Now, the users must use 16.bbs-ilias.de for 24 hours, bbs-ilias.de could run into cert errors (or use cert copy trick below)
  • Create a vhost for the moved domain bbs-ilias.de. Add the same line like above:
    • Redirect / https://16.bbs-ilias.de/
  • Try certbot for the new domain after 3-4 hours. Repeat this step later in case of cert errors. When a cert error occure, check the DNS mapping with ping bbs-ilias.de at the affected client. This problems should disappear after 24 hours.

Do not forget to choose also www.bbs-ilias.de in certbot

Trick: Copy Cert from source to target server

  • Thats the trick we all did befor certbot:
  • Logon to target server
  • cd /etc/apache2/sites-available
  • 000-bbs-ilias-le-ssl.conf 
  • copy-paste the content from the same file from the source server
  • Have a look aur these lines:
    • Include /etc/letsencrypt/options-ssl-apache.conf
    • SSLCertificateFile /etc/letsencrypt/live/bbs-ilias.de/fullchain.pem
    • SSLCertificateKeyFile /etc/letsencrypt/live/bbs-ilias.de/privkey.pem
  • mkdir -p /etc/letsencrypt/live/000-bbs-ilias.de/
  • cd /etc/letsencrypt/live/000-bbs-ilias.de/
  • now create every missing pem file and copy-paste the content with nano from the source /etc/letsencrypt/live/bbs-ilias.de/ to the target server /etc/letsencrypt/live/000-bbs-ilias.de/
  • a2ensite 000-bbs-ilias-le-ssl.conf
  • /etc/init.d/apache2 restart
  • Change the DNS entry, everthing should now run smooth and fine if there is still this line in both vhost files:
    • Redirect / https://16.bbs-ilias.de/


Information Message
No comment has been posted yet.