projekt kivitendo

        <para>in der doc/UPGRADE Datei im doc-Verzeichnis der

        Installation</para>

        <para>Im Schulungs- und Dienstleistungsangebot der entsprechenden

        kivitendo-Partner: <ulink

      <para>Die Installation von kivitendo umfasst mehrere Schritte. Die

      folgende Liste kann sowohl für Neulinge als auch für alte Hasen als

      Übersicht und Stichpunktliste zum Abhaken dienen, um eine Version mit

      minimalen Features möglichst schnell zum Laufen zu kriegen.</para>

        <listitem>

          <para><emphasis>Voraussetzungen überprüfen</emphasis>: kivitendo

          benötigt gewisse Ressourcen und benutzt weitere Programme. Das

          Kapitel "<xref linkend="Benötigte-Software-und-Pakete"/>" erläutert

          diese. Auch die Liste der benötigten Perl-Module befindet sich

          hier.</para>

        </listitem>

        <listitem>

          <para><emphasis>Installation von kivitendo</emphasis>: Diese umfasst

          die "<xref linkend="Manuelle-Installation-des-Programmpaketes"/>"

          sowie grundlegende Einstellungen, die der "<xref

          linkend="config.config-file"/>" erläutert.</para>

        </listitem>

        <listitem>

          <para><emphasis>Konfiguration externer Programme</emphasis>: hierzu

          gehören die Datenbank ("<xref

          linkend="Anpassung-der-PostgreSQL-Konfiguration"/>") und der

          Webserver ("<xref linkend="Apache-Konfiguration"/>").</para>

        </listitem>

        <listitem>

          <para><emphasis>Benutzerinformationen speichern können</emphasis>:

          man benötigt mindestens eine Datenbank, in der Informationen zur

          Authentifizierung sowie die Nutzdaten gespeichert werden. Wie man

          das als Administrator macht, verrät "<xref

          linkend="Benutzerauthentifizierung-und-Administratorpasswort"/>".</para>

        </listitem>

        <listitem>

          <para><emphasis>Benutzer, Gruppen und Datenbanken

          anlegen</emphasis>: wie dies alles zusammenspielt erläutert "<xref

          linkend="Benutzer--und-Gruppenverwaltung"/>".</para>

        </listitem>

        <listitem>

          <para><emphasis>Los geht's</emphasis>: alles soweit erledigt? Dann

          kann es losgehen: "<xref linkend="kivitendo-ERP-verwenden"/>"</para>

        </listitem>

      <para>Alle weiteren Unterkapitel in diesem Kapitel sind ebenfalls

      wichtig und sollten vor einer ernsthaften Inbetriebnahme gelesen

      werden.</para>

              <listitem>

                <para>7.0 "Wheezy"</para>

              </listitem>

              <listitem>

                <para>8.0 "Jessie"</para>

              </listitem>

            <para>Ubuntu 12.04 LTS "Precise Pangolin", 14.04 "Trusty Tahr"

            LTS, 15.10 "Wily Werewolf" und 16.04 "Xenial Xerus" LTS

            Alpha</para>

        <para>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:</para>

          <listitem>

            <para><literal>parent</literal> (nur bei Perl vor 5.10.1)</para>

          </listitem>

          <listitem>

            <para><literal>Archive::Zip</literal></para>

          </listitem>

          <listitem>

            <para><literal>Algorithm::CheckDigits</literal></para>

          </listitem>

          <listitem>

            <para><literal>CGI</literal></para>

          </listitem>

          <listitem>

            <para><literal>Clone</literal></para>

          </listitem>

          <listitem>

            <para><literal>Config::Std</literal></para>

          </listitem>

          <listitem>

            <para><literal>DateTime</literal></para>

          </listitem>

          <listitem>

            <para><literal>DateTime::Format::Strptime</literal></para>

          </listitem>

          <listitem>

            <para><literal>DBI</literal></para>

          </listitem>

          <listitem>

            <para><literal>DBD::Pg</literal></para>

          </listitem>

          <listitem>

            <para><literal>Email::Address</literal></para>

          </listitem>

          <listitem>

            <para><literal>Email::MIME</literal></para>

          </listitem>

          <listitem>

            <para><literal>FCGI</literal> (nicht Versionen 0.68 bis 0.71

            inklusive; siehe <xref

            linkend="Apache-Konfiguration.FCGI.WebserverUndPlugin"/>)</para>

          </listitem>

          <listitem>

            <para><literal>File::Copy::Recursive</literal></para>

          </listitem>

          <listitem>

            <para><literal>GD</literal></para>

          </listitem>

          <listitem>

            <para><literal>HTML::Parser</literal></para>

          </listitem>

          <listitem>

            <para><literal>HTML::Restrict</literal></para>

          </listitem>

          <listitem>

            <para><literal>Image::Info</literal></para>

          </listitem>

          <listitem>

            <para><literal>JSON</literal></para>

          </listitem>

          <listitem>

            <para><literal>List::MoreUtils</literal></para>

          </listitem>

          <listitem>

            <para><literal>List::UtilsBy</literal></para>

          </listitem>

          <listitem>

            <para><literal>Net::SMTP::SSL</literal> (optional, bei

            E-Mail-Versand über SSL; siehe Abschnitt "<xref

            linkend="config.sending-email.smtp"/>")</para>

          </listitem>

          <listitem>

            <para><literal>Net::SSLGlue</literal> (optional, bei

            E-Mail-Versand über TLS; siehe Abschnitt "<xref

            linkend="config.sending-email.smtp"/>")</para>

          </listitem>

          <listitem>

            <para><literal>Params::Validate</literal></para>

          </listitem>

          <listitem>

            <para><literal>PBKDF2::Tiny</literal></para>

          </listitem>

          <listitem>

            <para><literal>PDF::API2</literal></para>

          </listitem>

          <listitem>

            <para><literal>Rose::Object</literal></para>

          </listitem>

          <listitem>

            <para><literal>Rose::DB</literal></para>

          </listitem>

          <listitem>

            <para><literal>Rose::DB::Object</literal> Version 0.788 oder

            neuer</para>

          </listitem>

          <listitem>

            <para><literal>String::ShellQuote</literal></para>

          </listitem>

          <listitem>

            <para><literal>Sort::Naturally</literal></para>

          </listitem>

          <listitem>

            <para><literal>Template</literal></para>

          </listitem>

          <listitem>

            <para><literal>Text::CSV_XS</literal></para>

          </listitem>

          <listitem>

            <para><literal>Text::Iconv</literal></para>

          </listitem>

          <listitem>

            <para><literal>URI</literal></para>

          </listitem>

          <listitem>

            <para><literal>XML::Writer</literal></para>

          </listitem>

          <listitem>

            <para><literal>YAML</literal></para>

          </listitem>

        <para>Seit Version v3.4.0 sind die folgenden Pakete hinzugekommen:

        <literal>Algorithm::CheckDigits</literal><literal>PBKDF2::Tiny</literal></para>

        <para>Seit Version v3.2.0 sind die folgenden Pakete hinzugekommen:

        <literal>GD</literal>, <literal>HTML::Restrict</literal>,

        <literal>Image::Info</literal></para>

        <para>Seit v3.0.0 sind die folgenden Pakete hinzugekommen:

        <literal>File::Copy::Recursive</literal>.</para>

        <para>Seit v2.7.0 sind die folgenden Pakete hinzugekommen:

        <literal>Email::MIME</literal>, <literal>Net::SMTP::SSL</literal>,

          <para>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:</para>

          <para>Für das Paket HTML::Restrict gibt es kein Debian-Paket, dies

          muß per CPAN installiert werden. Unter Ubuntu funktioniert das

          mit:</para>

          <para>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:</para>

          <para>Zusätzlich müssen einige Pakete aus dem CPAN installiert

          werden. Dazu können Sie die folgenden Befehle nutzen:</para>

          <para>Für openSUSE stehen die meisten der benötigten Perl-Pakete als

          RPM-Pakete zur Verfügung. Sie können mit folgendem Befehl

          <para>Zusätzlich müssen einige Pakete aus dem CPAN installiert

          werden. Dazu können Sie die folgenden Befehle nutzen:</para>

      <para>Der aktuelle Stable-Release, bzw. beta Release wird bei github

      gehostet und kann <ulink

      url="https://github.com/kivitendo/kivitendo-erp/releases">hier</ulink>

      heruntergeladen werden.</para>

      <para>Die kivitendo ERP Installationsdatei

      (<filename>kivitendo-erp-3.4.0.tgz</filename>) wird im

      Dokumentenverzeichnis des Webservers (z.B.

      <filename>/var/www/html/</filename>,

      <filename>/srv/www/htdocs</filename> oder

      <filename>/var/www/</filename>) entpackt:</para>

      <para>Bei einer Neuinstallation von Version 3.1.0 oder später muß das

      WebDAV Verzeichnis derzeit manuell angelegt werden:</para>

      <para>Die Verzeichnisse <filename>users</filename>,

      <filename>spool</filename> und <filename>webdav</filename> 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. Die Benutzer-

      und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich

      (z.B. bei Debian/Ubuntu <constant>www-data</constant>, bei Fedora

      <constant>apache</constant> oder bei OpenSUSE

      <constant>wwwrun</constant>).</para>

      <para>Weiterhin muss der Webserver-Benutzer in den Verzeichnissen

      <filename>templates</filename> und <filename>users</filename>

      Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in

      kivitendo angelegt wird:</para>

      <note>

        <para>Wir empfehlen eine Installation mittels des Versionsmanagager

        git. Hierfür muss ein git-Client installiert sein. Damit ist man sehr

        viel flexibler für zukünftige Upgrades. Installations-Anleitung (bitte

        die Pfade anpassen) bspw. wie folgt: <programlisting>cd /usr/local/src/

        Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu

        erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen damit zu

        verwalten. Hierfür reicht ein simples <programlisting>  git checkout -b meine_eigenen_änderungen</programlisting>

        nach dem letzten Kommando (weiterführende Informationen <ulink

        url="http://git-scm.com/book/en/v2/Getting-Started-Git-Basics">getting

        started with git</ulink>).</para>

      </note>

        <para>In kivitendo gibt es nur noch eine Konfigurationsdatei, die

        benötigt wird: <filename>config/kivitendo.conf</filename> (kurz: "die

        Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation von

        kivitendo bzw. der Migration von älteren Versionen angelegt

          <para>Vor der Umbenennung in kivitendo hieß diese Datei noch

          <filename>config/lx_office.conf</filename>. Aus Gründen der

          Kompatibilität wird diese Datei eingelesen, sofern die Datei

          <filename>config/kivitendo.conf</filename> nicht existiert.</para>

          <listitem>

            <para><literal>authentication</literal> (siehe Abschnitt "<xref

            linkend="Benutzerauthentifizierung-und-Administratorpasswort"/>"

            in diesem Kapitel)</para>

          </listitem>

          <listitem>

            <para><literal>authentication/database</literal></para>

          </listitem>

          <listitem>

            <para><literal>authentication/ldap</literal></para>

          </listitem>

          <listitem>

            <para><literal>system</literal></para>

          </listitem>

          <listitem>

            <para><literal>paths</literal></para>

          </listitem>

          <listitem>

            <para><literal>mail_delivery</literal> (siehe Abschnitt "<xref

            linkend="config.sending-email.smtp"/>)</para>

          </listitem>

          <listitem>

            <para><literal>applications</literal></para>

          </listitem>

          <listitem>

            <para><literal>environment</literal></para>

          </listitem>

          <listitem>

            <para><literal>print_templates</literal></para>

          </listitem>

          <listitem>

            <para><literal>task_server</literal></para>

          </listitem>

          <listitem>

            <para><literal>periodic_invoices</literal></para>

          </listitem>

          <listitem>

            <para><literal>self_tests</literal></para>

          </listitem>

          <listitem>

            <para><literal>console</literal></para>

          </listitem>

          <listitem>

            <para><literal>testing</literal></para>

          </listitem>

          <listitem>

            <para><literal>testing/database</literal></para>

          </listitem>

          <listitem>

            <para><literal>debug</literal></para>

          </listitem>

        <para>kivitendo bringt eine eigene Komponente zur zeitgesteuerten

        Ausführung bestimmter Aufgaben mit, den <link

        linkend="config.task-server">Taskserver</link>. Er wird u.a. für

        Features wie die <link

        linkend="features.periodic-invoices">wiederkehrenden Rechnungen</link>

        benötigt, erledigt aber auch andere erforderliche Aufgaben und muss

        daher in Betrieb genommen werden. Seine Einrichtung wird im Abschnitt

        <link linkend="config.task-server">Task-Server</link> genauer

        beschrieben.</para>

        <para>kivitendo setzt zwingend voraus, dass die Datenbank

        Unicode/UTF-8 als Encoding einsetzt. Bei aktuellen

        Serverinstallationen braucht man hier meist nicht einzugreifen.</para>

        <para>Das Encoding des Datenbankservers kann überprüft werden. Ist das

        Encoding der Datenbank "template1" "Unicode" bzw. "UTF-8", so braucht

        man nichts weiteres diesbezüglich unternehmen. Zum Testen:</para>

        werden. Hier gibt es mehrere Möglichkeiten. Sinnvoll ist es nur die

        nötigen Verbindungen immer zuzulassen, für eine lokal laufende

        Datenbank zum Beispiel:</para>

psql template1</programlisting> führen Sie die folgenden Kommandos aus:</para>

        <note>

          <para><literal>CREATE EXTENSION</literal> ist seit Version 9.1 die

          bevorzugte Syntax um die Sprache <literal>plpgsql</literal>

          anzulegen. In diesen Versionen ist die Extension meist auch schon

          vorhanden. Sollten Sie eine ältere Version von Postgres haben,

          benutzen Sie stattdessen den folgenden Befehl.</para>

          <programlisting>CREATE LANGUAGE 'plpgsql';

\q</programlisting>

        </note>

        <para>Die Frage, ob der neue User Superuser sein soll, können Sie mit

        nein beantworten, genauso ist die Berechtigung neue User (Roles) zu

        generieren nicht nötig.</para>

        <programlisting>su - postgres

        Sie den evtl. voreingestellten Benutzer “postgres” auf “kivitendo”

        bzw. den hier gewählten Benutzernamen.</para>

          <xref linkend="Apache-Konfiguration.FCGI"/> beschrieben.</para>

          <para>Bei einigen Distribution (Ubuntu ab 14.04, Debian ab 8.2) muss

          noch explizit das cgi-Modul mittels <programlisting>a2enmod cgi</programlisting>

          aktiviert werden.</para>

            <para>FCGI-Versionen ab 0.69 und bis zu 0.71 inklusive sind extrem

            strict in der Behandlung von Unicode, und verweigern bestimmte

            Eingaben von kivitendo. Falls es Probleme mit Umlauten in Ihrer

            Installation gibt, muss zwingend Version 0.68 oder aber Version

            0.72 und neuer eingesetzt werden.</para>

            <para>Mit <ulink url="http://www.cpan.org">CPAN</ulink> lässt sie

            sich die Vorgängerversion wie folgt installieren:</para>

            <para>Wer einen älteren Apache als Version 2.4 im Einsatz hat,

            muss entsprechend die Syntax der Directorydirektiven verändert.

            Statt</para>

            <programlisting>Require all granted</programlisting>

            <para>muß man Folgendes einstellen:</para>

            <programlisting>

        <para>Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung

        von kivitendo nur über https-verschlüsselten Verbindungen, sowie

        weiteren Zusatzmassnahmen, wie beispielsweise Basic Authenticate. Die

        Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser

        Anleitung, hier ein Hinweis auf einen entsprechenden <ulink

        url="http://redmine.kivitendo-premium.de/boards/1/topics/142">Foreneintrag

        (Stand Sept. 2015)</ulink></para>

      <para>Der Task-Server ist ein Prozess, der im Hintergrund läuft, in

      regelmäßigen Abständen nach abzuarbeitenden Aufgaben sucht und diese zu

      festgelegten Zeitpunkten abarbeitet (ähnlich wie Cron). Dieser Prozess

      wird u.a. für die Erzeugung der wiederkehrenden Rechnungen und weitere

      essenzielle Aufgaben benutzt.</para>

      <para>Der Task-Server muss einmalig global in der Konfigurationsdatei

      konfiguriert werden. Danach wird er für jeden Mandanten, für den er

      laufen soll, in der Adminsitrationsmaske eingeschaltet.</para>

      <para>Beachten Sie, dass der Task-Server in den Boot-Vorgang Ihres

      Servers integriert werden muss, damit er automatisch gestartet wird.

      Dies kann kivitendo nicht für Sie erledigen.</para>

              linkend="Manuelle-Installation-des-Programmpaketes"/>). Daher

        <para>Ist der Task-Server grundlegend konfiguriert, so muss

        anschließend jeder Mandant, für den der Task-Server laufen soll,

        einmalig konfiguriert werden. Dazu kann in der Maske zum Bearbeiten

        von Mandanten im Administrationsbereich eine kivitendo-Benutzerkennung

        ausgewählt werden, unter der der Task-Server seine Arbeit

        verrichtet.</para>

        <para>Ist in dieser Einstellung keine Benutzerkennung ausgewählt, so

        wird der Task-Server für diesen Mandanten keine Aufgaben

          <title>SystemV-basierende Systeme (z.B. Debian, ältere OpenSUSE,

          ältere Fedora)</title>

          <title>systemd-basierende Systeme (z.B. neure OpenSUSE, neuere

          Fedora, neuere Ubuntu)</title>

          <para>Verlinken Sie die Datei

          <filename>scripts/boot/systemd/kivitendo-task-server.service</filename>

          nach <filename>/etc/systemd/system/</filename>. Passen Sie in der

          kopierten Datei den Pfad zum Task-Server an (Zeile

          <literal>ExecStart=....</literal> und

          <literal>ExecStop=...</literal>). Binden Sie das Script in den

          Boot-Prozess ein.</para>

        <para>Das Passwort, das zum Zugriff auf das Administrationsinterface

        von kivitendo benutzt wird, wird ebenfalls in dieser Datei

        gespeichert. Es kann auch nur dort und nicht mehr im

        Administrationsinterface selber geändert werden. Der Parameter dazu

        heißt <varname>admin_password</varname> im Abschnitt

        <varname>[authentication]</varname>.</para>

      <para>Nach der Installation müssen Mandanten, Benutzer, Gruppen und

      Datenbanken angelegt werden. Dieses geschieht im Administrationsmenü,

      das Sie unter folgender URL finden:</para>

        <para>kivitendo verwaltet zwei Sets von Daten, die je nach Einrichtung

        in einer oder zwei Datenbanken gespeichert werden.</para>

        <para>Das erste Set besteht aus Anmeldeinformationen: welche Benutzer

        und Mandanten gibt es, welche Gruppen, welche BenutzerIn hat Zugriff

        auf welche Mandanten, und welche Gruppe verfügt über welche Rechte.

        Diese Informationen werden in der Authentifizierungsdatenbank

        gespeichert. Dies ist diejenige Datenbank, deren Verbindungsparameter

        in der Konfigurationsdatei <filename>config/kivitendo.conf</filename>

        gespeichert werden.</para>

        <para>Das zweite Set besteht aus den eigentlichen Verkehrsdaten eines

        Mandanten, wie beispielsweise die Stammdaten (Kunden, Lieferanten,

        Waren) und Belege (Angebote, Lieferscheine, Rechnungen). Diese werden

        in einer Mandantendatenbank gespeichert. Die Verbindungsinformationen

        einer solchen Mandantendatenbank werden im Administrationsbereich

        konfiguriert, indem man einen Mandanten anlegt und dort die Parameter

        einträgt. Dabei hat jeder Mandant eine eigene Datenbank.</para>

        <para>Aufgrund des Datenbankdesigns ist es für einfache Fälle möglich,

        die Authentifizierungsdatenbank und eine der Mandantendatenbanken in

        ein und derselben Datenbank zu speichern. Arbeitet man hingegen mit

        mehr als einem Mandanten, wird empfohlen, für die

        Authentifizierungsdatenbank eine eigene Datenbank zu verwenden, die

        nicht gleichzeitig für einen Mandanten verwendet wird.</para>

      </sect2>

        <para>kivitendos Administration kennt Mandanten, Benutzer und Gruppen,

        die sich frei zueinander zuordnen lassen.</para>

        <para>kivitendo kann mehrere Mandaten aus einer Installation heraus

        verwalten. Welcher Mandant benutzt wird, kann direkt beim Login

        ausgewählt werden. Für jeden Mandanten wird ein eindeutiger Name

        vergeben, der beim Login angezeigt wird. Weiterhin benötigt der

        Mandant Datenbankverbindungsparameter für seine Mandantendatenbank.

        Diese sollte über die <link

        linkend="Datenbanken-anlegen">Datenbankverwaltung</link>

        geschehen.</para>

        <para>Ein Benutzer ist eine Person, die Zugriff auf kivitendo erhalten

        soll. Sie erhält einen Loginnamen sowie ein Passwort. Weiterhin legt

        der Administrator fest, an welchen Mandanten sich ein Benutzer

        anmelden kann, was beim Login verifiziert wird.</para>

        <para>Gruppen dienen dazu, Benutzern innerhalb eines Mandanten Zugriff

        auf bestimmte Funktionen zu geben. Einer Gruppe werden dafür vom

        Administrator gewisse Rechte zugeordnet. Weiterhin legt der

        Administrator fest, für welche Mandanten eine Gruppe gilt, und welche

        Benutzer Mitglieder in dieser Gruppe sind. Meldet sich ein Benutzer

        dann an einem Mandanten an, so erhält er alle Rechte von allen

        denjenigen Gruppen, die zum Einen dem Mandanten zugeordnet sind und in

        denen der Benutzer zum Anderen Mitglied ist,</para>

        <para>Die Reihenfolge, in der Datenbanken, Mandanten, Gruppen und

        Benutzer angelegt werden, kann im Prinzip beliebig gewählt werden. Die

        folgende Reihenfolge beinhaltet die wenigsten Arbeitsschritte:</para>

        <para>Benutzergruppen werden zwar in der Authentifizierungsdatenbank

        gespeichert, gelten aber nicht automatisch für alle Mandanten. Der

        Administrator legt vielmehr fest, für welche Mandanten eine Gruppe

        gültig ist. Dies kann entweder beim Bearbeiten der Gruppe geschehen

        ("diese Gruppe ist gültig für Mandanten X, Y und Z"), oder aber wenn

        man einen Mandanten bearbeitet ("für diesen Mandanten sind die Gruppen

        A, B und C gültig").</para>

        <para>Wurden bereits Benutzer angelegt, so können hier die Mitglieder

        dieser Gruppe festgelegt werden ("in dieser Gruppe sind die Benutzer

        X, Y und Z Mitglieder"). Dies kann auch nachträglich beim Bearbeiten

        eines Benutzers geschehen ("dieser Benutzer ist Mitglied in den

        Gruppen A, B und C").</para>

        <para>Beim Anlegen von Benutzern werden für viele Parameter

        Standardeinstellungen vorgenommen, die den Gepflogenheiten des

        deutschen Raumes entsprechen.</para>

        <para>Zwingend anzugeben ist der Loginname. Wenn die

        Passwortauthentifizierung über die Datenbank eingestellt ist, so kann

        hier auch das Benutzerpasswort gesetzt bzw. geändert werden. Ist

        hingegen die LDAP-Authentifizierung aktiv, so ist das Passwort-Feld

        <para>Hat man bereits Mandanten und Gruppen angelegt, so kann hier

        auch konfiguriert werden, auf welche Mandanten der Benutzer Zugriff

        hat bzw. in welchen Gruppen er Mitglied ist. Beide Zuweisungen können

        sowohl beim Benutzer vorgenommen werden ("dieser Benutzer hat Zugriff

        auf Mandanten X, Y, Z" bzw. "dieser Benutzer ist Mitglied in Gruppen

        X, Y und Z") als auch beim Mandanten ("auf diesen Mandanten haben

        Benutzer A, B und C Zugriff") bzw. bei der Gruppe ("in dieser Gruppe

        sind Benutzer A, B und C Mitglieder").</para>

        <para>Ein Mandant besteht aus Administrationssicht primär aus einem

        eindeutigen Namen. Weiterhin wird hier hinterlegt, welche Datenbank

        als Mandantendatenbank benutzt wird. Hier müssen die Zugriffsdaten

        einer der eben angelegten Datenbanken eingetragen werden.</para>

        <para>Hat man bereits Benutzer und Gruppen angelegt, so kann hier auch

        konfiguriert werden, welche Benutzer Zugriff auf den Mandanten haben

        bzw. welche Gruppen für den Mandanten gültig sind. Beide Zuweisungen

        können sowohl beim Mandanten vorgenommen werden ("auf diesen Mandanten

        haben Benutzer X, Y und Z Zugriff" bzw. "für diesen Mandanten sind die

        Gruppen X, Y und Z gültig") als auch beim Benutzer ("dieser Benutzer

        hat Zugriff auf Mandanten A, B und C") bzw. bei der Gruppe ("diese

        Gruppe ist für Mandanten A, B und C gültig").</para>

      <para>Im Administrationsmenü gibt es ferner noch die beiden Menüpunkte

      Druckeradministration und System.</para>

        <para>Unter dem Menüpunkt Druckeradministration lassen sich beliebig

        viele "Druckbefehle" im System verwalten. Diese Befehle werden

        mandantenweise zugeordnet. Unter Druckerbeschreibung wird der Namen

        des Druckbefehls festgelegt, der dann in der Druckerauswahl des Belegs

        angezeigt wird.</para>

        <para>Unter Druckbefehl definiert man den eigentlichen Druckbefehl,

        der direkt auf dem Webserver ausgeführt wird, bspw. 'lpr -P

        meinDrucker' oder ein kompletter Pfad zu einem Skript

        (/usr/local/src/kivitendo/scripts/pdf_druck_in_verzeichnis.sh). Wird

        ferner noch ein optionales Vorlagenkürzel verwendet, wird dieses

        Kürzel bei der Auswahl der Druckvorlagendatei mit einem Unterstrich

        ergänzt, ist bspw. das Kürzel 'epson_drucker' definiert, so wird beim

        Ausdruck eines Angebots folgende Vorlage geparst:

        sales_quotation_epson_drucker.tex.</para>

      </sect2>

        <para>Unter dem Menüpunkt System gibt es den Eintrag 'Installation

        sperren/entsperren'. Setzt man diese Sperre so ist der Zugang zu der

        gesamten kivitendo Installation gesperrt.</para>

        <para>Falls die Sperre gesetzt ist, erscheint anstelle der

        Anmeldemaske die Information: 'kivitendo ist momentan zwecks

        Wartungsarbeiten nicht zugänglich.'.</para>

        <para>Wichtig zu erwähnen ist hierbei noch, dass sich kivitendo

        automatisch 'sperrt', falls es bei einem Versionsupdate zu einem

        Datenbankfehler kam. Somit kann hier nicht aus Versehen mit einem

        inkonsistenten Datenbestand weitergearbeitet werden.</para>

      </sect2>

    </sect1>

    <sect1 id="config.sending-email"

           xreflabel="E-Mail-Versand aus kivitendo heraus">

      <title>E-Mail-Versand aus kivitendo heraus</title>

      <para>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

      <productname>Postfix</productname> oder <productname>Exim</productname>,

      was auch die standardmäßig aktive Methode ist) sowie Versand über einen

      SMTP-Server (z.B. der des eigenen Internet-Providers).</para>

      <para>Welche Methode und welcher Server verwendet werden, wird über die

      Konfigurationsdatei <filename>config/kivitendo.conf</filename>

      festgelegt. Dort befinden sich alle Einstellungen zu diesem Thema im

      Abschnitt '<literal>[mail_delivery]</literal>'.</para>

      <sect2 id="config.sending-email.sendmail"

             xreflabel="E-Mail-Versand über lokalen E-Mail-Server">

        <para>Diese Methode bietet sich an, wenn auf dem Server, auf dem

        kivitendo läuft, bereits ein funktionsfähiger E-Mail-Server wie z.B.

        <productname>Postfix</productname>, <productname>Exim</productname>

        oder <productname>Sendmail</productname> läuft.</para>

        <para>Um diese Methode auszuwählen, muss der Konfigurationsparameter

        '<literal>method = sendmail</literal>' gesetzt sein. Dies ist

        <para>Um zu kontrollieren, wie das Programm zum Einliefern gestartet

        wird, dient der Parameter '<literal>sendmail = ...</literal>'. Der

        Standardwert verweist auf das Programm

        <filename>/usr/bin/sendmail</filename>, das bei allen oben genannten

        <para>Die Konfiguration des E-Mail-Servers selber würde den Rahmen

        dieses sprengen. Hierfür sei auf die Dokumentation des E-Mail-Servers

        verwiesen.</para>

      <sect2 id="config.sending-email.smtp"

             xreflabel="E-Mail-Versand über einen SMTP-Server">

        <para>Diese Methode bietet sich an, wenn kein lokaler E-Mail-Server

        vorhanden oder zwar einer vorhanden, dieser aber nicht konfiguriert

        ist.</para>

        <para>Um diese Methode auszuwählen, muss der Konfigurationsparameter

        '<literal>method = smtp</literal>' gesetzt sein. Die folgenden

            <listitem>

              <para>Name oder IP-Adresse des SMTP-Servers. Standardwert:

              '<literal>localhost</literal>'</para>

            </listitem>

            <listitem>

              <para>Portnummer. Der Standardwert hängt von der verwendeten

              Verschlüsselungsmethode ab. Gilt '<literal>security =

              none</literal>' oder '<literal>security = tls</literal>', so ist

              25 die Standardportnummer. Für '<literal>security =

              ssl</literal>' ist 465 die Portnummer. Muss normalerweise nicht

              geändert werden.</para>

            </listitem>

            <listitem>

              <para>Wahl der zu verwendenden Verschlüsselung der Verbindung

              mit dem Server. Standardwert ist '<literal>none</literal>',

              wodurch keine Verschlüsselung verwendet wird. Mit

              '<literal>tls</literal>' wird TLS-Verschlüsselung eingeschaltet,

              und mit '<literal>ssl</literal>' wird Verschlüsselung via SSL

              eingeschaltet. Achtung: Für '<literal>tls</literal>' und

              '<literal>ssl</literal>' werden zusätzliche Perl-Module benötigt

              (siehe unten).</para>

            </listitem>

            <term><varname>login</varname> und

            <varname>password</varname></term>

            <listitem>

              <para>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.</para>

            </listitem>

      <para>Das Drucksystem von kivitendo benutzt von Haus aus LaTeX-Vorlagen.

      Um drucken zu können, braucht der Server ein geeignetes LaTeX System. Am

      einfachsten ist dazu eine <literal>texlive</literal> Installation. Unter

      debianoiden Betriebssystemen installiert man die Pakete mit:</para>

        <listitem>

          <para>RB</para>

        </listitem>

        <listitem>

          <para>f-tex</para>

        </listitem>

        <listitem>

          <para>rev-odt</para>

        </listitem>

      <para>Der ehemalige Druckvorlagensatz "Standard" wurde mit der Version

      3.3 entfernt, da er nicht mehr gepflegt wurde.</para>

      <sect2 id="Vorlagenverzeichnis-anlegen"

             xreflabel="Vorlagenverzeichnis anlegen">

        <para>Es lässt sich ein initialer Vorlagensatz erstellen. Die

        LaTeX-System-Abhängigkeiten hierfür kann man prüfen mit:</para>

        <para>Der Angemeldete Benutzer muss in einer Gruppe sein, die über das

        Recht "Konfiguration -> Mandantenverwaltung" verfügt. Siehe auch

        <xref linkend="Gruppen-anlegen"/>.</para>

        <para>Im Userbereich lässt sich unter: "<guimenu>System</guimenu>

        -&gt; <guisubmenu>Mandantenverwaltung</guisubmenu> -&gt;

        <guimenuitem>Verschiedenes</guimenuitem>" die Option "Neue

        Druckvorlagen aus Vorlagensatz erstellen" auswählen.</para>

        <orderedlist>

          <listitem>

            <para><option>Vorlagen auswählen</option>: Wählen Sie hier den

            Vorlagensatz aus, der kopiert werden soll

            (<filename>RB</filename>, <filename>f-tex</filename> oder

            <filename>odt-rev</filename>.)</para>

          </listitem>

          <listitem>

            <para><option>Neuer Name</option>: Der Verzeichnisname für den

            neuen Vorlagensatz. Dieser kann im Rahmen der üblichen Bedingungen

            für Verzeichnisnamen frei gewählt werden.</para>

          </listitem>

        </orderedlist>

        <para>Nach dem Speichern wird das Vorlagenverzeichnis angelegt und ist

        für den aktuellen Mandanten ausgewählt. Der gleiche Vorlagensatz kann,

        wenn er mal angelegt ist, bei mehreren Mandanten verwendet werden.

        Eventuell müssen Anpassungen (Logo, Erscheinungsbild, etc) noch

        vorgenommen werden. Den Ordner findet man im Dateisystem unter

        <filename>./templates/[Neuer Name]</filename></para>

        <para>Hierbei handelt es sich um einen vollständigen LaTeX

        Dokumentensatz mit alternativem Design. Die odt oder html-Varianten

        sind nicht gepflegt.</para>

        url="http://www.kivitendo-support.de/vortraege/Lx-Office%20Anwendertreffen%20LaTeX-Druckvorlagen-Teil3-finale.pdf">hier</ulink>

        auf Folie 5 bis 10 vorgestellt. Informationen zur Anpassung an die

        eigenen Firmendaten finden sich in der Datei Readme.tex im

        Vorlagenverzeichnis.</para>

        <itemizedlist>

          <listitem>

            <para>Mehrsprachenfähig, mit Deutscher und Englischer

            Übersetzung</para>

          </listitem>

          <listitem>

            <para>Zentrale Konfigurationsdateien, die für alle Belege benutzt

            werden, z.B. für Kopf- und Fußzeilen, und Infos wie

            Bankdaten</para>

          </listitem>

          <listitem>

            <para>mehrere vordefinierte Varianten für

            Logos/Hintergrundbilder</para>