How do I rename my tree?

(Last modified: 07Jul2005)

This document (10021052) is provided subject to the disclaimer at the end of this document.

goal

symptom

How do I change my tree name?

fact

Novell NetWare 6.0

Novell NetWare 5.1

Novell NetWare 5.0

Novell eDirectory 8.7.3 for All Platforms

fix

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 disalbe trace when you are done

note

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.

document

Document Title:	How do I rename my tree?
Document ID:	10021052
Solution ID:	1.0.38241490.2393741
Creation Date:	04Nov1999
Modified Date:	07Jul2005
Novell Product Class:	NetWare Novell eDirectory

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.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.