PingDirectory

Configuration with the dsconfig tool

The Ping Identity servers provide several command-line tools for management and administration. The command-line tools are available in the bin directory for UNIX or Linux systems and in the bat directory for Microsoft Windows systems.

The dsconfig tool is the text-based management tool used to configure the underlying server configuration. The tool has three operational modes:

  • Interactive mode

  • Non-interactive mode

  • Batch mode

The dsconfig tool also offers an offline mode using the --offline option, in which the server does not have to be running to interact with the configuration. In most cases, the configuration should be accessed with the server running in order for the server to give the user feedback about the validity of the configuration.

Each command-line utility provides a description of the subcommands, arguments, and usage examples needed to run the tool. View detailed argument options and examples by typing -- help with the command.

$ bin/dsconfig --help

To list the subcommands for each command:

$ bin/dsconfig --help-subcommands

To list more detailed subcommand information:

$ bin/dsconfig list-log-publishers --help