home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / web / arcweb / InetDB / ReadMe1st < prev    next >
Encoding:
Text File  |  1995-10-05  |  4.7 KB  |  153 lines
  1.  
  2.  
  3. INetDB - Cacheing Resolver
  4. --------------------------
  5.  
  6.    Copyright (c) 1994 Adam Goodfellow
  7.  
  8. This software is in part based upon source that is 
  9.  
  10.    Copyright (c) 1985, 1988 Regents of the University of California.
  11.    All rights reserved.
  12.   
  13.  
  14. ---------------------------------
  15.  
  16. How to install
  17. ==============
  18.  
  19. You CANNOT use this software with KA9Q. You require either Acorn TCP/IP
  20. release 2 or 4 or FreeNet.
  21.  
  22. If you have FreeNet, then you should already have this module and
  23. have configured it.  See !FreeNet.Docs.Resolver for more details.
  24.  
  25.  
  26. For Acorn !Internet:
  27.  
  28. 1) Extract the complete InetDB directory to your hard disc.
  29.  
  30. 2) Read the file called 'Resolver'.  If you don't understand what
  31.    this file is telling you to do, read the section at the end
  32.    of this file instead.
  33.  
  34. 3) Edit both of the files inside the 'files' subdirectory (resboot
  35.    and resconf) as per the instructions in 'Resolver'.
  36.    YOU CANNOT USE THEM WITHOUT EDITING THEM APPROPRIATELY FOR YOUR
  37.    MACHINE.  The bits you need to edit are:  All of resboot; the
  38.    domain and nameserver lines in resconf.
  39.    
  40. 4) Copy InetDB module into !Internet.RM directory.
  41.  
  42. 5) Add a line at the end of your !Internet.files.Startup script
  43.    along the lines of:  RmRun Inet:rm.InetDB
  44.    
  45. 6) Add a line to your !Internet.files.Shutdown script to RMKill InetDB
  46.  
  47. 7) Copy the 'files' directory over the top of !Internet.files directory
  48.    (which will merge the resboot and resconf with your !Internet files)
  49.  
  50. 8) That's it :-)
  51.  
  52.    
  53. If you already have !Internet active, then double-click on the InetDB
  54. module to start it immediately, otherwise next time you start !Internet
  55. the DNS resolver will load automatically.
  56.  
  57.  
  58. ----Alternate instructions from those given in 'Resolver'----
  59.  
  60.  
  61. In the following instructions, lines beginning >> are my comments:
  62. You cannot put these lines in resboot or resconf.
  63.  
  64. The following files are configured for my Risc PC, delenn, which is
  65. in the ecs.soton.ac.uk domain, and has IP address 152.78.67.42
  66. So the full machine name is delenn.ecs.soton.ac.uk
  67.  
  68. !Freeuser.files.resboot (or !Internet.files.resboot for Acorn TCP/IP)
  69.  
  70. $ORIGIN ecs.soton.ac.uk.
  71. >> this line tells the resolver in which domain it is running.
  72. >> Demon users should set it to demon.co.uk.
  73. >>
  74. >> >>>>>>> note the trailing dot at the end of the domain  <<<<<<<
  75. >>
  76. delenn        IN A 152.78.67.42
  77. >>
  78. >> format is: YourHostName IN A YourIpAddress
  79. >> this instructs the resolver to add a permanent entry to the
  80. >> lookup tables for your own host IN A == INternet Address
  81. >>
  82. 42.67.78.152.in-addr.arpa.  IN PTR  delenn
  83. >>
  84. >> format is YourReversedIpAddress.in-addr.arpa. IN PTR YourHostName
  85. >> this is used for looking up the name from the IP address
  86. >> Note that the IP address is specified ***backwards*** here
  87.  
  88.  
  89. !freeuser.files.resconf (or !Internet.files.resconf)
  90.  
  91. domain ecs.soton.ac.uk.
  92. >>
  93. >> should give the same domain name as the $ORIGIN line in resboot
  94. >> but may use the 'search' keyword instead.  Use domain if unsure.
  95. >>
  96. cachesize    16k
  97. >>
  98. >> the size of the cache.  16K is ok.  Given that DNS cache entries
  99. >> timeout after a while anyway, you don't need to increase this
  100. >> (unless you do an awful lot of resolving)
  101. >>
  102. cacheload    resboot rescache
  103. >>
  104. >> leave this line alone.  it tells the resolver to load resboot and
  105. >> then rescache when it first starts (or when you RMReinit InetDB)
  106. >>
  107. cachesave       rescache
  108. >>
  109. >> leave this line alone.  it tells the resolver where to store a
  110. >> a copy of the cache on disc when it exits
  111. >>
  112. retry           1
  113. >>
  114. >> number of retries it will make when it fails to talk to a DNS
  115. >> server.  Probably leave this as 1
  116. >>
  117. timeout         1 1
  118. >>
  119. >> timeout periods for retrying and moving through the list of
  120. >> nameservers.  leave this alone
  121. >>
  122. lookup          file bind
  123. >>
  124. >> when a query is made to InetDB, this tells it to look in
  125. >> inetdbase:hosts first, and then use the DNS protocols (bind).
  126. >> This means that if you put frequently used hosts in your
  127. >> hosts file, they will be resolved faster.
  128. >>
  129. options         ndots 1
  130. >>
  131. >> leave this alone.  this tells the resolver that if it is asked
  132. >> to lookup any host name with more than 1 dot in it, then it
  133. >> should try to look it up as a complete name first, and only
  134. >> if that fails, should it append the 'domain' or 'search' entry
  135. >> to it.
  136. >>
  137. nameserver      152.78.66.136
  138. nameserver      152.78.64.201
  139. nameserver      152.78.128.128
  140. >>
  141. >> these three lines specify the DNS server IP addresses.
  142. >> Format is:  nameserver NameServerIPAddress       They must
  143. >> be specified as addresses.  The three I use are suitable only for
  144. >> my domain (ecs.soton.ac.uk).  Demon users should set these to
  145. >> 158.152.1.222  158.152.1.193  158.152.1.72   respectively.
  146. >> Your service provider/network manager will be able to tell you 
  147. >> these numbers.
  148.  
  149.  
  150. ----
  151. Stewart Brodie
  152. 31st August 1995
  153.