7 Configuring WebCenter Sites
After you configure the Oracle WebCenter Sites Managed Servers, you can configure a WebCenter Sites instance by completing the browser-based WebCenter Sites Configurator. WebCenter Sites runtime consists of WebCenter Sites and CAS web applications (WAR files) and the following components shared across cluster members: a config
directory, a data
directory, and a database instance.
The following topics describe how to configure WebCenter Sites:
- Completing Prerequisites for Configuring WebCenter Sites
Several prerequisite tasks must be done before you use the WebCenter Sites Configurator. These tasks include modifying cache files, creating database schemas, configuring a WebCenter Sites domain, and setting property values for your environment. - Configuring WebCenter Sites with the Configurator
The WebCenter Sites Configurator populates the database with tables and data necessary for WebCenter Sites to function. The Configurator also creates the necessary user accounts and sets the required permissions on the database objects. - Managing Customizations with WebCenter Sites Deployment
It is recommend to not include any implementation specific customizations to Sites WAR file as the changes will be overwritten during patching process and is redeployed. - Configuring and Deploying the REST-avisports Sample Site
REST-avisports is a sample website that demonstrates client-side website development using the WebCenter Sites Aggregate REST API. - Creating a WebCenter Sites Web Tier
After you configure a domain, you set up Oracle Web Tier or a third-party web tier.
Parent topic: Configuring WebCenter Sites Components
Completing Prerequisites for Configuring WebCenter Sites
Several prerequisite tasks must be done before you use the WebCenter Sites Configurator. These tasks include modifying cache files, creating database schemas, configuring a WebCenter Sites domain, and setting property values for your environment.
Note:
If RSS is installed in a separate domain, you need to rungrant-opss-permission.sh
or grant-opss-permission.bat
. Make sure that these files contains the specified domain name before running it. If necessary, edit the file and update the domain name.
- In the WebCenter Sites
config
directory, modify the filescs-cache.xml
,ss-cache.xml
,linked-cache.xml
, andcas-cache.xml
as follows: - Use the Repository Creation Utility (RCU) to create database schemas for WebCenter Sites, as Creating the Database Schemas describes.
- Use the Fusion Middleware Configuration Wizard with the
Oracle WebCenter Sites - 12.2.1.3.0[wcsites]
template to create a new domain and configure one or more WebCenter Sites Managed Servers, as Configuring the Domain describes.
Parent topic: Configuring WebCenter Sites
Data Source for IBM DB2
- Add the IBM DB2 Driver JAR files to the class path for the WebCenter Sites domain:
- Create a new data source using the preceding DB2 driver. For more information, see Specifying JDBC Component Schema Information.
Data Source for Sites DB2
- Add the IBM DB2 Driver jar files to the domain classpath.
- Create new Data Source using above driver. For more information see, Creating and Configuring a Data Source
Configuring WebCenter Sites with the Configurator
The WebCenter Sites Configurator populates the database with tables and data necessary for WebCenter Sites to function. The Configurator also creates the necessary user accounts and sets the required permissions on the database objects.
Note:
If you are configuring WebCenter Sites over a slow network, increase the setting of the StuckThreadMaxTime
property to 1000 seconds per thread before starting the WebCenter Sites Configurator. The default value is 600 seconds.
In certain environments that potentially have network-related issues, the sample sites import process could take more than 600 seconds per thread during the WebCenter Sites configuration setup process. This can cause the import process or install to fail, and multiple exceptions in the log file. Oracle recommends increasing the setting to 1000 seconds to complete a successful installation of the sample sites.
To change the value of StuckThreadMaxTime
, in the WebLogic Server Administration Console for the domain, change to Servers -> wcsites_server1 -> Configuration -> Tuning.
Note:
The default location forcas.log
is DOMAIN_HOME/servers/wcsites_server1/logs/
.
CLASSPATH
environment variable:ORACLE_HOME\wcsites\webcentersites\sites-home\lib\*
ORACLE_HOME\oracle_common\modules\clients\*
For information about how to configure additional cluster nodes, see Setting Up a Cluster.
For information about how to configure an external LDAP authentication provider, see Switching to Authentication Against an LDAP Directory.
For information about how to configure Oracle Access Manager integration, see Switching to Authentication Against Oracle Access Manager.
For information about how to use the WebCenter Sites Configuration Import/Export Utility, see Using the Property Management Tool in Property Files Reference for Oracle WebCenter Sites.
Parent topic: Configuring WebCenter Sites
Managing Customizations with WebCenter Sites Deployment
It is recommend to not include any implementation specific customizations to Sites WAR file as the changes will be overwritten during patching process and is redeployed.
The WebCenter Sites web application is shipped as a WAR file. The web application is deployed during Config Wizard process initially and can be redeployed multiple times during the application lifecycle. It is recommend to not include any implementation specific customizations to Sites WAR file as the changes will be overwritten during patching process and is redeployed.
Extending the WebLogic Server Shared Libraries framework, Sites provides extend.sites.webapp-lib.war
as a shared library, located under ORACLE_HOME/wcsites/webcentersites/sites-home/
directory. Any implementation specific customizations such as static web resources or Java libraries can be included in this WAR file. This shared library gets deployed during application lifecycle and shares the same context root as sites (/sites/). The contents of this shared library will not be overwritten during patching process.
Note:
-
It is generally recommended to deploy the static artifacts such as images and stylesheet files onto the web server.
-
For more information on using the shared library, see Creating Shared Java EE Libraries and Optional Packages.
Parent topic: Configuring WebCenter Sites
Configuring and Deploying the REST-avisports Sample Site
REST-avisports is a sample website that demonstrates client-side website development using the WebCenter Sites Aggregate REST API.
Before you configure and deploy the REST-avisports Sample Site, make sure these tasks are done:
-
Install WebCenter Sites with avisports sample site.
-
Start the WebCenter Sites Managed Servers and verify that they are running successfully.
- Locate the
sites-restavisports.war
file in theORACLE_HOME/wcsites/webcentersites/sites-home
directory. - Extract this WAR file.
- Edit the
js/appconfig.js
file and provide this WebCenter Sites information:SITES_HOST_NAME = sites-host
SITES_PORT = sites-port
(for example:7003
)SITES_CONTEXT = sites context-root
(for example,sites
)
- The
sites-restavisports.war
can be deployed on any of the following servers:- On a separate managed server that is available in the same domain as WebCenter Sites.
- On a dedicated Domain Server or an Application Server. A typical client-side website follow this setup.
When WebCenter Sites is running, you can access the REST-avisports sample site at this URL:
http://<restavisports-host-name>:<restavisports-deployed-port>/<restavisports-app-context-path>
Parent topic: Configuring WebCenter Sites
Creating a WebCenter Sites Web Tier
After you configure a domain, you set up Oracle Web Tier or a third-party web tier.
For Oracle Web Tier, see Installing and Configuring Oracle HTTP Server or Installing Oracle Traffic Director for instructions to do these tasks:
-
Install Oracle HTTP Server (OHS) or Oracle Traffic Director (OTD) in the same Oracle home as WebCenter Sites, or in a different domain.
-
Run the Configuration Wizard again to configure OHS or OTD to add it to (extend) the WebCenter Sites domain, or to create a standalone OHS or OTD domain.
-
Configure the mod_wls web server plug-in, which routes requests to Managed Servers.
For a third-party web server, see the documentation for the web server.
- Configuring the OHS Server
Steps to configure Oracle HTTP Server (OHS).
Parent topic: Configuring WebCenter Sites
Configuring the OHS Server
Steps to configure Oracle HTTP Server (OHS).
Steps for configuring the OHS Server
-
Install OHS version 12.2.1.3.0.
-
Change the configuration to bypass the ROOT of OHS.
-
Peform the following change in the
mod_wl_ohs.conf
file located in the<ORACLE_HOME>/user_projects/domains/<DOMAIN_NAME>/config/fmwconfig/components/OHS/instances/<OHS_INSTANCE_NAME>
<IfModule weblogic_module> WebLogicHost <WEBLOGIC_HOST_ON_WHICH_SITES_IS_INSTALLED> WebLogicPort <WEBLOGIC_PORT_ON_WHICH_SITES_IS_INSTALLED> MatchExpression </IfModule>
-
-
For configuring Cluster, set the properties in the
mod_wl_ohs.conf
file located in the<ORACLE_HOME>/user_projects/domains/<DOMAIN_NAME>/config/fmwconfig/components/OHS/instances/<OHS_INSTANCE_NAME>
.<IfModule weblogic_module> WebLogicCluster <HOST_AND_PORT_DETAILS> MatchExpression </IfModule> <Location /sites> SetHandler weblogic-handler </Location> <Location /cas> SetHandler weblogic-handler </Location>
Note:
If you are installing WebCenter Sites with Sample Sites on different Webservers (for example: On the OHS Server), ensure to add the following paramaters in library file of Weblogic Plug-in as this allows you to import avisports installable during config wizard.-
WLIOTimeoutSecs=1200
-
KeepAliveEnabled=true
-
-
After setting properties in the
mod_wl_ohs.conf
file, you be able to preview the crawled sites instead of OHS screen. -
In addition to the above configuration, the following change is required for OHS version 11.1.0.9. The
DirectoryIndex
configuration inhttpd.conf
file should be modified to update the required change.<IfModule dir_module> DirectoryIndex index.html disabled </IfModule>
Parent topic: Creating a WebCenter Sites Web Tier