home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-1.iso / Documents / tech-alerts / 92-1_NI-DupsLoops.ascii < prev    next >
Encoding:
Text File  |  1992-02-01  |  6.1 KB  |  164 lines
  1.  
  2. Following is NeXT Technical Alert 92-1, which supercedes NTA 91-3
  3. (the NetInfo Duplicates and Loops alert).  My next message will be
  4. NeXT mail, with the RTF version of this as an attachment.
  5.  
  6. Key addition in NTA 92-1 over 91-3: a program called "nifix" is now
  7. available for repairing the damage described.
  8.  
  9. Alan M. Marcum
  10. NeXTedge Tech Support
  11. ==============================================================
  12. NeXT Technical Alert 92-1
  13. Supersedes NeXT Technical Alert 91-3
  14.  
  15. Summary
  16.  
  17. A loop in a NetInfo database can be erroneously created; deleting
  18. this loop will destroy the information in the database. One way
  19. loops are created is by destroying erroneous duplicate directories.
  20.  
  21.  
  22. Status
  23.  
  24. This Technical Alert supersedes NeXT Technical Alert 91-3, on the
  25. same topic. In this alert, the problem and preventative measure
  26. described in NTA 91-3 are documented; in addition, a program to
  27. fix this problem is described.
  28.  
  29.  
  30. Description
  31.  
  32. Under various circumstances that can be encountered during normal
  33. operations, duplicate directories can be created in a NetInfo
  34. domain. For example, a subdirectory of /printers might show up in
  35. /machines. This can occur using the high-level manager applications
  36. (such as PrintManager) as well us using other tools.
  37.  
  38. This duplicate entry is benign, unless it's deleted. If this
  39. duplicate entry is deleted a loop will be formed in the database.
  40. When using NetInfoManager, this loop will appear as dir:0 in a
  41. directory. This loop will lead to NetInfo failures and long delays
  42. in retrieving information from NetInfo. If the loop is deleted,
  43. the NetInfo database may be destroyed and you'll have to revert to
  44. a backup copy.
  45.  
  46.  
  47. Preventative Measure
  48.  
  49. A file called checksum is created by netinfod (the NetInfo server
  50. daemon) when it shuts down in a controlled fashion. This checksum
  51. file, one per NetInfo database, is written in the .nidb directory;
  52. its presence tells netinfod to assume that the database is  
  53. consistent.
  54. As a preventative measure, this file can be removed at system
  55. startup time, before netinfod is run; this will force netinfod to
  56. check through the entire database, which will prevent new duplicates
  57. from appearing.
  58.  
  59. Warning: This measure is preventative only. It will not
  60. correct existing loops. If you have a NetInfo database with a loop,
  61. see the section on Corrective Measure, below.
  62.  
  63. This preventative should be applied on each machine that's the
  64. master NetInfo server for a domain, except for machines that serve
  65. only a local domain. Even though these symptoms can appear in any
  66. NetInfo domain, network-wide or otherwise, it's rare to see them
  67. in a machine's local domain. Although it's not a problem to implement
  68. this workaround on any machine, the effort might not be worthwhile
  69. on machines that don't serve a network-wide domain. Here's an
  70. example:
  71.  
  72. Assume you have a network with three machines: master (which is
  73. the master NetInfo server of the root domain), clone (a clone server
  74. for the root domain), and client. The following table describes
  75. which machines serve which domains, and in what capacity. Let's
  76. further assume this is a two-level hierarchy.
  77.  
  78.     Machine        Domain Served    Type of Server
  79.  
  80.     master        /        Master Server
  81.     master        /master        Master Server
  82.     clone        /        Clone Server
  83.     clone        /clone        Master Server
  84.     client        /client        Master Server
  85.  
  86. In this configuration, we recommend applying the workaround to
  87. master, assuming that the local domains for each machine won't be
  88. modified very much. It's not necessary to apply the workaround to
  89. clone: Even though it serves the root domain, it's a clone server
  90. of the domain and thus obtains its authoritative information from
  91. master.
  92.  
  93. To implement the workaround, edit the file /etc/rc. Find the
  94. following lines (the first line shown is number 108 in the standard
  95. /etc/rc file):
  96.  
  97. # Start up the netinfo daemon
  98. if [ -f /usr/etc/nibindd ]; then
  99.     /usr/etc/nibindd && (echo -n ' netinfo')    >/dev/console 2>&1
  100. fi
  101.  
  102. Add a line (shown below in bold), so the above lines look like
  103. this:
  104.  
  105. # Start up the netinfo daemon
  106. if [ -f /usr/etc/nibindd ]; then
  107.     rm -f /private/etc/netinfo/*.nidb/checksum
  108.     /usr/etc/nibindd && (echo -n ' netinfo')    >/dev/console 2>&1
  109. fi
  110.  
  111. Note:  To perform this procedure, you must be logged in as or sued
  112. to root.
  113.  
  114. It's not necessary to reboot the machine; the next time it's shut
  115. down or rebooted, the workaround will be in effect.
  116.  
  117. Note that if you implement this preventative measure, it will take
  118. longer to start up the machines that are network-wide NetInfo
  119. servers than before. It's also much more likely that you'll see
  120. the following message:
  121.  
  122.     The following network error has occurred:
  123.         Cannot find parent NetInfo server, still looking<
  124.         Press 'c' to continue without parent server.
  125.     See your system administrator if you need help.
  126.  
  127. This message is the result of the local domain's netinfod being
  128. unable to communicate with the its parent domain's netinfod. This
  129. is because the parent domain's netinfod is busy checking the
  130. database's consistency, and isn't responding to requests from the
  131. local domain to bind. Wait several minutes before pressing c to
  132. continue.
  133.  
  134.  
  135. Corrective Measure
  136.  
  137. A program called nifix is available that removes, in a benign
  138. fashion, apparent duplicate directories and loops from a NetInfo
  139. domain. This program is available over anonymous FTP from NeXT.COM
  140. [129.18.1.2], in pub/Binaries/nifix.tar.Z. Be sure to retrieve this
  141. file with ftp in binary mode.  Authorized support Customers who do
  142. not have Internet access may obtain a copy of nifix on floppy disk
  143. from NeXT Technical Support, through their normal support channel.
  144.  
  145. The checksum for nifix.tar.Z (the output of the sum command) and
  146. its contents once extracted should be as follows:
  147.  
  148.     rhino% sum nifix.tar.Z nifix/*
  149.     14629     7 nifix.tar.Z
  150.     64307    16 nifix/nifix
  151.     00438     6 nifix/nifix-info.rtf
  152.  
  153. The compressed tar file contains two files: the executable program
  154. nifix, which a UNIX-level command-line utility, and nifix-info.rtf,
  155. a file with documentation on the program. Both of these files are
  156. contained in a directory ./nifix in the tar archive.
  157.  
  158.  
  159. For More Information
  160.  
  161. Contact your NeXT Authorized Support Provider for more information
  162. about this problem.  NeXT Authorized Support Customers should
  163. contact NeXTedge Technical Support with questions.
  164.