Tivoli Directory Integrator commands

Tivoli Directory Integrator commands
The following IBM Tivoli Directory Integrator commands are available for managing profile data and performing user data synchronization tasks.
Attention: The only supported methods for writing data or modifying data in the Profiles database are:

Use the supplied Profiles Tivoli Directory Integrator assembly lines
Use the Profiles ATOM administrative API
Developing custom assembly lines using the Tivoli Directory Integrator connectors

Writing directly to the Profiles database, including using Tivoli Directory Integrator database connectors to do so, is not supported and can lead to unforeseen consequences including data loss and application malfunction.
Use these commands to manage and work with profile data. The commands are listed in alphabetical order.
Table 1. Tivoli Directory Integrator commands
Command Description
IBM AIX and Linux™: clearLock.sh
Microsoft™ Windows™: clearLock.bat
Deletes the lock file that is generated by the sync_all_dns task.
For more information, see Synchronize LDAP directory changes with Profiles.
AI and Linux: collect_guid_and_source_uid_updates.sh
Microsoft Windows: collect_guid_and_source_uid_updates.bat
Collects each database entry that contains an email value and compares the value of the guid and distinguishedName properties in the Profiles database with the values returned by the LDAP directory. If one or both of the values are not the same, the command writes the UID and the values that are different to the collect_employees.in file.
For more information, see Update Profiles when changing LDAP directory.
AIX and Linux: collect_guid_updates.sh
Microsoft Windows: collect_guid_updates.bat
Collects each database entry containing the distinguishedName property and compares the values of the guid property in the Profiles database with the value returned by mapping the new LDAP values. If the GUID values do not match, the command writes the UID and globally unique ID (GUID) values that are different to the collect_employees.in file.
For more information, see Update Profiles when changing LDAP directory.
AIX and Linux: delete_or_inactivate_employees.sh
Microsoft Windows: delete_or_inactivate_employees.bat
Deletes or inactivates users in the Profiles database.
For more information, see Delete or inactivating users in the Profiles database.
AIX and Linux: dump_photos_to_files.sh
Microsoft Windows: dump_photos_to_files.bat
Reads existing photo files from the Profiles database and stores them on disk. Used in conjunction with the load_photos_from_files command.
For more information, see Populating Profiles with photos.
AIX and Linux: dump_pronounce_to_files.sh
Microsoft Windows: dump_pronounce_to_files.bat
Reads existing pronunciation files from the Profiles database and stores them on disk. Used in conjunction with the load_pronounce_from_files command.
For more information, see Uploading pronunciation files.
AIX and Linux: fixup_tdi_adapters.sh
Microsoft Windows: fixup_tdi_adapters.bat
Adds a reference to the profiles property store to your adapter files when you are defining a custom assembly line to contain the logic used for the delete operation.
For more information, see Customize the logic used for the delete operation.
AIX and Linux: load_photos_from_files.sh
Microsoft Windows: load_photos_from_files.bat
Reads stored photo files from disk and populates the Profiles database with them. Used in conjunction with the dump_photos_to_files command.
For more information, see Populating Profiles with photos.
AIX and Linux: load_pronounce_from_files.sh
Microsoft Windows: load_pronounce_from_files.bat
Reads stored pronunciation files from disk and populates the Profiles database with them. Used in conjunction with the dump_pronounce_to_files command.
For more information, see Uploading pronunciation files.
AIX and Linux: process_draft_updates.sh
Microsoft Windows: process_draft_updates.bat
Synchronizes changes from the Profiles database back to the LDAP directory. The script initializes a daemon process that monitors the Profiles database for updates, formats each update as a DSML request, and the transmits it to a configured DSML server.
For more information, see Synchronize user data between Profiles and the LDAP directory.
AIX and Linux: process_ad_changes.sh
Microsoft Windows: process_ad_changes.bat
Processes changes made to a Microsoft Active Directory LDAP directory and propagates the changes to the corresponding records in the Profiles database repository.
For more information, see Synchronize IBM Tivoli Directory Server and Microsoft Active Directory LDAP changes.
AIX and Linux: process_tds_changes.sh
Microsoft Windows: process_tds_changes.bat
Processes changes made to an IBM Tivoli Directory Server LDAP directory and propagates the changes to the corresponding records in the Profiles database repository.
For more information, see Synchronize IBM Tivoli Directory Server and Microsoft Active Directory LDAP changes.
AIX and Linux: reset_draft_iterator_state.sh
Microsoft Windows: reset_draft_iterator_state.bat
Deletes the value of a database change record number tracked in a persistent field by the process_draft_update task.
For more information, see Synchronize user data between Profiles and the LDAP directory.
AIX and Linux: set_draft_iterator_count.sh
Microsoft Windows: set_draft_iterator_count.bat
Resets the value of a database change record number tracked in a persistent field by the process_draft_update task.
For more information, see Synchronize user data between Profiles and the LDAP directory.
AIX and Linux: sync_all_dns.sh
Microsoft Windows: sync_all_dns.bat
Synchronizes LDAP directory changes with the Profiles database.
For more information, see Synchronize LDAP directory changes with Profiles.
AIX and Linux: update_employees_from_file.sh
Microsoft Windows: update_employees_from_file.bat
Replaces the globally unique identifiers in the Profiles database with the correct values from the LDAP directory.
For more information, see Update Profiles when changing LDAP directory.

Parent topic
Administer Profiles
Related concepts
Manage user data using Tivoli Directory Integrator scripts
Related tasks
Synchronize LDAP directory changes with Profiles
Update Profiles when changing LDAP directory
Delete or inactivating users in the Profiles database
Populating Profiles with photos
Uploading pronunciation files
Customize the logic used for the delete operation
Synchronize user data between Profiles and the LDAP directory
Synchronize IBM Tivoli Directory Server and Microsoft Active Directory LDAP changes

+
Search Tips | Advanced Search

Command	Description
IBM AIX and Linux™: clearLock.sh Microsoft™ Windows™: clearLock.bat	Deletes the lock file that is generated by the sync_all_dns task. For more information, see Synchronize LDAP directory changes with Profiles.
AI and Linux: collect_guid_and_source_uid_updates.sh Microsoft Windows: collect_guid_and_source_uid_updates.bat	Collects each database entry that contains an email value and compares the value of the guid and distinguishedName properties in the Profiles database with the values returned by the LDAP directory. If one or both of the values are not the same, the command writes the UID and the values that are different to the collect_employees.in file. For more information, see Update Profiles when changing LDAP directory.
AIX and Linux: collect_guid_updates.sh Microsoft Windows: collect_guid_updates.bat	Collects each database entry containing the distinguishedName property and compares the values of the guid property in the Profiles database with the value returned by mapping the new LDAP values. If the GUID values do not match, the command writes the UID and globally unique ID (GUID) values that are different to the collect_employees.in file. For more information, see Update Profiles when changing LDAP directory.
AIX and Linux: delete_or_inactivate_employees.sh Microsoft Windows: delete_or_inactivate_employees.bat	Deletes or inactivates users in the Profiles database. For more information, see Delete or inactivating users in the Profiles database.
AIX and Linux: dump_photos_to_files.sh Microsoft Windows: dump_photos_to_files.bat	Reads existing photo files from the Profiles database and stores them on disk. Used in conjunction with the load_photos_from_files command. For more information, see Populating Profiles with photos.
AIX and Linux: dump_pronounce_to_files.sh Microsoft Windows: dump_pronounce_to_files.bat	Reads existing pronunciation files from the Profiles database and stores them on disk. Used in conjunction with the load_pronounce_from_files command. For more information, see Uploading pronunciation files.
AIX and Linux: fixup_tdi_adapters.sh Microsoft Windows: fixup_tdi_adapters.bat	Adds a reference to the profiles property store to your adapter files when you are defining a custom assembly line to contain the logic used for the delete operation. For more information, see Customize the logic used for the delete operation.
AIX and Linux: load_photos_from_files.sh Microsoft Windows: load_photos_from_files.bat	Reads stored photo files from disk and populates the Profiles database with them. Used in conjunction with the dump_photos_to_files command. For more information, see Populating Profiles with photos.
AIX and Linux: load_pronounce_from_files.sh Microsoft Windows: load_pronounce_from_files.bat	Reads stored pronunciation files from disk and populates the Profiles database with them. Used in conjunction with the dump_pronounce_to_files command. For more information, see Uploading pronunciation files.
AIX and Linux: process_draft_updates.sh Microsoft Windows: process_draft_updates.bat	Synchronizes changes from the Profiles database back to the LDAP directory. The script initializes a daemon process that monitors the Profiles database for updates, formats each update as a DSML request, and the transmits it to a configured DSML server. For more information, see Synchronize user data between Profiles and the LDAP directory.
AIX and Linux: process_ad_changes.sh Microsoft Windows: process_ad_changes.bat	Processes changes made to a Microsoft Active Directory LDAP directory and propagates the changes to the corresponding records in the Profiles database repository. For more information, see Synchronize IBM Tivoli Directory Server and Microsoft Active Directory LDAP changes.
AIX and Linux: process_tds_changes.sh Microsoft Windows: process_tds_changes.bat	Processes changes made to an IBM Tivoli Directory Server LDAP directory and propagates the changes to the corresponding records in the Profiles database repository. For more information, see Synchronize IBM Tivoli Directory Server and Microsoft Active Directory LDAP changes.
AIX and Linux: reset_draft_iterator_state.sh Microsoft Windows: reset_draft_iterator_state.bat	Deletes the value of a database change record number tracked in a persistent field by the process_draft_update task. For more information, see Synchronize user data between Profiles and the LDAP directory.
AIX and Linux: set_draft_iterator_count.sh Microsoft Windows: set_draft_iterator_count.bat	Resets the value of a database change record number tracked in a persistent field by the process_draft_update task. For more information, see Synchronize user data between Profiles and the LDAP directory.
AIX and Linux: sync_all_dns.sh Microsoft Windows: sync_all_dns.bat	Synchronizes LDAP directory changes with the Profiles database. For more information, see Synchronize LDAP directory changes with Profiles.
AIX and Linux: update_employees_from_file.sh Microsoft Windows: update_employees_from_file.bat	Replaces the globally unique identifiers in the Profiles database with the correct values from the LDAP directory. For more information, see Update Profiles when changing LDAP directory.