<?xml version="1.0" encoding="UTF-8"?>

<chapter xml:id='chap-install-gui'

xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en'

xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'

xsi:schemaLocation='http://docbook.org/ns/docbook http://docbook.org/xml/5.0/xsd/docbook.xsd'

xmlns:xlink='http://www.w3.org/1999/xlink'

xmlns:xinclude='http://www.w3.org/2001/XInclude'>

<title>Installing OpenDJ With the QuickSetup Wizard</title>

<indexterm><primary>Downloading OpenDJ</primary></indexterm>

<indexterm><primary>Quick install</primary></indexterm>

<para>If 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.</para>

<xinclude:include href="/shared/itemizedlist-download.xml" />

<para>QuickSetup uses Java WebStart to let you perform an installation of

OpenDJ directory server starting with a click in your web browser, which can

be a great way to try OpenDJ directory server for the first time, or to do a

quick test installation.</para>

<note>

<para>OpenDJ directory server relies on Java 6 or later, so if your browser

picks up an old installation of Java 5 for example, installation can

fail. You might see an application error message such as this:</para>

<mediaobject xml:id="figure-missing-java6">

<alt>Application error due to old Java version</alt>

<imageobject>

<imagedata fileref="images/missing-java6.png" format="PNG" />

</imageobject>

<textobject>

<para>Message showing the browser is unable to launch the application</para>

</textobject>

</mediaobject>

</note>

<para>If the WebStart installation does not work in your browser, copy

the WebStart URL, ending in <literal>QuickSetup.jnlp</literal>, from the

OpenDJ download page. Next, pass the link as an argument to the

<command>javaws</command> command in a terminal window to start the

installer.</para>

<screen>$ export PATH=/path/to/java/bin:$PATH

$ javaws <replaceable>URL-to-QuickSetup-Installer</replaceable></screen>

<para>The WebStart installer corresponds to what you start if you download

OpenDJ-<?eval ${docTargetVersion}?>.zip, unzip the file, and then run

<command>opendj/setup</command> (UNIX), <command>opendj\setup.bat</command>

(Windows), or <command>opendj/QuickSetup.app</command> (Mac OS X).</para>

<para>Java WebStart launches the the QuickSetup wizard, and soon the

Welcome screen appears.</para>

<mediaobject xml:id="figure-quicksetup-welcome">

<imageobject>

<imagedata fileref="images/QuickSetup-welcome.png" format="PNG" />

</imageobject>

<textobject>

<para>The Welcome screen summarizes the setup process.</para>

</textobject>

</mediaobject>

<mediaobject xml:id="figure-quicksetup-license">

<imageobject>

<imagedata fileref="images/QuickSetup-license.png" format="PNG" />

</imageobject>

<textobject>

<para>Accept the license to install OpenDJ directory server if QuickSetup

presents a license text.</para>

</textobject>

</mediaobject>

<mediaobject xml:id="figure-quicksetup-svrconf">

<imageobject>

<imagedata fileref="images/QuickSetup-svrconf.png" format="PNG" />

</imageobject>

<textobject>

<para>In the Server Settings screen that the default ports

are 389 or 1389 for LDAP, 4444 for administrative access.</para>

</textobject>

</mediaobject>

<mediaobject xml:id="figure-quicksetup-replopts">

<imageobject>

<imagedata fileref="images/QuickSetup-replopts.png" format="PNG" />

</imageobject>

<textobject>

<para>You can replicate data for high availability through the

Topology Options screen.</para>

</textobject>

</mediaobject>

<mediaobject xml:id="figure-quicksetup-gendata">

<imageobject>

<imagedata fileref="images/QuickSetup-gendata.png" format="PNG" />

</imageobject>

<textobject>

<para>You can generate test data as part of server setup in the Directory

Data screen.</para>

</textobject>

</mediaobject>

<mediaobject xml:id="figure-quicksetup-jvmopts">

<imageobject>

<imagedata fileref="images/QuickSetup-jvmopts.png" format="PNG" />

</imageobject>

<textobject>

<para>For a real installation, you can adjust JVM parameters for

your server, for example to allow OpenDJ to use more memory.</para>

</textobject>

</mediaobject>

<mediaobject xml:id="figure-quicksetup-review">

<imageobject>

<imagedata fileref="images/QuickSetup-review.png" format="PNG" />

</imageobject>

<textobject>

<para>You can opt to start your server when setup completes.</para>

</textobject>

</mediaobject>

<mediaobject xml:id="figure-quicksetup-finished">

<imageobject>

<imagedata fileref="images/QuickSetup-finished.png" format="PNG" />

</imageobject>

<textobject>

<para>Click the Launch Control Panel button to check your newly

installed server.</para>

</textobject>

</mediaobject>

<mediaobject xml:id="figure-quicksetup-control-panel">

<imageobject>

<imagedata fileref="images/OpenDJ-Control-Panel.png" format="PNG" />

</imageobject>

<textobject>

<para>OpenDJ Control Panel offers basic administration capabilities.</para>

</textobject>

</mediaobject>

<itemizedlist>

<para>To launch OpenDJ Control Panel again later, you can run one of the

following, depending on your host system.</para>

<listitem>

<para>(Mac OS X) <command>opendj/bin/ControlPanel.app</command></para>

</listitem>

<listitem>

<para>(UNIX) <command>opendj/bin/control-panel</command></para>

</listitem>

<listitem>

<para>(Windows) <command>opendj\bat\control-panel.bat</command></para>

</listitem>

</itemizedlist>

</chapter>