1
Preinstallation

This chapter describes the preinstallation procedures for Oracle Unified Messaging. Topics covered include:

• Installation Overview

• Installation Requirements

• Preinstallation Tasks

Installation Overview

Oracle Unified Messaging is a highly scalable, messaging framework which integrates messages from multiple sources into a single inbox. Prior to installation, you should plan your implementation strategy and be familiar with Unified Messaging system components, concepts, and terminology described in the Unified Messaging Client Developer's Guide.

The installation process is composed of the following steps:

1. Complete the necessary pre-installation tasks including backing up your existing system, configuring the UNIX environment, and preparing related processes and products for the installation.

2. Use the Installer on the Oracle software CD to install or upgrade Oracle Unified Messaging and related software products.

3. Perform the post installation steps.

4. Verify the configuration by starting processes and checking process logs.

Installation Requirements

You must meet the following system and software requirements to install Oracle Unified Messaging.

System Requirements

• 50 MB of disk space

• 128 MB of memory

Software Requirements

Oracle Unified Messaging requires the following software components and associated versions:

Software Components	Version	Comments	State During Unified Messaging Installation
Oracle eMail Server	5.2		Installed and running
Oracle8i Data Server	8.1.7		Installed and running
Oracle Internet Directory	2.1.1		Installed and running
Oracle Internet Application Server (Oracle HTTP Server)	1.0.2.1	Required for Web node only. Oracle Internet Application Server cannot share the same ORACLE_HOME with other Oracle products. If you have installed other Oracle products, then Oracle Internet Application Server must be installed in a different ORACLE_HOME.	Installed and running
Netscape Communicator Or: Microsoft Internet Explorer JavaScript-enabled browser	4.6 or 4.7 5.0.x		Either one installed
Real Audio Server (optional)	5.0	Required for real audio streaming.	Installed and running
Tiff to Gif Conversion Tool (optional)		Required if your fax server captures images in .tiff format.	Installed and running

Preinstallation Tasks

The following tasks must be performed prior to installing Oracle Unified Messaging:

Task 1: Back Up and Shut down Existing Database and Log Files

Perform a full backup of your existing Oracle8 Universal Data Server before you perform any new installation or upgrade. A full backup ensures that you can recover from errors encountered during new installation or upgrade processes.

This backup should be taken with the database shut down cleanly. If you use SHUT DOWN IMMEDIATE or SHUT DOWN ABORT to force users off the system, be sure to restart the database in restricted mode, and then shut it down with normal priority. See the Oracle8i Administrator's Guide or Oracle8i Backup and Recovery for more information.

Task 2: Install and Configure the Oracle8 Universal Data Server

Oracle Unified Messaging requires reconfiguration of specific database parameters. Before starting this configuration, shut down the network listener and the database where Oracle Unified Messaging will be installed.

To shut down the network listener:

$ lsnrctl stop

To shut down the database:

$ svrmgrl
SVRMGR> connect internal
Connected.
SVRMGR> shutdown
SVRMGR> exit

Edit the init<sid>.ora file located in the $ORACLE_HOME/dbs directory to reflect the following minimum values for the listed parameters:

Parameter	Minimum Settings
job_queue_processes	10
job_queue_interval	60

Task 3: Start the Processes Necessary for Installation

1. Start the database:

   $ svrmgrl
   SVRMGR> connect internal
   Connected to an idle instance.
   SVRMGR> startup
   SVRMGR> exit
   
   

2. Start the network listener:

   $ lsnrctl start
   

Task 4: Configure Net8 (Database Node Installation) TNSLISTENER80

To install an Unified Messaging database node, a connect string must exist that provides a connection to the Unified Messaging database using the sid.

1. Verify that the entry exists in the TNSNAMES.ORA file for the Unified Messaging sid. If it does not exist, add the following:

   <connect string> =
       (DESCRIPTION=
           (ADDRESS_LIST =
           (ADDRESS = (PROTOCOL = tcp)
   

   (HOST = <um host name>)
   (PORT = <listener port>)
   )
   )
   )
   Example:
   

   ORCL.world =
       (DESCRIPTION=
           (ADDRESS_LIST =
           (ADDRESS = (community = tcp.world) (PROTOCOL =tcp)
   

   (HOST = um.acme.com)
   (PORT = 1521)
   )
   )
   (CONNECT_DATA = (SERVICE_NAME = ORCL)
   )
   )
   
   

Task 5: Configure Net8 (Multiple Instance Installations Only)

If you are installing a separate Oracle Unified Messaging system from your Oracle eMail Server database instance, then you must configure Net8 to enable the Oracle Unified Messaging system to contact the Oracle eMail Server database.

1. Add the following entry for the Oracle eMail Server database system to which you want to connect:

   <connect string> =
       (DESCRIPTION=
           (ADDRESS=( PROTOCOL= TCP)(HOST= <ES host server name>)(PORT= 1521))
           (CONNECT_DATA= (SERVICE_NAME= <ES sid>)))
   

Example

esnode1=
    (DESCRIPTION =
        (ADDRESS = (PROTOCOL= TCP) (HOST= eshardware.acme.com)(PORT=1521))
        (CONNECT_DATA = (SERVICE_NAME= orcl)))

Verify the modified tnsnames.ora file:

$ tnsping host

Verify that the Oracle eMail Server database tnsnames.ora file has an Oracle Unified Messaging entry name that connects to the Oracle eMail Server database instance.