<?xml version="1.0" encoding="iso-8859-1"?>
<chapter id="setup_setup">
  <title>Der Installationsvorgang</title>
  
  <para>Nachdem Sie die notwendigen Einstellungen am Server erfolgreich abgeschlossen
    haben und moregroupware entpackt haben, können Sie nun mit der webbasierenden
    Installationsprozedur beginnen. Diese ist detailliert im nächsten Abschnitt
    beschrieben. Nach Abschluss der Installationsprozedur kehren Sie wieder zu den
    betriebssytemszpezifischen Anweisungen zurück, um nichts zu übersehen.
    Lesen Sie danach im Abschnitt <link linkend="setup_security">
    Absichern von moregroupware</link> weiter!
  </para>
  
  <para>Öffnen Sie in Ihrem Browser die Seite
    <ulink href="http://localhost/moregroupware/index.php">
    http://localhost/moregroupware/index.php</ulink> (oder
    <literal>http://ihredomain.at/moregroupware/index.php</literal>
    wenn Sie über ein Netzwerk arbeiten).
</para>

<para>Wenn Sie die Installationsprozedur bis jetzt noch nicht
  aufgerufen haben, bekommen Sie eine Fehlermeldung:
  <figure>
    <title>Fehlermeldung nach dem Entpacken</title>
    <graphic fileref="images/setup/setup_step0.png"/>
  </figure>
</para>

<para>Durch einen Klick auf "run setup" starten Sie die Installationsprozedur.
  Wenn Sie nebenbei einen Blick ins Handbuch werfen wollen, klicken
  Sie auf "look at the manual". Mit einem Klick auf "run setup" kommen
  Sie auf folgende Seite:
  <figure>
    <title>Auswahl der Sprache</title>
    <graphic fileref="images/setup/setup_step1.png"/>
  </figure>
</para>

<para>Wählen Sie die Sprache, in der Sie die Installation durchführen wollen.
  Diese Sprache ist später die voreingestellte Sprache. Nach einer Änderung
  müssen Sie mit "refresh" die Seite neu laden, um die Sprache umzustellen.
  Folgen Sie nun den Anweisungen der Installationsprozedur, zu auftretenden
  Fehlern sollten Sie weiterführende Information erhalten. Wenn Sie über
  diese Fehler durch ein Popup informiert werden wollen, wählen Sie im mit "Use
  Javascript for errors" beschrifteten Listenfeld "Yes" aus.
</para>

<para>Gehen Sie nun weiter zu Schritt 2:
  <figure>
    <title>Systemüberprüfung</title>
    <graphic fileref="images/setup/setup_step2.png"/>
  </figure>
</para>

<para>Hoffentlich ist Ihr Computer richtig konfiguriert und übersteht die
  Systemüberprüfung. Wenn nicht, gehen Sie die letzten Kapitel bevor Sie
  die Installationsroutine nochmals aufrufen, Klicken Sie auf weiter, wenn alles
  in Ordnung ist.
</para>

<para>Nun ist es an der Zeit, moregroupware einzurichten:
  <figure>
    <title>Einstellungen</title>
    <graphic fileref="images/setup/setup_step3.png"/>
  </figure>
</para>

<para>
  Die hier zu tätigenden Einstellungen haben folgende Bedeutung:
  
  <variablelist>
    <varlistentry>
      <term>Datenbanksoftware</term>
      <listitem>
        <para>Dies ist der verwendete Datenbankserver. Derzeit werden nur MySQL und
          PostgreSQL unterstützt. Weitere Systeme werden in Zukunft unterstützt.
          Wählen Sie den Server aus, den Sie verwenden.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Datenbank-Hostname / IP</term>
      <listitem>
        <para>Der Computername oder die IP Adresse auf der der Datenbankserver
        läuft. Wenn es derselbe Computer ist, verwenden Sie am besten "localhost".
        Andererseits geben Sie die IP Adresse des Datenbankserver ein, dies ist
        performanter als der Servername, denn dieser braucht nicht erst zur
        entsprechenden IP Adresse aufgelöst werden. 
        </para>
        <para>Im Fall von PostgreSQL ist nur der Benutzername und das Passwort
          notwendig. Sie können das Feld auch leer belassen.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Datenbank-User</term>
      <listitem>
        <para>Hier geben Sie den Datenbankbenutzer ein, den Sie in den vorigen
        Kapiteln erstellt haben (oder der für Sie erstellt worden ist).
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Datenbank-Passwort</term>
      <listitem>
        <para>Das für den Datenbankbenutzer festgelegte Passwort.</para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Name der Datenbank</term>
      <listitem>
        <para>Den Namen der (leeren) Datenbank, die Sie für moregroupware erstellt
          haben.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Versuche Datenbank anzulegen</term>
      <listitem>
        <para>Wenn Sie die Datenbank, die Sie benutzen wollen, nocht nicht erstellt haben,
          kann dies die Installationsroutine f&uuml;r Sie erledigen. Aktivieren Sie diese
          Option, erscheinen zwei weitere Formularfelder f&uuml;r einen Benutzernamen
          und das dazugeh&ouml;rige Passwort, welcher die Berechtigung besitzt, Datenbanken anzulegen.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>URL der moregroupware-Installation</term>
      <listitem>
        <para>Der Pfad zum moregroupware Verzeichnis. Dieser ist in den meisten
          Fällen bereits richtig voreingestellt. Überprüfen Sie ihn dennoch,
          um sicher zu gehen.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>URL-Prüfung auslassen</term>
      <listitem>
        <para>Wenn sich die Installationsprozedur über eine falsche Adresse
          beschwert, können Sie die Überprüfung weglassen.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>dynamische URL-Erkennung nutzen</term>
      <listitem>
        <para>Wenn der Server über verschiedene Computernamen angesprochen
         werden kann (zum Beispiel im lokalen Netzwerk und über das Internet),
         müssen Sie diese Option aktivieren. Dadurch wird der Servername,
         der vom Browser übergeben wird anstelle des festeingestellten Servernamens
         verwendet. Diese Option setzt als Verbindungsprotokoll HTTP 1.1 voraus,
         das aber heutzutage schon Standard ist.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>SSL-Nutzung erzwingen</term>
      <listitem>
        <para>Aktivieren Sie diese Option, damit more.groupware automatisch
          eine verschl&uuml;sselte Verbindung erstellt, wenn eine unverschl&uuml;sselte
          Verbindung benutzt wird.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Session-Name</term>
      <listitem>
        <para>Diese Option legt den Namen der Session fest, die verwendet wird. Als Standard verwendet
          PHP den Namen PHPSESSION. Wir haben uns zur Unterscheidung f&uuml;r einen eigenen Namen entschieden,
          Sie k&ouml;nnen ihn &ouml;&auml;ndern, wenn Sie m&ouml;chten.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Session in Datenbank speichern</term>
      <listitem>
        <para>Normalerweise werden die Session-Daten in Dateien gespeichert. Wählen Sie diese Option, um die Daten in der Datenbank abzulegen.</para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Systempfad zur moregroupware-Installation</term>
      <listitem>
        <para>Dies ist das Verzeichnis, in das Sie moregroupware entpackt haben.
          Der angezeigte Pfad sollte an sich richtig sein, überprüfen Sie ihn aber
          um sicher zu gehen.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Authentifizierungsmethode</term>
      <listitem>
        <para>Sie können moregroupware über LDAP, MySQL oder NTLM/htaccess
          authentifizieren lassen.
        </para>
        <para>Die Authentifizierung über die Datenbank ist die am häufigsten
          verwendete Methode. Wenn Sie bereits die Benutzerdatenbank in einem
          Verzeichnisdienst (LDAP oder Active Directory) haben, können Sie
          diese weiterhin verwenden. In einem auf Windows basierendem Netzwerk
          kann NTLM als Authentifizierung ganz brauchbar sein.
        </para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Passwörter nicht mit JavaScript-MD5 verschlüsseln</term>
      <listitem>
        <para>Die benutzten Passwörter können mit dem MD5 Algorithmus mittels
          JavaScript auf dem Klienten verschlüsselt werden, um zu verhindern,
          dass Passwörter im Klartext übertragen werden. Diese Option ist automatisch
          deaktiviert, wenn JavaScript deaktiviert ist, aber Sie können es auch
          komplett deaktivieren.
        </para>
        <important>
          <para>Für eine akzeptable Sicherung verwenden Sie am besten SSL. Wenn
            ein mit MD5 verschlüsseltes Passwort in falsche Hände gelangt, kann
            es nach der Entschlüsselung genauso einfach wie ein Klartextpasswort
            verwendet werden!</para>
          </important>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Admin Passwort</term>
      <listitem>
        <para>Geben Sie das Passwort für den admin-User ein, der angelegt wird.
          Zur &Uuml;berpr&uuml;fung wird dieses doppelt abgefragt.
        </para>
      </listitem>
    </varlistentry>
    
  </variablelist>
</para>

<para>Klicken Sie auf weiter um zum nächsten Schritt zu kommen:
  <figure>
    <title>Authentifizierungseinstellungen für SQL/NTLM</title>
    <graphic fileref="images/setup/setup_step4_sql.png"/>
  </figure>
</para>
<para>Für diese zwei Authentifizierungsmethoden gibt eis keine weiteren Einstellung.
</para>

<para>Wenn Sie LDAP benutzen wollen, müssen Sie noch folgende Einstellungen tätigen:
  <figure>
    <title>Authentifizierung über LDAP</title>
    <graphic fileref="images/setup/setup_step4_ldap.png"/>
  </figure>
</para>

<para><variablelist>
    <varlistentry>
      <term>Verzeichnisdienst</term>
      <listitem>
        <para>Wählen Sie den Verzeichnisdienst, entweder OpenLDAP
        oder Active Directory.</para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>LDAP Host</term>
      <listitem>
        <para>IP Adresse oder Hostnamen des Verzeichnisservers.</para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>LDAP Base</term>
      <listitem>
        <para></para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>LDAP Userid</term>
      <listitem>
        <para>Der Benutzer, mit dem Sie auf den Server zugreifen wollen.</para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>LDAP root Passwort</term>
      <listitem>
        <para>Und das dazugehörige Passwort.</para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>LDAP Suffix</term>
      <listitem>
        <para></para>
      </listitem>
    </varlistentry>
    
    <varlistentry>
      <term>Accounts bei Login anlegen</term>
      <listitem>
        <para>moregroupware kann für Benutzer, die über den Verzeichnisdienst
          authentifiziert werden, automatisch einen Zugang einrichten. Wählen Sie
          dazu "Yes". Wenn Sie sich dagegen "No" entscheiden, müssen Sie diese
          Zugänge manuell einrichten.
        </para>
      </listitem>
    </varlistentry>
  </variablelist>
</para>

<para>Nachdem Sie die gewünschten Eingaben getätigt haben, klicken Sie auf weiter,
  um zum letzten Schritt der Installationsprozedur zu gelangen.
  <figure>
    <title>Modulinstallation</title>
    <graphic fileref="images/setup/setup_step5.png"/>
  </figure>
</para>

<para>Mit weiter erfahren Sie den Status der Installation.
  <figure>
    <title>Ergebnis der Installation</title>
    <graphic fileref="images/setup/setup_step6.png"/>
  </figure>
</para>
<para>Hoffentlich bekommen Sie nun die Meldung, dass die Installation erfolgreich
  abgeschlossen wurde. Wenn nicht, können Sie in Log der Installation erfahren,
  warum die Installation fehlgeschlagen ist. Versuchen Sie die Probleme zu beheben
  und starten Sie die Installationsprozedur neu.
</para>


<para>Nun können Sie sich zum ersten Mal an moregroupware anmelden. Öffnen Sie mit
  Ihrem Browser die Seite <ulink href="http://localhost/moregroupware/index.php">
  http://localhost/moregroupware/index.php</ulink> (<ulink href="http://localhost/moregroupware/index_ntlm.php">
  http://localhost/moregroupware/index_ntlm.php</ulink> für NTLM-Anmeldung) und melden Sie sich mit dem
  Benutzernamen "admin" und gewählten Passwort an.
</para>

</chapter>