<html>
<head>
<base href="https://cwiki.apache.org/confluence">
<link rel="stylesheet" href="/confluence/s/1810/9/1/_/styles/combined.css?spaceKey=DIRxSRVx11&forWysiwyg=true"
type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://cwiki.apache.org/confluence/display/DIRxSRVx11/Installers">Installers</a></h2>
<h4>Page <b>edited</b> by <a href="https://cwiki.apache.org/confluence/display/~pamarcelot">Pierre-Arnaud
Marcelot</a>
</h4>
<br/>
<h4>Changes (1)</h4>
<div id="page-diffs">
<table class="diff" cellpadding="0" cellspacing="0">
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" > <br>At the end of the execution
of the build, all installers are located at: *\[ApacheDS subproject root\]/installers/target/installers*
<br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">
<br> <br>h2. Installing/Uninstalling, Registering/Unregistering and Starting/Stopping
the ApacheDS service <br> <br>h3. With the Windows installer <br> <br>h4.
Installation <br> <br>Open the Windows installer and answer the questions asked
in the installer. <br> <br>h4. Uninstallation <br> <br>Run the Uninstaller
application (from the ApacheDS menu in the Start menu) <br> <br>h4. Starting the
default instance <br> <br>In the Services control panel (Configuration Panel >
Administrative Tasks > Services), right click on the ApacheDS service and choose "Start"
<br> <br>h4. Stopping the default instance <br> <br>In the Services
control panel (Configuration Panel > Administrative Tasks > Services), right
click on the ApacheDS service and choose "Stop" <br></td></tr>
</table>
</div> <h4>Full Content</h4>
<div class="notificationGreySide">
<h1><a name="Installers-Installers"></a>Installers</h1>
<h2><a name="Installers-Introduction%2FBackground"></a>Introduction/Background</h2>
<p>ApacheDS is provided to users as a set of native installers for various operating
systems, as well as archive-based distributions suitable for any operating system.</p>
<p>Here's the complete list of all the distributions:</p>
<ul class="alternate" type="square">
<li>Windows .exe installer (32 bit only)</li>
<li>Mac OS X .pkg installer package (32bit and 64bit)</li>
<li>Linux binary .bin installer (32bit and 64bit)</li>
<li>Linux Debian .deb installer package (32bit and 64bit)</li>
<li>Linux Fedora .rpm installer package (32bit and 64bit)</li>
<li>Archive distribution as zip and tar.gz</li>
</ul>
<p>Each distribution, except the archive-based distributions, bundles the specific version
(for the target operating system and architecture) of the <a href="http://wrapper.tanukisoftware.com"
class="external-link" rel="nofollow">Tanuki Service Wrapper</a>.<br/>
This wrapper allows ApacheDS to run as a standard native service using the system's routines
to start/stop the server at boot time.</p>
<h2><a name="Installers-InstallersGeneration"></a>Installers Generation</h2>
<h3><a name="Installers-Prerequisites"></a>Prerequisites</h3>
<p>Building all native installers requires that the machine on which the installers
will be built has all the needed tools and utilities.</p>
<div class='table-wrap'>
<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> Installer </th>
<th class='confluenceTh'> Tools and Utilities </th>
</tr>
<tr>
<td class='confluenceTd'> Windows .exe installer </td>
<td class='confluenceTd'><ul class="alternate" type="square">
<li>NSIS (/usr/bin/makensis)</li>
</ul>
</td>
</tr>
<tr>
<td class='confluenceTd'> Mac OS X .pkg installer package </td>
<td class='confluenceTd'><ul class="alternate" type="square">
<li>PackageMaker.app (/Developer/Applications/Utilities/PackageMaker.app/Contents/MacOS/PackageMaker)</li>
<li>HDIUtil (/usr/bin/hdiutil)</li>
</ul>
</td>
</tr>
<tr>
<td class='confluenceTd'> Linux binary .bin installer </td>
<td class='confluenceTd'><ul class="alternate" type="square">
<li>SH (/bin/sh)</li>
</ul>
</td>
</tr>
<tr>
<td class='confluenceTd'> Linux Debian .deb installer package </td>
<td class='confluenceTd'><ul class="alternate" type="square">
<li>DPKG (/usr/bin/dpkg)</li>
<li>GNUTar (/usr/bin/tar)</li>
</ul>
</td>
</tr>
<tr>
<td class='confluenceTd'> Linux binary .rpm installer package </td>
<td class='confluenceTd'><ul class="alternate" type="square">
<li>RPMBuild (/usr/bin/rpmbuild)</li>
</ul>
</td>
</tr>
<tr>
<td class='confluenceTd'> Archive distribution </td>
<td class='confluenceTd'><ul class="alternate" type="square">
<li>(none)</li>
</ul>
</td>
</tr>
</tbody></table>
</div>
<p>Building on a machine that does not have all the prerequisites will not fail the
build, targets with unavailable tools and utilities will be skipped gracefully.</p>
<p>Mac OS X is the only platform on which it is possible to build all installers.</p>
<p>The following section will describe how to install all prerequisites on a Mac OS
X system.</p>
<h4><a name="Installers-InstallingallprerequisitesonMacOSX"></a>Installing
all prerequisites on Mac OS X</h4>
<p>Installing all prerequisites on Mac OS X requires the following softwares to be installed:</p>
<ul class="alternate" type="square">
<li>Apple Xcode tools (<a href="http://developer.apple.com/" class="external-link"
rel="nofollow">http://developer.apple.com/</a>)</li>
<li>MacPorts (<a href="http://www.macports.org/" class="external-link" rel="nofollow">http://www.macports.org/</a>)</li>
</ul>
<p>Once those softwares are installed we need to install additional command line utilities
via Mac Ports (rpm, dpkg, gnutar)</p>
<p>To do so, run the following command in a terminal window:</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ sudo port install rpm dpkg gnutar</pre>
</div></div>
<p>It will take a little while to install everything.</p>
<p>Then, it will be required to create a few symbolic links to please the package complilers.</p>
<p>Run the following commands:</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$ sudo ln -s /opt/local/bin/rpmbuild /usr/bin/rpmbuild
$ sudo ln -s /opt/local/bin/dpkg /usr/bin/dpkg
$ sudo ln -s /opt/local/bin/dpkg-deb /usr/bin/dpkg-deb
$ sudo rm /usr/bin/tar
$ sudo ln -s /opt/local/bin/gnutar /usr/bin/tar</pre>
</div></div>
<h3><a name="Installers-Generateinstallers"></a>Generate installers</h3>
<p>You can generate ApacheDS installers by building the ApacheDS subproject from the
root directory with the 'installers' profile activated.</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>mvn clean install -Pinstallers</pre>
</div></div>
<p>This 'installers' profile will add the two maven modules to the build:</p>
<ul class="alternate" type="square">
<li>ApacheDS Installer Maven Plugin (artifactId='apacheds-installers-maven-plugin')</li>
<li>ApacheDS Installer (artifactId='apacheds-installers')</li>
</ul>
<p>At the end of the execution of the build, all installers are located at: <b>[ApacheDS
subproject root]/installers/target/installers</b></p>
<h2><a name="Installers-Installing%2FUninstalling%2CRegistering%2FUnregisteringandStarting%2FStoppingtheApacheDSservice"></a>Installing/Uninstalling,
Registering/Unregistering and Starting/Stopping the ApacheDS service</h2>
<h3><a name="Installers-WiththeWindowsinstaller"></a>With the Windows installer</h3>
<h4><a name="Installers-Installation"></a>Installation</h4>
<p>Open the Windows installer and answer the questions asked in the installer.</p>
<h4><a name="Installers-Uninstallation"></a>Uninstallation</h4>
<p>Run the Uninstaller application (from the ApacheDS menu in the Start menu)</p>
<h4><a name="Installers-Startingthedefaultinstance"></a>Starting the default
instance</h4>
<p>In the Services control panel (Configuration Panel > Administrative Tasks
> Services), right click on the ApacheDS service and choose "Start"</p>
<h4><a name="Installers-Stoppingthedefaultinstance"></a>Stopping the default
instance</h4>
<p>In the Services control panel (Configuration Panel > Administrative Tasks
> Services), right click on the ApacheDS service and choose "Stop" </p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;">
<a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
</div>
<a href="https://cwiki.apache.org/confluence/display/DIRxSRVx11/Installers">View
Online</a>
|
<a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=23339773&revisedVersion=14&originalVersion=13">View
Changes</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>
|