Content
Dateianzeige für ip_update (0.1.5)
usr/share/doc/ip_update/ip_update.txtip_update - package for eisfair
================================
Version 0.1.4 Stand 2008-12-29
Einleitung
==========
Mit dem FritzBox_IP_Up Paket können Benutzer der FritzBox die aktuelle
IP-Adresse auslesen und auf einer Webseite veöffentlichen.
Dieses Paket lehnt sich an das HOW-TO von Carl Kossack für die
"IP-Aktualisierung im HTML-Dokument" auf http://www.fli4l.de/
Installation
============
Das FritzBox_IP_Up Package wird über das Setup-Menü installiert. Nach
dem Installieren der Programmdateien wird direkt der Konfigurations-Editor
gestartet um die Konfiguration anzupassen.
Nach Beendigung diese Schrittes werden die Konfigurationsdateien generiert
und alle benötigten Programme gestartet.
Das Menü im Setup-Programm
==========================
Das Menü im Setup-Programm ist wie folgt aufgebaut:
* Read Documentation: Anzeigen der Dokumentation
* Edit Configuration: Bearbeiten der Konfiguration
* Edit draft file: Berabeiten der Vorlagen-Datei
* Start ip_update: Starten des Dienstes
* Show IP-Adress: Anzeigen der aktuellen IP-Adresse
Die Menüpunkte dürften selbsterklärend sein, da sie keinerlei
weiteren Input erwarten. Deshalb wird auf deren Funktion vorerst
nicht weitereingegangen.
Die Konfigurationsdatei
=======================
In der Konfigurationsdatei, die über das Menü zugänglich ist, sind folgende
Parameter vorhanden; wer sie von Hand editieren will findet sie unter
/etc/config.d/autohalt.
Die Parameter
=============
#-----------------------------------------------------------------------------
# Basic configuration
#-----------------------------------------------------------------------------
IP_UPDATE_START
Für die Aktivierung des IP_Update-Skripts muss diese Variable lediglich auf
den Wert 'yes' gestellt werden. Die Einstellung 'no' deaktiviert das Skript.
Gültige Werte: yes, no
Standard-Einstellung: IP_UPDATE_START='no'
IP_UPDATE_DATE
Hier wird das Datumsformat für die HTML-Seite festgelegt.
e.g. '%d.%m.%y'.
Gültige Werte: %d.%m.%y oder %y/%m/%d oder %d-%m-%y
Standard-Einstellung: IP_UPDATE_DATE='%d.%m.%y'
IP_UPDATE_TIME
Hier wird das Uhrzeitformat für die HTML-Seite festgelegt, e.g. '%H:%M:$S'.
Gültige Werte: %H:%M:$S oder %H:%M
Standard-Einstellung: IP_UPDATE_TIME='%H:%M:$S'
IP_UPDATE_EMAIL
Hier wird die Email Adresse des Webmasters angegeben.
Gültige Werte: EMAILADDR
Standard-Einstellung: IP_UPDATE_EMAIL='foo@foo.de'
IP_UPDATE_NAME
Hier wird der Name des Webmasters angegeben.
Gültige Werte: NONE
Standard-Einstellung: IP_UPDATE_NAME='yourname'
IP_UPDATE_MODE
Hier wird eingestellt wie die 'externe' IP ermittelt werden soll.
Gültige Werte: fritzbox, internet, isdn, dsl
Standard-Einstellung: IP_UPDATE_MODE='fritzbox'
IP_UPDATE_IP_ADRESS
Die IP-Adresse der FritzBox. Im Normalfall ist die Fritzbox über die
IP 192.168.178.1 zu erreichen. (Bitte im Handbuch nachschauen)
Sofern Sie die IP-Adresse ihrer FritzBox manuell geändert haben,
so ist diese IP-Adresse einzugeben.
Gültige Werte: IPADDR
Standard-Einstellung: IP_UPDATE_IP_ADRESS='192.168.178.1'
#-----------------------------------------------------------------------------
# FTP configuration
#-----------------------------------------------------------------------------
IP_UPDATE_USE_FTP
Soll der Upload per FTP erfolgen?
Gültige Werte: yes, no
Standard-Eistellung: IP_UPDATE_USE_FTP='yes'
IP_UPDATE_FTP_N
Anzahl der FTP-Server auf die IP-Adresse hochgeladen werden soll.
Gültige Werte: NUMERIC
Standard-Einstellung: IP_UPDATE_FTP_N='1'
IP_UPDATE_FTP_%_SRV
Der Name des FTP-Servers, auf den die HTML-Datei hochgeladen werden soll.
Gültige Werte: nahezu alles
Standard-Einstellung: IP_UPDATE_FTP_%_SRV='www.foo.de'
IP_UPDATE_FTP_%_USR
Benutzername des FTP-Servers, auf den die HTML-Datei hochgeladen werden soll.
Gültige Werte: nahezu alles
Standard-Einstellung: IP_UPDATE_FTP_%_USR='yourname'
IP_UPDATE_FTP_%_PWD
Passwort des FTP-Benutzers.
Gültige Werte: nahezu alles
Standard-Einstellung: IP_UPDATE_FTP_%_USR='yourname'
IP_UPDATE_FTP_%_TMP
Pfad und Name der Vorlagendatei auf dem Eis.
Gültige Werte: ABS_PATH
Standard-Einstellung:
IP_UPDATE_FTP_%_TMP='/usr/local/ip_update/ip_update.txt'
IP_UPDATE_FTP_%_HTM
Pfad und Name der HTML-Datei auf dem entfernten FTP-Server.
Hier kann ein beliebiger Pfad und Name angegeben werden.
WICHTIG: Das Verzeichnis wird nicht automatisch angelegt,
es muss schon vorhanden sein!
Gültige Werte: NOTEMPTY
Standard-Einstellung: IP_UPDATE_FTP_%_HTM='dynip.htm'
IP_UPDATE_FTP_%_PASSIVE
Soll der Passive Mode des FTP-Servers verwendet werden? yes/no
Eine Änderung des Wertes ist im allgemeinen nicht notwendig.
Gültige Werte: yes , no
Standard-Einstellung: IP_UPDATE_FTP_%_PASSIVE='no'
#-----------------------------------------------------------------------------
# SFTP configuration
#-----------------------------------------------------------------------------
IP_UPDATE_USE_SFTP
Soll der Upload per SFTP erfolgen?
Gültige Werte: yes, no
Standard-Eistellung: IP_UPDATE_USE_SFTP='no'
IP_UPDATE_SFTP_SRV
Der Name des Servers, auf den die HTML-Datei hochgeladen werden soll.
Gültige Werte: nahezu alles
Standard-Einstellung: IP_UPDATE_SFTP_SRV='www.foo.de'
IP_UPDATE_SFTP_USR
Benutzername des Servers, auf den die HTML-Datei hochgeladen werden soll.
Gültige Werte: nahezu alles
Standard-Einstellung: IP_UPDATE_SFTP_USR='yourname'
IP_UPDATE_SFTP_PWD
Passwort des SFTP-Benutzers.
Gültige Werte: nahezu alles
Standard-Einstellung: IP_UPDATE_SFTP_USR='yourname'
IP_UPDATE_SFTP_TMP
Pfad und Name der Vorlagendatei auf dem Eis.
Gültige Werte: Absoluter Pfad
Standard-Einstellung:
IP_UPDATE_SFTP_TMP='/usr/local/ip_update/ip_update.txt'
IP_UPDATE_SFTP_HTM
Pfad und Name der HTML-Datei auf dem entfernten FTP-Server.
Hier kann ein beliebiger Pfad und Name angegeben werden.
WICHTIG: Das Verzeichnis wird nicht automatisch angelegt,
es muss schon vorhanden sein!
Gültige Werte: nahezu alles
Standard-Einstellung: IP_UPDATE_SFTP_HTM='dynip.htm'
#-----------------------------------------------------------------------------
# Cron configuration
#-----------------------------------------------------------------------------
IP_UPDATE_CRON
Wann soll der upload der Datei erfolgen?
Startzeit des Cron jobs: Minute, Stunde, Tag, Monat, Wochentag
Mit dem Voreingestellten Wert wird die Datei alle 30 Minuten hochgeladen.
Gültige Werte: CRONTAB
Standard-Einstellung: IP_UPDATE_CRON='*/30 * * * *'
Die Vorlagendatei
=================
Die Vorlagendatei ist ein einfaches HTML-Dokument, das ein paar Variablen
enthält, die vor dem Upload auf den FTP-Server ersetzt werden.
__IP__ wird durch die aktuelle IP-Adresse ausgetauscht.
__DATE__ wird durch das aktuelle Datum ausgetauscht.
__TIME__ wird durch die Uhrzeit ausgetauscht.
__EMAIL__ wird durch die Email Adresse des Webmasters ausgetauscht.
__NAME__ wird durch den Namen des Webmasters ausgetauscht.
Wenn Sie mehrere verschiedene Vorlagen benötigen, so sind diese von "Hand"
anzulegen und zu editieren.