TECHNICAL INFORMATION DOCUMENT

TITLE:              dnssetup - Domain Name Server Utility
DOCUMENT ID:        TID300154
DOCUMENT REVISION:  B
DATE:               25JAN95
ALERT STATUS:       Yellow
INFORMATION TYPE:   Symptom Solution
README FOR:         DNS

PRODUCT and VERSION:
UnixWare 1.1

ABSTRACT:

The dnssetup file contains - Domain Name Server Configuration
Utility for UnixWare 1.1 and 2.0. 

Note:  This supplement is NOT SUPPORTED.  It is provided "AS-IS" to
       knowledgeable users as a courtesy.

SYMPTOM

Users have requested a utility to help configure Domain Name Server for
UnixWare 1.x and 2.x.  

SOLUTION

DATATYPE: file

1.  Download the dnssetup.tar and dns.txt files to the /tmp directory
    on your machine.

2.  Expand the dnssetup.tar file into the /tmp directory using the following
    commands from a terminal window of the UNIX command line:

     $ cd /tmp
     $ tar xvf {path_to_file}/dnssetup.tar

This will give you dnssetup and help.txt files in your /tmp directory.

3.   Read the release notes contained in this file.

4.   Now become root, move the dnssetup and help.txt files into /usr/bin and
     make dnssetup executable using the following commands:

     $ su
     # mv help.txt /usr/bin
     # mv dnssetup /usr/bin
     # chmod +x /usr/bin/dnssetup

5.    To execute the program simply type: 

     dnssetup [enter]

Solution Specifics:

General Description:

These release notes acquaint you with the contents of dnssetup.tar.  
The dnssetup utility allows users to setup their UnixWare 1.x or 2.0 
systems to be a domain name server.  Although the utilitiy will use 
and preserve information from an existing named.boot file, it is always 
recommended to backup this file and files in /var/named (if they exist) 
prior to running dnssetup.  Most problems related to setting up DNS on 
UnixWare are related to syntax errors.  This utility should considerably 
reduce these errors.  The utility also makes it easy to maintain an 
existing DNS.

New Features:

No new features.

Software Notes and Recommendations:

This utility was designed to work on any 1.x or 2.0 AS.  The utility will only
work on a PE with the  the Personal Utilities installed.  The program relies
heavily on the awk, grep, and nawk commands.

If you choose to remove (un-install) dns.tar and restore your system to its
original condition, please do the following.

mv /etc/resolv.old /etc/resolv.conf
mv /etc/inet/named.boot.old /etc/inet/named.boot
ps -ef | grep in.named
record the PID for the in.named process
kill -1 <PID>
/usr/sbin/in.named (if the system will still be a DNS)