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

<chapter xml:id='chap-install'

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 and Starting OpenIDM Services</title>

<para>A short description of the install procedure follows below. For a more

detailed description including some sample configurations please consult the

install guide. For exact prerequisites like JVM versions please consult the

release notes.</para>

<sect1>

<title>Install OpenIDM</title>

<para>Installing OpenIDM is as simple as to download the openidm.zip file and

unzip the archive. The latest build can be fould here: <link

xlink:href='http://forgerock.org/openidm.html'>download page.</link></para>

</sect1>

<sect1>

<title>Uninstall OpenIDM</title>

<para>To uninstall OpenIDM simply remove the extracted folder. Eventually drop the

database schema "openidm" if using an external jdbc repository. </para>

</sect1>

<sect1>

<title>Start and Stop OpenIDM</title>

<sect2>

<title>Start and Stop OpenIDM in Interactive Mode</title>

<para>The simplest way to start OpenIDM is to execute the start.sh script

(or the run.bat on windows). This will start OpenIDM in a mode where it will

report all out put to the OSGI console. The console also accepts OSGI commands like

"scr list" in this mode. OpenIDM can simply be started with: </para>

<programlisting>/start</programlisting>

<para>To stop OpenIDM in this mode type the following on the OSGI console:</para>

<programlisting>->shutdown</programlisting>

</sect2>

<sect2>

<title>Start OpenIDM in the Background</title>

<para>As prerequisite of starting OpenIDM in the background, the ConsoleHandler

of OSGI must be disabled. This can be done in one of the following ways:</para>

<itemizedlist>

<listitem>In conf/logging.properties set java.util.logging.ConsoleHandler.level = OFF</listitem>

<listitem>The ConsoleHandler is removed from the list of handlers in the same file. </listitem>

</itemizedlist>

<para>OpenIDM can then be started in the background with: </para>

<programlisting>/start &amp;</programlisting>

<para>Stopping the instanc will now be done with the stop command: </para>

<programlisting>/stop</programlisting>

</sect2>

</sect1>

<sect1>

<title>Use MySQL for the Repository</title>

<para>Please see the chapter "Setting up the Repository" on how to connect to a

different repository database than the built in OrientDB.</para>

</sect1>

</chapter>