ldif-diff

Description

Compare the contents of two files containing LDIF entries. The output will be an LDIF file containing the add, delete, and modify change records needed to convert the data in the source LDIF file into the data in the target LDIF file.

This tool works best with small LDIF files because it reads the entire contents of the source and target LDIF files into memory so they can be quickly compared. If you encounter an out of memory error while running the tool, you may need to increase the amount of memory available to the JVM used to invoke it.

The amount of memory available to the JVM may be customized by invoking the JVM with the '-Xms' and '-Xmx' arguments (which specify the initial and maximum amounts of memory that it may use, respectively). These arguments should be immediately followed (without any intervening space) by an integer and a unit to specify the amount of memory that may be used. The unit may be either 'm' to indicate that the size is in megabytes, or 'g' to indicate that it is in gigabytes. For example, '-Xms512m' indicates that the JVM should be given an initial heap size of 512 megabytes, while '-Xmx2g' indicates that it should be given a maximum heap size of two gigabytes.

When invoking the ldif-diff tool included in the installation of a Ping Identity server product, you may edit the config/java.properties file to specify the arguments to use when invoking the JVM. After modifying the file, run the dsjavaproperties tool to ensure that those changes will be used for subsequent tool invocations.

Examples

ldif-diff --sourceLDIF actual.ldif --targetLDIF desired.ldif \
     --outputLDIF diff.ldif

ldif-diff --sourceLDIF actual.ldif --targetLDIF desired.ldif \
     --outputLDIF diff.ldif --includeOperationalAttributes \
     --excludeNoUserModificationAttributes --nonReversibleModifications

Arguments

-V
--version

-H
--help

--help-debug

-s {path}
--sourceLDIF {path}

--sourceEncryptionPassphraseFile {path}

-t {path}
--targetLDIF {path}

--targetEncryptionPassphraseFile {path}

-o {path}
--outputLDIF {path}

--compressOutput

--encryptOutput

--outputEncryptionPassphraseFile {path}

-O
--overwriteExistingOutputLDIF

--changeType {add|delete|modify}

--includeFilter {filter}

--excludeFilter {filter}

--includeAttribute {attributeName}

--excludeAttribute {attributeName}

-i
--includeOperationalAttributes

-e
--excludeNoUserModificationAttributes

--nonReversibleModifications

-S
--singleValueChanges

--stripTrailingSpaces

--schemaPath {path}

--interactive

--propertiesFilePath {path}

--generatePropertiesFile {path}

--noPropertiesFile

--suppressPropertiesFileComment