Oracle Unified Messaging, Installation Manual

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: ...le 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 the following notice is applicable Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are commercial computer software and use duplication and disclosure of the Programs including documentation shall be subject to the licensing rest...

Page 3: ...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 St...

Page 4: ... 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 execut...

Page 5: ...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 infodev us oracle com FAX 650 506 7228 Attn Unified Messaging Documentation Manager Postal service Oracle Corporation Unified Messaging Documentation ...

Page 6: ...vi ...

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

Page 8: ...em 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 Solaris Ordering Related Documentation T...

Page 9: ...d example indicates that more than one input_file may be specified on the command line command input_file In command syntax angle brackets identify variables 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 whic...

Page 10: ...x Installation Guide ...

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

Page 12: ...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...

Page 13: ... 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 imag...

Page 14: ...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 databa...

Page 15: ...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 DESCRIPTI...

Page 16: ...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 2 Verify the modified tnsnames ora file tnsping host 3 Verify that the Oracl...

Page 17: ... Messaging 2 1 2 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 ...

Page 18: ...he CD ROM manually Be sure to unmount the CD ROM before removing it from the drive 1 Place the Product Installation CD ROM in the CD ROM drive 2 Log in as the root user su root 3 Create a CD ROM mount point directory mkdir mount_point_directory 4 Mount the CD ROM drive on the mount point directory and exit the root account mount options device_name mount_point_directory exit Running the Oracle Uni...

Page 19: ...e following command usr openwin bin xhost See the UNIX man pages for more information on xhost 4 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 bu...

Page 20: ...stall 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 Previous Takes you back to the previous screen Next Takes you to the next screen Cancel Enables you to cancel the installation process ...

Page 21: ...lays 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 2 Type in or use the Browse button to select the Source and Destination directories for your installation 3 Click Next The Installation Types screen displays ...

Page 22: ...stallation Guide Select your installation type Click Next The Summary screen appears Installation Type What it Does Database Node Installs the database components and creates UM database objects Web Node Installs the web components only ...

Page 23: ...mmary 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 and the Unified Messaging products that will be installed ...

Page 24: ...ur 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: ... installation was successful the UM 2 1 2 Configuration Assistant launches Starting the Configuration Assistant Manually 1 Define the ORACLE _HOME environment variable in the login file for the C shell or the profile file for the Bourne or Korn Shell 2 Run the profile or login file login C shell setenv ORACLE_HOME directoryName profile Bourne or Korn shells ORACLE_HOME directoryName export ORACLE_...

Page 26: ... 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 Next Takes you to the next screen ...

Page 27: ...racle 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 The ORACLE_SIDs for UM 2 1 2 screen displays ...

Page 28: ...Installing Unified Messaging 2 12 Installation Guide On this screen you must enter the Oracle SID and connect string for Unified Messaging as well as the Unified Messaging tablespace name ...

Page 29: ...D 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 Name of UM Tablespace The name of the Unified Messaging tablespace on the database Database Passwords What it Is UM User Password UM database password for the UM user All Unified Messaging objects are owned...

Page 30: ...splays 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 It should be entered here Database Passwords What it Is ...

Page 31: ...y passwords for your Oracle eMail Server installation IM Parameters What it Is ES Hostname Hostname and machine where ES is installed DNS Domain DNS domain where ES is installed ES Node Name Node name of the ES node ES Domain Name Fully qualified domain name for Unified Messaging installation ES User Passwords What it Is oo pwd for ES instance oo user password for the ES database instance All Orac...

Page 32: ...mpted 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 In addition the ADMIN user can grant administrative privileges to other users so that they can administer the Unified Messaging system The ADMIN account cannot be deleted and always retains superuser privileges LDAP Parameters Wh...

Page 33: ...rt number of the LDAP server specified in PAB server Defaults to 389 GSM Server Name of the LDAP server to use for General Directory searching capability in UM GSM Server 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 LDAP Parameters What it Is ...

Page 34: ...your LDAP domains Enter the LDAP domains and click Next The last screen displays 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: ...ed Messaging 2 19 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 ...

Page 36: ...Installing Unified Messaging 2 20 Installation Guide ...

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

Page 38: ...ME 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 1 Edit the following files to specify the LDAP domains oid_setup ldif oid_acl ldif oid_domain ldif 2 Create the domains in the directory tree using oid_domain ldif ldapmodify D user dn for directory admin w password a f oid_domain ldif 3 C...

Page 39: ...rs for the domain dc PAB dc UM_DOMAIN dc com ldapmodify D user dn for directory admin w password a f oid_setup ldif 6 Setup the ACLs using oid_acl ldif after changing the domains in this file 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 7 Restart Oracle Internet Directory database and the Oracle Internet Dire...

Page 40: ...t on the Oracle eMail Server machine Unified Messaging classes need to be installed and configured with the wizard in the ORACLE_HOME where Oracle eMail Server is installed On machines with Unified Messaging middle tier installation verify that the oomgr servername property in the properties file points to where oomgr RMI process is running The properties file is located in the following directory...

Page 41: ...erties To add Oracle Unified Messaging CLASSPATHs Oracle recommends adding the following lines in the same location where other CLASSPATHs are defined wrapper classpath ORACLE_HOME jdbc lib classes111 zip wrapper classpath ORACLE_HOME um lib um jar wrapper classpath ORACLE_HOME um lib jgl zip wrapper classpath ORACLE_HOME um lib j2ee jar wrapper classpath ORACLE_HOME um lib ldap jar Task 7 Startin...

Page 42: ... the following to enable Real Audio streaming Update rma home home of RealAudio and rma server server name and port number of RealAudio in site name properties Task 10 Updating the Tiff to Gif Executable only if a Tiff to Gif executable is installed You must update your tiff to gif executable to enable your fax server to convert tiff image files to gif image files Edit convert tiff gif sh to call ...

Page 43: ...Troubleshooting 4 1 4 Troubleshooting This chapter discusses troubleshooting information Topics include Log Files and Trace Files Troubleshooting Hints ...

Page 44: ...racle eMail Server is installed and working correctly 1 Connect directly to the IMAP ports of Oracle eMail Server telnet es machine name 143 2 If Oracle eMail Server is running imap4 correctly login using a1 login helpdesk helpdesk 3 Response from the server should be a1 OK LOGIN completed 4 Log out of Oracle eMail Server a2 LOGOUT Make sure that listeners on Oracle eMail Server and Oracle Unified...

Page 45: ...3 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 Note PAB_DOMAIN selected during installation ...

Page 46: ...Troubleshooting Hints 4 4 Installation Guide ...