This manual page is for Mac OS X Server version 10.6.3

Reading manual pages

changeDirData.pl(8)                      BSD System Manager's Manual                     changeDirData.pl(8)

NAME
     changeDirData.pl -- Mac OS X Server OpenDirectory LDAP find/replace tool

SYNOPSIS
     changeDirData.pl [-hiPv] -s server -u diradmin [-p password] -o oldValue -n newValue -r recordType

DESCRIPTION
     changeDirData.pl Searches an Open Directory LDAP server for a specified value, and replaces it.  This
     is particularly useful for bulk changing record values when a server hostname or ip number changes.

     changeDirData.pl should be run against the Open Directory master -- not an Open Directory Replica, but
     the script itself can be run from any machine on the network.

     It is highly recommended that you make a backup of your directory data (via Server Admin or slapconfig)
     before making bulk changes.

OPTIONS
     The following options are available:

     -h    prints a usage statement and exits

     -i    The find and replace operation will be done case insensitively.  mysearchstring will match not
           only mysearchstring, but also  MYSEARCHSTRING and mYsearchSTring

     -v    prints more status information as the script runs

     -s server
           the DNS or IP address of the OD LDAP server

     -u username
           Username for a directory administrator on the LDAP server

     -o oldValue
           the value to search for and replace.

     -n newValue
           the value that will replace the oldValue

     -r recordType
           comma separated list of record types.  For all record types, use "all".  The list of valid record
           types is: users, groups, people, mounts, computers, augments, autoserversetup, computer_lists,
           computer_groups, computer_lists, printers, places, locations, maps, presets_computers, pre-sets_computer_groups, presets_computer_groups,
           sets_computer_groups, presets_users, presets_groups, presets_computer_lists

USAGE
     Although .Nm can be used to find and replace any string in any attribute of  your OD LDAP server, it is
     particularly useful for bulk changing references (such as home directory paths, email addresses, share-points, sharepoints,
     points, etc.)  to your server when its IP or hostname changes.  .Nm should be run after  the changeip
     command has been run on the server that is changing it's hostname/IP.  Note: it is highly recommended
     that you backup your Open Directory data via Server Admin or slapconfig before making bulk changes to
     your directory.

EXAMPLES
     Replace all occurrences in all record types of "blue" with "red" in the LDAP server hosted at
     dirserv.example.com:

     changeDirData.pl -s dirserv.apple.com -u diradmin -o blue -n red -r all

     Replace all occurrences of "oldserver.example.com" with "newserver.apple.com" case-insensitively on
     only user and group records  in the LDAP server hosted at dirserv.example.com:

     changeDirData.pl -i -s dirserv.apple.com -u diradmin -o oldserver.example.com -n newserver.apple.com -r
     users,groups

SEE ALSO
     slapconfig(8) changeip(8)

Mac OS X Server                               11 December 2008                               Mac OS X Server