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