Oracle A86091-02 User Manual

Oracle Unified Messaging

Installation Guide

Release 2.1.2 for Sun SPARC Solaris 2.6

January, 2001
Part No. A86091-02

Unified Messaging Insta lla t ion G u id e , Rel e ase 2. 1. 2 for Sun SPARC Solaris 2.6
Part No. A86091-02

Copyright © 1996, 2001 Oracle Corporation. All rights reserved .
Primary Author: Ginger Tabora
Contributors: Byung Choung, Varouzhan Ebrahimian, Duane Jensen, Tom Kraikit, Jae Lee, Sunia Lin,

Allen Liu, Louise Lu o, Stefano Montero, Howard Narvae z, Ric ardo Rivera
The Programs (which include bo th t he so ft ware and documentation) con tain proprietary information of

Oracle Corporation; they are provided under a license agreement containing restrictions on use and
disclosure and are also protected by copyrigh t , paten t, and other intellectual and in d u strial property
laws. Reverse engineering, disassembly, or decompilation of the Programs is prohibited.

The information contained in this document is subject to change without notice. If you find any problems
in the documentat ion, please report them to u s in writing. Oracle Corporation does not wa rrant that this
document is error free. Except as may be expressly permitted in your license agreement for these
Programs, no part of these Programs may be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without t he e xp res s wri tt en permission of Oracle Corporation.

If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on
behalf of the U.S . Government, th e following no tice is applicable:

Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial
computer software" and use , duplication, and disclo sure of the Prog rams, including docu me n t at ion,
shall be subject to the lice ns ing restrictions set forth in the appli cable Oracle license agreem e n t .
Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer
software" and use, duplic at ion, and disclosure of the Programs sh all be subject to the restrictions in FAR

52.227-19, Commercial Comput e r Soft w are - Rest ri ct e d Righ t s (Jun e, 1987). Oracle Corporation, 500
Oracle Parkway, Redwood City, CA 94065.

The Programs are not intended for use in an y nucle ar, aviation, mass transi t, me d ic al, or other inherently
dangerous applications. It shall be the licensee's responsibilit y to take al l approp riate fail-safe, backup,
redundancy, and other measures to ensure the sa fe u se of such applications if the Programs are used for
such purposes, and Oracle Cor p ora t ion disclaims liability for any damages caused by such use of the
Programs.

Oracle is a registered trademark, and Oracle Names, and Oracle Office are trademarks or registered
trademarks of Oracle Corporation. Other nam e s m e nt ioned may be trademarks of their respective
owners.

Contents

Preface........................................................................................................................................................... vii

1 Preinstallation

Installation Overview ........................................................................................................................ 1-2

Installation Requirements ................................................................................................................ 1-2

System Requirements................................................................................................................... 1-2

Software Requirements................................................................................................................ 1-3

Preinstallation Tasks.......................................................................................................................... 1-3

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

Task 2: Install and Configure the Oracle8 Universal Data Server......................................... 1-4

Task 3: Start the Processes Necessary for Installation............................................................. 1-4

Task 4: Configure Net8 (Database Node Installation) TNSLISTENER80 ............................ 1-5

Task 5: Configure Net8 (Multiple Instance Installations Only)............................................. 1-6

2 Installing and Configuring Oracle Unified Messaging

Installing Oracle Unified Messaging.............................................................................................. 2-2

Mounting the Product CD-ROM Manually........................................................................... 2-2

Running the Oracle Universal Installer.................................................................................. 2-2

Entering File Locations................................................................................................................ 2-5

Verifying Your Installation Settings .......................................................................................... 2-7

Starting the Configuration Assistant Manually................................................................ 2-9

Configuration Assistant Screen Buttons .......................................................................... 2-10

Specifying File Locations........................................................................................................... 2-11

Entering Passwords.................................................................................................................... 2-13

iii

Specifying Oracle eMail Server Parameters............................................................................ 2-15

Specifying Oracle eMail Server Passwords............................................................................. 2-15

Entering LDAP Information...................................................................................................... 2-16

Exiting the Configuration Assistant......................................................................................... 2-19

3 Post Installation

Post Installation Tasks ....................................................................................................................... 3-2

Task 1: Create the Oracle Unified Messaging LDAP Schema................................................ 3-2

Task 2: Encoding the Helpdesk Password................................................................................ 3-3

Task 3: Configuring the oomgr RMI Process............................................................................ 3-4

Task 4: Starting the Oracle Unified Messaging Processes ...................................................... 3-4

Task 5: Configuring Apache Listener Port................................................................................ 3-4

Task 6: Configuring JServ............................................................................................................ 3-5

Task 7: Starting Apache JServ..................................................................................................... 3-5

Task 8: Configuring HelpDesk ................................................................................................... 3-5

Task 9: Updating Real Audio (only if Real Audio is installed).............................................. 3-6

Task 10: Updating the Tiff to Gif Executable (only if a Tiff to Gif executable is installed) 3-6

4 Troubleshooting

Log Files and Trace Files.................................................................................................................... 4-2

Troubleshooting Hints....................................................................................................................... 4-2

iv

Send Us Your Comments

Oracle Unified Messaging Installation Guide, Release 2.1.2 for Sun SPARC Solaris 2.6
Part No. A86091-02

Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this
publication. Your input is an important part of the information used for revision.

■ Did you find any errors?

■ Is the information clearly presented?

■ Do you need more information? If so, where?

■ Are the examples correct? Do you need more examples?

■ What features did you like most about this manual?

If you find any errors or have any other suggestions for improvement, please indicate the chapter,
section, and page number (if available). You can send comments to us in the following ways:

■ Electronic mail: [e-mail]

■ FAX: [phone] Attn: Unified Messaging Documentation Manager

■ Postal service:

Oracle Corporation
Unified Messaging Documentation Manager
500 Oracle Parkway, Mailstop 4OP12
Redwood Shores, CA 94065
USA

If you would like a reply, please give your name, address, and telephone number below.

If you have problems with the software, please contact your local Oracle Support Services representa­tive.

v

vi

The topics covered in this preface include:

■ Intended Audience

■ Oracle Unified Messaging Docume ntation

■ Related Documents

■ Notation Conventions

Preface

vii

Intended Audience

The configuration and installation instructions in this document are intended for

anyone who is responsible for installing Oracle products on Sun SPARC Solaris.

While some command examples are provided, this document does not attempt to

teach Oracle or UNIX administration.

Oracle Unified Messaging Documentation

Oracle Unified Messaging document ation is available in HTML and PDF format on

the CD-ROM and installs automatica lly during product installation. Use your Web

browser to access $ORACLE_HOME/um/doc/index.html on your server. The following

documents are available:

Oracle Unified Messaging Ins tall a tion Guide

Oracle Unified Messagin g Client Developer’s Guide

Oracle Unified Messagin g Release Notes

Related Documents

This guide provides operating system-specific information for Oracle Unified

Messaging for Sun SPARC Solaris 2.6. This document refers to the following user

guides and reference manuals:

■ Oracle eMail Server 5.1 Installation Guide

■ Oracle eMail Server 5.1 Administration Guide

■ Oracle eMail Server 5.1 Release Notes

■ Oracle Internet Application Server 8i Installation Guide Release 1.0 for Sun SPARC

Ordering Related Documentation

To order documentation, call the appropriate number listed below.

■ In the United States, call Documentation Sales at: 1-800-252-0303.

■ In the United Kingdom, call Oracle Direct Response at: [phone].

■ In other European countries, contact your local Oracle Support office.

■ In the Asia-Pacific region, contact your Oracle sales representative.

viii Installation Guide

Solaris

Notation Conventions

The following notational co nventions appear in this manual:

Convention Description

italic Italicized type identifies document titles.

Monospace Monospace type indicates commands.

bold Boldface type indicates script names, directory names, path names,

UPPERCASE Uppercase letters indicate parameters or environment variables (for

.
.
.

. . . In command syntax, horizontal ellipsis points indicat e r e petit ion of

< >

[ ]

{ }

and file names (for example, the root.sh script).

example, ORACLE_HOME).
In code examples, vertical ellipsis points indicate that information

not directly related to the example has been omitted.

the preceding parameters. The following command example
indicates that more than one input_file may be specified on the
command line.

command [input_file ...]

In command syntax, an gle brackets identify var iab les that the user
must supply. You do not type the angle brackets. The following
command example indicates that the user must enter a value for the
variable input_file:

command <input_file>

In command syntax, brackets enclose optional clauses from which
you can choose one or none. You do not type the brackets. The
following command example indicates that the variable output_file
is optional:

command <input_file> [output_file]

In command syntax, curly brackets indicate that a choice of two or
more items separated by a vertical bar or pipe ( | ). You do not type
the curly brackets. The following command example indicates a
choice of either a or b:

command {a | b}

$

The dollar sign represents the shell prompt in UNIX.

ix

x Installation Guide

1

Preinstallation

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

■ Installation Overview

■ Installation Requirements

■ Preinstallation Tasks

Preinstallation 1-1

Installation Overview

Installation Overview

Oracle Unified Messaging is a highly scalable, messaging framewo r k which

integrates messages from multiple sources into a single inbox. Prior to installation,

you should plan your implementation strategy an d 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 follo wing steps:

1. Complete the necessary pre-installation tasks including b acki ng 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 softw are 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

Oracle eMail Server 5.2 Installed and running

Oracle8i Data Server 8.1.7 Installed and running

1-2 Installation Guide

State During Unified
Messaging Installation

Installation Requirements

Software
Components Version Comments

Oracle Internet
Directory

Oracle Internet
Application Server
(Oracle HTTP Server)

Netscape
Communicator

Or:
Microsoft Internet

Explorer
JavaScript-enabled
browser

Real Audio Server
(optional)

Tiff to Gif Conversion
Tool (optional)

2.1.1 Ins ta lled an d ru nn ing

1.0.2.1 Required for Web
node only.

Oracle Inter net
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.

4.6 or 4.7

5.0.x

5.0 Required for real
audio streaming.

Required if your fax
server captures
images in .tiff format.

State During Unified
Messaging Installation

Installed and running

Either one installed

Installed and running

Installed and running

Preinstallation 1-3

Preinstallation Tasks

Preinstallation Tasks

The following tasks must be performed prior to insta lling 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:

To shut down the database:

Edit the init
reflect the following minimum values for the listed parameters:

Parameter Minimum Settings

job_queue_processes 10
job_queue_interval 60

1-4 Installation Guide

$ lsnrctl stop

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

<sid>

.ora file located in the $ORACLE_HOME/dbs directory to