X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fhtml%2Fch02s02.html;h=5cacded3d5816328165091cde73a757cefe86be7;hb=8ded2eedc25dbec2e489f81f6355fc5f0998f46d;hp=e4a8d8fe2d7fe43e42218232c460eeb7d6014311;hpb=15f021a67aa7e26458a3fbac8efe89ef9c0b0657;p=kivitendo-erp.git diff --git a/doc/html/ch02s02.html b/doc/html/ch02s02.html index e4a8d8fe2..5cacded3d 100644 --- a/doc/html/ch02s02.html +++ b/doc/html/ch02s02.html @@ -1,21 +1,164 @@ - - 2.2. Manuelle Installation des Programmpaketes

2.2. Manuelle Installation des Programmpaketes

Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.3.tgz) wird - im Dokumentenverzeichnis des Webservers (z.B. - /var/www/html/, - /srv/www/htdocs oder - /var/www/) entpackt:

cd /var/www tar xvzf
-lxoffice-erp-2.6.2.tgz

Verändern Sie evtl. noch den Namen des Verzeichnisses mit

mv lxoffice-erp/ lx-erp/

Alternativ können Sie auch einen Alias in der - Webserverkonfiguration benutzen, um auf das tatsächliche - Installationsverzeichnis zu verweisen.

Die Verzeichnisse users, - spool und webdav müssen für - den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die - restlichen Dateien müssen für diesen Benutzer lesbar sein. Der - Benutzername ist bei verschiedenen Distributionen unterschiedlich (z.B. - bei Debian/Ubuntu www-data, bei Fedora core - apache oder bei OpenSuSE - wwwrun).

Der folgende Befehl ändert den Besitzer für die oben genannten - Verzeichnisse auf einem Debian/Ubuntu-System:

chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav

Weiterhin muss der Webserver-Benutzer im Verzeichnis - templates Verzeichnisse für jeden neuen Benutzer, - der in lx-office angelegt wird, anlegen dürfen:

chgrp www-data lx-office-erp/templates
-chmod g+w lx-office-erp/templates
\ No newline at end of file + + 2.2. Benötigte Software und Pakete

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 +

  • + File::MimeInfo +

  • + GD +

  • + HTML::Parser +

  • + HTML::Restrict +

  • + Image::Info +

  • + JSON +

  • + List::MoreUtils +

  • + List::UtilsBy +

  • LWP::Authen::Digest

  • LWP::UserAgent

  • + 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 +

  • + Text::Unidecode +

  • + URI +

  • + XML::Writer +

  • + YAML +

Seit Version größer v3.5.0 sind die folgenden Pakete + hinzugekommen: Text::Unidecode, LWP::Authen::Digest, + LWP::UserAgent +

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 libtext-unidecode-perl libwww-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 perl-libwww-perl

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 perl-libwwww-perl

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.

Debian und 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.

Debian und Ubuntu:

apt install poppler-utils
+        

+

OpenSuSE:

zypper install poppler-tools

+

\ No newline at end of file