OIG 11G R2 PS1 Training OIM Performance Diagnostics Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 1 | Page OIG 11G R2 PS1 Field Enablement Training Lab27_OIM Performance Diagnostics Disclaimer: The Virtual Machine Image and other software are provided for use only during the workshop. Please note that you are responsible for deleting them from your computers before you leave. If you would like to try out any of the Oracle products, you may download them from the Oracle Technology Net- work (http://www.oracle.com/technology/index.html ) or the Oracle E-Delivery WebSite (http://edelivery.oracle.com )
18
Embed
OIG 11G R2 PS1 Field Enablement Training - download.oracle.com · OIG 11G R2 PS1 Training OIM Performance Diagnostics Oracle Proprietary - Restricted to Personal Use in an Oracle
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
1 | P a g e
OIG 11G R2 PS1 Field Enablement Training
Lab27_OIM Performance Diagnostics
Disclaimer: The Virtual Machine Image and other software are provided for use
only during the workshop. Please note that you are responsible for deleting
them from your computers before you leave. If you would like to try out any of
the Oracle products, you may download them from the Oracle Technology Net-
work (http://www.oracle.com/technology/index.html) or the Oracle E-Delivery
6. Resetting the DMS metrics ……………………………………………………………………………………………………………13
7. Profile validation using EM ……………………………………………………………………………………………………………….14
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
3 | P a g e
1. Introduction
This lab shows how to look at the Dynamic Monitoring Service (DMS) metrics specifically for reconcilia-tion. DMS allow you to analyze the metrics for looking at the performance of OIM server components , event handler , scheduled jobs etc..
2. Run the Reconciliation to gather recon metrics
Note: Make sure to start the Admin Server and OIM Server.
We need to have some data with reconciliation to look at the metrics for reconciliation. Lets run the
OUD target reconciliation so that reconciliation events gets generated which will trigger the DMS met-
rics for reconciliation collected.
1. Open the SYSADMIN console in a new browser window.
2. Login as ADMIN or XELSYSADM.
3. Click on Scheduler under System Management.
4. Search for the schedule job LDAP Connector User Search Reconciliation
5. Make sure to remove the Latest Token . Click on Apply and Run Now
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
4 | P a g e
6. Make sure couple of recon events gets generated for LDAP User under Event Management
when you search.
Note: If you are not getting recon events. Use the Apache Studio LDAP Browser in the VM
(launchApacheStudio.sh) and modify couple of users to update department number or middle
initial/name. Run the recon again.
7. Now go back to the schedule job LDAP Connector User Search Reconciliation
8. This time run the reconciliation again ( This time Latest Token. Will have the last recon run time)
We would just run the incremental recon
9. Click on Run Now to run the reconciliation
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
5 | P a g e
Note: If you are not getting any new recon events. Use the Apache Studio LDAP Browser in
the VM (launchApacheStudio.sh) and modify couple of users to update department number or
middle initial/name. Run the recon again.
3. Analyzing the Reconciliation DMS metrics
Let analyze the various metrics for reconciliation. During reconciliation the metrics will be collected at 4
places
i. Schedule Job – This captures how much time it took to capture the events from target
and how much time it took to create the event
ii. Processing the Event- Action Task – Reports how much time it took to process the
events
iii. Post processing – Event Handlers – How much time it took to execute any post process
event handlers attached.
iv. Audit Handler – Time taken to record/process audit
There are also multiple ways to look at the DMS metrics. Here are the tools available to view the
metrics
i. DMS Spy servlet http://<host>:<port>/dms/Spy – Available on Admin and manage
servers as well. For a cluster view from Admin Server will give you metrics for all man-
aged servers
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
6 | P a g e
ii. WebLogic Diagnostic Framework (WLDF)
iii. WLST commands
iv. Jconsole
v. Enterprise Manager
vi. WSADMIN ( For IBM WebSphere)
We will use the dms spy servlet to view the metrics. The URL will be
http://identity.oracleads.com:7001/dms
Schedule Job Metrics:
This metrics gives information about the time taken by the schedule job to connect and pull data
from the target system as well as the time taken by the schedule job to create the events.
1. Access the DMS url http://identity.oracleads.com:7001/dms
2. Login as weblogic/Oracle123.
3. On the left hand side scroll down and click on OIM_ScheduledJob . This will open the various
scheduled jobs in OIM on right hand side.
4. Scroll down on the right side to locate LDAP Connector User Search Reconciliation. This is the
job we ran and we would like to look at the metrics for this job.
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
7 | P a g e
Now this metrics tells us that the scheduler has been running on oim_server1. If there is a clus-
ter you would have second entry for that server as well.
Lets look at the metrics highlighted
Active threads – 0 – This shows the active threads currently running at the time of the metrics
collection. If the scheduled job is running this would be a non zero number
Ave msecs – This indicates average time it took by this scheduled job. In this example we have
run the scheduled job 2 times (completed ops) . So the average will be for these two jobs
Completed ops – Number of times this scheduled job has run
MaxActive Threads – maximum number of threads used during the run
MaxTime – Maxium time taken by a single run among all the runs. In our example it’s the max
time taken in our 2 runs
minTime – This is the minimum time taken by this job among all the runs.
Time – This is the total time taken by this job among all the runs.
Processing the Events – Action Task and Audit Handler Metrics
Once the events are in the OIM. Events get processed. Action Task takes the events and submits
in batches to the stored procedure in the database for processing. Audit handler will audit the
events. DMS collects metrics for both of these handlers.
5. Click on the OIM_JMS on the left hand side. It should bring the Action Task Metrics on the right
hand side.
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
8 | P a g e
This Action Task shows you the time taken to process the Reconciliation Events. This event pro-
cessing is internally done by the stored procedure.
In the above example, we have 2 operation completed (we have run the recon 2 times) . It
shows you the average time taken. Maximum time and minimum time taken among all the runs
and it also shows you the Total time taken by all the runs.
Post Processing – Event Handlers Metrics
Once the processing of events finishes, event handlers gets triggered for any post processing.
You could have your custom post event handlers which will also get reported in DMS metrics.
6. Click on OIM_EventHandler on the left hand side. This will open the metrics on the right hand
side.
We don’t have post processing event handlers in the VM. If you do have multiple event handlers
those should show up.
Below is the screen shot from one of the development machines.
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
9 | P a g e
You can see from the above screenshot, this system has the UserLoginHandler and the corre-
sponding metrics.
4. Dumping DMS Metrics to file
In order to share the metrics offline, you can dump the DMS metrics to file. This allows you to share the
metrics for debugging purpose like with Oracle support.
The WLST command allows you to dump the metrics to file.
1. In an terminal navigate to /app/Middleware/oracle_common/common/bin
2. Enter ./wlst.sh
3. connect(‘weblogic’,’Oracle123’)
4. We would like to get the metrics for our OIM Server. Its possible to get the metrics for multiple
server as well. You just need to specify the server names as comma separated list
Execute the below command
dumpMetrics(servers=’oim_server1’,format=’xml’)
You should see the metrics displayed in the terminal window.
OIG 11G R2 PS1 Training
OIM Performance Diagnostics
Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class
10 | P a g e
5. You can also get metrics for specific category as well. Enter the below command to get metrics