Variable |
Default Value |
Description |
Valid |
Example |
Optional |
OPT_HTTPDNS |
'no' |
Activates the httpDNS
optional
package. |
yes or no |
'yes' |
no |
HTTPDNS_INTERFACE |
'' |
Device the WWW is accessed
through. Usually this is the ISDN interface card or an ethernet NIC
connected to the modem. Property is needed to fetch the current IP
address. If left empty, the IP address is requested from the server. |
all NIC and PPP devices |
'eth1' |
yes |
HTTPDNS_HOSTNAME |
'' |
Unique name of the fli4l router.
NOTE: All letters are converted to small letters! |
a-z, 0-9, '-', '@', '_', '!' and
'.' |
'hunter99' |
no |
HTTPDNS_DNSFOLDER |
'/var/run/httpdns' |
Folder on the client the DNS
files are stored in. All entries are preserved during reboot if the
folder is not part of the RAM disk, but located on physical disk. |
any absolute path |
'/boot/httpdns' |
no |
HTTPDNS_SERVER_N |
'0' |
Number of servers you wish to
use. |
any number |
'1' |
no |
HTTPDNS_SERVER_%_NAME |
'' |
URL of the n'th server. Must
point to the folder the server program is put in. The server program
file name is appended automatically. |
URL (HTTP) |
'members.myprovider.com/yourname/httpdns/sub/folder' | no |
HTTPDNS_SERVER_%_KEY |
'' |
Secret key of the n'th server.
Has to be declared on every client that wants to access the server. |
use key gen- erartor, please! |
'iAZoUkX!v0@V_flg5BLyPwuHTFbK3R9xaIYEGJnqp' |
no |
HTTPDNS_SERVER_%_IPUP |
'no' |
Do you want the client to
synchronize with this server after connecting to the ISP? |
yes or no |
'yes' |
yes |
HTTPDNS_SERVER_%_DNSFILE | 'httpdns.dns' |
Name of the file used to store
entries on the server. If it contains a path, necessary folders are
created automatically at the first start of the server program. |
file name with or without path |
'subfolder/httpdns.log' |
yes |
HTTPDNS_SERVER_%_LOGFILE | '' |
If you want all activities to be logged, state the log file name here. If it contains a path, necessary folders are created automatically at the first start of the server program. | file name with or without path |
'subfolder/access.log' |
yes |
HTTPDNS_SERVER_%_LOGLEVEL |
'5' |
Specify how detailed the server
program does it's logging. '9' is very verbose, while '0' disables
logging, entirely. |
0-9 |
'0' |
yes |
Variable |
Default Value |
Description |
Valid |
Example |
Optional with
MySQL |
HTTPDNS_SERVER_%_MYSQL |
'no' |
Activates MySQL for this server. |
'yes' or 'no' |
'yes' |
no |
HTTPDNS_SERVER_%_MYSQL_SERVER |
'localhost' |
URL to MySQL server. |
URL with or without port
specification |
'localhost' or 'localhost:3306' |
no |
HTTPDNS_SERVER_%_MYSQL_USER |
'' |
User name for MySQL server login. |
any |
'username' |
no |
HTTPDNS_SERVER_%_MYSQL_PWD |
'' |
Password for MySQL server login. |
any |
'password' |
no |
HTTPDNS_SERVER_%_MYSQL_DB |
'' |
Database to use. The database
has to be created manually, because some limitations may apply on some
servers for creating databases. |
any |
'mydb01' |
no |
HTTPDNS_SERVER_%_MYSQL_DNSTABLE |
'httpDNS_DNS' |
Name of the table holding DNS
information. All tables are automatically created by httpDNS. |
a-z, A-Z, 0-9, '_' and '$', no
blanks, max. 64 chars |
'my_dns_table' |
yes (see
below) |
HTTPDNS_SERVER_%_MYSQL_LOGTABLE |
'httpDNS_Log' |
Name of the table holding log information. All tables are automatically created by httpDNS. | a-z, A-Z, 0-9, '_' and '$', no blanks, max. 64 chars | 'my_log_table' |
yes (see
below) |
|
|
Variable |
Default Value |
Description |
Valid |
Example |
Optional |
HTTPDNS_SERVER_%_FTPURL |
'' |
FTP address of the web server. |
URL (FTP) |
'ftp.myprovider.de' |
yes |
HTTPDNS_SERVER_%_FTPUSER | '' |
FTP user name as defined by the
web space provider. |
a-z, 0-9, '-' and '.' | 'firstname.lastname' |
yes |
HTTPDNS_SERVER_%_FTPPWD |
'' |
FTP Password. |
any value |
'password' |
yes |
HTTPDNS_SERVER_%_FOLDER |
'' |
Sub folder the server shall be running in. The folder has to correlate the one given with HTTPDNS_SERVER_%_NAME. | relative paths, only |
'httpdns/sub/folder' |
yes |
www.tiger.adm24.eu/httpdns-test/httpdns.php?hostname=YOURHOSTNAME&password=YOURPASSWORD
Variable |
Default
Value |
Desciption |
Valid |
Example |
Optional |
HTTPDNS_SERVER_%_PASSWORD |
'' |
Enable password access of the
server by setting a password. |
any value |
'5hDdfg2aLsf' |
yes |
Variable |
Default Value |
Description |
Valid |
Example |
Optional |
HTTPDNS_SERVER_%_LIFETIME |
'0' |
Number of hours until a host
entry is erased from the server database, if not updated. '0' disables
this feature. |
0 to 65535 |
'8770' |
yes |
Icon |
Name |
Description |
See
Chapter |
![]() |
Synchronize |
Starts the synchronization with
the server next to the symbol. |
Synchronization
with the Server |
![]() |
Synchronize All DNS |
Starts the synchronization with
all servers. |
Synchronization with the Server |
![]() |
Show Server Log |
Views the content of the
server's log file. |
Server
Administration |
![]() |
Clear Server Log |
Empties the server's log file. |
Server Administration |
![]() |
Setup Manually |
Starts the configuartion
procedure of the server program for manual installation. |
Manual
Installation of the Server Program |
![]() |
Upload Program |
Starts the automated
installation of the server program. |
Starting
the Automated Installation of the Server Program |
![]() |
Generate Polling Links |
Displays a list of http links,
which can be used to query ip addresses of single hosts. |
Gerneration of Polling Links |
![]() |
Erase Host Entry |
Erases a single host from server. |
Erasing
Hosts |
The current IP is:
<IFRAME
src="http://www.tiger.adm24.eu/httpdns-test/httpdns.php?query=oHdADfKVvZh.tczmGONilqjaJE_01xPCQRIFTr3w7t4pFQjC|Gd2n0.a6vDxPumKkAY">
Server not available
</IFRAME><br>
Description |
Usual File
Name |
Usual Folder |
File Format |
Server Program |
httpdns.php |
- |
Text, PHP4 |
DNS File |
httpdns.dns |
Same as the server Program or as
stated in
HTTPDNS_SERVER_%_DNSFILE |
Text, encoded |
Log File |
httpdns.log |
Same as the server Program or as
stated in
HTTPDNS_SERVER_%_LOGFILE |
Text |
Variable |
Default Value |
Description |
Valid |
Example |
Optional |
HTTPDNS_SERVER_%_ADMIN |
'' |
Hostname of the administrator of
the server. Prevents any other user from erasing server data. ''
disables this feature. |
a-z, 0-9, '-', '@', '_', '!' and '.' | 'master' |
yes |
User Rights
Entry |
Key
Generator |
View
DNS Tables |
Synchronize |
Upload
Server Program |
View
& Clear Server Log |
View Journal |
'httpdns:' |
no |
no | no |
no |
no |
no |
'httpdns:view' |
yes | yes | no | no | no |
no |
'httpdns:view,sync' |
yes |
yes |
yes | no | no | no |
'httpdns:view,sync,admin' or
'httpdns:all' or simply '' |
yes | yes |
yes |
yes | yes |
yes |
Parameter |
Description |
Example |
-a, --all |
Synchronize with all servers and
update hosts.httpdns file. |
/srv/www/admin/httpdns.cgi -a |
-h, --help |
Show help and program version. |
/srv/www/admin/httpdns.cgi -h |
-i, --ipup |
Synchronize with all servers,
where HTTPDNS_SERVER_%_IPUP='yes'. Update hosts.httpdns file afterwards. |
/srv/www/admin/httpdns.cgi -i |
-u, --update |
Only update hosts.httpdns file.
Do not
synchronize with servers. Only locally stored DNS entries are processed. |
/srv/www/admin/httpdns.cgi -u |
-s, --silent |
Additional parameter. Suppresses
any output to the console. |
/srv/www/admin/httpdns.cgi -a -s |
{Server Name} |
Only synchronize with the server
stated and update hosts.httpdns file afterwards. The server must have
been
configured previously and the name stated must be exactly the name in
HTTPDNS_SERVER_%_NAME. |
/srv/www/admin/httpdns.cgi
member.myprovider.com/yourname |
{Server Number} |
Only synchronize with the server stated and update hosts.httpdns file afterwards. The server must have been configured previously and the number stated must be the number as indicated by '%' in HTTPDNS_SERVER_%_NAME. | /srv/www/admin/httpdns.cgi 1 2 3 |
No parameter shows help. |
/srv/www/admin/httpdns.cgi |
Variable | Description |
Valid |
Example |
HTTPDNS_SERVER_%_HTTPUSER |
The user name used to access the
webfolder. |
any value |
'httpdns' |
HTTPDNS_SERVER_%_HTTPPWD | The password used to get access
to the webfolder. |
any value |
'iO02Dq_yasE2' |
Field |
Description |
Valid |
Example |
Server URL |
HTTP address of the server
program as stated in HTTPDNS_SERVER_%_NAME. |
any URL |
http://www.tiger.adm24.eu/httpdns-test |
Hostname |
Name this network is represented
with on the server. |
a-z, 0-9, '-', '@', '_', '!' and '.' | myhost.network |
Password |
Password as defined in
HTTPDNS_SERVER_%_PASSWORD |
a-z, 0-9, '-', '@', '_', '!' and '.' | 5hDdfg2aLsf |
Field |
Description |
Valid |
Example |
Server URL |
Link with crypted query. Use the
httpd web interface to generate the links and copy and paste it into
the Windows Client. |
any link generated by the httpDNS
web interface |
http://www.tiger.adm24.eu/httpdns-test/httpdns.php? |
Filename |
Name and path of the text file
to be patched with the received IP address. If empty, no file will be
modified. |
any text file given by it's full
path |
C:\WINNT\system32\drivers\etc\hosts |
Find |
Text pattern being searched in
the text file. Use @IP as placeholder for any IP address. |
any text, as well as any AutoIt3
Regular Expression |
remote='@IP' ; Synchronized on
[-[:digit:]]* at [:[:digit:]]* |
Replace with |
Text to replace any occurence of
the 'Find' text. Use @IP as placeholder of the received IP address. The
placeholders @DATE and @TIME insert the current date and time. |
any text |
remote='@IP' ; Synchronized on @DATE at @TIME |
Append |
If Append is checked, the
Windows Client will append the 'Replace with' text at the end of the
text file, in case no match of the 'Find' text is found in the text
file. |
- |
- |
Execute cmd. |
After the text file has been patched or if no text file is set, the command stated will be executed. Use @IP as placeholder of the received IP address. | any shell command |
cmd /c
"C:\Programs\PuTTY\putty.exe root@@IP" or cmd /c "echo @IP > %TEMP%\ip.txt && notepad %TEMP%\ip.txt" |
No.
of Param's |
Description |
0 |
Opens the dialog and loads the
settings of the profile saved last. |
1 |
Opens the dialog and loads the
settings of the profile stated in the first parameter. Exception: '-h'
or '/?' or '--help' will open the help box. |
2 |
Does not open the dialog, but
loads the profile stated in the second parameter and executes the httpDNS
command stated in the first parameter. |
Param #1 |
Description |
'-s' or '--sync' or '/s' |
Loads the profile stated in the
second parameter and synchronizes with the server program. The Windows
Client terminates without any dialogs, but maybe error messages. |
'-q' or '--query' or '/q' |
Loads the profile stated in the second parameter and queries the IP address from the server program. It patches the text file if 'Filename' is set, executes a given 'Execute cmd.' command and terminates without any dialogs, but maybe error messages. |
Error
Description |
Problem | Solution |
When compiling fli4l (mkfli4l) a
'Invalid Key' error is displayed. I do not have and cannot create any
key, for the key generator is not running, yet. |
A key has to contain 41
characters in length from as special character set. |
For the first installation run you can leave the key variable empty. HTTPDNS_SERVER_%_KEY='' |
In the window 'Current IP
Address' no or not the correct IP address is displayed. |
HTTPDNS_INTERFACE not set
correctly. |
The variable must hold the name
of the device through which the WWW is accessed. Leave
HTTPDNS_INTERFACE empty, it the client is installed behind another
router or a masquerading proxy. |
When I click the tab
'Synchronization' in the web interface a error message 'offline' is
displayed,
despise I am online. |
HTTPDNS_INTERFACE not set
correctly. |
The variable must hold the name of the device through which the WWW is accessed. |
Error
Description |
Problem | Solution |
Only a 'Setup Manually' button
is displayed in the tab 'Administration', but no 'Upload Program'
button. |
At least on of the variables
HTTPDNS_SERVER_%_FTPURL, HTTPDNS_SERVER_%_FTPUSER or
HTTPDNS_SERVER_%_FTPPWD is not set. |
To make use of the automated
upload feature all FTP variables in config/httpdns.txt need to be set. |
On viewing a server's log file I
get a lot of junk data. |
The web server seems to add
frames or pop-ups to any HTML page. |
There is no solution but to
change the web space package from your current provider or to change
providers at all. |
During the automated upload
error messages are reported from the FTP server. |
Error 530 during Logging in:
Login failed, due to illegal user name or password. Error 530 some later after logging in: The 'chmod' command is not supported. Errors 526 and 536: The server program could not be copied to the web space. |
For there are various reasons,
there are various solutions. Anyway, it's a good idea to consult the
web space providers FTP manual and check if the FTP variables are set
correspondingly. If the chmod command is not supported you are probably
not privileged to execute programs (run PHP's) on the web space. |
Right after setting up the
server the synchronization results 'Invalid response' or 'Server error'. |
The server program tries to
create the files and folders for storing DNS data and logs. Due to
access restrictions the creation is prohibited. |
Erase all automatically created
folders and recreate them manually. Change the access rights to those
folders with the command 'chmod 777' and try to synchronize. The files
should have been created, now. Restore the access right with the
command 'chmod 755'. |
'Not available' is displayed as
status. |
The NSLookup did not yield any
results. |
The given URL or FTP URL is
invalid or your ISP's DNS is currently down. |
The button 'Generate Polling
Links' is not being displayed |
The button is only displayed, if
the server supports quering by links. This feature was introduced in httpDNS
1.1.1. |
Update your server program. |
The button 'Erase Host' is not
being displayed |
The button is only displayed, if
the server supports the deletion of hosts. This feature was introduced
in httpDNS
1.1.7. |
Update your server program. |
During erasing of hosts or the
clearing of the server log a 'You have no administrator rights' error
is displayed, but I am a named administrator of the sever. |
The IP address you are sending
the server command from does not match the IP address your hostname is
registered with. |
Just synchronize with the server. |
Error
Description |
Problem | Solution |
Even after synchronizing a wrong
IP address is written to the hosts.httpdns file for my router's host
name. |
HTTPDNS_INTERFACE not set
correctly or the ISP assigns the IP address after some time delayed or
the client is installed behind another router or masquerading Proxy. |
The variable must hold the name
of the device through which the WWW is accessed. Check your IP address
as displayed in the windows 'Current IP Address' by selecting
tab 'Synchronization' in the web interface. Some modems with integrated DHCP assign a temporary IP address until the ISP assigns the valid address. In that case you can only synchronize manually using the web interface after the valid address was assigned. Leave HTTPDNS_INTERFACE empty, it the client is installed behind another router or a masquerading proxy. |
Synchronization does work, but
the other clients cannot find my router. |
HTTPDNS_INTERFACE not set correctly | The variable must hold the name
of the device through which the WWW is
accessed. Check your IP address as displayed in the windows 'Current IP
Address' by selecting tab 'Synchronization' in the web interface. The
IP
address displayed has to be the one your router was assigned by the
ISP not the one used to access your router from the LAN. Leave HTTPDNS_INTERFACE empty, it the client is installed behind another router or a masquerading proxy. |
HTTPDNS_SERVER_%_IPUP is set
'yes', but the router does not synchronize on dial-up. |
IP-up event is not triggered |
If your are running fli4l in a
straight router configuration with the OPT_DHCP option enabled, the
variable
DHCPCD_EXEC_IPUPDOWN has to be 'yes' or no ip-up event will occur. |
The client cannot find the
server and a 'No answer' status is displayed. |
The server program is not stored
in the correct folder. |
Either move the server program
to the correct folder or change the URL in HTTPDNS_SERVER_%_NAME. |
The URL in HTTPDNS_SERVER_%_NAME
corresponds to the folder the server program is stored in. Anyway,
there still is a 'No answer' status being displayed. |
Probably the web server does not
support PHP4. Or the server program was not set to be executable on the web server. |
Open your browser and request
the URL with '/httpdns.php' appended. If you receive data junk, the web
server does not support PHP4 or the server program was not set to be
executable by the use of 'chmod 755 httpdns.php'. If a 'httpDNS' header
line is displayed, the URL is correct. Check if the corresponding
variables are set correctly. If a '404 not found' error message is
displayed, the URL is incorrect. Have a look in the web space
provider's manual for information how to access the web space. |
'Encryption failed.' is being
displayed. |
No valid key was declared for
the server. |
Start the key generator and copy
a key to the server's key variable in config/httpdns.txt. |
The client does not receive any DNS entries from the server. | The DNS file cannot be created
on the web server |
Check the access rights to the
server's folder and the DNS file using the chmod command. |
There are no buttons in the
windows after selecting tab 'Synchronization' in the web interface. |
User right 'sync' not set for
you. |
Please, contact your system
administrator, who sets the user rights for the 'httpdns' section of
the httpd package. If you are the administrator, please read further
information in the manual for the httpd package regarding the setting
of user rights. |
An old server is still being
listed when tab 'Synchronization' is selected, despise I
already deleted the corresponding variables from the configuration. |
There still is an old DNS file
from the server in the local folder declared in HTTPDNS_DNSFOLDER |
The file has to be deleted
manually from the folder. The httpDNS client evaluates
every file with
the extension ".dns" stored in the folder HTTPDNS_DNSFOLDER. |
Variable |
Default Value |
Description |
Example |
Valid |
HTTPDNS_DEBUG |
'no' |
During normal program execution
all temporary files are deleted right away. With debugging enabled, the
files containig the HTTP request sent to the sever
(httpdns-request.tmp) and the server's response (httpdns-response.tmp)
are saved to the /tmp folder. |
'yes' |
yes or no |
HTTPDNS_LOGFILE |
'' |
Independent of the HTTPDNS_DEBUG
option the CGI can be configured to keep a journal of all WAN
activities regarding the package. Just state the file you want the data
to be written to to enable logging. Vice versa, an empty
HTTPDNS_LOGFILE variable disables the journal creation, but does not
delete the journal file. To view and delete the journal file you can
use the httpd web interface. The log file is written in Common Log
Format. |
'/var/log/httpdns.log' | any filename with absolute path |
HTTPDNS_LOGLEVEL |
'5' |
Determines how verbose the
logging is done. 0 disables logging entirely, while 9 is extremely
noisy. Please refer to the table below
for a description of the different levels. |
'1' |
0-9 or empty |
Variable |
Default Value |
Description |
Example |
Valid |
HTTPDNS_SERVER_%_LOGFILE |
'httpdns.log' |
If you want the logging data to
be written to disk, just state the name and relative path of the file
on the server. |
'log/serverlog.txt' |
any filename with relative path |
HTTPDNS_SERVER_%_MYSQL_LOGTABLE |
'httpDNS_Log' |
Instate of a file you can use a
table in a MySQL database to store logging information. Please, make
sure to enable MySQL with the variable HTTPDNS_SERVER_%_MYSQL! |
'my_log' |
up to 64 characters of 0-9, a-z,
A-Z, $ and _ |
HTTPDNS_SERVER_%_LOGLEVEL |
'5' |
Independent of the way the
information is store, this variable sets the verbosity of the server's
log. Please refer to the table below for
a description of the different levels. |
'1' |
0-9 or empty |
Log
Level |
Remark |
Error |
Warning |
Info |
Notice |
0 |
Logging
disables |
no |
no |
no |
no |
1 |
yes |
no | no | no | |
3 |
yes | no | no | no | |
5 |
Default log
level |
yes | yes | no | no |
7 |
yes | yes | yes | no | |
9 |
yes | yes | yes | yes |