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.

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.

Before configuring WebCenter Sites, make sure these prerequisite tasks are done:

Note:

If RSS is installed in a separate domain, you need to run grant-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.

1. In the WebCenter Sites config directory, modify the files cs-cache.xml, ss-cache.xml, linked-cache.xml, and cas-cache.xml as follows:
   1. Locate the following section:
      <cacheManagerPeerProviderFactory class="net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory" properties="peerDiscovery=automatic, multicastGroupAddress=230.0.0.0, multicastGroupPort=4444, timeToLive=0" />
   2. Change the value of the peerDiscovery property to manual. If Sites is run on Cluster the peerDiscovery property value should be automatic.

      Note:

      WebCenter Sites is implemented on multicast to support caching and there could be network issues if another Sites instance or any other application using same multi cast address. Hence it's recommended to change peerDiscovery property to manual.
   3. Save and close the file.
   4. Start the WebCenter Sites Managed Server.
      WebCenter Sites is implemented on multicast to support caching and there could be network issues if another Sites instance or any other application using same multi cast address. Hence it's recommended to change peerDiscovery property to manual.
2. Use the Repository Creation Utility (RCU) to create database schemas for WebCenter Sites, as Creating the Database Schemas describes.
3. 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.

Typically, Sites uses the time zone setting of the WebLogic JVM. However, if you want to use a different time zone, ensure that you change it immediately after you install Sites, that is, before you create any data in the target (12.2.1.3.0) environment.

Data Source for IBM DB2

For IBM DB2 WebCenter Sites does not support the default data source created by the Fusion Middleware Configuration Wizard. To create new data source with a driver that DB2 supports:

1. Add the IBM DB2 Driver JAR files to the class path for the WebCenter Sites domain:
   1. Stop the WebLogic Server Administration Server.
   2. Copy the db2jcc.jar and db2jcc_license_cu.jar files from DB2 to a location that you can add to the domain classpath.
   3. Edit DOMAIN_HOME/bin/setDomainEnv.sh and add the following line after # ADD EXTENSIONS TO CLASSPATHS:
      PRE_CLASSPATH="path_to_db2jcc.jar:path_to_db2jcc_license_cu.jar:${PRE_CLASSPATH}"
   4. Start the Administration Server.
2. Create a new data source using the preceding DB2 driver. For more information, see Specifying JDBC Component Schema Information.

Data Source for Sites DB2

WebCenter Sites doesn't support the default data source created by Configuration Wizard. Follow the steps listed below to create new data source with supported driver.

1. Add the IBM DB2 Driver jar files to the domain classpath.
   1. Stop WebLogic Administration Server.
   2. Copy the db2jcc.jar and db2jcc_license_cu.jar from DB2 to a location that can be added to the domain classpath.
   3. Update <domain_home>/bin/setDomainEnv.sh and after # ADD EXTENSIONS TO CLASSPATHS add the below line:

      PRE_CLASSPATH="<path_to_db2jcc.jar>:<path_to_db2jcc_license_cu.jar>${PRE_CLASSPATH}"

   4. Start WebLogic Administration Server.
2. 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.

To run the browser-based WebCenter Sites Configurator after the corresponding WebLogic domain has been successfully set up:

1. (Optional) To run the Configurator in silent mode:
   1. Edit the DOMAIN_HOME/wcsites/wcsites/config/wcs_properties_bootstrap.ini file, and complete the inline instructions.
   2. Start the WebCenter Sites Managed Server.
   3. Initiate the WebCenter Sites configuration process with the following command:

      • On UNIX operating systems: xdg-open http://sites-host:sites-port/sites/sitesconfig

      • On Windows operating systems: start http://sites-host:sites-port/sites/sitesconfig

2. To configure WebCenter Sites over a web server, increase the web server timeout value to 300 sec before starting the WebCenter Sites configuration.
3. (Optional) Set the values of the following properties as appropriate for your environment, using the Property Management Tool in the Admin interface. Set these properties for a cluster that uses the NIO database-based file system. If you would like files stored in locations other than the default (individual folders under DOMAIN_HOME/wcsites/wcsites/config), specify the locations as property values because they cannot be changed once WebCenter Sites is up and running.

   Properties	Description
   xcelerate.transformpath	Directory where Microsoft Word files are stored before WebCenter Sites transforms those files into assets.
   cs.pgcachefolder	Deprecated. Only set if instructed to do so by Oracle Support.
   cs.xmlfolder	Working directory for HTML rendering.
   cs.pgexportfolder	Base export directory for the HTML files that are created when assets are published with the Export to Disk delivery type.
   vis.path	Directory where WebCenter Sites is installed. You must include the trailing slash.
   mwb.path	Directory where WebCenter Sites is installed. You must include the trailing slash.
   contentserver.installation.folder	Directory where WebCenter Sites is installed. You must include the trailing slash. Applies to installations in which Satellite Server and WebCenter Sites are running in the same web application and must therefore share the user's session. Specifying this enables Satellite Server to access WebCenter Sites resources.
   cs.csdtfolder	Directory where WebCenter Sites Developer Tools imports are stored.

   For more information on the preceding properties, see Overview of the Property Management Tool in Property Files Reference for Oracle WebCenter Sites.

4. Start the Managed Server for the WebCenter Sites primary cluster node.
5. In a web browser, access this URL: http://sites-host:sites-port/sites/sitesconfigsetup.
6. On the WebCenter Sites Configurator screen, click Begin.
7. On the Database Parameters screen, specify the JNDI Datasource name for the WebCenter Sites database repository This must be the repository you created using the Repository Creation Utility while setting up the WebLogic domain.
8. On the Web Application Parameters screen, select Yes if you are installing over a secure connection, leave all the parameters at their default (prepopulated) values, and click Next.
9. On the CAS Deployment Information screen, leave all parameters at their default (prepopulated) values and click Next. If using a cluster and a front-end web server for load balancing, adjust these values as appropriate for your environment.
10. On the WebCenter Sites Administrator Accounts screen, specify the credentials you want, and then click Next.
11. (Optional) If you chose the WebCenter Sites with Examples installation option when installing WebCenter Sites, the Sample Sites screen appears. On this screen, select the desired sample sites and click Next.
12. On the Configuration Summary screen, click Test and verify that all tests are successful. Then click Start and wait for the configuration process to complete.
13. Restart the Managed Server for the WebCenter Sites application.
14. Verify that WebCenter Sites is up and running by accessing the following URL in a web browser and logging in: http://sites-host:sites-port/sites.

Note:

The default location for cas.log is DOMAIN_HOME/servers/wcsites_server1/logs/.

To get XMLPost and Bulkloader up and running, set the following directories in the 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.

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.

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.

To configure and deploy the REST-avisports Sample Site:

1. Locate the sites-restavisports.war file in the ORACLE_HOME/wcsites/webcentersites/sites-home directory.
2. Extract this WAR file.
3. Edit the js/appconfig.js file and provide this WebCenter Sites information:
   1. SITES_HOST_NAME = sites-host
   2. SITES_PORT = sites-port (for example: 7003)
   3. SITES_CONTEXT = sites context-root (for example, sites)
4. The sites-restavisports.war can be deployed on any of the following servers:
   1. On a separate managed server that is available in the same domain as WebCenter Sites.
   2. 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>

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:

1. Install Oracle HTTP Server (OHS) or Oracle Traffic Director (OTD) in the same Oracle home as WebCenter Sites, or in a different domain.

2. 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.

3. 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).

Configuring the OHS Server

Steps to configure Oracle HTTP Server (OHS).

Steps for configuring the OHS Server

1. Install OHS version 12.2.1.3.0.

2. 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>

3. 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

   If you do not add the parameters the config wizard will fail during the installation process. For more information of parameters, see Parameters for Web Server Plug-Ins.

4. After setting properties in the mod_wl_ohs.conf file, you be able to preview the crawled sites instead of OHS screen.

5. In addition to the above configuration, the following change is required for OHS version 11.1.0.9. The DirectoryIndex configuration in httpd.conf file should be modified to update the required change.

   <IfModule dir_module>
   DirectoryIndex index.html disabled
   </IfModule>