Oracle® Voicemail & Fax Administrator's Guide 10g Release 1 (10.1.2.4.1) Part Number B25458-03 |
|
|
View PDF |
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:
See Also: Note 416319.1 on http://www.metalink.com for information discovered after this document was published. |
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.
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:
Navigate to the home page for the Voicemail & Fax group.
Scroll down to the Components table.
To view all subcomponents of the Voicemail & Fax group, click Expand All.
Select the components that you want to start or stop.
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.
You can manage processes on a single Applications tier using the opmnctl
command-line tool or using the Application Server Control for Collaboration Suite.
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 |
|
stop |
|
reload |
|
restart |
|
Note: You use theopmnctl 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 |
Note: As of version 10.1.2.4.1, |
start |
|
stop |
|
reload |
|
restart |
|
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
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.
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:
Log in to the Application Server Control for Collaboration Suite.
Navigate to the home page.
In the System Components section select the Voicemail & Fax Application and click Start, Stop, Restart, or Reload.