Thursday, July 28, 2011

WebCenter Environment Dependencies


If you have ever installed a base WebCenter PS3 environment, you will know that missing from this install is a managed server specifically there as a deployment target for your new and beautiful custom WebCenter Application – Your WebCenter Portal.  

As part of the installation you get a shiny new Spaces managed server but nothing for the portal. I am lead to believe this will change in the future, so PS4 or PS5 – Oracle PM's please confirm if you read this, but until then you need to create your own managed server and MDS to target and deploy your WebCenter portal application to.

The problem with this is unless you magically or intuitively pick which libraries to associate with your new managed server when you create it you will find that your deployment will fail until you add those libraries.

No major biggie, but annoying. I thought I would record a list of the libraries I know that are required by your portal managed server. If I missed some out, well, please add them in comments, and obviously, the more services and things you add to your application then the more libraries you will need.

The following list is the most basic you will need just to install the base WebCenter Portal created from the standard jDeveloper template.

Usually you will receive the following error message

Error while processing library references. Unresolved application library references, defined in weblogic-application.xml”

Luckily this is one of the nicer error messages you will ever receive from jDev, WebLogic or WebCenter. Basically the weblogic-application.xml and/or weblogic.xml files reference dependent libraries, and these need to be present on the managed server your are deploying to.

This appears to be a comprehensive list.
  • oracle.webcenter.framework,
  • oracle.webcenter.skin,
  • oracle.sdp.client,
  • p13n-app-lib-base,
  • oracle.ucm.ridc.app-lib
  • wcps-util-app-lib,
  • content-app-lib,
  • oracle.webcenter.spaces.fwk,
  • oracle.webcenter.framework.core,
  • oracle.webcenter.activitygraph.lib,
  • oracle.webcenter.forum.dependency
  • oracle.webcenter.jive.dependency
  • oracle.webcenter.framework.view,
  • content-web-lib,
  • wcps-services-client-web-lib,
  • jaxrs-framework-web-lib,
  • jersey-web-lib

What to do.
  1. Open your WebLogic Console and navigate to the deployments list.
  2. Select each one of the libraries listed above one by one, navigate to the targets tab.
  3. Select your desired target from the list and hit save.
That's it
All done. Now your deployment will work wonderfully... unless you have not set up your MDS target, but that will be for another post.

Happy WebCenter-ing.