3 Installation

This chapter describes how to install Oracle WebCenter Ensemble.

For a high-level overview intended to quickly guide an experienced user through the install process, see Chapter 2, "Quickstart Overview."

For instructions on upgrading to the latest version of Oracle WebCenter Ensemble, see Chapter 4, "Upgrade."

To install Oracle WebCenter Ensemble:

1. Verify that you have met the prerequisites for installation. For details, see Chapter 1, "Installation Prerequisites."

2. Configure the Oracle WebCenter Ensemble database. For details, see Creating and Configuring the Oracle WebCenter Ensemble Database.

   
   

   Note: When you install an Evaluation version of Oracle WebCenter Ensemble, the Oracle WebCenter Ensemble database is automatically configured. If you are installing an Evaluation version of Oracle WebCenter Ensemble, you do not need to perform this procedure.

   
   

3. Grant user and group access rights to Oracle Inventory directories. For details, see Granting User and Group Access Rights to Oracle Inventory Directories.

4. Install the Oracle WebCenter Ensemble components. For details, see Installing the Oracle WebCenter Ensemble Components.

5. Configure the ALUI Security database. For details, see Creating and Configuring the ALUI Security Database.

   
   

   Note: When you install an Evaluation version of Oracle WebCenter Ensemble, the ALUI Security database is automatically configured. If you are installing an Evaluation version of Oracle WebCenter Ensemble, you do not need to perform this procedure.

   
   

6. If you are implementing an Evaluation install of Oracle WebCenter Ensemble in a Production environment, delete the sample evaluation data. For details, see Creating and Configuring the ALUI Security Database.

7. Start and verify Oracle WebCenter Ensemble services. For details, see Starting and Verifying Oracle WebCenter Ensemble Services.

   
   

   Note: If you are installing the Evaluation version of Oracle WebCenter Ensemble, you do not need to start and verify Oracle WebCenter Ensemble services. The Evaluation version of Oracle WebCenter Ensemble handles this automatically.

   
   

Creating and Configuring the Oracle WebCenter Ensemble Database

This section describes how to create and configure the database used by Oracle WebCenter Ensemble. It is expected that the person setting up the Oracle WebCenter Ensemble database has a strong understanding of database system administration.

Note: When you install an Evaluation version of Oracle WebCenter Ensemble, the Oracle WebCenter Ensemble database is automatically configured. If you are installing an Evaluation version of Oracle WebCenter Ensemble, you do not need to perform this procedure.

To set up the Oracle WebCenter Ensemble database, follow the steps in the subsection appropriate to your environment:

• To set up the Oracle WebCenter Ensemble databases on Microsoft SQL Server, see Creating and Configuring the Oracle WebCenter Ensemble Database on Microsoft SQL Server.

• To set up the Oracle WebCenter Ensemble databases on Oracle, see Creating and Configuring the Oracle WebCenter Ensemble Tablespace on Oracle.

Creating and Configuring the Oracle WebCenter Ensemble Database on Microsoft SQL Server

This section describes how to create and configure the Oracle WebCenter Ensemble database on Microsoft SQL Server.

To set up the Oracle WebCenter Ensemble database on SQL Server:

1. Create the Oracle WebCenter Ensemble database:

   1. Set the Oracle WebCenter Ensemble database name to the name you specified for the Oracle WebCenter Ensemble database when you completed the worksheets provided in the Configuration Worksheets for Oracle WebCenter Ensemble 10.3.

   2. Verify that the initial size of the Oracle WebCenter Ensemble database is sufficient for your Oracle WebCenter Ensemble deployment. For a relatively small installation, configure a database that is at least 100 MB. For a large enterprise with as many as 20,000 users, configure a database that is as large as 1 GB.

   3. (SQL Server 2005 only) Configure the Oracle WebCenter Ensemble database to use SQL Server 2000 (80) compatibility level.

2. Create the Oracle WebCenter Ensemble database user:

   1. Create the Oracle WebCenter Ensemble database user with the user name you designated when you completed the worksheets provided in the Configuration Worksheets for Oracle WebCenter Ensemble 10.3.

   2. Configure the Oracle WebCenter Ensemble database user's authentication mode:

      • On SQL Server 2000, select SQL Server Authentication.

      • On SQL Server 2005, select SQL Server Authentication mode.

   3. Set the Oracle WebCenter Ensemble database user password to the password you designated when you completed the worksheets provided in the Configuration Worksheets for Oracle WebCenter Ensemble 10.3.

   4. Set the Oracle WebCenter Ensemble database user's default database to the Oracle WebCenter Ensemble database.

   5. Grant the Oracle WebCenter Ensemble database user the db_owner role for the Oracle WebCenter Ensemble database.

   6. (SQL Server 2000 only) On the Oracle WebCenter Ensemble database Properties > Permissions tab, grant the Oracle WebCenter Ensemble database user all permissions on the Oracle WebCenter Ensemble database.

When Oracle WebCenter Ensemble is first launched, it seeds the Oracle WebCenter Ensemble database. For this reason, it is not necessary to run database configuration scripts.

Creating and Configuring the Oracle WebCenter Ensemble Tablespace on Oracle

This section discusses how to create and configure the Oracle WebCenter Ensemble tablespace on Oracle.

To set up the Oracle WebCenter Ensemble tablespace on Oracle:

1. Create the Oracle WebCenter Ensemble tablespace:

   1. Create a new tablespace for Oracle WebCenter Ensemble in the Oracle WebCenter Interaction portal database instance.

   2. Use the name you designated for the Oracle WebCenter Ensemble tablespace when you completed the worksheets provided in the Configuration Worksheets for Oracle WebCenter Ensemble 10.3.

   3. Verify that the initial size of the tablespace is sufficient for your Oracle WebCenter Ensemble deployment. For a relatively small installation, configure a tablespace that is at least 100 MB. For a large enterprise with as many as 20,000 users, configure a tablespace that is as large as 1 GB.

   4. Configure the newly created Oracle WebCenter Ensemble tablespace to Automatically extend data file.

2. Create the Oracle WebCenter Ensemble schema user:

   1. Use the name you designated for the Oracle WebCenter Ensemble schema user when you completed the worksheets provided in the Configuration Worksheets for Oracle WebCenter Ensemble 10.3.

   2. Grant the Oracle WebCenter Ensemble schema user default ownership of the newly created Oracle WebCenter Ensemble tablespace.

   3. Grant the Oracle WebCenter Ensemble schema user the Resource role.

When Oracle WebCenter Ensemble is first launched, it seeds the Oracle WebCenter Ensemble database. For this reason, it is not necessary to run database configuration scripts.

Granting User and Group Access Rights to Oracle Inventory Directories

(Linux/UNIX only) Oracle Inventory contains files that provide the Oracle Universal Installer with the locations of the ORACLE_HOME directories on a particular machine. For Oracle Inventory to function properly, the user that installs Oracle WebCenter Ensemble must have access rights to the directories that contain Oracle Inventory's files. This section describes how to run the ouais.sh shell script, which sets user and group access rights for these directories.

Note: You do not need to perform this procedure if you are installing Oracle WebCenter Ensemble on Windows.

Note: If you are installing Oracle WebCenter Ensemble on Linux or UNIX operating systems, you do not need to perform this procedure if, as the same user that is installing Oracle WebCenter Ensemble, you have already installed at least one of the following products on the same machine on which you are installing Oracle WebCenter Ensemble: Oracle WebCenter Interaction 10.3 Oracle WebCenter Collaboration 10.3 Oracle WebCenter Analytics 10.3 Oracle WSRP Consumer 10.3 Oracle WebCenter Interaction Identity Service for LDAP 10.3 Oracle WebCenter Content Service for Documentum 10.3

To grant user and group access rights to Oracle Inventory directories:

1. Log in to the remote server host computer as the root user.

2. Copy the ouais.sh script to the machine onto which you will be installing Oracle WebCenter Ensemble.

   This script is located in the same location as the Oracle WebCenter Ensemble installer file.

3. Change the current directory (cd) to be the directory to which you copied the ouais.sh script.

4. Run the ouais.sh shell script.

   As arguments to the script, specify the user and group that will be running the Oracle WebCenter Ensemble installer. For example, you would use the following command to run the ouais.sh script from the root shell:

   ./ouais.sh -u oracleuser -g oraclegroup
   

   The ouais.sh script creates the Oracle Inventory directory if it did not exist before you ran the script. Additionally, the script grants user and group ownership to the directories that contain the files that are used by Oracle Inventory.

Installing the Oracle WebCenter Ensemble Components

This section describes how to install the Oracle WebCenter Ensemble components. The Oracle WebCenter Ensemble components are:

• Administrative UI and Login Server

• ALUI Directory

  
  

  Note: The ALUI Directory component is not required to run Oracle WebCenter Ensemble.

  
  

• Proxy

When performing a clean install, you can install the Oracle WebCenter Ensemble components in any order; however, you should not start any of the components until all components are installed.

Launching the Oracle WebCenter Ensemble Installer

This section describes how to launch the Oracle WebCenter Ensemble installer.

To launch the Oracle WebCenter Ensemble installer:

1. Log into the Oracle WebCenter Ensemble host machine as the local Administrator.

   
   

   Note: For UNIX and Linux installations, you must run the Oracle WebCenter Ensemble installer as the user that you specifed in the procedure Granting User and Group Access Rights to Oracle Inventory Directories. You specified the user who will run the product installer as an argument to the ouais.sh script.

   
   

2. Copy the installer, WebCenterEnsemble_10.3.0.0.0.exe, to a temporary location.

3. Close all unnecessary windows and applications.

4. Stop all Oracle WebCenter services on the host.

5. Double-click WebCenterEnsemble_10.3.0.0.0.exe to launch the installer.

Completing the Installer Wizard Pages

The following tables describe the Oracle WebCenter Ensemble installer wizard pages. The installer wizard pages that appear vary according to the selections you choose.

Note: If the installer setting does not apply to your Web application server or to the Oracle WebCenter Ensemble components you are installing, the installer does not display the wizard page.

Wizard Page	Description
Introduction	This installer wizard page provides a brief description of the installer.
Choose Install Set	Click either Evaluation or Custom: If you choose to install an Evaluation version, a lightweight database and LDAP server is installed and configured. The Oracle WebCenter Ensemble application is configured automatically and launches when the installation process is complete. Both the evaluation and Custom versions of Oracle WebCenter Ensemble install the same components. If you choose to install the Evaluation version, you can later use Oracle WebCenter Configuration Manager to change configurations of Oracle WebCenter Ensemble settings. If you choose to install a Custom version, you will be prompted to run Oracle WebCenter Configuration Manager when the installation process is complete in order to configure Oracle WebCenter Ensemble to connect to the Oracle WebCenter Ensemble database, ALUI Security database, and your LDAP server.
Choose Components	Select either Evaluation or Custom. If you select Evaluation, the installer automatically installs and configures all necessary components to run Oracle WebCenter Ensemble in a standalone evaluation environment. This includes the installation, configuration, and seeding of the ALUI Security and Oracle WebCenter Ensemble databases. If you select Custom, you can select the following individual components to install according to your deployment plan: Administrative UI and Login Server: This component contains the administrative user interface and the Login Server. The Login Server manages end user logins using a custom login resource that you configure, such as LDAP or Active Directory. ALUI Directory: This component installs the ALUI Directory server, which behaves like an LDAP server to serve ALUI Security authentication data. This component is not required to run Oracle WebCenter Ensemble. Proxy: This component installs the core Oracle WebCenter Ensemble files.
Installation Location	Accept the default installation folder or select a different folder in which to install Oracle WebCenter Ensemble.
Configuration Manager - Port and Password	Enter the Port and Password for the Oracle WebCenter Configuration Manager web tool. Oracle WebCenter Configuration Manager will be used to complete the installation of Oracle WebCenter Ensemble.
Pre-Installation Summary	Review the list of components to be installed. Click Install.
Launch Configuration Manager	This installation wizard page lets you access Oracle WebCenter Configuration Manager to configure Oracle WebCenter Ensemble components. Click the link on this installation wizard page to access Oracle WebCenter Configuration Manager. The default username for logging into Oracle WebCenter Configuration Manager is administrator. Use the password that you typed into the Configuration Manager - Port and Password installation wizard page. In Oracle WebCenter Configuration Manager, configure all settings for the Ensemble, Ensemble Administrative UI, Ensemble Login Server, and Ensemble Proxy application names. Note that in Oracle WebCenter Configuration Manager, all URLs for Oracle WebCenter Ensemble components must be set to the Full Qualified Domain Name (FQDN), otherwise unexpected results might occur. Use the database and connectivity settings that you provisioned when you completed the Configuration Worksheets for Oracle WebCenter Ensemble 10.3. Online Help for these settings is available in the Oracle WebCenter Configuration Manager application. When you have completed all Oracle WebCenter Configuration Manager tasks, return to the installer and click Next.

Creating and Configuring the ALUI Security Database

This section describes how to set up the ALUI Security database. This section contains the following sections:

• Creating and Configuring the ALUI Security Database on Microsoft SQL Server

• Creating and Configuring the ALUI Security Database on Oracle

Creating and Configuring the ALUI Security Database on Microsoft SQL Server

This section describes how to set up the ALUI Security database on Microsoft SQL Server.

Note: When you install an Evaluation version of Oracle WebCenter Ensemble, the ALUI Security database is automatically configured. If you are installing an Evaluation version of Oracle WebCenter Ensemble, you do not need to perform this procedure.

To create and set up the ALUI Security database on Microsoft SQL Server:

1. On the computer to which you installed the BEA AL Ensemble service, copy the scripts from install_dir\ensembleadminui\10.3.0\sql\mssql to the ALUI Security database host computer.

   This folder contains the script that you will use to configure the ALUI Security database.

2. In SQL Server Management Studio, access the database engine's properties.

   If the database is currently set to use Windows Authentication, configure the database engine to use SQL Server and Windows Authentication mode, then restart the database engine.

3. Create the ALUI Security database user:

   1. Create the ALUI Security database user with the user name you provisioned when you completed the Configuration Worksheet, which is included in the Configuration Worksheets for Oracle WebCenter Ensemble 10.3.

   2. Configure the ALUI Security database user to use SQL Server Authentication.

   3. Set the ALUI Security database user password to the password you designated when you completed the Configuration Worksheets for Oracle WebCenter Ensemble 10.3.

4. Create the ALUI Security database with the name you provisioned when you completed the Configuration Worksheet, which is included in the Configuration Worksheets for Oracle WebCenter Ensemble 10.3.

5. Change the default database for the ALUI Security database user to the ALUI Security database.

6. Grant the ALUI Security database user the db_owner role for the ALUI Security database.

7. Connect to the ALUI Security database as the ALUI Security database user, using SQL Server Authentication.

8. Run the create_security_tables.sql script, located in the folder that you copied in Step 1.

   
   

   Note: Do not run the create_security_tables.sql script more than once. If you run this script more than once, the ALUI Security database will become invalid and you will need to recreate the ALUI Security database.

   
   

Creating and Configuring the ALUI Security Database on Oracle

This section describes how to set up the ALUI Security database on Oracle.

Note: When you install an Evaluation version of Oracle WebCenter Ensemble, the ALUI Security database is automatically configured. If you are installing an Evaluation version of Oracle WebCenter Ensemble, you do not need to perform this procedure.

To create and set up the ALUI Security database on Oracle:

1. On the computer on which you installed the BEA AL Ensemble service, copy the oracle directory from install_dir\ensembleadminui\10.3.0\sql\oracle to the ALUI Security database's host computer.

   This folder contains the script that you will use to configure the ALUI Security database.

2. Log on to the host computer for the ALUI Security database as owner of the Oracle system files.

3. Create the ALUI Security database tablespace.

4. Create the ALUI Security database user.

5. Add the ALUI Security database user and password values into the Configuration Worksheets for Oracle WebCenter Ensemble 10.3. (you will enter these values into Oracle WebCenter Configuration Manager when configuring Oracle WebCenter Ensemble database settings).

6. Connect to the ALUI Security database as the ALUI Security database user.

7. Run the create_security_tables.sql script, located in the folder that you copied in Step 1.

8. Run your database's analysis tool on the ALUI Security database to the efficiency of the database.

Deleting Sample Data

By default, installing the Evaluation install of Oracle WebCenter Ensemble installs and configures an embedded LDAP server. The embedded LDAP server includes sample users; the database server includes sample resources and sample pagelets.

You should delete this sample data before implementing Oracle WebCenter Ensemble in a Production environment.

Starting and Verifying Oracle WebCenter Ensemble Services

This section describes how to start Oracle WebCenter Ensemble services and verify operation.

Note: If you installed the Evaluation version of Oracle WebCenter Ensemble, you do not need to start and verify Oracle WebCenter Ensemble services. The Evaluation version of Oracle WebCenter Ensemble handles this automatically. If you installed a Custom version of Oracle WebCenter Ensemble, ensure that your user directory is running (either the ALUI Directory component or your LDAP server) before performing these procedures. Your user directory component must be running for Oracle WebCenter Ensemble to start successfully. Additionally, ensure that the server hosting the Oracle WebCenter Ensemble database is running.

Note: For each service below, the URL to verify the service is given with the default port. If you specified a different port during configuration of Ensemble, use that port.

Starting and Verifying the Login Server

To start and verify the Login Server

1. From Services, select and start the BEA AL Login Server service.

2. Verify the operation of the Login Server by browsing to the URL: http://ensemble_adminui_host:20060/loginserver/login/

   The directory listing for /login/ is displayed.

Starting and Verifying the Ensemble Administrative UI

To start and verify the Ensemble Administrative UI:

1. From Services, select and start the BEA AL Ensemble Administrative UI service.

2. Verify the operation of the Ensemble Administrative UI by browsing to the Administrative UI URL: http://ensemble_adminui_host:20070/ensembleadminui/run/

   The Ensemble Console is displayed. The default username is Administrator. The default password is pass.

Starting and Verifying the Ensemble Proxy

To start and verify the Ensemble Proxy:

1. From Services, select and start the BEA AL Ensemble Proxy service.

2. Verify the operation of the Ensemble Proxy by browsing to the Proxy URL: http://ensemble_proxy_host:20050/welcome