TECHNICAL INFORMATION DOCUMENT

TITLE:              dns2x - Domain Name Server Utility
DOCUMENT ID:        TID300154
DOCUMENT REVISION:  A
DATE:               25JAN95
ALERT STATUS:       Yellow
INFORMATION TYPE:   Symptom Solution
README FOR:         DNS2X.TAR 

PRODUCT and VERSION:
UnixWare 1.1
UnixWare 2.0

ABSTRACT:

The dns2x.tar file contains dnssetup - Domain Name Server Configuration 
Utility v3.0 for UnixWare 1.1 with the SDK and all 2.0 systems.  

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

Apply the dns2x.tar file.

Installation Instructions:

DATATYPE: file

1.  Download the dns2x.tar, and dns2x.txt file to the /tmp directory
    on your machine.

2.   Expand the dns2x.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}/dns2x.tar

3.   Read the release notes contained in the dns.txt 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 dns.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 2.0 AS or 1.x sytem with the SDK
loaded.  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>