My Oracle Support Banner

How To Change WebCenter Spaces (webcenter.ear) Application Configuration Files (connections.xml, adf-config.xml, web.xml, etc.)? (Doc ID 1557319.1)

Last updated on FEBRUARY 01, 2022

Applies to:

Oracle WebCenter Portal - Version to [Release 11g]
Information in this document applies to any platform.


This is an important note as it explains the best practices for changing the WebCenter Spaces (webcenter.ear) application configuration files.

By following these recommendations, it eliminates the need to touch or explode the webcenter.ear file and issues with patching and/or upgrading will no longer be of concern.  This will make sure that the configurations are not lost during those activities and patches can be safely installed.

The WebCenter Spaces files are split by:

In summary things would look like:

webcenter.ear/adf/META-INF/adf-config.xml - It stores the application-level settings, like description, application defaults, etc.

webcenter.ear/adf/META-INF/connections.xml - It stores connection details for WebCenter Portal services, other type of connections that may be needed by the application.

webcenter.ear/META-INF/application.xml - Is a standard Java EE deployment description, but it is also used to populate a security mapping for the "valid-users" role (when using ADF Security).

webcenter.ear/META-INF/weblogic-application.xml - Is the WebLogic Server-specific deployment descriptor for an enterprise application; it contains configuration information about the XML, JDBC, and EJB resources used by an enterprise application.

webcenter.ear/spaces.war/WEB-INF/web.xml - The standard JavaEE configuration file that lists out the servlets, filters and security settings for the application - spaces.war.

webcenter.ear/spaces.war/WEB-INF/weblogic.xml - It is the web application deployment descriptor file.


There is another file called webcenter-config.xml (or webcenter-config.xml.xml - customization file), which is a XML base document within the MDS (MetaData Repository side).

MDS_REPOS/oracle/webcenter/webcenterapp/metadata/webcenter-config.xml - It is the XML base document.

MDS_REPOS/oracle/webcenter/webcenterapp/metadata/mdssys/cust/site/webcenter/webcenter-config.xml.xml -It is the customization layer on top of the above XML base document.



To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
 1. Change the WebCenter Portal/Spaces application configuration settings - webcenter-config.xml.xml (in MDS)
 2. Change the WebCenter Portal/Spaces enterprise application configuration files - adf-config.xml.xml and connections.xml.xml (in MDS)
 3. Change the WebCenter Portal/Spaces web application configuration files - web.xml or other configurations files within WAR
 3.1. Adding changes onto the web.xml
 3.2. Modify the DesignWebCenterSpaces\ and get the user configuration file and key file from the WebCenter Portal/Spaces instance
 3.3. Build and Deploy the Extended WebCenter Portal/Spaces Library on the WebCenter Portal/Spaces server(s)
 3.4. Test things and notice the differences
 3.5. Remove and/or default to the WebCenter Portal/Spaces application

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.