home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / zoneedit.zip / README!.1ST < prev    next >
Text File  |  2002-04-04  |  8KB  |  208 lines
  1. Overview
  2. ========
  3.  
  4. The zoneditor is used for creating BIND zone files. It also maintains
  5. the BIND named.conf file adding and deleting domains edited using the
  6. programme. The programme can also produce a config file for the
  7. secondary server.
  8.  
  9. WARNING:
  10. If you already have a working BIND setup, be sure to back-up your
  11. existing named.conf file before using this programme, as the file
  12. will be overwritten without warning.
  13.  
  14. If you have any zone files you don't want the programme to "mess
  15. with", just make sure they don't have the same extension as the one
  16. you choose in the ZoneEdit.cfg file.
  17.  
  18. If you don't have BIND installed, I have included sample config files
  19. you can use. If you want to use your existing setup see "Adapting an
  20. existing configuration" below. Apart from those files, all you need is
  21. that .exe and .cmd files somewhere in your path.
  22.  
  23.  
  24. Installation
  25. ============
  26.  
  27. To install the programme simply copy the .exe and .cfg file to a
  28. directory of your choise. If you want to use the sample BIND config
  29. files, unzip the etc.zip file in your %ETC% directory
  30. (normally C:\MPTN\ETC\). The only thing you have to change is the
  31. "listen-on" line in named.tpl, where you have to change 11.11.11.11
  32. to whatever address your DNS server has. The programme can create
  33. conf files for the secondary server as well. See "Secondary server"
  34. below.
  35.  
  36. Then the ZoneEdit.cfg file has to be changed to suit your
  37. configuration. I will explain the meaning of the different lines
  38. below.
  39.  
  40. The following lines contain the names of the default nameservers to
  41. be used in your zone files. The primary server is the system you
  42. are running ZoneEdit on. The ip-address in line two should be set to
  43. the address used in your named.tpl.
  44.  
  45.    Default primary nameserver = ns1.domain.com
  46.    ip-address of primary nameserver = 11.11.11.11
  47.    Default secondary nameserver = ns2.domain.com
  48.  
  49. The originhost line should be set to the same as line one.
  50.  
  51.    Default originhost = ns1.domain.com
  52.  
  53. Zonecontact is the e-mail address that should be used to report
  54. errors in your DNS setup. Normally hostmaster@domain is used.
  55.  
  56.    Default zone contact = hostmaster@domain.com
  57.  
  58. The next values are the default refresh and expiry etc. values
  59.  
  60.    Default refresh = 1d
  61.    Default retry = 1h
  62.    Default expire = 4w
  63.    Default ttl = 1d
  64.    Default negative ttl = 1h
  65.  
  66. The next to lines contain the mail servers you normally want to
  67. use.
  68.  
  69.    Default mx1 = mail.domain.com
  70.    Default mx2 = mx2.domain.com
  71.  
  72. The next line can be used if you often need a certain name for
  73. cname records. I use the mail server address, as I normally
  74. create a mail.domain cname record in all domains.
  75.  
  76.    Default cname = mail.domain.com
  77.  
  78. The next to lines contain standard values to be used as adresses
  79. in a and ptr records.
  80.  
  81.    Default ptr ip-address = 1
  82.    Default ip-address = 11.11.11.1
  83.  
  84. The next line is the path to your namedb directory
  85.  
  86.    namedb path = c:\mptn\etc\namedb\
  87.  
  88. The next line contains the extension used for the zone files
  89. created/edited by the programme. I use .zone for those files and
  90. .mzone for the "don't mess with" zones.
  91.  
  92.    Filespec for zone-files = *.zone
  93.  
  94. The next lines can be used to upload config files to the secondary
  95. server after there have been changes made. If you fill-out the
  96. following lines, the programme will upload the file named.conf.sec
  97. to the specified server whenever the configuration has been changed
  98. (domains added/deleted).
  99.  
  100.    FTP-server for sec. conf. file = ftp.domain.com
  101.    FTP username = username
  102.    FTP password = password
  103.  
  104.  
  105. Use
  106. ===
  107.  
  108. To create a domain, I do the following:
  109.  
  110. 1. Click the "Create zone" button
  111. 2. Type-in a domain name and click the "Create" button.
  112. 3. Add the records using the "Add record" buttons.
  113.  
  114.    I normally add these records:
  115.  
  116.    ╧ an "A" record for the webserver (eg. example.com 11.11.11.12)
  117.    ╧ a "CNAME" record for the webserver (eg. www.example.com
  118.      example.com)
  119.    ╧ a "CNAME" record for the mailserver (eg. mail.example.com
  120.      mail.domain.com) - if you have done like me, the mail server
  121.      will be in the drop-down list in the CNAME dialogue.
  122.    ╧ two "MX" records for the domain - to do that simply click the
  123.      "MX" button, and then click the "Save" button in the MX
  124.      dialogue - the default values from the cfg files are
  125.      automatically filled in.
  126. 4. After that I simply click "Save".
  127.  
  128. When you click "Exit" the programme will ask if you want to
  129. restart the name server. If you select "Yes" the command "ndc2
  130. restart" will be executed.
  131.  
  132. If you are creating the main domain file, you will of course have
  133. to add "A" records for the mail servers and the name server itself.
  134.  
  135. Remember that "CNAME" records can only point to "A" records. If you
  136. add a "CNAME" record that points to a name that's itself a "CNAME",
  137. BIND will reject the zone.
  138.  
  139. Also remember that "MX" records "should" only point to an "A"
  140. record. What I do is this: I add the mail servers to the main
  141. domain(s) using "A" records, and then I use one of those names for
  142. all the "MX" records, even if there is a "CNAME" mail server is
  143. defined in the domain. I just add the mail server "CNAME" records,
  144. so that the users can use mail.example.com as their mail-server.
  145.  
  146.  
  147. Adapting an existing configuration
  148. ==================================
  149.  
  150. To use an existing configuration you should first backup your
  151. named.conf and zone files.
  152.  
  153. If you don't want the programme to touch your existing files,
  154. simply choose a different file-extension in the config file.
  155.  
  156. Next you should rename your named.conf to named.tpl. The programme
  157. will then simply include your existing conf file when writing the
  158. new named.conf. The domains created using ZoneEdit will be added
  159. at the bottom of the named.conf file.
  160.  
  161. If you choose to let the programme edit your existing files you
  162. should beware that the "zone file de-cryption engine" is not
  163. perfect (yet), so the files may end up in a FUBAR state after being
  164. edited (don't say you haven't been warned). I haven't had problems
  165. with the files that have been created by the programme in the first
  166. place though.
  167.  
  168.  
  169. Secondary server
  170. ================
  171.  
  172. If you want the programme to create a named.conf file for the
  173. secondary server as well, simply copy the named.conf file of the
  174. secondary server to the primary server (where ZoneEdit is used).
  175. The file should be called named.tpl.sec, and the file created is
  176. called named.conf.sec.
  177.  
  178. If you don't copy/create a named.tpl.sec file the named.conf.sec
  179. file will simply contain the domains created by ZoneEdit. That file
  180. can then be merged into the secondary servers conf file manually.
  181.  
  182. If you specify the ftp server part at the bottom of the cfg file,
  183. the named.conf.sec will be transfered whenever it's changed.
  184.  
  185.  
  186. Bugs
  187. ====
  188.  
  189. As mentioned the ability to read and "de-crypt" zone files from
  190. other sources is not yet perfect, so remember to make a backup!
  191.  
  192. Not all types of records are supported. Currently only SOA, A,
  193. PTR, MX, CNAME and NS records are supported.
  194.  
  195. While editing a zone file, you can only delete one record at a
  196. time - otherwise the programme does strange things. If that
  197. happens, simply click the "Cancel" button, and your zone file
  198. will survive unharmed.
  199.  
  200. I currently host about 30 domains on my name-server, and all the
  201. zone files have been written and maintained using ZoneEdit, so I
  202. would say that it does work...
  203.  
  204. Please send bug reports and complaints to mcs@post5.tele.dk
  205.  
  206. Mikkel C. Simonsen
  207.  
  208.