Chapter 4. Installing OpenIG

Before you install OpenIG, make sure you have the right version of Java, and install and configure the web container.

  • Make sure you have the correct Java environment installed.

    $ java -version
java version "1.6.0_24"
Java(TM) SE Runtime Environment (build 1.6.0_24-b07-334-9M3326)
Java HotSpot(TM) 64-Bit Server VM (build 19.1-b02-334, mixed mode)

  • Refer to the chapter on Configuring Deployment Containers to ensure you have properly installed and configured your web application container and are running a supported version of Java.

For the remainder of this chapter $HOME refers to the home directory of the user running the web container where you install OpenIG.

Procedure 4.1. Download, Install, & Configure

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

  2. Deploy the .war to the root context of the web application container.

  3. Copy the proxy and capture template. You can jump straight to a configuration template that best matches your application, but it is highly recommended you start with the basic proxy template.

  4. Copy the template to $HOME/.ForgeRock/OpenIG/config.json. Replace the TARGETIP tag in config.json with the IP address and port number of your target application.

  5. Modify DNS or host file settings so the name of your target application resolves to the IP address of OpenIG. Be sure to restart your browser after making this change.

  6. Start the web container where OpenIG is deployed and browse to the target application. OpenIG should now proxy all traffic to the application.

  7. To ensure the browser is going through OpenIG, stop the OpenIG web container, and verify you cannot reach the application. You can also look in the OpenIG capture log to verify the traffic is going through OpenIG. The location for this log is set in config.json, by default /tmp/gateway.log.