3 Installing Oracle WebCenter Interaction

This chapter describes how to complete the Oracle WebCenter Interaction installer wizard and how to deploy the portal application and Image Service to your application server.

Installing the Oracle WebCenter Interaction Components

This section describes how to run the Oracle WebCenter Interaction installer. Before installing Oracle WebCenter Interaction you must complete the tasks described in Chapter 2, "Installation Prerequisites."

Log in to the host as the ALI user.
Close all programs.
Launch the Oracle WebCenter Interaction installer.

The installer file is named WebCenterInteraction_10.3.3.0.0. The Oracle WebCenter Interaction installer is a graphical, X-Windows client when run in interactive mode. If you run the installer on a remote terminal, ensure that your DISPLAY is set appropriately.
Complete the installer wizard pages.

For details, see Oracle WebCenter Interaction Installer Wizard Pages
Configure environment settings for Oracle WebCenter Interaction.

Source the script install_dir/pthome.sh in the startup script for your application server. The pthome.sh script sets up the environment for Oracle WebCenter components.
Deploy the portal application to your application server.

The portal Web application archives are located in install_dir/ptportal/10.3.3/webapp/.
- If you are deploying to Oracle WebLogic Server or IBM WebSphere, deploy portal.ear.
Deploy the Image Service to your application server.

The Image Service files are located in install_dir/ptimages/imageserver/.

For instructions, see Deploying the Image Service.

Oracle WebCenter Interaction Installer Wizard Pages

This section describes the Oracle WebCenter Interaction installer wizard pages.

Wizard Page	Description
Introduction	This installer wizard page provides a brief description of the installer and describes how to run the installer in silent mode.
Installation Folder	Accept the default installation folder or select a different folder in which to install Oracle WebCenter Interaction. Default: /opt/oracle/middleware/wci
Choose Components	Select either Complete or Custom. If you select Complete, a full set of Oracle WebCenter Interaction components is installed. If you select Custom, you can select individual portal components to install according to your deployment plan.
Configuration Manager - Port and Password	Enter the port and password for the Configuration Manager Web tool. The Configuration Manager will be used to complete the installation of Oracle WebCenter Interaction.
Standalone or Cluster	Select whether you would like to install a Single Standalone Search Node or add a Search Cluster Node. Selecting to install the standalone search node installs a single node on the local computer. If you want to support failover, add search cluster nodes.
Adding New Search Node	Enter the name and port number of the new search node. The search node is installed into install_dir/ptsearchserver/10.3.3.
Search Cluster Files	If you chose to install a search cluster node, select the location of the search cluster files. You must have permission to access and write to the location where you want to install these files. Example: install_dir/ptsearchserver/10.3.3/cluster
Content Service for Documentum - Application Port	Choose whether to use a secure protocol (https) for the Oracle WebCenter Interaction Content Service for Documentum or a standard protocol (http). Specify your port number. The default port is 11951. Make sure to enter the SSL port number if using https.
Documentum Client Library	Enter the path to your Documentum client library. Example: `$DOCUMENUM_SHARED/dfc/dfcbase.jar`
Fully Qualified Domain Name	Enter the fully qualified domain name for the computer hosting Oracle WebCenter Interaction Content Service for Windows Files.
Identity Service for LDAP - Application Port	Choose whether to use a secure protocol (https) for the Oracle WebCenter Interaction Identity Service for LDAP or a standard protocol (http). Specify your port number. The default port is 11950. Make sure to enter the SSL port number if using https.
Fully Qualified Domain Name	Enter the fully qualified domain name for the computer hosting Oracle WebCenter Interaction Identity Service for Microsoft Active Directory.
Interaction Development Kit: .NET Signed or Unsigned	Choose whether to install the .NET signed or unsigned version of the Oracle WebCenter Interaction Development Kit (IDK).
Fully Qualified Domain Name	Enter the fully qualified domain name for the computer hosting Oracle WebCenter Console for Microsoft SharePoint.
Pre-Installation Summary	Review the list of components to be installed. Click Install.
Launch Configuration Manager	Launch the Configuration Manager. The Configuration Manager is located at: `https://host:port` Where host is the host you are installing on and port is the port you specified. Log in to the Configuration Manager using the user name `administrator` and the password you specified on the Configuration Manager – Port and Password page. The Configuration Manager displays a list of all recently installed components. Clicking the link next to each component leads you through the settings you must configure to complete the installation. For information on the settings in the Configuration Manager, refer to the Configuration Manager online help or to the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Interaction. When you have completed all Configuration Manager tasks, return to the installer.
Application Settings Confirmation	Choose whether you have completed configuration of your application settings or want to complete configuration later.
Install Complete	When the installer is finished, you might be asked to restart your computer to complete installation. If prompted, choose whether to restart your computer now or manually at another time. Click Done. Note: The Oracle WebCenter Interaction installer launches additional installers depending on the components you chose to install. You might be prompted by one of the additional component installers to restart your computer before the Oracle WebCenter Interaction installer is finished. If you are prompted to restart your computer while another installer is running, select the option to manually restart your computer later. Then, if you are not prompted to restart your computer after the final installer is finished, restart your computer manually.

Deploying the Image Service

The Image Service is a collection of static, non-secure files that should be served by an HTTP server, such as Apache HTTP Server. The Image Service files are located in install_dir/ptimages/imageserver.

This directory should be aliased in your HTTP server configuration so that the URL specified for the Image Service when the installer was run is correct. For example, if you were running an Apache HTTP Server on port 8082, and you had specified http://webserver:8082/imageserver as your Image Service URL, you might configure Apache HTTP server as follows:

Note:

This is only an example. In a production environment the imageserver directory should be aliased to the Web server by a knowledgeable Web server administrator.

In a text editor, open the file Apache_home/conf/httpd.conf.
Alias your install_dir/ptimages/imageserver directory to /imageserver/ on the Web server by adding the following alias to the httpd.conf file:
```
Alias /imageserver/ “install_dir/ptimages/imageserver/”
```

Create a Directory entry for the imageserver directory:

<Directory “install_dir/ptimages/imageserver”>
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>

Include the bea.conf file you will create next.
```
Include conf/bea.conf
```
Save httpd.conf and exit the text editor.

In the same folder as the httpd.conf, create a bea.conf file with the following contents, replacing wls-hostname and wls-port with the actual host name and port number:

LoadModule weblogic_module     lib/mod_wl_22.so
# the local weblogic setup
<IfModule mod_weblogic.c>
  WebLogicHost wls-hostname
  WebLogicPort wls-port
  MatchExpression /portal/*
</IfModule>

From the wls_server installed location, copy mod_wl_22.so to the corresponding app server lib folder (for example, for http server, copy to /usr/local/apache2/lib).

Verify /opt/oracle/middleware/wci/ptimages/imageserver is readable by Apache HTTP Server:

$ chmod a+r /opt
$ chmod a+r /opt/oracle
$ chmod a+r /opt/oracle/middleware/wci
$ chmod a+r /opt/oracle/middleware/wci/ptimages
$ chmod -R a+r /opt/oracle/middleware/wci/ptimages/imageserver

When Apache HTTP Server is restarted, http://webserver:8082/imageserver/ should point to install_dir/ptimages/imageserver/.