Die Anleitung beschreibt die Installation der Librebiz ERP- und CRM-Software auf Rechnern mit CentOS.
CentOS Konfiguration
Die Anleitung wurde auf Grundlage von CentOS 7 sowie CentOS 8 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:
yum install java-11-openjdk-devel git wget tar postgresql-server
CentOS 8 installiert neben OpenJDK 11 auch OpenJDK 8 und konfiguriert letzteres als Standard-JVM. Um das benötigte OpenJDK 11 als Standard einzustellen, wird der Befehl alternatives --config java
ausgeführt und dabei java-11-openjdk.x86_64 ausgewählt.
Der Befehl java -version
sollte im Anschluss OpenJDK version 11 ausgeben.
Zum Bau der Software wird Apache Maven verwendet. Da die von CentOS angebotenen Versionen nicht kompatibel sind, muss Maven z.B. gemäß Anleitung Maven Installation manuell installiert und konfiguriert werden.
Nach Installation von Maven muss der Befehl mvn -version
fehlerfrei ausgeführt werden und hierbei eine Versionsnummer >= 3.6 ausgeben.
Librebiz Softwarepaket erstellen
su - librebiz-dev
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk
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 CentOS nicht automatisch initialisiert und gestartet. Dies wird mit den nachfolgenden Kommandos erreicht:
postgresql-setup initdb
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 CentOS 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 CentOS:
JAVA_HOME="/usr/lib/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.