Web Agent Configuration wizard does not detect OHS instance

Document ID : KB000006769
Last Modified Date : 14/02/2018
Show Technical Document Details
Issue:

Web Agent configuration wizard fails to detect all the OHS instances

Environment:
Web Agent Version : r12.51 until CR8, r12.52SP1 until CR4OS : Windows
Cause:

This issue happens when the OHS instances are customized and installed outside of the default <ORACLE_HOME>\instances directory.

Here is how web agent currently determines the location of the instances.

  1. Read the path of the ORACLE_HOME by looking at all the keys under "HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE" registry.
  2. Then look for instances under <ORACLE_HOME>\instances folder ( for 11g release). (To identify correct ORACLE_HOME it also checks for couple of other files/folders)

e.g.

 

[HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE]

"inst_loc"="C:\\Program Files\\Oracle\\Inventory"

 

[HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_OH582528179]

"ORACLE_HOME"="C:\\Middleware\\Oracle_WT1"

"ORACLE_HOME_NAME"="OH582528179"

"ORACLE_GROUP_NAME"="Oracle - OH582528179"

"NLS_LANG"="AMERICAN_AMERICA.WE8MSWIN1252"

"ORACLE_BUNDLE_NAME"="Enterprise"

"ORACLE_HOME_KEY"="SOFTWARE\\ORACLE\\KEY_OH582528179"

 

instances.png

 

Now, this is all good if the OHS instances are installed using default installation. However, if the instances are customized and installed outside of this default location web agent configuration wizard fails to detect it.

 

Resolution:

Option 1 : Configure Web Agent Manually : 

https://communities.ca.com/community/ca-security/blog/2016/02/08/tech-tip-ca-single-sign-onweb-agent-how-to-manually-configure-siteminder-webagent-for-ohs-manually

 

Option 2 : Reconfigure OHS and install the instances in the default location and re-run Web Agent configuration wizard.

 

Resolution : 

 

This issue has been fixed in following version : r12.52SP1C5 and above.

Each OHS instances contains a service and each service contains a direct path to the instance directory.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\OracleProcessManager_instanceX

So, now instead of looking up the <ORACLE_HOME>\instances folder web agent configuration wizard directly get the instance path from it's service description.

 

services.png

 

Additional Information:

https://communities.ca.com/community/ca-security/blog/2016/02/08/tech-tip-ca-single-sign-onweb-agent-how-to-manually-configure-siteminder-webagent-for-ohs-manually