Installation¶

SQL Ledger steht als Tarball unter http://www.sql-ledger.com zum Download bereit und es gibt die Möglichkeit eines weitgehend automatisierten Installationskripts, welches in Perl programmiert wurde. Vorab sollte man folgende Pakete noch installieren.

• ssh

• acpid

• apache2

• postgresql

• libdbi-perl

• git-core

• postfix

• texlive

• texlive-lang-german

• libdbd-pg-perl (universe)

• mailutils (universe)

• gitweb (universe)

mit apturl

sudo apt-get install ssh acpid apache2 postgresql libdbi-perl git-core postfix texlive texlive-lang-german libdbd-pg-perl mailutils gitweb 

sudo aptitude install ssh acpid apache2 postgresql libdbi-perl git-core postfix texlive texlive-lang-german libdbd-pg-perl mailutils gitweb 

Anmerkung zu Ubuntu Server 14.04.4: Bei der Installation von PostgreSQL 9.3 wird bei der Installation über apt-get kein neuer Cluster erstellt. Diesen kann man aber wie folgt erstellen:

locale-gen de_DE.UTF-8
pg_createcluster --locale=de_DE.UTF-8 --encoding=UTF-8 9.3 main 

Installation über git auf Ubuntu Server 14.04¶

cd /var/www/html
git clone git://github.com/Tekki/sql-ledger.git
cd sql-ledger
mkdir spool
a2enmod cgi
service apache2 restart 

Absicherung der SQL Ledger Installation¶

cd /var/www/html/sql-ledger  
sudo chown -hR www-data.www-data users templates css spool 

Erstellen eines separaten Postgres-Nutzers¶

sudo su postgres
createuser -d -P sql-ledger 

Die beiden folgenden Fragen kann man mit "n" beantworten, man sollte sich aber das Passwort für die Rolle merken.

Danach sollte man noch mit dem Befehl

exit 

zu seinem normalen Benutzer zurück kehren.

Alternative und offizielle Installation von SQL Ledger mit Hilfe des offiziellen Perlskripts¶

sudo mkdir /var/www/sql-ledger/
cd /var/www/sql-ledger
sudo wget http://sql-ledger.com/source/setup.pl
sudo perl setup.pl 

Checking for latest version number ....
www.sql-ledger.com ... ok

SQL-Ledger ERP Installation

(i)nstall 3.0.4 (from Internet)
(d)ownload 3.0.4 (no installation)
	 
Enter: i

Enter httpd owner [] : www-data
	 
Enter httpd group [] : www-data

Status

Downloading sql-ledger-3.0.4.tar.gz ....
www.sql-ledger.com .... ok
Decompressing sql-ledger-3.0.4.tar.gz ... done
Unpacking sql-ledger-3.0.04.tar ... done
cleaning up ... done
 
This is a new installation.
 
Webserver directives were written to
 
/etc/apache2/sql-ledger-httpd.conf

Please add
 
# SQL-Ledger
Include /etc/apache2/sql-ledger-httpd.conf
 
to your httpd configuration file and restart the web server.
 
Display README (Y/n) : n

Wie in der Ausgabe andeutet, muss man noch Konfigurationen an den Webserverdirektiven vornehmen. Dazu öffnet man die Datei /etc/apache2/apache2.conf mit einem Editor^[5] mit Root-Rechte^[4] und fügt hinzu:

# SQL-Ledger
Include /etc/apache2/sql-ledger-httpd.conf

Konfiguration von SQL Ledger¶

Wurde SQL Ledger lokal auf dem Rechner installiert, sollte man sich nun über http://localhost/sql-ledger/admin.pl in die Administrationsoberfläche einloggen können. Ein Administrator-Passwort ist für den ersten Login nicht gesetzt. Man kann den Bildschirm durch einfachen Klick auf "Login" überspringen. Eine neue Firma (Mandanten) legt man durch Klick auf "Add Dataset" an. Das folgende Formular kann man wie folgt ausfüllen:

Host -> localhost bzw. die IP-Adresse des PostgreSQL-Servers
Port -> 5432
User -> Postgresnutzer, wie unter "Erstellen eines separaten Postgres-Nutzers" angegeben
Passwort -> wie unter "Erstellen eines separaten Postgres-Nutzers" angegeben
Connect to -> template1

Wenn alles geklappt hat, kann man im folgenden Bildschirm einen Namen für seine Datenbank (Dataset) sowie einen Firmennamen (Company) vergeben und schon Grundeinstellungen treffen.

Der erste Login¶

Sobald man die erste Firma eingerichtet hat, kann man sich unter http://localhost/sql-ledger/login.pl mit den Zugangsdaten "admin" - "admin" einloggen. Neue Benutzer kann man über die HR- (Human Resource) Funktion einrichten.

Fehlerbehebung und Problemlösung¶

Ein häufiger Fehler ist, dass beim Login die Perlskripte vom Server nicht ausgeführt werden und nur zum Download angeboten werden. Hier können die Ursachen wie folgt sein:

• In der apache2.conf ist kein AddHandler eingetragen

• Das Modul mod_perl ist serverseitig im Apache2 nicht aktiviert. Die Aktivierung geschieht über

# a2enmod cgi

Falls der deutsche SKR03-Kontenrahmen wegen einer fehlenden Kodierung nicht initialisiert werden kann, kann man auf die entsprechende Kodierung angepasste SQL-Skripte von folgender Adresse herunterladen:

https://github.com/Tekki/sql-ledger/blob/master/sql/

Bei der Testinstallation hat das Installationsskript die Webverzeichnisse nicht richtig eingetragen. Nachfolgend ein angepasster Eintrag fuer die apache2.conf, der auf einem virtuellen Server sowie einem Desktopsystem getestet wurde.

Alias /sql-ledger /var/www/html/sql-ledger/
<Directory /var/www/html/sql-ledger>
  AllowOverride All
  AddHandler cgi-script .pl
  Options ExecCGI Includes FollowSymlinks
  Order Allow,Deny
  Allow from All
</Directory>

<Directory /users>
  Order Deny,Allow
  Deny from All
</Directory>

Wenn man die admin.pl aufruft und die Fehlermeldung Database Driver missing! erhaelt, muss man das Paket libdbd-pg-perl aus den Universequellen nachinstallieren. Beim ersten Aufruf kann man das Passwort selbst setzen.

Aktualisierungen¶

Die jeweilige README-Datei in "SQL Ledger" gibt Hinweise bezüglich der Aktualisierung auf neue Version. Um den laufenden Betrieb zu sperren, ruft man die Administrationsoberfläche (admin.pl) auf und wählt "Lock System". Dies verhindert das Hinzufügen neuer Daten und sperrt das System. Als nächster Schritt reicht es mit Hilfe des tar-Befehls die neue Version über der alten Installation zu entpacken.

Weitere Hinweise bietet das Unterverzeichnis "doc". Die Datei UPGRADE in diesem Verzeichnis sollte dringends gelesen werden.

Im Januar 2016 erfolgte ein Versionssprung von 3.0 auf 3.2. Auch hier reicht es, den Tarball über das bestehende Verzeichnis zu entpacken, jedoch müssen für jeden Mandanten die Datenbanktabellen aktualisiert werden. Hier ist ein Login in die ERP-Software als Administrator nötig (login.pl). Es erscheint eine Meldung Upgrading to 3.2. Durch Klick auf Continue werden die Datenbanktabellen aktualisiert.

Links¶

• Projektseite

• Online-Demo

• Ledgercart Onlineshop

• SQL Ledger Network Association - mit Verzeichnis unabhängiger SQL Ledger Consultants

• Github Repository von Mankind75/tapwag - bietet bash-Installationsskripte für Ubuntuserver und CentOS.