%
% systemd-timesyncd.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Systemd-timesyncd %%%%%%%%%%%%%%%%%%%%%%%

\chapter{Systemd-timesyncd - einfacher NTP Klient}
\index{systemd-timesyncd}


\section{Allgemein}

    \glqq{}systemd-timesyncd\grqq{} ist ein Systemdienst, der verwendet
    werden kann, um die lokale Systemuhr mit einem entfernten NTP-Server
    (Network Time Protocol) zu synchronisieren. Es sichert auch jedes Mal
    die lokale Zeit, wenn die  Uhr synchronisiert wurde, und verwendet
    dies, um m"oglicherweise die System-Echtzeituhr bei nachfolgenden
    Neustarts vorzustellen, um sicherzustellen, dass auch dann ungef"ahr
    die Zeit stimmt, wenn dem System ein batteriegepufferter RTC-Chip
    fehlt.


\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. &  Timesync service - administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & 1. &  View documentation \\
    & 2. &  Edit configuration \\
    & 3. &  Advanced configuration file handling \\
    & 4. &  Show status \\
    & 5. &  Stop service \\
    & 6. &  Start service \\
    & 7. &  Show time status \\
    & 8. &  Show timesync status \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

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

    Es wird gefragt, ob die Konfiguration angewendet (aktiviert) werden
    soll. Wird dieses verneint, so unterbleibt die Aktivierung.

    Wird die Aktivierung best"atigt, werden "uber ein Skript die
    durchgef"uhrten "Anderungen wirksam gemacht. Dazu werden die Dienste,
    auch wenn sich die Konfiguration nicht ge"andert hat, gestoppt und
    neu gestartet.


\section{Die Konfigurationsdatei}

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


\section{Die Parameter}

\begin{description}

\config{START\_SYSTEMD\_TIMESYNCD}
{START\_SYSTEMD\_TIMESYNCD}
{STARTSYSTEMDTIMESYNCD}
{
    Für die Aktivierung dieser Konfiguration muss diese Variable
    lediglich auf den Wert 'yes' gestellt werden. Die Einstellung
    'no' schaltet die Aktivierung dieser Konfiguration ab.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_SYSTEMD\_TIMESYNCD='no'}
}

\end{description}


\subsection{Timeserver}


\begin{description}

\config{SYSTEMD\_TIMESYNCD\_USE\_POOL\_NTP\_ORG}
{SYSTEMD\_TIMESYNCD\_USE\_POOL\_NTP\_ORG}
{SYSTEMDTIMESYNCDUSEPOOLNTPORG}
{
    Hier wird angegeben, ob die Server von pool.ntp.org benutzt werden
    sollen, was die default-Einstellung darstellt.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{SYSTEMD\_TIMESYNCD\_USE\_POOL\_NTP\_ORG='yes'}
}


\config{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_N}
{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_N}
{SYSTEMDTIMESYNCDNTPSERVERN}
{
    Hier wird angegeben, wieviele NTP Server aufgelistet werden
    sollen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_N='0'}
}


\config{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_NAME}
{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_NAME}
{SYSTEMDTIMESYNCDNTPSERVERxNAME}
{
    Hier kann eine beliebige Zeichenkette zur eigene Benennung des Servers
    eingetragen werden. systemd-timesyncd wertet diese Option nicht aus.

    G"ultige Werte: alles

    Standardeinstellung: \texttt{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_NAME='{}'}
}


\config{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_ACTIVE}
{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_ACTIVE}
{SYSTEMDTIMESYNCDNTPSERVERxACTIVE}
{
    Hier wird angegeben, ob der NTP Server aktiv sein soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_ACTIVE'no'}
}


\config{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_ADDR}
{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_ADDR}
{SYSTEMDTIMESYNCDNTPSERVERxADDR}
{
    Hier wird der Name oder die IP-Adresse des NTP Servers angegeben.

    G"ultige Werte: Hostname, IP-Adresse des Servers

    Standardeinstellung: \texttt{SYSTEMD\_TIMESYNCD\_NTP\_SERVER\_x\_ADDR='{}'}
}

\end{description}
