<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Chapter 1. Installing OpenDJ With the QuickSetup Wizard - - OpenDJ Installation Guide</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
<link rel="home" href="index.html" title="OpenDJ Installation Guide" />
<link rel="up" href="index.html" title="OpenDJ Installation Guide" />
<link rel="prev" href="joining-the-community.html" title="4. Joining the Open Identity Platform Community" />
<link rel="next" href="chap-install-cli.html" title="Chapter 2. Installing OpenDJ From the Command Line" />
<link rel="copyright" href="legalnotice.html" title="Legal Notice" />
<meta xmlns="" name="Section-title" content="Chapter 1. Installing OpenDJ With the QuickSetup Wizard" /><script xmlns="" type="text/javascript">
//The id for tree cookie
var treeCookieId = "treeview-1311";
var language = "en";
var w = new Object();
//Localization
txt_filesfound = 'Results';
txt_enter_at_least_1_char = "You must enter at least one character.";
txt_browser_not_supported = "JavaScript is disabled on your browser. Please enable JavaScript to enjoy all the features of this site.";
txt_please_wait = "Please wait. Search in progress...";
txt_results_for = "Results for: ";
</script><link xmlns="" rel="shortcut icon" href="favicon.ico" type="image/x-icon" />
<link xmlns="" rel="stylesheet" type="text/css" href="common/css/positioning.css" />
<link xmlns="" rel="stylesheet" type="text/css" href="common/jquery/theme-redmond/jquery-ui-1.8.2.custom.css" />
<link xmlns="" rel="stylesheet" type="text/css" href="common/jquery/treeview/jquery.treeview.css" /><style xmlns="" type="text/css">
#noscript{
font-weight:bold;
background-color: #55AA55;
font-weight: bold;
height: 25spx;
z-index: 3000;
top:0px;
width:100%;
position: relative;
border-bottom: solid 5px black;
text-align:center;
color: white;
}
input {
margin-bottom: 5px;
margin-top: 2px;
}
.folder {
display: block;
height: 22px;
padding-left: 20px;
background: transparent url(common/jquery/treeview/images/folder.gif) 0 0px no-repeat;
}
span.contentsTab {
padding-left: 20px;
background: url(common/images/toc-icon.png) no-repeat 0 center;
}
span.searchTab {
padding-left: 20px;
background: url(common/images/search-icon.png) no-repeat 0 center;
}
/* Overide jquery treeview's defaults for ul. */
.treeview ul {
background-color: transparent;
margin-top: 4px;
}
#webhelp-currentid {
background-color: #D8D8D8 !important;
}
.treeview .hover { color: black; }
.filetree li span a { text-decoration: none; font-size: 12px; color: #517291; }
/* Override jquery-ui's default css customizations. These are supposed to take precedence over those.*/
.ui-widget-content {
border: 0px;
background: none;
color: none;
}
.ui-widget-header {
color: #e9e8e9;
border-left: 1px solid #e5e5e5;
border-right: 1px solid #e5e5e5;
border-bottom: 1px solid #bbc4c5;
border-top: 4px solid #e5e5e5;
border: medium none;
background: #F4F4F4; /* old browsers */
background: -moz-linear-gradient(top, #F4F4F4 0%, #E6E4E5 100%); /* firefox */
background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#F4F4F4), color-stop(100%,#E6E4E5)); /* webkit */
font-weight: none;
}
.ui-widget-header a { color: none; }
.ui-state-default, .ui-widget-content .ui-state-default, .ui-widget-header .ui-state-default {
border: none; background: none; font-weight: none; color: none; }
.ui-state-default a, .ui-state-default a:link, .ui-state-default a:visited { color: black; text-decoration: none; }
.ui-state-hover, .ui-widget-content .ui-state-hover, .ui-widget-header .ui-state-hover, .ui-state-focus, .ui-widget-content .ui-state-focus, .ui-widget-header .ui-state-focus { border: none; background: none; font-weight: none; color: none; }
.ui-state-active, .ui-widget-content .ui-state-active, .ui-widget-header .ui-state-active { border: none; background: none; font-weight: none; color: none; }
.ui-state-active a, .ui-state-active a:link, .ui-state-active a:visited {
color: black; text-decoration: none;
background: #C6C6C6; /* old browsers */
background: -moz-linear-gradient(top, #C6C6C6 0%, #D8D8D8 100%); /* firefox */
background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#C6C6C6), color-stop(100%,#D8D8D8)); /* webkit */
-webkit-border-radius:15px; -moz-border-radius:10px;
border: 1px solid #f1f1f1;
}
.ui-corner-all { border-radius: 0 0 0 0; }
.ui-tabs { padding: .2em;}
.ui-tabs .ui-tabs-nav li { top: 0px; margin: -2px 0 1px; text-transform: uppercase; font-size: 10.5px;}
.ui-tabs .ui-tabs-nav li a { padding: .25em 2em .25em 1em; margin: .5em; text-shadow: 0 1px 0 rgba(255,255,255,.5); }
/**
* Basic Layout Theme
*
* This theme uses the default layout class-names for all classes
* Add any 'custom class-names', from options: paneClass, resizerClass, togglerClass
*/
.ui-layout-pane { /* all 'panes' */
background: transparent;
border: 1px solid #BBB;
padding: 05x;
overflow: auto;
}
.ui-layout-resizer { /* all 'resizer-bars' */
background: #DDD;
top:100px
}
.ui-layout-toggler { /* all 'toggler-buttons' */
background: #AAA;
}
</style>
<!--[if IE]>
<link rel="stylesheet" type="text/css" href="../common/css/ie.css"/>
<![endif]--><script xmlns="" type="text/javascript" src="common/browserDetect.js">
<!----></script><script xmlns="" type="text/javascript" src="common/jquery/jquery-1.7.2.min.js">
<!----></script><script xmlns="" type="text/javascript" src="common/jquery/jquery.ui.all.js">
<!----></script><script xmlns="" type="text/javascript" src="common/jquery/jquery.cookie.js">
<!----></script><script xmlns="" type="text/javascript" src="common/jquery/treeview/jquery.treeview.min.js">
<!----></script><script xmlns="" type="text/javascript" src="common/jquery/layout/jquery.layout.js">
<!----></script><script xmlns="" type="text/javascript" src="search/l10n.js">
<!----></script><script xmlns="" type="text/javascript" src="search/htmlFileInfoList.js">
<!----></script><script xmlns="" type="text/javascript" src="search/nwSearchFnt.js">
<!----></script><script xmlns="" type="text/javascript" src="search/stemmers/en_stemmer.js">
<!--//make this scalable to other languages as well.--></script><script xmlns="" type="text/javascript" src="search/index-1.js">
<!----></script><script xmlns="" type="text/javascript" src="search/index-2.js">
<!----></script><script xmlns="" type="text/javascript" src="search/index-3.js">
<!----></script></head>
<body>
<noscript>
<div id="noscript">JavaScript is disabled on your browser. Please enable JavaScript to enjoy all the features of this site.</div>
</noscript>
<div id="header"><a href="index.html"><img style="margin-right: 2px; height: 59px; padding-right: 25px; padding-top: 8px" align="right" src="common/images/logo.png" alt=" Documentation" /></a><h1>OpenDJ Installation Guide<br />Chapter 1. Installing OpenDJ With the QuickSetup Wizard
</h1>
<div id="navheader">
<!---->
<table class="navLinks">
<tr>
<td><a id="showHideButton" href="#" onclick="myLayout.toggle('west')" class="pointLeft" tabindex="5" title="Hide TOC tree">Sidebar
</a></td>
<td><a accesskey="p" class="navLinkPrevious" tabindex="5" href="joining-the-community.html">Prev</a>
|
<a accesskey="n" class="navLinkNext" tabindex="5" href="chap-install-cli.html">Next</a></td>
</tr>
</table>
</div>
</div>
<div id="content">
<!---->
<div xml:lang="en" class="chapter">
<div class="titlepage">
<div>
<div>
<h1 class="title"><a id="chap-install-gui"></a>Chapter 1. Installing OpenDJ With the QuickSetup Wizard
</h1>
</div>
</div>
</div><a id="d0e251" class="indexterm"></a><a id="d0e254" class="indexterm"></a><p>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.
</p>
<div xml:lang="en" class="itemizedlist">
<p>Download OpenDJ software from one of the following locations.</p>
<ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem">
<p>The ForgeRock <a class="link" href="http://forgerock.com/download-stack/" target="_blank">Enterprise Downloads</a> page has the latest stable,
supported release of OpenDJ and the other products in the ForgeRock identity
stack.
</p>
</li>
<li class="listitem">
<p>The <a class="link" href="http://forgerock.org/opendj.html" target="_blank">Nightly Builds</a> page posts links to the latest nightly
builds of OpenDJ software. Note that these builds are the working version
from the trunk and are not for use in a production environment.
</p>
</li>
<li class="listitem">
<p>The <a class="link" href="http://forgerock.org/opendj-archive.html" target="_blank">Community Archives</a> page includes stable community
builds for previous releases of OpenDJ software.
</p>
</li>
</ul>
</div>
<p>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.
</p>
<div class="note" style="font-style: italic;">
<table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="common/images/admon/note.png" /></td>
<th align="left">Note</th>
</tr>
<tr>
<td align="left" valign="top">
<p>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:
</p>
<div class="mediaobject" align="center"><a id="figure-missing-java6"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/missing-java6.png" align="middle" height="360" alt="Application error due to old Java version" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-missing-java6.html" target="longdesc">D</a>]</span></div>
</div>
</td>
</tr>
</table>
</div>
<p>If the WebStart installation does not work in your browser, copy
the WebStart URL, ending in <code class="literal">QuickSetup.jnlp</code>, from the
OpenDJ download page. Next, pass the link as an argument to the
<span class="command"><strong>javaws</strong></span> command in a terminal window to start the
installer.
</p><pre class="screen">$ export PATH=/path/to/java/bin:$PATH
$ javaws <em class="replaceable"><code>URL-to-QuickSetup-Installer</code></em></pre><p>The WebStart installer corresponds to what you start if you download
OpenDJ-4.8.1-SNAPSHOT.zip, unzip the file, and then run
<span class="command"><strong>opendj/setup</strong></span> (UNIX), <span class="command"><strong>opendj\setup.bat</strong></span>
(Windows), or <span class="command"><strong>opendj/QuickSetup.app</strong></span> (Mac OS X).
</p>
<p>Java WebStart launches the the QuickSetup wizard, and soon the
Welcome screen appears.
</p>
<div class="mediaobject" align="center"><a id="figure-quicksetup-welcome"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/QuickSetup-welcome.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-welcome.html" target="longdesc">D</a>]</span></div>
</div>
<div class="mediaobject" align="center"><a id="figure-quicksetup-license"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/QuickSetup-license.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-license.html" target="longdesc">D</a>]</span></div>
</div>
<div class="mediaobject" align="center"><a id="figure-quicksetup-svrconf"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/QuickSetup-svrconf.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-svrconf.html" target="longdesc">D</a>]</span></div>
</div>
<div class="mediaobject" align="center"><a id="figure-quicksetup-replopts"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/QuickSetup-replopts.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-replopts.html" target="longdesc">D</a>]</span></div>
</div>
<div class="mediaobject" align="center"><a id="figure-quicksetup-gendata"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/QuickSetup-gendata.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-gendata.html" target="longdesc">D</a>]</span></div>
</div>
<div class="mediaobject" align="center"><a id="figure-quicksetup-jvmopts"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/QuickSetup-jvmopts.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-jvmopts.html" target="longdesc">D</a>]</span></div>
</div>
<div class="mediaobject" align="center"><a id="figure-quicksetup-review"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/QuickSetup-review.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-review.html" target="longdesc">D</a>]</span></div>
</div>
<div class="mediaobject" align="center"><a id="figure-quicksetup-finished"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/QuickSetup-finished.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-finished.html" target="longdesc">D</a>]</span></div>
</div>
<div class="mediaobject" align="center"><a id="figure-quicksetup-control-panel"></a><table border="0" summary="manufactured viewport for HTML img" style="cellpadding: 0; cellspacing: 0;" width="100%">
<tr>
<td align="center"><img src="images/OpenDJ-Control-Panel.png" align="middle" height="360" /></td>
</tr>
</table>
<div class="longdesc-link" align="right"><br clear="all" /><span class="longdesc-link">[<a href="figure-quicksetup-control-panel.html" target="longdesc">D</a>]</span></div>
</div>
<div class="itemizedlist">
<p>To launch OpenDJ Control Panel again later, you can run one of the
following, depending on your host system.
</p>
<ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem">
<p>(Mac OS X) <span class="command"><strong>opendj/bin/ControlPanel.app</strong></span></p>
</li>
<li class="listitem">
<p>(UNIX) <span class="command"><strong>opendj/bin/control-panel</strong></span></p>
</li>
<li class="listitem">
<p>(Windows) <span class="command"><strong>opendj\bat\control-panel.bat</strong></span></p>
</li>
</ul>
</div>
</div><script type="text/javascript" src="common/main.js">
<!----></script><script type="text/javascript" src="common/splitterInit.js">
<!----></script></div>
<div id="sidebar">
<div id="leftnavigation" style="padding-top:3px;">
<div id="tabs">
<ul>
<li><a href="#treeDiv" style="outline:0;" tabindex="1"><span class="contentsTab">Contents</span></a></li>
<li><a href="#searchDiv" style="outline:0;" tabindex="1" onclick="doSearch()"><span class="searchTab">Search</span></a></li>
</ul>
<div id="treeDiv"><img src="common/images/loading.gif" alt="loading table of contents..." id="tocLoading" style="display:block;" /><div id="ulTreeDiv" style="display:none">
<ul id="tree" class="filetree">
<li><span class="file"><a href="preface.html" tabindex="1">Preface</a></span><ul>
<li><span class="file"><a href="pr01s01.html" tabindex="1">1. Who Should Read this Guide</a></span></li>
<li><span class="file"><a href="formatting-conventions.html" tabindex="1">2. Formatting Conventions</a></span></li>
<li><span class="file"><a href="accessing-doc-online.html" tabindex="1">3. Accessing Documentation Online</a></span></li>
<li><span class="file"><a href="joining-the-community.html" tabindex="1">4. Joining the Open Identity Platform Community</a></span></li>
</ul>
</li>
<li id="webhelp-currentid"><span class="file"><a href="chap-install-gui.html" tabindex="1">1. Installing OpenDJ With the QuickSetup Wizard</a></span></li>
<li><span class="file"><a href="chap-install-cli.html" tabindex="1">2. Installing OpenDJ From the Command Line</a></span></li>
<li><span class="file"><a href="chap-jvm-opts.html" tabindex="1">3. Tuning JVM Options</a></span></li>
<li><span class="file"><a href="chap-upgrade.html" tabindex="1">4. Upgrading to OpenDJ 4.8.1-SNAPSHOT</a></span></li>
<li><span class="file"><a href="chap-uninstall.html" tabindex="1">5. Removing OpenDJ Servers</a></span></li>
<li><span class="file"><a href="ix01.html" tabindex="1">Index</a></span></li>
</ul>
</div>
</div>
<div id="searchDiv">
<div id="search">
<form onsubmit="Verifie(searchForm);return false" name="searchForm" class="searchForm">
<div><input id="textToSearch" name="textToSearch" type="search" placeholder="Search" class="searchText" tabindex="1" /> <input onclick="Verifie(searchForm)" type="button" class="searchButton" value="Go" id="doSearch" tabindex="1" /></div>
</form>
</div>
<div id="searchResults">
<center></center>
</div>
<p class="searchHighlight"><a href="#" onclick="toggleHighlight()">Search Highlighter (On/Off)</a></p>
</div>
</div>
</div>
</div>
</body>
</html>