<?xml version="1.0" encoding="iso-8859-1"?>
<chapter id="administration_users">
  <title>Benutzeradministration</title>
  
  <para>Dieses Kapitel soll Ihnen bei der Administration Ihrer
    moregroupware Installation helfen und erklärt Ihnen die
    Werkzeuge, die Sie als Administrator zur Verfügung haben.
  </para>
  
  <section id="administration_users_create_batch">
    
    <title>Erstellen neuer Benutzer aus einer Datei</title>
    
    <para>
      Erstellen Sie eine CSV Datei (z.B. <filename>benutzer.csv</filename>)
      mit Ihrem Lieblingseditor nach der folgenden Struktur:
    </para>
    
    <programlisting>
    "Benutzername","Nachname","Vorname","Aufgabe","Arbeitsplatz","Geburtstag","Geschlecht","Mobil","Telefon","Email","Passwort"
    </programlisting>
    
    <para>
      Erstellen Sie für jeden Benutzer eine eigene Zeile mit einem Zeilenwechsel.
      Verwenden Sie Microsoft Word oder eine andere Textverarbeitung, so stellen
      Sie sicher, dass die Datei als reine Textdatei "Nur Text" abgespeichert wird.
      Achten Sie auf die Anf&uuml;hrungszeichen.
      Benutzernamen d&uuml;rfen nur alphanumerische Zeichen enthalten (A-Z, a-z, 0-9).
    </para>
    
    <para>
      Öffnen Sie moregroupware als Administrator und gehen Sie in den
      Benutzermanager. Wählen Sie zum Importieren den Link "Neuen Benutzer
      erstellen (aus Datei)".
    </para>
    
    <para>
      Sie sehen nun ein Formular mit drei Eingabefeldern. Wählen Sie die entsprechende
      Datei aus. Zusätzlich können Sie die Sprache und Benutzergruppe für die neu
      anzulegenden Benutzer festlegen. Mit einem Klick auf "Erstellen" starten Sie
      den Import.
    </para>
    
  </section>
  
</chapter>

<chapter id="administration_complaints">
  <title>Allgemeine Beschwerden von Benutzern</title>
  
  <para>In diesem Kapitel finden Sie Lösungen zu öfters vorkommenden
    Beschwerden von Benutzern, die im alltäglichen Gebrauch lästig sind.
  </para>
  
  <section id="administration_complaints_session_timeout">
    <title>Session timeout</title>
    
    <para>
      Wenn Sie Ihren Computer eine Weile unbenutzt lassen und an moregroupware
      angemeldet sind, können Sie "die Verbindung" verlieren und Sie müssen sich
      erneut anmelden. Dieses Problem tritt auf, wenn die Session zu alt wird.
      Um dieses Problem zu beheben, editieren Sie in der <filename>php.ini</filename>
      folgende Stelle:
    </para>
    
    <programlisting>
      session.gc_maxlifetime = 1440
    </programlisting>
    
    <para>
      Die Voreinstellung beträgt 1440 Sekunden, danach werden die Daten der Session
      automatisch gelöscht.
    </para>
    
    <para>
      Wenn Sie den Wert ändern, speichern Sie die Änderungen und starten den
      Webserver neu. Das Problem sollte gelöst oder zumindest minimiert werden.
    </para>
    
    <note>
      <para>
        Der Nachteil dieser Einstellung: Die längere Session bleibt länger
        erhalten, es besteht die Gefahr eines "Einbruchs".
        Wenn Sie den Computer eine längere Zeit unbeaufsichtigt lassen und
        jemand nimmt Änderungen unter Ihrer Benutzerkennung vor, könnte das
        Probleme mit sich ziehen. Vergessen Sie die die Nachteile nicht,
        wenn Sie diese Einstellung ändern (oder erziehen Sie Ihre Benutzer,
        dass Sie sich abmelden, wenn Sie eine längere Pause machen).
        </para>
    </note>
    
  </section>
  
</chapter>

<chapter id="administration_backup">
  <title>Sichern Ihrer moregroupware Daten</title>
  
  <para>
    Backups sind notwendig. Speziell, weil wir noch kein Sicherungsmodul
    vorhanden ist. Glauben Sie es, ein Backup kann Ihnen viele Probleme ersparen
    oder erleichern. Denken Sie darüber nach.
  </para>
  
  <section id="administration_backup_mysql">
    
    <title>Sichern der MySQL Datenbank</title>
    
    <para>Eine Möglichkeit, ein manuelles Backup durchzuführen, ist
      über die Kommandozeile.
    </para>
    
    <note>
      <para>Ein grafisches webbasierendes Werkzeug dazu ist auch
        der "phpMyAdmin", zu finden untern
        <ulink url="http://www.phpmyadmin.net/">http://www.phpmyadmin.net/
      </ulink>
    </para>
  </note>
  
  <para>Öffnen Sie die Kommandozeile (Linux) oder die Eingabeaufforderung
    (Windows) und geben folgenden Befehl ein:
  </para>
  
  <para>
    <command>mysqldump --add-drop-table -a -u benutzername -p datenbank
      &gt; pfad/zum/backup.sql
    </command>
  </para>
  
  <para>
    Ersetzen Sie <literal>benutzername</literal> mit einem berechtigten
    MySQL Benutzer, der die Tabellen der <literal>datenbank</literal>
    lesen kann, die Sie für moregroupware verwenden.
    Der <literal>pfad/zum/backup.sql</literal> gibt die Datei an, wohin
    die Sicherung geschrieben werden soll, z.B. <filename>C:\backup\mgwbackup.sql
    </filename>
  </para>
  
  <para>
    Wenn Sie einen Fehler ähnlich <computeroutput>bad command</computeroutput>
    erhalten, müssen Sie mit <command>cd</command> in das MySQL Systemverzeichnis
    wechseln (z.B. <command>C:\mysql\bin</command> und den Befehl nochmals ausführen.
  </para>
  
  <para>Nach dem Eingeben des Kommandos führen Sie es mit der Enter Taste aus.
    Sie werden nach einem Passwort für den MySQL Benutzer <literal>benutzername</literal>
    gefragt. Bestätigen Sie die Eingabe ein weiteres Mal mit der Enter Taste. Das
    Backup wird in die angegebene Datei gesichert.
  </para>
  
  <para>Nun haben Sie eine Sicherung der Datenbank, die Sie an einem
    gut behüteten Ort aufheben können.
    Legen Sie ebenso eine Kopie des gesamten moregroupware Ordners an
    (<command>cp -R mgwfolder backupfolder</command> unter Linux oder
    mit dem Windows Explorer unter Windows).
  </para>
  
  <para>Für die Sicherung der E-Mails aus dem Webmail Modul müssen Sie
    den Ordner <filename>modules/webmail2/store</filename>, den Inhalt
    des Dateimoduls und die Konfigurationsdatei <filename>config.inc.php
    </filename> sichern.
  </para>
  
</section>

<section id="administration_backup_mysql_restore">
  
  <title>Wiederherstellen der MySQL Datenbank</title>
  
  <para>Eine Sicherung macht nur Sinn, wenn Sie im Notfall verloren gegangene
    Daten wiederherstellen können. Diese Prozedur sollten Sie vor einem solcher
    Notfälle ausprobiert haben, damit dann die Wiederherstellung erfolgreich verläuft.
  </para>
  
  <note>
    <para>Als grafisches Hilfsmittel steht Ihnen wieder der phpMyAdmin zur Verfügung,
      zu finden unter <ulink url="http://www.phpmyadmin.net/">http://www.phpmyadmin.net/
    </ulink>.
  </para>
</note>

<para><orderedlist>
    <listitem>
      <para>Stellen Sie die ursprüngliche Konfiguration von Apache und MySQL
        wieder her.
      </para>
    </listitem>
    <listitem>
      <para>Kopieren Sie den zuvor gesicherten moregroupware Ordner in
        das ursprüngliche Verzeichnis.
      </para>
    </listitem>
    <listitem>
      <para>Erstellen Sie eine leere Datenbank:</para>
      <para>
        <command>mysql -u benutzername -p -e 'CREATE DATABASE datenbank'</command>
      </para>
      <para>
        Verwenden Sie denselben Namen der <literal>datenbank</literal>
        wie in der ursprünglichen Konfiguration und ersetzen Sie
        <literal>benutzername</literal> durch einen MySQL Benutzer, der eine Datenbank
        anlegen darf.
      </para>
    </listitem>
    <listitem>
      <para>Sichern Sie die Datenbank zurück:</para>
      <para>
        <command>mysql -u benutzername -p datenbank &lt; pfad/zum/backup.sql</command>
      </para>
      <para>
        Ersetzen Sie <literal>benutzername</literal> durch einen MySQL Benutzer, der
        Tabellen in der <literal>database</literal> erstellen darf, die Sie gerade 
        erstellt haben.
        <literal>pfad/zum/backup.sql</literal> ist die Pfadangabe und der Dateiname
        des Datenbank Backups, z.B. <filename>C:\backup\mgwbackup.sql</filename>. 
        Zum Ausführen des Befehls drücken Sie die Enter Taste. Bestätigen Sie das Passwort
        für den MySQL Benutzer nochmals mit der Enter Taste.
        Nun wird die Datenbank mit dem zuletzt gesicherten Datenbestand neu erstellt. 
      </para>
    </listitem>
  </orderedlist>
</para>

<para>Hoffentlich können Sie ohne Datenverlust weiterarbeiten.
</para>

</section>

</chapter>