# Guide to OpenIG
Chapter 3. Getting Started

Sidebar | Prev | Up | Next

## 3.2. Installation Steps

1. Download and if necessary unpack the gateway .war file.

2. Download and unzip the OpenIG sample configuration files.

3. Download and unzip Jetty 7.1.6 Hightide.

4. 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

5. 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

6. 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>

7. 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>

8. 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