Menu
▾
▴
Tree [e655bf] master / History
Read Me
Sauron v.0.7.4 - DNS/DHCP Management System
==============
This is a development branch release (current stable branch is v0.6.x).
However, based on reports from users current development branch releases
should be more stable than the current "stable" branch :)
DBI (DBD::Pg) is now the default database access method, but Pg can still
be used by specifying --with-Pg option to configure script.
UPGRADE
See README.upgrade if upgradig from a previous version.
REQUIREMENTS
- BIND v8 or later [9.2.x or newer recommended]
- ISC dhcpd v2 or later [3.x or newer recommended] (optional)
- Perl 5 or better [at least 5.6 recommended]
- CGI module
- DBD::Pg (and DBI) module (or Pg module)
- Net::DNS module
- Net::IP module
- Net::Netmask module
- Digest::MD5 module
- Digest::HMAC module
- Digest::SHA1 module
- MIME::Base64
- Crypt::RC5
- PostgresSQL [7.4 or newer (may work fine with earlier 7.x versions)]
(or add support to your favorite db yourself :)
- www-server (Apache or any other www-server with CGI support)
SOURCE
http://sourceforge.net/p/sauron-dns/code/
DOWNLOAD
Sauron and related files are available from:
WWW: http://sauron.jyu.fi/
or
http://sourceforge.net/projects/sauron-dns/files/
FTP: ftp://ftp.jyu.fi/pub/sauron/
TESTED PLATFORMS
Sauron is currently developed using Red Hat Linux,GNU/Debian Linux,
and Solaris but it should work pretty much on any Unix variant
(if required programs are available).
INSTALLATION
See User Guide for complete installation instruction. This section
is only a quick overview of the installation process:
1) Build and install the program (SKIP this if you're installing the RPM):
./configure
make
make docs (optional)
make install
2) Create database for Sauron to use in PostgreSQL
(use createdb command to create the database, see PostgreSQL
documentation for more help)
3) Edit configuration files: config and config-browser
(these are usually in /usr/local/etc/sauron or /etc/sauron)
at minimum you need to check paths and setup database
connection string (DB_CONNECT)
4) Create tables in the newly created database:
<change to installation directory (/usr/local/sauron)>
./createtables
./status (check that everything worked)
5) Populate OUI (Ethernet card manufacturer) table (optional):
./import-ethers contrib/Ethernet.txt
./import-ethers --force contrib/additional-ether-codes.txt
(NOTE! you may want to download IEEE's public list
of OUIs from: http://standards.ieee.org/regauth/oui/index.shtml
and import it as well)
6) Populate global root servers table:
./import-roots default contrib/named.root
(NOTE! you should download latest version of this file
from: ftp://ftp.rs.internic.net/domain/ and use it)
7) Create administrator account:
./adduser (remember to set superuser flag)
8) Setup www interface
You need to make sauron.cgi and browser.cgi available through
your www server. One way to do this is to make symbolic links
for sauron.cgi and browser.cgi in your cgi-bin directory.
Copy images under icons/ directory to sauron/icons/ directory
under your web server root directory (or just make a symbolic link)
9) now you can use the web interface to create a server and zones, or
you can import existing named/dhcpd configurations using
import/iport-dhcp utilities. Or you can try out the demo database
that can be found under test/ directory in source tree.
COMMANDS
addgroup
Creates user groups. It's recommended to assign
users to groups and assign privileges to groups and not
directly to users.
addhosts
Utility for adding hosts to a existing zone from given
file. Input file format is same as in normal zone files.
adduser
Creates new user accounts. Use --help option for more help.
check-pending
Program to be run from crontab that check for pending
changes in database and sends notification of pending changes
to address defined in configuration.
delgroup
Removes user group from the system.
deluser
Removes users accounts from the system. (accounts can also be locked
with moduser command).
expire-hosts
Utility for expiring unused (no DHCP activity within given time-frame)
host entries.
export-networks
Generates Unix /etc/networks format file of networks defined for
given server.
generatehosts
Utility for generating number of host entries into database.
import
Reads complete named (BIND) configuration file set and generates
new server and related zones into Sauron.
import-dhcp
Utility for updating existing server using dhcpd configuration;
adds Ethernet addressess for hosts and to builds network map for
the server.
import-ethers
Utility for adding OUI (Ethernet card manufacturer) information
into global table. This table enable Sauron to recognize and display
NIC manufacturer information for hosts.
import-roots
Utility for importing root server hints into Sauron. Sauron has
global table and option for server specific root server lists.
keygen
Utility for generating TSIG keys and master key for protecting key for
Sauron database.
last
Unix 'last' command style utility for listing lastlog information
about Sauron www-interface users.
modgroup
Modifies privileges associated with groups.
modhosts
Simple utility for modifying several hosts at a time in the database.
moduser
Modifies user account privileges and attributes.
runsql
Utility for running SQL code from file into Sauron database.
sauron
Program to for generating named/dhcpd configuration files from Sauron
database for given server.
status
Utility for listing database connection and www-interface status.
Also displays currently logged in users.
update-dhcp-info
Program to be run from crontab that parses dhcpd logs and updates
'last seen by dhcp server' fields for hosts.
SUGGESTED READING
RFC: 952,953,974,1032,1034,1035,1123,1912
--
Timo <tjko@iki.fi>
