How do I rename my tree when running eDirectory 8.7.3 on NetWare?

  • 7010652
  • 20-Aug-2012
  • 26-Oct-2017

Environment


Novell NetWare 6.0
Novell NetWare 5.1
Novell eDirectory 8.7.3 for All Platforms

 

Situation

How do I change my tree name?
 
Please Note:
The information in this TID pertains to eDirectory 8.7.3 on NetWare.  This version of eDirectory is no longer supported.  For an explanation of how to rename a tree using our current version of eDirectory please refer to section 10.3 in the eDirectory 8.8 SP7 Administration Guide.  This can be found at https://www.netiq.com/documentation/.

Resolution

Before renaming a tree be sure to perform a comprehensive eDirectory health check.  Also be sure to understand the ramifications of renaming a tree for workstations, such as workstation registry entries and login scripts that may include the tree name.

For Netware based trees use one of two options:

1. DSMERGE.NLM

DSMERGE.NLM will allow you to rename your tree. 

Run DSMERGE by typing "DSMERGE" at the server console holding the Master of [Root] partition.  In DSMERGE.NLM there is an option to rename your tree, however, you will need admin rights to [ROOT] to perform this operation.  Make sure that the new name you choose is unique as well.  Furthermore, you might have to change the "PREFERRED TREE" statement on each NetWare client in order for the workstations to log in.  This operation will check all of the other server's addresses and change the tree name in their database as well.

NOTE: If you are using Account Management 2.1 for NT please refer to Moving the Domain Object


2. iManager

Use the "Rename Tree" task in the eDirecory Maintenance section.  For more information refer to the eDirectory documentation section on Merging eDirectory Trees

For Linux or Solaris based trees use one of two options:

 

1. ndsmerge

Use the ndsmerge utility, installed by default, to rename the tree by running the following command on the server with the Master of the [Root] partition:


ndsmerge -r <New Tree Name> <admin ID>


For more information on ndsmerge consult its man pages.


2. iManager

Use the "Rename Tree" task in the eDirectory Maintenance section.  For more information refer to the eDirectory documentation section on Merging eDirectory Trees

For Windows based trees use the "Rename Tree" task in the eDirectory Maintenance section.  For more information refer to the eDirectory documentation section on Merging eDirectory Trees.

After renaming a tree it is a good idea to trigger the Limber process.  Using iMonitor on the Master of [Root] server:

 

1. Enable DSTrace (to observe the results)

Trace Configuration | click the "Clear All" button | Select "Limber" | Click the "Trace On" button

2. Trigger the Limber and Replicaiton processes

Agent Configuration | Agent Triggers | select Limber and Replication | click the "Submit" button

3. Be sure to disable trace when you are done

 

Additional Information

Using client 4.9 or later will allow for contextless login. If the "Enable LDAP Treeless login" is used, in the configuration of the LDAP contextless login, the preferred Tree name is not needed.
 
 
Formally known as TID 10021052