2.2. Benötigte Software und Pakete

2.2.1. Betriebssystem

kivitendo ist für Linux konzipiert, und sollte auf jedem unixoiden Betriebssystem zum Laufen zu kriegen sein. Getestet ist diese Version im speziellen auf Debian und Ubuntu, grundsätzlich wurde bei der Auswahl der Pakete aber darauf Rücksicht genommen, dass es ohne große Probleme auf den derzeit aktuellen verbreiteten Distributionen läuft.

Anfang 2016 sind das folgende Systeme, von denen bekannt ist, dass kivitendo auf ihnen läuft:

  • Debian

    • 7.0 "Wheezy"

    • 8.0 "Jessie"

  • Ubuntu 12.04 LTS "Precise Pangolin", 14.04 "Trusty Tahr" LTS, 15.10 "Wily Werewolf" und 16.04 "Xenial Xerus" LTS Alpha

  • openSUSE LEAP 42.1

  • Fedora 22

2.2.2. Benötigte Perl-Pakete installieren

Zum Betrieb von kivitendo werden zwingend ein Webserver (meist Apache) und ein Datenbankserver (PostgreSQL) in einer aktuellen Version (s.a. Liste der unterstützten Betriebssysteme) benötigt.

Zusätzlich benötigt kivitendo einige Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind. Um zu überprüfen, ob die erforderlichen Pakete installiert und aktuell genug sind, wird ein Script mitgeliefert, das wie folgt aufgerufen wird:

./scripts/installation_check.pl

Die vollständige Liste der benötigten Perl-Module lautet:

  • parent (nur bei Perl vor 5.10.1)

  • Archive::Zip

  • Algorithm::CheckDigits

  • CGI

  • Clone

  • Config::Std

  • DateTime

  • DateTime::Format::Strptime

  • DBI

  • DBD::Pg

  • Email::Address

  • Email::MIME

  • FCGI (nicht Versionen 0.68 bis 0.71 inklusive; siehe Abschnitt 2.6.2.3, „Getestete Kombinationen aus Webservern und Plugin“)

  • File::Copy::Recursive

  • GD

  • HTML::Parser

  • HTML::Restrict

  • Image::Info

  • JSON

  • List::MoreUtils

  • List::UtilsBy

  • Net::SMTP::SSL (optional, bei E-Mail-Versand über SSL; siehe Abschnitt "E-Mail-Versand über einen SMTP-Server")

  • Net::SSLGlue (optional, bei E-Mail-Versand über TLS; siehe Abschnitt "E-Mail-Versand über einen SMTP-Server")

  • Params::Validate

  • PBKDF2::Tiny

  • PDF::API2

  • Rose::Object

  • Rose::DB

  • Rose::DB::Object Version 0.788 oder neuer

  • String::ShellQuote

  • Sort::Naturally

  • Template

  • Text::CSV_XS

  • Text::Iconv

  • URI

  • XML::Writer

  • YAML

Seit Version v3.4.0 sind die folgenden Pakete hinzugekommen: Algorithm::CheckDigits PBKDF2::Tiny

Seit Version v3.2.0 sind die folgenden Pakete hinzugekommen: GD, HTML::Restrict, Image::Info

Seit v3.0.0 sind die folgenden Pakete hinzugekommen: File::Copy::Recursive.

Seit v2.7.0 sind die folgenden Pakete hinzugekommen: Email::MIME, Net::SMTP::SSL, Net::SSLGlue.

Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete hinzugekommen, URI und XML::Writer sind notwendig. Ohne startet kivitendo nicht.

Gegenüber Version 2.6.1 sind parent, DateTime, Rose::Object, Rose::DB und Rose::DB::Object neu hinzugekommen. IO::Wrap wurde entfernt.

Gegenüber Version 2.6.3 ist JSON neu hinzugekommen.

Email::Address und List::MoreUtils sind schon länger feste Abhängigkeiten, wurden aber bisher mit kivitendo mitgeliefert. Beide sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer zukünftigen Version aber aus dem Paket entfernt werden. Es wird empfohlen diese Module zusammen mit den anderen als Bibliotheken zu installieren.

2.2.2.1. Debian und Ubuntu

Für Debian und Ubuntu stehen die meisten der benötigten Perl-Pakete als Debian-Pakete zur Verfügung. Sie können mit folgendem Befehl installiert werden:

apt 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 libapache2-mod-fcgid \
  libfile-copy-recursive-perl postgresql libalgorithm-checkdigits-perl \
  libcrypt-pbkdf2-perl git libcgi-pm-perl

Für das Paket HTML::Restrict gibt es kein Debian-Paket, dies muß per CPAN installiert werden. Unter Ubuntu funktioniert das mit:

apt-get install build-essential
cpan HTML::Restrict

2.2.2.2. Fedora

Für Fedora stehen die meisten der benötigten Perl-Pakete als RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl installiert werden:

dnf install httpd mod_fcgid perl-Archive-Zip perl-Clone perl-DBD-Pg \
  perl-DBI perl-DateTime perl-Email-Address perl-Email-MIME perl-FCGI \
  perl-File-Copy-Recursive perl-JSON perl-List-MoreUtils perl-Net-SMTP-SSL perl-Net-SSLGlue \
  perl-PDF-API2 perl-Params-Validate perl-Rose-DB perl-Rose-DB-Object \
  perl-Rose-Object perl-Sort-Naturally perl-String-ShellQuote \
  perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI \
  perl-XML-Writer perl-YAML perl-parent postgresql-server perl-CPAN \
  perl-Algorithm-CheckDigits perl-GD perl-Class-XSAccessor perl-Text-Balanced

Zusätzlich müssen einige Pakete aus dem CPAN installiert werden. Dazu können Sie die folgenden Befehle nutzen:

cpan Config::Std HTML::Restrict

2.2.2.3. openSUSE

Für openSUSE stehen die meisten der benötigten Perl-Pakete als RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl installiert werden:

zypper install apache2 apache2-mod_fcgid perl-Archive-Zip perl-Clone \
  perl-Config-Std perl-DBD-Pg perl-DBI perl-DateTime perl-Email-Address \
  perl-Email-MIME perl-FastCGI perl-File-Copy-Recursive perl-JSON perl-List-MoreUtils \
  perl-Net-SMTP-SSL perl-Net-SSLGlue perl-PDF-API2 perl-Params-Validate \
  perl-Sort-Naturally perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv \
  perl-URI perl-XML-Writer perl-YAML perl-CPAN \
  perl-Algorithm-CheckDigits perl-GD perl-Class-XSAccessor postgresql-server

Zusätzlich müssen einige Pakete aus dem CPAN installiert werden. Dazu können Sie die folgenden Befehle nutzen:

cpan Rose::Db::Object

2.2.3. Andere Pakete installieren

Seit Version v3.4.0 wird für den Bankimport optional das Paket 'aqbanking-tools' benötigt.

Ubuntu:

apt install aqbanking-tools

OpenSuSE:

zypper install aqbanking-tools

Seit Version v3.4.1 wird generell zum Feststellen der Seitenanzahl von PDF_Dokumenten 'pdfinfo' benötigt was im Paket 'poppler-utils' enthalten ist.

Ubuntu:

apt install poppler-utils

OpenSuSE:

zypper install poppler-tools