chap-before-you-install.xml revision 7b85693a3ced68e4f3697280b999a5a710b7a17d
<?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-2014 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'>
<title>Before You Install OpenIDM Software</title>
<para>
This chapter covers prerequisites for installing and running OpenIDM software.
</para>
<variablelist>
<para>
For OpenIDM ${docTargetVersion}, the following configurations are
supported for use in production.
</para>
<varlistentry>
<term>Repository</term>
<listitem>
<itemizedlist>
<para>
The following JDBC repositories are supported for use in production:
</para>
<listitem>
<para>
MySQL 5.1 or 5.5 with Connector/J 5.1.18 or later
</para>
</listitem>
<listitem>
<para>
Microsoft SQL Server 2008
</para>
</listitem>
<listitem>
<para>
Oracle Database 11g
</para>
</listitem>
</itemizedlist>
<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>
<para>
OpenIDM ${docTargetVersion} bundles Jetty version 8.1.9.v20130131.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Connectors</term>
<listitem>
<para>
OpenIDM ${docTargetVersion} comes packaged with these OpenICF
connectors:
</para>
<itemizedlist>
<listitem><para>CSV File</para></listitem>
<listitem><para>Database Table</para></listitem>
<listitem><para>LDAP</para></listitem>
<listitem><para>Scripted Groovy</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>
<para>
When using the LDAP connector to provision to Active Directory, OpenIDM
${docTargetVersion} supports Active Directory Domain Controllers and
Active Directory Global Catalogues. This release also provides support for
Active Directory Lightweight Directory Services (LDS).
</para>
<para>
OpenIDM ${docTargetVersion} also provides support for Windows 2012 R2
as the remote system for connectors and password synchronization plugins.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Browsers</term>
<listitem>
<para>
ForgeRock has tested many browsers with the OpenIDM UI, including the
following browsers.
</para>
<itemizedlist>
<listitem>
<para>Chrome and Chromium 16 and later</para>
</listitem>
<listitem>
<para>Firefox 3.6 and later</para>
</listitem>
<listitem>
<para>Internet Explorer 8 and later</para>
</listitem>
<listitem>
<para>Safari 5 and later</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
<varlistentry>
<term>Operating Systems</term>
<listitem>
<para>
OpenIDM ${docTargetVersion} has been tested on most variations of
Linux and on Windows 2008 R2 and Windows 2012 R2.
</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>
On Windows systems, use Java SE JDK 7 update 6 or later, to take advantage of
a recent JVM fix relating to non-blocking sockets with the default Jetty
configuration.
</para>
<para>
OpenIDM ${docTargetVersion} also supports OpenJDK 1.7.
</para>
<para>
You need 150 MB disk space and 1 GB memory for an evaluation installation. For
a production installation, disk space and memory requirements will depend on
the size of the repository, and on size of the audit and service log files
that OpenIDM writes.
</para>
</chapter>