                   OS/2 port of Bind 8.2.4 - Quick setup guide
                 -----------------------------------------------


*** Requirements ***

  OS/2 Warp 3.0/4.0 or higher.
  TCP/IP.
  HPFS.
  EMX runtime version 0.9c or higher.



*** Additional requirements ***

  syslog2b.zip (ftp://ftp.leo.org/pub/comp/os/os2/leo/tcpip/systools/syslog2b.zip) or
  IBM OS/2 syslogd.



*** Optional requirements ***

  Nolist utility (http://hobbes.nmsu.edu/pub/os2/util/system/nolist2a.zip).



*** Installation ***

1) Copy the following files:

  .\bin\named.exe
  .\bin\named-xfer.exe
  .\bin\ndc.exe
  .\bin\emxkill.exe
  .\bin\ndc2.cmd
  .\bin\xferldr.exe

to a directory in your %PATH%. Optionally, you may also want to copy the following
tools into the same directory:

  .\bin\nslookup.exe
  .\bin\dig.exe
  .\bin\dnsquery.exe
  .\bin\dnskeygen.exe
  .\bin\host.exe
  .\bin\addr.exe
  .\bin\nsupdate.exe
  .\bin\mkservdb.exe

2) Copy all files from the directory .\etc to your %ETC% directory preserving
the same directory structure.

3) Edit %ETC%\named.conf to match your system preferences (directory options).

4) Make sure you have a "SET TEMP=your_temp_directory" line in your config.sys.

5) Reboot your system if required.



*** Running the server ***

  named

  or

  named c:\mptn\etc\named.conf

  or

  ndc -c 127.0.0.1/101 start c:\mptn\etc\named.conf

  or

  ndc2 start



*** Notes about running Bind detached ***


  -Do not run Bind 8.2.4 for OS/2 detached (ex: detach named.exe -c c:\mptn\etc\named.conf)
   if you plan on acting as a slave server. Use ndc.exe if you want Bind 8.2.4 for OS/2 to
   work as a detached-like process. (see below).

  -Each time Bind 8.2.4 for OS/2 is stopped, it leaves an opened OS/2 window (session). To
   avoid this behavior try to use ndc.exe to start named.exe. ndc.exe simulates some
   detaching mechanism so that the remaining opened window closes as soon as you stop Bind
   8.2.4 for OS/2.



*** ndc2.cmd , ndc3.cmd and ndc4.cmd ***


  -ndc2.cmd is a modified copy of ndc.cmd (included in the OS/2 port of Bind 8.1.2). It has
   been modified by Peter Lindeman <peter@lindeman.org> to work only with this release of
   Bind. Now, ndc2.cmd works in conjunction with ndc.exe to start named.exe as a
   detached-like process so any older version of ndc*.cmd will not work fine with this
   port of Bind 8 for OS/2.

  -ndc3.cmd works like ndc2.cmd. However, ndc3.cmd uses a little utility called "Nolist" to
   hide named.exe from the window list.

  -ndc4.cmd is a modified copy of ndc2.cmd made by Voytek Eymont <voytek@sbt.net.au> that
   allows you to add master/slave domains.

  Note: I'm not the official maintainer of the ndc*.cmd utilities. If you have any problems,
  suggestions or questions about them, please contact their respective owners. My skills
  about REXX programming are.... NULL :-)



Please read CHANGES.OS2 file. That's all  ;-)



Antonio Sanmarti <warper@ansaro.com>
July 30 2001


