Guide to OpenIG
Chapter 3. Getting Started

Download and if necessary unpack the gateway .war file.

Download and unzip the OpenIG sample configuration files.

Download and unzip Jetty 7.1.6 Hightide.

Copy the OpenIG .war file as root.war to the webapps/ directory in Jetty.

When copied to this location along with the root.xml file below, Jetty automatically deploys OpenIG on startup.

$ cp $HOME/gateway-*.war $HOME/jetty-hightide-7.1.6/webapps/root.war

Copy the WordPressLogin.json gateway configuration file to $HOME/.ForgeRock/OpenIG/config.json. By default, OpenIG looks for config.json in the $HOME/.ForgeRock/OpenIG/ directory.

$ cp $HOME/forgerock-sample-configs/WordPressLogin.json
 $HOME/.ForgeRock/OpenIG/config.json

Create $HOME/jetty-hightide-7.1.6/contexts/root.xml with the following content. This tells Jetty to deploy OpenIG in the root context:

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN"
  "http://www.eclipse.org/jetty/configure.dtd">
<Configure class="org.eclipse.jetty.webapp.WebAppContext">
    <Set name="contextPath">/</Set>
    <Set name="war"><SystemProperty name="jetty.home"
      default="."/>/webapps/root.war</Set>
    <Set name="extractWAR">true</Set>
    <Set name="copyWebDir">false</Set>
    <Set name="defaultsDescriptor"><SystemProperty name="jetty.home"
      default="."/>/etc/webdefault.xml</Set>
</Configure>

If you are managing multiple applications in one domain you must turn on domain cookies in Jetty. This can be done by adding the following property to $JETTY_HOME/contexts/root.xml or to $JETTY_HOME/etc/jetty.xml. Note that any changes to jetty.xml impact all web applications running in the container.

<Get name="sessionHandler">
    <Get name="sessionManager">
        <Set name="sessionDomain">.forgerock.com<Set>
    <Get>
<Get>

Start Jetty in the background:

$ $HOME/jetty-hightide-7.1.6/bin/jetty.sh start

Or start Jetty in the foreground:

$ java -jar $HOME/jetty-hightide-7.1.6/start.jar