<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<!-- $Id: book.xml,v 1.29.2.1 2007/10/24 18:06:20 cs Exp $ -->
<book lang="de">

<bookinfo>
<title>OTRS 2.1 - Admin-Handbuch</title>
<edition>Playa Esmeralda</edition>

<copyright>
<year>2003-2007</year>
<holder>OTRS AG</holder>
</copyright>

<date>2007-02-12</date>

<legalnotice>
<para>
Christian Schöpplein, Richard Kammermeyer, Stefan Rother, Thomas Raith,
Burchard Steinbild, Andre Mindermann, Martin Edenhofer, Christopher Kuhn
</para>

<para>
Dieses Werk ist geistiges Eigentum der OTRS AG.
Es darf als Ganzes oder in Auszügen kopiert werden, vorausgesetzt,
dieser Copyright-Vermerk befindet sich auf jeder Kopie.
</para>

<para>
UNIX ist ein eingetragenes Warenzeichen von X/Open Company Limited.
Linux ist ein eingetragenes Warenzeichen von Linus Torvalds.
MS-DOS, Windows, Windows 95, Windows 98, Windows NT, Windows 2000, Windows XP
und Windows 2003 sind eingetragene Warenzeichen der Microsoft Corporation.
Andere Warenzeichen oder registrierte Warenzeichen: SUSE und YaST von SUSE
GmbH, Red Hat und Fedora von Red Hat Inc., Debian von Software in the
Public Interest, Inc., Mandrake von MandrakeSoft, SA.
MySQL und das MySQL Logo sind eingetragene Warenzeichen von MySQL AB.
Alle Warennamen werden ohne Gewährleistung der freien Verwendbarkeit benutzt und sind möglicherweise eingetragene Warenzeichen.
Die Firma OTRS AG richtet sich im Wesentlichen
nach den Schreibweisen der Hersteller. Andere hier genannte Produkte
können Warenzeichen des jeweiligen Herstellers sein.
</para>
</legalnotice>

</bookinfo>

<!-- $Id: preface.xml,v 1.3 2006/01/09 21:37:53 cs Exp $ --><preface id="preface">
<title>Vorwort</title>

<para>
Das folgende Buch richtet sich besonders an OTRS Neulinge und
Administratoren des Open Ticket Request Systems. Beschrieben werden die Installation,
Konfiguration und Administration des Systems, die eigentliche
Benutzung von OTRS für Agenten oder Kunden-Benutzer wird weniger in diesem
Buch angesprochen.
</para>

<para>
Obwohl viele  Arbeitsstunden, einige Liter an Kaffee und so manche Pizza in
die Erstellung der folgenden Abschnitte investiert wurden, erhebt das Buch
keinen Anspruch auf Vollständigkeit. Mit Sicherheit haben sich Fehler
eingeschlichen, wurden manche Dinge umständlich erklärt oder sind einige
wichtige Dinge komplett vergessen worden. Mit Sicherheit werden auch manche
Kapitel noch mal überarbeitet bzw. neue Kapitel oder Abschnitte hinzugefügt
werden.
</para>

<para>
Da das Buch versucht, sich an den Bedürfnissen von OTRS Administratoren und OTRS
Neulingen zu orientieren und da die Qualität der folgenden Kapitel so hoch
wie möglich sein soll, sind wir auf Ihr Feedback angewiesen. Bitte
teilen Sie uns mit, wenn Sie Abschnitte in diesem Buch vermissen, wenn Dinge
für Sie unverständlich erklärt sind oder auch wenn Sie Rechtschreib-, Tipp
oder Grammatikfehler in diesem Buch entdecken. Jede Art von Rückmeldung ist
ausdrücklich erwünscht und sollte durch einen Eintrag auf

<ulink url="http://bugs.otrs.org">
<citetitle>http://bugs.otrs.org</citetitle>
</ulink>

an uns gerichtet werden, da sie so nicht verloren geht und direkt beim
zuständigen Ansprechpartner landet. Wir bedanken uns schon jetzt für
jede Art von Mithilfe!
</para>

</preface>
<!-- $Id: tts.xml,v 1.5 2006/10/18 12:55:19 cs Exp $ --><chapter id="tts">
<title>Allgemeines zu Trouble Ticket Systemen</title>

<abstract>
<para>
In diesem Abschnitt soll kurz die grundlegende Idee, die hinter
Trouble Tickets im Allgemeinen und Trouble Ticket Systemen im Speziellen steht,
erläutert werden. An einem kleinen Beispiel wird gezeigt,
wofür Trouble Ticket Systeme in der Praxis verwendet werden
können und wo die Vorteile dieser Systeme liegen.
</para>
</abstract>

<sect1 id="basic-tts-example">
<title>Was ist ein Trouble Ticket System, wann wird es benötigt?</title>

<para>
Das folgende Beispiel soll verdeutlichen, was ein Trouble Ticket System
ist und wie damit in der Praxis Zeit und Geld eingespart werden können.
</para>

<para>
Nehmen wir an, dass Max Mustermann Fabrikant ist und Videorekorder
produziert. Da die Programmierung der Videorekorder sehr
unübersichtlich und kompliziert ist, wenden sich die Kunden von
Herrn Mustermann gerne und häufig mit Supportanfragen per Mail an
ihn. An manchen Tagen kann Herr Mustermann der Mailflut kaum Herr
werden und so kommt es, dass seine Kunden sich einige Zeit gedulden
müssen, bis die Antwort mit der rettenden Lösung bei ihnen
eintrifft. Manchen Kunden dauert dies jedoch zu lange, eine weitere
E-Mail mit dem gleichen Inhalt wird an Herrn Mustermann geschickt. Die
E-Mails mit den Supportanfragen werden alle in eine INBOX
weitergeleitet, wie sie von fast allen E-Mailprogrammen
verwendet wird.
</para>

<para>
An manchen Tagen ist die Anfragewelle besonders groß und Herr
Mustermann sieht sich außerstande, alle Mails noch in einem
vertretbaren Zeitrahmen zu beantworten. Aus diesem Grund kommandiert er
seine Entwickler Meier und Schulze zur Bearbeitung der Supportanfragen
ab. Da von allen das gleiche System
benutzt wird, greifen alle auf die gleiche INBOX und daher auch auf die
gleichen Mails zu. Meier und Schulze haben jedoch keine Ahnung, dass
manch ein Kunde in seiner Not gleich zwei E-Mails verfasst und an Herrn
Mustermann geschickt hat. So kommt es vor, dass Meier die erste Mail
mit einem anderen Ratschlag beantwortet als Schulze der sich im selben
Moment der zweiten Nachricht des gleichen Kunden annimmt. Das Ergebnis
ist, dass der Kunde unterschiedliche Antworten bekommt. Darüber
hinaus hat Herr Mustermann keinen Einblick darüber, welcher
Mitarbeiter wann was welchem Kunden gesagt hat, welche Probleme
besonders häufig auftreten und wie groß sein gesamter
Aufwand für den Kundensupport ist.
</para>

<para>
Von einem Kollegen erfährt Herr Mustermann schließlich, dass
es Trouble Ticket Systeme gibt, die genau die Probleme lösen, die
Herr Mustermann mit dem Support für seine Kunden hat. Herr Mustermann
entscheidet sich für das offene
Trouble Ticket Request System OTRS und installiert dieses System auf
einem Rechner, der über einen Webserver sowohl für seine Mitarbeiter als
auch über das Internet erreichbar ist. Von nun an werden die Hilferufe der
Kunden nicht mehr länger an seine private INBOX, sondern direkt an
den Mail-Account für OTRS weitergeleitet. OTRS hat eine
Schnittstelle zur INBOX für die Supportanfragen, so dass alle
ankommenden E-Mails automatisch ins Trouble Ticket System eingespeist
werden. Unabhängig ob Herr Mustermann nun gerade anwesend ist oder
nicht, generiert OTRS eine automatische Antwort und teilt dem Kunden
mit, dass seine E-Mail angekommen ist und so schnell wie möglich
bearbeitet wird. Dabei wird eine eindeutige Trouble Ticket Nummer
vergeben. Der Kunde ist glücklich, dass sein Flehen schnell
erhört wurde und wartet gespannt auf eine Antwort. Sowohl Herr
Mustermann als auch die Entwickler Meier und Schulze können nun
über einen beliebigen Internetbrowser und die Weboberfläche
von OTRS auf die Supportanfragen zugreifen und diese einzeln
beantworten.
</para>

<para>
Stellen wir uns vor, dass Herr Schmidt eine Anfrage ans System gestellt
hat und Herr Meier diese kurz und knapp beantwortet. Herrn Schmidt
reicht diese Antwort jedoch nicht aus und so antwortet er auf die
Lösungsmail am folgenden Tag. Herr Meier ist jedoch gerade mit
anderen Dingen beschäftigt, so dass sich Herr Mustermann der Sache
annimmt. Über die History-Funktion von OTRS kann er jetzt auf alle
vergangenen E-Mails von Herrn Schmidt und Herrn Meier zugreifen, deren
Inhalt abfragen und eine ausführlichere Antwort versenden. Herr
Schmidt erhält nun die Lösung für sein
Problem, weiß aber nicht, dass diese von unterschiedlichen
Personen stammt.
</para>

<para>
Natürlich ist dies nur ein sehr kleiner Einblick in die
Funktionalitäten von Trouble Ticket Systemen. Da Herr Mustermann eine
kleine Firma führt, erhält er vielleicht nur wenige E-Mails mit
Supportanfragen pro Tag, die er vielleicht noch ganz überschaulich
mit seiner normalen Mailsoftware handhaben kann und somit kein
Trouble Ticket System braucht. Wenn aber der neue DVD-Rekorder in die Regale
kommt, werden es vielleicht schon 500 oder in ein paar Jahren schon 10.000
Nachrichten pro Tag sein. Spätestens dann rechnet sich der Einsatz von
Trouble Ticket Systemen wie OTRS.
</para>

<para>
Der Einsatz von Trouble Ticket Systemen kann also für solche
Umgebungen große Vorteile bringen, in denen viele Anfragen per E-Mail
oder Telefon anfallen und wo die Anfragen von verschiedenen Mitarbeitern
bearbeitet werden. Trouble Ticket Systeme helfen dabei, Supportaufgaben zu
strukturieren und zu beschleunigen, ebenfalls können Arbeitsabläufe
abgebildet werden. Durch Systeme wie OTRS lässt sich Arbeitszeit einsparen
bzw. effektiver nutzen und die Kommunikation zwischen Kunden und
Mitarbeitern wird transparenter. Sowohl das Unternehmen als auch die Kunden
profitieren also vom Einsatz eines Trouble Ticket Systems.
</para>
</sect1>

<sect1 id="what-is-a-tt">
<title>Was ist ein Trouble Ticket?</title>

<para>
Ein Trouble Ticket lässt sich im Wesentlichen mit einem
Krankenblatt eines Krankenhauspatienten vergleichen. Bei der erstmaligen
Einlieferung in das Krankenhaus wird das Krankenblatt im Zuge der
Anamnese neu angelegt. Jeder Arzt trägt nun seine Diagnose sowie
die verordnete Therapie und Medikation ein und dokumentiert deren
Erfolg. Das Krankenblatt gibt nun einen schnellen Überblick,
gewährleistet eine schnelle Einarbeitung und verhindert eine
Mehrfachdosierung von Medikamenten. Ist die Krankheit besiegt und der
Patient entlassen, wird das Krankenblatt archiviert.
</para>

<para>
Im OTRS werden Trouble Tickets, also die Krankenblätter aus dem
obigen Beispiel, als normale E-Mails behandelt und gespeichert. Schickt
z. B. ein Kunde eine Anfrage an das Trouble Ticket System, wird das
Krankenblatt eingerichtet, ein neues Ticket wird geöffnet. Die
Antwort eines Mitarbeiters auf die Anfrage kann als Eintrag eines
Arztes gesehen werden, eine erneute Antwort bzw.
Anfrage des Kundens auf das selbe Ticket als Veränderung oder
Erweiterung des Krankheitsbildes. Ein Ticket gilt als
erledigt bzw. geschlossen, wenn eine Antwort auf die Anfrage an den
Kunden zurückgesendet wurde oder das Ticket über das System als
geschlossen markiert wird. Antwortet ein Kunde auf ein bereits
geschlossenes Ticket, so wird es erneut geöffnet und die neuen
Informationen ergänzt. Um die Konsistenz der Daten sicherzustellen,
werden alle Tickets mit all ihren spezifischen Informationen archiviert
und verbleiben im System. Durch die Speicherung der Tickets als ganz
normale E-Mails ist es möglich, dass diese auch
E-Mail-Anhänge enthalten können. Zusätzlich zu den normalen
Informationen einer E-Mail lassen sich beliebige Notizen zu jedem
Ticket hinzufügen. Die Tickets selbst werden auf der Festplatte
bzw. in einer Datenbank archiviert, ebenso zusätzliche
Meta-Informationen des Tickets wie Notizen, an der Beantwortung des
Tickets beteiligte Mitarbeiter, Zeit und Datum der Bearbeitung,
Bearbeitungsdauer usw. Eine Sortierung oder eine Suche über den
Datenbestand wird mit Hilfe aller vorhandenen Informationen zu den
Tickets realisiert.
</para>
</sect1>

</chapter>
<!-- $Id: otrs.xml,v 1.10.2.1 2007/10/24 18:06:20 cs Exp $ --><chapter id="otrs">
<title>OTRS - Open Ticket Request System</title>

<abstract>
<para>
In diesem Abschnitt werden die Features des Open Ticket Request Systems
(OTRS) vorgestellt. Des Weiteren wird näher auf die Systemanforderungen von
OTRS eingegangen und erläutert, wie Kontakt zur OTRS-Community aufgenommen
werden kann bzw. wie kommerzieller Support erhältlich ist.
</para>
</abstract>

<sect1 id="otrs-basics">
<title>Allgemeines</title>

<para>
Das Open Ticket Request System (OTRS) ist eine Webapplikation, die
mit jedem HTML kompatiblen Browser benutzt werden kann. OTRS
verzichtet bewusst auf aktive Webkomponenten wie z. B. Javaskript,
JavaApplets und Flash. Dadurch wird es möglich, das System nicht nur
über einen PC, sondern auch von Mobiltelefonen und anderen Handcomputern,
welche HTML unterstützen, zu benutzen. Als Client kann jedes
Betriebssystem eingesetzt werden.
</para>

<para>
OTRS ist in mehrere Komponenten aufgeteilt. Als Basis wird ein
Framework benötigt, der alle grundlegenden Funktionen des
Systems und das Trouble Ticket System enthält. An zusätzlichen
Komponenten können ein Webmailer, ein Dateimanager, ein
Contentmanager, ein Kalender und ein Modul zur Ausgabe verschiedener
Systemstatus bequem über die Weboberfläche nachinstalliert werden.
</para>
</sect1>

<sect1 id="features-of-otrs">
<title>Features</title>

<para>
OTRS bietet viele verschiedene Features. Die folgende Aufzählung
gibt einen Überblick über die wichtigsten Eigenschaften und
Fähigkeiten des zentralen OTRS-Frameworks.
</para>

<itemizedlist>
  <title>Die Features von OTRS</title>
  <listitem>
    <para>
    Webinterface:
    </para>
    <itemizedlist>
      <listitem>
        <para>
        Leichte und intuitive Bedienung über einen HTML-Browser.
        </para>
      </listitem>
      <listitem>
        <para>
        Auf aktive Inhalte wie Flash oder Java-Applets wird in der
        Weboberfläche bewusst verzichtet. Das System kann somit
        mit nahezu allen Browsern benutzt werden, auch von Mobiltelefonen
        oder Handcomputern aus.
        </para>
      </listitem>
      <listitem>
        <para>
        Eine Weboberfläche zur Administration des Systems ist vorhanden.
        </para>
      </listitem>
      <listitem>
        <para>
        Ein Webinterface für die Mitarbeiter (Agenten) zur Bearbeitung
        von Kundenanfragen ist verfügbar.
        </para>
      </listitem>
      <listitem>
        <para>
        Eine Weboberfläche für Kunden, über die Nachrichten an
        zuständige Agenten geschickt werden können und der Status
        eigener Tickets abgerufen werden kann, ist vorhanden.
        </para>
      </listitem>
      <listitem>
        <para>
        Unterstützung für verschiedene Oberflächen-Layouts
        (themes).
        </para>
      </listitem>
      <listitem>
        <para>
        Unterstützung vieler Sprachen.
        </para>
      </listitem>
      <listitem>
        <para>
        Eigene Anpassungen der Ausgabe-Vorlagen sind möglich (dtl).
        </para>
      </listitem>
      <listitem>
        <para>
        Mehrfach-Anhänge sind über die Weboberfläche
        möglich.
        </para>
      </listitem>
    </itemizedlist>
  </listitem>
  <listitem>
    <para>
    E-Mail-Schnittstelle:
    </para>
    <itemizedlist>
      <listitem>
        <para>
        Unterstützung für E-Mail-Anhänge (MIME support).
        </para>
      </listitem>
      <listitem>
        <para>
        Automatische Umwandlung von HTML- in reine Text-Nachrichten
        (höhere Sicherheit vor schädlichen Inhalten und
        schneller durchsuchbar).
        </para>
      </listitem>
      <listitem>
        <para>
        Filterung von E-Mails über eigene X-Header-Einträge
        oder Mailadressen, z. B. für die Aussortierung von Spam.
        </para>
      </listitem>
      <listitem>
        <para>
        PGP-Support, Erstellung und Import eigener Zertifikate,
        verschlüsselter und signierter Mails, Anzeige von
        verschlüsselten und signierten Nachrichten.
        </para>
      </listitem>
      <listitem>
        <para>
        Unterstützung für die Verschlüsselung und Anzeige
        von SMIME-Nachrichten.
        </para>
      </listitem>
      <listitem>
        <para>
        Automatisierte Antworten (auto responder) für die
        Benachrichtigung von Kunden, abhängig von der Queue
        konfigurierbar.
        </para>
      </listitem>
      <listitem>
        <para>
        E-Mail-Benachrichtigungen für Agenten über neue
        Tickets, Follow-ups oder freigegebene Tickets.
        </para>
      </listitem>
      <listitem>
        <para>
        Follow-Ups an Hand von Reference- oder In-Reply-To-Headern,
        automatisierte Zuordnung von Follow-Ups über den Ticket-Bezeichner
        im Betreff, Mailbody oder in Text-Anhängen.
        </para>
      </listitem>
    </itemizedlist>
  </listitem>
  <listitem>
    <para>
    Tickets:
    </para>
    <itemizedlist>
      <listitem>
        <para>
        Erweiterte Queue-Ansicht, Übersicht über alle Anfragen
        innerhalb einer Queue.
        </para>
      </listitem>
      <listitem>
        <para>
        Sperren von Tickets.
        </para>
      </listitem>
      <listitem>
        <para>
        Überwachen der Aktivitäten rund um ein Ticket mit Hilfe des
        TicketWatcher-Features.
        </para>
      </listitem>
      <listitem>
        <para>
        Festlegen eines Ticket-Verantwortlichen mit Hilfe des
        TicketResponsible-Features.
        </para>
      </listitem>
      <listitem>
        <para>
        Erstellung eigener Antwortvorlagen.
        </para>
      </listitem>
      <listitem>
        <para>
        Erstellung eigener auto responder, abhängig von der Queue.
        </para>
      </listitem>
      <listitem>
        <para>
        Ticket-History, Übersicht über die komplette
        Entwicklung eines Tickets, Änderungen der Ticketstatus,
        Übersicht über die verschidenen Aktionen für ein
        Ticket usw.
        </para>
      </listitem>
      <listitem>
        <para>
        Druckansicht für Tickets, Export als PDF möglich.
        </para>
      </listitem>
      <listitem>
        <para>
        Hinzufügen eigener (interner oder externer) Notizen zu einem Ticket
        (eigener Text und Dateianhänge).
        </para>
      </listitem>
      <listitem>
        <para>
        Möglichkeit zum Zoomen von Tickets.
        </para>
      </listitem>
      <listitem>
        <para>
        Definition von ACL's (access control lists) für Tickets.
        </para>
      </listitem>
      <listitem>
        <para>
        Tickets können an andere E-Mail-Adressen weiter- oder
        umgeleitet werden (forwarding, bouncing).
        </para>
      </listitem>
      <listitem>
        <para>
        Verschieben von Tickets zwischen verschiedenen Queues.
        </para>
      </listitem>
      <listitem>
        <para>
        Festlegen der Priorität für Tickets.
        </para>
      </listitem>
      <listitem>
        <para>
        Erfassung der Bearbeitungsdauer für Tickets.
        </para>
      </listitem>
      <listitem>
        <para>
        Anstehende Aufgaben für ein Ticket festlegen (pending
        features).
        </para>
      </listitem>
      <listitem>
        <para>
        Massenoperationen auf Tickets sind möglich (bulk features).
        </para>
      </listitem>
      <listitem>
        <para>
        Automatische und zeitgesteuerte Aktionen können mit
        Hilfe eines sog. Generic-Agenten auf Tickets ausgeführt
        werden.
        </para>
      </listitem>
      <listitem>
        <para>
        Volltextsuche über den gesamten Ticketbestand und Export der
        Suchergebnisse als PDF.
        </para>
      </listitem>
    </itemizedlist>
  </listitem>
  <listitem>
    <para>
    System:
    </para>
    <itemizedlist>
      <listitem>
	    <para>
	    OTRS läuft unter vielen Betriebssystemen (Linux, Solaris, AIX,
	    FreeBSD, OpenBSD, Mac OS 10.x, Microsoft Windows).
	    </para>
      </listitem>
      <listitem>
        <para>
        Unterstützung von ASP (active service providing).
        </para>
      </listitem>
      <listitem>
        <para>
        Verknüpfung von Objekten wie z. B. Tickets, FAQ-Einträgen
        o.ä. innerhalb des Systems.
        </para>
      </listitem>
      <listitem>
        <para>
        Einbindung externer Datenquellen für die Kundendaten, z. B.
        über AD, eDirectory oder OpenLDAP).
        </para>
      </listitem>
      <listitem>
        <para>
        Festlegen einer eigenen Kennzeichnung für Tickets, z. B.
        Cal#, Ticket#, Request# o.ä.
        </para>
      </listitem>
      <listitem>
        <para>
        Festlegen einer eigenen Nummerierung für Tickets.
        </para>
      </listitem>
      <listitem>
        <para>
        Unterstützung verschiedener Datenbanktypen für die
        zentrale Datenbank von OTRS (MySQL, PostgreSQL, SAPDB, Oracle
        MSSQL, usw.).
        </para>
      </listitem>
      <listitem>
        <para>
        Framework für die Erstellung von Statistiken über die Web-Oberfläche,
        Export und Import von Reports und Statistikmodulen, Export von
        Statistiken als PDF ist möglich.
        </para>
      </listitem>
      <listitem>
        <para>
        utf-8-Unterstützung für Front- und Back-End.
        </para>
      </listitem>
      <listitem>
        <para>
        Die Authentifikation für Agenten oder Kunden kann
        unabhängig voneinander über eine Datenbank, LDAP,
        HTTPAuth oder Radius realisiert werden.
        </para>
      </listitem>
      <listitem>
        <para>
        Unterstützung von Benutzer-Accounts, Benutzergruppen und
        Rollen.
        </para>
      </listitem>
      <listitem>
        <para>
        Unterstützung verschiedener Zugriffsrechte, z. B. auf
        Queues oder Systembereiche.
        </para>
      </listitem>
      <listitem>
        <para>
        Die Erstellung von Standardantworten ist möglich.
        </para>
      </listitem>
      <listitem>
        <para>
        Unter-Queues werden unterstützt.
        </para>
      </listitem>
      <listitem>
        <para>
        Anreden und Signaturen können abhängig von der Queue
        definiert werden.
        </para>
      </listitem>
      <listitem>
        <para>
        E-Mail-Benachrichtigungen für Administratoren.
        </para>
      </listitem>
      <listitem>
        <para>
        Bekanntgabe von Informationen zu Updates über die
        Weboberfläche oder via E-Mail.
        </para>
      </listitem>
      <listitem>
        <para>
        Festlegen von Ablauffristen für problematische Tickets.
        </para>
      </listitem>
      <listitem>
        <para>
        Benutzerabhängige Unterstützung für verschiedene Zeitzonen.
        </para>
      </listitem>
      <listitem>
        <para>
        Einfache Einbindung eigener Addons und Module mit Hilfe
        der OTRS API.
        </para>
      </listitem>
      <listitem>
        <para>
        Einfache Erstellung eigener Front-Ends, z. B. X11, Console usw.
        </para>
      </listitem>
    </itemizedlist>
  </listitem>
</itemizedlist>

<sect2 id="new-features-of-2.1">
<title>Neue Features von OTRS 2.1</title>

<itemizedlist>
<title>Die neuen Kern-Features von OTRS 2.1 im Überblick</title>
<listitem>
    <para>
    Multi-Kalnder-Funktionalität: Dieses Feature vereinfacht das Arbeiten in
    verschiedenen Umgebungen mit verschiedenen Zeitzonen. Die relevanten
    Arbeitsstunden des Systems können abhängig von der Zeitzone festgelegt
    werden, die Spezifikation von Urlaubs- und Feiertagen ist abhängig von
    der Region möglich.
    </para>
</listitem>
<listitem>
    <para>
    Statistik-Framework: Integration eines komplett überarbeiteten
    Statistik-Frameworks der es erlaubt, nahezu jede Art von Report über die
    Weboberfläche zu erstellen. Die Erstellung und Ansicht von Statistiken
    kann pro Benutzer, Gruppe und / oder Rolle freigeschaltet werden. Der
    Ex- und Import von bereits vorhandenen oder neuen Statistiken ist
    möglich, Statistikmodule aus früheren OTRS-Versionen können weiter
    verwendet werden.
    </para>
</listitem>
<listitem>
    <para>
    PDF-Generator: Die Druck-Ansicht von Tickets, Statistiken und
    Suchergebnisse können nun als PDF-Datei exportiert werden.
    </para>
</listitem>
<listitem>
    <para>
    Unterstützung von MSSQL: Eine Schnittstelle zu Microsofts SQL-Server
    wurde integriert, so dass nun die komplette OTRS Datenbank auch auf
    MSSQL-basierten Systemen installiert und benutzt werden kann.
    </para>
</listitem>
<listitem>
    <para>
    FAQ-Modul: Das FAQ-Modul von OTRS wurde komplett neu implementiert
    und aus dem zentralen OTRS-Framework herausgenommen, so dass eine
    Installation als seperates Modul möglich ist. Das neue FAQ-Modul bietet
    erweiterte Such- und Navigationsfunktionen, eine verbesserte
    Administration und eine Möglichkeit zur Bewertung von einzelnen FAQ-Einträgen.
    </para>
</listitem>
<listitem>
    <para>
    Unterstützung hirarchischer Team-Strukturen: Mit hilfe der neu
    eingeführten Überwachungs- und Verantwortlichkeitsfunktionen für
    Tickets, wird die strukturierte Bearbeitung von Tickets in Teams
    vereinfacht. Das Verantwortlichkeits-Feature ermöglicht es einem Agenten
    den Ticket-Besitz abzugeben, jedoch trotzdem noch alle Schreibrechte am
    Ticket zu behalten. Das Überwachungs-Features ermöglicht die Vrfolgung der
    Aktivitäten für ein Ticket, ohne selbst Eigentümer des Tickets zu sein.
    </para>
</listitem>
<listitem>
    <para>
    Optimierte Erkennung von Follow-Ups: Neben der Auswertung der
    Ticketnummer im Betreff einer Nachricht kann OTRS 2.1 nun auch nach
    Ticket-Bezeichnern im Body einer Mail und innerhalb von Textanhängen
    suchen und so ggfs. ein Follow-Up automatisiert zuordnen.
    </para>
</listitem>
</itemizedlist>

</sect2>

</sect1>

<sect1 id="software-requirements">
<title>Hard- und Software-Anforderungen</title>

<para>
OTRS kann unter vielen Betriebssystemen installiert werden. Neben Linux und
den verschiedenen Unix-Derivaten (z. B. OpenBSD oder FreeBSD), läuft
OTRS auch unter allen Windows-Versionen. Bezüglich der Hardware empfiehlt
es sich, mindestens einen 2 GHz Pentium Xeon oder vergleichbare CPU,
2 GB RAM und eine 160 GB Festplatte zu verwenden.
</para>

<para>
Für den Betrieb von OTRS werden einige externe Software-Komponenten
benötigt. Ein Web- sowie ein Datenbankserver und eine
funktionierende perl-Installation mit einigen Zusatzmodulen sind die
Grundvorraussetzungen für ein funktionierendes System. Der Webserver
und <application>perl</application> müssen auf der gleichen
Maschine installiert sein, auf der später auch OTRS ausgeführt werden soll.
Das Datenbank-Back-End kann auf der lokalen oder auf einer entfernten Maschine
installiert werden.
</para>

<para>
Für den Webserver wird empfohlen, auf <application>apache
1.3.x</application> oder <application>apache 2.x</application>
zurück zu greifen. Vor allem durch die Erweiterung der
apache-Konfiguration um das mod-perl-Modul, kann die Geschwindigkeit
von OTRS enorm gesteigert werden. Prinzipiell sollte aber jeder Webserver,
der die Ausführung von perl-Skripten unterstützt, für den
Betrieb von OTRS geeignet sein.
</para>

<para>
Als Datenbank-Back-End eignen sich besonders <application>MySQL</application>
ab Version 3.1.x oder <application>PostgreSQL</application>.
Grundsätzlich sollten jedoch alle Datenbankserver zusammen mit OTRS
verwendet werden können, die SQL als Datenbanksprache
unterstützen. Ein Vorteil der Benutzung von
<application>MySQL</application> ist, dass OTRS über einen
Webinstaller die Datenbank und Tabellen automatisch anlegen kann.
</para>

<para>
Für <application>perl</application> gilt mindestens die Version 5.8 zu
verwenden. Es werden einige Zusatzmodule benötigt, die Sie entweder
direkt über die Shell von <application>perl</application> und
CPAN oder mit Hilfe des Paketmanagers (<application>yast</application>,
<application>apt-get</application>) Ihres Betriebssystems einspielen
müssen.
</para>

<para>
Im Abschnitt für die

<link linkend="installation-of-needed-perl-modules">
manuelle Installation der für OTRS benötigten perl-Module
</link>

wird beschrieben, wie Sie perl-Module manuell einspielen können.
</para>

<para>
Wenn Sie ein bereits vorgefertigtes OTRS-Paket für Ihr Betriebssystem
zur Installation verwenden (rpm, Windows-Installer), sollten
die benötigten perl-MOdule automatisch installiert werden.
</para>
</sect1>

<sect1 id="community">
<title>Community</title>

<para>
Um OTRS hat sich in den letzten Jahren eine große Community
gebildet. Über

<link linkend="additional-resources-mailinglists">
Mailinglisten
</link>

tauschen sich Anwender und Entwickler zu den verschiedensten Themen rund um
das Trouble Ticket System aus. Behandelt werden Fragen rund um die Installation,
Konfiguration, Benutzung, Lokalisation und Entwicklung. Fehler in
der Software können über ein

<link linkend="additional-resources-bugtracking">
Bug-Tracking-System
</link>

gemeldet werden und erreichen so die zuständigen Entwickler bzw. gehen
nicht verloren, so dass schnell Fixes bereit gestellt werden können.
</para>

<para>
<screenshot>
<screeninfo>Homepage OTRS.org</screeninfo>
<graphic srccredit="Homepage OTRS.org" scale="40" fileref="screenshots/homepage-otrs.png"/>
</screenshot>
</para>

<para>
Die Community ist über die Homepage

<ulink url="http://www.otrs.org">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

zu erreichen.
</para>
</sect1>

<sect1 id="commercial-support-for-otrs">
<title>Kommerzieller Support für OTRS</title>

<para>
Neben der Unterstützung aus der Open Source Community auf

<ulink url="http://www.otrs.org">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

ist auch kommerzieller Support rund um OTRS erhältlich. Über die Adresse

<ulink url="http://www.otrs.com">
<citetitle>http://www.otrs.com</citetitle>
</ulink>

sind die Seiten der OTRS AG zu finden, die den kommerziellen Teil des
OTRS.org-Projektes darstellen.
</para>

<para>
Das Angebot der OTRS AG umfasst Support, Consulting und fertige
Installations-CDs für OTRS und richtet sich an den Mittelstand,
Behörden, Institutionen und große Konzerne. Von der
professionellen Beratung zum Einsatz des Trouble Ticket Systems bis hin
zur kompletten Installation und Wartung
mit 24-Stunden Rückrufservice sind verschiedene
Supportpakete erhältlich. Fertige High-Performance- und
High-Availabilty-Systeme, aber auch die Anfertigung
von Spezialanpassungen runden das Angebot der OTRS AG ab.
</para>

<para>
Detaillierte Informationen zu den verschiedenen Angeboten der OTRS
AG sind unter

<ulink url="http://www.otrs.com">
<citetitle>http://www.otrs.com</citetitle>
</ulink>

zu finden oder können über die Mailadresse

<ulink url="mailto:sales at otrs.com">
<citetitle>sales at otrs.com</citetitle>
</ulink>

erfragt werden.
</para>
</sect1>

</chapter>
<!-- $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $ --><chapter id="installation-and-basic-configuration">
<title>Installation des OTRS Framework</title>

<abstract>
<para>
Dieser Abschnitt beschreibt die Installation und die grundlegende
Einrichtung des zentralen OTRS Frameworks. Dabei wird auf die Installation
von bereits fertigen Paketen für die Betriebssysteme Linux und
Microsoft Windows eingegangen, aber auch die manuelle Installation direkt
über die Quellen erklärt, wodurch eine Installation auch auf
anderen, hier nicht näher beschriebenen, Betriebssystemen
übertragbar sein sollte.
</para>

<para>
Die Einrichtung des Web- und Datenbankservers,
die Schnittstelle zwischen OTRS und der Datenbank, das Einspielen
einzelner perl-Module, das Setzen der richtigen Berechtigungen, die
Einrichtung der OTRS-eigenen cron-Jobs sowie grundlegende Einstellungen
in den OTRS-Konfigurationsdateien, sind in diesem Kapitel zu finden.
</para>

<para>
Am Ende dieses Abschnitts sollte ein lauffähiges OTRS auf Ihrem
Betriebssystem installiert sein, an dessen Weboberfläche Sie sich
bereits als OTRS-Administrator anmelden können.
</para>
</abstract>

<sect1 id="installation-of-prepared-packages">
<title>Der einfache Weg - Installation fertiger Pakete</title>

<para>
Der einfachste und komfortableste Weg ein lauffähiges OTRS zu
installieren ist sicherlich, auf bereits vorgefertigte Pakete zurück
zu greifen. Viele bereits vorgefertigte Installations-Pakete sind im
Download-Bereich unter

<ulink url="http://www.otrs.org">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

zu finden. Da der Aufwand viel zu groß wäre, die Installation
aller dort aufgeführten Pakete in dieser Dokumentation anzuführen,
soll im Folgenden nur näher auf die Installation von OTRS unter SUSE
Linux, Debian und Microsoft Windows eingegangen werden. Sehen Sie unter
der o.g. URL nach, ob auch für Ihr Betriebssystem ein fertiges
Installations-Paket vorhanden ist und greifen Sie nur auf die manuelle
Installation zurück, wenn Sie keine andere Möglichkeit haben.
</para>

<sect2 id="installation-on-suse">
<title>Installation des rpm-Softwarepackets auf einer SUSE Linux
Distribution</title>

<para>
Dieser Abschnitt beinhaltet die Anleitung für die Installation von OTRS
unter SUSE Linux. Getestet wurden die Versionen bis SUSE Linux 9.3.
Bevor Sie mit der Installation beginnen, sehen Sie bitte unter

<ulink url="http://www.otrs.org/">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

nach, ob eine aktuellere Version von OTRS als .rpm-Datei vorliegt.
Sollte dies der Fall sein, verwenden Sie bitte diese neuere Version.
</para>

<para>
Installieren Sie OTRS mittels <application>yast</application> (yast2)
oder der Kommandozeile und <command>rpm</command>, je nach
Vorliebe. Beachten Sie jedoch, dass OTRS einige perl-Module
benötigt, die nicht standardmäßig in einer typischen
SUSE-Installation enthalten sind. <application>yast</application> sollte
die bessere Wahl sein, da es alle Abhängikeiten automatisch
beachtet und auflösen kann.
</para>

<para>
Sollten Sie den Weg über die Kommandozeile mit
<command>rpm</command> bevorzugen, so müssen Sie die
perl-Module manuell vor Beginn der Installation von
OTRS installieren. Angenommen Sie haben die Datei
<filename>otrs.rpm</filename> im Verzeichnis <filename>/tmp</filename>
gespeichert, dann geben Sie zur Installation von OTRS folgenden Befehl ein.
</para>

<para>
<screen>
linux:~ # rpm -ivh /tmp/otrs.rpm
otrs                        ##################################################
Check OTRS user (/etc/passwd)... otrs exists.

Next steps:

[SuSEconfig]
 Execute 'SuSEconfig' to configure the webserver.

[start Apache and MySQL]
 Execute 'rcapache restart' and 'rcmysql start' in case they don't run.

[install the OTRS database]
 Use a webbrowser and open this link:
 http://localhost/otrs/installer.pl

[OTRS services]
 Start OTRS 'rcotrs start-force' (rcotrs {start|stop|status|restart|start-force|stop-force}).

Have fun!

 Your OTRS Team
 http://otrs.org/

linux:~ #
</screen>
</para>

<para>
Nach der Installation des rpm's ist es notwendig
<application>SuSEconfig</application> zu starten. Geben Sie hierzu
Folgendes ein.
</para>

<para>
<screen>
linux:~ # SuSEconfig
Starting SuSEconfig, the SuSE Configuration Tool...
Running in full featured mode.
Reading /etc/sysconfig and updating the system...
Executing /sbin/conf.d/SuSEconfig.aaa_at_first...
Executing /sbin/conf.d/SuSEconfig.apache...
Including /opt/otrs/scripts/apache-httpd.include.conf
Executing /sbin/conf.d/SuSEconfig.bootsplash...
Executing /sbin/conf.d/SuSEconfig.doublecheck...
Executing /sbin/conf.d/SuSEconfig.guile...
Executing /sbin/conf.d/SuSEconfig.hostname...
Executing /sbin/conf.d/SuSEconfig.ispell...
Executing /sbin/conf.d/SuSEconfig.perl...
Executing /sbin/conf.d/SuSEconfig.permissions...
Executing /sbin/conf.d/SuSEconfig.postfix...
Setting up postfix local as MDA...
Setting SPAM protection to "off"...
Executing /sbin/conf.d/SuSEconfig.profiles...
Finished.
linux:~ #
</screen>
</para>

<para>
Die Installation des OTRS-rpm ist abgeschlossen. Starten Sie nun
Ihren Webserver neu, um die Änderungen in der Konfiguration zu
übernehmen.
</para>

<para>
<screen>
linux:~ # rcapache restart
Shutting down httpd                                         done
Starting httpd [ PERL ]                                     done
linux:~ #
</screen>
</para>

<para>
Der nächste Schritt ist das Aufsetzen der Datenbank.
Wenn sie <application>MySQL</application> als Datenbankserver verwenden,
können Sie hierzu den Webinstaller von OTRS benutzen. Geben Sie
dazu folgende Adresse in Ihrem Browser ein.
</para>

<para>
<ulink url="http://localhost/otrs/installer.pl">
<citetitle>http://localhost/otrs/installer.pl</citetitle>
</ulink>
</para>

<para>
Der Webinstaller wird gestartet. Folgen Sie den Anweisungen auf dem
Bildschirm.
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Lizenz (1/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer.png"/>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer1.png"/>
</screenshot>
</para>

<warning>
<para>
Es ist niemals eine gute Idee, Standardpasswörter zu
verwenden! Bitte ändern Sie deshalb unbedingt das von OTRS
standardmäßig gesetzte Passwort!
</para>
</warning>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer2.png"/>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - System einstellungen (3/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer3.png"/>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Fertig (4/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer4.png"/>
</screenshot>
</para>

<para>
Nachdem alle Einstellungen vorgenommenw urden, kann OTRS nun gestartet
werden.
</para>

<para>
<screen>
linux:~ # rcotrs restart-force
Shutting down OTRS
 Disable /opt/otrs/bin/PostMaster.pl ... done.
no crontab for otrs
 Shutting down cronjobs ... failed!
Shutting down OTRS (completely)
 Shutting down Apache ... done.
 Shutting down MySQL ... done.
                                                                     done
Starting OTRS (completely)
 Starting Apache ... done.
 Starting MySQL ... done.
Starting OTRS
 Checking Apache ... done.
 Checking MySQL ... done.
 Checking database connect... (It looks Ok!).
 Enable /opt/otrs/bin/PostMaster.pl ... done.
 Checking otrs spool dir...  done.
 Creating cronjobs (source /opt/otrs/var/cron/*) ... done.

  --&gt;&gt; http://linux.example.com/otrs/index.pl &lt;&lt;--
                                                                     done
                                                                     done
linux:~ #
</screen>
</para>

<para>
Die Installation von OTRS ist beendet, Sie sollten das System nun
verwenden können. Um sich in die Weboberfläche des
Trouble Ticket Systems einloggen zu können, geben sie die Adresse

<ulink url="http://localhost/otrs/index.pl">
<citetitle>http://localhost/otrs/index.pl</citetitle>
</ulink>

in Ihrem Browser ein. Melden sie sich als OTRS-Administrator an und
konfigurieren Sie das System Ihren Wünschen entsprechend.
Als Benutzername verwenden Sie root@localhost, das Passwort lautet
root.
</para>

<warning>
<para>
Bitte ändern Sie auch dieses Passwort schnellstmöglich! Es
handelt sich auch hier um ein Standardpasswort!
</para>
</warning>

</sect2>

<sect2 id="installation-on-debian">
<title>Installation von OTRS auf einer Debian-Distribution</title>

<para>
Eine ausführliche Beschreibung zur Installation von OTRS auf Debian-Systemen
wurde dankenswerter Weise vom Maintainer des OTRS-Pakets, Torsten Werner,
bereit gestellt. Sie kann über den Link

<ulink url="http://www.writely.com/View.aspx?docid=drm3kmx_0cbr3x9">
http://www.writely.com/View.aspx?docid=drm3kmx_0cbr3x9
</ulink>

eingesehen werden.
</para>
</sect2>

<sect2 id="installation-on-windows">
<title>Installation von OTRS unter Microsoft Windows</title>

<para>
Die Installation von OTRS unter Microsoft Windows ist denkbar einfach.
Laden Sie den auf

<ulink url="http://www.otrs.org/">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

bereit gestellten Installer herunter und speichern Sie die Datei.
Anschließend führen Sie den Installer einfach aus und folgen
den einzelnen Installationsschritten.
</para>

<important>
<para>
Der Windows-Installer für OTRS beinhaltet bereits alle Komponenten,
die für den Betrieb von OTRS benötigt werden. D.h., es wird
zusätzlich zum eigentlichen OTRS der <application>apache2</application>
Webserver, <application>MySQL</application>, <application>perl</application>
mit den für OTRS benötigten Modulen und
<application>cron</application> für Windows installiert. Aus diesem
Grund ist es empfehlenswert OTRS über den Installer nur auf solchen
Windowssystemen zu installieren, auf denen noch kein
<application>apache2</application> bzw. ein anderer Webserver und
<application>MySQL</application> läuft.
</para>
</important>

</sect2>

</sect1>

<sect1 id="manual-installation-of-otrs">
<title>Manuelle Installation (Linux, Unix)</title>

<sect2 id="preparing-manual-installation">
<title>Vorbereiten der manuellen Installation</title>

<para>
Wenn Sie OTRS manuell über die Quellen installieren möchten oder
müssen, laden Sie sich zuerst das aktuelle Archiv herunter. Sie finden
die entsprechenden .tar.gz- oder .tar.bz2-Dateien im Downloadbereich auf

<ulink url="http://www.otrs.org/">
<citetitle>http://www.otrs.org</citetitle>
</ulink>

</para>

<para>
Entpacken Sie das Archiv mit Hilfe von <command>tar</command> z. B. in das
Verzeichnis <filename>/opt</filename>:
</para>

<para>
<screen>
linux:/opt# tar xf /tmp/otrs-2.0.0.tar.gz
linux:/opt# ls
otrs
linux:/opt#
</screen>
</para>

<para>
Da die Skripte von OTRS später nicht mit root-Rechten laufen sollen, muss
im nächsten Schritt ein Benutzer für OTRS im System angelegt
werden. Dieser Benutzer sollte als Homeverzeichnis das Verzeichnis erhalten,
in das gerade die Quellen von OTRS entpackt wurden, also
<filename>/opt/otrs</filename>. Wird der Webserver unter einem anderen
Benutzer als dem OTRS-User betrieben, so muss der neue OTRS-Benutzer
noch zur Gruppe des Webserver-Users hinzugefügt werden.
</para>

<para>
<screen>
linux:/opt# useradd -d /opt/otrs/ -c 'OTRS user' otrs
linux:/opt# usermod -G nogroup otrs
linux:/opt#
</screen>
</para>

<para>
Im nächsten Schritt werden einige Demo-Konfigurationsdateien
innerhalb der entpackten Quelldateien bzw. innerhalb des Homeverzeichnisses
des OTRS-Benutzers kopiert. Die Dateien befinden sich in den Verzeichnissen
<filename>/opt/otrs/Kernel</filename> bzw.
<filename>/opt/otrs/Kernel/Config</filename> und haben die Endung .dist.
</para>

<para>
<screen>
linux:/opt# cd otrs/Kernel/
linux:/opt/otrs/Kernel# cp Config.pm.dist Config.pm
linux:/opt/otrs/Kernel# cd Config
linux:/opt/otrs/Kernel/Config# for foo in *.dist; do cp $foo `basename
$foo .dist`; done
linux:/opt/otrs/Kernel/Config#
</screen>
</para>

<para>
Zum Abschluss der Vorbereitungen werden noch die richtigen
Zugriffsrechte für die Dateien des Ticket Systems gesetzt. Dazu kann
das Skript <command>SetPermissions.sh</command> verwendet werden, das sich
im Verzeichnis <filename>bin</filename> innerhalb des Homeverzeichnisses des
OTRS-Benutzers befindet. Das Skript kann mit folgenden Parametern
aufgerufen werden:
</para>

<para>
<cmdsynopsis>
  <command>SetPermissions.sh</command>
    <arg choice="req">
      <replaceable>Homedirectory des OTRS Benutzers</replaceable>
    </arg>
    <arg choice="req">
      <replaceable>OTRS Benutzer</replaceable>
    </arg>
    <arg choice="req">
      <replaceable>Webserver Benutzer</replaceable>
    </arg>
    <arg choice="opt">
      <replaceable>Gruppe des OTRS Benutzers</replaceable>
    </arg>
    <arg choice="opt">
      <replaceable>Gruppe des Webserver Benutzers</replaceable>
    </arg>
  </cmdsynopsis>
</para>

<para>
Läuft Ihr Webserver mit den Benutzerrechten des OTRS Benutzers, dann
lautet das Kommando also
<command>SetPermissions.sh /opt/otrs otrs otrs</command>. Unter SUSE Linux
wird der Webserver mit dem Benutzer wwwrun betrieben. Geben Sie hier
das Komando <command>SetPermissions.sh /opt/otrs otrs wwwrun</command> ein.
</para>

<para>
Nach diesen Schritten ist die Vorbereitung zur Installation des Ticket
Systems abgeschlossen und es kann der Webserver auf die Verwendung von OTRS
vorbereitet werden.
</para>

</sect2>

<sect2 id="installation-of-needed-perl-modules">
<title>Installation der für OTRS benötigten perl-Module</title>

<para>
Für den Betrieb von OTRS werden einige perl-Module benötigt. Wenn
Sie OTRS manuell einrichten, müssen Sie wahrscheinlich einige
dieser Module per Hand nachinstallieren. Dies können Sie entweder
über den Paketmanager ihrer Distribution erledigen (<application>yast</application>,
<application>apt-get</application>), oder, wie in diesem Kapitel
beschrieben,  direkt über die Shell von <application>perl</application>
und CPAN.
</para>

<para>
Die folgenden perl-Module werden von OTRS
benötigt.
</para>

<para>

<table id="table-of-needed-perl-modules">
<title>Die von OTRS benötigten perl-Module</title>
  <tgroup cols="2">
    <thead>
      <row>
        <entry>
          Name
        </entry>
        <entry>
          Beschreibung
        </entry>
      </row>
    </thead>
    <tbody>
      <row>
        <entry>
          CGI
        </entry>
        <entry>
          Mit diesem Modul wird die Darstellung der OTRS-Oberfläche
          als Webinterface ermöglicht.
        </entry>
      </row>
      <row>
        <entry>
          Date::Pcalc
        </entry>
        <entry>
          Dieses Modul enthält Berechnungsgrundlagen zum
          gregorianischen Kalender und wird in OTRS z. B. für die
          zeitspezifischen Berechnungen auf Tickets benötigt.
        </entry>
      </row>
      <row>
        <entry>
          DBI
        </entry>
        <entry>
          Dieses Modul wird von OTRS für die Verbindung zum
          Datenbank-Backend benötigt.
        </entry>
      </row>
      <row>
        <entry>
          DBD::mysql
        </entry>
        <entry>
          Modul zum Verbindungsaufbau zum MySQL-Datenbank-Backend.
        </entry>
      </row>
      <row>
        <entry>
          Digest::MD5
        </entry>
        <entry>
          Ermöglicht die Verwendung des md5-Algorithmus.
        </entry>
      </row>
      <row>
        <entry>
          LWP::UserAgent
        </entry>
        <entry>
          Modul zur Verarbeitung von http-Anfragen.
        </entry>
      </row>
      <row>
        <entry>
          MIME::Base64
        </entry>
        <entry>
          En- und Decodierung von Base64-Strings.
        </entry>
      </row>
      <row>
        <entry>
          MIME::Tools
        </entry>
        <entry>
          Modul mit verschiedenen Werkzeugen für die Verarbeitung von
          Nachrichten mit MIME-Teil.
        </entry>
      </row>
      <row>
        <entry>
          Mail::Internet
        </entry>
        <entry>
          Modul für die Bearbeitung von E-Mails nach RFC 822
        </entry>
      </row>
      <row>
        <entry>
          Net::DNS
        </entry>
        <entry>
          Schnittstelle zum Domain Name System (DNS).
        </entry>
      </row>
      <row>
        <entry>
          Net::POP3
        </entry>
        <entry>
          Modul mit Funktionen für den Zugriff auf einen
          POP3-Server.
        </entry>
      </row>
      <row>
        <entry>
          Net::LDAP
        </entry>
        <entry>
          Modul zur Verarbeitung von Anfragen an ein LDAP-Directory. Dieses
          Modul wird nur benötigt, wenn OTRS mit einem LDAP-Directory
          betrieben werden soll, z. B. fuer die Abfrage von Kundendaten.
        </entry>
      </row>
      <row>
        <entry>
          Net::SMTP
        </entry>
        <entry>
          Modul mit Funktionen zum Versenden von Mails.
        </entry>
      </row>
      <row>
        <entry>
          Authen::SASL
        </entry>
        <entry>
          SASL Authentication Framework, wird z. B. für die Anmeldung
          an Mailservern benötigt.
        </entry>
      </row>
      <row>
        <entry>
          GD
        </entry>
        <entry>
          Schnittstelle zur Gd Graphics Library. Wird nur
          benötigt, wenn das Statistikmodul von OTRS verwendet
          werden soll.
        </entry>
      </row>
      <row>
        <entry>
          GD::Text, GD::Graph, GD::Graph::lines, GD::Text::Align
        </entry>
        <entry>
          Text- und Grafikwerkzeuge für die Benutzung zusammen mit der
          GD Graphics Library. Diese Komponenten werden nur benötigt,
          wenn das Statistikmodul von OTRS verwendet werden soll.
        </entry>
      </row>
      <row>
        <entry>
          XML::Parser
        </entry>
        <entry>
          Dieses Modul wird benötigt, um Konfigurationsparameter
          aus XML-Files auszulesen bzw. Konfigurationen in XML-Dateien zu
          schreiben. Die grafische Administrations-Oberfläche von OTRS
          greift auf diese Mechanissmen zurück.
        </entry>
      </row>
      <row>
        <entry>
          PDF::API2, Compress::Zlib
        </entry>
        <entry>
          Diese Module werden für die Generierung der PDF-Ausgaben von
          Statistiken, Suchergebnissen oder Druckansicht eines Tickets benötigt.
        </entry>
      </row>
    </tbody>
  </tgroup>
</table>

</para>

<para>
Um eines der oben aufgeführten Module mit Hilfe von CPAN zu
installieren, geben Sie als root das Kommando
<command>perl -e shell -MCPAN</command> ein. perl wird im interaktiven
Modus gestartet und das CPAN Modul wird geladen. Ist CPAN bereits
ordentlich konfiguriert, können Sie die für OTRS benötigten
Module mit Hilfe des Kommandos <command>install</command> gefolgt vom
Modulnamen einrichten. CPAN weist darauf hin, wenn Abhängigkeiten
zwischen einzelnen Modulen nicht erfüllt sind und schlägt
automatisch die zusätzlich benötigten Module für die
Installation vor.
</para>

<para>
Nachdem Sie alle perl-Module installiert haben, können Sie mit Hilfe
des Skriptes <command>otrs.checkModules</command> überprüfen, ob
OTRS wirklich alle benötigten Module finden und verwenden kann. Das
Skript finden sie im Verzeichnis <filename>bin</filename> innerhalb des
Homeverzeichnisses des OTRS Benutzers.
</para>

<para>
<screen>
linux:~# cd /opt/otrs/bin/
linux:/opt/otrs/bin# ./otrs.checkModules

                  CGI ... ok
          Date::Pcalc ... ok
         Date::Format ... ok
                  DBI ... ok
           DBD::mysql ... ok
          Digest::MD5 ... ok
     Crypt::PasswdMD5 ... ok
       LWP::UserAgent ... ok
           IO::Scalar ... ok
             IO::Wrap ... ok
         MIME::Base64 ... ok
          MIME::Tools ... ok
       Mail::Internet ... ok
             Net::DNS ... ok
            Net::POP3 ... ok
            Net::LDAP ... ok
            Net::SMTP ... ok
         Authen::SASL ... ok
                   GD ... ok
             GD::Text ... ok
            GD::Graph ... ok
     GD::Graph::lines ... ok
      GD::Text::Align ... ok
          XML::Parser ... ok
            PDF::API2 ... not installed! (for PDF output - not required)
       Compress::Zlib ... ok
linux:/opt/otrs/bin#
</screen>
</para>

<para>
Führen Sie weiterhin die beiden Befehle
<command>perl -cw bin/cgi-bin/index.pl</command> und
<command>perl -cw bin/PostMaster.pl</command> aus, nach dem Sie in das
Verzeichnis <filename>/opt/otrs</filename> gewechselt sind. Wird bei
beiden Befehlen die Meldung "syntax OK" angezeigt, verfügt Ihre
perl-Installation über alle von OTRS benötigten Module und Sie
können im nächsten Schritt mit der Einrichtung des Webservers
beginnen.
</para>

<para>
<screen>
linux:~# cd /opt/otrs
linux:/opt/otrs# perl -cw cgi-bin/installer.pl
cgi-bin/installer.pl syntax OK
linux:/opt/otrs# perl -cw PostMaster.pl
PostMaster.pl syntax OK
linux:/opt/otrs#
</screen>
</para>

</sect2>

<sect2 id="webserver-configuration">
<title>Konfiguration des apache Webservers</title>

<para>
In diesem Abschnitt wird beschrieben, wie der
<application>apache</application> Webserver grundlegend für OTRS
eingerichtet werden muss. Der Webserver solte cgi- bzw. perl-Skripte
ausführen können, anderenfalls ist kein Betrieb von
OTRS möglich. Überprüfen Sie die Konfigurationsdateien Ihres
Webservers und stellen Sie fest, ob das cgi-Modul geladen wird: Wenn Ihr
Webserver die Ausführung von cgi-Skripten unterstützt, sollte
eine Zeile ähnlich der folgenden zu finden sein.
</para>

<para>
<programlisting id="load-cgi-module">
LoadModule cgi_module /usr/lib/apache2/modules/mod_cgi.so
</programlisting>
</para>

<para>
Um die Oberfläche von OTRS bequem erreichen zu können, wird ein
Alias- und ein ScriptAlias-Eintrag angelegt. Für die meisten
Installationen des <application>apache</application> Webservers gilt, dass
ein Verzeichnis mit dem Namen <filename>conf.d</filename> vorhanden ist,
unter Linux ist es meist unterhalb des Verzeichnisses
<filename>/etc/apache</filename> bzw. <filename>/etc/apache2</filename> zu
finden. Wechseln Sie als root in dieses Verzeichnis und öffnen
Sie die Datei <filename>otrs.conf</filename> mit einem Editor bzw. legen
Sie diese Datei an. Tragen Sie die folgenden Zeilen in die Datei ein.
</para>

<para>
<programlisting id="basic-apache-configuration-for-otrs">
#
# Basic apache configuration for OTRS
#
# agent, admin and customer frontend
#
ScriptAlias /otrs/ "/opt/otrs/bin/cgi-bin/"
Alias /otrs-web/ "/opt/otrs/var/httpd/htdocs/"
#
# directory settings
#
&lt;Directory "/opt/otrs/bin/cgi-bin/"&gt;
    AllowOverride None
    Options +ExecCGI -Includes
    Order allow,deny
    Allow from all
&lt;/Directory&gt;
&lt;Directory "/opt/otrs/var/httpd/htdocs/"&gt;
    AllowOverride None
    Order allow,deny
    Allow from all
&lt;/Directory&gt;
</programlisting>
</para>

<para>
Speichern Sie die Datei, schließen Sie den Editor und starten Sie Ihren
Webserver neu, um die neue Konfiguration zu laden. Auf den meisten Systemen
lässt sich der Webserver über den Befehl
<command>/etc/init.d/apache restart</command> bzw.
<command>/etc/init.d/apache2 restart</command> neu starten.
</para>

<para>
<screen>
linux:/etc/apache2/conf.d# /etc/init.d/apache2 restart
Forcing reload of web server: Apache2.
linux:/etc/apache2/conf.d#
</screen>
</para>

<para>
Das war bereits die grundlegende Konfiguration des Webservers für
OTRS. Im nächsten Schritt kann die Datenbank eingerichtet werden.
</para>
</sect2>

<sect2 id="database-configuration">
<title>Einrichten der Datenbank</title>

<sect3 id="installation-of-database-with-the-webinstaller">
<title>Einrichtung der Datenbank mit Hilfe des Webinstallers (nur für
<application>MySQL</application>)</title>

<para>
Wenn Sie <application>MySQL</application> als Datenbankserver einsetzen,
können Sie die OTRS Datenbank leicht und bequem mit Hilfe des
Webinstallers einrichten. Geben Sie folgende Adresse in Ihrem Browser ein,
um den Webinstaller zu starten:
</para>

<para>
<ulink url="http://localhost/otrs/installer.pl">
<citetitle>http://localhost/otrs/installer.pl</citetitle>
</ulink>
</para>

<para>
Der Webinstaller wird gestartet. Folgen Sie den Anweisungen auf dem
Bildschirm.
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Lizenz (1/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer.png"/>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer1.png"/>
</screenshot>
</para>

<warning>
<para>
Es ist niemals eine gute Idee, Standardpasswörter zu
verwenden! Bitte ändern Sie deshalb unbedingt das von OTRS
standardmäßig gesetzte Passwort!
</para>
</warning>

<para>
<screenshot>
<screeninfo>installer.pl screen - Datenbank erstellen (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer2.png"/>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - System einstellungen (3/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer3.png"/>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>installer.pl screen - Fertig (4/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer4.png"/>
</screenshot>
</para>

<para>
Die OTRS Datenbank wurde aufgesetzt. Im nächsten Schritt werden die
cron-Jobs eingerichtet, die von OTRS benötigt werden.
</para>

</sect3>

<sect3 id="manual-installation-of-database">
<title>Manuelle Installation der OTRS Datenbank</title>

<para>
Wenn Sie den Webinstaller nicht einsetzen können, kann die Datenbank
für OTRS auch manuell eingerichtet werden. Skripte mit dem
Datenbankschema und den SQL-Statements finden Sie im Verzeichnis
<filename>scripts/database</filename> innerhalb des Homeverzeichnisses des
OTRS Benutzers.
</para>

<para>
<screen>
linux:~# cd /opt/otrs/scripts/database/
linux:/opt/otrs/scripts/database# ls
initial_insert.sapdb.sql    otrs-schema-post.maxdb.sql
initial_insert.sql          otrs-schema-post.mysql.sql
otrs-schema.maxdb.sql       otrs-schema-post.oracle.sql
otrs-schema.mysql.sql       otrs-schema-post.postgresql.sql
otrs-schema.oracle.sql      otrs-schema.xml
otrs-schema.postgresql.sql
linux:/opt/otrs/scripts/database#
</screen>
</para>

<para>
Für die verschiedenen Datenbanktypen sind mehrere .sql-Dateien
vorhanden, die nacheinander abgearbeitet werden müssen. Um die Datenbank
anzulegen, gehen Sie folgendermaßen vor:
</para>

<para>
<orderedlist numeration="arabic">
<title>Die verschiedenen Schritte für die manuelle Erstellung der
Datenbank</title>
<listitem>
<para>
Anlegen der Datenbank für OTRS: Legen Sie mit Hilfe Ihres
Datenbankinterfaces bzw. Ihrer Datenbankoberfläche die Datenbank
an, die später von OTRS verwendet werden soll.
</para>
</listitem>
<listitem>
<para>
Erstellen der Tabellen: Mit Hilfe der otrs-schema.Datenbanktyp.sql-Dateien
(z. B. <filename>otrs-schema.oracle.sql</filename>,
<filename>otrs-schema.postgresql.sql</filename>, usw.) können Sie die
Tabellen innerhalb der OTRS Datenbank erzeugen.
</para>
</listitem>
<listitem>
<para>
Einfügen der vom System benötigten Daten: Damit OTRS richtig
funktioniert, müssen einige Daten in verschiedene Tabellen geschrieben
werden (z. B. die verschiedenen Ticketstatus, Ticket- und
Benachrichtigungstypen, etc.). Verwenden Sie entweder die Datei
<filename>initial_insert.sql</filename> oder
<filename>initial_insert.sapdb.sql</filename> zum Einspielen der Daten,
je nachdem welche Datenbank verwendet wird.
</para>
</listitem>
<listitem>
<para>
Erzeugen von "foreign keys" auf andere Tabellen: Abschließend
müssen noch die "foreign keys" erstellt werden, über die die
verschiedenen Tabellen in der OTRS Datenbank voneinander abhängen.
Dies kann mit Hilfe der otrs-schema-post.Datenbanktyp.sql-Dateien erreicht
werden (z. B. <filename>otrs-schema-oracle.post.sql</filename>,
<filename>otrs-schema-post.postgresql.sql</filename>, usw.).
</para>
</listitem>
</orderedlist>
</para>

<para>
Nachdem Sie die Datenbank angelegt haben, sollten Sie die Zugriffsrechte
dafür setzen und z. B. sicherstellen, dass nur ein bestimmter
Benutzer ohne Datenbank-Administrationsrechte Zugriff auf die OTRS
Datenbank hat. Je nachdem, welche Datenbank Sie einsetzen, unterscheiden
sich hier die Vorgehensweisen, es sollte jedoch möglich sein dies mit
Hilfe Ihres Datenbankinterfaces bzw. Ihrer Datenbankoberfläche zu
erledigen.
</para>

<para>
Wurden die nötigen Einstellungen für die Datenbank vorgenommen,
muss nun noch dem Ticket System mitgeteilt werden, welche Datenbank es
verwenden soll. Öffnen Sie die Datei
<filename>Kernel/Config.pm</filename> innerhalb des Homeverzeichnisses des
OTRS Benutzers und passen Sie die dafür vorgesehenen Parameter an. Am
wichtigsten sind die folgenden Parameter.
</para>

<para>
<programlisting>

    # Database
    # (The database name.)
    $Self-&gt;{Database} = 'otrs';

    # DatabaseUser
    # (The database user.)
    $Self-&gt;{DatabaseUser} = 'otrs';

    # DatabasePw
    # (The password of database user.)
    $Self-&gt;{DatabasePw} = 'some-pass';

</programlisting>
</para>

<para>
Nachdem nun die Verbindung zur Datenbank steht, können im
nächsten Schritt die verschiedenen cron-Jobs für OTRS
eingerichtet werden.
</para>

</sect3>

</sect2>

<sect2 id="cronjobs">
<title>Einrichten der von OTRS benötigten cron-Jobs</title>

<para>
Damit OTRS voll funktioniert, werden einige cron-Jobs benötigt. Die
cron-Jobs sollten mit denselben Benutzerrechten ausgeführt werden,
die auch für die restlichen OTRS-Skripte vergeben wurden, d.h. die
cronJobs sollten in die crontab des OTRS-Benutzers eingetragen werden. Alle
Skripte für die verschiedenen cron-Jobs befinden sich im Verzeichnis
<filename>var/cron</filename> innerhalb des Homeverzeichnisses des
OTRS-Benutzers.
</para>

<para>
<screen>
linux:~# cd /opt/otrs/var/cron
linux:/opt/otrs/var/cron# ls
aaa_base.dist                pending_jobs.dist          session.dist
fetchmail.dist               postmaster.dist            unlock.dist
generic_agent-database.dist  postmaster_pop3.dist
generic_agent.dist           rebuild_ticket_index.dist
linux:/opt/otrs/var/cron#
</screen>
</para>

<para>
Alle Skripte tragen die Endung .dist und sollten zunächst so
umkopiert werden, dass keine Endung mehr vorhanden ist.
</para>

<para>
<screen>
linux:/opt/otrs/var/cron# for foo in `ls -1 *.dist` ; do cp $foo
`basename $foo .dist`; done
linux:/opt/otrs/var/cron# ls
aaa_base                     generic_agent.dist    rebuild_ticket_index
aaa_base.dist                pending_jobs
rebuild_ticket_index.dist
fetchmail                    pending_jobs.dist     session
fetchmail.dist               postmaster            session.dist
generic_agent                postmaster.dist       unlock
generic_agent-database       postmaster_pop3       unlock.dist
generic_agent-database.dist  postmaster_pop3.dist
linux:/opt/otrs/var/cron#
</screen>
</para>

<para>
Die folgende Tabelle gibt eine kurze Übersicht über die Aufgabe
der verschiedenen Skripte, die als cron-Job in der crontab des
OTRS-Benutzers installiert werden sollten.
</para>

<para>
<table id="table-of-cronjobs-for-otrs">
<title>Die verschiedenen Skripte für die cron-Jobs von OTRS</title>
  <tgroup cols="2">
    <thead>
      <row>
        <entry>
          Skript
        </entry>
        <entry>
          Aufgabe
        </entry>
      </row>
    </thead>
    <tbody>
      <row>
        <entry>
          aaa_base
        </entry>
        <entry>
          Über dieses Skript werden die grundlegenden Einstellungen
          für die crontab des OTRS-Benutzers festgelegt.
        </entry>
      </row>
      <row>
        <entry>
          fetchmail
        </entry>
        <entry>
          Falls Nachrichten mit Hilfe von fetchmail in das System
          eingespeißt werden sollen, kann dieses Skript verwendet werden.
        </entry>
      </row>
      <row>
        <entry>
          generic_agent
        </entry>
        <entry>
          Mit Hilfe dieses Skripts werden die Jobs des GenericAgents
          ausgeführt, die über eigene Konfigurationsdateien
          festgelegt wurden.
        </entry>
      </row>
      <row>
        <entry>
          generic_agent-database
        </entry>
        <entry>
          Mit Hilfe dieses Skripts werden die Jobs des GenericAgents
          ausgeführt, die über dem Administrations-Bereich
          innerhalb von "GenericAgent" angelegt wurden.
        </entry>
      </row>
      <row>
        <entry>
          pending_jobs
        </entry>
        <entry>
          Mit Hilfe dieses Skripts wird das System auf "wartende" (pending)
          Tickets überprüft.
        </entry>
      </row>
      <row>
        <entry>
          postmaster
        </entry>
        <entry>
          Mit Hilfe dieses Skripts wird die Nachrichten-Warteschlange von
          OTRS überprüft und noch nicht verarbeitete Nachrichten
          werden im System gespeichert bzw. zugestellt..
        </entry>
      </row>
      <row>
        <entry>
          postmaster_pop3
        </entry>
        <entry>
          Mit Hilfe dieses Skripts werden die verschiedenen pop3-Konten
          abgefragt, die im Administrations-Bereich innerhalb von
          "PostMaster POP3 Account" eingerichtet wurden.
        </entry>
      </row>
      <row>
        <entry>
          rebuild_ticket_index
        </entry>
        <entry>
          Mit Hilfe dieses Skripts wird der Ticket-Index für die
          Queue-Ansicht neu erzeugt, wodurch die Anzeige beschleunigt wird.
        </entry>
      </row>
      <row>
        <entry>
          session
        </entry>
        <entry>
          Über dieses Skript werden alte und nicht mehr gültige
          Session-IDs entfernt.
        </entry>
      </row>
      <row>
        <entry>
          unlock
        </entry>
        <entry>
          Mit Hilfe dieses Skripts wird die Freigabe von Tickets innerhalb
          des Systems ermöglicht.
        </entry>
      </row>
    </tbody>
  </tgroup>
</table>
</para>

<para>
Für die Einrichtung aller cron-Jobs kann das Skript
<filename>Cron.sh</filename> verwendet werden, das sich im Verzeichnis
<filename>bin</filename> innerhalb des Homeverzeichnisses des
OTRS-Benutzers befindet. Dem Cron.sh Skript muss beim Aufruf ein
Parameter übergeben werden. Dieser Parameter legt fest, ob die
cron-Jobs installiert, deinstalliert oder neu gestartet werden. Es sind
folgende Parameter zulässig.
</para>

<para>
<cmdsynopsis>
  <command>Cron.sh</command>
    <arg choice="req">
      <replaceable>start</replaceable>
    </arg>
    <arg choice="req">
      <replaceable>stop</replaceable>
    </arg>
    <arg choice="req">
      <replaceable>restart</replaceable>
    </arg>
    <arg choice="opt">
      <replaceable>OTRS-Benutzer</replaceable>
    </arg>
  </cmdsynopsis>
</para>

<para>
Da die cron-Jobs für den OTRS-Benutzer angelegt werden sollen,
muss das Skript von diesem Benutzer ausgeführt werden. Sind Sie z. B.
als Benutzer root am System angemeldet, können Sie mit Hilfe des
Kommandos <command>su otrs</command> zum OTRS-Benutzer wechseln. Nehmen Sie
also die Installation wie folgt vor.
</para>

<warning>
<para>
Bitte beachten Sie, dass durch die Verwendung von
<filename>Cron.sh</filename> evtl. andere Cron-Jobs des OTRS-Benutzers
überschrieben bzw. gelöscht werden. Um weitere, nicht von OTRS benötigte
Cron-Jobs für den OTRS-Benutzer zu installieren, erweitern Sie bitte
<filename>Cron.sh</filename> dementsprechent.
</para>
</warning>

<para>
<screen>
linux:/opt/otrs/var/cron# cd /opt/otrs/bin/
linux:/opt/otrs/bin# su otrs
linux:~/bin$ ./Cron.sh start
Cron.sh - start/stop OTRS cronjobs - &lt;$Revision: 1.17 $&gt;
Copyright (c) 2002 Martin Edenhofer &lt;martin@otrs.org&gt;
(using /opt/otrs) done
linux:~/bin$ exit
exit
linux:/opt/otrs/bin#
</screen>
</para>

<para>
Mit Hilfe des Kommandos <command>crontab -l -u otrs</command>, das Sie als
root ausführen können, wird die crontab-Datei des OTRS-Benutzers
angezeigt und Sie können überprüfen, ob alle Einträge
vorhanden sind.
</para>

<para>
<screen>
linux:/opt/otrs/bin# crontab -l -u otrs
# --
# cron/aaa_base - base crontab package
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# Who gets the cron emails?
MAILTO="root@localhost"

# --
# cron/fetchmail - fetchmail cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# fetch every 5 minutes emails via fetchmail
#*/5 * * * * /usr/bin/fetchmail -a &gt;&gt; /dev/null

# --
# cron/generic_agent - GenericAgent.pl cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# start generic agent every 20 minutes
*/20 * * * * $HOME/bin/GenericAgent.pl &gt;&gt; /dev/null
# example to execute GenericAgent.pl on 23:00 with
# Kernel::Config::GenericAgentMove job file
#0 23 * * * $HOME/bin/GenericAgent.pl -c "Kernel::Config::GenericAgentMove" &gt;&gt; /dev/null
# --
# cron/generic_agent - GenericAgent.pl cron of the OTRS
# Copyright (C) 2001-2004 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# start generic agent every 10 minutes
*/10 * * * * $HOME/bin/GenericAgent.pl -c db &gt;&gt; /dev/null
# --
# cron/pending_jobs - pending_jobs cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# check every 120 min the pending jobs
45 */2 * * * $HOME/bin/PendingJobs.pl &gt;&gt; /dev/null
# --
# cron/postmaster - postmaster cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# check daily the spool directory of OTRS
#10 0 * * * * test -e /etc/init.d/otrs &amp; /etc/init.d/otrs cleanup &gt;&gt; /dev/null; test -e /etc/rc.d/init.d/otrs &amp;&amp; /etc/rc.d/init.d/otrs cleanup &gt;&gt; /dev/null
10 0 * * * $HOME/bin/otrs.cleanup &gt;&gt; /dev/null
# --
# cron/postmaster_pop3 - postmaster_pop3 cron of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# fetch emails every 10 minutes
*/10 * * * * $HOME/bin/PostMasterPOP3.pl &gt;&gt; /dev/null
# --
# cron/rebuild_ticket_index - rebuild ticket index for OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# just every day
01 01 * * * $HOME/bin/RebuildTicketIndex.pl &gt;&gt; /dev/null

# --
# cron/session - delete old session ids of the OTRS
# Copyright (C) 2001-2004 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# delete every 120 minutes old/idle session ids
55 */2 * * * $HOME/bin/DeleteSessionIDs.pl --expired &gt;&gt; /dev/null

# --
# cron/unlock - unlock old locked ticket of the OTRS
# Copyright (C) 2002-2003 Martin Edenhofer &lt;martin+code@otrs.org&gt;
# --
# $Id: installation-and-basic-configuration.xml,v 1.17 2006/10/18 13:02:43 cs Exp $
# This software comes with ABSOLUTELY NO WARRANTY.
# --
# unlock every hour old locked tickets
35 * * * * $HOME/bin/UnlockTickets.pl --timeout &gt;&gt; /dev/null

linux:/opt/otrs/bin#
</screen>
</para>

<para>
Nach der Einrichtung der Cron-Jobs ist die Installation von OTRS
abgeschlossen, Sie können das System nun über dessen Weboberfläche weiter
an Ihre Bedürfnisse anpassen und benutzen.
</para>

</sect2>

</sect1>

</chapter>
<!-- $Id: first-steps.xml,v 1.10 2006/10/18 13:05:06 cs Exp $ --><chapter id="first-steps-in-otrs">
<title>Die ersten Schritte in OTRS</title>

<abstract>
<para>
Dieser Abschnitt soll einen ersten Überblick über die
Funktionsweise von OTRS und den Aufbau der Weboberfläche des
Systems geben. Es werden die Unterschiede zwischen Mitarbeitern
(Agents), Kunden (Customer) und Administratoren erklärt.
Anschließend wird die erste Anmeldung als OTRS-Administrator
durchgeführt und erläutert, was mit Hilfe der
Benutzereinstellungen für jeden Account innerhalb des Systems festgelegt
werden kann.
</para>
</abstract>

<sect1 id="agent-interface">
<title>Agenten Weboberfläche</title>

<para>
Die Mitarbeiter bearbeiten über die Weboberfläche des Systems
die Anfragen der Kunden, erstellen neue Tickets für andere Mitarbeiter
oder Kunden, legen Tickets über Telefongespräche mit Kunden an,
schreiben FAQ-Einträge, bearbeiten Kundendaten usw.
</para>

<para>
<screenshot>
<screeninfo>index.pl - Login Bildschirm für Agenten</screeninfo>
<graphic srccredit="index.pl - screenshot" scale="40" fileref="screenshots/login.png"/>
</screenshot>
</para>

<para>
Angenommen, Ihr Host mit der OTRS-Installation ist über die Domain

<ulink url="http://www.example.com/">
<citetitle>http://www.example.com</citetitle>
</ulink>

erreichbar, so kann der Login-Bildschirm für die Mitarbeiter und somit
auch für den OTRS-Administrator über die URL

<ulink url="http://www.example.com/otrs/index.pl">
<citetitle>http://www.example.com/otrs/index.pl</citetitle>
</ulink>

aufgerufen werden.
</para>
</sect1>

<sect1 id="customer-interface">
<title>Kunden Weboberfläche</title>

<para>
Kunden können über das speziell für sie vorhandene Webinterface von OTRS
einen eigenen Kundenaccount anlegen, die eigenen Tickets einsehen, Tickets
erstellen und bearbeiten, die Account-Einstellungen anpassen usw.
</para>

<para>
<screenshot>
<screeninfo>customer.pl - Login Bildschirm für Kunden</screeninfo>
<graphic srccredit="customer.pl - screenshot" scale="40" fileref="screenshots/customer-login.png"/>
</screenshot>
</para>

<para>
Angenommen, Ihr Host mit der OTRS-Installation ist über die Domain

<ulink url="http://www.example.com/">
<citetitle>http://www.example.com</citetitle>
</ulink>

zu erreichen, so kann der Login-Bildschirm für die Kunden über die URL

<ulink url="http://www.example.com/otrs/customer.pl">
<citetitle>http://www.example.com/otrs/customer.pl</citetitle>
</ulink>

geladen werden.
</para>
</sect1>

<sect1 id="public-interface">
<title>Public Weboberfläche</title>

<para>
Neben diesen beiden Bereichen der Weboberfläche verfügt OTRS
weiterhin über ein Interface, mit dem die FAQ des Systems
durchsucht werden kann und welches öffentlich, also ohne Anmeldung,
zugänglich ist.
</para>

<para>
<screenshot>
<screeninfo>public.pl - Öffentliche Weboberfläche</screeninfo>
<graphic srccredit="index.pl - screenshot" scale="40" fileref="screenshots/public-interface.png"/>
</screenshot>
</para>

<para>
Das öffentliche Web-Interface ist über die URL

<ulink url="http://www.example.com/otrs/faq.pl">
<citetitle>http://www.example.com/otrs/faq.pl</citetitle>
</ulink>

erreichbar. Ebenfalls ist ein Zugriff auf die FAQ über die URL

<ulink url="http://www.example.com/otrs/public.pl">
<citetitle>http://www.example.com/otrs/public.pl</citetitle>
</ulink>

möglich.
</para>
</sect1>

<sect1 id="first-login">
<title>Die erste Anmeldung am System</title>

<para>
Wie im Abschnitt über die

<link linkend="agent-interface">
Agenten Weboberfläche
</link>

beschrieben, erreichen Sie den Bildschirm für die Anmeldung
am System über die URL

<ulink url="http://www.example.com/otrs/index.pl">
<citetitle>http://www.example.com/otrs/index.pl</citetitle>.
</ulink>

</para>

<para>
<screenshot>
<screeninfo>index.pl - Login screen für OTRS-Administrator</screeninfo>
<graphic srccredit="index.pl - screenshot" scale="40" fileref="screenshots/login.png"/>
</screenshot>
</para>

<para>
Hier haben Sie die Möglichkeit, einen Benutzernamen und ein Kennwort
anzugeben. Um sich als OTRS-Administrator
anzumelden, verwenden Sie als Benutzername "root@localhost" und als
Kennwort "root".
</para>

<warning>
<para>
Diese Zugangsdaten werden bei jeder OTRS-Installation
standardmäßig vergeben. Da das Kennwort für den
OTRS-Administrator somit öffentlich bekannt ist, sollten Sie es
schnellstmöglich ändern! Sie können dies nach der Anmeldung
als OTRS-Administrator über die

<link linkend="user-preferences">
Benutzereinstellungen
</link>

vornehmen.
</para>
</warning>

<para>
Wollen Sie sich nicht als OTRS-Administrator anmelden, geben Sie einfach
den Benutzernamen und das Kennwort Ihres normalen OTRS-Accounts in
die dafür vorgesehenen Eingabefelder ein. Mit Hilfe der
Listbox unterhalb der Eingabefelder für den Benutzernamen und das
Kennwort können Sie weiterhin die Sprache auswählen, die Sie
innerhalb der Oberfläche von OTRS verwenden möchten.
</para>

<para>
Falls Sie einmal ihr Kennwort vergessen haben sollten, können Sie sich
automatisch vom System ein neues Kennwort an die Mailadresse schicken
lassen, die für Ihren OTRS-Account im System hinterlegt ist. Geben Sie
dazu im unteren Bereich des Login-Bildschirms den Benutzernamen Ihres
Accounts an und schicken Sie die Eingabe über den dafür
vorgesehenen Schalter ab. Kurze Zeit später sollte sich in Ihrem
Postfach eine Mail vom OTRS-System befinden, die das neu vergebene Kennwort
enthält.
</para>
</sect1>

<sect1 id="gui-overview">
<title>Die Benutzeroberfläche im Überblick</title>

<para>
Nachdem Sie sich erfolgreich am System angemeldet haben, wird die
Oberfläche von OTRS geladen. Sie befinden sich nach einer Anmeldung
standardmäßig in der sog. Queue-Ansicht. Die Queue-Ansicht
vermittelt einen schnellen Überblick über die Tickets in den
verschiedenen Queues. Sie werden auf neue Nachrichten hingewiesen, die
Anzahl ihrer gesperrten Tickets wird angezeigt usw.
</para>

<para>
<screenshot>
<screeninfo>Bildschirm nach erster erfolgreicher Anmeldung</screeninfo>
<graphic srccredit="First screen - screenshot" scale="40" fileref="screenshots/first-screen.png"/>
</screenshot>
</para>


<para>
Um die Übersichtlichkeit zu erhöhen, wurde die Oberfläche
von OTRS in verschiedene Bereiche aufgeteilt. Innerhalb des schwarzen
Balkens am oberen Fensterrand werden allgemeine Informationen wie die
aktuelle Uhrzeit, das Datum, Ihr Name und Ihre in den
Account-Einstellungen hinterlegte Mailadresse angezeigt. Weiterhin finden
Sie auf der linken Seite des Balkens einen Link über den die
Oberfläche neu geladen werden kann.
</para>

<para>
Im weißen Balken darunter, der sog. Navigationsleiste, werden
verschiedene Schaltflächen dargestellt, über die die Navigation im
System oder die Aktivierung bestimmter Aktionen möglich ist. Der Balken
unterteilt sich in drei Abschnitte. Der linke Bereich enthält
Schaltflächen zur Abmeldung vom System, zur Aktivierung der Queue-Ansicht,
einen Schalter, um auf das Kunden-Backend zuzugreifen oder einen Schalter zum
Laden der Maske für die Volltextsuche über die im System
gespeicherten Tickets. Über die Schalter "Phone-Ticket" und
"E-Mail-Ticket" kann ein neues Telefon- oder E-Mail-Ticket angelegt werden. Mit
Hilfe des Schalters "Statistik" wird der Bildschirm zur Ausgabe verschiedener
Systemstatistiken geladen, über "Einstellungen" gelangen Sie in den
Bereich zur Anpassung Ihrer eigenen Account-Einstellungen. "Bulk-Action"
lädt den Bildschirm für die Ausführung verschiedener Aktionen
auf markierte Tickets. Hiermit können z. B. mehrere Tickets auf einmal
geschlossen oder verschoben werden.
</para>

<para>
Im mittleren Bereich des weißen Balkens werden die Schalter zur
Navigation im System angezeigt. Nach der ersten Anmeldung als
OTRS-Administrator ist hier nur die Schaltfläche "Admin"
aufgeführt. Werden später weitere Module wie z. B. der Kalender
oder der Dateimanager installiert, tauchen die Schalter für diese
Komponenten ebenfalls in diesem Bereich auf.
</para>

<para>
An der rechten Seite des Balkens wird angezeigt, ob neue Nachrichten
für Sie vorhanden sind bzw. wie viele Tickets Sie gesperrt haben, d.h.
von wie vielen Tickets Sie der Eigentümer sind.
</para>

<para>
Im hellgrauen Balken unterhalb der Navigationsleiste werden verschiedene
Systemmeldungen angezeigt. Wenn Sie als Administrator angemeldet sind,
werden Sie z. B. darauf aufmerksam gemacht, dass normale Arbeiten nicht als
Administrator durchgeführt werden sollten. Wurde das Kalender-Modul
installiert, werden innerhalb dieses Balkens z. B. die nächsten Termine
angezeigt.
</para>

<para>
Der darunter liegende schwarze Balken enthält die gerade selektierte
Queue bzw. zeigt an, dass "Meine Queues" ausgewählt wurde. Hinter dem
Begriff "Meine Queues" verbergen sich alle Queues, die Sie für sich
als wichtig erachten und genauer überwachen möchten. Sie
können in Ihren

<link linkend="user-preferences">
Benutzereinstellungen
</link>

die Queues auswählen, die Sie in "Meine Queues" aufnehmen möchten.
</para>

<para>
Unter dem Bereich mit der gerade selektierten Queue wird ein grauer Balken
angezeigt, der einen Überblick über die im System
verfügbaren Tickets gibt. Innerhalb des nächsten Balkens wird
eine Übersicht für die verschiedenen Queues und deren Anzahl an
offenen Tickets präsentiert. Nach einer Neuinstallation ist zu
erkennen, dass in "Meine Queues" noch kein offenes Ticket vorhanden ist, in
der Queue "Raw" sich jedoch ein noch nicht gesperrtes Ticket befindet.
</para>

<para>
<screenshot>
<screeninfo>Inhalt der Raw-Queue nach der ersten Anmeldung</screeninfo>
<graphic srccredit="Raw queue - screenshot" scale="40" fileref="screenshots/raw-queue.png"/>
</screenshot>
</para>

<para>
Wenn Sie nun die Queue "Raw" auswählen, wird die Oberfläche neu
aufgebaut und der Inhalt dieser Queue angezeigt. Im unteren Bereich des
Bildschirms erscheinen nun noch die zusätzlichen Informationen für
das Ticket, welches sich in der Queue "Raw" befindet. In einem schwarzen
Balken ist die ID, also die eindeutige Ticket-Kennung, und das Alter des Tickets
zu erkennen. Auf der linken Seite dieses Balkens sehen Sie die Checkbox, mit
der das Ticket für die Bulk-Action markiert werden kann. In der
nächsten Zeile, die grau dargestellt wird, sind die Eigenschaften bzw.
die Aktionen aufgeführt, die auf das Ticket angewendet werden
können ("Sperren", "Inhalt", "History" usw.). In der gleichen Zeile
ist rechts eingerückt das Erstellungsdatum und die Erstellungszeit des
Tickets zu erkennen.
</para>

<para>
Im weiteren Verlauf teilt sich die Oberfläche in zwei Bereiche auf.
Auf der linken Seite wird in weißer Farbe eine Vorschau des
Ticketinhaltes angezeigt. Es ist zu erkennen, wer das Ticket gesendet hat, an
welche Adresse es geschickt wurde, wie der Betreff lautet und was die ersten
Zeilen beinhalten. Rechts daneben werden in grauer Farbe weitere
Informationen wie die Priorität oder der aktuelle Status des Tickets
angezeigt. Weiterhin kann eingesehen werden, ob das Ticket bereits einem
Kunden zugeordnet wurde. Über verschiedene Schaltflächen
können Sie auf das Ticket antworten, eine Anrufnotiz erstellen oder
das Ticket in eine neue Queue verschieben.
</para>

<para>
Am unteren Ende des Bildschirms erscheint innerhalb eines schwarzen
Balkens der Seitenfooter. Dieser beinhaltet ebenfalls einige Schalter zum
Aktivieren der Queue-Ansicht oder für die Erstellung eines
Telefontickets.
</para>
</sect1>

<sect1 id="what-is-a-queue">
<title>Was verbirgt sich hinter dem Begriff Queue?</title>

<para>
Da Queues in OTRS sehr wichtig sind und als Grundkonzept hinter allem
stehen und der Begriff in den letzten Abschnitten schon mehrmals verwendet
wurde, soll hier näher erklärt werden, was sich hinter dem
Begriff Queue verbirgt.
</para>

<para>
Normalerweise werden E-Mails in einer INBOX gespeichert und verwaltet. Eine
INBOX ist eine große Datei, in der alle E-Mails aneinandergereiht
werden. Neue E-Mails werden einfach an das Ende der INBOX angehängt. Das
E-Mail-Programm, welches Sie zum Lesen und Bearbeiten Ihrer Nachrichten
benutzen,  liest die INBOX-Datei aus, strukturiert den Inhalt dieser Datei
neu (wenn z. B. eine E-Mail mitten aus der INBOX-Datei gelöscht
wird) und bereitet den Inhalt für Sie als Nutzer auf.
</para>

<para>
Eine Queue in OTRS ist ein Mechanismus, mit dessen Hilfe viele
Tickets gespeichert und verwaltet werden können, also auch eine Art
INBOX. Als Anwender ist es völlig unwichtig zu wissen, wo oder
wie das Ticket gesichert ist. Wichtig ist nur, zu wissen, welcher Queue
das Ticket zugeordnet wurde. Anwender, also die sog. Agents (z. B. die
Mitarbeiter ihrer Supportabteilung), können nun Tickets zwischen
den Queues verschieben! Warum aber sollten sie das tun?
</para>

<para>
Gehen wir zur praktischeren Erklärung noch mal von Max Mustermanns
Unternehmen aus dem Abschnitt

<link linkend="basic-tts-example">
ein Beispiel für ein Trouble Ticket System
</link>

aus. Max Mustermann hat nach seinem anfänglichen Support-Chaos OTRS
installiert, und er und seine Mitarbeiter nutzen das System zur
Bearbeitung der Anfragen für die Videorekorder. Eine Queue, in die
alle Anfragen einsortiert werden, reicht in dieser Situation aus. Nach
einiger Zeit bringt Max Mustermann einen DVD-Player auf den Markt, der von
den Kunden gut angenommen wird. Doch auch zu diesem Gerät laufen
immer mehr Anfragen in das Ticket System und die Verwaltung der E-Mails
mit einer Queue wird immer unübersichtlicher. Deshalb entschließt
sich Max Mustermann nach einiger Zeit, sein Supportsystem weiter zu
optimieren. Er richtet zwei neue Queues ein, so dass er nun
insgesamt drei Queues in OTRS definiert hat. Die erste und schon
länger vorhandene Queue wird zur Eingangsqueue, in die erst mal
alle Mails wandern, umfunktioniert. Daneben gibt es jetzt noch die neuen
Queues "Videorekorder" und "DVD-Player". Herr Mustermann beauftragt
Frau Müller als sog. Dispatcherin tätig zu werden und mehrmals
am Tag die Mails in der Eingangsqueue zu sichten und sie, je nach
Inhalt, der Queue "Videorecorder" oder der Queue "DVD-Player"
zuzuordnen. Herr Meier bearbeitet ab jetzt nur noch die Anfragen in der
Videorekorder-Queue, Herr Schulze geht nur noch auf die Anfragen
innerhalb der DVD-Player-Queue ein. Beide haben auf die jeweils anderen
zwei Queues keinen Zugriff. Herr Mustermann kümmert sich weiter wie
gewohnt um alle Arten von Anfragen und darf auf alle drei Queues
zugreifen, die Möglichkeiten der Vergabe von Zugriffsrechten
innerhalb von OTRS macht es möglich.
</para>

<para>
Das Sortieren von Mails in verschiedene Queues schafft also Ordnung und
mehr Übersicht in der täglichen Mailflut, deshalb sind Queues sehr
wichtig für OTRS. Durch die Einteilung der Mitarbeiter (agents) in
verschiedene Benutzergruppen mit differenzierten
Zugriffsrechten auf die einzelnen Queues, kann die Abarbeitung der
Anfragen weiter optimiert werden. Mit Hilfe von Queues können Sie die
Struktur Ihres Unternehmens abbilden bzw. einzelne
Geschäftsvorgänge abgrenzen. So könnte Max Mustermann
neben seinem Support-Queues für die verschiedenen Geräte für
Bestellungen eine Queue mit dem Namen "Sales" anlegen und als Unter-Queues
"Anfragen", "Angebote", "Bestellungen" usw. definieren, um den
Bestellvorgang zu optimieren. Je besser und strukturierter ein Support-
system organisiert ist, desto weniger Zeit und letztlich auch finanzielle
Mittel müssen dafür aufgebracht werden. Queues und Unter-Queues
helfen bei der Strukturierung bzw. bei der Abbildung von Abläufen.
</para>
</sect1>

<sect1 id="user-preferences">
<title>Benutzereinstellungen</title>

<para>
Die Einstellungen eines Accounts lassen sich mit Hilfe der
Benutzereinstellungen den eigenen Wünschen entsprechend anpassen. Dabei
spielt keine Rolle, ob man als Mitarbeiter, Kunde oder Administrator
am System angemeldet ist. Die Benutzereinstellungen sind über den
Link "Einstellungen" sowohl innerhalb des Interfaces für Mitarbeiter
bzw. Administratoren als auch der Oberfläche für
Kunden erreichbar.
</para>

<para>
<screenshot>
<screeninfo>Persönliche Account-Einstellungen für Kunden</screeninfo>
<graphic srccredit="index.pl - screenshot" scale="40" fileref="screenshots/customer-preferences.png"/>
</screenshot>
</para>

<para>
Für Kunden-Accounts gilt, dass die Oberflächensprache, die
maximale Anzahl an angezeigten Tickets pro Seite und die Aktualisierungszeit
für das Kunden-Webinterface angepasst werden kann. Weiterhin ist es
möglich, das persönliche Kennwort zu ändern und die Anzeige
von geschlossenen Tickets an- bzw. abzuschalten.
</para>

<para>
<screenshot>
<screeninfo>Persönliche Account-Einstellungen für Agenten</screeninfo>
<graphic srccredit="index.pl - screenshot" scale="40" fileref="screenshots/agent-preferences.png"/>
</screenshot>
</para>

<para>
In den Benutzereinstellungen eines Mitarbeiters kann ebenfalls die
Oberflächensprache, das Anzeigeschema, das Standardwörterbuch
für die Rechtschreibprüfung und die Ansicht für
die Queues ausgewählt werden. Weiterhin kann eingestellt werden, in
welchem Zeitintervall die Oberfläche neu geladen werden soll, wie
viele Tickets maximal pro Seite angezeigt werden sollen und welcher
Bildschirm nach der Erstellung eines neuen Tickets automatisch geladen
wird. Sie können Ihr Kennwort ändern und festlegen, bei welchen
Ereignissen Sie vom System per Mail benachrichtigt werden möchten.
Benachrichtigungen können verschickt werden, wenn ein neues Ticket
in "Meine Queues" verfügbar ist, wenn Sie eine Nachfrage auf ein von
Ihnen gesperrtes Ticket erhalten (also wenn Sie der Eigentümer eines
solchen Tickets sind), wenn ein Ticket vom System freigegeben wurde und wenn
ein Ticket in "Meine Queues" verschoben wurde. Die Benachrichtigungsmails
werden an die Mailadresse gesendet, die bei der Erstellung Ihres Accounts
im System hinterlegt wurde.
</para>

<para>
Die Queues, die sie in "Meine Queues" aufnehmen möchten, können
Sie ebenfalls in Ihren Benutzereinstellungen auswählen. Sie sollten
in "Meine Queues" nur die Queues aufnehmen, die für Sie am wichtigsten
sind und die Sie besonders aufmerksam überwachen möchten.
</para>
</sect1>

</chapter>
<!-- $Id: adminarea.xml,v 1.17 2006/10/18 13:07:15 cs Exp $ --><chapter id="adminarea">
<title>Der Administrationsbereich von OTRS</title>

<sect1 id="adminarea-general">
<title>Allgemeines zum Administrationsbereich</title>

<para>
Der Administrationsbereich von OTRS ist die zentrale Anlaufstelle für
den Administrator des Ticket Systems. Innerhalb dieses Bereiches
können alle wichtigen Einstellungen der Systemkonfiguration
eingesehen bzw. geändert und das System auf die eigenen Bedürfnisse
angepasst werden.
</para>

<para>
Die Administrationsoberfläche kann über den Link "Admin"
innerhalb der Navigationsleiste des Agent-Interfaces geladen werden. Damit
dieser Link in der Navigationsleiste überhaupt sichtbar ist,
müssen Sie als OTRS-Administrator am System angemeldet sein bzw.
über Administrationsrechte im System verfügen. Nach einer
Standardinstallation können Sie sich mit dem Benutzernamen
"root@localhost" und dem Kennwort "root" als OTRS-Admin am System anmelden.
</para>

<warning>
<para>
Bitte ändern Sie schnellstmöglich über die

<link linkend="user-preferences">
Benutzereinstellungen
</link>

das Kennwort für root@localhost, da es sich hierbei um ein
standardmäßig vergebenes Kennwort handelt, das allgemein bekannt ist.
</para>
</warning>

<para>
<screenshot>
<screeninfo>Der Administrationsbereich von OTRS</screeninfo>
<graphic srccredit="Adminarea - screenshot" scale="40" fileref="screenshots/adminarea.png"/>
</screenshot>
</para>
</sect1>

<sect1 id="adminarea-user-groups-and-roles">
<title>Benutzer-, Gruppen- und Rollenverwaltung</title>

<sect2 id="adminarea-user">
<title>Benutzer</title>

<para>
Über den Link "Benutzer" gelangen Sie in die Benutzerverwaltung von
OTRS. Hier können Sie Benutzer anlegen, bearbeiten und deaktivieren.
Weiterhin lassen sich einige grundlegende Einstellungen für den Benutzer
festlegen, z. B. die Oberflächensprache oder das Anzeigeschema.
</para>

<para>
<screenshot>
<screeninfo>Benutzerverwaltung in OTRS</screeninfo>
<graphic srccredit="Adminarea user management - screenshot" scale="40" fileref="screenshots/admin-users.png"/>
</screenshot>
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
können einmal im System angelegte Benutzer nicht entfernt werden. Um einen
Benutzer-Account zu deaktivieren, setzen Sie in den Einstellungen den
entsprechenden Benutzer mit Hilfe der Listbox für "Gültig" auf
"ungültig" bzw. "ungültig-temporär".
</para>
</note>

<para>
Nachdem Sie einen neuen Benutzer angelegt haben, muss dieser einer Gruppe
bzw. einer Rolle zugewiesen werden. Sie werden nach dem Anlegen
eines neuen Benutzers automatisch auf die Bildschirmmaske für die
Zuweisung eines Benutzers in Gruppen weitergeleitet.
</para>

</sect2>

<sect2 id="adminarea-groups">
<title>Gruppen</title>

<para>
Jeder Mitarbeiter mit einem Account im OTRS, sollte mindestens einer
Benutzergruppe angehören. Über den Link "Gruppen" gelangen Sie in
die Gruppenverwaltung von OTRS.
</para>

<para>
<screenshot>
<screeninfo>Gruppenverwaltung in OTRS</screeninfo>
<graphic srccredit="Adminarea group management - screenshot" scale="40" fileref="screenshots/admin-groups.png"/>
</screenshot>
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
können einmal im System angelegte Gruppen nicht entfernt werden. Um
eine Gruppe zu deaktivieren, setzen Sie in den Einstellungen der
entsprechenden Gruppe in der Listbox für "Gültig" den Wert
entweder auf "ungültig" bzw. "ungültig-temporär".
</para>
</note>

<para>
Nach einer Standard-Installation sind bereits vier Gruppen im System
verfügbar.
</para>

<para>
<table id="table-of-groups-after-installation">
<title>Standardmäßig vorhandene Gruppen in OTRS</title>
  <tgroup cols="2">
    <thead>
      <row>
        <entry>
         Gruppe
        </entry>
        <entry>
          Beschreibung
        </entry>
      </row>
    </thead>
    <tbody>
      <row>
        <entry>
            admin
        </entry>
        <entry>
          Gruppe für die Benutzer mit Administrationsrechten. Nach
          einer Installation ist in dieser Gruppe nur der Benutzer
          "root@localhost".
        </entry>
      </row>
      <row>
        <entry>
          faq
        </entry>
        <entry>
          Benutzer in dieser Gruppe dürfen lesend (ro) oder schreibend
          (rw) auf das FAQ-System von OTRS zugreifen.
          Standardmäßig befindet sich nach einer Installation kein
          Benutzer in dieser Gruppe, auch nicht "root@localhost".
        </entry>
      </row>
      <row>
        <entry>
          stats
        </entry>
        <entry>
          Benutzer in dieser Gruppe dürfen lesend (ro) oder schreibend
          (rw) auf das Statistikmodul von OTRS zugreifen, d.h. sie
          können Statistiken einsehen oder auch erstellen. Nach einer
          Installation befindet sich lediglich "root@localhost" in dieser
          Gruppe.
        </entry>
      </row>
      <row>
        <entry>
          users
        </entry>
        <entry>
          Dies ist die Gruppe, in die normale Mitarbeiter aufgenommen
          und mit den kompletten Rechten ausgestattet werden sollten.
          Dadurch wird für die Mitarbeiter das normale Arbeiten im
          System ermöglicht, der Zugriff auf alle Funktionen rund um
          Tickets ist gegeben. Nach einer Installation ist diese Gruppe
          leer.
        </entry>
      </row>
    </tbody>
  </tgroup>
</table>
</para>

<para>
Um einen Benutzer einer Gruppe zuzuweisen bzw. die Gruppenmitgliedschaft
eines Benutzers zu ändern, kann der Link "Benutzer &lt;-&gt;
Gruppen" im Administrationsbereich genutzt werden.
</para>

<para>
<screenshot>
<screeninfo>Zuweisung von Benutzer und Gruppen</screeninfo>
<graphic srccredit="Adminarea groups and users - screenshot" scale="40" fileref="screenshots/admin-users-and-groups.png"/>
</screenshot>
</para>
<para>
Im unteren Bereich des Bildschirms wird eine Übersicht angezeigt, die
alle Benutzer und Gruppen auflistet. Indem Sie auf einen Benutzernamen
klicken, bekommen Sie dessen Gruppenzugehörigkeiten angezeigt und
können diese ändern. Bei der Auswahl einer Gruppe werden alle
Benutzer aufgelistet, die sich in dieser Gruppe befinden.
</para>

<para>
Um eine bessere Abstufung der Rechte im System sicher zu stellen,
können einem Benutzer verschiedene Rechte pro Gruppe zugewiesen
werden. Nach einer Standardinstallation sind in jede Gruppe die
folgenden Rechte vorhanden.
</para>

<para>
<table id="table-of-group-permissions-after-installation">
<title>Berechtigungen in den Benutzergruppen von OTRS</title>
  <tgroup cols="2">
    <thead>
      <row>
        <entry>
          Berechtigung
        </entry>
        <entry>
          Beschreibung
        </entry>
      </row>
    </thead>
    <tbody>
      <row>
        <entry>
          ro
        </entry>
        <entry>
          Nur Lesezugriff auf die Tickets bzw. Beiträge dieser Gruppe
          bzw. der Gruppe zugewiesenen Queues oder Bereiche.
        </entry>
      </row>
      <row>
        <entry>
          Verschieben in (move into)
        </entry>
        <entry>
          Recht zum Verschieben von Tickets oder Beiträgen innerhalb
          der Queues bzw. Bereiche dieser Gruppe.
        </entry>
      </row>
      <row>
        <entry>
          Erstellen (create)
        </entry>
        <entry>
          Recht zum Erstellen von Tickets oder Beiträgen in den Queues,
          bzw. Bereichen dieser Gruppe.
        </entry>
      </row>
      <row>
        <entry>
          Besitzer (owner)
        </entry>
        <entry>
          Recht zum Ändern des Eigentümers von Tickets, bzw.
          Beiträgen in den der Gruppe zugewiesenen Queues bzw. Bereiche.
        </entry>
      </row>
      <row>
        <entry>
          Priorität (priority)
        </entry>
        <entry>
          Recht zum Ändern der Priorität von Tickets, bzw.
          Beiträgen in den der Gruppe zugewiesenen Queues bzw. Bereiche.
        </entry>
      </row>
      <row>
        <entry>
          rw
        </entry>
        <entry>
          Voller Lese- und Schreibzugriff auf alle Inhalte der dieser
          Gruppe zugewiesenen Queues, bzw. Bereiche.
        </entry>
      </row>
    </tbody>
  </tgroup>
</table>
</para>

</sect2>

<sect2 id="adminarea-roles">
<title>Rollen</title>

<para>
Rollen sind ein sehr nützliches und mächtiges Feature in OTRS, um schnell
und einfach die Vergabe von Zugriffsrechten für viele Benutzer vorzunehmen.
Vor allem bei großen und komplexen Installationen mit
vielen Benutzern, Gruppen und Queues, zahlt sich dieses Feature schnell
aus und erspart dem OTRS-Administrator viel Zeit und Arbeit.
</para>

<para>
Um den Nutzen von Rollen zu verdeutlichen, stellen Sie sich die Situation
vor, dass Sie ein OTRS-System mit 100 Benutzern verwalten. 90 Benutzer
haben Zugriff auf eine Queue namens Support, die mehrere themenspezifische
Unter-Queues enthält und in der die Support-Anfragen Ihrer Kunden landen.
Die restlichen Queues des Systems sind für die 90 Supporter nicht
zugänglich, dies wurde durch Gruppenzugriffsrechte so festgelegt. Die
übrigen 10 Benutzer haben Zugriff auf alle Queues im System. Sie sortieren
falsch einsortierte Mails aus, behalten die "Raw"-Queue im Auge und
verschieben Spam-Mails in die "Junk"-Queue. Im Rahmen einer
Unternehmensumstrukturierung wird eines Tages zusätzlich eine Abteilung
eröffnet, die Produkte verkaufen soll. Es müssen Angebote,
Auftragsbestätigungen und Rechnungen  erstellt, Anfragen bearbeitet,
Bestellungen ans Lager weitergeleitet und Stornierungen entgegen genommen
werden. Ein Teil der bisherigen Mitarbeiter soll in verschiedenen
Bereichen der neuen Abteilung tätig werden und Sie als OTRS-Administrator
haben nun die Aufgabe die neuen Queues anzulegen, die erweiterten
Zugriffsrechte anzupassen und diese für die einzelnen Benutzer zu ändern.
Da es mühsam und viel zu umständlich wäre, für einen Teil aller 100
Benutzer einzeln die Zugrifssrechte zu ändern, richten Sie Rollen ein die
mit Hilfe von Gruppenberechtigungen die verschiedenen Zugriffsrechte regeln.
Anschließend ändern Sie für die entsprechenden Benutzer auf einmal die
Zugriffsberechtigungen, indem Sie diese der entsprechenden Rolle zuweisen.
Beim Anlegen neuer Benutzer müssen Sie nicht mehr einzeln die Gruppen und
Zugrifssrechte einstellen, auch hier genügt die Verknüpfung des neuen
Benutzers mit einer Rolle.
</para>

<para>
<screenshot>
<screeninfo>Rollenverwaltung in OTRS</screeninfo>
<graphic srccredit="Adminarea roles - screenshot" scale="40" fileref="screenshots/admin-roles.png"/>
</screenshot>
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
können einmal im System angelegte Rollen nicht mehr entfernt werden. Um eine
Rolle zu deaktivieren, setzen Sie in den Einstellungen die
entsprechende Rolle mit Hilfe der Listbox für "Gültig" auf
"ungültig" oder "ungültig-temporär".
</para>
</note>

<para>
<screenshot>
<screeninfo>Zuweisung von Benutzern zu Rollen</screeninfo>
<graphic srccredit="Adminarea roles users - screenshot" scale="40" fileref="screenshots/admin-roles-users.png"/>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>Zuweisung von Gruppen zu Rollen</screeninfo>
<graphic srccredit="Adminarea roles groups - screenshot" scale="40" fileref="screenshots/admin-roles-groups.png"/>
</screenshot>
</para>

<para>
Um die Zugriffsrechtevergabe einer Rolle näher zu spezifizieren, können
die Links "Rollen &lt;-&gt; Benutzer" bzw. "Rollen &lt;-&gt; Gruppen"
genutzt werden. Mit Hilfe dieser beiden Links können Sie sich eine
Übersicht über die 1:n und n:1 Beziehungen der Rolle zu den einzelnen im
System vorhandenen Benutzer oder Gruppen anzeigen lassen und diese ändern.
</para>

</sect2>

</sect1>

<sect1 id="customer-user-and-groups">
<title>Kundenbenutzer und -gruppen</title>

<sect2 id="adminarea-customeruser">
<title>Kunden Benutzer</title>

<para>
OTRS unterstützt, wie bereits erwähnt, verschiedene Arten von Benutzern.
Über den Link "Kunden Benutzer", den Sie im Admin-Bereich von OTRS
finden, können Sie die Benutzerdaten der im System angelegten Kunden
verwalten. Ein Kunde kann sich mit Hilfe seines Accounts in das vom
Ticket-System bereitgestellte Webinterface für Kunden einloggen, um dort
die eigenen Tickets einzusehen, neue Tickets zu verfassen, usw. Weiterhin
wird ein Kunden-Account vom System für die Historie von Tickets benötigt.
</para>

<para>
<screenshot>
<screeninfo>Kundenverwaltung in OTRS</screeninfo>
<graphic srccredit="Adminarea customer - screenshot" scale="40" fileref="screenshots/admin-customer.png"/>
</screenshot>
</para>

<para>
Neben der Möglichkeit in der Datenbank nach einem bestimmten Kunden zu
suchen, kann das Backend umgestellt werden, über das auf die
Kundendaten zugegriffen wird. In OTRS lassen sich mehrere Datenbanken mit
Kundendaten einbinden, genauere Informationen hierzu finden Sie im
Abschnitt

<link linkend="external-backends">
Einbinden externer Backends für Agents und Customer
</link>.
</para>

<para>
Mit Hilfe des Formulars an der rechten Bildschirmseite kann ein neuer
Kunden-Account erstellt werden. Alle Eingabefelder, die mit einem Stern (*)
markiert sind, müssen ausgefüllt werden. Neben den üblichen
Daten wie Vor- und Nachname, Mailadresse, den Einstellungen für die
Oberfläche, usw. muss ein Benutzername und ein Kennwort angegeben
werden, wodurch die Anmeldung am System ermöglicht wird. Desweiteren
ist eine Angabe für "Kunden#" erforderlich, die eine eindeutige
Kennung darstellt, über die das System den Kunden ansprechen kann bzw.
identifiziert. Für "Kunden#" kann also z. B. eine Kundennummer oder
auch die Mailadresse des Kunden eingetragen werden.
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
kann ein einmal im System angelegter Kunde nicht entfernt werden. Um
einen Kunden-Account trotzdem zu deaktivieren, setzen Sie in den
Einstellungen des entsprechenden Kunden-accounts in der Listbox
für "Gültig" den Wert entweder auf "ungültig" bzw.
"ungültig-temporär".
</para>
</note>

</sect2>

<sect2 id="adminarea-customer-user-groups">
<title>Kundengruppen</title>

<para>
Genau wie Agenten, können in OTRS auch Kundenbenutzer verschiedenen Gruppen
zugewiesen werden. Dieses Feature kann z. B. dann interessant sein, wenn Sie
mehrere Kundenbenutzer einer Firma anlegen möchten, die alle über das
Kundeninterface nur Tickets in eine oder mehrere bestimmte Queues senden
sollen. Legen Sie hierzu zuerst über die

<link linkend="adminarea-groups">
Gruppenverwaltung
</link>

die Gruppe an, in der alle Kundenbenutzer der Firma aufgenommen werden
sollen. Anschließend erstellen Sie im

<link linkend="adminarea-queue">
Verwaltungsbereich für queues
</link>

die Queues und ordnen diese der gerade angelegten Gruppe zu.
</para>

<para>
Im nächsten Schritt aktivieren Sie mit Hilfe des Konfigurationsparameters

<link linkend="Framework:Frontend::Customer:CustomerGroupSupport">
CustomerGroupSupport
</link>

die Unterstützung für Kundengruppen. Mit Hilfe des Parameters

<link linkend="Framework:Frontend::Customer:CustomerGroupAlwaysGroups">
CustomerGroupAlwaysGroups
</link>

legen Sie fest, welchen Gruppen ein neu angelegter Kundenbenutzer
automatisch zugeordnet werden soll.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von Kundengruppen</screeninfo>
<graphic srccredit="&gt;Adminarea customer groups - screenshot" scale="40" fileref="screenshots/admin-customer-groups.png"/>
</screenshot>
</para>

<para>
Über den Link "Kunden Benutzer &lt;-&gt; Gruppen" können Sie nun die
Zuordnung der Kundenbenutzer in die gewünschten Gruppen vornehmen.
Je nachdem, welche Queues zu welchen Gruppen gehören, werden später im
Webinterface für Kunden auch nur die entsprechenden Queues zur Verfügung
gestellt.
</para>

</sect2>

</sect1>


<sect1 id="adminarea-queue">
<title>Queues</title>

<para>
Über den Link "Queue" innerhalb des Admin-Bereiches von OTRS können Sie
die

<link linkend="what-is-a-queue">
Queues
</link>

Ihres Systems verwalten. Nach einer Standard-Installation sind bereits die
Queues "Junk", "Misc", "Postmaster" und "Raw" im System angelegt. "Raw"
ist die Default-Queue, in ihr landen alle neuen Tickets, so lange kein
Filter definiert wurde. "Junk" kann z. B. zum Aussortieren von Spam-Mails
genutzt werden.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung der Queues in OTRS</screeninfo>
<graphic srccredit="Adminarea queue - screenshot" scale="40" fileref="screenshots/admin-queue.png"/>
</screenshot>
</para>

<para>
Über das Formular auf der rechten Bildschirmseite kann eine neue Queue
angelegt werden. Zusätzlich zum Namen der neuen Queue kann angegeben
werden, für welche Benutzergruppe die Queue bereitgestellt werden
und ob die neue Queue eine Unter-Queue (sub queue) von einer bereits in
Ihrem System vorhandenen Queue sein soll.
</para>

<para>
Wurde ein Ticket von einem Agenten gesperrt, so können Sie mit Hilfe
des Freigabezeit-Intervalls festlegen, wann ein Ticket wieder automatisch
vom System freigegeben werden soll. So können auch die anderen
Mitarbeiter wieder auf dieses Ticket zugreifen und es bearbeiten.
</para>

<para>
Geben Sie für Eskalationszeit einen Wert an, so blockieren Tickets,
die älter als die angegebene Zeit sind, die Bearbeitung neuerer
Tickets. Diese Einstellung stellt also sicher, dass ältere Tickets ab
einem bestimmten Alter bevorzugt bearbeitet werden müssen, neuere
Tickets werden dann nicht mehr in der Queue angezeigt.
</para>

<para>
Weiterhin können Sie festlegen, dass bei einem Follow-Up auf ein Ticket
wieder der Mitarbeiter Eigentümer dieses Tickets wird, der zuletzt als
Eigentümer im System für dieses Ticket vermerkt war. Dies stellt
sicher, dass die Nachfrage eines Kunden zuerst bei demselben
Mitarbeiter landet, der sich zuletzt um dieses Ticket gekümmert
hat.
</para>

<para>
Der Parameter für die Systemadresse legt fest, mit welcher
Absenderadresse Mails aus dieser Queue versendet werden sollen. Mit Hilfe
der Parameter für Anrede und Signatur kann eingestellt werden, welche
Vorgaben hier standardmäßig bei Antworten auf Tickets in
dieser Queue genutzt werden. In den Abschnitten

<link linkend="adminarea-emailaddresses">
E-Mailadressen
</link>


<link linkend="adminarea-salutations">
Anreden
</link>

und

<link linkend="adminarea-signatures">
Signaturen
</link>

erfahren Sie mehr über die Einrichtung dieser Parameter.
</para>

<para>
Mit Hilfe der verschiedenen Kundeninfo-Parameter können Sie
schließlich festlegen, bei welchen Ereignissen ein Kunde über die
Änderungen bei einem Ticket in dieser Queue informiert werden soll.
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
kann eine einmal im System angelegte Queue nicht entfernt werden. Um
eine Queue trotzdem zu deaktivieren, setzen Sie in den Einstellungen
der entsprechenden Queue in der Listbox für "Gültig" den Wert
entweder auf "ungültig" bzw. "ungültig-temporär".
</para>
</note>

<para>
Alle gerade beschriebenen Konfigurationsmöglichkeiten für Queues,
gelten auch für Unter-Queues. Somit lassen sich mit Hilfe der
Queues in OTRS z. B. die einzelnen Abteilungen Ihres Betriebes oder die
verschiedenen Phasen eines Geschäftsvorgangs (Anfrage, Angebot,
Bestellung, usw.) abbilden. Dies sollten Sie sich bei der Strukturierung
Ihres OTRS zu Nutze machen.
</para>

</sect1>

<sect1 id="adminarea-salutations-signatures-attachments-and-answers">
<title>Anreden, Signaturen, Anlagen und Antwortvorlagen</title>

<para>
Um das Antworten auf Tickets zu beschleunigen und das Aussehen
beantworteter Tickets zu vereinheitlichen, können in OTRS
Antwortvorlagen erstellt werden. Jede Antwortvorlage kann einer oder
mehreren Queues bzw. Unter-Queues zugeordnet werden, es können mehrere
Antwortvorlagen für jede Queue definiert werden. In der Queue-Ansicht
bzw. in "Meine Queues" erscheinen die verschiedenen Antwortvorlagen als
Links unter jedem angezeigten Ticket, eine Antwort auf ein Ticket mit einer
bestimmten Vorlage kann somit schnell durchgeführt werden.
</para>

<para>
Nach einer Standardinstallation ist für jede Queue die Antwortvorlage
"empty answer" vorhanden. Im Admin-Bereich kann über den Link
"Antworten" auf die im System gespeicherten Antwortvorlagen zugegriffen und
diese bearbeitet werden.
</para>

<para>
<screenshot>
<screeninfo>Antwortvorlagen</screeninfo>
<graphic srccredit="Adminarea response - screenshot" scale="40" fileref="screenshots/admin-response.png"/>
</screenshot>
</para>

<para>
<screenshot>
<screeninfo>Zuweisung einer Antwortvorlage zu einer Queue</screeninfo>
<graphic srccredit="Adminarea response queue - screenshot" scale="40" fileref="screenshots/admin-response-queue.png"/>
</screenshot>
</para>

<para>
Um eine Antwortvorlage einer oder mehreren Queues zuzuweisen, aktivieren
Sie im Admin-Bereich den Link "Antworten &lt;-&gt; Queues". Es wird eine
Tabelle geladen, die die Queues und die einzelnen Antwortvorlagen und deren
Beziehung zueinander (1:n oder n:1) anzeigt. Hier können Sie nun die
Queue oder die Antwortvorlage auswählen, um die Zuordnung zu
bearbeiten.
</para>

<para>
Wenn Sie zum Beantworten eines Tickets, z. B. in der Queue-Ansicht, auf den
Link für eine Antwortvorlage klicken, können Sie feststellen,
dass nicht nur der Text der Antwortvorlage sondern auch eine Anrede, der
zitierte Ticketinhalt und eine Signatur geladen werden. Antwortvorlagen
setzen sich also aus verschiedenen Textbausteinen zusammen. Dies sind die
Anrede und Signatur der Queue, in der sich das zu beantwortende Ticket
befindet, der Text des Tickets auf das geantwortet werden soll und ggf. der
Text der Antwortvorlage selbst, der wie gerade beschrieben, festgelegt
werden kann. Diese Elemente sind standardmäßig so angeordnet,
dass beim Antworten zuerst die Anrede, danach der zitierte Text des zu
beantwortende Ticket, anschließend ggf. der Text der Antwortvorlage
und zum Schluss die Signatur ausgegeben wird.
</para>

<sect2 id="adminarea-salutations">
<title>Anreden</title>

<para>
Ein Textbaustein für eine Antwortvorlage ist die Anrede. Anreden
können einer Queue zugeordnet werden, wie im Abschnitt zu den

<link linkend="adminarea-queue">
Queues
</link>

beschrieben, nur so werden Sie bei Antworten für Tickets aus dieser
Queue verwendet. Über den Link "Anreden" innerhalb des Admin-Bereiches,
können Sie die verschiedenen Anreden Ihres Systems verwalten.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von Anreden</screeninfo>
<graphic srccredit="Adminarea salutation - screenshot" scale="40" fileref="screenshots/admin-salutation.png"/>
</screenshot>
</para>

<para>
Nach einer Standardinstallation von OTRS sind bereits zwei Anreden im
System gespeichert, "system standard salutation (de/buiss)" und
"system standard salutation (en)".
</para>

<para>
Damit auch dynamische Inhalte in eine Anrede eingebaut werden
können, also Inhalte, die sich bei jeder Anrede ändern, können
verschiedene Variablen in den Anredentext eingebaut werden. Der in der
Variable gespeicherte Text wird beim Antworten automatisch in den Text
eingefügt. Ein variabler Textteil könnte z.b. der Name oder
die Mailadresse der Person sein, auf deren Ticket sie antworten.
</para>

<para>
Im unteren Teil der Bildschirmmaske zum Ändern oder Anlegen einer
Anrede finden Sie die verschiedenen OTRS-Variablen, die Sie für die
dynamische Aufbereitung eines Anredentextes verwenden können. OTRS-Variablen
zeichnen sich dadurch aus, dass sie von spitzen Klammern (&lt;&gt;)
eingeschlossen sind. Zwischen den spitzen Klammern steht der Name der
Variable, der sich oft auf den in der Variable gespeicherten Inhalt
bezieht. Bauen Sie z. B. in Ihrem Anredentext die Variable
&lt;OTRS_LAST_NAME&gt; ein, so wird diese später durch den
Nachnamen der Person ersetzt, deren Ticket Sie beantworten. Sehen Sie
sich auch die schon bereits im System gespeicherten Anreden an, dann wird
die Verwendung der verschiedenen Variablen klarer.
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
kann eine einmal im System angelegte Anrede nicht entfernt werden. Um
eine Anrede trotzdem zu deaktivieren, setzen Sie in den Einstellungen
der entsprechenden Anrede in der Listbox für "Gültig" den Wert
entweder auf "ungültig" bzw. "ungültig-temporär".
</para>
</note>

</sect2>

<sect2 id="adminarea-signatures">
<title>Signaturen</title>

<para>
Ein weiterer Textbaustein für eine Antwortvorlage, ist die Signatur.
Signaturen können einer Queue zugeordnet werden, wie im Abschnitt zu
den

<link linkend="adminarea-queue">
Queues
</link>

beschrieben, nur so werden Sie bei Antworten für Tickets aus dieser
Queue verwendet. Über den Link "Signaturen" innerhalb des
Admin-Bereiches, können Sie die verschiedenen Signaturen Ihres
Systems verwalten.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von Signaturen</screeninfo>
<graphic srccredit="Adminarea signatures - screenshot" scale="40" fileref="screenshots/admin-signatures.png"/>
</screenshot>
</para>

<para>
Nach einer Standardinstallation von OTRS sind bereits zwei Signaturen im
System gespeichert, "system standard signature (de/buiss)" und
"system standard signature (en)".
</para>

<para>
Auch in Signaturen können dynamische Inhalte eingebaut werden.
Dies geschieht, genauso wie bei den Anreden, mit Hilfe verschiedener
OTRS-Variablen, die in den Text der Signatur integriert werden können.
Ein variabler Textteil könnte z.b. der Name des
Mitarbeiters sein, der das Ticket beantwortet hat.
</para>

<para>
Im unteren Teil der Bildschirmmaske zum Ändern oder Anlegen einer
Signatur finden Sie die verschiedenen OTRS-Variablen, die Sie für die
dynamische Aufbereitung eines Signaturentextes verwenden können.
OTRS-Variablen zeichnen sich dadurch aus, dass sie von spitzen Klammern
(&lt;&gt;) eingeschlossen sind. Zwischen den spitzen Klammern steht der
Name der Variable, der sich oft auf den in der Variable gespeicherten
Inhalt bezieht. Bauen Sie z. B. in Ihrem Anredentext die OTRS-Variable
&lt;OTRS_LAST_NAME&gt; ein, so wird diese später durch den
Nachnamen des Agents ersetzt, der das Ticket beantwortet hat. Sehen Sie
sich auch die schon bereits im System gespeicherten Anreden an, dann wird
die Verwendung der verschiedenen Variablen klarer.
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
kann eine einmal im System angelegte Signatur nicht entfernt werden. Um
eine Signatur trotzdem zu deaktivieren, setzen Sie in den Einstellungen
der entsprechenden Signatur in der Listbox für "Gültig" den Wert
entweder auf "ungültig" oder auf "ungültig-temporär".
</para>
</note>

</sect2>

<sect2 id="adminarea-attachments">
<title>Anlagen</title>

<para>
Ein weitere optionaler Teil einer Antwortvorlage kann eine Anlage sein.
Diese wird bei der Benutzung einer Antwortvorlage als Anhang an das zu
beantwortende Ticket angehängt, kann aber über eine Checkbox im
Antworten-Bildschirm für Tickets leicht deaktiviert werden.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von Anlagen für Antwortvorlagen</screeninfo>
<graphic srccredit="Adminarea attachment - screenshot" scale="40" fileref="screenshots/admin-attachment.png"/>
</screenshot>
</para>

<para>
Über den "Anlagen"-Link im Admin-Bereich können Sie neue Anlagen in das
System integrieren. Nachdem eine Anlage im System gespeichert wurde, kann
sie noch einer oder mehreren Antwortvorlagen zugeordnet werden. Die
Zuordnung der Anlagen zu den einzelnen Antwortvorlagen kann über
den Link "Anlagen &lt;-&gt; Antworten" im Admin-Bereich von OTRS erreicht
werden.
</para>

<para>
<screenshot>
<screeninfo>Zuweisung einer Anlage zu einer Antwortvorlage</screeninfo>
<graphic srccredit="Adminarea attachment response - screenshot" scale="40" fileref="screenshots/admin-attachment-response.png"/>
</screenshot>
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
kann eine einmal im System gespeicherte Anlage nicht mehr entfernt werden.
Um eine Anlage trotzdem systemweit zu deaktivieren, setzen Sie in den
Einstellungen der entsprechenden Anlager in der Listbox für "Gültig" den Wert
entweder auf "ungültig" oder "ungültig-temporär".
</para>
</note>

</sect2>

</sect1>

<sect1 id="adminarea-auto-responses">
<title>Automatische Antworten</title>

<para>
OTRS bietet die Möglichkeit, automatische Antworten an Kundenbenutzer zu
verschicken. Automatische Antworten sind an bestimmte Ereignisse im System
gebunden, z. B. an das Anlegen eines neuen Tickets in einer Queue, wenn ein
Followup eines Tickets stattfindet, wenn ein Ticket geschlossen oder
vom System zurückgewiesen wird. Über den Link "Auto Antworten" innerhalb
des Admin-Bereiches erreichen Sie die Verwaltung der automatischen
Antworten. Im Formular zum Ändern oder Anlegen einer automatischen
Antwort stellen Sie über die Listbox für "Typ" das Ereignis ein, das
mit der automatischen Antwort verknüpft werden soll. Nach einer
Standardinstallation sind folgende Ereignistypen vorhanden.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von automatischen Antworten</screeninfo>
<graphic srccredit="Adminarea auto response - screenshot" scale="40" fileref="screenshots/admin-autoresponse.png"/>
</screenshot>
</para>

<table id="table-of-autoanswer-types">
<title>Ereignistypen für automatische Antworten</title>
  <tgroup cols="2">
    <thead>
      <row>
        <entry>
          Name
        </entry>
        <entry>
          Beschreibung
        </entry>
      </row>
    </thead>
    <tbody>
      <row>
        <entry>
          auto reply
        </entry>
        <entry>
          Dieses Ereignis tritt ein, wenn ein neues Ticket in
          einer Queue angelegt wird.
        </entry>
      </row>
      <row>
        <entry>
          auto reply/new ticket
        </entry>
        <entry>
          Dieses Ereignis tritt ein, wenn ein bereits geschlossenes Ticket,
          z. B. durch die Antwort eines Kunden, mit einer neuen
          Ticketnummer erneut geöffnet wird.
        </entry>
      </row>
      <row>
        <entry>
          auto follow up
        </entry>
        <entry>
          Dieses Ereignis tritt ein, wenn ein Follow up für ein bereits
          vorhandenes Ticket eintrifft.
        </entry>
      </row>
      <row>
        <entry>
          auto reject
        </entry>
        <entry>
          Dieses Ereignis tritt ein, wenn ein Ticket vom System
          zurückgewiesen wird.
        </entry>
      </row>
      <row>
        <entry>
          auto remove
        </entry>
        <entry>
          Dieses Ereignis tritt ein, wenn ein Ticket entfernt wird.
        </entry>
      </row>
    </tbody>
  </tgroup>
</table>

<para>
Für die Betreffzeile und den Text von automatischen Antworten kann genauso
wie bei Signaturen oder Anreden, der Inhalt mit Hilfe von OTRS-Variablen
dynamisch erzeugt werden. So werden über die Variable
&lt;OTRS_CUSTOMER_EMAIL[5]&gt; die ersten 5 Zeilen der an das System
gesendeten E-Mail in die automatische Antwort eingefügt, oder durch
&lt;OTRS_CUSTOMER_FROM&gt; die From-Zeile. Die Anmerkungen im unterem
Bereich der Bildschirmmaske zur Verwaltung der automatischen Antworten
listen alle OTRS-Variablen auf, die verwendet werden können.
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
kann eine einmal im System angelegte Auto-Antwort nicht entfernt werden.
Um eine Auto-Antwort trotzdem systemweit zu deaktivieren, setzen Sie in den
Einstellungen der entsprechenden Auto-Antwort in der Listbox für
"Gültig" den Wert entweder auf "ungültig" oder "ungültig-temporär".
</para>
</note>

<para>
<screenshot>
<screeninfo>Zuweisung einer automatischen Antwort zu einer Queue</screeninfo>
<graphic srccredit="Adminarea auto response queue - screenshot" scale="40" fileref="screenshots/admin-autoresponse-queue.png"/>
</screenshot>
</para>

<para>
Um eine automatische Antwort einer oder mehreren Queues zuzuweisen, folgen
Sie im Admin-Bereich den Link "Auto Antworten &lt;-&gt; Queues". Dort sind
für jede Queue die verschiedenen Ereignistypen aufgelistet und es kann eine
Zuordnung einer Auto-Antwort vom gleichen Ereignistyp durchgeführt bzw.
entfernt werden.
</para>

</sect1>

<sect1 id="adminarea-emailaddresses">
<title>E-Mailadressen</title>

<para>
Um aus OTRS heraus E-Mails verschicken zu können, benötigen Sie
mindestens eine gültige Mailadresse. Da in vielen Fällen eine
Mailadresse nicht ausreicht, ist OTRS auch in der Lage, mit mehreren
Mailadressen zu arbeiten. Für jede Queue kann mindestens eine Mailadresse
festgelegt werden, es ist aber auch möglich eine Adresse mehreren Queues
zuzuordnen. D.h., dass von außen eine Queue über mehrere Mailadressen
ereicht werden kann, für das Versenden von Nachrichten aus einer Queue muss
jedoch eine Adresse festgelegt werden. Beim

<link linkend="adminarea-queue">
Anlegen oder Bearbeiten einer Queue
</link>

stellen Sie ein, welche im System gespeicherte Mailadresse für die
ausgehenden Nachrichten der entsprechenden Queue benutzt werden soll.
Die Verwaltung der Mailadressen des Systems erreichen Sie, indem sie im
Admin-Bereich dem Link "E-Mail Adressen" folgen.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von Mailadressen</screeninfo>
<graphic srccredit="Adminarea email - screenshot" scale="40" fileref="screenshots/admin-email.png"/>
</screenshot>
</para>

<para>
Im Formular zur Verwaltung der E-Mailadressen können Sie u.a. direkt
auswählen, mit welcher Queue oder Unter-Queue die neue Mailadresse
verknüpft werden soll. Diese Verknüpfung ist wichtig, da so eingehende
Mails anhand der Adresse im To: Feld der entsprechenden Queue zugewiesen
werden können.
</para>

<note>
<para>
Um die Konsistenz der von OTRS verwalteten Daten sicher zu stellen,
kann eine einmal im System angelegte Mailadresse nicht entfernt werden.
Um eine Mailadresse trotzdem systemweit zu deaktivieren, setzen Sie in den
Einstellungen der entsprechenden Mailadresse in der Listbox für
"Gültig" den Wert entweder auf "ungültig" oder
"ungültig-temporär".
</para>
</note>

</sect1>

<sect1 id="adminarea-notifications">
<title>Benachrichtigungen</title>

<para>
Kunden und Mitarbeiter können im

<link linkend="user-preferences">
Einstellungs-Bereich
</link>

ihres Accounts festlegen, bei welchen Ereignissen Sie automatisch vom
System per Mail benachrichtigt werden wollen.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von Benachrichtigungen</screeninfo>
<graphic srccredit="Adminarea notifications - screenshot" scale="40" fileref="screenshots/admin-notification.png"/>
</screenshot>
</para>

<para>
Über den "Benachrichtigungen"-Link im Admin-Bereich erreichen Sie die
Verwaltung der Benachrichtigungen. Sie können die Betreffzeile
und den Text einer Benachrichtigung anpassen, indem Sie die entsprechende
Benachrichtigung aus der Listbox auswählen und deren Einstellung über den
"Ändern"-Schalter laden. Am Namen einer Benachrichtigung erkennen Sie, bei
welcher Oberflächensprache die Benachrichtigung verwendet wird, für welches
Ereignis die Benachrichtigung steht und ob sie für einen Kunden oder
Agenten bestimmt ist.
</para>

<para>
Auch innerhalb der Benachrichtigungen können die Textinhalte mit Hilfe der
OTRS-Variablen dynamisch aufbereitet werden. Innerhalb der Anmerkungen im
unteren Bereich der Bildschirmmaske zur Benachrichtigungen-Verwaltung
werden die verschiedenen zur Verfügung stehenden Variablen und deren
Verwendung aufgelistet und näher erklärt.
</para>

</sect1>

<sect1 id="adminarea-smime">
<title>SMIME</title>

<para>
Mit OTRS ist es möglich, Tickets mit Hilfe von SMIME zu ent- und
verschlüsseln bzw. Tickets zu signieren. Bevor SMIME allerdings
systemweit genutzt werden kann, muss das Feature mit Hilfe einiger

<link linkend="Framework:Crypt::SMIME">
Konfigurationsparameter
</link>

z. B. über die

<link linkend="adminarea-sysconfig">
grafische Administrationsoberfläche
</link>

des Systems aktiviert und konfiguriert werden
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von SMIME-Zertifikaten</screeninfo>
<graphic srccredit="Adminarea smime - screenshot" scale="40" fileref="screenshots/admin-smime.png"/>
</screenshot>
</para>

<para>
Über den "SMIME"-Link im Admin-Bereich von OTRS erreichen Sie die
Verwaltung der SMIME-Zertifikate. Es können Zertifikate und private
Fingerprints hinzugefügt und entfernt werden und eine Suche in den
Zertifikaten ist möglich.
</para>

</sect1>

<sect1 id="adminarea-pgp">
<title>PGP</title>

<para>
Mit OTRS ist es möglich, Tickets mit Hilfe von PGP zu ent- und
verschlüsseln bzw. zu signieren. Bevor PGP allerdings systemweit genutzt
werden kann, muss das Feature mit Hilfe einiger

<link linkend="Framework:Crypt::PGP">
Konfigurationsparameter
</link>

z. B. über die

<link linkend="adminarea-sysconfig">
grafische Administrationsoberfläche
</link>

des Systems aktiviert und konfiguriert werden
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von PGP-Schlüsseln</screeninfo>
<graphic srccredit="Adminarea pgp -  screenshot" scale="40" fileref="screenshots/admin-pgp.png"/>
</screenshot>
</para>

<para>
Über den "PGP"-Link im Admin-Bereich von OTRS erreichen Sie die
Verwaltung des Schlüsselrings Ihres Systems. Es können Schlüssel und
Signaturen hinzugefügt und entfernt werden und eine Suche innerhalb des
Schlüsselrings ist möglich. Das Kapitel

<link linkend="configure-pgp">
Verschlüsselung mit PGP
</link>

beschreibt die einrichtung und Verwendung detaillierter.
</para>

</sect1>

<sect1 id="adminarea-status">
<title>Status</title>

<para>
Über den Link "Status" können Sie die Status, die Sie in OTRS verwenden
möchten, bearbbeiten.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung der Status</screeninfo>
<graphic srccredit="Adminarea states - screenshot" scale="40" fileref="screenshots/admin-status.png"/>
</screenshot>
</para>

<para>
Nach einer Standardinstallation sind die Status "closed successful",
"closed unsuccessful", "merged", "new", "open", "pending auto close+",
"pending auto close-" "pending reminder" und "removed" vorhanden. Jeder
Status ist einem Status-Typ zugeordnet, der auch beim Anlegen eines neuen
Status vergeben werden muss. Es gibt standardmäßig die Status-Typen
"geschlossen", "merged", "neu", "offen", "pending auto", "warten zur
Erinnerung" und "entfernt".
</para>
</sect1>

<sect1 id="adminarea-sysconfig">
<title>Die Admin GUI (SysConfig)</title>

<para>
Seit OTRS 2.0 kann das System nahezu vollständig über das Webinterface
konfiguriert werden und manuelle Anpassungen der Konfigurationsdateien
gehören der Vergangenheit an. MÖglich wird dies durch das grafische
Administrations-Frontend.
</para>

<para>
<screenshot>
<screeninfo>Das grafische Konfigurations-Frontend von OTRS</screeninfo>
<graphic srccredit="Adminarea sysconfig - screenshot" scale="40" fileref="screenshots/admin-sysconfig.png"/>
</screenshot>
</para>

<para>
Über den "SysConfig"-Link im Admin-Bereich von OTRS erreichen sie die
grafische Administrationsoberfläche. Über diese können Sie eigene
Konfigurationsdateien in das System integrieren bzw. Ihre
persönlichen Änderungen an der Standardkonfiguration in eine Datei
sichern. Nahezu alle Konfigurationsparameter des OTRS Frameworks und der
zusätzlich installierten Module können eingesehen und geändert werden, die
Navigation durch die Vielzahl der Konfigurationsparameter wurde durch die
Einteilung in Module und Gruppen übersichtlich aufgeteilt. Weiterhin ist es
möglich, eine Suche über alle Konfigurationsparameter hinweg
durchzuführen, so dass einzelne Parameter schnell aufgefunden und
bearbeitet werden können.
</para>

<para>
Das Kapitel

<link linkend="sysconfig">
Nähere Beschreibung der grafischen Administrationsoberfläche
</link>

geht ausführlicher auf das grafische Konfigurations-Frontend ein.
</para>

</sect1>

<sect1 id="adminarea-postmasterpop3-account">
<title>Einrichten von POP3-Konten</title>

<para>
Es gibt mehrere Möglichkeiten, Mails in OTRS einzuspeisen. Neben
der Nutzung des PostMaster.pl-Skripts, welches die Mails direkt in das
System piped, können auch POP3-Konten abgefragt werden, an die Mails
für Ihr Ticket-System gehen. Über den Link "PostMaster POP3
Account" innerhalb des Admin-Bereiches erreichen Sie die Verwaltung der
POP3-Konten, die OTRS automatisch auf neue Nachrichten überprüfen
soll.
</para>

<para>
<screenshot>
<screeninfo>Verwaltung von POP3 Konten</screeninfo>
<graphic srccredit="Adminarea postmasterpop3 - screenshot" scale="40" fileref="screenshots/admin-postmasterpop3.png"/>
</screenshot>
</para>

<para>
Im Kapitel über die

<link linkend="email-receiving-pop3">
Mailkonfiguration
</link>

für OTRS wird die Einrichtung der POP3-Konten näher erläutert.
</para>

</sect1>

<sect1 id="adminarea-postmasterfilter">
<title>Einrichten von Filterregeln</title>

<para>
Damit Sie automatisch Mails vorsortieren können bzw. ungewünschte Mails gar
nicht in die Queues des Ticket-Systems gelangen, können Filterregeln für
eingehende Nachrichten festgelegt werden. Dabei spielt es keine Rolle, ob die
Mails über POP3-Konten oder mit Hilfe des
<filename>PostMaster.pl</filename> Skriptes ins System gelangen. Der Link
"PostMaster Filter" innerhal