NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: DS411h.EXE; NDS for intraNetWare Update README FOR: DS411H.EXE NOVELL PRODUCTS and VERSIONS: DS NetWare 4.11 DS NetWare IW 4.11 DS NetWare - IWSB411 ABSTRACT: This update contains the following updated files: DS.NLM v5.95, DSREPAIR.NLM v4.53 This update also contains the following files which have not been updated since the previous update kit. DSMERGE.NLM v1.63, DSMAINT.NLM v4.96 This update also contains the following NEW files which have not been previously distributed in this kit. DSVIEW.NLM v1.05, ROLLCALL.NLM v4.10 WARNING: It is required that this update be applied according to the instructions within the DS411H.TXT file! 2/5/98 - File date changed because of readme edits. ----------------------------------------------------------------- DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES ALL REASONABLE EFFORTS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. ----------------------------------------------------------------- ISSUE: IMPORTANT: Please be sure to review the Installation instructions of the DS411H.TXT File as this new version of DS.NLM has a dependant NLM which MUST be present on a sub-directory within the search path for DS.NLM to load. Do NOT use NDS Manager to distribute this update. Please review the installation instructions BEFORE applying this update! Servers running NetWare version 4.11 should be running the latest DS.NLM, currently at version 5.95. The DSRepair.NLM version 4.53 MUST be used on all NetWare version 4.11 servers running DS.NLM version 5.95. Version 5.95 of DS.NLM and version 4.53 of DSREPAIR.NLM supercede all previous versions. Mixed versions of Netware 4.11 Directory Services (DS.NLM) inter- operate completely, but it is strongly recommended that all Netware version 4.11 servers be upgraded to the new version to insure consistency and easier future maintaince. ********************************************************************** Changes and Enhancements to DS.NLM v5.95 ********************************************************************** Support for the following intraNetWare Enhancements have been added to this version: Support for NDS Background Process Status Tracking Support for NetWare for Small Businesses Support for NDS on NT In addition to various corrections to Auditing, NDS Background Processes and abends, the following specific corrections have been made to this version: intraNetWare, or NetWare, file servers running DS.NLM v5.95 (included within this kit) will allow only version 4.53, or higher, of DSRepair.NLM (also included within this kit) to be used. Corrections to handle a -252 error after performing a DSMaint. Modifications to improve handling of NDS Schema Epochs. Corrections for NetWare Auditing to audit static bindery objects. A possible abend condition that could occur if more than 32 Auditors existed and the option to Broadcast Errors to All User was set to no. Correction to prevent specific stack overflows. Enhanced display of year for Year 2000 readiness. This is an optional display enhancement only. It is not required for system stability or the prevention of data corruption. Corrections for the processing of Move Obituaries. Corrections for the processing of Rename Obituaries. Adjusted the containment check rules for external references. Changed the maximum length for the Bindery Context Set parameter to 2048. PLEASE NOTE: A problem has been found with NWPA.NLM which will cause the file server to ABEND if a console command greater than 256 characters is entered. To resolve this issue, obtain NWPA.NLM v2.32D (05/23/1997) or higher. Increased the maximum DSTrace file size allowed to 50Mb. This is set, while TTF is Off, using the command "SET DSTRACE=*M[size in hex]" For example, SET DSTRACE=*M4FFFFF would allow the DSTrace debug file to reach 50Mb maximum. Notify External References was incorrectly reporting -602 under some cirsumstances. Modification to prevent Back-Link Attributes on the [Root] object and sub-ordinate reference partition objects. Enhancement for Merge Tree to prevent the source Master from changing its' name back to the old Tree name. Corrections to Merge Tree processing. NOTE: BEFORE performing a Tree Merge, in an environment where the SOURCE and TARGET NDS Tree's have 35 or more File Servers, it is recommended that the Back-Link attributes of the [Root] object be removed. This can be accomplished by performing the following steps: NOTE: It is not required that the following steps be done in order to Merge two NDS Trees. However, if the SOURCE NDS Tree has a medium to high number of NetWare File Servers, the Merge Tree will process faster if the these steps are taken. NOTE: To obtain the performance increase offered by the modifications to the Merge Tree functionality, these steps should be completed a minumum of 24 hours, prior to initiating the Merge. NOTE: If multiple Merge Trees will be performed, these steps will be performed, these steps must be performed on each SOURCE NDS Tree that will be merged. 1. Upgrade all NetWare File Servers, which hold a copy of the [Root] partition, in the SOURCE NDS Tree, to intraNetWare v4.11 AND DS.NLM version v5.95. 2. Upgrade all NetWare File Servers, which hold a copy of any partition which is an immediate child of the [Root] partition, in either the SOURCE or the TARGET NDS Tree, to the following DS.NLM versions; according the the OS used: intraNetWare DS.NLM v5.95 NetWare v4.10 DS.NLM v5.09 3. Write down the names of the Partitions held by the NetWare File Server holding the MASTER REPLICA of the [Root] Partition, in the SOURCE Tree. Then TEMPORARILY remove them using the NetWare Administration tools. Wait approximately 4 hours, or, until all external reference back-linking activity has completed. 4. Using DSRepair, v4.53 or higher, on the command line of the NetWare File Server holding the MASTER REPLICA of the [Root] partition, in the SOURCE NDS Tree; LOAD DSREPAIR -XK8 5. Select the Advanced Menu Options option; then select the Repair Local Database option. Initiate the database repair by pressing F10. NOTE: DO NOT perform any Move Partition partition operations or rename any Partition's on a partition which is sub- ordinate to the [Root] partition for a minimum of 72 Hours! However, the Tree Merge may be performed. 6. After DSRepair has completed, select the option to Save the local database. 7. At this point, DSRepair has removed the Back-Link attributes from ALL partition root objects on this NetWare File Server. However, since ALL partition root objects, except the [Root] partition, were removed during step 3; the only partition affected would be the [Root] partition. IMPORTANT: If you chose to skip step 3, then NO PARTITIONS, stored on this NetWare File Server, should be renamed for at least 96 hours!!! 8. Exit DSRepair and WAIT 15 minutes. 9. Using DSRepair, check the replica synchronization of the NetWare File Server holding the MASTER REPLICA of the SOURCE NDS Tree, with the Report Synchronization Status menu option. If no errors are being reported, then proceed on to step 10. Otherwise, resolve any reported errors. If you are unable to resolve the errors, please contact Novell Technical Support. 10. Replace ALL partitions which were removed during step #3. Do not proceed until all added replica's are turned on. 11. You are now ready to perform the Tree Merge. ********************************************************************** Changes and enhancements to DSREPAIR.NLM v4.53 ********************************************************************** Corrections in the handling of purging records during the database repair. Modifications to display the full year (Year 2000) when displaying dates. Corrected a problem with the handling of NDS Schema Extentions placed by newer versions of DS.NLM. Backward compatibility issue with 4.10 and DSRepair versions 4.48 and higher. Corrected a problem with v4.45 that would result in partition root objects being mutated into an Unknown class object. Enhancements to the advanced menu option 'Check External References'. Corrected a situation which would cause an abend when importing the schema. Modification to the Import Schema routines to support larger Schema definitions. The DS_REVISION property on external references was being incorrectly deleted. When performing a "Repair all Remote ID's", DSRepair did not check to determine if the escape key was pressed. Enabled the /u command line parameter. The command line operation /RS (to remove a server from the replica ring) writes "not supported" in the log file. The operation to 'Remove Server from the Ring' in the repair menu, has been modified. ********************************************************************** Changes and enhancements to DSMERGE.NLM v1.63 ********************************************************************** No changes have been made to this module. ********************************************************************** Changes and enhancements to DSMAINT.NLM v4.96 ********************************************************************** No changes have been made to this module. This module has been provided for your use. This module is designed to assist in upgrading NetWare File Server to new hardware platforms. For usage information on DSMAINT.NLM, please review the DSMAINT.TXT file included in this update kit. ********************************************************************** Introducing DSVIEW.NLM v1.05 ********************************************************************** This is an un-documented and un-supported NLM which is being provided by Novell Technical Support. An overview of some of the functionality of DSView.NLM is discussed in DSView.TXT. ********************************************************************** Introducing ROLLCALL.NLM v4.10 ********************************************************************** IMPORTANT: Please be sure to review the Installation instructions of the DS411H.TXT File as this new version of DS.NLM has a dependant NLM which MUST be present on a sub-directory within the search path for DS.NLM to load. Do NOT use NDS Manager to distribute this update. Please review the installation instructions BEFORE applying this update! This NLM is required for use by DS.NLM v5.95. This NLM MUST be present, in the SYS:SYSTEM sub-directory, for this version of DS.NLM to load. Self-Extracting File Name: ds411h.exe Files Included Size Date Time ..\ DS411H.TXT (This file) DS411H.TXT 17673 1-12-98 11:26:20 am NDSMGR.EXE 2386158 12-23-97 1:16:32 pm UPDATE.EXE 743635 12-23-97 1:13:08 pm Installation Instructions: These new files are for use with NetWare 4.11. The new files contain numerous enhancements and fixes overall previous versions of the same files. Novell strongly recommends that all NetWare 4.11 customers upgrade their NDS files to these new versions. ********************************************************************** Installation Instructions ********************************************************************** For NetWare 4.11 servers: ** NOTE ** WARNING! If you choose to use versions of NDS Manager, prior to v1.25, to distribute the new version of DS.NLM; please be aware that the versions of NDS Manager, prior to v1.25, ONLY distribute the DS.NLM and not the ROLLCALL.NLM. The ROLLCALL.NLM MUST be present in a sub-directory, within the search path, for DS.NLM to load. If you use a version of NDS Manager, prior to v1.25, to distribute the DS.NLM contained within this kit, it will be neccessary to RCONSOLE to the file servers which which received the new DS.NLM via a version of NDS Manager, prior to v1.25, AND transfer the ROLLCALL.NLM manually. Failure to do so could prevent DS.NLM from loading and thereby prevent Novell Directory Services for NetWare / IntranetWare from being used. Novell Technical Support recommends that you use the procedure described below; or v1.25 of NDS Manager which is contained within this kit. To extract v1.25 of NDS Manager, please run the executable file NDSMGR.EXE. To extract the NDS update kit, please run the executable file UPDATE.EXE. ** NOTE ** Always make a backup copy of original files. 1. Log into the network as ADMIN or a user with rights to the SYS:SYSTEM of the file server. Locate the following files in the SYS:\SYSTEM sub-directory: DS.NLM ROLLCALL.NLM DSREPAIR.NLM DSMERGE.NLM DSMAINT.NLM DSVIEW.NLM You may or may not find all of the files mentioned above, additionally, one or more of the files may be flagged Read-Only. Rename these files to *.OLD. 2. Copy the NLM files provided in this update to the SYS:SYSTEM directory of the NetWare 4.11 file server. 3. At the file server console of the server being upgraded (or using RCONSOLE) toggle to the system console screen. 4. At the system console screen enter the command "SET DSTRACE = *." and press to reload the Directory Services (DS.NLM v5.95) without downing the server. 5. To confirm that the DS.NLM 5.95 is loaded, at the system console screen type MODULES. Scroll through the modules screens and find DS.NLM. The following information, as well as the Novell Copyright and Patent Information should appear as follows: DS.NLM NetWare 4.11 Directory Services Version 5.95 December 5, 1997 6. Repeat the process for each IntranetWare/NetWare v4.11 server in the network, which may be running the older versions. 7. In addition to updating the files on your IntranetWare/NetWare v4.11 file servers; it is also recommended that you update the version of DSREPAIR.NLM that is being used by your NetWare v4.10 file servers. This is neccessary to prevent OLDER versions of DSREPAIR.NLM from incorrectly handling the new NDS Schema definitions which will be introduced by DS.NLM v5.81 and higher. 8. To update the version of DSREPAIR.NLM on your NetWare v4.10 file servers you must log into the network as ADMIN, or as a user with rights to the SYS:SYSTEM of the file server. Locate the following files in the SYS:\SYSTEM sub-directory: DSREPAIR.NLM 8a. Additionally, you may update the following files by locating them, as well. However, DO NOT place the v5.95 DS.NLM on the NetWare v4.10 file server. That DS.NLM version is for IntranetWare/NetWare v4.11 file servers only! DSMERGE.NLM DSMAINT.NLM DSVIEW.NLM 8b. You may or may not find all of the files mentioned above, additionally, one or more of the files may be flagged Read-Only. Rename these files to *.OLD. 9. Copy the NLM files provided in this update to the SYS:SYSTEM directory of the NetWare 4.10 file server. ----------------------------------------------------------------- Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information. -----------------------------------------------------------------