Skip Headers
Oracle® Voicemail & Fax Administrator's Guide
10g Release 1 (10.1.1)

Part Number B14496-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

9 Oracle Collaboration Suite Databases

In this chapter, we discuss how you can configure the Oracle Collaboration Suite Databases to work with the Voicemail & Fax Applications. You can configure the following:

Setting the Parameters for an Oracle Collaboration Suite Database

You can set the following parameters for an Oracle Collaboration Suite Database:

To set the database parameters:

  1. Navigate to the Voicemail & Fax group administration page.

  2. In the Tasks list, expand the Manage Collaboration Suite Databases task.

  3. Click the Go To Task icon for Set Database Parameters task.

  4. Select the database from the Collaboration Suite Database list and click Continue.

  5. Specify the minimum and maximum number of connections between the Voicemail & Fax Application and this database.

  6. Select Global if you want to make this database available to all Voicemail & Fax Applications.

    You may decide that you want to make an Oracle Collaboration Suite Database available only to one Voicemail & Fax Application. In this instance, deselect the Global box for the Collaboration Suite Database. Then use the Set Voicemail & Fax Application Service List task to specify access for that particular application. See "Setting the Available Oracle Collaboration Suite Databases" for more information.

  7. Click OK.

Setting the Connections to an Oracle Collaboration Suite Database

The number of connections to an Oracle Collaboration Suite Database can be specified for the database, and the default settings are four minimum connections and ten maximum connections from the application to the database. By default, the Voicemail & Fax Applications inherit these connections settings. However, you can customize the number of connections from a particular Voicemail & Fax Application to any database that is available to the application.

The number specified by the Minimum Connections settings indicates the number of physical connections the application makes to the database. You may want to adjust the database connection settings if you need to manage your database resources. You do not have to individually manage the connections from each Voicemail & Fax Application to an Oracle Collaboration Suite Database. You can set the minimum number of connections to one and the maximum number of connections to the largest number of connections required by any Voicemail & Fax Server. In this way, each server keeps one connection open at all times. Each server then opens up as many connections as it requires to handle calls, but no more than is necessary. See "Setting the Parameters for an Oracle Collaboration Suite Database" for information on setting the default connections for a database.

To set the number of connections to the Collaboration Suite Database for a specific Voicemail & Fax Application:

  1. Navigate to the Voicemail & Fax administration page.

  2. In the Tasks list, expand the Manage Collaboration Suite Databases list.

  3. Click the Go To Task icon for the Set Voicemail & Fax Application Collaboration Suite Database Parameters task.

  4. Select the application from the Voicemail & Fax Application list.

  5. Select the database from the Collaboration Suite Database list and click Continue.

    The Oracle Collaboration Suite Databases that are currently available to the selected Voicemail & Fax Application appear in the Collaboration Suite Database list. If you want to configure connections to an Oracle Collaboration Suite Database that does not appear in the list, you must first make the database available to this application. See "Setting the Available Oracle Collaboration Suite Databases" for more information on how to make a database available to an application.

  6. Click Continue.

    The page displays the minimum and maximum number of connections from the Voicemail & Fax Application to the Collaboration Suite Database. If the number cannot be edited, then the application is set to use the default. If the number is in an editable box, then the connections have been specifically set for the application.

    Click the icon above the box to either use the default or override the default. The icon toggles between the two options.

  7. To override the default, click the Override icon, enter the number of connections.

  8. To use the default, click the Inherit icon.

  9. Click OK.

WARNING:

When these parameters are changed, you must restart the host of the Voicemail & Fax Application that accesses this Collaboration Suite Database. After you click OK, you will be given a confirmation message, including the host that needs to be restarted.

Setting the Available Oracle Collaboration Suite Databases

When an Oracle Collaboration Suite Database is installed, by default it is made globally available to all Voicemail & Fax Applications. And by default, a Voicemail & Fax Application has access to any globally available database. (See "Setting the Parameters for an Oracle Collaboration Suite Database" for information on setting the Global parameter.) You can override this default and specify a different set of Oracle Collaboration Suite Databases for this Voicemail & Fax Application. You may restrict access to an Oracle Collaboration Suite Database that is set to be globally available or you may enable access to an Oracle Collaboration Suite Database that is not globally available.

Restricting access to a database is useful when you have multiple Oracle Collaboration Suite Databases that support users in different geographical regions. For example, you may have users in New York and Los Angeles. The Inbox of these users are in different databases, that is, the New York users' voice messages are stored in a database in New York, and the Los Angeles users' voice messages are stored in a database in Los Angeles. You might want to restrict the access of the Voicemail & Fax Server in New York to the database in New York. Likewise, you may want to restrict the access of the server in Los Angeles to the database in Los Angeles. Doing so restricts users' access to retrieve messages from a particular database. Note that users are still able to send voicemail messages to users whose Inboxes reside in other databases. **One of the disadvantages to restricting access to a database occurs when a user is away from their office. For example, if a New York user travels to the Los Angeles office, he or she must dial the New York phone number that is used to access the voicemail system instead of using the local Los Angeles phone number used to access the system. The advantage of restricting users to a particular database is that you do not have to maintain database connections and related database resources to other databases in the system.

Note:

Setting the list of available Oracle Collaboration Suite Databases for a Voicemail & Fax Application only restricts where the user can access their voicemail messages. The user can still send voicemail messages to users residing on other Oracle Collaboration Suite Databases.

To set the Oracle Collaboration Suite Databases for a Voicemail & Fax Application:

  1. Navigate to the Voicemail & Fax administration page.

  2. In the Tasks list, expand the Manage Collaboration Suite Databases list.

  3. Click the Go To Task icon for Set Voicemail & Fax Application Service List task.

  4. Select the application from the Voicemail & Fax Application list and click Continue.

    The Set Voicemail & Fax Application Service List: Set Collaboration Suite Databases page displays the Oracle Collaboration Suite Databases that are available for the application you selected. If the list is greyed out, then the application is set to use the default. If the list is not greyed out, then the Oracle Collaboration Suite Databases have been specifically set for the application.

    Click the icon above the box to either use the default or override the default. The icon toggles between the Inherit and Override options.

  5. To specify a different set of databases, click the Override icon.

    • A list of all Oracle Collaboration Suite Databases appears, including those that are globally available and those that are not.

    • Select the Oracle Collaboration Suite Databases from the list that you want to make available to this Voicemail & Fax Application, and click OK.

  6. To use the default, click the Inherit icon.

    The service list displays all Oracle Collaboration Suite Databases that are set to Global.

Note:

If the Voicemail & Fax Application has a local primary outbox, you must first change the primary outbox and set it to the global primary outbox. You must do this before you can make any change to the service list. Once you have updated the service list, you can then change the primary outbox back to the local setting. See "Setting the Primary Outbox for a Voicemail & Fax Application" for more information on how to change the primary outbox.

Primary Outboxes

The primary outbox is an Oracle Collaboration Suite Database that functions as an access gateway to all other databases in the Oracle Voicemail & Fax installation. By default, the first Oracle Collaboration Suite Database that is installed is set as the global primary outbox for the entire system. You can later configure the global primary outbox and select another Oracle Collaboration Suite Database. By default, all voicemail messages are delivered to the global primary outbox. If the voicemail recipient does not belong to the database specified as the primary outbox, then the voicemail message is forwarded to the correct database. For the fastest message delivery time, it is preferable that the primary outbox be the same database where the user's voicemail is stored. Therefore, Oracle recommends that you set the global primary outbox to be the database where the majority of your users' voicemail messages are stored. A global primary outbox is set for the system and, by default, this is inherited by all the Recording Services in the system.

You can set a different primary outbox for a Voicemail & Fax Application. You may want to do this if a specific Application tier is configured to support the majority of users in a specific Oracle Collaboration Suite Database that is different from the one specified for the global primary outbox. You can override this global setting and configure the appropriate database as the primary outbox.

If the Recording Service is unable to successfully send the message using the specified primary outbox, the message is stored on the Telephony Server and sits in a queue waiting to be processed by the Message Recovery Service. The Message Recovery Service attempts to connect to all the configured databases for the Voicemail & Fax Application instead of using the database specified by the Primary Outbox parameter.

Setting the Global Primary Outbox

When the Oracle Collaboration Suite Databases are created, the first Oracle Collaboration Suite Database that is created is set as the global primary outbox. The database you select as the global primary outbox is, by default, the primary outbox for all Voicemail & Fax Applications. After installation, you can change this global primary outbox setting and select any other Oracle Collaboration Suite Database in your system.

To set the global primary outbox:

  1. Navigate to the Voicemail & Fax administration page.

  2. In the Tasks list, expand the Manage Collaboration Suite Databases task.

  3. Click the Go To Task icon for Set Global Primary Outbox to go to the Set Global Primary Outbox: Select Global Primary Outbox page.

    The database that is currently the global primary outbox appears in the Collaboration Suite Database list.

  4. Select the database you want to set as the global primary outbox from the Collaboration Suite Database list and click OK.

One of the options in the Collaboration Suite Database list is No Global Primary Outbox. One way of using this option is if you want to change the availability of an Oracle Collaboration Suite Database that is currently the global primary outbox. In order to make it not globally available, you must first remove it as the global primary outbox and make another selection. If you do not want to select an alternative database as the global primary outbox, use No Global Primary Outbox.

You may specify a different primary outbox for an application. See "Setting the Primary Outbox for a Voicemail & Fax Application" for information on how to set a primary outbox for a Voicemail & Fax Application.

Setting the Primary Outbox for a Voicemail & Fax Application

By default, all Voicemail & Fax Applications use the global primary outbox. You may either use this inherited value or select another Oracle Collaboration Suite Database as the primary outbox.

To set the primary outbox:

  1. Navigate to the Voicemail & Fax administration page.

  2. In the Tasks list, expand the Manage Collaboration Suite Databases task.

  3. Click the Go To Task icon for Set Voicemail & Fax Application Primary Outbox.

  4. Select the application from the Voicemail & Fax Application list and click OK.

    In the Set Voicemail & Fax Application Primary Outbox: Select Primary Outbox page, the primary outbox is displayed for the application you selected. The icon to the left of the named primary outbox indicates whether this setting is inherited, that is, it is using the global primary outbox setting or if the primary outbox is specifically set for this application.

  5. If the primary outbox is inherited and you want to select a different primary outbox for this application, click the Override icon to the left of the box, and select another primary outbox from the list.

    The list displays the Oracle Collaboration Suite Databases that are available to this Voicemail & Fax Application. If you want to select an Oracle Collaboration Suite Database that does not appear in the list, you must first make it available. See "Setting the Available Oracle Collaboration Suite Databases" for more information on making a database available to an application.

  6. If the primary outbox is specified for this Voicemail & Fax Application, and you want to change this and use the global primary outbox, click the Inherit icon.

  7. Click OK.

Setting the Application Password

The um user ID and password is required to connect from the Voicemail & Fax Application to the Collaboration Suite Database. This application password is used by the Oracle Container subsystem and the Message Waiting Indicator (MWI) Service. When you install Oracle Voicemail & Fax, you are prompted to provide a password for the um user ID. If, for some reason, you need to change the password or you add another Oracle Collaboration Suite Database to your installation, you must also update the Voicemail & Fax Applications that connect to the database with the password.

To set the application password:

  1. Navigate to the Voicemail & Fax group administration page.

  2. In the Tasks list, expand the Manage Collaboration Suite Databases task.

  3. Click the Go To Task icon for the Set Application Password task.

  4. Select the database from the Collaboration Suite Database list and click Continue.

  5. On the Set Application Password: Set Password page, enter the old password, and enter the new password twice, and click OK.

    The application returns a message confirming that the password has been successfully changed and gives a list of the hosts that need to be restarted.

WARNING:

When the password is changed, you must restart the host of any Voicemail & Fax Application that accesses this Collaboration Suite Database. After you click OK, you will be given a confirmation message, including the hosts that need to be restarted.

In addition, you must also update the um password in the Collaboration Suite Database. Therefore, the change must be made in two places—the Voicemail & Fax Applications and the Collaboration Suite Database—in order for the new password to take effect. Until the passwords are synchronized, the Voicemail & Fax Applications will not be able to connect to the database.

Setting the Metrics Password

The Message Delivery Service uses the ovfmetrics user ID and password to connect to the Collaboration Suite Database. When you install Oracle Voicemail & Fax, you are prompted to provide a password for the ovfmetrics user. If, for some reason, you need to change the password or you are adding a new Oracle Collaboration Suite Database to your installation, you must also update the Voicemail & Fax Applications that connect to the database with this password.

To change the metrics password:

  1. Navigate to the Voicemail & Fax group administration page.

  2. In the Tasks list, expand the Manage Collaboration Suite Databases task.

  3. Click the Go To Task icon for the Set Metrics Password task.

  4. Select the database from the Collaboration Suite Database list and click Continue.

  5. On the Set Metrics Password: Set Password page, enter the old password, enter the new password twice, and click OK.

    The application returns a message confirming that the password has been successfully changed and gives a list of the hosts that need to be restarted.

    WARNING:

    When the password is changed, you must restart the host of any Voicemail & Fax Application that accesses this Collaboration Suite Database. After you click OK, you will be given a confirmation message, including the hosts that need to be restarted.

    In addition, you must also update the ovfmetrics password in the Collaboration Suite Database. Therefore, the change must be made in two places—the Voicemail & Fax Applications and the Collaboration Suite Database— in order for the new password to take effect. Until the passwords are synchronized, the Voicemail & Fax Applications will not be able to connect to the database.