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.