Using dsconfig in non-interactive mode
The dsconfig
non-interactive command-line mode provides a simple way to make arbitrary changes to the server by invoking it from the command line.
Steps
-
To use administrative scripts to automate configuration changes, run the
dsconfig
command in non-interactive mode.Non-interactive mode is convenient for scripting applications.
If you plan to make changes to multiple configuration objects at the same time, then the batch mode might be more appropriate.
-
Use the
dsconfig
tool to update a single configuration object using command-line arguments to provide all of the necessary information.Example:
The following shows the general format for the non-interactive command line.
$ bin/dsconfig --no-prompt {globalArgs} {subcommand} {subcommandArgs}
The
--no-prompt
argument indicates that you want to use non-interactive mode. The{sub-command}
is used to indicate which general action to perform. The{globalArgs}
argument provides a set of arguments that specify how to connect and authenticate to the PingDirectory server. Global arguments can be standard LDAP connection parameters or SASL connection parameters depending on your setup. For example, using standard LDAP connections, you can invoke thedsconfig
tool, as shown.$ bin/dsconfig --no-prompt list-backends \ --hostname server.example.com \ --port 389 \ --bindDN uid=admin,dc=example,dc=com \ --bindPassword password
-
If your system uses SASL GSSAPI (Kerberos), invoke
dsconfig
as shown.$ bin/dsconfig --no-prompt list-backends \ --saslOption mech=GSSAPI \ --saslOption authid=admin@example.com \ --saslOption ticketcache=/tmp/krb5cc_1313 \ --saslOption useticketcache=true
-
To always display the advanced properties, use the
--advanced
command-line option.The
{subcommandArgs}
argument contains a set of arguments specific to the particular subcommand that you want to invoke.Global arguments can appear anywhere on the command line, including before the subcommand and after or intermingled with subcommand-specific arguments. The subcommand-specific arguments can appear anywhere after the subcommand.