Kostis Netzwerkberatung
Konstantinos Kostis
Talstr. 25, D-63322 Rödermark
Tel. +49 6074 881056, FAX 881058
kosta@kostis.net, http://www.kostis.net/

You may use this software free of charge at your own risk

netdb 3.0.6 (2001-01-29)


netdb installation

Since netdb is currently developed using Red Hat Linux 7.0, some of the default directories and settings are Red Hat Linux 7.0 centric, but changes needed for other Unix like OSs should be minimal.

netdb assumptions

web server assumptions

web server is run by user/group apache

This is a Red Hat Linux 7.0 default. If you go for this solution, please add user netdb to group apache, so that netdb can do chgrp apache on files owned by netdb. The configuration file to look for is most likely /etc/groups.

Earlier versions of both netdb and Red Hat Linux used user nobody for running the web server.

If you plan on running netdb on a system different from Red Hat Linux 7.0 you will need to change a number of file permissions within netdb and possibly some scripts. Future versions of netdb will keep on using Red Hat Linux for development until further notice.

web server files located under /var/www

This is a Red Hat Linux 7.0 default.

Earlier versions of both netdb and Red Hat Linux used to have their web data stored under /home/httpd.

If you don't want to go along with that change to /var/www, it may help to create symbolic links to where your web data is currently stored.

Assuming your web server data is stored under /home/httpd creating such a link would look like this:

ln -s /var/www/cgi-bin/netdb /home/httpd/cgi-netdb/netdb
ln -s /var/www/html/netdb /home/httpd/html/netdb

DNS/bind assumptions

netdb assumes DNS zone files to be stored under /var/named, which is only relevant if you want to create DNS/bind zone files and/or configuration files.

Red Hat Linux 7.0 changed the owner for DNS/bind zones file to a newly created user called named. Even though it's a good idea, it causes problems when you try to create DNS zone files using netdb using user netdb. In case you don't want to touch file permissions, run netdb.mknamed as user root and correct file permissions when necessary.

However I do not recommend creating DNS zone files from netdb more than initially. Please switch to dynamic DNS updates only.

For dynamic DNS updates netdb does not care where DNS zones are stored. Updates are handled by the DNS/bind utility nsupdate with which one can make any changes one needs without stoping and starting named ever.

Having said that one can always stop named, which then freshens it's zone files, edit them (don't forget to increment the key) and start named again. This requires root privileges, though.

Work for shell user root

# use netdb definitions
if [ -x /etc/netdb/setvars ]
then
        . /etc/netdb/setvars
        export REMOTE_USER=netdb
        export REMOTE_ADDR=localhost
fi

netdb must be extracted by user root. Should you have extracted netdb using some non-root type user, please remove netdb and extract it correctly.

netdb consists of the following directories:

/etc/netdb may be owned by root:root after extraction. In case this happens, please fix this:

chown netdb:netdb /etc/netdb

Create /etc/netdb/setvars.local

netdb.local

currently detects

creating /etc/netdb/setvars.local.

For those of you running anything else, please bear with me. I can't have all possible platforms here and test everything. For other platforms to be supported I'll need your support.

Initialize files and file permissions

netdb.init

Compile and install Standard C binaries

If you're not running Red Hat Linux 7.0, here's another step; compile and install Standard C programs netdb and netdbipc:

netdb.install

Check what you still need

netdb.check

Work related to your web server

I wished there was a standard, even an API to just query things like the web server directory or at least a way to query the location of configuration files for applications.

Your web server must be configured to allow .htaccess in your cgi-bin/netdb/admin directory and your web server must be restarted. apache configuration files are usually called httpd.conf

Such a change for httpd.conf could look like this:

<Directory "/var/www/cgi-bin/netdb/admin">
    AllowOverride All
    Options ExecCGI
    Order allow,deny
    Allow from all
</Directory>

Work for shell user netdb

Login as shell user netdb and manually correct /etc/netdb/setvars.local if necessary.

Use netdb.mkdomain to create virtual subdomains (subnets)