From a7121495cf3620bf1236a35675cfd1fecfb9820a Mon Sep 17 00:00:00 2001
From: Moritz Bunkus
Date: Thu, 1 Nov 2012 11:59:41 +0100
Subject: [PATCH] =?utf8?q?Doku:=20E-Mail-Einstellungen=20und=20-Module=20e?=
=?utf8?q?rg=C3=A4nzt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit
---
doc/dokumentation.xml | 121 +++++++++++++++++++++++++++++---
doc/html/ch02.html | 19 +++--
doc/html/ch02s03.html | 2 +
doc/html/ch02s05.html | 2 +-
doc/html/ch02s06.html | 4 +-
doc/html/ch02s08.html | 4 +-
doc/html/ch02s09.html | 59 +++++++++-------
doc/html/ch02s10.html | 81 +++++++--------------
doc/html/ch02s11.html | 117 +++++++++++++++---------------
doc/html/ch02s12.html | 95 ++++++++++++++++---------
doc/html/ch02s13.html | 40 +++++++++--
doc/html/ch02s14.html | 8 +++
doc/html/ch03.html | 4 +-
doc/html/ch03s02.html | 2 +-
doc/html/ch04.html | 32 ++++-----
doc/html/index.html | 6 +-
doc/kivitendo-Dokumentation.pdf | Bin 583159 -> 591661 bytes
17 files changed, 366 insertions(+), 230 deletions(-)
create mode 100644 doc/html/ch02s14.html
diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml
index 25b52d39e..51b81c97b 100644
--- a/doc/dokumentation.xml
+++ b/doc/dokumentation.xml
@@ -103,6 +103,10 @@
Email::Address
+
+ Email::MIME
+
+
JSON
@@ -111,6 +115,12 @@
List::MoreUtils
+ Net::SMTP::SSL (optional, bei E-Mail-Versand über SSL; siehe Abschnitt "E-Mail-Versand aus kivitendo heraus")
+
+ Net::SSLGlue (optional, bei E-Mail-Versand über TLS; siehe Abschnitt "E-Mail-Versand aus kivitendo heraus")
+
Params::Validate
@@ -156,6 +166,9 @@
+ 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
@@ -184,31 +197,27 @@
apt-get install apache2 postgresql libparent-perl libarchive-zip-perl \
libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl \
- libemail-address-perl liblist-moreutils-perl libpdf-api2-perl \
+ libemail-address-perl libemail-mime-perl liblist-moreutils-perl libpdf-api2-perl \
librose-object-perl librose-db-perl librose-db-object-perl \
libtemplate-perl libtext-csv-xs-perl libtext-iconv-perl liburi-perl \
libxml-writer-perl libyaml-perl libconfig-std-perl \
- libparams-validate-perl libjson-perl libclass-accessor-perl
+ libparams-validate-perl libjson-perl libclass-accessor-perl \
+ libnet-sslglue-perl libnet-smtp-ssl-perl
Für Fedora Core benötigen Sie diese Pakete:yum install httpd postgresql-server perl-parent perl-DateTime \
- perl-DBI perl-DBD-Pg perl-Email-Address perl-List-MoreUtils \
+ perl-DBI perl-DBD-Pg perl-Email-Address perl-Email-MIME perl-List-MoreUtils \
perl-PDF-API2 perl-Rose-Object perl-Rose-DB perl-Rose-DB-Object \
perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI \
- perl-XML-Writer perl-YAML
+ perl-XML-Writer perl-YAML perl-Net-SSLGlue perl-Net-SMTP-SSL
Für OpenSuSE benötigen Sie diese Pakete:zypper install apache2 postgresql-server perl-Archive-Zip \
- perl-DateTime perl-DBI perl-DBD-Pg perl-MailTools perl-List-MoreUtils \
+ perl-DateTime perl-DBI perl-DBD-Pg perl-Email-MIME perl-MailTools perl-List-MoreUtils \
perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv \
- perl-URI perl-XML-Writer perl-YAML
-
- Bei openSuSE 11 ist parent bereits enthalten,
- und braucht nicht nachinstalliert werden. Die
- Rose::* Pakete sind derzeit nicht für SuSE gepackt,
- und müssen anderweitig nachinstalliert werden.
+ perl-URI perl-XML-Writer perl-YAML perl-Net-SSLGlue perl-Net-SMTP-SSL
kivitendo enthält ein Script, mit dem überprüft werden kann, ob
alle benötigten Perl-Module installiert sind. Der Aufruf lautet wie
@@ -335,6 +344,11 @@ tar xvzf kivitendo-erp-2.6.3.tgz
environment
+
+ mail_delivery (siehe Abschnitt "E-Mail-Versand aus kivitendo
+ heraus")
+
+
print_templates
@@ -1274,6 +1288,91 @@ insserv kivitendo-task-server
+
+ E-Mail-Versand aus kivitendo heraus
+
+ kivitendo kann direkt aus dem Programm heraus E-Mails versenden, z.B. um ein Angebot direkt an einen Kunden zu
+ verschicken. Damit dies funktioniert, muss eingestellt werden, über welchen Server die E-Mails verschickt werden sollen. kivitendo
+ unterstützt dabei zwei Mechanismen: Versand über einen lokalen E-Mail-Server (z.B. mit Postfix oder
+ Exim, was auch die standardmäÃig aktive Methode ist) sowie Versand über einen SMTP-Server (z.B. der des
+ eigenen Internet-Providers).
+
+ Welche Methode und welcher Server verwendet werden, wird über die Konfigurationsdatei config/kivitendo.conf
+ festgelegt. Dort befinden sich alle Einstellungen zu diesem Thema im Abschnitt '[mail_delivery]'.
+
+
+ Versand über lokalen E-Mail-Server
+
+ Diese Methode bietet sich an, wenn auf dem Server, auf dem kivitendo läuft, bereits ein funktionsfähiger E-Mail-Server wie
+ z.B. Postfix, Exim oder Sendmail läuft.
+
+ Um diese Methode auszuwählen, muss der Konfigurationsparameter 'method = sendmail' gesetzt sein. Dies ist
+ gleichzeitig der Standardwert, falls er nicht verändert wird.
+
+ Um zu kontrollieren, wie das Programm zum Einliefern gestartet wird, dient der Parameter 'sendmail =
+ ...'. Der Standardwert verweist auf das Programm /usr/bin/sendmail, das bei allen oben genannten
+ E-Mail-Serverprodukten für diesen Zweck funktionieren sollte.
+
+ Die Konfiguration des E-Mail-Servers selber würde den Rahmen dieses sprengen. Hierfür sei auf die Dokumentation des
+ E-Mail-Servers verwiesen.
+
+
+
+ Versand über einen SMTP-Server
+
+ Diese Methode bietet sich an, wenn kein lokaler E-Mail-Server vorhanden oder zwar einer vorhanden, dieser aber nicht
+ konfiguriert ist.
+
+ Um diese Methode auszuwählen, muss der Konfigurationsparameter 'method = smtp' gesetzt sein. Die folgenden
+ Parameter dienen dabei der weiteren Konfiguration:
+
+
+
+ hostname
+
+ Name oder IP-Adresse des SMTP-Servers. Standardwert: 'localhost'
+
+
+
+ port
+
+ Portnummer. Der Standardwert hängt von der verwendeten Verschlüsselungsmethode ab. Gilt 'security =
+ none' oder 'security = tls', so ist 25 die Standardportnummer. Für 'security =
+ ssl' ist 465 die Portnummer. Muss normalerweise nicht geändert werden.
+
+
+
+ security
+
+ Wahl der zu verwendenden Verschlüsselung der Verbindung mit dem Server. Standardwert ist
+ 'none', wodurch keine Verschlüsselung verwendet wird. Mit 'tls' wird TLS-Verschlüsselung
+ eingeschaltet, und mit 'ssl' wird Verschlüsselung via SSL eingeschaltet. Achtung: Für
+ 'tls' und 'ssl' werden zusätzliche Perl-Module benötigt (siehe unten).
+
+
+
+ login und password
+
+ Falls der E-Mail-Server eine Authentifizierung verlangt, so können mit diesen zwei Parametern der Benutzername
+ und das Passwort angegeben werden. Wird Authentifizierung verwendet, so sollte aus Sicherheitsgründen auch eine Form von
+ Verschlüsselung aktiviert werden.
+
+
+
+ Wird Verschlüsselung über TLS oder SSL aktiviert, so werden zusätzliche Perl-Module benötigt. Diese sind:
+
+
+ TLS-Verschlüsselung: Modul Net::SSLGlue (Debian-Paketname
+ libnet-sslglue-perl, Fedora Core: perl-Net-SSLGlue, openSuSE:
+ perl-Net-SSLGlue
+
+ SSL-Verschlüsselung: Modul Net::SMTP::SSL (Debian-Paketname
+ libnet-smtp-ssl-perl, Fedora Core: perl-Net-SMTP-SSL, openSuSE:
+ perl-Net-SMTP-SSL
+
+
+
+
Drucken mit kivitendo
diff --git a/doc/html/ch02.html b/doc/html/ch02.html
index 95ad65e7b..467bf4678 100644
--- a/doc/html/ch02.html
+++ b/doc/html/ch02.html
@@ -9,7 +9,8 @@
dass kivitendo auf ihnen läuft:
Ubuntu 10.04 LTS Lucid Lynx bis 12.04 Precise Pangolin
Debian 5.0 Lenny und 6.0 Squeeze
openSUSE 11.2 und 11.3
SuSE Linux Enterprice Server 11
Fedora 13 bis 16
2.1.2. Pakete
Zum Betrieb von kivitendo werden zwingend ein Webserver (meist
Apache) und ein Datenbankserver (PostgreSQL, mindestens v8.2)
benötigt.
Zusätzlich benötigt kivitendo die folgenden Perl-Pakete, die
- nicht Bestandteil einer Standard-Perl-Installation sind:
parent
Archive::Zip
Config::Std
DateTime
DBI
DBD::Pg
Email::Address
JSON
List::MoreUtils
Params::Validate
PDF::API2
Rose::Object
Rose::DB
Rose::DB::Object
Template
Text::CSV_XS
Text::Iconv
URI
XML::Writer
YAML
Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete
+ nicht Bestandteil einer Standard-Perl-Installation sind:
Bei openSuSE 11 ist parent bereits enthalten,
- und braucht nicht nachinstalliert werden. Die
- Rose::* Pakete sind derzeit nicht für SuSE gepackt,
- und müssen anderweitig nachinstalliert werden.
kivitendo enthält ein Script, mit dem überprüft werden kann, ob
+ perl-URI perl-XML-Writer perl-YAML perl-Net-SSLGlue perl-Net-SMTP-SSL
kivitendo enthält ein Script, mit dem überprüft werden kann, ob
alle benötigten Perl-Module installiert sind. Der Aufruf lautet wie
folgt: