6 Managing Oracle Voicemail & Fax

This chapter describes how to manage Oracle Voicemail & Fax processes across the enterprise, from a single Applications Tier, and using command-line tools.

This chapter discusses the following topics:

• Managing the Oracle Voicemail & Fax Components

• Managing Processes Across the Enterprise

• Managing Processes on a Single Applications Tier

See Also: Note 416319.1 on http://www.metalink.com for information discovered after this document was published.

Managing the Oracle Voicemail & Fax Components

You can start, stop, restart, and reload any component of the Oracle Voicemail & Fax system. The following describes the results of each of these actions:

• Start — Starts all enabled, stopped services that are direct or indirect members of the component.

• Stop — Stops all enabled, running services that are direct or indirect members of the component.

• Restart — Restarts all enabled, running services that are direct or indirect members of the component.

• Reload — Reinitializes all enabled services that are direct or indirect members of this component without restarting the services. Service reinitialization includes reloading all service-specific configurations stored in Oracle Internet Directory and, for certain services, includes reestablishing connections to the Telephony Server. The database connection information is not reloaded. It is refreshed only when a service is restarted.

You can use the following tools to manage your Oracle Voicemail & Fax components:

• Enterprise Manager Grid Control – a Web-based tool that consolidates management of all Oracle Voicemail & Fax installations in one location

• opmnctl – a command-line tool to manage processes on a particular Applications tier in the Oracle Voicemail & Fax installation

• Application Server Control for Collaboration Suite – a Web-based tool for managing a specific Applications tier

Enterprise Manager Grid Control gives you systemwide management capabilities, allowing you to manage not only all Oracle Voicemail & Fax components in your Oracle environment, but your application servers and databases as well. The opmnctl command-line tool allows you to manage the Voicemail & Fax Application and its processes on a specific Applications tier, and Application Server Control for Collaboration Suite allows you to stop or start the Voicemail & Fax Application on a specific Applications tier.

Managing Processes Across the Enterprise

Using Enterprise Manager Grid Control, you can manage the processes for any Oracle Voicemail & Fax component in your enterprise. You can start, stop, restart, and reload any component in the hierarchy. When you do this, you also execute the same command on any of the subcomponents. The following illustrates how the Start command works when it is executed at different levels in the hierarchy:

• If you start the Voicemail & Fax component, this starts all PBX-Application Clusters, all Voicemail & Fax Applications, and all enabled services in the Oracle Voicemail & Fax system.

• If you start a PBX-Application Cluster, then only those Voicemail & Fax Applications that belong to the PBX-Application Cluster are started, and any enabled services associated with these applications are started.

• If you start a specific Voicemail & Fax Application, then only the enabled services associated with this particular application are started.

• If you start a particular service, then only that one service is started.

The Grid Control tool makes it easy to manage the Oracle Voicemail & Fax components from any of the pages. Navigate to any page for a Voicemail & Fax group, PBX-Application Cluster, or Voicemail & Fax Application where you find a Components table at the bottom of the page. From where you are in the hierarchy, you can execute a command on the topmost component. For example, if you navigate to the PBX-Application Cluster, you can select the cluster and click Stop. Or you can expand the hierarchy to reveal the subcomponents and execute a command on a subcomponent. For example, from the PBX-Application Cluster level, you can expand the hierarchy to reveal all Voicemail & Fax Applications that belong to the PBX-Application Cluster. You can then select a Voicemail & Fax Application and start only that application and its subcomponents.

To manage the Oracle Voicemail & Fax components:

1. Navigate to the home page for the Voicemail & Fax group.

2. Scroll down to the Components table.

3. To view all subcomponents of the Voicemail & Fax group, click Expand All.

4. Select the components that you want to start or stop.

5. Click Start, Stop, Restart, or Reload.

There are two ways to manage the individual services, such as the Recording Service or the Routing Service. You can either use the Components table at one of the levels above the service in the hierarchy (that is, Voicemail & Fax, PBX-Application Cluster, or Voicemail & Fax Application). Alternatively, you can navigate to the home page for the service. In the upper left-hand side of the home page, in the General section, you can click one of the buttons (Start, Stop, Restart, Reload) for the desired action.

Managing Processes on a Single Applications Tier

You can manage processes on a single Applications tier using the opmnctl command-line tool or using the Application Server Control for Collaboration Suite.

Managing Processes Using opmnctl

You can use the opmnctl command to manage Oracle Voicemail & Fax processes on the Applications tier from which you execute the command.

To list the status of all processes managed by opmnctl, use the following command:

%ORACLE_HOME%\opmn\bin\opmnctl status

Managing an Oracle Voicemail & Fax Component

To start, stop, reload, or restart any Oracle Voicemail & Fax component, execute the commands in Table 6-1.

Table 6-1 Commands Used to Manage the Voicemail & Fax Application

To	Execute this command
start	%ORACLE_HOME%\opmn\bin\opmnctl startproc ias-component=VoicemailFaxApplication
stop	%ORACLE_HOME%\opmn\bin\opmnctl stopproc ias-component=VoicemailFaxApplication
reload	%ORACLE_HOME%\opmn\bin\opmnctl stopproc ias-component=VoicemailFaxApplication OVFRefresh=true
restart	%ORACLE_HOME%\opmn\bin\opmnctl restartproc ias-component=VoicemailFaxApplication

Note: You use the opmnctl restartproc command when you want to reload or restart the services. If you want to refresh the processes and re-create the threads, as needed, without terminating any ongoing transactions, you must specify OVRRefresh=true.

Managing the Voicemail & Fax Application Services

As of version 10.1.2.4.1 of Oracle Voicemail & Fax, TelephonyMonitorService must be started before all other processes. The opmnctl startall command (listed in the following table) does this automatically.

To start, stop, reload, or restart a service of the Voicemail & Fax Application, execute the commands in Table 6-2.

Table 6-2 Commands Used to Manage Voicemail & Fax Application Services

To	Execute this command
start all	%ORACLE_HOME%\opmn\bin\opmnctl startall Note: As of version 10.1.2.4.1, TelephonyMonitorService must be started before all other processes. opmnctl startall does this automatically.
start	%ORACLE_HOME%\opmn\bin\opmnctl startproc process-type=service_name
stop	%ORACLE_HOME%\opmn\bin\opmnctl stopproc process-type= service_name
reload	%ORACLE_HOME%\opmn\bin\opmnctl restartproc process-type=service_name OVFRefresh=true
restart	%ORACLE_HOME%\opmn\bin\opmnctl restartproc process-type=service_name

Oracle Voicemail & Fax Process Type IDs

The following are the valid values for the process-type IDs:

• CallTransferService

• FaxReceivingService

• InteractiveVoiceResponseService

• MessageRecoveryService

• MsgDeliveryMonitorService

• MWIService

• RecordingService

• RetrievalService

• RoutingService

• TelephonyMonitorService

Note: The values for the process-type IDs are case-sensitive.

The Start and Restart commands can be executed on both enabled and disabled services.

The opmnctl restartproc command is used to reload and restart the services. If you want to refresh the processes and re-create the threads, as needed, without terminating any ongoing transactions, you must specify OVRRefresh=true.

Managing All Host Processes

To start, stop, or shut down opmn and all managed processes on the host, use the following commands:

%ORACLE_HOME%\opmn\bin\opmnctl startall

%ORACLE_HOME%\opmn\bin\opmnctl stopall

%ORACLE_HOME%\opmn\bin\opmnctl shutdown

The stopall and shutdown commands are identical. Both commands cause opmn and all processes to stop.

For more information on opmnctl, see Oracle Process Manager and Notification Server Administrator's Guide.

Managing Processes Using Application Server Control for Collaboration Suite

From the Application Server Control for Collaboration Suite you can only start the Voicemail & Fax Application. You cannot manage the individual services. You must use either Enterprise Manager Grid Control or the opmnctl command to start, stop, or reload the services.

To start or stop the Voicemail & Fax Application:

1. Log in to the Application Server Control for Collaboration Suite.

2. Navigate to the home page.

3. In the System Components section select the Voicemail & Fax Application and click Start, Stop, Restart, or Reload.