2
Getting Started

This chapter discusses and explains how to install the Oracle Voicemail & Fax system.

This chapter contains the following topics:

• Preinstallation Checklist
• Installation Requirements
• Installing Oracle Voicemail & Fax Telephony Services
• Postinstallation Tasks

Preinstallation Checklist

This section describes preinstallation tasks that must be performed prior to installing Oracle Voicemail & Fax.

Perform the following tasks prior to installing Oracle Voicemail & Fax:

1. Modify the Windows Service named CT Media so that it runs under the context of the user performing the installation. The user performing the installation should be in the CTMUsers group.
2. Restart CT server and bring it up to level 5 before installation.

Installation Requirements

Oracle Voicemail & Fax must be installed on a server running Microsoft Windows 2000. Oracle Email components (middle tier protocol servers and database message stores) can be installed on servers running any supported operating system (UNIX, Linux, or Windows).

To install Oracle Voicemail & Fax, Release 9.0.3, you must have the following installed:

• Oracle9i Application Server can be installed on a machine other than that where Oracle Voicemail & Fax is installed.
• The system that Oracle Voicemail & Fax is installed on must have Oracle9i (9.0.1.1) NT with the 9.0.1.3.1 patch set installed in order for the encryption to work properly.
• Oracle Email can be installed on a machine other than that where Oracle Voicemail & Fax is installed.
• Windows 2000 Resource Kit can be installed on a machine other than that where Oracle Voicemail & Fax is installed.
• CT Media Server, Version 2.1 SW Dev Kit for Windows 2000
• IT Media 1.0
• Java Runtime Environment 1.3.1
• Oracle9i Client 9.0.1.3

Installing Oracle Voicemail & Fax Telephony Services

Once Oracle Voicemail & Fax is installed, the configuration tool does the following:

• Prompts are added to the CTMedia Container
• The sc_vsto.cfg file is created to configure Oracle Voicemail & Fax Conatiner
• The rmid, rmiregistry, and UMProcessMgrService processes are installed

To install Oracle Voicemail & Fax on Windows 2000, do the following:

1. Insert disc into the CD-ROM drive. The Oracle Universal Installer automatically starts and displays the Welcome screen.
2. Use Browse... to locate the file in the \Disk1\stage directory on the disc.
3. In the Destination... section of the File Locations screen, enter the name of an Oracle home (or select an existing Oracle home from the drop-down list) in the Name: field.
4. Enter the path to the Oracle home in the Path field.
5. You can also use Browse... to locate the Oracle home path.
6. Click Next to display the Database Connection Parameters screen.
7. Enter the database password in the DB Password UM field.

   Note: Database user name and password should have the same values for every mail store.

8. Click Next to display the OID Connection Parameters screen.
9. Enter the host name for Oracle Internet Directory in the OID Host Name field.
10. Enter the port number for Oracle Internet Directory in the OID Port field.
11. Click Next to display the Mail Host Locations screen.
12. Enter the mail hosts (use the full machine name, such as mail1.acme.com), ports, and service names to be supported in the Mail Hosts field.

    Use the following format for entering the mail hosts information:

    full_machine_name:port:service_name
    
    

13. Click Next to display the IT Media Location screen.
14. Specify the location of the IT Media jar files in the Directory field.

    Use Browse... to locate the jar files.

15. Click Next to display the Summary screen.
16. Click Install to display the Install screen.

    A progress bar displays. Upon successful installation, the End of Installation screen displays.

17. Click Exit to quit Oracle Universal Installer.

Postinstallation Tasks

There are several tasks you must perform after installing Oracle Voicemail & Fax. These tasks include creating and changing profiles on the CT Media server, and moving and using the Oracle Voicemail & Fax Infrastructure Configuration Tool to configure middle tier components.

This section includes the following topics:

• Creating and Changing Profiles on the CT Media Server
• Configuring Middle Tier and Infrastructure Components

Creating and Changing Profiles on the CT Media Server

Run the ct_admin.exe file located in the \%ORACLE_HOME%\um
\profile directory.

When you run ct_admin.exe, an Oracle Voicemail & Fax Media Services Profile is created on the CT Media server. The executable also makes changes to SCR_AppProfile, SCR_ASIMap, and SCR_RoutingRules.

Configuring Middle Tier and Infrastructure Components

Use the Oracle Voicemail & Fax Infrastructure Configuration Tool on the middle tier node where the Oracle Voicemail & Fax administration component is installed to configure middle tier and infrastructure components, including Oracle Internet Directory, Oracle Voicemail & Fax Advanced Queues (AQs), and Oracle Voicemail & Fax Enterprise Manager Daemon (EMD).

Starting the Oracle Voicemail & Fax Infrastructure Configuration Tool

1. Start the Oracle Voicemail & Fax Infrastructure Configuration Tool as follows:

   $ORACLE_HOME/um/uminfra/uminfra_install.sh
   
   

   The Available Products screen displays.

Configuring Oracle Internet Directory

This procedure creates schema for Oracle Voicemail & Fax prompts and menus and are loaded into Oracle Internet Directory. This part of the installation should only be run.

This procedure requires information about the database and CT Media.

Perform the following steps to configure Oracle Internet Directory:

1. Select Oracle Internet Directory Configuration from the Available Products list.
2. Click Next to display the Oracle Internet Directory Configuration screen.
3. Select one of the following:
   • CT Server Processes

     If selecting CT Server Processes, perform steps 4 - 9.

   • Middle Tier Processes

     If selecting Middle Tier Processes and System Infrastructure, perform steps 5, 7 - 9.

     Note: For a fresh installation, each component must be configured once.

4. Enter the following database information:
   • Middle Tier Machine Host Name: Host name of the machine on which Oracle9i Application Server middle tier components are installed
   • Mail Store Service Name: Service name of the mail store database
   • Mail Store Host Name: Host name of the machine on which the mail store database resides
   • AQ Connect String: Connect string to the Advanced Queues database
5. Click Next to display the CT Media Parameters screen.
6. Enter the following CT Media information:
   • CT Media Host Name: Host name of machine on which CT Media is installed
   • CT Media Port: Port number on which CT Media is listening
   • CT Server Oracle Home Directory: Top level directory path to Oracle Voicemail & Fax home on Windows 2000
   • Windows Directory: Top level directory path to Windows 2000 installation (typically C:\winnt)
   • Resource Kit Directory: Top level directory path to Windows 2000 (typically C:\PROGRA~1\RESOUR~1)
   • CT Media Home Directory: Top level directory path to CT Media installation
   • Java Home Directory: Top level directory path to Java Development Kit installation
7. Click Next to display the Summary screen.
8. Click Install.

   A progress bar displays. Upon successful installation, the End of Installation screen displays.

9. Click Next Install to display the Available Products screen.

   Note: Reboot the machine upon which Oracle Voicemail & Fax is installed.

Configuring Oracle Voicemail & Fax Advanced Queues

This procedure installs the message waiting indicator (MWI) Advanced Queue (AQ) on a particular database.

Because the MWI AQ must be installed on every mail store database, if you have multiple mail store databases, this part of the installation must be run separately for each. AQ are installed on a machine that the user specifies each time this component is run.

To configure Oracle Voicemail & Fax AQ, do the following:

1. Select Oracle Voicemail & Fax AQ Configuration from the Available Products list.
2. Click Next to display the Oracle Voicemail & Fax AQ screen.
3. Click Next to display the Oracle Voicemail & Fax Mail Store Installation screen and enter the following information:
   • Connect String: Connect string to the mail store database
   • System Password: Password to the mail store database
   • es_mail Password: Password for the es_mail account on the mail store database
4. Click Next to display the Choose Password for the Database User UM.
5. Enter a password for the Database User UM.
6. Click Next to display the Summary screen.
7. Click Install.

   A progress bar displays. Upon successful installation, the End of Installation screen displays.

8. Click Next Install to display the Available Products screen.

Configuring Oracle Voicemail & Fax Enterprise Manager Daemon

The Oracle Voicemail & Fax Enterprise Manager Daemon (EMD) allows you to centrally manage remote installations.

This procedure installs the voice mail portion of EMD on the Oracle9iAS middle tier.

Additonally, Oracle Voicemail & Fax targets are loaded into the targets.xml and consoleConfig.xml files.

To configure the Oracle Voicemail & Fax EMD, do the following:

1. Select Oracle Voicemail & Fax EMD Configuration from the Available Products list.
2. Click Next to display the Oracle Voicemail & Fax Configuration Selection screen.
3. Select one of the following:
   • CT Server

     If selecting CT Server, go to step 4.

   • Middle Tier Process

     If selecting CT Server, go to step 5.

     Note: For a fresh installation, each component must be configured once.

4. Click Next to display the Oracle Voicemail & Fax EMD Configuration screen and enter the following information:
   • CT Media Host Name: Host name of machine on which CT Media is installed
5. Click Next to display the Summary screen.
6. Click Install.

   A progress bar displays. Upon successful installation, the End of Installation screen displays.

7. Click Exit to quit Oracle Universal Installer.

   Note: Restart EMD and OPMN processes.

Configuring the Simplified Message Desk Interface

The Simplified Message Desk Interface (SMDI) gets call detail information, and activates and deactivates the MWI.