Installing OpenDJ With a Graphical InstallerDownloading OpenDJQuick installIf you want only to try OpenDJ server software, and you do not plan to
store any real or important data that you want to keep, then read only this
chapter, or just try out installation without reading any further.Installing OpenDJ With the QuickSetup Wizard
The OpenDJ QuickSetup wizard provides a graphical user interface
for installing OpenDJ directory server.
To begin installation, download OpenDJ-${docTargetVersion}.zip,
unzip the file,
and then run the
setup command,
opendj/setup (UNIX),
opendj\setup.bat (Windows),
or opendj/QuickSetup.app (Mac OS X).
If your environment picks up an old installation of Java,
installation can fail.
You might see an application error due to an old Java version.
If your default Java environment is not appropriate,
set OPENDJ_JAVA_HOME
to the path to the correct Java environment,
or set OPENDJ_JAVA_BIN
to the absolute path of the java command.
The latter environment variable is useful for example
if you have both 32-bit and 64-bit versions of the Java environment installed,
and want to make sure you use the 64-bit version.
The QuickSetup wizard presents the following screens:
Welcome: summarizes the setup process
and indicates the minimum required Java version
License: presents the license agreement to accept
before installing OpenDJ software
Server Settings: prompts for basic server settings
including installation path, host name, port numbers, secure connections,
and credentials for the directory superuser
(default bind DN: cn=Directory Manager)
Topology Options: prompts for data replication options
including whether this server is part of a replication topology,
and if so the port number and security settings for this server,
as well as the connection settings for a remote replica if available
Directory Data: allows you to import or to generate
LDAP directory data as part of the setup process
This screen also allows you to select the backend type for data storage.
Runtime Options: allows you to adjust
JVM settings as part of the setup process,
for example to allow OpenDJ to use more memory if necessary
Review: presents current selections
so that you can check everything is correct before running setup,
with the option to start OpenDJ directory server after setup completes
Finished: summarizes how setup completed,
with the option to launch the OpenDJ Control Panel
shows the top-level window with status information.
OpenDJ Control Panel helps to manage directory data, LDAP schema, indexes,
monitoring, and JVM runtime options through a graphical user interface.
OpenDJ Control PanelOpenDJ Control Panel offers basic administration capabilities.Installing OpenDJ From the Windows Installer Package
You can start installing OpenDJ directory server on Windows systems
from the Windows installer package,
OpenDJ-${docTargetVersion}.msi.
Windows installer (.msi) packageTo Install OpenDJ From the Windows Installer Package
Installing OpenDJ directory server by using the Windows installer package
is a two-stage process.
First, you install the files by using the Windows installer package wizard.
Second, you configure OpenDJ by using the setup command.
Prevent anti-virus and intrusion detection systems from interfering
with OpenDJ directory server.
Install OpenDJ files in one of the following ways.
Double-click the Windows installer package,
OpenDJ-${docTargetVersion}.msi,
to start the install wizard.
In the Destination Folder screen, set the folder
where the wizard installs OpenDJ directory server files.
The default location is under Program Files on the system drive.
For example if the system drive is C:, the default location is
C:\Program Files (x86)\OpenDJ\,
as the native executable is a 32-bit application,
though you can run OpenDJ directory server
with a 64-bit Java environment.
Use the Microsoft msiexec.exe command
to install the files.
The following example installs OpenDJ directory server files under
C:\OpenDJ-${docTargetVersion},
writing an installation log file, install.log,
in the current folder.
C:\>msiexec /i OpenDJ-${docTargetVersion}.msi /l* install.log /q OPENDJ=C:\OpenDJ-${docTargetVersion}
Start the installation.
When installation is finished, OpenDJ directory server files
are found in the location you specified as Destination Folder.
You must still run the setup command
before you can use OpenDJ directory server.
Browse to the Destination Folder,
and double-click the setup command
to start the OpenDJ QuickSetup wizard
and following the instructions on screen
as described in .
Starting OpenDJ Control Panel
You might close OpenDJ Control Panel,
or decide to start it later after closing the QuickSetup wizard.
To launch OpenDJ Control Panel again later, run the
control-panel command.
Depending on your host system, this command is one of the following.
(Mac OS X) /path/to/opendj/bin/ControlPanel.app(UNIX) /path/to/opendj/bin/control-panel(Windows) C:\path\to\opendj\bat\control-panel.bat