|Skip Navigation Links|
|Exit Print View|
|Oracle Fusion Middleware Command-Line Usage Guide for Oracle Unified Directory 11g Release 1 (11.1.1)|
The list-backends command displays information about the available back ends.
This command is not supported for the proxy.
The list-backends command can be used to obtain information about the back ends defined in a directory server instance. Back ends are responsible for providing access to the server database.
The list-backends command has three modes of operation:
No options. When invoked with no options, display the back-end IDs for all back ends configured in the server, along with the base DNs for those back ends.
With backend ID. When used with the --backendID, list all of the base DNs for the back end with the specified back-end ID.
With baseDN. When used with the --baseDN option, list the back-end ID of the back end that should be used to hold the entry with the given DN and also indicate whether that DN is one of the configured base DNs for that back end.
The following are available for use but are not required. The list-backends command accepts an option in either its short form (for example, -b baseDN) or its long form equivalent (for example, --baseDN baseDN).
-b, --baseDN baseDN Specify the base DN from which the list-backends command should list the back-end ID. The option also indicates whether the specified DN is a baseDN for that back end.
-n, --backendID backendID Specify the back-end ID from which the command should display the associated base DN. This option can be used multiple times to display the base DNs for multiple back ends.
-?, -H, --help Display the command usage information and exit immediately without taking any other action.
-V, --version Display the directory server version information and exit rather than attempting to run this command.
The following examples show how to use the directory server commands. See System Requirements and Certification in Oracle Fusion Middleware Installation Guide for Oracle Unified Directory for more information.
Example 2-29 Listing the Current Back Ends
The following command lists the current back ends on the directory server:
$ list-backends Backend ID Base DN ---------- ----------------- backup cn=backups config cn=config monitor cn=monitor schema cn=schema tasks cn=tasks userRoot dc=example,dc=com
Example 2-30 Listing the Back-end ID
The following command lists the back-end ID on the directory server:
$ list-backends --backendID monitor Backend ID Base DN ---------- ---------- monitor cn=monitor
Example 2-31 Listing the Base DN
The following command lists the base DN on the directory server:
$ list-backends --baseDN cn=backups The provided DN 'cn=backups' is a base DN for the back end 'backup'
An exit code of 0 indicates that the operation completed successfully. An exit code of 1 indicates that an error occurred during processing.
UNIX and Linux: instance-dir/OUD/bin/list-backends