%
% geoipupdate.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel goipupdate %%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{GeoIPupdate - Geolite2-Datenbanken}
\marklabel{GEOIPUPDATE}{}
\index{geoipupdate}

\section{Die Einleitung}


    Um die freien GeoLite2-Datenbanken kostenlos herunter laden
    zu k"onnen, ist eine Registrierung erforderlich. Weitere Details
    hierzu finden sich auf der Seite von
    \link{https://dev.maxmind.com/geoip/geoip2/geolite2/}{MaxMind}.

    Mit dem erstellten Zugriffsaccount meldet man sich an und erzeugt
    unter \glqq{}License Keys\grqq{} einen neuen Lizenzschl"ussel f"ur
    den Download der Dateien.


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


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

    \mbox{}

    \begin{tabular}{llll}
    & 4. &  Service administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & x. &  GeoIP update service \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}ll}
    & 1. & View documentation \\
    & 2. & Edit configuration \\
    & 3. & Advanced configuration file handling \\
    & 4. & Show schedule status \\
    & 5. & Update databases manually \\
    & 6. & GeoIP Modules \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}ll}
    & x. & \jump{GEOIPUPDATELEGACY}{GeoIP legacy databases services (optional)} \\
    & x. & \jump{XTABLESGEOIPUPDATE}{XTables GeoIP databases services (optional)} \\
    & x. & \jump{XTABLESGEOIPUPDATELEGACY}{XTables GeoIP legacy databases services (optional)} \\
    \end{tabular}

    \mbox{}


\section{"Anderung der Konfiguration}


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


\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/geoipupdate}


\section{Die Parameter}


\begin{description}

\config{START\_GEOIPUPDATE}
{START\_GEOIPUPDATE}
{STARTGEOIPUPDATE}
{
    Soll geoipupdate gestartet werden.

    G"ultige Werte: yes, no

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


\config{GEOIPUPDATE\_SCHEDULE\_TIME}
{GEOIPUPDATE\_SCHEDULE\_TIME}
{GEOIPUPDATESCHEDULETIME}
{
    Hier wird eingestellt, zu welchen Zeiten die Datenbanken aktualisert
    werden sollen.

% ausgegliedert da dieser Teil von vielen benutzt werden kann
% und nicht immer neu erfunden werden muss
\input{systemd_time_definition}

    Standardeinstellung: \texttt{GEOIPUPDATE\_SCHEDULE\_TIME='*-*-1 01:05:00'}
}


\config{GEOIPUPDATE\_EDITION\_ID}
{GEOIPUPDATE\_EDITION\_ID}
{GEOIPUPDATEEDITIONID}
{
    EditionId, von MaxMind, Werte mit Leertaste trennen.

    G"ultige Werte: mit Leertaste getrennt

    Standardeinstellung: \texttt{GEOIPUPDATE\_EDITION\_ID='GeoLite2-Country GeoLite2-City GeoLite2-ASN'}
}


\config{GEOIPUPDATE\_ACCOUNT\_ID}
{GEOIPUPDATE\_ACCOUNT\_ID}
{GEOIPUPDATEACCOUNTID}
{
    Hier ist die Account-ID von MaxMind einzutragen, welcher auch
    bei der Verwendung der freien Datenbanken erforderlich ist. \\

    siehe dazu auch: \link{https://www.maxmind.com/en/my_license_key}{MaxMind.com}.

    G"ultige Werte: AccountID

    Standardeinstellung: \texttt{GEOIPUPDATE\_ACCOUNT\_ID='{}'}
}


\config{GEOIPUPDATE\_LICENSE\_KEY}
{GEOIPUPDATE\_LICENSE\_KEY}
{GEOIPUPDATELICENSEKEY}
{
    Hier ist der Lizenzschl"ussel (License Key) von MaxMind
    einzutragen, welcher auch bei der Verwendung der freien
    Datenbanken erforderlich ist. \\

    siehe dazu auch: \link{https://www.maxmind.com/en/my_license_key}{MaxMind.com}.

    G"ultige Werte: Lizenzschl"ussel

    Standardeinstellung: \texttt{GEOIPUPDATE\_LICENSE\_KEY='{}'}
}

\end{description}
