Installationsanleitung

Inhalt

  • Installation unter Windows (mit XAMPP)
  • Installation unter Debian oder Ubuntu mit dem Installations-Assistenten
  • Manuelle Installation unter Debian oder Ubuntu
  • Installation eines Beispiel-Kontenplans

Installation unter Windows (mit XAMPP)

Eine Installationsanleitung für das HTML5-Haushaltsbuch unter Windows mit XAMPP wird bald zur Verfügung gestellt.

Nach der Installation von XAMPP können sie für die Installation des Haushaltsbuchs entsprechend der folgenden Beschreibung für Linux vorgehen. Beginnen Sie dazu ab dem Entpacken der Installationsdateien (dann ins htdocs-Verzeichnis Ihrer XAMPP-Installation).

Installation unter Debian oder Ubuntu mit dem Installations-Assistenten

Für eine geführte Installation mittels Installationsassistent gehen Sie wie folgt vor. In einem ersten Schritt müssen Sie Ihr System für die Installation vorbereiten, d.h. die erforderlichen Softwarekomponenten installieren, sofern diese noch nicht auf dem System installiert sind.

Erforderliche Komponenten sind:

  • ein Apache2-Webserver (installierbar via apt-get install apache2)
  • ein Mysql-Datenbankserver (installierbar via apt-get install mysql-server)
  • PHP5 mit Integration in den Apache Webserver (apt-get install libapache2-mod-php5 php5)

Zur Vorbereitung der Installation kopieren Sie bitte die Installationsdateien in das Server-Verzeichnis entpacken. Abhängig von der verwendeten Debian bzw. Ubuntu-Version liegt das Root-Verzeichnis des Webservers entweder unter /var/www/ oder unter /var/www/html/. In diesem Verzeichnis legen Sie ein neues Verzeichnis an, in das Sie das HTML5-Haushaltsbuch installieren wollen. In unserem Beispiel verwenden wir hier das Verzeichnis fibu. Entpacken Sie die Quelldateien des HTML5-Haushaltsbuch in dieses Verzeichnis.

Danach können Sie den Installationsassistenten durch die Eingabe der URL http://localhost/fibu/install.php.

Die Einstiegsmaske des Installations-Assistenten. Sie weist auf den Einstieg in die geführte Installation des HTML5-Haushaltsbuch hin und führt noch zu keiner tatsächlichen Installationsoperation.
Über diese Maske können bzw. müssen Sie Ihre Datenbankverbindung konfigurieren. Geben Sie dazu den von Ihnen gewünschten Datenbanknutzer und das zugehörige Passwort ein. Wenn sich Ihre Datenbank auf dem gleichen Rechner befindet, wie Ihr Apache-Webserver, dann sind die Parameter Hostname und Port bereits richtig konfiguriert.

Beim Parameter Datenbankname geben Sie bitte den Namen der Datenbank an, in die Sie die Daten Ihres Haushaltsbuchs speichern wollen. Sollten Sie noch keine entsprechende Datenbank angelegt haben können Sie das wie im folgenden Code-Snippet durchführen.

# mysql -u BENUTZERNAME -p
mysql> create database fibu;

Als Benutzernamen und Passwort verwenden Sie bitte eine Kombination, die den Verbindungsaufbau mit Ihrer Datenbank erlaubt.
In diesem Schritt wird in der durch die vorher angegebenen Verbindungsdaten spezifizierten Datenbank das Schema der Datenbank des HTML5-Haushaltsbuchs angelegt. Dieser Schritt kann bei einer leeren Datenbank völlig bedenkenlos ausgeführt werden. (Das ist z. B. dann der Fall, wenn Sie wie im vorherigen Schritt die Datenbank fibu erst frisch angelegt haben).
In diesem Schritt müssen Sie mindestens einen Benutzer anlegen, mit dem Sie sich später am Haushaltsbuch anmelden können. Dabei wird neben dem Benutzer auch der Standard-Mandant mit der ID 1 angelegt.
Bitte starten Sie nun über den untenstehenden Button das HTML5-Haushaltsbuch und testen Sie ob alles wie erwünscht funktioniert. Das Anlegen von Konten, das Anlegen von Schnellbuchungen und das Erfassen von Buchungen. Ist alles in Ordnung gehen Sie wie angegeben vor und löschen Sie die Datei install.php und den Ordner /install.

Sollten danach Fehler auftreten prüfen Sie bitte folgendes:

Unter Ubuntu (und manchen anderen Linux Distributionen) werden .htaccess-Dateien standardmäßig nicht durch den Apache-Webserver ausgewertet. Um diese Funktion zu aktivieren ist es erforderlich in der Datei /etc/apache2/apache2.conf einige Einstellungen zu prüfen und ggf. zu korrigieren.

# cd /etc/apache2/
# vim apache2.conf

Darin: mit "<Esc> /.htaccess" nach dem folgenden Eintrag suchen:

AccessFileName .htaccess

Sollte dieser mit einem # auskommentiert sein entfernen Sie das #.

Danach korrigieren Sie den Bereich <Directory /var/www> so, dass er wie folgt aussieht
<Directory /var/www/>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>

und speichern die Datei mit "<Esc> :wq"

Manuelle Installation unter Debian oder Ubuntu

Vor der Installation laut folgendem Code-Listing bitte falls nicht bereits vorhanden apache2, php5 und mysql5.x z. B. mittels apt-get installieren.

# cd /var/www
# mkdir fibu
# cd fibu
# wget https://github.com/wolfgang-wiedermann/php_mobile_accounting/archive/v0.1.04.tar.gz
# tar -zxf v0.1.04.tar.gz
# cd php_mobile_accounting-0.1.04
# mv * ..
# cd ..
# rm -r php_mobile_accounting-0.1.04
# cd lib
# cp Database.php.template Database.php
# vim Database.php
// Datenbankverbindung konfigurieren
# cd ..
# mysql -u BENUTZERNAME -p
mysql> create database fibu;
mysql> use fibu;
mysql> \. sql/create-tables-and-views.sql
mysql> insert into fi_user values(0, 'benutzername', 'Benutzerbeschreibung', 1, now());
mysql> insert into fi_mandant values(0, 'Mandantbeschreibung', 1, now());
mysql> quit
# htpasswd -c .passwd benutzername
# vim .htaccess
// Noch den Pfad zur Datei .passwd eintragen

Installation eines Beispiel-Kontenplans mit vorbereiteten Buchungs-Shortcuts

Die Installation des Beispiel-Kontenplans setzt ein vollständig installiertes HTML5-Haushaltsbuch (siehe Beispiel für Ubuntu oder Debian) voraus.

# wget https://raw.githubusercontent.com/wolfgang-wiedermann/php_mobile_accounting/master/sql/sample_kontenplan_single.sql
# mysql -u BENUTZERNAME -p
mysql> \. sample_kontenplan_single.sql
mysql> quit