The Directory Server provides a tool, move-subtree, to move a subtree or one entry on one machine to another. The subtree or entry must exist on the source server and must not be present on the target server. The source server must also support the 'real attributes only' request control. The target server must support the Ignore NO-USER-MODIFICATION request control.

Note: The move-subtree tool moves a subtree or multiple entries from one machine to another. The tool does not copy the entries. Once the entries are moved, they are no longer present on the source server.
  • Use the move-subtree tool to move an entry (e.g., uid=test.user,ou=People,dc=example,dc=com) from the source host to the target host.
    $ bin/move-subtree --sourceHost --sourcePort 389 \ 
      --sourceBindDN "uid=admin,dc=example,dc=com" --sourceBindPassword password \ 
      --targetHost --targetPort 389 \ 
      --targetBindDN "uid=admin,dc=example,dc=com" --targetBindPassword password \
      --entryDN uid=test.user,ou=People,dc=example,dc=com