i-doit update Anleitung

Wichtige Informationen bevor du beginnst#

Hier findest du eine kurze Anleitung zum Aktualisieren deines i-doit auf i-doit 31.
Möglicherweise musst du dein Betriebssystem aktualisieren.
Diese Anweisungen gelten für Debian, die verwendeten Befehle unterscheiden sich in anderen Betriebssystemen. Bevor du beginnst, lädst du alle Updates herunter, die du durchführen musst, und kopiere sie in den i-doit-Stammordner.

Aktualisierung von 1.7.4 auf 1.8#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das i-doit-Update-Paket mit folgendem Befehl entpacken:

1

sudo -u www-data unzip idoit-1.8-update.zip

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst.

Nun öffnen wir den Web-Interface-Updater, wählen das Update auf v1.8 aus und führen das Update durch.

Aktualisierung von 1.8 auf 1.9#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das i-doit-Update-Paket mit folgendem Befehl entpacken:

1

sudo -u www-data unzip idoit-1.9-update.zip

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst. Nun öffnen wir den Web-Interface-Updater, wählen das Update auf v1.9 aus und führen das Update durch.

Aktualisierung von 1.9 auf 1.10#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das i-doit-Update-Paket mit folgendem Befehl entpacken:

1

sudo -u www-data unzip idoit-1.10-update.zip

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst. Nun öffnen wir den Web-Interface-Updater, wählen das Update auf v1.10 aus und führen das Update durch.

Aktualisierung von 1.10 auf 1.11#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das i-doit-Update-Paket mit folgendem Befehl entpacken:

1

sudo -u www-data unzip idoit-1.11-update.zip

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst. Öffne nun das Webinterface-Updater und das Update auf v1.11 wird angezeigt und ausgewählt, führst du das Update durch.

Lösungen:

• Lade die Seite neu und fährst du fort.
• oder verwendest du das folgende Hotfix, wenn das Neuladen nicht funktioniert

Fahre mit dem Update fort

Aktualisierung von 1.11 auf 1.12#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das i-doit-Update-Paket mit folgendem Befehl entpacken:

1

sudo -u www-data unzip idoit-1.12-update.zip

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst. Öffne nun das Webinterface-Updater und das Update auf v1.12 wird angezeigt und ausgewählt, führst du das Update durch.

Debian 8 auf 9 aktualisieren#

1
2

sudo apt-get autoremove
sudo apt-get clean

1

sudo nano /etc/apt/sources.list

1
2

deb http://deb.debian.org/debian stretch main
deb http://deb.debian.org/debian stretch contrib

1

sudo apt-get update

1
2

Es sind keine öffentlichen Schlüssel verfügbar für die folgenden Schlüssel-IDs:
112695A0E562B32A

1

sudo systemctl stop mysql cron

1
2

sudo apt-get upgrade
sudo apt-get full-upgrade

1

sudo systemctl start mysql cron

1
2

sudo apt-get autoremove
sudo apt-get clean

Debian 9 auf 10 aktualisieren#

1
2

sudo apt-get autoremove
sudo apt-get clean

1

sudo nano /etc/apt/sources.list

1
2

deb http://deb.debian.org/debian buster main
deb http://deb.debian.org/debian buster contrib

1

sudo systemctl stop mysql cron

1
2
3

sudo apt-get update
sudo apt-get upgrade
sudo apt-get full-upgrade

1

sudo systemctl start mysql cron

1
2

sudo apt-get autoremove
sudo apt-get clean

Aktualisierung von PHP 5.6 auf PHP 7.3#

Aktualisieren und installierst du alle benötigten Pakete

1
2

sudo apt update
sudo apt install apache2 libapache2-mod-php mariadb-client mariadb-server php php-bcmath php-cli php-common php-curl php-gd php-imagick php-json php-ldap php-mbstring php-memcached php-mysql php-pgsql php-soap php-xml php-zip memcached unzip sudo moreutils

Erstelle die PHP-Konfigurationsdatei

1

sudo nano /etc/php/7.3/mods-available/i-doit.ini

folgendes einfügen:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

allow_url_fopen = Yes
file_uploads = On
magic_quotes_gpc = Off
max_execution_time = 300
max_file_uploads = 42
max_input_time = 60
max_input_vars = 10000
memory_limit = 256M
post_max_size = 128M
register_argc_argv = On
register_globals = Off
short_open_tag = On
upload_max_filesize = 128M
display_errors = Off
display_startup_errors = Off
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
log_errors = On
default_charset = "UTF-8"
default_socket_timeout = 60
date.timezone = Europe/Berlin
session.gc_maxlifetime = 604800
session.cookie_lifetime = 0
mysqli.default_socket = /var/run/mysqld/mysqld.sock

Änderungen aktivieren

1
2
3
4
5

sudo a2dismod php5
sudo a2enmod php7.3
sudo phpenmod i-doit
sudo phpenmod memcached
sudo systemctl restart apache2.service

i-doit sollte jetzt über Verwaltung > [Mandant Name] Verwaltung > System Config Check die neue PHP-Version 7.3.31-1~deb10u1 anzeigen.

Erstelle die MariaDB-Konfigurationsdatei, falls nicht vorhanden#

Erstellen oder aktualisierst du eine MariaDB-Konfigurationsdatei

1

sudo nano /etc/mysql/mariadb.conf.d/99-i-doit.cnf

einfügen oder aktualisierst du deine MariaDB-Konfiguration

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

[mysqld]

# This is the number 1 setting to look at for any performance optimization
# It is where the data and indexes are cached: having it as large as possible will
# ensure MySQL uses memory and not disks for most read operations.
#
# Typical values are 1G (1-2GB RAM), 5-6G (8GB RAM), 20-25G (32GB RAM), 100-120G (128GB RAM).
innodb_buffer_pool_size = 1G

# Use multiple instances if you have innodb_buffer_pool_size > 10G, 1 every 4GB
innodb_buffer_pool_instances = 1

# Redo log file size, the higher the better.
# MySQL/MariaDB writes two of these log files in a default installation.
innodb_log_file_size = 512M

innodb_sort_buffer_size = 64M
sort_buffer_size = 262144 # default
join_buffer_size = 262144 # default

max_allowed_packet = 128M
max_heap_table_size = 32M
query_cache_min_res_unit = 4096
query_cache_type = 1
query_cache_limit = 5M
query_cache_size = 80M

tmp_table_size = 32M
max_connections = 200
innodb_file_per_table = 1

# Disable this (= 0) if you have only one to two CPU cores, change it to 4 for a quad core.
innodb_thread_concurrency = 0

# Disable this (= 0) if you have slow hard disks
innodb_flush_log_at_trx_commit = 1
innodb_flush_method = O_DIRECT

innodb_lru_scan_depth = 2048
table_definition_cache = 1024
table_open_cache = 2048
#Only if your have MySQL 5.6 or higher, do not use with MariaDB!
#table_open_cache_instances = 4

innodb_stats_on_metadata = 0

sql-mode = ""

Starte MariaDB danach neu

1

sudo systemctl start mysql.service

Aktualisierung von 1.12 auf 1.13#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Updatepaket mit

1

sudo -u www-data unzip idoit-1.13-update.zip

entpacken.

Wenn du gefragt werden, überschreiben du alles, indem du A eingibst.

Öffne nun den Web-Interface-Updater und das Update auf v1.13 wird angezeigt und ausgewählt, führst du das Update durch.

Möglicherweise erhältst du diesen Fehler:

Dann musst du das Update erneut starten.
Wenn du jetzt einen HTTP 500 erhalten, führst du das Update erneut durch.

Aktualisierung von 1.13 auf 1.14#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Updatepaket mit

1

sudo -u www-data unzip idoit-1.14-update.zip

entpacken.

Wenn du gefragt werden, überschreiben du alles, indem du A eingibst.

Öffne nun den Web-Interface-Updater und das Update auf v1.14 wird angezeigt und ausgewählt, führst du das Update durch.

Wenn du diesen Fehler sehen:

Die Lösung ist hier dokumentiert

Update von 1.14 auf 1.15#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Updatepaket mit

1

sudo -u www-data unzip idoit-1.15-update.zip

entpacken.

Wenn du gefragt werden, überschreiben du alles, indem du A eingibst.

Öffne nun den Web-Interface-Updater und das Update auf v1.15 wird angezeigt und ausgewählt, führst du das Update durch.

Update von 1.15 auf 1.16#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Updatepaket mit

1

sudo -u www-data unzip idoit-1.16-update.zip

entpacken.

Wenn du gefragt werden, überschreiben du alles, indem du A eingibst.

Öffne nun den Web-Interface-Updater und das Update auf v1.16 wird angezeigt und ausgewählt, führst du das Update durch.

Update von 1.16 auf 1.17#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Updatepaket mit

1

sudo -u www-data unzip idoit-1.17-update.zip

entpacken.

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst.

Nun öffnen wir den Web-Interface-Updater und das Update auf v1.17 wird angezeigt und ausgewählt, führst du das Update durch.

Aktualisierung von 1.17 auf 1.18#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Update-Paket mit folgendem Befehl entpacken:

1

sudo -u www-data unzip idoit-1.18-update.zip

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst.

Nun öffnen wir den Web-Interface-Updater und das Update auf v1.18 wird angezeigt und ausgewählt, führst du das Update durch.

Upgrade von Debian 10 auf 11#

1
2

sudo apt-get autoremove
sudo apt-get clean

1

sudo nano /etc/apt/sources.list

1
2

deb http://deb.debian.org/debian bullseye main
deb http://deb.debian.org/debian bullseye contrib

1

sudo systemctl stop mysql cron

1
2
3

sudo apt-get update
sudo apt-get upgrade
sudo apt-get full-upgrade

1

sudo systemctl start mysql cron

1
2

sudo apt-get autoremove
sudo apt-get clean

Konfigurieren von PHP 7.4#

Erstelle die PHP-Konfigurationsdatei

1

sudo nano /etc/php/7.4/mods-available/i-doit.ini

folgendes einfügen:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

allow_url_fopen = Yes
file_uploads = On
magic_quotes_gpc = Off
max_execution_time = 300
max_file_uploads = 42
max_input_time = 60
max_input_vars = 10000
memory_limit = 256M
post_max_size = 128M
register_argc_argv = On
register_globals = Off
short_open_tag = On
upload_max_filesize = 128M
display_errors = Off
display_startup_errors = Off
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
log_errors = On
default_charset = "UTF-8"
default_socket_timeout = 60
date.timezone = Europe/Berlin
session.gc_maxlifetime = 604800
session.cookie_lifetime = 0
mysqli.default_socket = /var/run/mysqld/mysqld.sock

Änderungen aktivieren

1
2
3
4
5

sudo a2dismod php7.3
sudo a2enmod php7.4
sudo phpenmod i-doit
sudo phpenmod memcached
sudo systemctl restart apache2.service

Wenn der apache2 nicht neu startet und du den obigen Fehler erhältst, startest du den Server neu.

i-doit sollte jetzt über Verwaltung > [Mandant Name] Verwaltung > System Config Check die neue PHP-Version 7.4.30 anzeigen.

Aktualisierung von 1.18 auf 1.19#

Zuerst bereiten wir das Update über die CLI vor, indem wir den i-doit-Ordner unter /var/www/html/ öffnen und das i-doit-Update-Paket mit

1

sudo -u www-data unzip idoit-1.19-update.zip

entpacken.

Wenn du gefragt werden, überschreiben du alles, indem du A eingibst.

Wenn du das Update ohne PHP 7.3 versuchen, siehst du diese Meldung:

Öffne nun den Web-Interface-Updater und das Update auf v1.19 wird angezeigt und ausgewählt, führst du das Update durch.

Aktualisierung von 1.19 auf 20#

Öffne zuerst den Web-Interface-Updater.
Durch Klicken auf Nach einer neuen Version suchen kannst du überprüfen, ob ein neueres Paket verfügbar ist. Dafür benötigst du eine Internetverbindung.
Wenn eine neue Version verfügbar ist, kann das Update-Paket mit einem Klick auf Herunterladen heruntergeladen und extrahiert werden.

Wenn du nicht mit dem Internet verbunden sind, kannst du das Update über die Befehlszeile vorbereiten, indem du den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Update-Paket mit dem folgenden Befehl entpacken:

1

sudo -u www-data unzip idoit-20-update.zip

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst.

Überprüfe im Webinterface, ob das Update auf Version 20 angezeigt und ausgewählt ist, und führst du dann das Update durch.

Aktualisierung von 20 auf 29#

Zunächst musst du das Update über die Befehlszeile vorbereiten, indem du den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Update-Paket mit dem folgenden Befehl entpacken:

1

sudo -u www-data unzip idoit-29-update.zip

Wenn du dazu aufgefordert wirst, überschreibe alles, indem du A eingibst.

Überprüfe im Webinterface des Updaters, ob das Update auf Version 29 angezeigt und ausgewählt ist, und führst du dann das Update durch.

Upgrade von Debian 11 auf 12#

1
2

sudo apt-get autoremove
sudo apt-get clean

1

sudo nano /etc/apt/sources.list

Ändere alle Einträge in 'bookworm' oder löschst du alle Einträge und Füge folgendes ein

1
2

deb http://deb.debian.org/debian bookworm main
deb http://deb.debian.org/debian bookworm contrib

Stoppe nun mysql und cron

1

sudo systemctl stop mysql cron

Führe das Update auf Debian 12 durch

1
2
3

sudo apt-get update
sudo apt-get upgrade
sudo apt-get full-upgrade

Starte die Dienste, die wir gestoppt haben

1

sudo systemctl start mysql cron

Fehler? Hier lesen

Gib erneut etwas Speicherplatz frei

1
2

sudo apt-get autoremove
sudo apt-get clean

Überprüfe deine sources.list, für weitere Informationen siehe hier

Du befindest dich jetzt bei Debian 12 mit PHP 8.2.18 und MariaDB 10.11.

Konfigurieren von PHP 8.2#

Erstelle die PHP-Konfigurationsdatei

1

sudo nano /etc/php/8.2/mods-available/i-doit.ini

Füge ein:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

allow_url_fopen = Yes
file_uploads = On
magic_quotes_gpc = Off
max_execution_time = 300
max_file_uploads = 42
max_input_time = 60
max_input_vars = 10000
memory_limit = 256M
post_max_size = 128M
register_argc_argv = On
register_globals = Off
short_open_tag = On
upload_max_filesize = 128M
display_errors = Off
display_startup_errors = Off
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
log_errors = On
default_charset = "UTF-8"
default_socket_timeout = 60
date.timezone = Europe/Berlin
session.gc_maxlifetime = 604800
session.cookie_lifetime = 0
mysqli.default_socket = /var/run/mysqld/mysqld.sock

Änderungen aktivieren

1
2
3
4
5

sudo a2dismod php7.4
sudo a2enmod php8.2
sudo phpenmod i-doit
sudo phpenmod memcached
sudo systemctl restart apache2.service

Wenn der apache2 nicht neu startet, startest du den Server neu.

i-doit sollte jetzt die neue PHP-Version 8.2.18 unter Verwaltung > [Mandant Name] Verwaltung > System Config Check anzeigen.

MariaDB 10.11 Upgrade#

Jetzt müssen wir die Tabellen überprüfen und auf die letzte Version aktualisieren mit

1

sudo mariadb-upgrade -p

Gib dein Passwort ein und Überprüfe, ob alles gut gelaufen ist

Starte danach MariaDB neu

1

sudo systemctl start mysql.service

Aktualisierung von 29 auf 34#

Zuerst musst du das Update über die CLI vorbereiten, indem du den i-doit-Ordner unter /var/www/html/ öffnen und das idoit-Update-Paket mit

1

sudo -u www-data unzip idoit-34-update.zip

entpacken.

Wenn du gefragt werden, überschreiben du alles, indem du A eingibst.

Im Web-Interface-Updater Überprüfe, ob das Update auf Version 33 angezeigt und ausgewählt ist, und führst du dann das Update durch.

Quellen#

• MariaDB-Upgrade-Informationen https://mariadb.com/kb/en/upgrading/
• Debian 9-Upgrade https://www.debian.org/releases/stretch/
• Debian 10-Upgrade https://www.debian.org/releases/buster/
• Debian 11-Upgrade https://www.debian.org/releases/bullseye/
• Debian 12-Upgrade https://www.debian.org/releases/bookworm/