ForgeRock Identity Platform
Does not apply to Identity Cloud

FAQ: Installing and configuring DS

Last updated Jan 12, 2023

The purpose of this FAQ is to provide answers to commonly asked questions regarding installing and configuring DS.

1 reader recommends this article

Frequently asked questions

Q. Is DS compatible with Oracle Java Development Kit (JDK) 11?

A. Yes, as of DS 6.5, Oracle JDK 11 is supported. You should only use supported versions to prevent compatibility issues.

Q. Where can I download the latest release of DS?

A. The current supported releases of DS are available for download from Backstage.

Q. Where can I find the DS installation requirements?

A. The Release Notes provide the Hardware and Software requirements for installing DS.

See the release notes for the latest version of DS: Requirements.

Q. Can I install DS so that the instance files are separate to the install files?

A. Yes you can. This setup allows you to separate all your backend database files and configuration in a separate file system to your binaries.

See How do I install DS (All versions) so that the instance files are separate to the install files? for further details.

Q. How do I integrate IDM, AM and DS?

A. You should refer to Platform Setup for further information.

Q. Is it possible to clone a copy of an existing DS between servers?

A. You can move DS data between servers and operating systems. Most of the configuration is portable.

The following two aspects of the configuration are not portable:

  • Server certificates - they contain the host name of the system.
  • Replication configuration - this includes the host name and administrative port numbers.

The procedure and considerations are discussed in detail Move a Server and Key Management.

Q. Where can I find available options to install or remove DS?

A. You should refer to the Installation for details on installing or remove DS.

Q. Can I create a new base DN using the command line?

A. Yes you can. It is a two stage process because creating the backend using the command line only creates the backend database and adds its configuration to the instance. It does not create the base entry for you. The backend is only created with the base entry if you do it via the control panel; the control panel is removed in DS 6.

To create a base DN:

  1. Create the backend configuration and database using the dsconfig command. See Creating a Backend for further information.
  2. Add the base DN entry to the backend using the ldapmodify command or import the base DN entry into the backend using the import-ldif command. See Import and Export for further information.

Q. Is there a configuration reference for DS?

A. Yes, the Configuration Reference is provided, which details the configuration components available in DS.

Q. How can I configure my local system to make administering DS server easier?

A. You can eliminate the need to provide defined arguments when using command line utilities by creating a personal tools.properties file to store commonly entered parameters such as bind DN, host name, and port number.

See Default Settings for a tools.properties example.

After saving the changes to your new tools.properties file, perform a query of your suffix as follows:

$ ./ldapsearch "(objectclass=*)"

Which gives an output similar to this (where the example suffix is dc=example,dc=com):

dn: dc=example,dc=com dc: example objectclass: domain objectclass: top

The tools.properties file found in the user’s .opendj directory takes the highest precedence for the executing user. If you need different parameters for different DS instances installed on the same system, create a tools.properties file in the config directory for each individual instance rather than in the user’s directory.

See Also

FAQ: Passwords in DS

FAQ: DS compatibility with third-party products

FAQ: General DS

FAQ: Upgrading DS

Installing and Administering DS





Related Training

ForgeRock Directory Services Core Concepts (DS-400)

Copyright and Trademarks Copyright © 2023 ForgeRock, all rights reserved.