+ All Categories
Home > Documents > webcenter_sites_11gr1_install_on_tomcat.pdf

webcenter_sites_11gr1_install_on_tomcat.pdf

Date post: 14-Apr-2018
Category:
Upload: onidojo
View: 213 times
Download: 0 times
Share this document with a friend

of 50

Transcript
  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    1/50

    Oracle WebCenter Sites

    Installing on Apache Tomcat Application Server

    11gRelease 1 (11.1.1)

    April 2012

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    2/50

    OracleWebCenter Sites: Installing on Apache Tomcat Application Server, 11g Release 1 (11.1.1)

    Copyright 2012 Oracle and/or its affiliates. All rights reserved.

    Primary Author: Melinda Rubenau

    Contributor: Gaurang Mavadiya, Eric Gandt

    This software and related documentation are provided under a license agreement containing restrictions onuse and disclosure and are protected by intellectual property laws. Except as expressly permitted in your

    license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify,license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.Reverse engineering, disassembly, or decompilation of this software, unless required by law forinteroperability, is prohibited.

    The information contained herein is subject to change without notice and is not warranted to be error-free. Ifyou find any errors, please report them to us in writing.

    If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it onbehalf of the U.S. Government, the following notice is applicable:

    U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technicaldata delivered to U.S. Government customers are "commercial computer software" or "commercial technicaldata" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplementalregulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to therestrictions and license terms set forth in the applicable Government contract, and, to the extent applicableby the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial

    Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City,CA 94065.

    This software or hardware is developed for general use in a variety of information management applications.It is not developed or intended for use in any inherently dangerous applications, including applications thatmay create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure itssafe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of thissoftware or hardware in dangerous applications.

    Oracle and J ava are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks oftheir respective owners.

    Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks areused under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of AdvancedMicro Devices. UNIX is a registered trademark of The Open Group.

    This software or hardware and documentation may provide access to or information on content, products,and services from third parties. Oracle Corporation and its affiliates are not responsible for and expresslydisclaim all warranties of any kind with respect to third-party content, products, and services. OracleCorporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to youraccess to or use of third-party content, products, or services.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    3/50

    3

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Table of

    Contents

    About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Graphics in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

    Third-Party Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

    1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

    How This Guide Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

    Before You Install Oracle WebCenter Sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

    Installation Quick Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

    Paths and Directories Used in This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

    Part 1. Database

    2 Setting Up a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

    Part 2. Application Server

    3 Installing and Configuring Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Start/Stop Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

    Step I. Installing Tomcat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

    Step II. Configuring Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

    Setting Up a Tomcat Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

    Setting Up Multiple Instances of Tomcat to Run Simultaneously . . . . . . . . . . . . . .24

    Configuring Tomcat for SSL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    4/50

    Table of Contents4

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Part 3. Web Server

    4 Integrating with Apache Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

    Installing and Integrating Apache Web Server 2.2.x . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

    Installing Apache Web Server 2.2.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

    Integrating Tomcat with Apache Web Server 2.2.x (mod_proxy_ajp) . . . . . . . . . . .30

    Part 4. Oracle WebCenter Sites

    5 Installing and Configuring Oracle WebCenter Sites. . . . . . . . . . . . . . . . . . . 35

    Installing WebCenter Sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

    Installation Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

    Post-Installation Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

    A. Setting File Permissions (Unix Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41B. Loading the XML Parser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

    C. Adding the WebCenter Sites Binaries Directory to the Library Path Variable . .41

    D. Verifying the WebCenter Sites Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

    E. Integrating Oracle Access Manager (OAM) with WebCenter Sites (Optional) . .46

    F. Integrating with LDAP (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46

    G. Setting Up a WebCenter Sites Cluster (Optional) . . . . . . . . . . . . . . . . . . . . . . . .46

    H. Setting Up a CAS Cluster (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50

    I. Redeploying CAS (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50

    J. Setting Up WebCenter Sites for Its Business Purpose. . . . . . . . . . . . . . . . . . . . . .50

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    5/50

    5

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    About This Guide

    This guide describes the process of installing Oracle WebCenter Sites on Apache TomcatApplication Server, connecting to a supported database of your choice. This includesinstructions for installing WebCenter Sites in single-member and vertically clusteredenvironments.

    Applications discussed in this guide are former FatWire products. Naming conventions arethe following:

    Oracle WebCenter Sites is the current name of the application previously known asFatWire Content Server. In this guide,Oracle WebCenter Sites is also calledWebCenter Sites.

    Oracle WebCenter Sites: Web Experience Management Frameworkis the currentname of the environment previously known asFatWire Web Experience Management

    Framework. In this guide,Oracle WebCenter Sites: Web Experience ManagementFramework is also calledWeb Experience Management Framework, orWEM Framework.

    Audience

    This guide is for installation engineers and anyone else who has experience installing andconfiguring databases, web servers, and application servers.

    Related Documents

    For more information, see the following documents:

    Oracle WebCenter Sites: Configuring Supporting Software Oracle WebCenter Sites: Integrating with LDAP

    Oracle WebCenter Sites Administrators Guide for the WEM Framework

    Oracle WebCenter Sites Administrators Guide

    Oracle WebCenter Sites Developers Guide

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    6/50

    About This Guide6

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Graphics in This Guide

    Many steps in this guide include screen captures of dialog boxes and similar windows thatyou interact with in order to complete the steps. These screen captures are presented to

    help you follow the installation process. They are not intended to be sources of specificinformation, such as parameter values, options to select, or product version number.

    Conventions

    The following text conventions are used in this guide:

    Boldfacetype indicates graphical user interface elements that you select.

    Italictype indicates book titles, emphasis, or variables for which you supply particularvalues.

    Monospace type indicates file names, URLs, sample code, or text that appears on thescreen.

    Monospace bol d type indicates a command.

    Third-Party Libraries

    Oracle WebCenter Sites and its applications include third-party libraries. For additionalinformation, seeOracle WebCenter Sites 11gR1: Third-Party Licenses.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    7/50

    7

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Chapter 1

    Introduction

    This chapter provides information that will help you prepare for the WebCenter Sitesinstallation. It contains the following sections:

    How This Guide Is Organized

    Before You Install Oracle WebCenter Sites

    Installation Quick Reference

    Paths and Directories Used in This Guide

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    8/50

    Chapter 1. Introduction

    How This Guide Is Organized8

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    How This Guide Is Organized

    This guide provides instructions for installing WebCenter Sites in single-member andclustered environments. This guide also describes the installation and configuration of

    Tomcat Application Server, as required to support WebCenter Sites. This includesconfiguration of one or more Tomcat instances, creation of backend databases, andintegration of Tomcat with Apache Web Server. The last chapter in this guide shows youhow to install WebCenter Sites.

    The content of this guide is organized by function rather than the order in whichinstallation steps are completed. For example, a function such as application deploymentis associated with the application server. It is presented in Part II (which covers theapplication server), even though it is performed, later, when WebCenter Sites is installed(Part IV). Each major component of the WebCenter Sites installation is covered in its ownpart. A summary of the installation steps in the required order is given at the end of thischapter (seeInstallation Quick Reference, on page9).

    This guide does not cover the following topics, as they fall outside the scope of this guide:

    Tomcat SSL configuration for simultaneously run instances

    LDAP integration. For information about this topic, seeOracle WebCenter Sites:Integrating with LDAP.

    CAS clustering. For information about this topic, seeOracle WebCenter Sites:Configuring Supporting Software.

    Oracle Access Manager (OAM) integration. For information about this topic, seeOracle WebCenter Sites: Configuring Supporting Software.

    Before You Install Oracle WebCenter Sites

    Refer to theOracle WebCenter Sites Certification Matrixfor this version ofWebCenter Sites to ensure that you are installing currently supported third-partyproducts.

    Only selected information about the configuration of third-party products is given inthis guide. For detailed information and to obtain the latest e-fixes, patches, andservice packs, refer to third-party product vendors documentation and release notes.

    You can install and deploy WebCenter Sites by running the supplied installer either inGUI or silent install mode. When you run the GUI installer, a graphical interfaceguides you through the installation process, prompting you to enter information andselect options as required. It also provides access to online help. When you installsilently, you enter your installation settings into one of the sampleomi i . i ni files

    provided, using comments in the file for guidance. The installer then uses the file toinstall WebCenter Sites.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    9/50

    Chapter 1. Introduction

    Installation Quick Reference9

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    You will run the WebCenter Sites installer on all systems in your environment. Thereare two system types: content management or development (whose installationprocesses are identical) and delivery. Content management systems and developmentsystems run in the same mode but are used for different purposes.

    Remove older versions of the Java Runtime Environment from theCLASSPATHandPATHenvironment variables.

    Installation Quick Reference

    After you install and configure the third-party components that support WebCenter Sites,you will run the WebCenter Sites installer on each development, content management, anddelivery system on which you plan to use WebCenter Sites. During the installation, youwill have the option to install sample sites and sample content.

    The steps below summarize the installation and configuration of WebCenter Sites and itssupporting software. Keep the steps handy as a quick reference to the installationprocedure and to the chapters that provide more detailed instructions.

    Complete the steps below for each development, content management, and deliveryenvironment.

    I. Set Up the Database

    Set up your choice of supported databases by installing the database management system,creating a database for WebCenter Sites, and configuring the database. For instructions,seeOracle WebCenter Sites: Configuring Supporting Software.

    II. Set Up the Application Server

    To set up Tomcat Application Server, complete the steps inChapter 3, Installing andConfiguring Tomcat:

    1. Installing Tomcat, on page20.

    Note

    The system type cannot be changed once you select the type and clickNext (GUI installation) or start running the silent installer.

    The installation process does not install user interfaces ondelivery systems,except for a limited version of the WebCenter SitesAdmin interface to enable the management of select features.

    The names of the systems in your WebCenter Sites environmentmight differ from the names used in this document. Typically, thecontent management system is also called staging, and the deliverysystem is also called production.

    http://02%20oracle%2010g%20install.pdf/http://02%20oracle%2010g%20install.pdf/
  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    10/50

    Chapter 1. Introduction

    Installation Quick Reference10

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    2. Setting Up a Tomcat Instance, on page21.

    3. If you are already running one or more instances of Tomcat on your system (regardlessof the application they are serving), or if you are planning to set up a WebCenter Sitesvertical cluster, ensure that each Tomcat instance runs on a unique port number. For

    instructions, seeSetting Up Multiple Instances of Tomcat to Run Simultaneously,on page24.

    4. If you plan on running a single instance over SSL, complete the steps inConfiguringTomcat for SSL, on page25.

    III. Integrate Tomcat with Apache Web Server

    This step is required if:

    You wish to use Apache web server. You can install Apache 2.2.x.

    You are creating a clustered environment that will be load balanced through ApacheWeb Server.

    You are planning to configure Tomcat to run over SSL through Apache Web Server.

    To set up the web server, complete the following steps (inChapter 4):

    1. Install Apache 2.2.x. For instructions, seeInstalling Apache Web Server 2.2.x, onpage30.

    2. Integrate Tomcat with Apache 2.2.x. For instructions, seeIntegrating Tomcat withApache Web Server 2.2.x (mod_proxy_ajp),on page30

    IV. Install and Configure WebCenter Sites

    In this step, you will first make sure that the listed pre-requisites for installing WebCenterSites are satisfied. You will install WebCenter Sites, verify the installation, and completeany additional post-installation steps that apply to your system (for example, set up avertical cluster).

    1. Before installing WebCenter Sites, do the following:

    a. Start a Tomcat instance.

    b. Create a valid directory into which you will install WebCenter Sites; the directoryname and path cannot contain spaces, and the directory must have writepermissions.

    c. For clustered installations, create a shared file system directory that all clustermembers can read from and write to; the directory name and path cannot containspaces. Note the following:

    Note

    When setting up a Tomcat instance, keep in mind the following: If you plan to create a clustered environment, you will repeat this step to

    create a new instance of Tomcat for each cluster member. Before creatingseveral Tomcat instances, however, it is best to create one instance (asdone in this guide), install WebCenter Sites, and verify that it is functional.

    If you plan to cluster CAS, refer to the instructions inOracle WebCenterSites: Configuring Supporting Software.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    11/50

    Chapter 1. Introduction

    Installation Quick Reference11

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    - For delivery systems, the default location of the shared file system directory isthe directory containing the directory in which WebCenter Sites is installed.

    - For content management and development systems, the default location of theshared file system directory is inside the directory in which WebCenter Sites

    is installed.

    2. Install and deploy WebCenter Sites by running the GUI installer or installing silently.For instructions, seeRunning the GUI Installer, on page37or Installing Silently,on page39.

    3. Complete the WebCenter Sites installation by performing the following steps:

    a. If you installed WebCenter Sites on Unix, set the permissions for WebCenter Sitesbinaries by following the steps inSetting File Permissions (Unix Only), onpage41.

    b. WebCenter Sites contains a modified version of the Microsoft XML Parser(MSXML. j ar in theWEB- I NF/ l i b directory). If a different version of the Parseris referenced in theCLASSPATHenvironment variable, you must change the path

    to refer to the version used by WebCenter Sites; otherwise, WebCenter Sites willfail when parsing XML. For information, seeLoading the XML Parser, onpage41.

    c. Add the WebCenter Sites binaries directory to your library path variable asexplained inAdding the WebCenter Sites Binaries Directory to the Library PathVariable,on page41.

    d. Verify the WebCenter Sites installation by logging in to Oracle WebCenter Sitesas the general administrator and accessing the WebCenter Sites Admin interfaceand Contributor interface. For instructions, seeVerifying the WebCenter SitesInstallation, on page42.

    e. If you wish to replace CAS with Oracle Access Manager (OAM), follow the

    instructions inOracle WebCenter Sites: Configuring Supporting Software.f. If you want to perform LDAP integration, follow the steps inIntegrating with

    LDAP (Optional), on page46. For detailed instructions about installing andconfiguring LDAP servers, seeOracle WebCenter Sites: Configuring SupportingSoftware.

    g. If you are creating a clustered system, follow the instructions inSetting Up aWebCenter Sites Cluster (Optional), on page46.

    h. If you are clustering CAS, follow the instructions inOracle WebCenter Sites:Configuring Supporting Software.

    i. If you need to redeploy CAS, refer to the instructions inOracle WebCenter Sites:Configuring Supporting Software.

    j. Once the entire installation is completed and verified, set up WebCenter Sites forits business purpose. For instructions, see theOracle WebCenter SitesAdministrators Guideand theOracle WebCenter Sites Developers Guide.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    12/50

    Chapter 1. Introduction

    Paths and Directories Used in This Guide12

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Paths and Directories Used in This Guide

    Name Description

    Path to the Tomcat installation directory($CATALI NA_HOME).

    Path to the WebCenter Sites installation directory.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    13/50

    13

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    P art 1

    Database

    This part contains a short chapter summarizing the databases that WebCenter Sites uses.Instructions on creating and configuring the databases are given inOracle WebCenterSites: Configuring Supporting Software.

    This part contains the following chapter:

    Chapter2, Setting Up a Database

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    14/50

    14

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    15/50

    15

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Chapter 2

    Setting Up a Database

    WebCenter Sites requires access to a database specifically configured for WebCenterSites. Refer to theOracle WebCenter Sites Certification Matrixfor the list of supporteddatabases (as well as other third-party components).

    Before installing any other of WebCenter Sites supporting software, complete thefollowing steps:

    1. Install the database management system.For instructions, refer to the product vendors documentation.

    2. Create and configure a database for WebCenter Sites.For instructions, consultOracle WebCenter Sites: Configuring Supporting Software.Note that database configuration is identical across different application servers. Referto the correct chapter to create and configure the database of your choice.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    16/50

    Chapter 2. Setting Up a Database16

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    17/50

    17

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    P art 2

    Application Server

    This part contains information about installing and configuring the Tomcat ApplicationServer as well as integrating Tomcat with Apache Web Server.

    This part contains the following chapter:

    Chapter3, Installing and Configuring Tomcat

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    18/50

    18

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    19/50

    19

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Chapter 3

    Installing and Configuring Tomcat

    The chapter shows you how to install and configure Tomcat Application Server forWebCenter Sites, for running over SSL, and for simultaneously running multiple instancesof Tomcat.

    This is not an exhaustive chapter, as its covers the installation of Tomcat ApplicationServer only so far as needed to install and run WebCenter Sites. For more extensivedocumentation on the installation process and best practices, see the documentation on theApache Tomcat website.

    This chapter contains the following sections:

    Start/Stop Commands

    Installing Tomcat

    Configuring Tomcat

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    20/50

    Chapter 3. Installing and Configuring Tomcat

    Start/Stop Commands20

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Start/Stop Commands

    This section lists commands for starting and stopping Tomcat instances.

    Step I. Installing Tomcat

    To install the Tomcat Appli cation Server

    1. Create an installation directory for Tomcat.

    2. Download and install a supported JDK.

    3. Decompress the Tomcat archive file into the Tomcat installation directory:

    t ar xvf z apache- t omcat - x. t ar . gz

    4. Edit$CATALI NA_HOME/ bi n/ cat al i na. sh by adding the following lines after thefirst comment block:

    CATALI NA_HOME=

    CATALI NA_PI D="$CATALI NA_HOME"/ t omcat . pi d

    Addingt omcat . pi d ensures that the Tomcat process is killed when theshut down. sh command is executed with the- force argument.

    5. Set theJ AVA_HOME variable to theJ DKfolder of the version of Java that will be used.For example:

    expor t J AVA_HOME=/ opt / j dk1. 6. 0_24

    6. Start the application server by running the startup command.

    $CATALI NA_HOME/ bi n/ s t ar t up. sh

    7. Access the following URL in a web browser: ht t p: / / : 8080/

    This brings you to Tomcats default homepage.

    8. Shut down the application server by running theshutdown command.

    Note

    All commands require thatCATALI NA_HOME andJ AVA_HOME are set to the properdirectories.

    Action Command

    Start the Tomcat instance: $CATALI NA_HOME/ bi n/ st ar t up. sh

    Shut down the Tomcat instance: $CATALI NA_HOME/ bi n/ shut down. sh - f orce

    Note

    In this guide, we assume that you are using a UNIX based system. Therefore, thecommands that are provided in this section for your reference are only for UNIXbased systems. Commands for Windows based systems may be different.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    21/50

    Chapter 3. Installing and Configuring Tomcat

    Step II. Configuring Tomcat21

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    $CATALI NA_HOME/ bi n/ shut down. sh - f orce

    9. After you have successfully installed Tomcat, continue with the next section,Configuring Tomcat.

    Step II. Configuring Tomcat

    Complete the steps in this section as required for your installation:

    Setting Up a Tomcat Instance

    Setting Up Multiple Instances of Tomcat to Run Simultaneously

    Configuring Tomcat for SSL

    Setting Up a Tomcat Instance

    1. Create a directory namedtest in$CATALI NA_HOME/ webapps .

    2. Copy t omcat . gi ffrom$CATALI NA_HOME/ webapps / ROOT to$CATALI NA_HOME/webapps/ t est .

    3. Choose the data source information that corresponds to the database you will be usingand place the requiredj ar files in$CATALI NA_HOME/ l i b. The driver class and urldata will be inserted into theser ver . xml file in the next step.

    Table 1: Data Source Information

    Database Driver Parameters Values

    J TDS (third-partydriver)

    DriverClass net . sour cef orge. j t ds. j dbcx.J t dsDat aSour ce

    Required. j ar files j tds- 1. 2. 5 j ar

    URL j dbc: j t ds: sql ser ver : / /: /

    Ex:j dbc: j t ds: sql ser ver : / /

    127. 0. 0. 1: 1433/ cont ent DB

    DB2 DriverClass com. i bm. db2. j cc. DB2Dr i ver

    Required. j ar files db2j cc. j ar , db2cc_l i cense_cu. j ar

    Note: Thedb2j cc4. j ar file is not

    supported. Installation will fail if thedb2j cc4. j ar file is used.

    URL j dbc: db2: / / : /

    Ex.j dbc: db2: / / 127. 0. 0. 1: 50001/

    cont ent DB

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    22/50

    Chapter 3. Installing and Configuring Tomcat

    Step II. Configuring Tomcat22

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    4. Edit theser ver . xml file as follows:

    a. Add the following code before thetag:

    b. Set thedr i ver Cl assName andur l to the values you selected fromTable1 instep3.

    Oracle Thin driver DriverClass or acl e. j dbc. dr i ver . Or acl eDr i ver

    Required. j ar files oj dbc6. j ar

    URL j dbc: or acl e: t hi n: @/ /: 1521/

    Ex.j dbc: or acl e: t hi n: @/ /

    127. 0. 0. 1: 1521/cont ent DB

    Note

    If you are using an Oracle database and require text attributes greater than 2000characters, you will have to setcc. bi gt ext toCLOB. You will setcc. bi gt ext toCLOB when you run the WebCenter Sites installer (as explained inInstallationProcedures, on page36.)

    Table 1: Data Source Information (continued)

    Database Driver Parameters Values

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    23/50

    Chapter 3. Installing and Configuring Tomcat

    Step II. Configuring Tomcat23

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    c. Set theuser name andpasswor d.

    5. Edit thecat al i na. sh file in$CATALI NA_HOME/ bi n. Do the following:

    a. Set the classpath by adding the following line:

    CLASSPATH=$J AVA_HOME/ l i b/ t ool s. j ar : / bi n: $CLASSPATH

    b. Add the following lines toCATALI NA_OPTS:

    - Set the value of theMax Per mGen space to a minimum value of 192 MB. Forexample, add the following line:

    - XX: MaxPer mSi ze=

    - Set UTF file encoding by adding the following line:

    - Df i l e. encodi ng=UTF- 8

    - Enable the Ehcache shutdown hook by adding the following line:

    - Dnet . sf . ehcache. enabl eShut downHook=t r ue

    - Add the following line to use IPv4 stack:

    - Dj ava. net . pref er I Pv4Stack=t r ueAfter completing this step, yourCATALI NA_OPTS should look similar to thefollowing:

    CATALI NA_OPTS="- XX: MaxPer mSi z==- Df i l e. encodi ng=UTF- 8- Dnet . sf . ehcache. enabl eShut downHook=t r ue- Dj ava. net . pref er I Pv4St ack=t r ue $CATALI NA_OPTS"

    6. Test the new instance as follows:

    a. Make sure the Tomcat instance is shut down before attempting to start it.

    Note

    Sample configuration for an Oracle Database:

    Note

    If the classpath and library path are not set properly, the CAS webapplication will not start and theSystem Toolsnode in theAdmin tab ofthe WebCenter Sites Admin interface will have reduced functionality.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    24/50

    Chapter 3. Installing and Configuring Tomcat

    Step II. Configuring Tomcat24

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    b. Start the Tomcat instance by running the startup command:

    $CATALI NA_HOME/ bi n/ s t ar t up. sh

    c. In your browser, openht t p: / / : 8080/ test / t omcat . gi f

    If thet omcat . gi f image is displayed, the setup was done properly.7. For the next step, see theInstallation Quick Reference, on page9.

    Setting Up Multiple Instances of Tomcat to Run Simultaneously

    This section explains the extra steps that need to be taken if multiple Tomcat instanceshave been set up on the same machine/server and must run simultaneouslyregardless ofthe applications they are serving. To set up multiple Tomcat instances, follow the stepsused for setting up the first instance (seeSetting Up a Tomcat Instance,on page21). Thesteps in this section ensure that no two instances use the same ports:

    1. Shut down all running instances of Tomcat.

    2. Check that theser ver . xml file for each Tomcat instance uses unique port values.The port values to check are:

    - Theport value in the first connector tag (set to8080 in the main instance andprevious example). This is the main port where the application will be deployed.

    - Theshut down por t value, located in theSer ver tag (with a value of 8005 inthe example above as well as the main instance). If this value is identical for twoinstances attempting to run simultaneously, the second instance will be unable tostart.

    - Ther edi r ect Port value in bothConnect or tags.

    - Theconnector port value, located in the secondConnect or tag.

    3. Test whether two instances can run simultaneously:

    a. Open a shell andcd to the$CATALI NA_HOME of the first Tomcat instance, andrun thestartup command:

    . / bi n/ st art up. sh

    b. Open a shell andcd to the$CATALI NA_HOME of the second Tomcat instance, andrun thestartup command:

    . / bi n/ st art up. sh

    c. To verify that the two instances can run simultaneously, display the imaget omcat . gi f:

    htt p: / / : /t est / t omcat . gi f

    ht t p: / / : /

    t est / t omcat . gi f

    If there is an error, check bothser ver . xml files to make sure the instances arenot sharing any ports.

    4. For the next step, see theInstallation Quick Reference, on page9.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    25/50

    Chapter 3. Installing and Configuring Tomcat

    Step II. Configuring Tomcat25

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Configuring Tomcat for SSL

    1. Generate a certificate:

    keyt ool - genkey - al i as t omcat - keyal g RSA keyst or e/ keys/ . keyst or e

    a. Set the- keyst or e parameter to the location where you want the generated keysto be stored.

    b. When prompted for the keystore password, you may use your own password, orthe default changei t . If a custom password is entered, a value in theser ver . xml file will need to be changed (as explained instep2).

    c.Enter your first and last name, name of organization, city, state, and country codewhen prompted, then clickYesto confirm.

    d. At the next prompt, Ent er key passwor d f or ( RETURN i fsame as keyst or e passwor d) , press Enter, as the key passwordmustbe thesame as the keystore password.

    2. Edit$CATALI NA_HOME/ conf / ser ver . xml , uncomment theSSL section, and addthe following attributes to the SSL connector:

    - keyst oreType=" J KS"

    This attribute is set to JKS for J ava Keyst or e (the format produced by Javaskeytool).

    - keyst or eFi l e="/ keys/ . keyst or e"

    This attribute is set to the path where the. keyst ore file was created and thesame path used instep1.

    - keyst orePass=""

    This attribute is needed only if the keystore password used instep1is notchangei t , and should be set to the custom password used.

    a. If ther edi rect Por t values in thetags are not already set to8443, change them now.

    3. Point your browser toht t ps: / / : 8443/ t est / t omcat . gi f.

    If your system works correctly, you will be prompted to accept the certificate. Whenyou accept the certificate, the Tomcat image is displayed.

    4. For the next step, see theInstallation Quick Reference, on page9.

    Note

    This section applies only to single-server WebCenter Sites installations.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    26/50

    Chapter 3. Installing and Configuring Tomcat

    Step II. Configuring Tomcat26

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    27/50

    27

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    P art 3

    Web Server

    This part shows you how to install and configure Apache Web Server.

    This part contains the following chapter:

    Chapter4, Integrating with Apache Web Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    28/50

    28

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    29/50

    29

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Chapter 4

    Integrating with Apache Web Server

    The chapter shows you how to install Apache Web Server 2.2.x and then integrate it withthe Tomcat Application Server. The steps in this chapter are required if you wish tointegrate Tomcat with Apache Web Server or to create a vertical cluster that will be loadbalanced through Apache Web Server.

    This chapter contains the following section:

    Installing and Integrating Apache Web Server 2.2.x

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    30/50

    Chapter 4. Integrating with Apache Web Server

    Installing and Integrating Apache Web Server 2.2.x30

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Installing and Integrating Apache Web Server 2.2.x

    This section contains instructions for installing Apache Web Server 2.2.x and thenintegrating this version of Apache with the Tomcat application server. This section

    contains the following topics:

    Installing Apache Web Server 2.2.x

    Integrating Tomcat with Apache Web Server 2.2.x (mod_proxy_ajp)

    Installing Apache Web Server 2.2.x

    1. Extract, compile, and install Apache 2.2.xas follows:

    a. t ar xvf j p ht t pd- 2. 2. 11. t ar . bz2

    b. . / conf i gur e - - enabl e- so - - enabl e- mods- shared="proxy cachessl al l " - - pr ef i x= - - wi t h- i ncl uded- apr

    c. make

    d. make i nst al l

    2. Set the variable$APACHE2_HOME to the directory in which Apache 2.2.xwasinstalled.

    Integrating Tomcat with Apache Web Server 2.2.x(mod_proxy_ajp)

    In this step you will usemod_proxy_aj p to integrate Tomcat Application Server withApache Web Server 2.2.x.

    1. Make sure you have modified/ conf / ser ver . xml to includej vmr oute in theEngi ne tag. For example:

    2. Open$APACHE2_HOME/ conf / ht t pd. conf and add the following to the Mainserver configuration section:

    SetHandl er bal ancer - managerOr der Deny, Al l owDeny f r om al l

    Bal ancer Member aj p: / / : l oadf act or =1

    r out e=j vm1

    ProxyPass / cs bal ancer : / / cl ust er / cs

    ProxyPassReverse / cs bal ancer : / / cl ust er / cs

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    31/50

    Chapter 4. Integrating with Apache Web Server

    Installing and Integrating Apache Web Server 2.2.x31

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    3. Testhtt pd. conf by typing the following:

    cd $APACHE2_ HOME/ bi n

    apachect l conf i gtest

    If successful, you will receive the message Synt ax OK. Ignore any warningmessages.

    4. Start Tomcat:

    $CATALI NA_HOME/ bi n/ st ar t up. sh

    5. Start Apache:

    $APACHE2_HOME/ bi n/ apachect l st ar t

    6. Point your browser toht t p: / / / t est / t omcat . gi fand verify that theTomcat image is displayed.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    32/50

    Chapter 4. Integrating with Apache Web Server

    Installing and Integrating Apache Web Server 2.2.x32

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    33/50

    33

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    P art 4

    Oracle WebCenter Sites

    This part shows you how to install WebCenter Sites. It contains the following chapter:

    Chapter5, Installing and Configuring Oracle WebCenter Sites

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    34/50

    34

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    35/50

    35

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Chapter 5

    Installing and Configuring Oracle WebCenterSites

    This chapter guides you through the installation of WebCenter Sites on the TomcatApplication Server.

    This chapter contains the following sections:

    Installing WebCenter Sites

    Post-Installation Steps

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    36/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Installing WebCenter Sites36

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Installing WebCenter Sites

    After completingStepsI IV.1in theInstallation Quick Reference, on page9, youinstall WebCenter Sites using the provided installer. The installation process consists of

    two stages:

    In the first stage, the installer gathers necessary configuration information, installs thefile structure, and automatically deploys the WebCenter Sites application. At the endof the first stage, the GUI installer displays the Installation Actions window whichlists the steps you must perform before proceeding to the second stage of theinstallation. In a silent installation, these steps are displayed on the command-line.

    If the first stage fails, the installer allows you to go back and modify yourconfiguration options (except the database type), and retry the installation.

    In the second stage, the installer populates the database with the tables and datarequired for WebCenter Sites to function. If the second stage fails, you must drop thedatabase tables, undeploy the WebCenter Sites application, delete the WebCenter Sitesfile structure, and re-install WebCenter Sites.

    Installation Procedures

    This section explains the two ways to install WebCenter Sites:

    Running the GUI Installer

    When you run the GUI installer, a graphical interface guides you through theinstallation process, prompting you to enter information and select options asrequired. It also provides access to online help.

    Installing Silently

    When you install silently, you enter your installation settings into one of the sample

    omi i . i ni files provided, using comments in the file for guidance. The installer usesthe settings in the file to install and deploy WebCenter Sites.

    Note

    If you need to change the type of database you have specified during the

    installation, you must delete the installed WebCenter Sites file structure andrestart the installation.

    Note

    The WebCenter Sites installer includes the installation of CAS. By default, CASwill be installed on the primary cluster member.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    37/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Installing WebCenter Sites37

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Running the GUI Installer

    To install WebCenter Sites using the GUI installer

    1. Make sure you have completedStepsI IV.1in theInstallation Quick Reference,

    on page9.

    2. Extract the WebCenter Sites installer archive into a temporary directory.

    3. Change to the temporary directory containing the installer files.

    4. Execute the installer script:

    - On Windows: csI nst al l . bat

    - On Unix: csI nst al l . sh

    The installer provides online help at each screen. Read the online help for detailedexplanations of the options in each screen. If you encounter problems during theinstallation process, consult the online help for possible causes and solutions.

    5. In the Enter CAS Deployment information screen, do one of the following:

    - For networks with firewalls, fill in the fields as follows:

    - Enter Server HostName Enter the hostname/IP address of the CAS server,as referred to by the external network. If you are clustering CAS, enter thehostname/IP address of the externally facing load balancer.

    - Enter Server PortNumber Enter the port number of the CAS server, asreferred to by the external network. If you are clustering CAS, enter the portnumber of the externally facing load balancer.

    - Enter Server HostName of internally accessible CAS Enter thehostname/IP address of the CAS server, as referred to by the internal network.If you are clustering CAS, enter the hostname/IP address of the load balancer,as referred to by the internal network.

    - Enter Server PortNumber of internally accessible CAS Enter the portnumber of the CAS server, as referred to by the internal network. If you areclustering CAS, enter the hostname/IP address of the load balancer, asreferred to by the internal network.

    - Enter Server HostName where CAS is actually deployed Enter thehostname of the machine where CAS will be deployed.

    - For networks without firewalls, fill in the fields as follows:

    - Enter Server HostName Enter the hostname/IP address of the CAS server.If you are clustering CAS, enter the hostname/IP address of the load balancer.

    - Enter Server PortNumber Enter the port number of the CAS server. If you

    are clustering CAS, enter the post number of the load balancer.- Enter Server HostName of internally accessible CAS Enter the

    hostname/IP address of the CAS server. If you are clustering CAS, enter thehostname/IP address of the load balancer.

    - Enter Server PortNumber of internally accessible CAS Enter the portnumber of the CAS server. If you are clustering CAS, enter the port number ofthe load balancer.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    38/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Installing WebCenter Sites38

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    - Enter Server HostName where CAS is actually installed Enter thehostname of the machine where CAS will be deployed.

    6. Halfway through the installation, after the WebCenter Sites and CAS applications aredeployed, the GUI installer displays the Installation Actions window, which lists thesteps you must perform to complete the installation.

    If necessary, deploy the WebCenter Sites and CAS web applications. Do the following

    before continuing with the installation process:a. Edit thecas- cache. xml , cs- cache. xml , ss - cache. xml , and l i nked-

    cache. xml files (located in the WebCenter Sites deployed directory under theWEB- I NF/ cl asses folder). Ensure that the following fields are unique for eachcache type:

    - mul t i cast Gr oupAddr ess

    - mul t i cast Gr oupPort

    - t i meToLi ve

    Note

    When setting up a cluster, ensure that each corresponding file has identical

    values across the cluster members. Edit thet i meToLi ve field to control thepropagation of multicast packets. The following is a list of possible options:

    1- (multicast packets restricted to the same subnet)

    32- (multicast packets restricted to the same site)

    64- (multicast packets restricted to the same region)

    128- (multicast packets restricted to the same continent)

    255- (multicast packets are unrestricted)

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    39/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Installing WebCenter Sites39

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    b. Edit thej bossTi cket CacheRepl i cat i onConf i g. xml file, located under the/ bi n directory. Ensure that the following fields have uniquevalues:

    - mcast addr

    - mcast por t

    c. If you are using an Oracle database and require text attributes greater than 2000characters set thecc. bi gt ext property toCLOB:

    1) Open the Property Editor by clicking theProperty Editor button.

    2) In the Property Editor, open thef ut ur et ense. i ni file.

    3) Click theDatabasetab.

    4) Locate thecc. bi gt ext property and set its value to CLOB.

    5) Save your changes and close the Property Editor.

    7. When the installation completes successfully, continue withPost-Installation Steps,on page41.

    Installing Silently

    To install WebCenter Sites silently:

    1. Ensure you have completedStepsI IV.1in theInstallation Quick Reference, onpage9.

    2. Extract the WebCenter Sites installer archive into a temporary directory.

    3. TheMi sc/ si l ent i nst al l er folder of the temporary directory contains sampleomi i . i ni files that you can use for your silent installation.

    - If you are installing a content management or development system, use the

    generi c_omi i . i ni file.- If you are installing a delivery system, use thedel i ver y_omi i . i ni file.

    a. Edit the file for your type of installation by verifying the default values andentering additional values as required. Refer to the comments in the file forguidance.

    b. Save the file and copy it to a folder outside.

    Note

    When setting up a CAS cluster, ensure that each cluster member hasidentical values for the following fields:

    Cl ust er Name

    mcast addr

    mcast port

    i p_t t l (set this value to1 or 32 depending on your network)

    For more details on setting up a CAS cluster, seeOracle WebCenter Sites:

    Configuring Supporting Software.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    40/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Installing WebCenter Sites40

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    4. If you are installing a delivery system, you must set unique passwords for thef wadmi n andCont ent Ser ver /Sat el l i teServer users:

    a. Open thecscor e. xml file in theCont ent Ser ver folder of the temporarydirectory.

    b. Set passwords in the following section:

    1) Set the password for thef wadmi n user in theVALUE field followingNAME=passwor dVar .

    2) Set the password for theCont ent Ser ver /Sat t el i teServer user in theVALUE field followingNAME=passwor dAdmi nVar .

    c. Save and close the file.

    5. Edit thei nst al l . i ni file in the root folder of the temporary directory:

    a. Set thenodi spl ay property to t rue.

    b. Uncomment thel oadf i l e property and set it to the path and name of theomi i . i ni file fromstep3b.

    c. Save and close the file.

    6. Change to the temporary directory containing the installer files.

    7. Execute the installer script:

    - On Windows: csI nst al l . bat - si l ent

    - On Unix: csI nst al l . sh - si l ent

    8. To complete the installation, refer tosteps6 7starting onpage38.

    9. When the installation completes successfully, continue withPost-Installation Steps,on page41.

    Note

    Verify that you have correctly specified the file system path. Forexample, for Windows:

    CSI nst al l Di r ect ory=C\ : / csi nst al l

    - or -

    c\ : \ \ i nst al l

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    41/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps41

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    Post-Installation Steps

    When the installation process completes successfully, perform the steps in this section, asrequired for your configuration:

    A.Setting File Permissions (Unix Only)

    B.Loading the XML Parser

    C.Adding the WebCenter Sites Binaries Directory to the Library Path Variable

    D.Verifying the WebCenter Sites Installation

    E.Integrating Oracle Access Manager (OAM) with WebCenter Sites (Optional)

    F.Integrating with LDAP (Optional)

    G.Setting Up a WebCenter Sites Cluster (Optional)

    H.Setting Up a CAS Cluster (Optional)

    I.Redeploying CAS (Optional)

    J .Setting Up WebCenter Sites for Its Business Purpose

    A. Sett ing File Permissions (Unix Only)

    If you installed WebCenter Sites on Unix, you must grant the executable permission toall files in the/ bi n directory. To do so, perform the following steps:

    1. Change to the/ bi n directory.

    2. Run the following command:chmod +x *

    3. Restart Tomcat.

    B. Loading the XML ParserWebCenter Sites contains a modified version of the Microsoft XML Parser (MSXML. j ar in theWEB- I NF/ l i b directory). If a different version of the Parser is referenced in theCLASSPATHenvironment variable, you must change the path to refer to the version usedby WebCenter Sites; otherwise, WebCenter Sites will fail when parsing XML.

    C. Adding the WebCenter Sites Binaries Directory to the LibraryPath Variable

    In order for the ContentServer component to function in WebCenter Sites, you must addthe WebCenter Sites binaries directory,/ bi n, to your library pathvariable as follows:

    For HP-UX:

    Add/ bi n toSHLI B_PATH.

    Note

    If the classpath and library path are not set properly, theSystem Toolsnode in the

    Admin tab of the WebCenter Sites Admin interface will have reducedfunctionality and CAS will not start.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    42/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps42

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    For Linux and Solaris:

    Add/ bi n toLD_LI BRARY_PATH.

    For AIX:

    Add/ bi n toLI BPATH. For Windows:

    Add\ bi n to your systemsPATHvariable.

    For AIX and Solaris based systems, you will have to manually copy the correct library filefrom thesi gar/ bi n/ folder, located under the Installer folder (into whichyou extracted the WebCenter Sites installer), to the/ bi n directory.

    Then, remove the incorrect version from the/ bi n directory.

    For example, for AIX 64 bit, copy thel i bsi gar - ppc64- ai x- 5. so from/ si gar / bi n/ AI X64/ to the/ bi n directory and deletethel i bsi gar - ppc- ai x- 5. so from the/ bi n directory.

    D. Verify ing the WebCenter Sites Installation

    Verify the installation by logging in to Oracle WebCenter Sites as a general administratorand accessing the WebCenter Sites Admin, Contributor, and WEM Admin interfaces. Inthe process, you will verify that single sign-on functions (by accessing a differentapplication without logging out and back in to WebCenter Sites).

    To access the WebCenter Sites interfaces

    1. Point your browser to the following URL:

    ht t p: / / : / / l ogi n

    whereis the host name or IP address of the server running WebCenterSites,is the port number of the WebCenter Sites application, andis the name of the WebCenter Sites application that was deployed on the server.

    Note

    In the WebCenter Sites log file, the following message indicates that the correctlibraries are not found in the library path:

    UnsatisfiedLinkError caught: Content Server is unable to gather/display systeminformation. Ensure thatj ava. l i br ar y. pat h (or LD_LI BRARY_PATH) ispointed toCSI nst al l Di r ect ory/ bi n

    In such cases, set - Dj ava. l i br ary. pat h=/ bi n for theapplication server.

    The default WebCenter Sites log file (si t es. l og) is created during theinstallation process in the/ l ogs directory.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    43/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps43

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    The WebCenter Sites login form is displayed.

    2. Enter the following credentials:

    - User name: fwadmin

    - Password:xceladmin

    3. ClickLogin.

    4. Access the WEM Admin interface. In the Site drop-down, selectAdminSiteand theicon for theWEM Admin interface.

    The WEM Admin interface (on AdminSite) is displayed:

    WEM Admin

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    44/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps44

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    5. Switch to the WebCenter Sites Admin interface by navigating to the applications barand selecting the icon for the WebCenter SitesAdmin interface:

    The WebCenter Sites Admin interface (on AdminSite) is displayed. Only systemadministration functionality is available.

    6. Switch to the WebCenter Sites Contributor interface:

    Note

    The WebCenter Sites Contributor interface is not associated with AdminSite. Ifthe avisports and FirstSite II sample sites are installed, you can switch to eitherone of these sample sites to access the Contributor interface. If no sample sitesare installed, you will have to access the WEM Admin interface (seestep4 onpage43), create a site, create users, and then assign the users to the site. TheContributor interface is automatically assigned to the site. (For instructions, seetheOracle WebCenter Sites Administrators Guide for the Web ExperienceManagement Framework.) Then continue with this step.

    Applications barAdmin

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    45/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps45

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    a. Navigate to the applications bar. In the site selection drop-down menu, select asite other than AdminSite.

    b. Since this is the first time you are accessing the selected site, the following screenis displayed. Select the icon for theContributor interface.

    (Upon subsequent access, WebCenter Sites opens the application you lastaccessed for the site you selected.)

    The Contributor interface on the site to which you are logged in is displayed:

    WebCenter Sites is now ready to be configured. Follow the steps in the rest of thischapter.

    Site selection drop-down menu

    Contributor

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    46/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps46

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    E. Integrating Oracle Access Manager (OAM) with WebCenterSites (Optional)

    If you wish to replace CAS with Oracle Access Manager (OAM), refer to the instructions

    inOracle WebCenter Sites: Configuring Supporting Software.

    F. Integrating with LDAP (Optional)

    If you wish to perform LDAP integration, do the following:

    1. Set up a supported LDAP server of your choice. For instructions, seeOracleWebCenter Sites: Configuring Supporting Software.

    2. Run the LDAP integration program included on the WebCenter Sites CD.

    For more information, seeOracle WebCenter Sites: Integrating with LDAP.

    G. Setting Up a WebCenter Sites Cluster (Optional)

    This section is written on the assumption that you have already installed and configuredTomcat Application Server as specified in the previous sections of this guide, and:

    You are installing a vertical cluster (Tomcat Application Server instances are installedon the same machine).

    You have installed and configured a single instance of WebCenter Sites to run throughTomcat. You have also logged in to the instance and confirmed that it is operational.

    Step I. Creating Vertical Cluster Members

    1. Create an installation directory folder for each cluster member. For example:

    - - | - -

    | - - | - - Shar ed

    2. Create a new Tomcat instance by following the steps inChapter 3, Installing andConfiguring Tomcat.

    3. Change the port settings of the new instance by following the steps inSetting UpMultiple Instances of Tomcat to Run Simultaneously, on page24.

    4. Install the WebCenter Sites cluster member on the newly created Tomcat instance.Follow the steps inRunning the GUI Installer, on page37or Installing Silently,on page39, but observe the following exceptions:

    Note

    If you have configured LDAP for the primary cluster member, make sure to runtheconf i gureLDAP. sh for all secondary cluster members.

    Note

    If you are clustering CAS, you will have to manually redeploy all secondary CAScluster members. For instructions, seeOracle WebCenter Sites: ConfiguringSupporting Software.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    47/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps47

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    - When running the GUI installer:

    - In the Installation Directory screen, select the installation directory that youcreated instep1of this section.

    - In the Clustering screen, selectCluster Member.- In the WebCenter Sites Shared File System screen, enter the path to the

    shared file system of the primary cluster member.

    - In the WebCenter Sites URL Parameters screen, enter the IP address andport number of the load balancer for WebCenter Sites and CAS.

    - In the WebCenter Sites Application Deployment screen, enter the path toCATALI NA_HOME of the Tomcat instance you created instep1of this section.

    - When configuring theomi i . i ni file for silent installation:

    - SetCSI nst al l Di r ect ory to the installation directory that you created instep1of this section.

    - SetCSI nst al l Type tocl ust er.

    - SetCSI nst al l Shar edDi r ect ory to the shared file system of the primarycluster member.

    - SetCSI nst al l WebSer verAddr ess to the IP address of the load balancerfor WebCenter Sites and CAS.

    - SetCSI nst al l WebSer verPor t to the port numberof the load balancerfor WebCenter Sites and CAS.

    - SetCSI nst al l AppSer verPat h toCATALI NA_HOME of the Tomcat instanceyou created instep1of this section.

    - SetCASHost Name to the resolvable hostname/IP address of the external loadbalancer for CAS.

    - SetCASPor t Number to the port number of external load balancer for CAS.

    - SetCASHost NameLocal to the resolvable hostname/IP address of theinternal load balancer for CAS.

    - SetCASPor t NumberLocal to the port number of internal load balancer forCAS.

    - SetCASHost NameAct ual to the resolvable hostname/IP address of theServer where CAS is actually deployed.

    5. For every member of the WebCenter Sites cluster and CAS cluster, edit theweb. xml file (located in/ webapps/ cs / WEB- I NF/ ) byadding the line between theandlines:

    6. To enable Tomcat to cluster, do the following:

    a. For every member of the cluster, open theser ver . xml file and add the codeshown below (replacing the sample values with the values for your system). Thecode shown below is a sample configuration. If you need more information, referto the Tomcat documentation.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    48/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps48

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    49/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps49

    Oracle WebCenter Sites: Installing on Apache Tomcat Application Server

    b. Check the following:

    - All Tomcat instances belonging to the same cluster have the same values forthemcast Addr andmcast Port in theMember shi p tag.

    - All Tomcat instances have a different value for thet cpLi st eni ngPor t intheRecei ver tag.

    7. Make sure there is ausedi sksync directory in theShar eddirectory of your primaryWebCenter Sites installation, or the first one that was created. If theusedi sksyncdirectory is not already there, then create it with the following command:

    mkdi r / Shar ed/ usedi sksync

    8. To finish configuring WebCenter Sites for clustering, edit the following properties byusing WebCenter Sitess Property Editor.Complete the steps below for all clustermembers:

    a. Launch the WebCenter Sites Property Editor (make sure yourDI SPLAY variable isset):

    / pr opedi t or . shb. From theFilemenu, selectOpen, navigate to your WebCenter Sites installation

    directory and open thef ut ur et ense. i ni file.

    c. ClickCluster.

    d. Make sure the following variables are set as shown below:

    - cc. cacheNoSync is set to f al se

    - f t . sync is set to a value (assigned by you) that is identical for all membersof this cluster, e.g., cl ust er 1.

    - f t . usedi sksync is set to the path of theusedi sksync directory created instep7.

    e. If you have configured LDAP for the primary cluster member, make sure to runconf i gur eLDAP. sh for all secondary cluster members.

    9. Verify the newly created cluster member. For instructions, seeD. Verifying theWebCenter Sites Installation, on page42.

    10.To create additional cluster members, repeat the steps in this section. Once the clusteris created, continue with the next step, Step II. Balancing Load Withmod_proxy_ajp.

    Step II. Balancing Load With mod_proxy_ajp

    For every cluster member, complete the following steps:

    1. Open theser ver . xml file and add the following attribute to theEngi ne tag:

    Note

    Each member can be given any node name as long as the names are uniqueacross members.

  • 7/30/2019 webcenter_sites_11gr1_install_on_tomcat.pdf

    50/50

    Chapter 5. Installing and Configuring Oracle WebCenter Sites

    Post-Installation Steps50

    2. Open thehtt pd. conffile and add the following to the Main server configurationsection:

    SetHandl er bal ancer - managerOr der Deny, Al l owDeny f r om al l

    Bal ancer Member aj p: / / : l oadf act or=1 r out e=

    Bal ancer Member aj p: / / : l oadf act or=1 r out e=

    Pr oxySet st i ckysessi on=J SESSI ONI D

    ProxyPass / cas bal ancer : / / cl ust er / cas

    ProxyPassReverse / cas bal ancer : / / cl ust er / cas

    ProxyPass / cs bal ancer : / / cl ust er / cs

    ProxyPassReverse / cs bal ancer : / / cl ust er / cs

    3. For each cluster member, edit the$CATALI NA_HOME/ conf / web. xml file by addingthe linebetween theandlines:

    4. Load balancer configuration is now complete. Restart Apache for the changes to takeeffect.

    H. Setting Up a CAS Cluster (Optional)

    The installer is configured to deploy CAS only on the primary WebCenter Sites clustermember. In cases where CAS is deployed on a separate server, you will have to manuallydeploy CAS. Additionally, you must configure and deploy secondary CAS clustermembers manually. For instructions, seeOracle WebCenter Sites: Configuring SupportingSoftware.

    I. Redeploying CAS (Optional)

    There may be cases where you will have to manually redeploy CAS on another server. Forinstructions on redeploying CAS, seeOracle WebCenter Sites: Configuring SupportingSoftware.

    J. Setting Up WebCenter Sites for Its Business Purpose

    You are now ready to configure WebCenter Sites for business use. For instructions, see the