Kapitel 1. Aktuelle Hinweise

Kapitel 1. Aktuelle Hinweise
ZurÃ¼ck		Weiter

2.2.2.1. Debian und Ubuntu

Alle benÃ¶tigten Perl-Pakete stehen fÃ¼r Debian und Ubuntu als Debian-Pakete zur VerfÃ¼gung. Sie kÃ¶nnen mit folgendem Befehl + installieren.

2.2.2.1. Debian und Ubuntu

Alle benÃ¶tigten Perl-Pakete stehen fÃ¼r Debian und Ubuntu als Debian-Pakete zur VerfÃ¼gung. Sie kÃ¶nnen mit folgendem Befehl installiert werden:

apt-get 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 \
@@ -79,14 +79,14 @@
   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 \
-  libfile-copy-recursive-perl postgresql

2.2.2.2. Fedora Core

FÃ¼r Fedora Core stehen die meisten der benÃ¶tigten Perl-Pakete als RPM-Pakete zur VerfÃ¼gung. Sie kÃ¶nnen mit folgendem Befehl installeirt werden:

yum install httpd perl-Archive-Zip perl-Clone perl-DBD-Pg \
+  libfile-copy-recursive-perl postgresql

2.2.2.2. Fedora Core

FÃ¼r Fedora Core stehen die meisten der benÃ¶tigten Perl-Pakete als RPM-Pakete zur VerfÃ¼gung. Sie kÃ¶nnen mit folgendem Befehl installeirt werden:

yum install httpd 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

ZusÃ¤tzlich mÃ¼ssen einige Pakete aus dem CPAN installiert werden. Dazu kÃ¶nnen Sie die folgenden Befehle nutzen:

yum install perl-CPAN
-cpan Config::Std

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 +cpan Config::Std

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 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 \
diff --git a/doc/html/ch02s06.html b/doc/html/ch02s06.html
index c8329b677..8adafac8c 100644
--- a/doc/html/ch02s06.html
+++ b/doc/html/ch02s06.html
@@ -1,6 +1,6 @@
 
       
-   2.6. Webserver-Konfiguration2.6. Webserver-Konfiguration
ZurÃ¼ck  Kapitel 2. Installation und Grundkonfiguration  Weiter
2.6. Webserver-Konfiguration
2.6.1. Grundkonfiguration mittels CGI
Anmerkung
FÃ¼r einen deutlichen Performanceschub sorgt die AusfÃ¼hrung
+   2.6. Webserver-Konfiguration
2.6. Webserver-Konfiguration
ZurÃ¼ck  Kapitel 2. Installation und Grundkonfiguration  Weiter
2.6. Webserver-Konfiguration
2.6.1. Grundkonfiguration mittels CGI
Anmerkung
FÃ¼r einen deutlichen Performanceschub sorgt die AusfÃ¼hrung
           mittels FastCGI/FCGI. Die Einrichtung wird ausfÃ¼hrlich im Abschnitt
           Konfiguration fÃ¼r FastCGI/FCGI beschrieben.
Der Zugriff auf das Programmverzeichnis muss in der Apache
         Webserverkonfigurationsdatei httpd.conf eingestellt
diff --git a/doc/html/ch02s07.html b/doc/html/ch02s07.html
index 76a6c3467..577f2b5c6 100644
--- a/doc/html/ch02s07.html
+++ b/doc/html/ch02s07.html
@@ -29,7 +29,7 @@
         Links aus einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess
         einzubinden. Da das bei neueren Linux-Distributionen aber nicht
         zwangslÃ¤ufig funktioniert, werden auch Start-Scripte mitgeliefert, die
-        anstelle eines symbolischen Links verwendet werden kÃ¶nnen.
2.7.2.1. SystemV-basierende Systeme (z.B. Debian, Ã¤ltere OpenSUSE, Ã¤ltere Fedora Core)
Kopieren Sie die Datei
+        anstelle eines symbolischen Links verwendet werden kÃ¶nnen.
2.7.2.1. SystemV-basierende Systeme (z.B. Debian, Ã¤ltere OpenSUSE, Ã¤ltere Fedora Core)
Kopieren Sie die Datei
           scripts/boot/system-v/kivitendo-server
           nach /etc/init.d/kivitendo-server. Passen
           Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile
@@ -37,12 +37,12 @@
           Boot-Prozess ein. Dies ist distributionsabhÃ¤ngig:
Debian-basierende Systeme:
update-rc.d kivitendo-task-server defaults
 # Nur bei Debian Squeeze und neuer:
 insserv kivitendo-task-server
Ãltere OpenSUSE und Ã¤ltere Fedora Core:
chkconfig --add kivitendo-task-server
Danach kann der Task-Server mit dem folgenden Befehl gestartet
-          werden:
/etc/init.d/kivitendo-task-server start
2.7.2.2. Upstart-basierende Systeme (z.B. Ubuntu)
Kopieren Sie die Datei
+          werden:
/etc/init.d/kivitendo-task-server start
2.7.2.2. Upstart-basierende Systeme (z.B. Ubuntu)
Kopieren Sie die Datei
           scripts/boot/upstart/kivitendo-task-server.conf
           nach /etc/init/kivitendo-task-server.conf.
           Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile
           exec ....).
Danach kann der Task-Server mit dem folgenden Befehl gestartet
-          werden:
service kivitendo-task-server start
2.7.2.3. systemd-basierende Systeme (z.B. neure OpenSUSE, neuere Fedora Core)
Verlinken Sie die Datei scripts/boot/systemd/kivitendo-task-server.service nach
+          werden:
service kivitendo-task-server start
2.7.2.3. systemd-basierende Systeme (z.B. neure OpenSUSE, neuere Fedora Core)
Verlinken Sie die Datei scripts/boot/systemd/kivitendo-task-server.service nach
           /etc/systemd/system/. Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile
           ExecStart=.... und ExecStop=...). Binden Sie das Script in den Boot-Prozess ein.
           
Alle hierzu benÃ¶tigten Befehle sehen so aus:
cd /var/www/kivitendo-erp/scripts/boot/systemd
diff --git a/doc/html/ch03s02.html b/doc/html/ch03s02.html
index 9866b342d..01554890c 100644
--- a/doc/html/ch03s02.html
+++ b/doc/html/ch03s02.html
@@ -566,7 +566,7 @@
                         invdate
                      Rechnungsdatum

                         invnumber
-                     
Rechnungsnummer
3.2.10. Variablen in anderen Vorlagen
3.2.10.1. EinfÃ¼hrung
Die Variablen in anderen Vorlagen sind Ã¤hnlich wie in der
+                     
Rechnungsnummer
3.2.10. Variablen in anderen Vorlagen
3.2.10.1. EinfÃ¼hrung
Die Variablen in anderen Vorlagen sind Ã¤hnlich wie in der
           Rechnung. Allerdings heiÃen die Variablen, die mit
           inv beginnen, jetzt anders. Bei den Angeboten
           fangen sie mit quo fÃ¼r "quotation" an:
diff --git a/doc/html/ch04.html b/doc/html/ch04.html
index ca228b368..7584f82f0 100644
--- a/doc/html/ch04.html
+++ b/doc/html/ch04.html
@@ -1,6 +1,6 @@
 
       
-   Kapitel 4. Entwicklerdokumentation
Kapitel 4. Entwicklerdokumentation
ZurÃ¼ck     Weiter
Kapitel 4. Entwicklerdokumentation
4.1. Globale Variablen
4.1.1. Wie sehen globale Variablen in Perl aus?
Globale Variablen liegen in einem speziellen namespace namens
+   Kapitel 4. Entwicklerdokumentation
Kapitel 4. Entwicklerdokumentation
ZurÃ¼ck     Weiter
Kapitel 4. Entwicklerdokumentation
4.1. Globale Variablen
4.1.1. Wie sehen globale Variablen in Perl aus?
Globale Variablen liegen in einem speziellen namespace namens
         "main", der von Ã¼berall erreichbar ist. DarÃ¼ber hinaus sind bareword
         globs global und die meisten speziellen Variablen sind...
         speziell.
Daraus ergeben sich folgende Formen:

@@ -25,7 +25,7 @@
               $PACKAGE::form.

                      local $form
                   
Alle Ãnderungen an $form werden am Ende
-              des scopes zurÃ¼ckgesetzt
4.1.2. Warum sind globale Variablen ein Problem?
Das erste Problem ist FCGIâ¢.

+              des scopes zurÃ¼ckgesetzt
4.1.2. Warum sind globale Variablen ein Problem?
Das erste Problem ist FCGIâ¢.

                SQL-Ledgerâ¢ hat fast alles im globalen
         namespace abgelegt, und erwartet, dass es da auch wiederzufinden ist.
         Unter FCGIâ¢ mÃ¼ssen diese Sachen aber wieder
@@ -39,7 +39,7 @@
         dies hat, seit der EinfÃ¼hrung, u.a. schon so manche langwierige
         Bug-Suche verkÃ¼rzt. Da globale Variablen aber implizit mit Package
         angegeben werden, werden die nicht geprÃ¼ft, und somit kann sich
-        schnell ein Tippfehler einschleichen.
4.1.3. Kanonische globale Variablen
Um dieses Problem im Griff zu halten gibt es einige wenige
+        schnell ein Tippfehler einschleichen.
4.1.3. Kanonische globale Variablen
Um dieses Problem im Griff zu halten gibt es einige wenige
         globale Variablen, die kanonisch sind, d.h. sie haben bestimmte
         vorgegebenen Eigenschaften, und alles andere sollte anderweitig
         umhergereicht werden.
Diese Variablen sind im Moment die folgenden neun:

@@ -62,7 +62,7 @@
                      $::request
                   
Damit diese nicht erneut als MÃ¼llhalde missbraucht werden, im
         Folgenden eine kurze ErlÃ¤uterung der bestimmten vorgegebenen
-        Eigenschaften (Konventionen):
4.1.3.1. $::form
Ist ein Objekt der Klasse
+        Eigenschaften (Konventionen):
4.1.3.1. $::form
Ist ein Objekt der Klasse
               "Form"
Wird nach jedem Request gelÃ¶scht
Muss auch in Tests und Konsolenscripts vorhanden
               sein.
EnthÃ¤lt am Anfang eines Requests die Requestparameter vom
               User
Kann zwar intern Ã¼ber Requestgrenzen ein Datenbankhandle
@@ -110,7 +110,7 @@
   push @{ $form->{TEMPLATE_ARRAYS}{number} },          $form->{"partnumber_$i"};
   push @{ $form->{TEMPLATE_ARRAYS}{description} },     $form->{"description_$i"};
   # ...
-}
4.1.3.2. %::myconfig
Das einzige Hash unter den globalen Variablen
Wird spÃ¤testens benÃ¶tigt wenn auf die Datenbank
+}
4.1.3.2. %::myconfig
Das einzige Hash unter den globalen Variablen
Wird spÃ¤testens benÃ¶tigt wenn auf die Datenbank
               zugegriffen wird
Wird bei jedem Request neu erstellt.
EnthÃ¤lt die Userdaten des aktuellen Logins
Sollte nicht ohne Filterung irgendwo gedumpt werden oder
               extern serialisiert werden, weil da auch der Datenbankzugriff
               fÃ¼r diesen user drinsteht.
EnthÃ¤lt unter anderem Listenbegrenzung vclimit,
@@ -122,10 +122,10 @@
           Ã¼berwiegend die Daten, die sich unter Programm
           -> Einstellungen befinden, bzw. die
           Informationen Ã¼ber den Benutzer die Ã¼ber die
-          Administrator-Schnittstelle eingegeben wurden.
4.1.3.3. $::locale
Objekt der Klasse "Locale"
Wird pro Request erstellt
Muss auch fÃ¼r Tests und Scripte immer verfÃ¼gbar
+          Administrator-Schnittstelle eingegeben wurden.
4.1.3.3. $::locale
Objekt der Klasse "Locale"
Wird pro Request erstellt
Muss auch fÃ¼r Tests und Scripte immer verfÃ¼gbar
               sein.
Cached intern Ã¼ber Requestgrenzen hinweg benutzte
               Locales
Lokalisierung fÃ¼r den aktuellen User. Alle Ãbersetzungen,
-          Zahlen- und Datumsformatierungen laufen Ã¼ber dieses Objekt.
4.1.3.4. $::lxdebug
Objekt der Klasse "LXDebug"
Wird global gecached
Muss immer verfÃ¼gbar sein, in nahezu allen
+          Zahlen- und Datumsformatierungen laufen Ã¼ber dieses Objekt.
4.1.3.4. $::lxdebug
Objekt der Klasse "LXDebug"
Wird global gecached
Muss immer verfÃ¼gbar sein, in nahezu allen
               Funktionen

                   $::lxdebug stellt Debuggingfunktionen
           bereit, wie "enter_sub" und
@@ -135,14 +135,14 @@
           "message" und "dump" mit
           denen man flott Informationen ins Log (tmp/kivitendo-debug.log)
           packen kann.
Beispielsweise so:
$main::lxdebug->message(0, 'Meine Konfig:' . Dumper (%::myconfig));
-$main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{vc});
4.1.3.5. $::auth
Objekt der Klasse "SL::Auth"
Wird global gecached
Hat eine permanente DB Verbindung zur Authdatenbank
Wird nach jedem Request resettet.

+$main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{vc});
4.1.3.5. $::auth
Objekt der Klasse "SL::Auth"
Wird global gecached
Hat eine permanente DB Verbindung zur Authdatenbank
Wird nach jedem Request resettet.

                   $::auth stellt Funktionen bereit um die
           Rechte des aktuellen Users abzufragen. Obwohl diese Informationen
           vom aktuellen User abhÃ¤ngen wird das Objekt aus
           GeschwindigkeitsgrÃ¼nden nur einmal angelegt und dann nach jedem
           Request kurz resettet.
Dieses Objekt kapselt auch den gerade aktiven Mandanten. Dessen Einstellungen kÃ¶nnen Ã¼ber
           $::auth->client abgefragt werden; RÃ¼ckgabewert ist ein Hash mit den Werten aus der Tabelle
-          auth.clients.
4.1.3.6. $::lx_office_conf
Objekt der Klasse
+          auth.clients.
4.1.3.6. $::lx_office_conf
Objekt der Klasse
               "SL::LxOfficeConf"
Global gecached
ReprÃ¤sentation der
               config/kivitendo.conf[.default]-Dateien
Globale Konfiguration. Configdateien werden zum Start gelesen
           und danach nicht mehr angefasst. Es ist derzeit nicht geplant, dass
@@ -152,16 +152,16 @@ $main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{
 file = /tmp/kivitendo-debug.log
ist der Key file im Programm als
           $::lx_office_conf->{debug}{file}
           erreichbar.
Warnung
Zugriff auf die Konfiguration erfolgt im Moment Ã¼ber
-            Hashkeys, sind also nicht gegen Tippfehler abgesichert.
4.1.3.7. $::instance_conf
Objekt der Klasse
+            Hashkeys, sind also nicht gegen Tippfehler abgesichert.
4.1.3.7. $::instance_conf
Objekt der Klasse
               "SL::InstanceConfiguration"
wird pro Request neu erstellt
Funktioniert wie $::lx_office_conf,
           speichert aber Daten die von der Instanz abhÃ¤ngig sind. Eine Instanz
           ist hier eine Mandantendatenbank. Beispielsweise Ã¼berprÃ¼ft
           
$::instance_conf->get_inventory_system eq 'perpetual'

-          ob die berÃ¼chtigte Bestandsmethode zur Anwendung kommt.
4.1.3.8. $::dispatcher
Objekt der Klasse
+          ob die berÃ¼chtigte Bestandsmethode zur Anwendung kommt.
4.1.3.8. $::dispatcher
Objekt der Klasse
               "SL::Dispatcher"
wird pro Serverprozess erstellt.
enthÃ¤lt Informationen Ã¼ber die technische Verbindung zum
               Server
Der dritte Punkt ist auch der einzige Grund warum das Objekt
           global gespeichert wird. Wird vermutlich irgendwann in einem anderen
-          Objekt untergebracht.
4.1.3.9. $::request
Hashref (evtl spÃ¤ter Objekt)
Wird pro Request neu initialisiert.
Keine Unterstruktur garantiert.

+          Objekt untergebracht.
4.1.3.9. $::request
Hashref (evtl spÃ¤ter Objekt)
Wird pro Request neu initialisiert.
Keine Unterstruktur garantiert.

                   $::request ist ein generischer Platz um
           Daten "fÃ¼r den aktuellen Request" abzulegen. Sollte nicht fÃ¼r action
           at a distance benutzt werden, sondern um lokales memoizing zu
@@ -174,20 +174,20 @@ file = /tmp/kivitendo-debug.log

2.6. Webserver-Konfiguration
ZurÃ¼ck	Kapitel 2. Installation und Grundkonfiguration	Weiter

ist der Key file$::request

Muss ich von anderen Teilen des Programms lesend drauf zugreifen? Dann $::request, aber Zugriff Ã¼ber - Wrappermethode

ZurÃ¼ck		Weiter
3.4. Mandantenkonfiguration Lager	Zum Anfang	4.2. Entwicklung unter FastCGI

ZurÃ¼ck		Weiter
kivitendo 3.0.0: Installation, Konfiguration, Entwicklung	Zum Anfang	Kapitel 2. Installation und Grundkonfiguration