Installing OAM 10g Webgate on MSWindows 7
Recently, we were asked to install the OAM 10g Webgate for Apache on Windows7. Unfortunately this configuration is NOT yet supported by Oracle.
This presents a few problems:
- Oracle will not support you if something goes wrong
- Oracle will require you to reproduce your issues on a supported environment before they are allowed to address your problem
- This will cause you may waste a lot of time tracking down issues with your installation due to it’s unsupported nature
Lastly, even if you correct the problem and it works a patch or update patch or update might later break something that went untested (as you are utilizing an unsupported platform). Not willing to turn a blind eye from a challenge, we wanted to see if it could be done anyway. 🙂 As it turns out, our fix worked with only a few minor quirks which we thought to share with you.
NOTE – Before we get started, remember that this really should NOT be done on anything other than a “Sandbox”-type environment (for the reasons discussed above).
Remember: You are not going to get any support for issues in a non-certified environment.
With that in mind, let’s begin with the following assumptions regarding our sandbox environment:
- OAM 11g server
- Apache 2.2.21
- OAM 10g Webgate 10.1.4.3.0
- Windows 7 32-bit
1. Install Apache
- You can use the default settings for the installation
- It will install in your Program Files folder
- After installation, confirm it is running
- Modify the httpd.conf as needed for correct port, host, etc.
This process should be pretty painless.
2. Install Webgate
- Here is where you’ll start to hit snags. Installation will proceed normally, until you are asked to provide the webgate information (Access Server host name, port, etc). On this screen, the labels for the various fields will not be visible. A partial solution is to resize the window until you see the labels again (which is annoying), or you can just trust us when we say the order of the input boxes is: webgate id, password for webgate, access server id, access server hostname, access server port.
- From this point forward, we also encountered issues on just about every screen in the installer, including some strange error message, and more hidden labels. The webgate will “fail” to configure, and then display error messages about missing XML files. Believe it or not, it is actually OK (for now). Choose “No” when prompted (the lower radio button) and choose next until you reach the end.
- Be sure to configure httpd.conf as per the Oracle documentation to integrate the Webgate and Apache.
3. Replace missing files
- You must replace the following missing files in your webgate installation. You can get these files from a working installation of OAM 10g Webgate, unless otherwise noted:
- Contents of $WEBGATE_INSTALL_DIR/access/oamsso/ (language-specific sub-directories – en-us, de-de, etc…)
- Contents of $WEBGATE_INSTALL_DIR/access/oblix/ang/en-us/ (some files will already be here, just copy the missing files/directories)
- Config file from OAM server (ObAccessClient.xml) -> $WEBGATE_INSTALL_DIR/access/oblix/lib/
4. Start Apache and check the OAM Webgate diagnostic page to verify that it works.
5. Optionally, apply the latest OAM Webgate patch for Apache (BP10 as of this writing).
Questions, comments or concerns? Feel free to reach out to us below or at IDMWORKS