BookStack aktualisieren (Debian 10)

In diesem Kapitel führen wir unter Debian 10 eine Aktualisierung der installierten BookStack-Instanz innerhalb eines Mayor Release durch. Hierbei sollte i.d.R. keine Aktualisierung der Abhängigkeiten von Nöten sein - dies sollte jedoch zuvor unbedingt im offiziellen Admin-Guide geprüft werden.

Vorbereitung

Vor dem Update sollte unbedingt ein Backup der BookStack-Directory sowie der Datenbank durchgeführt werden. Das geht beisp. wie folgt:

tar cfvj ~/backup_bookstack.tar.bz2 /var/www/bookstack
mysqldump -u root -p bookstack > ~/backup_bookstack_db.sql

Aktualisierung

Zunächst beziehen wir die aktuellste Version aus dem offiziellen Git-Repository:

cd /var/www/bookstack
git pull origin release

Nun führen wir die Installation der PHP-Abhängigkeiten über den Composer durch:

curl -s https://getcomposer.org/installer > composer-setup.php
php composer-setup.php --quiet
rm -f composer-setup.php
export COMPOSER_ALLOW_SUPERUSER=1
php composer.phar install --no-dev --no-plugins

Und zum Schluss aktualisieren wir die Datenbank:

php artisan migrate --no-interaction --force

Verifizierung

Nach der Aktualisierung sollte selbstverständlich direkt geprüft werden, ob alles wie gewohnt funktioniert. Die aktuell installierte Version findet sich unter dem Menüpunkt "Einstellungen" oben rechts.