%
% Achtung: Dateien muessen mit latin1-Encoding gespeichert werden!
% Attention: Files must be saved using latin1 encoding!
%

\chapter{Das DynEisfair-Paket}

    Das DynEisfair-Paket erm"oglicht es, einem an das Internet angebundenen
    Rechner, einen individuellen, festen Domainnamen zuzuweisen ohne hierf"ur
    eine feste IP-Adresse besitzen zu m"ussen. Hierf"ur wird der DynEisfair-
    Service der Firma interSales (\url{http://www.intersales.de}) verwendet.

    Auf Wunsch kann man dar"uber hinaus die extern zugewiesene IP-Adresse
    zyklisch, mit Hilfe eines externen Services oder einer
    AVM FRITZ!Box\texttrademark abfragen, um gegebenenfalls automatisiert
    eine Adressaktualisierung anzusto"sen. Siehe hierzu
    \jump{DYNEISFAIRCHECKIPADDR}{DYNEISFAIR\_CHECK\_IPADDR}.


\section{Die Funktionen}

    Das DynEisfair-Paket beinhaltet keine weiteren externen Komponenten.


\section{Die Voraussetzungen}

    Dieses Paket ben"otigt zur korrekten Funktion nur einen funktionierenden
    DSL-Anschluss und einen g"ultigen DynEisfair-Account.


\section{Die Installation}

    Das DynEisfair-Paket wird "uber das Setup-Men"u installiert. Wird eine
    "altere Paketversion vorgefunden, so wird diese deinstalliert bevor die
    neuen Programmdateien installiert werden. Nach dem Installieren der
    Programmdateien wird direkt der Konfigurations-Editor gestartet um die
    Konfiguration anzupassen. Nach Beendigung dieses Schrittes werden die
    Konfigurationsdateien generiert und alle ben"otigten Programme
    gestartet.


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

    Das Men"u im Setup-Programm wird "uber 'DynEisfair Client' angesprochen und
    ist wie folgt aufgebaut:

    \begin{itemize}
        \item DynEisfair client administration
        \begin{itemize}
            \item View documentation: Anzeigen der Dokumentation
            \item Edit configuration: Bearbeiten der Konfiguration
            \item Advanced configuration file handling: Konfigurationen verwalten
            \item Show status: Status des DynEisfair-Services anzeigen
            \item Stop DynEisfair client: DnyEisfair-Service anhalten
            \item Start DynEisfair client: DnyEisfair-Service starten
            \item View Logfile: Die Logmeldungen anzeigen
            \item Return: Untermen"u verlassen
        \end{itemize}
    \end{itemize}

    Die Men"upunkte d"urften selbsterkl"arend sein, da sie keinerlei weitere
    Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter
    eingegangen.


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt `Edit configuration' ge"andert
    werden. Standardm"a"sig wird der Editor aufgerufen, der in der Environment-
    Konfiguration "uber die Variable `EDITOR' festgelegt wurde. Nachdem der
    Editor beendet wurde wird abgefragt, ob die Konfiguration aktiviert werden
    soll. Wird dies best"atigt, werden "uber ein Skript die Anpassungen umgehend
    wirksam gemacht.


\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/dyneisfair}.


\section{Die Parameter}
%----------------------

\begin{description}
    \config{START\_DYNEISFAIR}{START\_DYNEISFAIR}{STARTDYNEISFAIR}
        F"ur die Aktivierung des DynEisfair-Programms muss dieser Parameter
        lediglich auf den Wert `yes' gestellt werden. Die Einstellung
        `no' deaktiviert das DynEisfair-Programm.

        G"ultige Werte: yes, no

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

    \config{DYNEISFAIR\_DOMAIN\_N}{DYNEISFAIR\_DOMAIN\_N}{DYNEISFAIRDOMAINN}
        Dieser Parameter gibt die Anzahl der zu aktualisierenden
        dynamischen Domains an, welche "uber das DynEisfair-Paket
        aktualisiert werden sollen.

        G"ultige Werte: Zahl

        Beispiel: \texttt{DYNEISFAIR\_DOMAIN\_N='1'}

    \config{DYNEISFAIR\_DOMAIN\_x\_ACTIVE}{DYNEISFAIR\_DOMAIN\_x\_ACTIVE}{DYNEISFAIRDOMAINxACTIVE}
        Dieser Parameter legt fest, ob der angegebene dynamische
        Domaineintrag aktiviert oder deaktiviert wurde.

        G"ultige Werte: yes oder no

        Standardeinstellung: \texttt{DYNEISFAIR\_DOMAIN\_1\_ACTIVE='no'}

    \config{DYNEISFAIR\_DOMAIN\_x\_NAME}{DYNEISFAIR\_DOMAIN\_x\_NAME}{DYNEISFAIRDOMAINxNAME}
        Dieser Parameter definiert den Namen der zu aktualisierenden
        dynamischen Domain.

        G"ultige Werte: Domainname

        Beispiel: \texttt{DYNEISFAIR\_DOMAIN\_1\_NAME='xxx.eisfair.net'}

    \config{DYNEISFAIR\_DOMAIN\_x\_PASS}{DYNEISFAIR\_DOMAIN\_x\_PASS}{DYNEISFAIRDOMAINxPASS}
        Dieser Parameter definiert das Kennwort welches zur
        Aktualisierung des dynamischen Domaineintrags genutzt
        werden soll.

        G"ultige Werte: Passwort

        Beispiel: \texttt{DYNEISFAIR\_DOMAIN\_1\_PASS='secret'}

    \config{DYNEISFAIR\_CHECK\_IPADDR (Optionaler Parameter)}{DYNEISFAIR\_CHECK\_IPADDR}{DYNEISFAIRCHECKIPADDR}
        Falls eine DynEisfair-Aktualisierung nur durchgef"uhrt werden
        soll, wenn sich die extern zugewiesene IP-Adresse ge"andert hat,
        so muss diese Variable lediglich auf den Wert `yes' gestellt
        werden. Die Einstellung `no' deaktiviert diese Funktion.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{DYNEISFAIR\_CHECK\_IPADDR='no'}

    \config{DYNEISFAIR\_CHECK\_IPADDR\_URL (Optionaler Parameter)}{DYNEISFAIR\_CHECK\_IPADDR\_URL}{DYNEISFAIRCHECKIPADDRURL}
        "Uber diesen Parameter kann eine URL angegeben werden, welche
        zur Abfrage der extern zugewiesene IP-Adresse verwendet werden
        soll. Alternativ kann die Adresseingabe auch im Format `fritzbox:ip-adresse'
        erfolgen, wenn die extern zugewiesene IP-Adresse von einer AVM
        FRITZ!Box\texttrademark  abgefragt werden soll. Um diese Funktion nutzen
        zu k"onnen, muss zuvor jedoch die Funktion 'Statusinformationen "uber
        UPnP "ubertragen' (Heimnetz/Netzwerk/Programme) in der AVM 
        FRITZ!Box\texttrademark aktivieren werden.\\
        Wird dieser Parameter nicht gesetzt, so wird standardm"a"sig die folgende
        URL verwendet:\\
        \begin{verbatim}
http://automation.whatismyip.com/n09230945.asp
        \end{verbatim}

        G"ultige Werte: URL

        Standardeinstellung: \texttt{DYNEISFAIR\_CHECK\_IPADDR\_URL=$''$}

    \config{DYNEISFAIR\_CHECK\_IPADDR\_INTERVAL (Optionaler Parameter)}{DYNEISFAIR\_CHECK\_IPADDR\_INTERVAL}{DYNEISFAIRCHECKIPADDRINTERVAL}
        Dieser Parameter legt fest alle wie viel Minuten die extern
        zugewiesene IP-Adresse gepr"uft werden soll. Wird dieser
        Parameter nicht gesetzt, so wird standardm"a"sig ein Intervall
        von 5 min verwendet.\\
        \achtung{Dieser Parameter darf nicht zu klein gesetzt werden,
        da ansonsten eventuelle Vorgaben des f"ur die Pr"ufung verwendeten
        Servicedienstleisters, siehe auch DYNEISFAIR\_CHECK\_IPADDR\_URL,
        missachtet werden.}

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{DYNEISFAIR\_CHECK\_IPADDR\_INTERVAL=$''$}

    \config{DYNEISFAIR\_INTERVAL}{DYNEISFAIR\_INTERVAL}{DYNEISFAIRINTERVAL}
        Dieser Parameter legt fest nach wie viel Minuten der
        dynamische Domaineintrag beim Provider aktualisiert
        werden soll. Wird der Wert `0' gesetzt, so deaktiviert
        dies die zyklische Aktualisierung und es erfolgt einzig
        eine Aktualisierung wenn eine Adress"anderung festgestellt
        wird.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{DYNEISFAIR\_INTERVAL='10'}
\end{description}

\section{Verschiedenes}
%----------------------

\begin{description}
    \config{UPnP bei der AVM FRITZ!Box\texttrademark nutzen}{UPnP}{UPnP}
        Als Erstes muss die Verwendung von UPnP in der AVM FRITZ!Box\texttrademark aktiviert
        werden. Dazu geht man wie folgt vor:
        \begin{itemize}
            \item[1.] Mit dem Webbrowser zum Router verbinden, indem man die
                URL \url{http://fritz.box} oder http://$<$ip-adresse-vom-router$>$
                eingibt und sich am Router mit seinem Kennwort anmelden.

            \item[2.] Abh"angig von dem eingesetzten Router-Typ aktiviert man im
                Men"u 'Heimnetz -$>$ Netzwerk -$>$ Programme', 'Heimnetz -$>$ Netzwerk
                -$>$ Netzwerkeinstellungen -$>$ Heimnetzfreigaben'  oder 'System -$>$
                Netzwerkeinstellungen' die Funktion 'Statusinformationen "uber
                UPnP "ubertragen' und die "Anderung durch Klick auf den
                "Ubernehmen-Knopf best"atigen.\\
                \begin{minipage}[t]{50mm}
                    \includegraphics[width=80mm]{./pics/fritz-upnp-activation.png}\\
                \end{minipage}

            \item[3.] In der dyneisfair-Konfiguration setzt man anschlie"send die
                folgenden Parameter:\\

                \begin{verbatim}
DYNEISFAIR_CHECK_IPADDR='yes'
DYNEISFAIR_CHECK_IPADDR_URL='fritzbox:'
DYNEISFAIR_CHECK_IPADDR_INTERVAL='2'
DYNEISFAIR_INTERVAL='0'
                \end{verbatim}

                Standardm"a"sig verwendet die AVM FRITZ!Box\texttrademark die
                IP-Adresse '192.168.178.1'. Falls eine vom Standard abweichende
                IP-Adresse konfiguriert wurde muss der folgende Parameter
                angepasst werden:\\

                \begin{verbatim}
DYNEISFAIR_CHECK_IPADDR_URL='fritzbox:<fritzbox-ip-adresse>'
                \end{verbatim}

            \item[4.] Falls alles korrekt konfiguriert wurde, sollte sich anschlie"send
                eine Meldung wie die folgende in der DynEisfair-Logdatei, welche "uber
                den Men"upunkt 'DynEisfair Client -> View log file' eingesehen werden
                kann, finden:

                \begin{verbatim}
Jan 23 18:37:47 eis dyneisfair: updating ip of 'meine-
    dyneisfair-domain': 185.142.12.145 - OK nothing changed
                \end{verbatim}
        \end{itemize}
\end{description}
