How To
ForgeRock Identity Platform
Does not apply to Identity Cloud

How do I install DS (All versions) so that the instance files are separate to the install files?

Last updated Jan 12, 2023

The purpose of this article is to provide information on installing DS so that the instance files (user data) are separate to the install files (binaries). This setup allows you to separate all your backend database files and configuration in a separate file system to your binaries.


2 readers recommend this article

Background

You can install your backend database files and configuration (instance files) in a separate file system to your binaries if required.

Note

Any support patches received from ForgeRock will need to be installed in the classes directory where the instance files are stored rather than the /path/to/ds/classes/ directory if you have this setup.

Installing DS so that the instance files are separate to the install files

To install DS so that the binaries are in /opt/ds and the instance files are in /var/ds, you should do the following:

  1. Download the latest DS zip file from Backstage.
  2. Navigate to the /opt directory (where you want to install DS) and unzip the DS zip file (for example, DS-7.2.0.zip). This creates /opt/ds/...
  3. Run the setup command per Setup hints. You must include the --instancePath option, which should point to the directory where you want the instance files located. For example:
    • DS 7.2 and later: $ ./setup --instancePath /var/ds --serverId server1 --deploymentId $DEPLOYMENT_ID --deploymentIdPassword password --rootUserDN uid=admin --rootUserPassword password --monitorUserPassword password --hostname ds.example.com --adminConnectorPort 4444 --ldapPort 1389 --enableStartTls --ldapsPort 1636 --httpsPort 8443 --replicationPort 8989 --bootstrapReplicationServer rs.example.com:8989 --profile ds-evaluation --acceptLicense
    • DS 7.0.x and 7.1.x: $ ./setup --instancePath /var/ds --serverId server1 --deploymentKey $DEPLOYMENT_KEY --deploymentKeyPassword password --rootUserDN uid=admin --rootUserPassword password --monitorUserPassword password --hostname ds.example.com --adminConnectorPort 4444 --ldapPort 1389 --enableStartTls --ldapsPort 1636 --httpsPort 8443 --replicationPort 8989 --bootstrapReplicationServer rs.example.com:8989 --profile ds-evaluation --acceptLicense
    • DS 6.x: $ ./setup --instancePath /var/ds --ldapPort 1389 --adminConnectorPort 4444 --rootUserDN "cn=Directory Manager" --rootUserPassword password --hostname ds.example.com --acceptLicense

The setup tool creates the /var/ds directory if it does not already exist and populates this directory with all the data and configuration files needed by the server.

See Also

How do I relocate the backend database files in DS (All versions) on to a separate file system?

FAQ: Installing and configuring DS

Installation

File layout

Related Training

N/A

Related Issue Tracker IDs

OPENDJ-3121 (Setup fails to create the lib/extensions directory in the instance.loc path, if a instance.loc file is used.)


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