Deploying Oracle Collaboration Suite in a Single-Box Installation

Purpose

The goal of this tutorial is to show you how install Oracle Collaboration Suite (OCS) on a single-box using the Advanced Installation option. This includes all components of OCS, including Infrastructure, OCS Database, and the Mid-Tier applications

Time to Complete

Approximately 1 hour (this will depend on your machine setup).

Topics

This tutorial covers the following topics:

 Overview
 Prerequisites

Perform a Single-Box Installation of OCS

Perform Post Installation Steps

 Summary

Viewing Screenshots

 Place the cursor over this icon to load and view all the screenshots for this tutorial. (Caution: This action loads all screenshots simultaneously, so, depending on your Internet connection, may result in a slow response time.)

Note: Alternatively, you can place the cursor over an individual icon in the following steps to load and view only the screenshot associated with that step. You can hide an individual screenshot by clicking it.

Overview

This tutorial covers how to install all of the components of OCS on one single machine. Typically, Oracle recommends that you install Oracle Application Server Infrastructure and Oracle Collaboration Suite Applications on different computers for better performance. However, for smaller production environments, or for a test environment, a single-box installation can be used.

The focus of this tutorial is to provide an overview of each step involved in the installation process.

Back to Topic List

Prerequisites

Before starting this tutorial, you should:

1.

Verify the hardware requirements on your machine (assuming that Linux Red Hat 3.0 is being used):

Item
Minimum Requirement
Command to Check

Processor type

Pentium (32-bit)

Processor speed

450 MHz or faster

IP

Static or DHCP

Memory

2 GB RAM

prompt> grep MemTotal /proc/meminfo

Disk space

Oracle Collaboration Suite Infrastructure: 2.5 GB
Oracle Collaboration Suite Applications: 2.5 GB
Oracle Collaboration Suite Database: 3.6 GB

prompt> df -m <dir>

Space in /tmp

250 MB

prompt> df -m /tmp

Swap space

4 GB

prompt> grep SwapTotal /proc/meminfo

Monitor

256 color display

2.

Verify the software requirements on your machine (assuming again that Linux Red Hat 3.0 is being used):

Item
Requirement
Command to Check

Operating system

Red Hat 3.0
Update 4
Kernel version:
kernel-2.4.21-27.EL or
kernel-smp-2.4.21-27.EL or
kernel-hugemem-2.4.21-27.EL

prompt> uname -a

Software packages

glibc-2.3.2-95.30
glibc-common-2.3.2-95.30
binutils-2.14.90.0.4-35
compat-db-4.0.14-5.1
compat-glibc-7.x-2.2.4.32.6
compat-libstdc++-7.3-2.96.128
compat-libstdc++-devel-7.3-2.96.128
gcc-3.2.3-47
gcc-c++-3.2.3-47
libstdc++-3.2.3-47
libstdc++-devel-3.2.3-47
openmotif21-2.1.30-8
pdksh-5.2.14-21
setarch-1.3-1
make-3.79.1-17
gnome-libs-1.4.1.2.90-34.2
sysstat-5.0.5-5.rhel3

prompt> rpm -qa <package_name>

 

3.

Verify the kernel parameter settings:

Kernel
Parameter Setting
Configuration file

kernel.sem

256 32000 100 142

/etc/sysctl.conf

kernel.shmmax

2147483648

kernel.shmmni

4096

 

kernel.shmall

3279547

 

kernel.msgmni

2878

 

kernel.msgmax

8192

 

kernel.msgmnb

65535

 

fs.file-max

327679

 

ip_local_port_range 1024 65000  

 

4.

To improve the performance or the software on Linux systems, you must increase the following shell limits for the oracle user, depending on the user's default shell.

To increase the shell limits, complete the following steps:

1. Add the following lines to /etc/security/limits.conf file:

* soft nproc 4096
* hard nproc 16384
* soft nofile 16384
* hard nofile 65536

2. Add the following lines to the /etc/pam.d/login file, if it does not already exist:

session required /lib/security/pam_limits.so

3. Depending on the oracle user's default shell, make the following changes to the default shell start-up file.

For the Bourne, Bash, or Korn shell, add the following lines to the /etc/profile file:


Back to Topic List

Perform a Single-Box Installation of OCS

To begin an installation of OCS, perform the following steps:

1.

At the prompt, invoke the Installation wizard by executing the following command:

>$ /stage/DVD_1/runInstaller

 

2.

The Welcome page appears. Select Advanced Installation. Click Next to continue.


3.

On the Specify Inventory directory and credentials window, you can set the full path of the inventory directory and the operating system group name. For this example, all of the default values are used. Click Next.

 

4.

During the installation process, a script needs to be run in order to continue

 

5.

Open a new window and log in as root. Navigate to the oraInventory directory and execute the orainstRoot.sh script by typing the commands listed below.

>$ cd /u01/app/oracle/oraInventory
>$./orainstRoot.sh

 

6.

Once the script has finished, return to the Installation Wizard and click Continue.

 

7.

In the Specify File Locations window, set both the Source and Destination file locations of the products that you want to install. Click Next.

 

8.

The Select a Product to Install window gives you three installation options. Select Oracle Collaboration Suite Infrastructure and Applications 10.1.2.0.0. Click Next.

 

9.

The Oracle Universal Installer performs product-specific prerequisite checks. In order to proceed, click Next.

 

10.

You can select the language in which Oracle Collaboration Suite will run. To select all the available languages, click the >> button.

 

11.

Click Next to continue.

 

12.

Because a single box installation was selected in the previous window, the Oracle Collaboration Suite Infrastructure and Applications Methodology window appears. From this window, you can verify the order and the location where OCS will be installed. Click Next.

 

13.

On the Select Components to Configure window, all of the OCS components are selected by default. You can deselect any if you would like to configure them at a later time. Click Next.

 

14.

The Specify Namespace in Internet Directory window allows you to specify a location, or namespace, in the Oracle Internet Directory. By default, the Suggested Namespace is selected. Click Next.

 

15.

On the Specify Database Configuration Options window, input the Global Database Name and the SID. Under the Database Character Set region, Oracle Collaboration Suite defaults to the Database Character set used for this installation. For this example, all of the default values are accepted. Click Next.

 

16.

Within the Specify Database Schema Passwords window, you have the choice of setting different passwords for each of the pre-loaded schemas (this is the default value), or to use the same password for all of the accounts. This example uses the Use the same password for all of the above accounts option. Input and confirm the necessary password. Note that the password has to be alphanumberic. Click Next.

 

17.

On the Specify Application Passwords window, you have the choice of using different passwords (the default) or using the same password for the administrative accounts associated with OCS. For this example, the Use the same password for all of the above accounts is selected. Input and confirm the necessary password. Note that the password has to be alphanumberic. Click Next.

 

18.

The next window, Specify E-Mail Domain Information, allows you to specify the E-mail domain served by this E-Mail server installation. Input your domain in the E-mail Domain field. Click Next.

 

19.

There are a number of ports that need to be configured for OCS. On the Specify Port Configuration Options window, you can either chose to have the ports configured automatically (the default value) or manually. For this example, Automatic Port Selection is kept as the default. Click Next.

 

20.

The Summary window appears. From this window you can view the Global Settings, Product Languages, Space Requirements, and New Installations. If you would like to change any of the configurations, you can select the Back button. Otherwise, click Install to begin the installation process.

 

21.

During the installation process, a script needs to be run as root in order to continue:

 

22.

Open a new window and log in as root. Navigate to the infra directory and execute the root.sh script by typing the commands listed below:

>$ cd /u01/app/oracle/product/10.1.2/ocs_1/infra
>$./root.sh

 

23.

Once the script has finished, return back to the Installation Wizard and click OK.

 

24.

The next window, Configuration Assistants, configures and starts the components that were selected earlier.

 

25.

The Database Configuration Assistant appears, and will close automatically when database configuration completes.

 

26.

Next begins the installation of the Mid-Tier applications.

 

27.

During this installation process, a script needs to be run in order to continue.

 

28.

Open a new window and log in as root. Navigate to the apps directory and execute the root.sh script by typing the commands listed below.

>$ cd /u01/app/oracle/product/10.1.2/ocs_1/apps
>$./root.sh

 

29.

Once the script has finished, return back to the Installation Wizard and click OK.

 

30.

The next window, Configuration Assistants, configures and starts the components that were selected earlier.

 

31.

When the installation of OCS has completed successfully, the End of Installation appears. Click Exit to quit the Installation wizard.

 

32.

Click Yes to confirm.

 

Back to Topic List

 

Perform Post Installation Steps

 Start the Oracle Mail Listener
 Provision orclguest for Content Services and Real-Time Collaboration

Back to Topic List

Start the Oracle Mail Listener

The Oracle Mail listener, listener_es , listens for requests to send e-mail. Because the Email listener listens on the privileged port 25, a privileged user, such as root, must start the listener. To start this listener, perform the following steps:

1.

Login as root to your machine hosting your OCS installation and set the ORACLE_HOME variable:

>$ export ORACLE_HOME=/u01/app/oracle/product/10.1.2/ocs_1/apps


2.

Find out the ID and group ID of the oracle user who installed OCS:

>$ id oracle

uid=502(oracle) gid=502(oinstall) groups=502(oinstall)

 

3.

Start the E-Mail listener using the following command:

>$ $ORACLE_HOME/bin/tnslsnr listener_es -user 502 -group 502 &

 

4.

Verify the listener is running:

>$ ps -ef | grep listener_es

oracle 1765 1 Oct01 ? 00:00:00 /u01/app/oracle/product/10.1.1
/ocs_1/apps/bin/tnslsnr listener_es -user 502 -group502

 

Back to Topic List

Provision orclguest for Content Services and Real-Time Collaboration

To provision orclguest for Content Services and Real-Time Collaboration, perform the following steps:

1.

Open a browser window and access the Oracle Internet Directory Self Service Console. Click the Login link.

 

2.

Login as orcladmin. Click Login.

 

3.

Click the Directory tab.

 

4.

Enter orclguest in the Search box, and then click Go.

 

5.

Select orclguest, and then click Edit.

 

6.

Click Next.

 

7.

Note that Content Services and Real-Time Collaboration (RTC) are available to be provisioned. Click Next.

 

8.

Click Next.

 

9.

Scroll down the page and verify that Content Services and RTC are listed in the Applications to be provisioned section.

 

10.

Click Finish.

 

11.

Note that the alert that orclguest account was successfully modified.

 

Back to Topic List

 

Summary

In this lesson, you have learned how to:

 Install OCS on a single-box
 Perform Post Installation steps

Back to Topic List

 Place the cursor over this icon to hide all screenshots.

 

 

 

Left Curve
Popular Downloads
Right Curve
Untitled Document