3
Post Installation

This chapter describes post installation procedures for Unified Messaging. Topics include:

Post Installation Tasks

Post Installation Tasks

Perform the tasks described in this section after a Unified Messaging installation or upgrade.







Note:



You must run the following tasks in a Korn shell environment.







Note:



Configure Oracle eMail Server to include two rewrite rules. Please refer to chapter 10 of the Oracle eMail Server 5.1 Administration Guide.

Task 1: Create the Oracle Unified Messaging LDAP Schema

Use this procedure to create the schema the helpdesk will use in the LDAP server. This procedure must be performed after completing the postinstallation chapter of the Oracle eMail Server 5.1 Installation Guide.







Note:



The following tasks should be completed on the machine 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.

Edit the following files to specify the LDAP domains:
```
oid_setup.ldif
oid_acl.ldif 
oid_domain.ldif
```

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

Create search catalogs:
```
$cd  $ORACLE_HOME/ldap/bin
```

Execute the following:

catalog.sh -connect <connectString> -add -attr aliasedobjectname
catalog.sh -connect <connectString> -add -attr associateddomain
catalog.sh -connect <connectString> -add -attr dnqualifier
catalog.sh -connect <connectString> -add -attr homephone
catalog.sh -connect <connectString> -add -attr mobile
catalog.sh -connect <connectString> -add -attr pager
catalog.sh -connect <connectString> -add -attr owner

Setup the Helpdesk Administrators using oid_setup.ldif after changing the domains in this file. Currently, it creates HelpDesk administrators for the domain dc=PAB,dc=UM_DOMAIN,dc=com.
```
ldapmodify -D <user dn for directory admin> -w 
<password> -a -f oid_setup.ldif 
```
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 
```
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> server=oidldapd instance=1 
configset=0 flags='-p 389' start

Task 2: Encoding the Helpdesk Password






Note:



The following tasks should be performed on the machine where the Unified Messaging server is installed.

Source the UM environment:
```
$ . $ORACLE_HOME/um/admin/.umenv 
```

Encode the password:

$ $ORACLE_HOME/JRE/bin/jre -cp $UM_CLASSPATH $UM_PROPERTIES 
oracle.um.util.EncPwd HELPDESK

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.

To run it on the Unified Messaging machine, oomgr executable and its message files need to be installed on the Unified Messaging machine.
To run it 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:

Task 4: Starting the Unified Messaging Processes

Start the Unified Messaging processes.

$ $ORACLE_HOME/um/bin/start_mls.sh 
$ $ORACLE_HOME/um/bin/start_IOoomgrRMI.sh

Task 5: Configuring Apache Listener Port

The default listener port without SSL is 7777 and with SSL is 80.

To configure the Apache port:

$vi $ORACLE_HOME/Apache/Apache/conf/httpds.conf

and edit the parameter called Port.

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.

wrapper.bin.parameters=-DUM_HOME=<ORACLE_HOME>/um
wrapper.bin.parameters=-DPROPERTIES=<ORACLE_
HOME>/um/config/<MACHINE_HOST_NAME>.properties

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: Starting Apache JServ

Go to $ORACLE_HOME/Apache/Apache/bin

To start: '

apachectl start

To stop:

apachectl stop

Note:
if the port is < 1024, you need to be root to start Apache.

Task 8: Configuring HelpDesk

Change directory to:
```
$ cd $ORACLE_HOME/um/admin
```
Run oomgr:
```
$ oomgr admin/<password>
```
Execute helpdesk.oom
```
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.

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 the tiff to gif converter executable.







Note::



The convert.tiff.gif.sh takes two arguments:


1st = name of the tiff file


2nd = destination of the gif file

3 Post Installation