Die Anleitung beschreibt die Installation der Librebiz ERP- und CRM-Software auf Rechnern mit openSUSE.
openSUSE Konfiguration
Die Anleitung wurde auf Grundlage von openSUSE Leap 15.3 erstellt. Nach der Installation wurden lediglich Rechnername und Netzwerk konfiguriert sowie ein Benutzerkonto zum Bau der Software angelegt:
useradd --home-dir /home/librebiz-dev --create-home librebiz-dev
Installation der benötigten Softwarepakete:
zypper install java-11-openjdk-devel maven git wget tar postgresql-server
Librebiz Softwarepaket erstellen
su - librebiz-dev
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk
export LANG=en_US.UTF-8
git clone https://codeberg.org/librebiz/librebiz-ce.git
cd librebiz-ce
git checkout v6.1.0
./build all && ./build pkg
exit
Librebiz Installation
Alle Kommandos müssen als root oder mit vorangestelltem sudo ausgeführt werden.
Datenbank Setup
Der PostgreSQL-Server wird unter openSUSE nicht automatisch initialisiert und gestartet. Dies wird mit den nachfolgenden Kommandos erreicht:
systemctl enable postgresql
systemctl start postgresql
Hinweis: Um spätere Probleme zu vermeiden sollten alle nachfolgenden Befehle unverändert übernommen werden. Der Datenbankname bildet eine Ausnahme von dieser Empfehlung und kann problemlos geändert werden.
su - postgres
createuser --encrypted --pwprompt osserp
createdb --owner=osserp --template=template0 --encoding=UTF8 librebiz_main
exit
Beim Anlegen des Datenbankbenutzers wird nach einem Passwort für den neuen Benutzer gefragt. Das hierbei vergebene Passwort wird im Anschluss zum Eintrag in der Konfigurationsdatei benötigt.
Datenbank konfigurieren
Die im folgenden zu bearbeitenden Dateien befinden sich im Verzeichnis /var/lib/pgsql/data. Um lokalen Anwendungen Zugriff auf den Datenbankserver über TCP/IP zu gewähren, wird in der Datei postgresql.conf das Kommentarzeichen (#) am Anfang der nachfolgenden Zeile entfernt:
#listen_addresses = 'localhost' # what IP address(es) to listen on;
ändern in
listen_addresses = 'localhost' # what IP address(es) to listen on;
Um dem neuen Datenbankbenutzer Zugriff auf die angelegte Datenbank zu gewähren, werden in der Datei pg_hba.conf direkt unter der Zeile
# TYPE DATABASE USER ADDRESS METHOD
an erster Stelle die folgenden Zeilen eingetragen:
local librebiz_main osserp md5
host librebiz_main osserp 127.0.0.1/32 md5
Im Anschluss muss der Datenbankserver die Konfiguration neu einlesen.
systemctl reload postgresql
Installation der Software
Es wird empfohlen, das Installationspaket in das voreingestellte Verzeichnis /usr/local zu entpacken bzw. es dorthin zu verschieben (wenn es bereits ausgepackt wurde um diese Anleitung zu lesen).
Wenn ein anderes Verzeichnis wie z.B. /opt verwendet werden soll, muss der Pfad im Skript librebiz-admin, der Konfigurationsdatei custom.properties sowie in der Datei librebiz-context.xml geändert werden.
tar -zxf /home/librebiz-dev/librebiz-ce/dist/common/librebiz-bin-latest.tar.gz -C /usr/local
Nach dem Auspacken/Verschieben ins Zielverzeichnis erfolgt die eigentliche Installation durch Aufruf des Programms librebiz-admin mit der install Option.
/usr/local/librebiz/sbin/librebiz-admin install
librebiz-admin legt bei der ersten Ausführung einen symbolischen Link auf sich selbst in /usr/local/bin an, so dass es künftig ohne Angabe des Programmpfad aufgerufen werden kann.
Konfiguration
Wenn Datenbankbenutzer und Datenbank angelegt sind, muss das Passwort in der Datei /etc/librebiz/conf/custom.properties eingetragen werden.
Das Passwort des Datenbankbenutzers muss jeweils bei dms.database.pwd sowie root.database.pwd eingetragen werden, der Name der Datenbank bei den Einträgen dms.database.name und root.database.name.
Abschliessend richtet librebiz-admin mit der Option init die Datenbank ein, die Option enable registriert die Anwendung in der Laufzeitumgebung.
librebiz-admin init
librebiz-admin enable
Unter openSUSE wird JAVA_HOME nicht automatisch initialisiert und muss deshalb in der Datei /var/lib/librebiz/mq/.activemqrc eingestellt werden. Die Datei enthält hierzu bereits ein Beispiel für openSUSE:
JAVA_HOME="/usr/lib64/jvm/java-11-openjdk"
Die Installation und Konfiguration des Systems ist hiermit abgeschlossen.
Abschliessend muss die Anwendung noch gestartet werden:
systemctl start librebiz
Wenn der Befehl systemctl status librebiz im Anschluss an das Startkommando keine Fehler meldet, war der Start erfolgreich. Die Einrichtung der Firma ist im Setup Guide beschrieben.
Fehlermeldungen werden in der Datei /var/log/librebiz/librebiz.log sowie weiteren Dateien im Logverzeichnis protokolliert.