Wiki - Baroni Suite™ Webserver

Dokumentation

Einfache Dokumentation zu meiner Software

Inhaltsverzeichnis

Letzte Änderung

Vorwort

Die Installation sieht zwar auf den ersten Blick kompliziert aus, aber das Installationsskript erledigt fast alles automatisch. In der Dokumentation gibt es an einigen Stellen Platzhalter wie DOMAIN, die du bitte durch deine eigenen Daten ersetzen musst. Diese Anleitung funktioniert für Ubuntu und Debian. Andere Linux-Distributionen habe ich nicht getestet. Wenn du Fragen hast, melde dich gerne bei mir.

1. Automatische Installation

Du kannst mein Installationsskript verwenden, das übernimmt die komplette Installation des Webservers inklusive aller erforderlichen Voraussetzungen. Dabei werden unter anderem Apache2, PHP 8.4, MariaDB, Composer, Ioncube Loader, Qstat, ProFTPD und die benötigten PHP-Erweiterungen eingerichtet. Bei einer vollständigen Baroni Suite™ Webserver-Installation erstellt das Skript zusätzlich automatisch die Datenbank, den Datenbankbenutzer, importiert die database.sql, erstellt die config.php, installiert die benötigten Composer-Abhängigkeiten und setzt die erforderlichen Besitzer- und Dateirechte.

Falls beim Skript ein Fehler auftreten sollte, übernehme ich die Installation gerne kostenlos für dich.

Lade das Installationsskript herunter und führe es auf deinem Server als root aus:

cd /home
bash <(wget -qO- https://baroni-edv.de/getbsuite.sh)

Wähle anschließend die gewünschte Webserver- bzw. Baroni Suite™ Installation aus und folge den Anweisungen des Installationsskripts.

2. Manuelle Installation

Falls du das Skript nicht nutzen möchtest oder es zu Fehlern kommt, kannst du Baroni Suite™ auch manuell installieren. Ich erkläre hier die wichtigsten Schritte, damit deine Baroni Suite™-Installation schnell funktioniert. Wenn du bei grundlegenden Schritten nicht weiterkommst, hilft oft eine schnelle Google-Suche. Ich hoffe, du hast Verständnis dafür, dass nicht jeder Schritt im Detail erklärt werden kann. Du benötigst dafür:

Grundlegende Linux-Kenntnisse
Apache2 oder Nginx
MariaDB Server
libapache2-mod-php8.4 (nur bei Apache2)
php8.4
php8.4-bz2
php8.4-cli
php8.4-common
php8.4-curl
php8.4-gd
php8.4-intl
php8.4-mbstring
php8.4-mysql
php8.4-opcache
php8.4-xml
php8.4-xsl
php8.4-zip
composer
php8.4-fpm (nur bei Verwendung von PHP-FPM)
Ioncube Loader

2.1 Dateien hochladen

Zuerst musst du dir die Baroni Suite™ herunterladen. Nachdem du die ZIP-Datei entpackt hast, lade den Ordner bsuite mit einem FTP-Programm auf deinen Server, meistens nach /var/www bzw. in das DocumentRoot deiner Domain. Sobald alle Dateien hochgeladen sind, muss der komplette Baroni Suite™ Ordner dem Webserver-Benutzer www-data gehören. Passe den Pfad an dein tatsächliches Webverzeichnis an:

chown -R www-data:www-data /var/www/bsuite

Anschließend gehst du in den Ordner bsuite und setzt für die folgenden Ordner und Dateien die Rechte auf chmod 0777:

/cache
/pdf
/resources
/resources/downloads
/resources/uploads
/tmp
config.php

Beispiel:

cd /var/www/bsuite
chmod 0777 cache
chmod 0777 pdf
chmod 0777 resources
chmod 0777 resources/downloads
chmod 0777 resources/uploads
chmod 0777 tmp
chmod 0777 config.php

Öffne anschließend den Baroni Suite™ Installer:

http://DOMAIN/bsuite

Dort gibst du deine MariaDB-Zugangsdaten ein. Baroni Suite™ verwendet aktuell den Datenbanktreiber:

pdo_mysqli

Der Installer erstellt anschließend die config.php und importiert automatisch die mitgelieferte database.sql. Nach erfolgreicher Installation solltest du das Verzeichnis /install entfernen:

rm -rf /var/www/bsuite/install

Passe den Pfad bei Bedarf an dein tatsächliches Webverzeichnis an. Anschließend solltest du nochmals sicherstellen, dass der komplette Baroni Suite™ Ordner dem Webserver gehört:

chown -R www-data:www-data /var/www/bsuite

2.2 Ioncube Loader Installation

Falls der Ioncube Loader noch nicht auf deinem Server installiert ist, kannst du ihn hier nachholen. Kopiere den folgenden Link und lade die passende Version mit wget herunter:

Achte darauf, die richtige Version für dein Betriebssystem auszuwählen (x86 & x64).

Entpacke die Datei und verschiebe den ioncube-Ordner nach /usr/local. Um Ioncube für PHP 8.4 unter Apache2 zu aktivieren, führe den folgenden Befehl aus:

echo "zend_extension=/usr/local/ioncube/ioncube_loader_lin_8.4.so" > /etc/php/8.4/apache2/conf.d/00-ioncube.ini

Falls du php8.4-fpm verwendest:

echo "zend_extension=/usr/local/ioncube/ioncube_loader_lin_8.4.so" > /etc/php/8.4/fpm/conf.d/00-ioncube.ini

Für die PHP-CLI kannst du Ioncube zusätzlich hier aktivieren:

echo "zend_extension=/usr/local/ioncube/ioncube_loader_lin_8.4.so" > /etc/php/8.4/cli/conf.d/00-ioncube.ini

Starte danach Apache2 bzw. PHP-FPM neu:

systemctl restart apache2

Prüfen kannst du Ioncube anschließend mit:

php -m | grep -i ioncube

2.3 Qstat Installation

Einige Spiele nutzen Qstat, um den Server-Status anzuzeigen. Ich installiere es daher ebenfalls auf dem Webserver. Installiere Qstat mit folgendem Befehl:

apt install qstat

Nun machen wir es für Baroni Suite™ zugänglich:

cd /usr/bin
ln -s quakestat qstat

Fertig! Qstat ist jetzt installiert und verfügbar.

Composer Extensions Installation

Es müssen noch alle benötigten Extensions und Bibliotheken mit Composer installiert werden. Composer sollte dabei genauso wie Baroni Suite™ selbst unter dem Webserver-Benutzer www-data ausgeführt werden. Stelle zuerst sicher, dass der Baroni Suite™ Ordner dem Webserver gehört:

chown -R www-data:www-data /var/www/bsuite

Gehe anschließend in dein Baroni Suite™ Verzeichnis:

cd /var/www/bsuite

Installiere die Composer-Abhängigkeiten anschließend als www-data:

runuser -u www-data -- env HOME=/var/www COMPOSER_HOME=/var/www/.composer composer install --no-interaction --no-progress

Falls das Composer-Verzeichnis für www-data noch nicht existiert, kannst du es vorher erstellen:

mkdir -p /var/www/.composer
chown -R www-data:www-data /var/www/.composer

Anschließend sollte der Besitzer von Baroni Suite™ nochmals gesetzt werden:

chown -R www-data:www-data /var/www/bsuite

Bei einer fehlenden Composer-Installation bzw. fehlenden Abhängigkeiten sollte eine Meldung im Adminlogin darauf hinweisen.

Lizenz Aufschaltung & Admin Login

Bitte ändere die Logindaten nach dem ersten Anmelden.

Nach der erfolgreichen Installation kannst du Baroni Suite™ öffnen und die Lizenz aufschalten. Gehe dazu auf:

http://DOMAIN/bsuite/admin.php

Ist für die Installation noch keine gültige Lizenz hinterlegt, zeigt Baroni Suite™ einen entsprechenden Hinweis an. Die Lizenz muss beim jeweiligen Lizenzaussteller aktiviert bzw. der Installation zugeordnet werden. Je nachdem, wo du deine Baroni Suite™ Lizenz erhalten hast, kann der Lizenzaussteller direkt Baroni-EDV oder ein entsprechender Reseller sein. Alle Lizenzen werden zentral über das Baroni Suite™ Lizenzsystem geprüft. Die Verwaltung bzw. Freischaltung gegenüber dem Kunden kann jedoch durch den jeweiligen Lizenzaussteller erfolgen. Bei der Lizenzprüfung werden unter anderem die zur Installation gehörenden Daten wie Domain, Server-IP, Installationspfad und Baroni Suite™ Version berücksichtigt. Nach erfolgreicher Lizenzaktivierung kannst du dich als Admin anmelden. Ein zusätzlicher Lizenzschlüssel muss nicht manuell in Baroni Suite™ eingetragen werden.

Benutzername: Baroni-EDV
Passwort: BSuite

Optional kannst du anschließend für deinen Administrator die OTP Zwei-Faktor-Authentifizierung aktivieren. Der Kundenbereich ist unter

http://DOMAIN/bsuite/members.php

erreichbar.