%
% mdadm.tex
% Last update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel mdadm %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{mdadm - RAID management}
\marklabel{MENUSYSTEMMDADM}{}
\index{mdadm}

\section{Allgemeines}

    \glqq{}\emph{mdadm}\grqq{} stellt Werkzeuge zum Erzeugen und zum
    "Uberwachen eines Software-RAID bereit.\\
    Das Erzeugen und Anlegen eines \jump{SOFTWARERAID}{Software-RAID-Verbundes}
    wird an anderer Stelle beschrieben.


    In der \emph{mdadm}-Konfiguration werden die f"ur die "Uberwachung
    notwendigen Einstellungen vorgenommen.


\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \mbox{}

    \begin{tabular}{llll}
    & 1. &  System administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & x. &  Filesystems \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & x. &  mdadm - RAID management \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}ll}
    & 1. & View documentation \\
    & 2. & Edit configuration \\
    & 3. & Advanced configuration file handling \\
    & 4. & Show status \\
    & 5. & Stop service \\
    & 6. & Start service \\
    & 7. & Show RAID status \\
    & 8. & Create mdadm conf \\
    \end{tabular}


    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt
    \glqq{}Edit configuration\grqq{} ge"andert werden.

    Nachdem der Editor beendet wurde, wird abgefragt, ob die Konfiguration
    aktiviert werden soll. Wird dies best"atigt, so werden "uber ein Skript
    die Anpassungen umgehend wirksam gemacht.


\newpage


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will, findet sie unter\\
    \texttt{/etc/config.d/mdadm}


\section{Die Parameter}


\begin{description}

\config{START\_MDADM}
{START\_MDADM}
{STARTMDADM}
{
    F"ur die Aktivierung des \emph{'mdadm'} "Uberwachungsdienstes muss
    dieser Parameter lediglich auf den Wert 'yes' gestellt werden. Die
    Einstellung 'no' schaltet den \emph{'mdadm'} "Uberwachungsdienst
    ab.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_MDADM='no'}
}


\config{MDADM\_DELAY}
{MDADM\_DELAY}
{MDADMDELAY}
{
    "Uber diesen Parameter wird angegeben, in welchem Intervall
    \emph{'mdadm'} den RAID-Verbund "uberpr"ufen soll. Der
    Standardwert ist 60 Sekunden.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{MDADM\_DELAY='60'}
}


\config{MDADM\_MAIL}
{MDADM\_MAIL}
{MDADMMAIL}
{
    "Uber diesen Parameter wird die E-Mail-Adresse angegeben, an welche
    bei RAID-Ereignissen eine Nachricht gesandt werden soll.

    G"ultige Werte: E-Mailadresse

    Standardeinstellung: \texttt{MDADM\_MAIL='root@localhost'}
}


\config{MDADM\_SEND\_MAIL\_ON\_START}
{MDADM\_SEND\_MAIL\_ON\_START}
{MDADMSENDMAILONSTART}
{
    "Uber diesen Parameter wird festgelegt, ob beim Start des
    RAID-Verbunde eine Test E-Mail verschickt werden soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{MDADM\_SEND\_MAIL\_ON\_START='no'}
}


\config{MDADM\_SEND\_EVENT\_TO\_SYSLOG}
{MDADM\_SEND\_EVENT\_TO\_SYSLOG}
{MDADMSENDEVENTTOSYSLOG}
{
    "Uber diesen Parameter wird festgelegt, ob RAID-Meldungen an den
    Syslog-Prozess (/var/log/messages) geschickt werden sollen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{MDADM\_SEND\_EVENT\_TO\_SYSLOG='no'}
}

\newpage

\config{MDADM\_SEND\_EVENT\_MAIL}
{MDADM\_SEND\_EVENT\_MAIL}
{MDADMSENDEVENTMAIL}
{
    "Uber diesen Parameter wird angegeben, ob Ereignis RAID-Meldungen
    per E-Mail verschickt werden sollen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{MDADM\_SEND\_EVENT\_MAIL='no'}
}


\config{MDADM\_SEND\_STATUS\_MAIL}
{MDADM\_SEND\_STATUS\_MAIL}
{MDADMSENDSTATUSMAIL}
{
    "Uber diesen Parameter wird angegeben, ob Status RAID-Meldungen
    durch 'Systemd' ausgel"ost und per E-Mail verschickt werden sollen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{MDADM\_SEND\_STATUS\_MAIL='no'}
}


\config{MDADM\_SEND\_STATUS\_MAIL\_TIME}
{MDADM\_SEND\_STATUS\_MAIL\_TIME}
{MDADMSENDSTATUSMAILTIME}
{
    Bei diesen Parameter wird der Zeitpunkt definiert, an dem die
    Status RAID-Meldungen per E-Mail verschickt werden sollen.

\input{systemd_time_definition}


    Standardeinstellung: \texttt{MDADM\_SEND\_STATUS\_MAIL\_TIME='Sat *-*-* 04:10:00'}
}


\config{MDADM\_MD\_CHECK}
{MDADM\_MD\_CHECK}
{MDADMMDCHECK}
{
    "Uber diesen Parameter wird der Periodische Scheck des
    Raid eingeschaltet. Je nach Gr"o"se der Platte kann das
    lange dauern.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{MDADM\_MD\_CHECK='no'}
}


\config{MDADM\_MD\_CHECK\_TIME}
{MDADM\_MD\_CHECK\_TIME}
{MDADMMDCHECKTIME}
{
    "Uber diesen Parameter wird die Zeit angegeben an dem der
    'MD\_CHECK' durch 'Systemd' ausgel"ost werden soll.

\input{systemd_time_definition}


    Standardeinstellung: \texttt{MDADM\_MD\_CHECK\_TIME='Sun *-*-1..7 1:00:00'}
}
\end{description}

