LSPS documentation logo
LSPS Documentation
Oracle WebLogic

To set up LSPS on Oracle WebLogic application server 11gR1 (10.3.2) and newer, do the following:

  1. Ensure JPA2 is supported on app server (see http://wiki.eclipse.org/EclipseLink/Development/JPA_2.0/weblogic#20110115:_JPA_2.0_using_EclipseLink_on_WebLogic_10.3.4.0 for further information).
  2. If you are using WebLogic 12.2. and newer, run Java with the following properties:
    -Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.glassfish.JAXBRIContextFactory -Djavax.xml.bind.JAXBContext=com.sun.xml.bind.v2.ContextFactory
    
  3. Install WebLogic.
  4. If necessary, copy your database JDBC driver libraries to to the lib directory of your domain ($WL_HOME/server/lib or $WL_HOME/user_projects/domains/<YOUR_DOMAIN>/lib).
  5. Copy LSPS security module lsps-security-weblogic-$LSPS_VERSION.jar to $WL_HOME/server/lib/mbeantypes.
  6. Start WebLogic.
  7. Create JDBC XA data source named LSPS_DS with JNDI name jdbc/LSPS_DS.

    Example configuration for an Oracle database installed on localhost

    JDBC Data Source:
    Name: LSPS_DS
    JNDI Name: jdbc/LSPS_DS
    Database Type: Oracle
    Database Driver: Oracle's Driver (Thin XA)
    Database Name: LSPS
    Host Name: localhost
    Port: 1521
    Database User Name: lsps
    Password: lsps
  8. Create JMS resouces: Create a JMS server, you can also use your own instance.

    Example with a default persistent store

    • JMS Server:
      • Name: LSPS_JMS_SERVER
      • Persistent Store: (none)
      • Target: (your server name)
    • JMS Module:
      • Name: LSPS_JMS
      • Target: (your server name)
    • Resources inside JMS Module LSPS_JMS:
      • Subdeployment:
        • Name: LSPS_DEPL
        • Targets:
          • JMS Servers: LSPS_JMS_SERVER
    • Queue:
      • Name: LSPS_QUEUE
      • JNDI Name: jms/LSPS_QUEUE
      • Subdeployments: LSPS_DEPL
    • Connection Factory:
      • Name: LSPS_CF
      • JNDI Name: jms/LSPS_CF
      • Targets: (your server name)
      • XA Connection Factory Enabled: true (Detail/Configuration/Transactions)
    • Topic:
      • Name: LSPS_TOPIC
      • JNDI Name: jms/LSPS_TOPIC
      • Subdeployments: LSPS_DEPL
      • Targets: (your server name)
  9. Optionally, set up LSPS authentication provider. Use your own authentication providers if necessary.
    1. Open your default security realm and go to Providers.
    2. Create new authentication provider:
      Authentication Provider:
      Name: LSPS_AUTHENTICATOR
      Type: LSPSAuthenticator (this should be in the list if you copied the LSPS security module in the step 2 correctly)
  10. Reorder authentication providers so that LSPS_AUTHENTICATOR is the first provider and set the provider control flag to SUFFICIENT (you can find the control flag in the provider detail page)

    Alternatively set the control flag on all providers to OPTIONAL.

  11. Restart WebLogic.
  12. If you are using WLS 12.1.1, add the following line to the bin/setDomainEnv.cmd file of your domain to change the default JAXB provider:
    SET EXT_PRE_CLASSPATH=%WL_HOME%/../modules/databinding.override_1.0.0.0.jar
  13. Deploy $WL_HOME/common/deployable-libraries/jsf-1.2.war as a library to the WebLogic server.
  14. Deploy the application lsps-application-$LSPS_VERSION.ear to the WebLogic server.
  15. Open http://localhost:7001/lsps-application in your browser and log in as admin with the password admin.

Memory Settings

  • Minimum: -Xmx512m -XX:PermSize=128m (Usually satisfied by default application server settings)
  • Optimum: -Xmx1024m -XX:PermSize=256m

The amount of memory required might increase depending on uploaded and used lsps modules.