Thursday, March 7, 2013

OIM 11g R2 Plugin Registration

For sample plugin code refer below link: 

  • Before registering class files need to be generated for plugin code. 
  • XML files required for plugin registration need to be ready 

Follow below steps for Registering plugin: 

1) Go to Project Properties (Jdeveloper) 



2)  Go to Deployment and click on new and provide Jar file name. 


3) In side jar go to filters and select class files which need to be deployed. 






4) Click ok after creation of jar file. 


5) Right click on project and click on Deploy and select jar file which was created.

 

 6)Click Next


7) Check the Output file path where jar file will get created, click finish after that.



8) Create new folder and name it as "Lib" and place jar file exported into Lib folder


 9) Place plugin.xml folder outside lib folder, Select only Lib and plugin.xml and create zip file with both the files.


 10) Plugin Utility file is located in below path.


11) Modify ant.properties as shown below


12) Run ant -f pluginregistration.xml register (in command prompt after browsing upto plugin_utility) 


13) Enter following details: 
  1. OIM User Name
  2. OIM User Password
  3. URL(t3://localhost:14000) 
  4. weblogic.jndi.WLInitialContextFactory (if it is weblogic server) 
  5. Location of zip file. 



14) You need to get following output saying plugin got registered as shown below and BUILD SUCCESSFUL


Thanks !!! 

9 comments:

  1. how can we get al remaing folders in step for in jar filter

    ReplyDelete
  2. hi chinni,

    I got problem while doing this lab.

    While running plugin-registration ""ant -f pluginregistration.xml register""

    PROBLEM:: oracle.iam.platform.utils.ant.PasswordInputHandler

    c:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility>ant -f pluginregistration
    .xml register
    Unable to locate tools.jar. Expected to find it in C:\Java\jrockit-jre1.6.0_33-R
    28.2.4\lib\tools.jar
    Buildfile: c:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility\pluginregistra
    tion.xml

    register:
    [echo]
    [echo] ********************************************************************
    ***********
    [echo] REGISTRATION TOOL TO REGISTER
    [echo] ********************************************************************
    ***********
    [echo] This tool can be used to register or unregister plugins to OIM.
    [echo]
    [echo] Edit the ant.properties file to set the properties.
    [echo] Invoke the corresponding ant targets (register or unregister) to per
    form registration or unregistration correspondingly.
    [echo]
    [echo] Following are the additional system properties accepted by the utili
    ty. They would be prompted if not passed at the time of invoking the utility
    .
    [echo]
    [echo] OIM.Username (User ID of the oim user)
    [echo] ServerURL (URL of the server. WLS : t3://: W
    AS : corbaloc:iiop:: )
    [echo] Context Factory ( JNDI Context Factory WLS : weblogic.jn
    di.WLInitialContextFactory WAS: com.ibm.websphere.naming.WsnInitialContextFactor
    y)
    [echo] PluginZipToRegister (Complete name with path of the plug
    in file. Required for registering a plugin.)
    [echo]
    [echo] Set the other properties in ant.properties file:
    [echo] wls.home/was.home
    [echo] oim.home
    [echo] login.config
    [echo]
    [echo]
    [echo] C:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility\OracleMiddlew
    areOracle_IDM1server\ext\spring.jar;C:\Oracle\Middleware\Oracle_IDM1\server\plug
    in_utility\OracleMiddlewareOracle_IDM1server\ext\jakarta-commons\commons-logging
    .jar;C:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility\OracleMiddlewareOrac
    le_IDM1server\ext\internal\toplink.jar;C:\Oracle\Middleware\Oracle_IDM1\server\p
    lugin_utility\OracleMiddlewareOracle_IDM1server\platform\iam-platform-context.ja
    r;C:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility\OracleMiddlewareOracle_
    IDM1server\platform\iam-platform-utils.jar;C:\Oracle\Middleware\Oracle_IDM1\serv
    er\plugin_utility\OracleMiddlewareOracle_IDM1server\platform\iam-platform-auth-c
    lient.jar;C:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility\OracleMiddlewar
    eOracle_IDM1server\platform\iam-platform-pluginframework.jar;C:\Oracle\Middlewar
    e\Oracle_IDM1\server\plugin_utility\OracleMiddlewareOracle_IDM1server\client\oim
    client.jar;C:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility\OracleMiddlewa
    rewlserver_10.3\server\lib\wlfullclient.jar;C:\Oracle\Middleware\Oracle_IDM1\ser
    ver\plugin_utility\OracleMiddleware\oracle_common\modules\oracle.jrf_11.1.1\jrf-
    api.jar
    [input] Enter the oim user id:
    xelsysadm

    BUILD FAILED
    c:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility\pluginregistration.xml:74
    : Class not found: oracle.iam.platform.utils.ant.PasswordInputHandler

    Total time: 5 seconds

    c:\Oracle\Middleware\Oracle_IDM1\server\plugin_utility>

    ReplyDelete
  3. Add the below to your CLASSPATH variable to resolve this.
    $OIM_ORACLE_HOME/server/ext/spring.jar:$OIM_ORACLE_HOME/server/ext/jakarta-commons/commons-logging.jar:$OIM_ORACLE_HOME/server/ext/internal/toplink.jariam-platform-context.jar:$OIM_ORACLE_HOME/server/platform/iam-platform-utils.jar:$OIM_ORACLE_HOME/server/platform/iam-platform-auth-client.jar:$OIM_ORACLE_HOME/server/platform/iam-platform-pluginframework.jar:$OIM_ORACLE_HOME/server/client/oimclient.jar:$WL_HOME/server/lib/wlfullclient.jar:

    ReplyDelete
  4. I get this error

    BUILD FAILED

    $IDM_HOME/server/plugin_utility/pluginregistration.xml:72:
    The type doesn’t support the nested “handler” element


    Any ideas?

    ReplyDelete
  5. Solved, the version of the ant must be 1.7 or later, mine was 1.6.5

    ReplyDelete
  6. hello i have zipped the plugin.xml file and lib folder and inserted in plugins folder. when i try to run the ant -f pluginregistration.xml file it gives an error saying that

    [echo] Error in registering the plugin. plugin.xml is not found in the plugin zip .

    [echo] Error occured during the use of plugin registering utility. plugin.xml is not found in the plugin zip .

    But i have the plugin.xml file in the zip file . Is there any other reason for this sort of error
    Could you please help me out.

    ReplyDelete
  7. Please provide me the screenshot of folder structure.


    Thanks

    ReplyDelete
  8. this is resolved by setting the java_home

    ReplyDelete
  9. Open /server/plugin_utility/pluginregistration.xml and comment the line as shown below.

    ReplyDelete

Other Posts