Warenwirtschaftssysteme: Software

Nachfolgend soll die Installation, Konfiguration und Verwendung von Warenwirtschaftssystemen für den Klein- und Mittelständebetrieb unter DEBIAN Linux beschrieben werden.

Es wird ein DEBIAN-Standardsystem (Version: Jessie) vorausgesetzt und der Zugang zu den Paketquellen für die Installation von Paketen. Weiterhin sollte der Zugang zum Repository mit den Anpassungspaketen ermöglicht werden (notfalls können die Anpassungspakete auch lokal vorliegen).

Es gibt für die vorgestellten Warenwirtschaftssysteme gleiche Voraussetzungen zu erfüllen, wie zum Beispiel die Installation eines Apache Webserver oder einer Datenbank. Die Installation und Konfiguration dieser Pakete soll vorab einmal beschrieben werden.

• Installation von Apache Webserver:

~# apt-get --no-install-recommends -y install apache2

• Installation von PostgreSQL-Datenbank:

~# apt-get --no-install-recommends -y install postgresql postgresql-contrib

Für PostgreSQL-Datenbank wurde ein Anpassungspaket erstellt, welche der lokalen Verbindung („127.0.0.1“) durch Eintragen in die Dateien „/etc/postgresql/9.4/main/pg_hba.conf“ und „/etc/postgresql/9.4/main/postgresql.conf“ volles Vertrauen schenkt. Hiermit entfällt ein manuelles Eintragen.

• Installation des PostgreSQL-Anpassungspaketes (über Repository oder manuell):

~# apt-get -y --force-yes install rmp-postgresql-9.4

~# dpkg -i rmp-postgresql-9.4_*_all.deb

Als Webbrowser wird nachfolgend der Iceweasel verwendet.

• Installation des Browserprogramms:

~# apt-get --no-install-recommends -y install iceweasel-l10n-de

Kurzinfo:

Im ersten Schritt müssen die vorausgesetzten Programme installiert werden.

• Installation der notwendigen Perl-Pakete:

~# apt-get --no-install-recommends -y install libarchive-zip-perl libclone-perl libconfig-std-perl libdatetime-perl libdbd-pg-perl \
libdbi-perl libemail-address-perl  libemail-mime-perl libfcgi-perl libjson-perl liblist-moreutils-perl libnet-smtp-ssl-perl libnet-sslglue-perl \
libparams-validate-perl libpdf-api2-perl librose-db-object-perl librose-db-perl librose-object-perl libsort-naturally-perl \
libstring-shellquote-perl libtemplate-perl libtext-csv-xs-perl libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl \
libimage-info-perl libgd-gd2-perl libfile-copy-recursive-perl libalgorithm-checkdigits-perl libcgi-pm-perl

Das Programm benötigt ein Perl-Paket, welches nicht in den DEBIAN-Repositories zu finden ist. Es kann über CPAN mittels des Programms „dh-make-perl“ nachgebaut werden.

• Installation der notwendigen Pakete und Abhängigkeiten:

~# apt-get --no-install-recommends -y install apt-file dh-make-perl fakeroot-ng libdata-dump-perl libmoo-perl libtype-tiny-perl libnamespace-clean-perl libtest-fatal-perl

• Aktualisieren der Paketinformationen:

~# apt-file update

• Bauen des Perl-Paketes „libhtml-restrict-perl“:

~# dh-make-perl --requiredeps --build --cpan HTML::Restrict

Beim ersten Start muss CPAN konfiguriert werden. Hier kann die automatische Variante ausgewählt werden.

• Installation des gebauten Perl-Paketes:

~# dpkg -i libhtml-restrict-perl_*_all.deb

Damit der Apache Webserver mit Perl funktioniert, muss ein Modul dafür installiert werden.

• Installation des Perl-Moduls:

~# apt-get --no-install-recommends -y install libapache2-mod-perl2 libapache2-mod-fcgid libfcgi-perl

Nun kann das heruntergeladene Archiv im Wurzelverzeichnis des Browsers entpackt werden. Das entpackte Verzeichnis enthält neben dem Namen auch die Versionsnummer, die durch Umbennen entfernt werden kann.

• Entpacken des Archives:

~# tar xvfz /tmp/kivitendo-erp-release-3.4.0.tar.gz -C /var/www/html/

• Umbenennen des Verzeichnisses:

~# mv /var/www/html/kivitendo-erp-release-3.4.0 /var/www/html/kivitendo

• Setzen der Rechte:

~# chown -R www-data:www-data /var/www/html/kivitendo

Kivitendo liefert ein Perl-Skript mit, welches die Installation auf fehlende Pakete hin prüft.

• Prüfung auf fehlende Pakete:

~# cd /var/www/html/kivitendo
~# ./scripts/installation_check.pl

Erscheinen hier Fehlermeldungen oder ist das Gesamtergebnis nicht „OK“, müssen die fehlenden Pakete nachinstalliert werden.

Kivitendo besitzt eine Konfigurationsdatei, die im ersten Schritt aktiviert werden muss.

• Aktivieren der Konfigurationsdatei:

~# cp /var/www/html/kivitendo/config/kivitendo.conf.default /var/www/html/kivitendo/config/kivitendo.conf

• Anpassen der Konfigurationsdatei:

admin_password = <Passwort>
...
host     = localhost
port     = 5432
db       = kivitendo_auth
user     = kivitendo
password = <Passwort>

Hier werden die Passwörter des Administrators (bei der Anmeldung über die Weboberfläche) und der Datenbank festgelegt.

Kivitendo läuft mit FastCGI/FCGI, welches aktiviert werden muss. Danach kann die Konfiguration eingetragen werden.

• Aktivieren vom FastCGI-Modul:

~# a2enmod fcgid

• Eintragen der Konfiguration in die Datei „/etc/apache2/sites-enabled/000-default.conf“ (CGI-Variante):

        AliasMatch ^/kivitendo/[^/]+\.pl /var/www/html/kivitendo/dispatcher.fcgi
        Alias       /kivitendo/          /var/www/html/kivitendo/

        <Directory /var/www/html/kivitendo>
                AddHandler cgi-script .pl
                Options ExecCGI Includes FollowSymlinks
        </Directory>

        <Directory /var/www/html/kivitendo/users>
                Order Deny,Allow
                Deny from All
        </Directory>

• Eintragen der Konfiguration in die Datei „/etc/apache2/sites-enabled/000-default.conf“ (Fast-CGI-Variante):

        AddHandler fcgid-script .fpl
        AliasMatch ^/kivitendo/[^/]+\.pl /var/www/html/kivitendo/dispatcher.fcgi
        Alias       /kivitendo/          /var/www/html/kivitendo/
        FcgidMaxRequestLen 10485760

        <Directory /var/www/html/kivitendo>
                AllowOverride All
                Options ExecCGI Includes FollowSymlinks
                Require all granted
        </Directory>

        <DirectoryMatch /var/www/html/kivitendo/users>
                Require all granted
        </DirectoryMatch>

• Neustarten des Webservers:

~# /etc/init.d/apache2 restart

Für die Datenbank wird zwingend Unicode/UTF-8 benötigt. Des weiteren müssen die servergespeicherten Prozeduren aktiviert werden. Zum Schluss wird noch ein Benutzer angelegt.

• Überprüfen des Zeichensatzes:

~# su postgres
~$ echo '\l' | psql
                                  Liste der Datenbanken
   Name    | Eigentümer | Kodierung | Sortierfolge | Zeichentyp  |  Zugriffsprivilegien  
-----------+------------+-----------+--------------+-------------+-----------------------
 postgres  | postgres   | UTF8      | de_DE.UTF-8  | de_DE.UTF-8 | 
 template0 | postgres   | UTF8      | de_DE.UTF-8  | de_DE.UTF-8 | =c/postgres          +
           |            |           |              |             | postgres=CTc/postgres
 template1 | postgres   | UTF8      | de_DE.UTF-8  | de_DE.UTF-8 | =c/postgres          +
           |            |           |              |             | postgres=CTc/postgres
(3 Zeilen)
~$ exit
~#

• Aktivieren der servergespeicherten Prozeduren:

~# su - postgres
~$ psql template1
template1=# CREATE EXTENSION IF NOT EXISTS plpgsql;
template1= \q
~$ exit
~#

• Benutzer anlegen:

~# su - postgres
~$ createuser -d -P kivitendo
Geben Sie das Passwort der neuen Rolle ein: 
Geben Sie es noch einmal ein:
~$ exit
~#

• Anlegen der Datenbank und Benutzer berechtigen:

~# su - postgres
~$ psql
postgres=# CREATE DATABASE kivitendo_auth;
CREATE DATABASE
postgres=# GRANT ALL PRIVILEGES ON DATABASE kivitendo_auth to kivitendo;
GRANT
postgres=# \q
~$ exit
~#

• Neustarten der Datenbank:

~# /etc/init.d/postgresql restart

Zum Anlegen der Authentifizierungsdatenbank muss eine einmalige Anmeldung im Webbrowser erfolgen.

• Anmeldung als Administrator an folgender Adresse:

http://localhost/kivitendo/controller.pl?action=Admin/login

Jetzt können die Benutzer, Mandaten und Gruppen angelegt werden.

Kurzinfo:

Im ersten Schritt müssen die vorausgesetzten Programme installiert werden.

• Installation der notwendigen Python-Pakete:

~# apt-get --no-install-recommends -y install node-less postgresql-client python-dateutil python-decorator python-docutils python-feedparser \
python-imaging python-jinja2 python-ldap python-libxslt1 node-clean-css python-lxml python-mako python-mock python-openid \
python-passlib python-psutil python-psycopg2 python-pybabel python-pychart python-pydot python-pypdf python-reportlab \
python-requests python-suds python-vatnumber python-vobject python-werkzeug python-xlwt python-yaml

Nun kann das heruntergeladene Archiv installiert werden.

• Installation des Paketes:

~# dpkg -i odoo_9.0c.latest_all.deb

Nach der Installation des Paketes wird lokal ein Port geöffnet, auf dem ein Webserver läuft.

• Anzeigen des Serverports:

~# netstat -tulpn | grep 8069
tcp        0      0 0.0.0.0:8069            0.0.0.0:*               LISTEN      17267/python

Odoo ERP besitzt eine Konfigurationsdatei, die im ersten Schritt angepasst werden muss.

• Anpassen der Konfigurationsdatei „/etc/odoo/openerp-server.conf“:

[options]
admin_passwd = <Passwort>
db_host = localhost
db_port = 5432
db_user = odoo
db_password = <Passwort>
addons_path = /usr/lib/python2.7/dist-packages/openerp/addons

In der Datenbank muss der entpsrechende Benutzer und die Datenbank erstellt werden.

• Erstellen des Benutzers:

~# su - postgres
~$ createuser -d -P odoo
Geben Sie das Passwort der neuen Rolle ein: 
Geben Sie es noch einmal ein:
~$ exit
~#

• Erstellen der Datenbank:

~# su - postgres
~$ psql
postgres=# CREATE DATABASE odoo OWNER odoo;
CREATE DATABASE
postgres=# ALTER ROLE odoo CREATEDB;
ALTER ROLE
postgres=# \q
~$ exit
~#

• Neustarten der Datenbank:

~# /etc/init.d/postgresql restart

Sind alle Anpassungen durchgeführt, kann der Odoo-Dienst neu gestartet werden.

• Neustart des Odoo-Dienstes:

~# /etc/init.d/odoo restart

Die Administration des Programms erfolgt im Webbrowser.

• Anmeldung als Administrator an folgender Adresse:

http://localhost:8069/

Email: „admin“ und Password: „admin“.

Das Programm kann jetzt über die Weboberfläche konfiguriert werden.

Zum Einstellen der deutschen Sprache bitte im Menü auf „Settings“ → „Load a Translation“ klicken und im sich öffnenden Fenster unter „Language“ → „German / Deutsch“ auswählen und mit „Load“ bestätigen. Jetzt muss die Sprache noch für den aktuell angemeldeten Benutzer geändert werden. Hierfür wieder im Menü (rechts oben) unter „Administrator“ → „Preferences“ anklicken und dort unter „Language“ ebenfalls „German / Deutsch“ auswählen. Mit einem Klick auf „Save“ wird die Einstellung gespeichert und wirksam. Optional kann unter „Timezone“ die Zeitzone auf „Europe/Berlin“ gesetzt werden.

Kurzinfo:

Im ersten Schritt müssen die vorausgesetzten Programme installiert werden. Danach kann das heruntergeladene Programm installiert werden.

• Installation von LibreOffice und JAVA JRE

~# apt-get install --no-install-recommends -y libreoffice openjdk-7-jre-headless

• Installation vom Fakturama-DEBIAN-Paket:

~# dpkg -i Installer_Fakturama_linux_64Bit_1_6_9a.deb

Beim ersten Start muss ein Arbeitsverzeichnis angegeben werden. Danach ist das Programm einsatzbereit.

Kurzinfo:

Bei der Installation des Programms werden alle notwendigen Abhängigkeiten mit installiert.

• Installation des Programms:

~# apt-get install --no-install-recommends -y gnucash

Soll das Paket aus dem Backport-Repository von Jessie installiert werden, welches die Version „2.6.11“ ist, sieht der Befehl für die Installation etwas anders aus.

• Installation aus dem Jessie-Backport-Repository:

~# apt-get install --no-install-recommends -y gnucash=1:2.6.11-1~bpo8+1 gnucash-common=1:2.6.11-1~bpo8+1 libaqbanking35 libaqbanking35-plugins libaqbanking-data=5.6.1beta-1~bpo8+1

Das Programm kann über das Menü gestartet werden.

Kurzinfo:

Bei der Installation des Programms werden alle notwendigen Abhängigkeiten mit installiert. Das Programm wurde ursprünglich für den KDE-Desktop entwickelt, wodurch bei einer anderen Desktop-Umgebung die KDE-Abhängigkeiten (hautpsächlich Bibliotheken) mit installiert werden.

• Installation des Programms:

~# apt-get install --no-install-recommends -y kraft

Das Programm kann über das Menü gestartet werden. Beim ersten Start wird die Datenbank eingerichtet und es können Kontakte aus dem Adressbuch übernommen werden.

Kurzinfo:

Im ersten Schritt müssen die vorausgesetzten Programme installiert werden. Dann kann das Archiv in das Benutzerverzeichnis entpackt und gestartet werden.

• Installation von JAVA JRE

~# apt-get install --no-install-recommends -y openjdk-7-jre-headless

• Entpacken und Umbenennen des Archivs:

~$ unzip -x /tmp/Yabs-1.2.6-beta1-package.zip

• Umbenennen des Verzeichnisses

~$ mv Yabs-1.2.6-beta1-package Yabs

• Startskript ausführbar machen:

~$ chmod u+x Yabs/yabs.sh

Der Betrieb von beiden Programmen ist grundsätzlich möglich, führt aber hier in diesem Fall zu Problemen, weil die erkannte JAVA-Version (über den Befehl „java -version“) die OpenJDK-Version ist, aber die Umgebungsvariable „JAVA_HOME“ auf das Oracle-JAVA zeigt.

• Umstellen des Standard-JAVA-Interpreters:

~# update-alternatives --config java
Es gibt 2 Auswahlmöglichkeiten für die Alternative java (welche /usr/bin/java bereitstellen).

  Auswahl      Pfad                                            Priorität Status
------------------------------------------------------------
* 0            /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java   1071      automatischer Modus
  1            /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java   1071      manueller Modus
  2            /usr/lib/jvm/jre-8-oracle-x64/bin/java           317       manueller Modus

Drücken Sie die Eingabetaste, um die aktuelle Wahl[*] beizubehalten,
oder geben Sie die Auswahlnummer ein: 2
update-alternatives: /usr/lib/jvm/jre-8-oracle-x64/bin/java wird verwendet, um /usr/bin/java (java) im manuellen Modus bereitzustellen

Das JAVA-Programm kann durch Starten der Datei „Yabs/yabs.sh“ geöffnet werden. Beim ersten Start werden einige Einstellungen abgefragt, hier ist auch das Einrichten einer MySQL-Datenbank möglich. Nach dem Einrichten der Datenbank und der eingabe der persönlichen Informationen erfolgt die Abfrage der Sprachdatei, die unter „Yabs language“ eingetragen werden kann.

Kurzinfo:

Im ersten Schritt müssen die vorausgesetzten Programme installiert werden. Dann kann das Programm selbst installiert werden.

• Installation der MySQL-Datenbank:

~# apt-get install --no-install-recommends -y mysql-server

• Installation des Programms:

~# apt-get install --no-install-recommends -y dolibarr

Das Programm kann über das Menü gestartet werden. Es wird der Webbrowser gestartet und folgende Adresse aufgerufen: „http://localhost/dolibarr/“. Hier erfolgt dann die Konfiguration.

Beim ersten Start müssen verschiedene Einstellunge vorgenommen werden. Dafür wird im ersten Fenster angezeigt, ob die Systemvoraussetzungen erfüllt sind. Mit Klick auf „Start“ geht es weiter. Im nächsten Fenster werden die Verzeichnisse angezeigt, in welchem die software ihre Dateien ablegt. Des weiteren wird im unteren Teil die Datenbank konfiguriert und durch Klicken auf „Nächster Schritt“ angelegt. Dann wird der Administrator definiert. Jetzt kann die Software verwendet werden.

Kurzinfo:

Bei der Installation des Programms werden alle notwendigen Abhängigkeiten mit installiert. Die Installation erfolgt aus dem Backport-Repository, deshalb muss die Versionsnummer mit angegeben werden.

• Installation des Programms:

~# apt-get --no-install-recommends -y install postbooks=4.9.2-1~bpo8+1 postbooks-schema-quickstart=4.9.2-1~bpo8+1 postgresql-9.4-plv8

Es muss eine Gruppe „xtrole“, sowie ein Benutzer „admin“ erstellt und der Gruppe hinzugefügt werden. Die entsprechenden Datenbankbefehle werden bereits mit dem DEBIAN-Paket mitgeliefert. Diese Datei kann importiert werden. Zum Schluss werden die eigentlichen Datenbankdaten in die Datenbank importiert. Dafür wird die Datei aus dem Internet verwendet.

• mitgelieferte Datenbankdatei importieren:

~# su - postgres
~$ cat /usr/share/doc/postbooks-schema-quickstart/init.sql | psql -U admin -W -h localhost -d pb_data
Passwort für Benutzer admin:
~$ exit
~#

• Datenbankdaten in die Datenbank importieren:

~# su - postgres
~$ createdb -U admin -W -h localhost production
Passwort:
~$ pg_restore -U admin -W -h localhost -d production quickstart-4.9.2.backup -v
pg_restore: verbinde mit der Datenbank zur Wiederherstellung
Passwort: 
pg_restore: erstelle SCHEMA api
pg_restore: erstelle SCHEMA fixcountry
pg_restore: erstelle COMMENT SCHEMA fixcountry
...
~$ exit
~#

• Neustarten der Datenbank:

~# /etc/init.d/postgresql restart

Das Programm kann über das Menü gestartet werden. Es wird im ersten Fenster darauf hingewiesen, dass es auch Übersetzungen für das Programm gibt und wo diese zu finden sind. Bisher ist es dem Autor noch nicht gelungen, die Übersetzungsdatei an die richtige Stelle zu kopieren. Dann erscheint die Login-Maske, die wie folgt ausgefüllt werden muss:

Des weiteren treten noch ein paar Merkwürdigkeiten bezüglich der Konfiguration der Software auf. Der Autor stellt dieses Programm nach hinten in der Favoritenliste.

• http://fakturama.info/
• http://bidcore.de/display/public/bidFaktura
• http://www.davaosoft.com/
• http://volle-kraft-voraus.de/De/De
• http://www.kivitendo.de/
• http://xtuple.com/products/postbooks
• http://www.dolibarr.de/
• http://www.heise.de/download/linux/office/kaufmaennische-software/warenwirtschaft-50003505043/?f=15s
• https://wiki.ubuntuusers.de/ERP
• http://www.zentyal.org/

— Steffen Bornemann 08.11.2018