How do I install DS (All versions) so that the instance files are separate to the install files?
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:
- Download the latest DS zip file from Backstage.
- 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/...
- 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
Related Training
N/A