home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / dsreps.exe / DSREPS.TXT < prev   
Text File  |  1994-06-21  |  9KB  |  200 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              DSREPAIR.NLM 2.01 for NetWare 4.0x
  5. DOCUMENT ID:        TID015613
  6. DOCUMENT REVISION:  B
  7. DATE:               10JUN94
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         DSREPS.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. NetWare 4.01
  14.  
  15. ABSTRACT:
  16.  
  17. This file contains the latest version of DSREPAIR.NLM 2.01 for NetWare 4.0x.
  18.  
  19. ------------------------------------------------------------------------------
  20. DISCLAIMER
  21. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  22. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  23. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  24. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  25. ------------------------------------------------------------------------------
  26.  
  27. SYMPTOM
  28.  
  29. Earlier versions of DSREPAIR did not work with levels of DS.NLM above 296.
  30.  
  31. SOLUTION
  32.  
  33. Implement DSREPS.EXE containing DSREPAIR.NLM 2.01, which supports versions
  34. 290, 291, 296 and versions later than 296.
  35.  
  36. Self-Extracting File Name:  DSREPS.EXE     Revision:  A
  37.  
  38. Files Included     Size     Date      Time
  39.  
  40. \
  41.   DSREPR.TXT         (This File)
  42. DSREPAIR.NLM      53025   05-16-94    9:16a
  43.  
  44. Installation Instructions:
  45.  
  46. 1. Copy DSREPAIR.NLM to the SYS:SYSTEM subdirectory of the server on which it
  47. will be run.
  48.  
  49. 2. At the console prompt of the file server, type the following command:
  50.           LOAD DSREPAIR
  51.  
  52. Solution Specifics:
  53.  
  54. RELEASE NOTES
  55.  
  56. This version of DSREPAIR has been enhanced to allow the editing of replica
  57. rings.  This README describes this editing and gives examples of how to use
  58. DSREPAIR to correct the errors.
  59.  
  60. Normal partitioning operations should be done with client utilities NWADMIN or
  61. PARTMGR.  This feature should only be used when the MASTER replica of a
  62. partition has been lost because of server/hardware failure and the server will
  63. be reinstalled into the NetWare Directory Services Tree.
  64.  
  65. Caution should be used when changing a SECONDARY to a MASTER.  If a server
  66. containing a SECONDARY is changed to a MASTER and the server containing the
  67. original MASTER is brought back up, there is a possibility that the partition
  68. will have two MASTERS.
  69.  
  70. Attempting to use older version of DSREPAIR to designate a new master replica
  71. when the master replica has been lost, and the replica is in a split or join
  72. state, creates other errors.
  73.  
  74. *** WARNING ***
  75.  
  76. YOU MUST BE SURE YOU ARE USING THE CORRECT VERSION OF DSREPAIR!
  77.  
  78. Version 2.01 or later can be identified by the following message on the top of
  79. the main screen when the NLM is loaded at the server console:
  80.  
  81. NetWare 4.02 NetWare Directory Services Repair Utility
  82.  
  83. Item 4 in the options menu has been enhanced to resolve a problem that occurs
  84. in replica rings for partitions.
  85.  
  86. To invoke the option, select item 4 under the options menu.
  87.  
  88. Start the repair in the normal way by selecting "2" in the main menu.
  89.  
  90. When the DIB (local database on this server) repair has completed, the ring
  91. repair menu will appear.  It will list all replica root objects stored on this
  92. server.
  93.  
  94. This includes types of replicas; MASTER, SECONDARY, READ-ONLY, and
  95. SUBORDINATE.  You do not see the SUBORDINATE type from client utilities, such
  96. as PARTMGR.
  97.  
  98. It is preferred to only change a SECONDARY or READ-ONLY replicas to be a
  99. MASTER replica.  Changing a SUBORDINATE to a MASTER will cause all objects in
  100. the replica to become UNKNOWN.
  101.  
  102. Each replica is assigned a unique number on the left side of the screen. If
  103. there are more replicas than can be displayed on the first screen, you will be
  104. prompted to press a key to see the next screen, and this continues until all
  105. the replicas have been displayed.
  106.  
  107. You are prompted to select a replica by keying in the number of the replica
  108. that has been displayed.  If the replica you want to use is on a previous
  109. screen, you must remember the number it was assigned.  You can key in the
  110. replica number of the replica that you want to work on or "0" (zero) to exit
  111. the replica ring edit procedure and continue with the repair.
  112.  
  113. When you select a replica, you are prompted for the following operation:
  114.  
  115. 1)   Change the replica type on this server to a MASTER replica.
  116.  
  117. This option is used to select a new master replica for a partition that has
  118. somehow lost the master replica.  The master replica could have been lost
  119. because the server that contained it has been uninstalled from the NetWare
  120. Directory Services Tree with INSTALL.NLM or the server may have been damaged
  121. or destroyed.
  122.  
  123. Without a MASTER replica, partition operations, such as split and join, cannot
  124. be performed, because the client utilities first contact the MASTER replica of
  125. the partition to schedule these operations.
  126.  
  127. In this case, selecting the option to change the replica type to MASTER will
  128. set this server (the one running the NLM) as the MASTER replica in the replica
  129. ring (the list of all servers that contain replicas of the partition).
  130.  
  131. If you want to set some other server that has a replica of the partition as
  132. the master, then you will need to run DSREPAIR on that server and perform the
  133. operation there.
  134.  
  135. After changing a SECONDARY or READ-ONLY, there will be confirmation on the
  136. screen that THIS server was found in the replica ring and that it has been
  137. changed to type MASTER.  If another server is found in the replica ring that
  138. had been the MASTER, it is changed to a SECONDARY.
  139.  
  140. Another possible MASTER failure is that all the servers containing a replica
  141. of the partition have been lost.  This includes the case where there was only
  142. one replica of the partition and that server has been lost.
  143.  
  144. When this happens, there may still be SUBORDINATE replicas stored on servers
  145. in the NetWare Directory Services Tree.  You will see the partition with the
  146. client utilities; however, when you try a partition operation it will fail,
  147. and when you try to view the servers that contain replicas of the partition,
  148. none will be displayed, because the client utilities do not show servers with
  149. SUBORDINATE type partition roots.
  150.  
  151. When this type of failure occurs, there is a replica ring of SUBORDINATE
  152. reference partition roots for the partition; however, no real replicas of the
  153. partition exist.  Because no replicas exist, there are no copies of the
  154. objects, their properties, or their data left in the NetWare Directory
  155. Services tree.
  156.  
  157. There may, however, be external reference objects subordinate to the
  158. SUBORDINATE reference partition roots that contain the names of the objects. 
  159. These external reference objects were created on these servers because they
  160. needed object IDs to grant rights to the file system for these objects.
  161.  
  162. In this case, and ONLY this case, you need to change a SUBORDINATE reference
  163. to a MASTER replica.  When you select this option you are alerted on the
  164. screen that you will have to run DSREPAIR again on this server.  This is
  165. because the subordinate reference objects that were contained by the
  166. SUBORDINATE replica are now subordinate to a MASTER replica.
  167.  
  168. This is an illegal condition in the NetWare Directory Services database.  When
  169. DSREPAIR runs again, it will change the external reference objects to real
  170. objects with a base class of "unknown."  Be aware that DSREPAIR will generate
  171. a lot of errors on the objects in this replica when this takes place.
  172.  
  173. At this point, you have a MASTER replica of the partition, and it contains
  174. some but probably not all of the objects that were in the original replica. 
  175. However, these objects all have the object class of UNKNOWN, and they have no
  176. properties or data.
  177.  
  178. You can restore the replica from a tape drive with SMS, which will restore all
  179. the properties and data for these objects, or to clean up the tree, delete all
  180. the objects in the replica.  Then join the partition root object with the
  181. parent partition, which changes the object from a partition root to just a
  182. container, and then delete the container object.
  183.  
  184. You should always log the output of dsrepair to a log file, and check the log
  185. file after the repair to see if objects in replicas have been damaged.  If so,
  186. the objects have been repaired or deleted in the LOCAL DATABASE ONLY.  Further
  187. operations, such as removing the damaged replica from the server and
  188. reinstalling it again to replace the damaged objects with a good copy may be
  189. necessary.
  190.  
  191. _Verified by customer
  192. _Verified by Novell
  193.  
  194. ----------------------------------------------------------------
  195. Any trademarks referenced in this document are the property of their
  196. respective owners.  Consult your product manuals for complete trademark
  197. information.
  198. ----------------------------------------------------------------
  199.  
  200.