Dokumentation neu generiert
[kivitendo-erp.git] / doc / html / ch02s02.html
1 <html><head>
2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3    <title>2.2. Benötigte Software und Pakete</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.4.1: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="next" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.2. Benötigte Software und Pakete</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.2. Benötigte Software und Pakete"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Ben%C3%B6tigte-Software-und-Pakete"></a>2.2. Benötigte Software und Pakete</h2></div></div></div><div class="sect2" title="2.2.1. Betriebssystem"><div class="titlepage"><div><div><h3 class="title"><a name="Betriebssystem"></a>2.2.1. Betriebssystem</h3></div></div></div><p>kivitendo ist für Linux konzipiert, und sollte auf jedem
4         unixoiden Betriebssystem zum Laufen zu kriegen sein. Getestet ist
5         diese Version im speziellen auf Debian und Ubuntu, grundsätzlich wurde
6         bei der Auswahl der Pakete aber darauf Rücksicht genommen, dass es
7         ohne große Probleme auf den derzeit aktuellen verbreiteten
8         Distributionen läuft.</p><p>Anfang 2016 sind das folgende Systeme, von denen bekannt ist,
9         dass kivitendo auf ihnen läuft:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Debian</p><div class="itemizedlist"><ul class="itemizedlist" type="circle"><li class="listitem"><p>7.0 "Wheezy"</p></li><li class="listitem"><p>8.0 "Jessie"</p></li></ul></div></li><li class="listitem"><p>Ubuntu 12.04 LTS "Precise Pangolin", 14.04 "Trusty Tahr"
10             LTS, 15.10 "Wily Werewolf" und 16.04 "Xenial Xerus" LTS
11             Alpha</p></li><li class="listitem"><p>openSUSE LEAP 42.1</p></li><li class="listitem"><p>Fedora 22</p></li></ul></div></div><div class="sect2" title="2.2.2. Benötigte Perl-Pakete installieren"><div class="titlepage"><div><div><h3 class="title"><a name="Pakete"></a>2.2.2. Benötigte Perl-Pakete installieren</h3></div></div></div><p>Zum Betrieb von kivitendo werden zwingend ein Webserver (meist
12         Apache) und ein Datenbankserver (PostgreSQL) in einer aktuellen Version
13         (s.a. Liste der unterstützten Betriebssysteme) benötigt.</p><p>Zusätzlich benötigt kivitendo einige Perl-Pakete, die nicht
14         Bestandteil einer Standard-Perl-Installation sind. Um zu überprüfen,
15         ob die erforderlichen Pakete installiert und aktuell genug sind, wird
16         ein Script mitgeliefert, das wie folgt aufgerufen wird:</p><pre class="programlisting">./scripts/installation_check.pl</pre><p>Die vollständige Liste der benötigten Perl-Module lautet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
17                      <code class="literal">parent</code> (nur bei Perl vor 5.10.1)</p></li><li class="listitem"><p>
18                      <code class="literal">Archive::Zip</code>
19                   </p></li><li class="listitem"><p>
20                      <code class="literal">Algorithm::CheckDigits</code>
21                   </p></li><li class="listitem"><p>
22                      <code class="literal">CGI</code>
23                   </p></li><li class="listitem"><p>
24                      <code class="literal">Clone</code>
25                   </p></li><li class="listitem"><p>
26                      <code class="literal">Config::Std</code>
27                   </p></li><li class="listitem"><p>
28                      <code class="literal">DateTime</code>
29                   </p></li><li class="listitem"><p>
30                      <code class="literal">DateTime::Format::Strptime</code>
31                   </p></li><li class="listitem"><p>
32                      <code class="literal">DBI</code>
33                   </p></li><li class="listitem"><p>
34                      <code class="literal">DBD::Pg</code>
35                   </p></li><li class="listitem"><p>
36                      <code class="literal">Email::Address</code>
37                   </p></li><li class="listitem"><p>
38                      <code class="literal">Email::MIME</code>
39                   </p></li><li class="listitem"><p>
40                      <code class="literal">MIME::Entity</code>
41                   </p></li><li class="listitem"><p>
42                      <code class="literal">MIME::Parser</code>
43                   </p></li><li class="listitem"><p>
44                      <code class="literal">FCGI</code> (nicht Versionen 0.68 bis 0.71
45             inklusive; siehe <a class="xref" href="ch02s06.html#Apache-Konfiguration.FCGI.WebserverUndPlugin" title="2.6.2.3. Getestete Kombinationen aus Webservern und Plugin">Abschnitt&nbsp;2.6.2.3, „Getestete Kombinationen aus Webservern und Plugin“</a>)</p></li><li class="listitem"><p>
46                      <code class="literal">File::Copy::Recursive</code>
47                   </p></li><li class="listitem"><p>
48                      <code class="literal">GD</code>
49                   </p></li><li class="listitem"><p>
50                      <code class="literal">HTML::Parser</code>
51                   </p></li><li class="listitem"><p>
52                      <code class="literal">HTML::Restrict</code>
53                   </p></li><li class="listitem"><p>
54                      <code class="literal">Image::Info</code>
55                   </p></li><li class="listitem"><p>
56                      <code class="literal">JSON</code>
57                   </p></li><li class="listitem"><p>
58                      <code class="literal">List::MoreUtils</code>
59                   </p></li><li class="listitem"><p>
60                      <code class="literal">List::UtilsBy</code>
61                   </p></li><li class="listitem"><p>
62                      <code class="literal">Net::SMTP::SSL</code> (optional, bei
63             E-Mail-Versand über SSL; siehe Abschnitt "<a class="xref" href="ch02s11.html#config.sending-email.smtp" title="2.11.2. Versand über einen SMTP-Server">E-Mail-Versand über einen SMTP-Server</a>")</p></li><li class="listitem"><p>
64                      <code class="literal">Net::SSLGlue</code> (optional, bei
65             E-Mail-Versand über TLS; siehe Abschnitt "<a class="xref" href="ch02s11.html#config.sending-email.smtp" title="2.11.2. Versand über einen SMTP-Server">E-Mail-Versand über einen SMTP-Server</a>")</p></li><li class="listitem"><p>
66                      <code class="literal">Params::Validate</code>
67                   </p></li><li class="listitem"><p>
68                      <code class="literal">PBKDF2::Tiny</code>
69                   </p></li><li class="listitem"><p>
70                      <code class="literal">PDF::API2</code>
71                   </p></li><li class="listitem"><p>
72                      <code class="literal">Rose::Object</code>
73                   </p></li><li class="listitem"><p>
74                      <code class="literal">Rose::DB</code>
75                   </p></li><li class="listitem"><p>
76                      <code class="literal">Rose::DB::Object</code> Version 0.788 oder
77             neuer</p></li><li class="listitem"><p>
78                      <code class="literal">String::ShellQuote</code>
79                   </p></li><li class="listitem"><p>
80                      <code class="literal">Sort::Naturally</code>
81                   </p></li><li class="listitem"><p>
82                      <code class="literal">Template</code>
83                   </p></li><li class="listitem"><p>
84                      <code class="literal">Text::CSV_XS</code>
85                   </p></li><li class="listitem"><p>
86                      <code class="literal">Text::Iconv</code>
87                   </p></li><li class="listitem"><p>
88                      <code class="literal">URI</code>
89                   </p></li><li class="listitem"><p>
90                      <code class="literal">XML::Writer</code>
91                   </p></li><li class="listitem"><p>
92                      <code class="literal">YAML</code>
93                   </p></li></ul></div><p>Seit Version v3.4.0 sind die folgenden Pakete hinzugekommen:
94         <code class="literal">Algorithm::CheckDigits</code>
95                <code class="literal">PBKDF2::Tiny</code>
96             </p><p>Seit Version v3.2.0 sind die folgenden Pakete hinzugekommen:
97         <code class="literal">GD</code>, <code class="literal">HTML::Restrict</code>,
98         <code class="literal">Image::Info</code>
99             </p><p>Seit v3.0.0 sind die folgenden Pakete hinzugekommen:
100         <code class="literal">File::Copy::Recursive</code>.</p><p>Seit v2.7.0 sind die folgenden Pakete hinzugekommen:
101         <code class="literal">Email::MIME</code>, <code class="literal">Net::SMTP::SSL</code>,
102         <code class="literal">Net::SSLGlue</code>.</p><p>Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete
103         hinzugekommen, <code class="literal">URI</code> und
104         <code class="literal">XML::Writer</code> sind notwendig. Ohne startet kivitendo
105         nicht.</p><p>Gegenüber Version 2.6.1 sind <code class="literal">parent</code>,
106         <code class="literal">DateTime</code>, <code class="literal">Rose::Object</code>,
107         <code class="literal">Rose::DB</code> und <code class="literal">Rose::DB::Object</code>
108         neu hinzugekommen. <code class="literal">IO::Wrap</code> wurde entfernt.</p><p>Gegenüber Version 2.6.3 ist <code class="literal">JSON</code> neu
109         hinzugekommen.</p><p>
110                <code class="literal">Email::Address</code> und
111         <code class="literal">List::MoreUtils</code> sind schon länger feste
112         Abhängigkeiten, wurden aber bisher mit kivitendo mitgeliefert. Beide
113         sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer
114         zukünftigen Version aber aus dem Paket entfernt werden. Es wird
115         empfohlen diese Module zusammen mit den anderen als Bibliotheken zu
116         installieren.</p><div class="sect3" title="2.2.2.1. Debian und Ubuntu"><div class="titlepage"><div><div><h4 class="title"><a name="d0e452"></a>2.2.2.1. Debian und Ubuntu</h4></div></div></div><p>Für Debian und Ubuntu stehen die meisten der benötigten
117           Perl-Pakete als Debian-Pakete zur Verfügung. Sie können mit
118           folgendem Befehl installiert werden:</p><pre class="programlisting">apt install  apache2 libarchive-zip-perl libclone-perl \
119   libconfig-std-perl libdatetime-perl libdbd-pg-perl libdbi-perl \
120   libemail-address-perl  libemail-mime-perl libfcgi-perl libjson-perl \
121   liblist-moreutils-perl libnet-smtp-ssl-perl libnet-sslglue-perl \
122   libparams-validate-perl libpdf-api2-perl librose-db-object-perl \
123   librose-db-perl librose-object-perl libsort-naturally-perl \
124   libstring-shellquote-perl libtemplate-perl libtext-csv-xs-perl \
125   libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl \
126   libimage-info-perl libgd-gd2-perl libapache2-mod-fcgid \
127   libfile-copy-recursive-perl postgresql libalgorithm-checkdigits-perl \
128   libcrypt-pbkdf2-perl git libcgi-pm-perl
129 </pre><p>Für das Paket HTML::Restrict gibt es kein Debian-Paket, dies
130           muß per CPAN installiert werden. Unter Ubuntu funktioniert das
131           mit:</p><pre class="programlisting">apt-get install build-essential
132 cpan HTML::Restrict</pre></div><div class="sect3" title="2.2.2.2. Fedora"><div class="titlepage"><div><div><h4 class="title"><a name="d0e463"></a>2.2.2.2. Fedora</h4></div></div></div><p>Für Fedora stehen die meisten der benötigten Perl-Pakete als
133           RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl
134           installiert werden:</p><pre class="programlisting">dnf install httpd mod_fcgid perl-Archive-Zip perl-Clone perl-DBD-Pg \
135   perl-DBI perl-DateTime perl-Email-Address perl-Email-MIME perl-FCGI \
136   perl-File-Copy-Recursive perl-JSON perl-List-MoreUtils perl-Net-SMTP-SSL perl-Net-SSLGlue \
137   perl-PDF-API2 perl-Params-Validate perl-Rose-DB perl-Rose-DB-Object \
138   perl-Rose-Object perl-Sort-Naturally perl-String-ShellQuote \
139   perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI \
140   perl-XML-Writer perl-YAML perl-parent postgresql-server perl-CPAN \
141   perl-Algorithm-CheckDigits perl-GD perl-Class-XSAccessor perl-Text-Balanced</pre><p>Zusätzlich müssen einige Pakete aus dem CPAN installiert
142           werden. Dazu können Sie die folgenden Befehle nutzen:</p><pre class="programlisting">cpan Config::Std HTML::Restrict</pre></div><div class="sect3" title="2.2.2.3. openSUSE"><div class="titlepage"><div><div><h4 class="title"><a name="d0e474"></a>2.2.2.3. openSUSE</h4></div></div></div><p>Für openSUSE stehen die meisten der benötigten Perl-Pakete als
143           RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl
144           installiert werden:</p><pre class="programlisting">zypper install apache2 apache2-mod_fcgid perl-Archive-Zip perl-Clone \
145   perl-Config-Std perl-DBD-Pg perl-DBI perl-DateTime perl-Email-Address \
146   perl-Email-MIME perl-FastCGI perl-File-Copy-Recursive perl-JSON perl-List-MoreUtils \
147   perl-Net-SMTP-SSL perl-Net-SSLGlue perl-PDF-API2 perl-Params-Validate \
148   perl-Sort-Naturally perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv \
149   perl-URI perl-XML-Writer perl-YAML perl-CPAN \
150   perl-Algorithm-CheckDigits perl-GD perl-Class-XSAccessor postgresql-server</pre><p>Zusätzlich müssen einige Pakete aus dem CPAN installiert
151           werden. Dazu können Sie die folgenden Befehle nutzen:</p><pre class="programlisting">cpan Rose::Db::Object</pre></div></div><div class="sect2" title="2.2.3. Andere Pakete installieren"><div class="titlepage"><div><div><h3 class="title"><a name="d0e485"></a>2.2.3. Andere Pakete installieren</h3></div></div></div><p>Seit Version v3.4.0 wird für den Bankimport optional das Paket
152         'aqbanking-tools' benötigt.</p><p>Ubuntu: </p><pre class="programlisting">apt install aqbanking-tools</pre><p>
153             </p><p>OpenSuSE: </p><pre class="programlisting">zypper install aqbanking-tools</pre><p>
154             </p><p>Seit Version v3.4.1 wird generell zum Feststellen der
155         Seitenanzahl von PDF_Dokumenten 'pdfinfo' benötigt was im Paket
156         'poppler-utils' enthalten ist.</p><p>Ubuntu: </p><pre class="programlisting">apt install poppler-utils</pre><p>
157             </p><p>OpenSuSE: </p><pre class="programlisting">zypper install poppler-tools</pre><p>
158             </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s03.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 2. Installation und Grundkonfiguration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.3. Manuelle Installation des Programmpaketes</td></tr></table></div></body></html>