Oracle® Identity Manager Installation and Configuration Guide for IBM WebSphere Application Server Release 9.1.0.1 Part Number E14064-04 |
|
|
View PDF |
This appendix provides an overview for using WebSphere MQ as JMS provider for Oracle Identity Manager. For detailed information you have to refer to WebSphere and WebSphere MQ documentation.
Using WebSphere MQ as JMS provider for Oracle Identity Manager involves the following steps:
Oracle recommends that you create a backup of the WebSphere configuration for all the WebSphere profiles involved in the installation of Oracle Identity Manager. You need the WebSphere configuration backup to restore to the previous working state, if anything goes wrong. Refer to IBM documentation on how to use the backupConfig
and restoreConfig
utilities for creating backup and restoring the WebSphere configuration respectively.
To create a backup of the WebSphere configuration for all the profiles in WebSphere 6.1, run the WAS_HOME
/profiles/
PROFILE_NAME
/bin/backupConfig.sh
or backupConfig.cmd
script.
In addition, create a backup of the OIM_HOME
directory before starting the procedure described in this appendix.
Install MQ in one or more computers. For example, for failover, install MQ in one computer with hardware-based failover, or install MQ in multiple computers and create a clustered queue manager.
Create six separate JMS queues in the Queue Manager by naming the queues appropriately. For example, create queues named xlQueue, xlAuditQueue, xlAttestationQueue, xlReconQueue, xlProcessQueue, and xlErrorQueue. xlErrorQueue is intended to be used as a dead letter queue for all other five queues.
Uninstall Oracle Identity Manager applications already deployed from the IBM application server for integrating WebSphere MQ with Oracle Identity Manager. To do so:
In the WebSphere Admin Console, navigate to Applications, and then to Enterprise Applications.
Select Xellerate, and then select Nexaweb.
Click Uninstall.
To remove resource for default messaging:
In the WebSphere Admin Console, navigate to Resources, JMS, Queue Connection Factories.
Set the scope to the Cell Level for clustered and to the server level for nonclustered installations.
Select xlConnectionFactory, and then click Delete to remove it.
Navigate to Resources, JMS, Queues.
Set the scope to the Cell Level for clustered and to the server level for nonclustered installations.
Select all the queues that start with xl, and then click Delete.
Navigate to Resources, JMS, Activation Specification.
Set the scope to the Cell Level for clustered and to the server level for nonclustered installations.
Select all the activation specifications, and then click Delete to remove all.
Navigate to Service Integration, and then to Buses.
Select XellerateBus, and then click Delete to remove.
Click Save to save the changes in the main configuration.
Note:
For a clustered installation of Oracle Identity Manager, make sure to click Preferences, and select Synchronize changes with Nodes before clicking Save.To change the xlJMSLogic credentials:
Navigate to Security, Secure administration, applications and infrastructure, Java Authentication and Authorization Service (Under Authentication), J2C authentication data.
Click XLJMSLogin, and change the User ID and Password to the WebSphere MQ user name and password.
To create WebSphere MQ resources:
Create queue connection factory. To do so:
In the WebSphere Admin Console, navigate to Resources, JMS, Queue Connection Factories.
Set the scope to the Cell Level for clustered and to the server level for nonclustered installations.
Click New, and select WebSphere MQ messaging provider, and then click OK.
For Name and JNDI name, enter xlConnectionFactory.
Enter the other required information related to WebSphere MQ.
Create queue references on WebSphere:
In the WebSphere Admin Console, navigate to Resources, JMS, Queues.
Set the scope to the Cell Level for clustered and to the server level for nonclustered installations.
Click New, and select WebSphere MQ messaging provider, and then click OK.
Enter Name as xlQueue, JNDI name as queue/xlQueue, Base queue name as the name of the appropriate queue on Websphere MQ.
Create six new queues with the following JNDI names:
queue/xlQueue, queue/xlReconQueue, queue/xlAuditQueue, queue/xlAttestationQueue, queue/xlProcessQueue, and queue/xlErrorQueue
Create listener ports. To do so, in the WebSphere Admin Console, navigate to Servers, Application Servers, SERVER_NAME
, Messaging, Message Listener Service, Listener Ports. Then create the following listener ports:
MessageHandlerMDB_JMSPort:
Name: MessageHandlerMDB_JMSPort
Connection factory JNDI name: xlConnectionFactory
Destination JNDI name: queue/xlQueue
ReconMessageHandlerMDB_JMSPort:
Name: ReconMessageHandlerMDB_JMSPort
Connection factory JNDI name: xlConnectionFactory
Destination JNDI name: queue/xlReconQueue
AuditMessageHandlerMDB_JMSPort:
Name: AuditMessageHandlerMDB_JMSPort
Connection factory JNDI name: xlConnectionFactory
Destination JNDI name: queue/xlAuditQueue
AttestationMessageHandlerMDB_JMSPort:
Name: AttestationMessageHandlerMDB_JMSPort
Connection factory JNDI name: xlConnectionFactory
Destination JNDI name: queue/xlAttestationQueue
ProcessMessageHandlerMDB_JMSPort:
Name: ProcessMessageHandlerMDB_JMSPort
Connection factory JNDI name: xlConnectionFactory
Destination JNDI name: queue/xlProcessQueue
Note:
For a clustered installation of Oracle Identity Manager, the step for creating listener ports must be repeated for all the servers inXL_CLUSTER
.To make the message driven beans listen to MQ destinations, change the deployment descriptors. To do so:
Open the OIM_HOME
/DDTemplates/BO/ibm-ejb-jar-bnd.xmi
file.
Replace all occurrences of activationSpecJndiName with listenerInputPortName.
Replace xlQueueSpec with MessageHandlerMDB_JMSPort.
Replace xlReconQueueSpec with ReconMessageHandlerMDB_JMSPort.
Replace xlAuditQueueSpec with AuditMessageHandlerMDB_JMSPort.
Replace xlAttestationQueueSpec with AttestationMessageHandlerMDB_JMSPort.
Replace xlProcessQueueSpec with ProcessMessageHandlerMDB_JMSPort.
Save the ibm-ejb-jar-bnd.xmi file.
Note:
For a clustered installation of Oracle Identity Manager, copy the ibm-ejb-jar-bnd.xmi file to all the nodes on which Oracle Identity Manager is deployed.Restart WebSphere Application Server. For a clustered installation of Oracle Identity Manager, restart all the application servers as well as the Deployment Manager.
Run the following patch utility to deploy Oracle Identity Manager with MQ integration:
For UNIX:
OIM_HOME
/setup/patch_websphere.sh
XELSYSADM_PASSWD
OIM_DB_PASSWD
For Microsoft Windows:
OIM_HOME
/setup/patch_websphere.cmd
XELSYSADM_PASSWD
OIM_DB_PASSWD
Restart WebSphere Application Server. For a clustered installation of Oracle Identity Manager, restart all the application servers as well as the Deployment Manager.
If required, then restore OIM_HOME
and rollback the changes to IBM WebSphere Application Server by using the WAS_HOME
/profiles/
PROFILE_NAME
/bin/restoreConfig.sh
or restoreConfig.cmd
script. Refer to IBM documentation for more information on how to use this utility.