Installation von Simple Invoices auf Debian Etch

Version 1.0
Author: Falko Timme


Diese Anleitung veranschaulicht, wie man Simple Invoices auf einem Debian Etch Server installiert. Simple Invoices ist ein web-basiertes elementares Abrechnungssystem, das Dir dabei hilft Rechnungen zu erstellen und zu verwalten. Es gibt die Rechnungen als PDF oder Excel Dateien aus, mailt sie Deinen Kunden, etc. Es ist auf kleine Betriebe/Organisationen und auf private Nutzer zugeschnitten.

Diese Anleitung ist ohne jegliche Gewähr! Ich übernehme keine Garantie, dass dies auch bei Dir funktioniert!

1 Vorbemerkung

In dieser Anleitung verwende ich den Hostnamen server1.example.com mit der IP Adresse 192.168.0.100. Deine Einstellungen werden wahrscheinlich von meinen abweichen, Du musst sie also an entsprechender Stelle ändern.

Simple Invoices benötigt ein Apache-MySQL-PHP System. PHP sollte GD2 (für das Erstellen von PDF Rechnungen) und XSL (für Berichte) unterstützen. In dieser Anleitung werde ich Apache, PHP und MySQL auf einem frisch aufgesetzten Debian System installieren und ich werde Simple Invoices im Standard Apache vhost in /var/www installieren. Wenn Apache, PHP und MySQL bereits installiert und auch weitere Apache vhosts konfiguriert hast, wirst Du die Einstellungen in dieser Anleitung an Deine Wünsche anpassen müssen.

2 Installation von MySQL 5.0

Zunächst installieren wir MySQL 5.0 wie folgt:

apt-get install mysql-server mysql-client

Richte ein Passwort für den MySQL Benutzer root (ersetze yourrootsqlpassword mit dem Passwort, das Du verwenden möchtest) an:

mysqladmin -u root password yourrootsqlpassword

Überprüfe dann mit

netstat -tap | grep mysql

auf welcher Adresse MySQL hört. Sieht die Ausgabe wie folgt aus:

tcp 0 0 localhost.localdo:mysql *:* LISTEN 2713/mysqld

was bedeutet, dass MySQL nur auf localhost.localdomain hört, dann ist das Passwort, das Du zuvor angelegt hast, sicher. Sieht die Ausgabe allerdings so aus:

tcp 0 0 *:mysql *:* LISTEN 2713/mysqld

solltest Du auch ein MySQL Passwort für Deinen Hostnamen einrichten, da sonst jeder auf Deine Datenbank zugreifen und Daten verändern kann:

mysqladmin -h server1.example.com -u root password yourrootsqlpassword


3 Installation von Apache/PHP5/phpMyAdmin

Als Nächstes installieren wir Apache2 zusammen mit PHP5 (inklusive GD2 und XSL Unterstützung) und phpMyAdmin. phpMyAdmin wird nicht benötigt, aber es macht sich immer ganz gut es zu haben, für den Fall dass Du ein GUI für den Zugriff auf Deine MySQL Datenbank haben möchtest:

apt-get install apache2 apache2-mpm-prefork libapache2-mod-php5 php5 php5-gd php5-mysql php5-xsl phpmyadmin

Richte danach Deinen Browser auf http://192.168.0.100/phpmyadmin/ um zu überprüfen, ob phpMyAdmin funktioniert. Wenn Du etwas in der Art siehst, ist alles in Ordnung:

4 Konfiguriation von PHP

Da Simple Invoices in der Lage ist, PDF Rechnungen zu erstellen, solltest Du mindestens 24MB Arbeitsspeicher für PHP bereitstellen. Daher öffnen wir /etc/php5/apache2/php.ini und setzen memory_limit auf 24M:

vi /etc/php5/apache2/php.ini
[...]
;;;;;;;;;;;;;;;;;;; ; Resource Limits ; ;;;;;;;;;;;;;;;;;;; max_execution_time = 30 ; Maximum execution time of each script, in seconds max_input_time = 60 ; Maximum amount of time each script may spend parsing request data memory_limit = 24M ; Maximum amount of memory a script may consume (16MB) [...]
Starte danach Apache neu (starte auch neu, wenn Du php.ini nicht ändern musstest - wir müssen es einmal neu starten damit die GD2 und XSL Module, die wir im vorherigen Kapitel installiert haben, aktiviert werden):

/etc/init.d/apache2 restart

Sofern Du in Deiner Apache Installation nicht bereits virtuelle Hosts erstellt hast, ist der Dokumenten Root der Standard Website /var/www. Wir erstellen nun eine kleine PHP Datei (info.php) in diesem Verzeichnis (wenn Du virtuelle Hosts erstellt hast, platziere sie in einem der virtuellen Hosts, das PHP aktiviert hat) und rufen sie in einem Browser ab. Die Datei wird eine Menge nützlicher Angaben über unsere PHP Installation anzeigen, wie zum Beispiel die installierte PHP Version.

vi /var/www/info.php


<?php
phpinfo(); ?>
Nun rufen wir diese Datei in einem Browser auf (z.B. http://192.168.0.100/info.php):


Wenn Du runter scrollst, siehst Du nun die gd und xsl Module (wenn nicht, ist etwas schief gelaufen):


5 Erstellen einer Datenbank für Simple Invoices

Bevor wir Simple Invoices installieren, erstellen wir eine MySQL Datenbank namens simpleinvoices und einen MySQL Benutzer (mit der gleichen Bezeichnung simpleinvoices):

mysql -u root -p


CREATE DATABASE simpleinvoices;
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP ON simpleinvoices.* TO 'simpleinvoices'@'localhost' IDENTIFIED BY 'simpleinvoicessqlpassword';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP ON simpleinvoices.* TO 'simpleinvoices'@'localhost.localdomain' IDENTIFIED BY 'simpleinvoicessqlpassword';
FLUSH PRIVILEGES;

Ersetze den String simpleinvoicessqlpassword mit einem Passwort Deiner Wahl für den MySQL Benutzer simpleinvoices.

quit;

Wie Dir vielleicht aufgefallen ist, verlassen wir die MySQL Kommandozeile mit dem quit; Befehl und sind wieder in der Linux Kommandozeile.

6 Installation von Simple Invoices

Gehe nun zur Simple Invoices Website und zieh Dir eine Kopie der Software und lade sie auf Dein Debian System wie folgt (ich lade sie in das /tmp Verzeichnis):

cd /tmp
wget http://kent.dl.sourceforge.net/sourceforge/simpleinvoices/simpleinvoices-20070525.zip

Das Paket ist im .zip Format, also müssen wir unzip installieren, damit wir die Software dekomprimieren können:

apt-get install unzip

Nun können wir das Simple Invoices Paket dekomprimieren:

unzip simpleinvoices-20070525.zip

Somit erstellen wir ein Verzeichnis simpleinvoices, welches alle anderen Dateien beinhaltet. Jetzt verschieben wir dieses simpleinvoices Verzeichnis zum Dokumenten Root unserer Website (wie ich bereits erwähnt habe, verwende ich hier den Standard Dokumenten Root /var/www - falls Deiner davon abweicht, passe die Befehle dieser Anleitung an Deine Wünsche an):

mv simpleinvoices /var/www/

Als Nächstes erstellen wir die benötigten Datenbanktabellen in unserer simpleinvoices Datenbank. Simple Invoices hat zwei MySQL Dumps, einen für MySQL 4.1 und aufwärts und einen für alle älteren MySQL Versionen. Da wir zuvor MySQL 5.0 installiert haben, nutzen wir den Dump für Mysql 4.1 und die weiteren Versionen:

cd /var/www/simpleinvoices
mysql -h localhost -u simpleinvoices -psimpleinvoicessqlpassword simpleinvoices < SimpleInvoices.sql

Ersetze simpleinvoicessqlpassword mit Deinem eigenen Passwort für den MySQL Benutzer simpleinvoices. Bitte beachte, dass zwischen -p und dem Passwort kein Leerraum sein darf!

Danach können wir den MySQL Dumps löschen, der mit Simple Invoices einherging:

rm -f SimpleInvoices*.sql

2 Kommentar(e)

Zum Posten von Kommentaren bitte

Kommentare

Von: rawe28

Sehr gutes Howto.Klappt alle bestens.
ab der Authentfizierung gibt es jedoch bei mir Problem



Beim anschließenden, erneuten Aufruf der Adresse wird ein Fehler ausgegeben und zwar wird die Datei include('./include/auth/auth.php');

nicht gefunden.

Ich hab ISPConfig installiert. Kann es damit zusammenhängen?

Gruß
rawe


Von: rawe28

!!!A C H T U N G !!!

!!!ATEI NICHT RUNTERLADEN !!! IST KAPUTT!!

AKTUELLE DATEI VON http://www.simpleinvoices.org/ HOLEN