Content
Dateianzeige für dyneisfair (1.2.4)
usr/share/doc/dyneisfair/dyneisfair.txt
Das DynEisfair-Paket
Das DynEisfair-Paket ermoeglicht es, einem an das Internet angebundenen
Rechner, einen individuellen, festen Domainnamen zuzuweisen ohne
hierfuer eine feste IP-Adresse besitzen zu muessen. Hierfuer wird der
DynEisfair- Service der Firma interSales ([1]http://www.intersales.de)
verwendet.
Auf Wunsch kann man darueber hinaus die extern zugewiesene IP-Adresse
zyklisch, mit Hilfe eines externen Services oder einer AVM
FRITZ!Box^TM abfragen, um gegebenenfalls automatisiert eine
Adressaktualisierung anzustossen. Siehe hierzu
[2]DYNEISFAIR_CHECK_IPADDR.
Die Funktionen
Das DynEisfair-Paket beinhaltet keine weiteren externen Komponenten.
Die Voraussetzungen
Dieses Paket benoetigt zur korrekten Funktion nur einen
funktionierenden DSL-Anschluss und einen gueltigen DynEisfair-Account.
Die Installation
Das DynEisfair-Paket wird ueber das Setup-Menue installiert. Wird eine
aeltere 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 benoetigten Programme
gestartet.
Das Menue im Setup-Programm
Das Menue im Setup-Programm wird ueber 'DynEisfair Client' angesprochen
und ist wie folgt aufgebaut:
* DynEisfair client administration
+ View documentation: Anzeigen der Dokumentation
+ Edit configuration: Bearbeiten der Konfiguration
+ Advanced configuration file handling: Konfigurationen
verwalten
+ Show status: Status des DynEisfair-Services anzeigen
+ Stop DynEisfair client: DnyEisfair-Service anhalten
+ Start DynEisfair client: DnyEisfair-Service starten
+ View Logfile: Die Logmeldungen anzeigen
+ Return: Untermenue verlassen
Die Menuepunkte duerften selbsterklaerend sein, da sie keinerlei
weitere Eingaben erwarten. Aus diesem Grund wird auf deren Funktion
nicht weiter eingegangen.
Die Aenderung der Konfiguration
Die Konfiguration kann ueber den Menuepunkt `Edit configuration'
geaendert werden. Standardmaessig wird der Editor aufgerufen, der in
der Environment- Konfiguration ueber die Variable `EDITOR' festgelegt
wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die
Konfiguration aktiviert werden soll. Wird dies bestaetigt, werden ueber
ein Skript die Anpassungen umgehend wirksam gemacht.
Die Konfigurationsdatei
In der Konfigurationsdatei, die ueber das Menue zugaenglich ist, sind
folgende Parameter vorhanden; wer sie von Hand editieren will findet
sie unter /etc/config.d/dyneisfair.
Die Parameter
START_DYNEISFAIR
Fuer die Aktivierung des DynEisfair-Programms muss dieser
Parameter lediglich auf den Wert `yes' gestellt werden. Die
Einstellung `no' deaktiviert das DynEisfair-Programm.
Gueltige Werte: yes, no
Standardeinstellung: START_DYNEISFAIR='no'
DYNEISFAIR_DOMAIN_N
Dieser Parameter gibt die Anzahl der zu aktualisierenden
dynamischen Domains an, welche ueber das DynEisfair-Paket
aktualisiert werden sollen.
Gueltige Werte: Zahl
Beispiel: DYNEISFAIR_DOMAIN_N='1'
DYNEISFAIR_DOMAIN_x_ACTIVE
Dieser Parameter legt fest, ob der angegebene dynamische
Domaineintrag aktiviert oder deaktiviert wurde.
Gueltige Werte: yes oder no
Standardeinstellung: DYNEISFAIR_DOMAIN_1_ACTIVE='no'
DYNEISFAIR_DOMAIN_x_NAME
Dieser Parameter definiert den Namen der zu aktualisierenden
dynamischen Domain.
Gueltige Werte: Domainname
Beispiel: DYNEISFAIR_DOMAIN_1_NAME='xxx.eisfair.net'
DYNEISFAIR_DOMAIN_x_PASS
Dieser Parameter definiert das Kennwort welches zur
Aktualisierung des dynamischen Domaineintrags genutzt werden
soll.
Gueltige Werte: Passwort
Beispiel: DYNEISFAIR_DOMAIN_1_PASS='secret'
DYNEISFAIR_CHECK_IPADDR (Optionaler Parameter)
Falls eine DynEisfair-Aktualisierung nur durchgefuehrt werden
soll, wenn sich die extern zugewiesene IP-Adresse geaendert hat,
so muss diese Variable lediglich auf den Wert `yes' gestellt
werden. Die Einstellung `no' deaktiviert diese Funktion.
Gueltige Werte: yes, no
Standardeinstellung: DYNEISFAIR_CHECK_IPADDR='no'
DYNEISFAIR_CHECK_IPADDR_URL (Optionaler Parameter)
Ueber 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^TM abgefragt werden soll. Um
diese Funktion nutzen zu koennen, muss zuvor jedoch die Funktion
'Statusinformationen ueber UPnP uebertragen'
(Heimnetz/Netzwerk/Programme) in der AVM FRITZ!Box^TM aktivieren
werden.
Wird dieser Parameter nicht gesetzt, so wird standardmaessig die
folgende URL verwendet:
http://automation.whatismyip.com/n09230945.asp
Gueltige Werte: URL
Standardeinstellung: DYNEISFAIR_CHECK_IPADDR_URL=''
DYNEISFAIR_CHECK_IPADDR_INTERVAL (Optionaler Parameter)
Dieser Parameter legt fest alle wie viel Minuten die extern
zugewiesene IP-Adresse geprueft werden soll. Wird dieser
Parameter nicht gesetzt, so wird standardmaessig ein Intervall
von 5 min verwendet.
ACHTUNG
Dieser Parameter darf nicht zu klein gesetzt werden, da
ansonsten eventuelle Vorgaben des fuer die Pruefung verwendeten
Servicedienstleisters, siehe auch DYNEISFAIR_CHECK_IPADDR_URL,
missachtet werden.
Gueltige Werte: Zahl
Standardeinstellung: DYNEISFAIR_CHECK_IPADDR_INTERVAL=''
DYNEISFAIR_INTERVAL
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 Adressaenderung festgestellt wird.
Gueltige Werte: Zahl
Standardeinstellung: DYNEISFAIR_INTERVAL='10'
Verschiedenes
UPnP bei der AVM FRITZ!Box^TM nutzen
Als Erstes muss die Verwendung von UPnP in der AVM
FRITZ!Box^TM aktiviert werden. Dazu geht man wie folgt vor:
1.
Mit dem Webbrowser zum Router verbinden, indem man die URL
[3]http://fritz.box oder http://
eingiebt und sich am Router mit seinem Kennwort anmelden.
2.
Abhaengig von dem eingesetzten Router-Typ aktiviert man im
Menue 'Heimnetz -> Netzwerk -> Programme' oder 'System ->
Netzwerkeinstellungen' die Funktion 'Statusinformationen
ueber UPnP uebertragen' und die Aenderung durch Klick auf
den Uebernehmen-Knopf bestaetigen.
3.
In der dyneisfair-Konfiguration setzt man anschliessend die
folgenden Parameter:
DYNEISFAIR_CHECK_IPADDR='yes'
DYNEISFAIR_CHECK_IPADDR_URL='fritzbox:'
DYNEISFAIR_CHECK_IPADDR_INTERVAL='2'
DYNEISFAIR_INTERVAL='0'
Standardmaessig verwendet die AVM FRITZ!Box^TM die
IP-Adresse '192.168.178.1'. Falls eine vom Standard
abweichende IP-Adresse konfiguriert wurde muss der folgende
Parameter angepasst werden:
DYNEISFAIR_CHECK_IPADDR_URL='fritzbox:'
4.
Falls alles korrekt konfiguriert wurde, sollte sich
anschliessend eine Meldung wie die folgende in der
DynEisfair-Logdatei, welche ueber den Menuepunkt
'DynEisfair Client -> View log file' eingesehen werden
kann, finden:
Jan 23 18:37:47 eis dyneisfair: updating ip of 'meine-
dyneisfair-domain': 185.142.12.145 - OK nothing changed
__________________________________________________________________
Juergen Edner 2014-01-16