projekt kivitendo

h1. Installation Ubuntu 14.04.2 LTS

*VERALTET! Bitte die aktuelle kivitendo Doku nutzen und dies nur als Ergänzung lesen*

Aktuelle Doku: [https://www.kivitendo.de/kivi/doc/html/ch02s02.html]

* kivitendo 3.2.1

* Postgres 9.3

* Apache 2.4.7

Basierend auf Anleitung

https://www.kivitendo.de/doc/html/ch02s02.html

Dies ist eine Minimalinstallation, und geht davon aus, daß außer kivitendo sonst keine Dienste auf dem Server laufen, so daß es Server-intern keine Schutzmechanismen (z.B. Datenbankpasswort, eigener Datenbankbenutzer) für die Datenbank gibt.

h2. Ubuntu vorbereiten

> sudo su -

> apt-get install apache2 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 postgresql

> apt-get install build-essential

> cpan HTML::Restrict

h2. kivitendo per git installieren

> apt-get install git vim

> cd /usr/local/src/

> git clone https://github.com/kivitendo/kivitendo-erp.git

optional an dieser Stelle: einem normalen Benutzer die Verzeichnisrechte für kivitendo geben, damit man später nicht alles im kivitendo-Verzeichnis als root macht, dann sollten die meisten, der folgenden Schritte auch mit diesem User durchgeführt werden

> chown -R kivitendo.kivitendo kivitendo-erp/

> cd kivitendo-erp/

> git checkout release-3.2.1

> mkdir webdav

> ./scripts/installation_check.pl

Die nächsten beiden Zeile als root oder per sudo:

> chown -R www-data users spool webdav

> chown www-data templates users

> cp config/kivitendo.conf.default config/kivitendo.conf

> vim config/kivitendo.conf

<pre>

[authentication]

admin_password = admin123

[authentication/database]

host     = 127.0.0.1

port     = 5432

db       = kivitendo_auth

user     = postgres

password =

</pre>

h2. Postgres konfigurieren

Datenbank konfigurieren, passwortloser Zugang für lokalen Zugriff

> vim /etc/postgresql/9.3/main/pg_hba.conf

<pre>

local   all             postgres                                peer

local   all             all                                     peer

host    all             all             127.0.0.1/32            trust

host    all             all             ::1/128                 reject

</pre>

> service postgresql reload

Zugriff testen:

> psql -U postgres -h 127.0.0.1 -p 5432

h2. Apache konfigurieren

> vim /etc/apache2/sites-available/default-ssl.conf

<pre>

AddHandler fcgid-script .fpl

AliasMatch ^/kivitendo-erp/[^/]+\.pl /usr/local/src/kivitendo-erp/dispatcher.fpl

Alias       /kivitendo-erp/          /usr/local/src/kivitendo-erp/

FcgidMaxRequestLen 10485760

<Directory /usr/local/src/kivitendo-erp>

  AllowOverride All

  Options ExecCGI Includes FollowSymlinks

  Require all granted

</Directory>

<DirectoryMatch /usr/local/src/kivitendo-erp/users>

  Order Deny,Allow

  Deny from All

</DirectoryMatch>

</pre>

> apt-get install libapache2-mod-fcgid

> a2enmod ssl

> a2enmod fcgid

> a2ensite default-ssl

> service apache2 reload

h2. kivitendo starten

Am Besten auf der initial benötigten Admin-Seite, mit dem in kivitendo.conf vergebenen Admin-Passwort:

https://localhost/kivitendo-erp/controller.pl?action=Admin/login

h2. Backup

<pre>

#!/bin/bash

for i in datenbankname kivitendo_auth;

  do pg_dump -U postgres -h 127.0.0.1 $i > /backup/kivitendo/`date +%A`-$i.sql

done

pg_dumpall -U postgres -h 127.0.0.1  >  /backup/kivitendo/`date +%A`-dumpall.sql

</pre>