Oracle Unified Messaging Installation Manual

Release 2.1.2 for sun sparc solaris 2.6
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading

Summary of Contents for Oracle Unified Messaging

  • Page 1 Oracle Unified Messaging Installation Guide Release 2.1.2 for Sun SPARC Solaris 2.6 January, 2001 Part No. A86091-02...
  • Page 2 The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant 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 the express written permission of Oracle Corporation.
  • Page 3: Table Of Contents

    Installing and Configuring Oracle Unified Messaging Installing Oracle Unified Messaging....................2-2 Mounting the Product CD-ROM Manually ................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 ................
  • Page 4 Exiting the Configuration Assistant..................2-19 Post Installation Post Installation Tasks ........................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................
  • Page 5 500 Oracle Parkway, Mailstop 4OP12 Redwood Shores, CA 94065 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.
  • Page 7: Preface

    Preface The topics covered in this preface include: Intended Audience Oracle Unified Messaging Documentation Related Documents Notation Conventions...
  • Page 8: Intended Audience

    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.
  • Page 9 Notation Conventions The following notational conventions appear in this manual: Convention Description italic Italicized type identifies document titles. Monospace type indicates commands. Monospace Boldface type indicates script names, directory names, path names, bold and file names (for example, the root.sh script). UPPERCASE Uppercase letters indicate parameters or environment variables (for example, ORACLE_HOME).
  • Page 10 x Installation Guide...
  • Page 11: Preinstallation

    Preinstallation This chapter describes the preinstallation procedures for Oracle Unified Messaging. Topics covered include: Installation Overview Installation Requirements Preinstallation Tasks Preinstallation 1-1...
  • Page 12: Installation Overview

    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. Use the Installer on the Oracle software CD to install or upgrade Oracle Unified Messaging and related software products. Perform the post installation steps.
  • Page 13 Installed and running Directory Oracle Internet 1.0.2.1 Required for Web Installed and running Application Server node only. (Oracle HTTP Server) Oracle Internet Application Server cannot share the same ORACLE_HOME with other Oracle products. If you have installed other Oracle products, then Oracle...
  • Page 14: Preinstallation Tasks

    Preinstallation Tasks 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.
  • Page 15: Task 3: Start The Processes Necessary For Installation

    Preinstallation Tasks Task 3: Start the Processes Necessary for Installation Start the database: $ svrmgrl SVRMGR> connect internal Connected to an idle instance. SVRMGR> startup SVRMGR> exit 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.
  • Page 16: Task 5: Configure Net8 (Multiple Instance Installations Only)

    Preinstallation Tasks 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.
  • Page 17: Installing And Configuring Oracle Unified Messaging

    Installing and Configuring Unified Messaging This chapter describes Unified Messaging installation and configuration procedures for both new installations and upgrades. Topics covered include: Installing Unified Messaging Installing and Configuring Unified Messaging 2-1...
  • Page 18: Mounting The Product Cd-Rom Manually

    # mount options device_name mount_point_directory # exit Running the Oracle Universal Installer Log in as the user who installed oracle products on this machine and change to the installation directory on the CD-ROM: $ cd /cdrom/cdrom0 Make sure the DISPLAY environment variable is set to your display address.
  • Page 19 From the install directory on the CD-ROM, type the following command: $ ./runInstaller The ./runInstaller command launches the Oracle Universal Installer and the Welcome dialog box displays. Oracle Universal Installer Screen Buttons This table gives you information about the Oracle Universal Installer screen buttons. Installing and Configuring Unified Messaging 2-3...
  • Page 20 Screen Button What it Does Deinstall Products Takes you to the Deinstall screen. About Oracle Universal Installer Gives you the version number. Exit Exits you out of the install session. Installed Products Shows you what Oracle products you have installed.
  • Page 21: Entering File Locations

    Installing Unified Messaging Entering File Locations At the Welcome screen, click Next. The File Locations screen displays. Enter the location of the source and destination. The Source is where the Unified Messaging stage is located. The Destination is where the ORACLE_HOME is located and where Unified Messaging will be installed.
  • Page 22 Installing Unified Messaging Select your installation type. Installation Type What it Does Database Node Installs the database components and creates UM database objects. Web Node Installs the web components only. Click Next. The Summary screen appears. 2-6 Installation Guide...
  • Page 23: Verifying Your Installation Settings

    Installing Unified Messaging Verifying Your Installation Settings The Summary screen enables you to verify your installation settings. These settings include the source and destinations locations you specified; the installation type you selected; the product language; the space requirement for installation and the space currently available;...
  • Page 24 Installing Unified Messaging To change your source or destination location, or installation type, click Previous to return to the appropriate screen. Otherwise, click Install to begin installation. The progress screen displays. This screen shows the progress of your installation. To stop installation, click Cancel.
  • Page 25: Starting The Configuration Assistant Manually

    If installation was successful, the UM 2.1.2 Configuration Assistant launches. Starting the Configuration Assistant Manually Define the ORACLE _HOME environment variable in the .login file (for the C shell) or the.profile file (for the Bourne or Korn Shell): login (C shell) setenv ORACLE_HOME <directoryName>...
  • Page 26: Configuration Assistant Screen Buttons

    At the Solaris prompt, enter the command: $ORACLE_HOME/um/bin/um_install.sh Configuration Assistant Screen Buttons This table gives you information about the Configuration Assistant screen buttons. Click Next to proceed through the steps to configure Oracle Unified Messaging 2.1.2. Screen Button What it Does Cancel Exits you out of the Configuration Assistant.
  • Page 27: Specifying File Locations

    The ORACLE_HOME for Oracle UM 2.1.2 screen appears. Specifying File Locations On this screen you must specify the location of your Oracle Home, where Unified Messaging is to be installed. Enter the directory path of the ORACLE_HOME where Unified Messaging is installed and click Next.
  • Page 28 Installing Unified Messaging On this screen you must enter the Oracle SID and connect string for Unified Messaging, as well as the Unified Messaging tablespace name. 2-12 Installation Guide...
  • Page 29: Entering Passwords

    Tablespace in the corresponding fields. See the table below for more information. ORACLE_SID What it Is UM Connect String Connect string for the database that holds the Oracle Unified Messaging objects. UM ORACLE_SID SID for the database that holds the Oracle Unified Messaging objects.
  • Page 30 Installing Unified Messaging Database Passwords What it Is Sys User Password UM database password specified for the sys user. The password already exists from the database installation. It should be entered here. System User Password UM database password specified for the system user.The password already exists from the database installation.
  • Page 31: Specifying Oracle Email Server Parameters

    ES Domain Name Fully qualified domain name for Unified Messaging installation. Specifying Oracle eMail Server Passwords In this screen, you must specify passwords for your Oracle eMail Server installation. ES User Passwords What it Is oo pwd for ES instance oo user password for the ES database instance.
  • Page 32: Entering Ldap Information

    Installing Unified Messaging ES User Passwords What it Is admin pwd for oomgr Admin user password for oomgr. When you installed Unified Messaging, you were prompted to enter a password for the ADMIN account. The ADMIN account is the system administrator’s account (or superuser account) from which you manage objects on a given node.
  • Page 33 Port number of the LDAP server specified in GSM Server. Defaults to 389. LDAP Type The type of LDAP server being used. Must be "oracle" for an Oracle Internet Directory. Enter the parameters and click Next. The LDAP Domains screen displays.
  • Page 34 Installing Unified Messaging In this screen you must specify your LDAP domains. LDAP Domains What it Is PAB Domain Name of the root of the LDAP domain where UM will store it’s information. GSM Domain Name of the root of the GSM LDAP server from where all the search functions will start.
  • Page 35: Exiting The Configuration Assistant

    Installing Unified Messaging Exiting the Configuration Assistant Click Finish to exit the Configuration Assistant. Once you have completed installation, you must now complete the post-installation tasks. See "Post Installation Tasks" on page 3-2 to begin post-installation tasks. Installing and Configuring Unified Messaging 2-19...
  • Page 36 Installing Unified Messaging 2-20 Installation Guide...
  • Page 37: Post Installation

    Post Installation This chapter describes post installation procedures for Unified Messaging. Topics include: Post Installation Tasks Post Installation 3-1...
  • Page 38: Post Installation Tasks

    The following tasks should be completed on the machine Note: where Oracle Internet Directory is installed. .ldif files are located in the following directory where Oracle Unified Messaging is installed: $ORACLE_HOME/um/admin/ldap All .ldif files must be copied from the machine where Unified Messaging is installed to the machine where Oracle Internet Directory is installed.
  • Page 39: Task 2: Encoding The Helpdesk Password

    Currently, it sets up ACLs for the domain dc=PAB,dc=UM_DOMAIN,dc=com ldapmodify -D <user dn for directory admin> -w <password> -f oid_acl.ldif Restart Oracle Internet Directory database and the Oracle Internet Directory processes. Stop Oracle Internet Directory: oidctl connect=<connect string> server=oidldapd instance=1 stop Start Oracle Internet Directory: oidctl connect=<connect string>...
  • Page 40: Task 3: Configuring The Oomgr Rmi Process

    The oomgr RMI process allows for Unified Messaging sessions to remotely share an oomgr process to do administration on Oracle eMail Server accounts. The oomgr RMI process can be run on either the Unified Messaging or the Oracle eMail Server machine.
  • Page 41: Task 6: Configuring Jserv

    Post Installation Tasks Task 6: Configuring JServ To configure JServ for Oracle Unified Messaging, you must edit $ORACLE_HOME/Apache/JServ/etc/jserv.properties to add JVM properties and CLASSPATHS. To add Oracle Unified Messaging properties, Oracle recommends adding the following lines in the same location where other properties are defined.
  • Page 42: Task 9: Updating Real Audio (Only If Real Audio Is Installed)

    Post Installation Tasks iofcmgr> execute helpdesk.oom Bring up your browser. Enter the following: http://<hostname>:<port>/um/activatehelpdesk.jsp Enter the helpdesk user account password. The default password is helpdesk. Task 9: Updating Real Audio (only if Real Audio is installed) If Real Audio is installed, you must update the following to enable Real Audio streaming.
  • Page 43: Troubleshooting

    Troubleshooting This chapter discusses troubleshooting information. Topics include: Log Files and Trace Files Troubleshooting Hints Troubleshooting 4-1...
  • Page 44: Log Files And Trace Files

    Log out of Oracle eMail Server: a2 LOGOUT Make sure that listeners on Oracle eMail Server and Oracle Unified Messaging are working correctly (using tnsping from the machines). Make sure that LDAP server is up and running correctly. You can issue the following command using a browser: ldap://<...
  • Page 45 Troubleshooting Hints <PAB_DOMAIN> selected during installation. Note: If the data for the helpdesk is returned, then LDAP is working fine. If the data for the helpdesk is not returned, then resolve LDAP server issue using the documentation provided by the LDAP server. Troubleshooting 4-3...
  • Page 46 Troubleshooting Hints 4-4 Installation Guide...

Table of Contents