1.2.3 Configure Libovd for Multi Entity

This topic provides the systematic instructions to configure libovd for multi entity.

Follow the steps given below to configure the libovd for multi entity.

  1. Continue step 1 to step 5 from Configure Libovd For Single Entity
  2. In the following steps, replace the <EntityId> tag with the proper Entity name.
  3. Copy the fcubs_adapter_<EntityId>.xml to <MIDDLEWARE_HOME>/oracle_common/modules/oracle.ovd/templates/
  4. Search for <FCUBSDATASOURCE> in fcubs_adapter_< EntityId>.xml and update it with fcubs Datasource with the mapped Datasource for the entity in the property file.
    For example: <param name="DataSource" value="<FCUBSDATASOURCE>"/>
  5. Search for UserIdPattern Parameter and update the value for OU to the entity name in lower case.
    For example: <param name="UserIdPattern" value="cn=%USERID%,ou=<EntityId>,dc=oracle,dc=com"/>
  6. Search for MultiEntityEnabled element and update the value to true.
    For example: <param name="MultiEntityEnabled" value="true"/>
  7. Search for EntityId element and update the value with the entity name in lower case which we have created.
    For example: <param name="EntityId" value=" <EntityId>"/>
  8. Search for ou=fcubs and update with entity id in lower case.
    For example: ou= EntityId
  9. Execute libovdadapterconfig script which is present in <MIDDLEWARE_HOME>/oracle_common/bin with below parameters.
  10. Update the admin server host name or IP, admin server port, WebLogic user id, domain home, root, and fcubs datasource.
    libovdadapterconfig.sh -adapterName fcubsAdapter -adapterTemplate fcubs_adapter_< EntityId >.xml -host <ADMIN_SERVER_HOST> -port <ADMIN_PORT> -userName <WEBLOGIC_USERID> - domainPath <DOMAIN_HOME> -dataStore DB -root ou=<EntityId>,dc=oracle,dc=com -contextName default -dataSourceJNDIName <FCUBSDATASOURCE name which we mapped in step4>
  11. Repeat from step 2 to step 7 for each entity creation.
  12. Once the above steps are completed, restart the server.

    Note:

    For any misconfiguration in libovd, delete the existing fcubsAdapter and re-run the ./libovdadapterconfig.sh.
    For deleting fcubsAdapter use the below command:
    1. Log in to the WSLT console by running the WLST script.

      For example:

      • UNIX: MW_HOME/oracle_common/common/bin/wlst.sh
      • Windows: MW_HOME\oracle_common\common\bin\wlst.cmd
    2. Connect to your Administration Server using the following syntax:

      connect ('<WLS admin user name>','<WLS admin password>','t3://<admin server host>:<admin server port>')

      For Example: connect('weblogic','weblogic','t3://myserver:7001')

    3. Delete the misconfigured adapter using the following syntax:

      deleteAdapter(adapterName='fcubsAdapter')

    Note:

    • In the case of Multi Entity, all data sources must be created separately for each entity. The JNDI name will be differentiated by suffixing the entity name.

      Example: If Data source is jdbc/fcjDevDs then jdbc/fcjDevDs+entity name will be lookup the application. (jdbc/fcjDevDs+entity name) jndi should be presented in application server.

    • For multi tenant deployment, BPMN support will be available only for the logged entity.