SungHoon_Kim

How to manually configure OHS to integrate with Web Agent

Blog Post created by SungHoon_Kim Employee on Nov 12, 2015

This article is actually from Ujwol.

 

This use case is about installing OHS instance on a non-default folder(out side the ORACLE_HOME) and Web Agent Configuration Wizard fails to detect the existence of this instance.

 

Use case:

 

OS : Winodws 2012

Web Server : OHS 11g(2.2) 64bit

Web Agent version : R12.52 sp1 cr002

 

--- [REPRODUCTION STEPS]----

1. Install and configure OHS 11g R1 on Windows 2012 Std.

2. Configure Oracle Home as : C:\Middleware\Oracle_WT1 (Note , the default is : C:\Middleware\Oracel_WT1)

3. Configure Oracle Instance as : C:\otherplace\instance1 ( Note , the default is : C:\MIddlerware\Oracle_WT1\instances\instance1)

4. Install and configure web agent

5. Note , Web Agent Configuration Wizard won't be able to recognize this OHS instance.

 

 

Solution:

 

Not available at the moment.

Workaround is the solution for now.

 

 

Workaround:

 

Following needs to be followed.

 

 

Step 1. Changes to httpd.conf file at <Instance Directory>\instance1\config\OHS\ohs1

 

A. Add LoadModule entry to the DSO Support Section

The following line(s) are added to the Dynamic Shared Object (DSO) Support configuration section, which precedes the Main server configuration section of the file.

LoadModule sm_module "<web_agent_home>/win64/bin/mod_sm22.dll"

 

     Note:

          The SiteMinder Agent requires one of the following modules in order to load:

     Apache 2.0

LoadModule sm_module web_agent_home/bin/libmod_sm20.so

     Apache 2.0 running on Windows

LoadModule sm_module web_agent_home/bin/mod_sm20.dll

     Apache 2.2 running on Windows

LoadModule sm_module web_agent_home/bin/mod_sm22.dll

 

B. Add SmInitFile Entry

This entry is placed after the LoadModule entry that you added in (1). A full path is used, not a relative path.

SmInitFile "<Instance Directory>/instance1/config/OHS/ohs1/WebAgent.conf"

 

C. Alias Entries Added

In the Aliases section of the file, following entries are added to enable SiteMinder features.

 

     Note:

          The Alias /siteminderagent/ “<web_agent_home>/samples/” entry must come after all other aliases in the Aliases section.

          AliasMatch URI list must be in reverse alphabetical order.

          Also, the Alias URI list must be in reverse alphabetical order. (for example, /siteminderagent/pwcgi/ first and /siteminderagent/ last)

          <web_agent_home> need to be replaced with your actual %NETE_WA_ROOT% value.

 

     AliasMatch /siteminderagent/nocert/[0-9]+/(.*) "<web_agent_home>/win64/$1"

     <Directory "<web_agent_home>/win64/$1">

     Options Indexes MultiViews

     AllowOverride None

     Order allow,deny

     Allow from all

     </Directory>

     Alias /siteminderagent/pwcgi/ "<web_agent_home>/win64/pw/"

     <Directory "<web_agent_home>/win64/pw/">

     Options Indexes MultiViews ExecCGI

     AllowOverride None

     Order allow,deny

     Allow from all

     </Directory>

     Alias /siteminderagent/pw/ "<web_agent_home>/win64/pw/"

     <Directory "<web_agent_home>/win64/pw/">

     Options Indexes MultiViews ExecCGI

     AllowOverride None

     Order allow,deny

     Allow from all

     </Directory>

     Alias /siteminderagent/ "<web_agent_home>/win64/samples/"

     <Directory "<web_agent_home>/win64/samples/">

     Options Indexes MultiViews

     AllowOverride None

     Order allow,deny

     Allow from all

     </Directory>

 

Step 2. Create WebAgent.conf file with the following content and copy it in <Instance Directory>\instance1\config\OHS\ohs1

 

     Note: Replace <web_agent_home> with actual Web Agent Root(%NETE_WA_ROOT% value) folder

               Replace <Instance Directory> with the OHS instance folder

 

# WebAgent.conf - configuration file for SiteMinder Web Agent

# Web Agent Version = 12.51, Build = 1402, Update = 07

 

LOCALE=en-US

 

#agentname="<AgentName>, <IPAddress>"

HostConfigFile="<web_agent_home>\win64\config\SmHost.conf"

AgentConfigObject="<aco_name>"

EnableWebAgent="YES"

ServerPath=""

#localconfigfile="<Instance Directory>\instance1\config\OHS\ohs1\LocalConfig.conf"

LoadPlugin="<web_agent_home>\win64\bin\HttpPlugin.dll"

#LoadPlugin="<web_agent_home>\win64\bin\Affiliate10Plugin.dll"

#LoadPlugin="<web_agent_home>\win64\bin\SAMLAffiliatePlugin.dll"

#LoadPlugin="<web_agent_home>\win64\bin\eTSSOPlugin.dll"

#LoadPlugin="<web_agent_home>\win64\bin\IntroscopePlugin.dll"

#LoadPlugin="<web_agent_home>\win64\bin\SAMLDataPlugin.dll"

#LoadPlugin="<web_agent_home>\win64\bin\OpenIDPlugin.dll"

#LoadPlugin="<web_agent_home>\win64\bin\DisambiguatePlugin.dll"

#LoadPlugin="<web_agent_home>\win64\bin\OAuthPlugin.dll"

AgentIdFile="<Instance Directory>\instance1\config\OHS\ohs1\AgentId.dat"

 

 

Step 3. Create AgentId.dat file with the following content and copy it in <Instance Directory>\instance1\config\OHS\ohs1

 

     Note: (This value is supposed to be unique but as it is not generated you will have to copy one from another agent and change the value to make it unique. In this sample, I copied one and modified the last character 'b' to 'c')

GUID=000080fe0000000075939d10c0597d33-0bf0-5643dc86-0bf4-0339021c

 

 

Step 4. Change opmn.xml file at <Instance Directory>\instance1\config\OPMN\opmn

=======================================================================

Add following lines after

<ias-instance id="instance1" name="instance1">

<environment>

 

section

 

<variable id="NETE_WA_PATH" value="<web_agent_home>/win64/bin"/>

<variable id="NETE_WA_ROOT" value="<web_agent_home>/win64" />

<variable id="PATH" value="$NETE_WA_PATH;$PATH"/>

Note:

     a. All the sections within <> need to be changed with the actual path

     b. After making all these changes OS needs to be restarted.

          (In fact, haven't figured out which process loads this configuration file. If you are aware of how to get this recognized without rebooting the machine please let me know)

 

For your reference, please take a look at the sample attachment files.

 

And thanks to Ujwol for preparing and sharing this content.

Attachments

Outcomes