Dokumentation für 3.4 angepasst
[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.0: 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>6.0 "Squeeze" (hier muss allerdings das Modul FCGI in der Version &gt;= 0.72 compiled werden, und <code class="literal">Rose::DB::Object</code> ist zu alt)</p></li><li class="listitem"><p>7.0 "Wheezy"</p></li></ul></div></li><li class="listitem"><p>Ubuntu 12.04 LTS "Precise Pangolin", 12.10 "Quantal Quetzal", 13.04 "Precise Pangolin", 14.04 "Trusty Tahr" LTS, 15.10 "Wily Werewolf" und 16.04 "Xenial Xerus" LTS Alpha </p></li><li class="listitem"><p>openSUSE 12.2, 12.3 und 13.1</p></li><li class="listitem"><p>SuSE Linux Enterprice Server 11</p></li><li class="listitem"><p>Fedora 16 bis 19</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
10         Apache) und ein Datenbankserver (PostgreSQL, mindestens v8.4)
11         benötigt.</p><p>Zusätzlich benötigt kivitendo einige Perl-Pakete, die nicht Bestandteil einer Standard-Perl-Installation sind. Um zu
12         überprüfen, ob die erforderlichen Pakete installiert und aktuell genug sind, wird ein Script mitgeliefert, das wie folgt aufgerufen
13         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>
14                      <code class="literal">parent</code> (nur bei Perl vor 5.10.1)</p></li><li class="listitem"><p>
15                      <code class="literal">Archive::Zip</code>
16                   </p></li><li class="listitem"><p>
17                      <code class="literal">Algorithm::CheckDigits</code>
18                   </p></li><li class="listitem"><p>
19                      <code class="literal">Config::Std</code>
20                   </p></li><li class="listitem"><p>
21                      <code class="literal">DateTime</code>
22                   </p></li><li class="listitem"><p>
23                      <code class="literal">DBI</code>
24                   </p></li><li class="listitem"><p>
25                      <code class="literal">DBD::Pg</code>
26                   </p></li><li class="listitem"><p>
27                      <code class="literal">Email::Address</code>
28                   </p></li><li class="listitem"><p>
29                      <code class="literal">Email::MIME</code>
30                   </p></li><li class="listitem"><p>
31                      <code class="literal">FCGI</code> (nicht Versionen 0.68 bis 0.71 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>
32                      <code class="literal">File::Copy::Recursive</code>
33                   </p></li><li class="listitem"><p>
34                      <code class="literal">JSON</code>
35                   </p></li><li class="listitem"><p>
36                      <code class="literal">List::MoreUtils</code>
37                   </p></li><li class="listitem"><p>
38                      <code class="literal">Net::SMTP::SSL</code> (optional, bei 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>
39                      <code class="literal">Net::SSLGlue</code> (optional, bei 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>
40                      <code class="literal">Params::Validate</code>
41                   </p></li><li class="listitem"><p>
42                      <code class="literal">PBKDF2::Tiny</code>
43                   </p></li><li class="listitem"><p>
44                      <code class="literal">PDF::API2</code>
45                   </p></li><li class="listitem"><p>
46                      <code class="literal">Rose::Object</code>
47                   </p></li><li class="listitem"><p>
48                      <code class="literal">Rose::DB</code>
49                   </p></li><li class="listitem"><p>
50                      <code class="literal">Rose::DB::Object</code> Version 0.788 oder neuer</p></li><li class="listitem"><p>
51                      <code class="literal">Template</code>
52                   </p></li><li class="listitem"><p>
53                      <code class="literal">Text::CSV_XS</code>
54                   </p></li><li class="listitem"><p>
55                      <code class="literal">Text::Iconv</code>
56                   </p></li><li class="listitem"><p>
57                      <code class="literal">URI</code>
58                   </p></li><li class="listitem"><p>
59                      <code class="literal">XML::Writer</code>
60                   </p></li><li class="listitem"><p>
61                      <code class="literal">YAML</code>
62                   </p></li></ul></div><p>Seit Version v3.4.0 sind die folgenden Pakete hinzugekommen: <code class="literal">Algorithm::CheckDigits</code>
63                <code class="literal">PBKDF2::Tiny</code>
64             </p><p>Seit Version v3.2.0 sind die folgenden Pakete hinzugekommen: <code class="literal">GD</code>, <code class="literal">HTML::Restrict</code>, <code class="literal">Image::Info</code>
65             </p><p>Seit v3.0.0 sind die folgenden Pakete hinzugekommen: <code class="literal">File::Copy::Recursive</code>.</p><p>Seit v2.7.0 sind die folgenden Pakete hinzugekommen: <code class="literal">Email::MIME</code>, <code class="literal">Net::SMTP::SSL</code>,
66         <code class="literal">Net::SSLGlue</code>.</p><p>Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete
67         hinzugekommen, <code class="literal">URI</code> und
68         <code class="literal">XML::Writer</code> sind notwendig. Ohne startet kivitendo
69         nicht.</p><p>Gegenüber Version 2.6.1 sind <code class="literal">parent</code>,
70         <code class="literal">DateTime</code>, <code class="literal">Rose::Object</code>,
71         <code class="literal">Rose::DB</code> und <code class="literal">Rose::DB::Object</code>
72         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
73         hinzugekommen.</p><p>
74                <code class="literal">Email::Address</code> und
75         <code class="literal">List::MoreUtils</code> sind schon länger feste
76         Abhängigkeiten, wurden aber bisher mit kivitendo mitgeliefert. Beide
77         sind auch in 2.6.1 weiterhin mit ausgeliefert, wurden in einer
78         zukünftigen Version aber aus dem Paket entfernt werden. Es wird
79         empfohlen diese Module zusammen mit den anderen als Bibliotheken zu
80         installieren.</p><div class="sect3" title="2.2.2.1. Debian und Ubuntu"><div class="titlepage"><div><div><h4 class="title"><a name="d0e386"></a>2.2.2.1. Debian und Ubuntu</h4></div></div></div><p>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:</p><pre class="programlisting">apt-get install apache2 libarchive-zip-perl libclone-perl \
81   libconfig-std-perl libdatetime-perl libdbd-pg-perl libdbi-perl \
82   libemail-address-perl  libemail-mime-perl libfcgi-perl libjson-perl \
83   liblist-moreutils-perl libnet-smtp-ssl-perl libnet-sslglue-perl \
84   libparams-validate-perl libpdf-api2-perl librose-db-object-perl \
85   librose-db-perl librose-object-perl libsort-naturally-perl \
86   libstring-shellquote-perl libtemplate-perl libtext-csv-xs-perl \
87   libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl \
88   libimage-info-perl libgd-gd2-perl libapache2-mod-fcgid \
89   libfile-copy-recursive-perl postgresql libalgorithm-checkdigits-perl \
90   libcrypt-pbkdf2-perl git
91 </pre><p>Für das Paket HTML::Restrict gibt es kein Debian-Paket, dies muß per CPAN installiert werden. Unter Ubuntu funktioniert das mit:</p><pre class="programlisting">apt-get install build-essential
92 cpan HTML::Restrict</pre></div><div class="sect3" title="2.2.2.2. Fedora Core"><div class="titlepage"><div><div><h4 class="title"><a name="d0e397"></a>2.2.2.2. Fedora Core</h4></div></div></div><p>Für Fedora Core stehen die meisten der benötigten Perl-Pakete als RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl installiert werden:</p><pre class="programlisting">yum install httpd perl-Archive-Zip perl-Clone perl-DBD-Pg \
93   perl-DBI perl-DateTime perl-Email-Address perl-Email-MIME perl-FCGI \
94   perl-File-Copy-Recursive perl-JSON perl-List-MoreUtils perl-Net-SMTP-SSL perl-Net-SSLGlue \
95   perl-PDF-API2 perl-Params-Validate perl-Rose-DB perl-Rose-DB-Object \
96   perl-Rose-Object perl-Sort-Naturally perl-String-ShellQuote \
97   perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI \
98   perl-XML-Writer perl-YAML perl-parent postgresql-server</pre><p>Zusätzlich müssen einige Pakete aus dem CPAN installiert werden. Dazu können Sie die folgenden Befehle nutzen:</p><pre class="programlisting">yum install perl-CPAN
99 cpan Config::Std</pre></div><div class="sect3" title="2.2.2.3. openSUSE"><div class="titlepage"><div><div><h4 class="title"><a name="d0e408"></a>2.2.2.3. openSUSE</h4></div></div></div><p>Für openSUSE stehen die meisten der benötigten Perl-Pakete als RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl
100           installiert werden:</p><pre class="programlisting">zypper install apache2 perl-Archive-Zip perl-Clone \
101   perl-Config-Std perl-DBD-Pg perl-DBI perl-DateTime perl-Email-Address \
102   perl-Email-MIME perl-FastCGI perl-File-Copy-Recursive perl-JSON perl-List-MoreUtils \
103   perl-Net-SMTP-SSL perl-Net-SSLGlue perl-PDF-API2 perl-Params-Validate \
104   perl-Sort-Naturally perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv \
105   perl-URI perl-XML-Writer perl-YAML postgresql-server</pre><p>Zusätzlich müssen einige Pakete aus dem CPAN installiert werden. Dazu können Sie die folgenden Befehle nutzen:</p><pre class="programlisting">yum install perl-CPAN
106 cpan Rose::Db::Object</pre></div></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>