<?xml version="1.0" encoding="UTF-8"?>
<!--
  ! CCPL HEADER START
  !
  ! This work is licensed under the Creative Commons
  ! Attribution-NonCommercial-NoDerivs 3.0 Unported License.
  ! To view a copy of this license, visit
  ! http://creativecommons.org/licenses/by-nc-nd/3.0/
  ! or send a letter to Creative Commons, 444 Castro Street,
  ! Suite 900, Mountain View, California, 94041, USA.
  !
  ! You can also obtain a copy of the license at
  ! legal/CC-BY-NC-ND.txt.
  ! See the License for the specific language governing permissions
  ! and limitations under the License.
  !
  ! If applicable, add the following below this CCPL HEADER, with the fields
  ! enclosed by brackets "[]" replaced with your own identifying information:
  !      Portions Copyright [yyyy] [name of copyright owner]
  !
  ! CCPL HEADER END
  !
  !      Copyright 2012 ForgeRock AS
  !    
-->
<chapter xml:id='chap-before-you-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>Before You Install OpenIDM Software</title>

 <para>This chapter covers prerequisites for installing and running OpenIDM
 software.</para>

 <variablelist>
  <para>For OpenIDM <?eval ${docTargetVersion}?>, the following configurations
  are supported for use in production.</para>
  <varlistentry>
   <term>Repository</term>
   <listitem>
    <para>MySQL 5.1 or 5.5 with Connector/J 5.1.18 or later is supported for
    use as a JDBC repository in production.</para>
    <para>OrientDB is provided for evaluation only.</para>
   </listitem>
  </varlistentry>
  <varlistentry>
   <term>Stand-alone installation</term>
   <listitem>
    <para>You must install OpenIDM as a stand-alone service, using Apache Felix
    and Jetty as provided. Alternate containers are not supported.</para>
   </listitem>
  </varlistentry>
  <varlistentry>
   <term>Connectors</term>
   <listitem>
    <para>OpenIDM <?eval ${docTargetVersion}?> comes packaged with these
    OpenICF connectors:</para>
    <itemizedlist>
     <listitem><para>CSV File</para></listitem>
     <listitem><para>LDAP</para></listitem>
     <listitem><para>Scripted SQL</para></listitem>
     <listitem><para>XML File</para></listitem>
    </itemizedlist>
   <para>ForgeRock provides additional connectors, as listed on the <link
   xlink:href="http://openicf.forgerock.org/connectors/" xlink:show="new"
   >OpenICF project connectors site</link>.</para>
   </listitem>
  </varlistentry>
 </variablelist>

 <para>If you have a special request to support a component or combination not
 listed here, contact ForgeRock at <link
 xlink:href='mailto:info@forgerock.com'>info@forgerock.com</link>.</para>

 <para>OpenIDM requires Java SE JDK 6 update 24 or later. When using the
 Oracle JDK, you also need Java Cryptography Extension (JCE)
 <link xlink:show="new"
 xlink:href="http://www.oracle.com/technetwork/java/javase/downloads/index.html"
 >policy files</link>.</para>

 <para>You need 30 MB disk space for a minimal evaluation installation. For a
 production installation, disk space required depends on the size of the
 repository, and on size of the audit and service log files that OpenIDM
 writes.</para>
</chapter>

