Using dsconfig
batch mode
The dsconfig
tool provides a batching mechanism that reads multiple invocations from a file and executes them sequentially. The batch file provides advantages over standard scripting by minimizing LDAP connections and JVM invocations that normally occur with each dsconfig
call. Batch mode is the best method to use with setup scripts when moving from a development environment to test environment, or from a test environment to a production environment. The --no-prompt
option is required with dsconfig
in batch mode.
$ bin/dsconfig --no-prompt \
--hostname host1 \
--port 1389 \
--bindDN "uid=admin,dc=example,dc=com" \
--bindPassword secret \
--batch-file /path/to/sync-pipe-config.txt
If a dsconfig
command has a missing or incorrect argument, the command will fail and stop the batch process without applying any changes to the server. A --batch-continue-on-error
option is available, which instructs dsconfig
to apply all changes and skip any errors.
View the logs/config-audit.log
file to review the configuration changes made to the server, and use them in the batch file. The batch file can have blank lines for spacing, and lines starting with a pound sign (#) for comments. The batch file also supports a "\" line continuation character for long commands that require multiple lines.
PingDataSync also provides a docs/sun-ds-compatibility.dsconfig
file for migrations from Sun/Oracle to PingDataSync machines.