Table of Contents

• Account for newbie
• Pre-install
• Configration before Compile
• Compile
• Install
• Configuration Files

Account for newbie

Name server of this version has capability to manage its oun authority according to its work. `newbie' now has switch user and group id forth and back between root/wheel account and newbie account. If you don't define newbie account, newbie still use root/wheel account for all the time, but this makes larger problem of security. If newbie itself has security hole, it may allow cracker to use newbie's priviledge.

To use newbie account, define account name of newbie in config.h after configuration script, and prepare newbie acount itself, like this in /etc/passwd.

newbie:*:1000:1000:newbie:/etc/newbiedb:/nonexistent

and this in /etc/group

newbie:*:1000:root,doi

I don't think you don't know what each column mean. If you're not sure what those number and colon and characters are, please refer your handy UNIX adiministrator's handbook. Of course, those numbers are example and you may need to change them.

---

Pre-install

You'll need DB 1.85 or DB 1.86 and GNU readline package. Also you'll need bison and flex. Please install them before you install newbie.

To get DB: Sleepycat Software

Configuration before Compile

chdir to src/ directory and type ./configure

but there's few parameters configured well... if you've got problem, please report it to the author.

To configure newbie manually, you can edit Makefile and config.h, produced by configure command.

In Makefile, you can set compile flags to make it optimize or debugging. In config.h, you can set path to some configuration file. For example,

• NDEBUG: disable all debugging functions
• NS_PID_FILE: pid file of nameserver
• NS_CONFIG_FILE: nameserver configuration filename
• NS_MODE_FILE: nameserver mode filename
• RES_CONFIG_FILE: resolver configration filename
• NEWBIE_USER: username of newbie
• NEWBIE_USER_LOGLEVL: loglevel (see syslog(3)) of newbie
• USE_GETPW_DB: flag to use or not to use getpwnam(3) to check username of newbie. Actually, there's problem of DB library inconsistency to use those getpw* functions. I RECOMMEND to undef them.
• MCON_SOCKFILE: unix domain socket file for nconsole command
• MCON_SOCKMODE: unix domain socket file mode. default allows group access.
• USE_IPV6: enable IPv6 UDP/TCP (tested only with hydrangea/Kame stack)
• USE_HSIG: enable hash signature(HSIG) authentication on the dynamic update. (not supported by Linux)
• HSIG_DEFAULTEXPIRE: expire limit of signature -- by seconds
• HKEY_FILE_SUFFIX: secret key file suffix.

There may be options other than them. The clever way is to keep them as is. Please modify only if you're aware what you're doing.

Compile

just type ``make'' in src/ directory. Things will appear in a minute.

Install

Please type ``make install'' in src/ directory.

Configuration Files

You'll need server configuration file and resolver configuration file. By default, server configuration file is ``/etc/newbie.boot'' and resolver configuration file is ``/etc/res_core.conf'' Its names are subject to be renamed in future release, and your modification of config.h.

Sample of configuration files are in sample/ directory. For detailed instruction of configuration file, please follow these links.

• newbie.conf
• res_core.conf

You will want to make newbie serve some primary zone. In newbie nameserver, the name database is slightly different from standards.

Anyway, you must prepare hint zone for root servers at least. To create name database, please follow these links.

• instruction to prepare new zone
• database converter

You may want to prepare shared key pair between server and updater. To make shared key file, please follow these links.

• instruction to make shared key
• signed update with shared key