Sun Java System Portal Server Mobile Access 7.1 Administration Guide

Chapter 6 Configuring Voice Access

This chapter explains Portal Server Mobile Access software’s support for voice accessibility. It contains the following sections:

Understanding Voice Functionality

Mobile Access software’s support for voice accessibility allows users to access voice-enabled content by phone, or with software that enables Session Initiation Protocol (SIP) and supports Voice over IP (VoIP).

This software provides the following voice-enabled functionality:

Configuring Voice Access

Mobile Access software has built-in support for providing voice accessibility. Its voice components are certified against the Nuance Voice Platform, which includes a VoiceXML 2.0-compliant voice browser.

To access the voice functionality, a voice server must be configured to provide speech recognition, text to speech, and a VoiceXML browser.

This section discusses the following available configuration options:

Using a Voice Service Provider

If your Portal Server software is accessible from the Internet, the simplest option is to use a voice application service provider, or a voice hosting service. The service provider runs the voice server and provides a phone number for calling your Portal Server software.

To enable voice service provider access, perform the following steps:

ProcedureTo Enable Voice Service Provider Access:

  1. Install Sun Java System Portal Server Mobile Access software, and make sure the system is accessible from the Internet. You may need to open your firewall to HTTP traffic for the port assigned to Portal Server software web interface.

  2. Identify a voice service provider that uses the Nuance Voice Platform. The platform must use the VoiceXML browser in the Nuance Voice Web Server, not just the core Nuance recognition platform. Contact Nuance for a complete list of voice service providers that support the Nuance Voice Platform.

  3. Create an account with your voice service provider, and specify the HTTP URL of your Portal Server software. The service provider will assign a phone number and possibly a PIN for each service that you create. Most voice service providers allow the creation of evaluation accounts.

Using a Telephony System

If you plan to access Portal Server software using a phone, you must obtain a Digital Signal Processing (DSP) telephony card that is compatible with your telephony network (or switch) and your voice server hardware platform. NMS Communications has a range of DSP solutions that are compatible with the SolarisTM Operating System (SPARC® Platform Edition), as well as Windows Intel platforms.

To use telephony system access, perform the following steps:

ProcedureTo Use a Telephony System Access:

  1. Install the DSP hardware, device drivers, and software using the manufacturer’s recommendations. If you use an NMS Communications DSP card, you will also need the NMS Natural Access 2002-1 software.

  2. Test the DSP card configuration using a test utility, usually supplied with the DSP software.

  3. Provision a port or range of ports in your telephony switch, and configure the ports to use a protocol compatible with the DSP card.

  4. Assign phone numbers to the ports established in step 3 above.

  5. Connect the DSP card to the switch, and test its connectivity by dialing the numbers established in step 4 above. Use the test programs provided with the DSP hardware to verify correct operation.

  6. Refer to the section Installing a Nuance Voice Web Server to install the Nuance components.

Using Session Initiation Protocol

Session Initiation Protocol (SIP) allows users to access your portal site using Voice over IP (VoIP) from any computer equipped with a microphone and speakers.

To enable this, you must install a SIP software-based phone to communicate with the voice server. Pingtel has a SIP-enabled software-based phone application, InstantExpressa, which can be used for this purpose. A number of public domain SIP-based phones are available on the Internet.

To set up a system for SIP access, perform the following steps:

ProcedureTo Setup a System for SIP Access:

  1. Locate the computer that will be used to communicate with Portal Server software. Ensure that it can communicate with your voice server using the SIP protocol. You may need to configure your firewall to open the SIP ports.

  2. Install a SIP-based phone on this computer, and test it by connecting to a SIP service, if available. Many SIP-based phones include simple test servers that you can install for testing purposes.

  3. Refer to the section Installing a Nuance Voice Web Server on page 58 to install the Nuance components.

Using Native Audio

The term native audio refers to accessing Portal Server software directly from the system that is running the voice server software. This means that the voice server must have an audio card and a microphone. Users can only interact with the native audio locally. Remote access is not possible.

For systems running Microsoft Windows operating systems, the sound card must be SoundBlaster compatible. To use native audio access, perform the following steps:

ProcedureTo Use Native Audio Access:

  1. Refer to the section Installing a Nuance Voice Web Server to install the Nuance components.

  2. Configure the Nuance Voice Web Server for native audio. Refer to the Nuance Voice Web Server documentation for details.

Installing a Nuance Voice Web Server

Note –

If you are using a voice service provider, you can skip this section.

Installing a Nuance Voice Web Server involves selecting an appropriate hardware platform, installing and configuring the voice recognition software, and providing connectivity through a phone or IP network interface.

To install the server, complete the following steps:

ProcedureTo Install the Server:

  1. Select a dedicated system to use as the voice server. Refer to the Nuance Voice Web Server 2.0 Release Notes for hardware requirements.

  2. Obtain the Nuance Voice Platform software. Refer to the Nuance documentation for hardware requirements.

  3. Install and configure the Nuance software and additional software on the voice server. Follow the Nuance installation instructions. The order in which the software components and service packs are installed is important.

  4. Configure the Nuance Voice Web Server for native audio, SIP, or telephony access.

  5. Start the Nuance services, followed by the Nuance Voice Web Serve.

  6. Access the voice server using a microphone, a telephone, or your SIP software, and verify that you can access the Nuance voice demo applications. At this point, it may be necessary to tune the Nuance software to improve voice recognition performance. Refer to the Nuance documentation for instructions.

    When you have completed your installation, configure the Nuance software to access Portal Server software.

    To do so, complete the following steps:

  7. Shut down the Nuance Voice Web Server if it is running.

  8. Locate the browser.conf file in the Nuance Voice Web Server installation. On Microsoft Windows operating systems, you will find this file in the following directory:

  9. Open the file using a text editor, and locate the following entry:

  10. Modify this entry to contain the URL of your Portal Server software installation.

    For example:


    where is the host name of the system where Portal Server software is installed, and 58080 is the port assigned to the portal web interface.

  11. Save the browser.conf file.

  12. Restart the Nuance Voice Web Server. Voice Web Server initializes and waits for incoming calls.

Creating Voice-Accessible User Accounts

To use the voice functionality, you must create user accounts on Portal Server software. For voice access, you must assign numeric user IDs and passwords to accounts that will be voice-accessible.

Create a 10-digit account number. The account password is used as the PIN, so assign a numeric password to the account. The PIN must be a four-digit number.

Refer to the Sun JavaTM System Portal Server 7.1 Administration Guide for information about creating user accounts.

Accessing Portal Server Software

This section describes the following ways of accessing Portal Server software:

Using a Voice Service Provider

Call the number assigned by the service provider to your account.

If your software is correctly configured, you will hear the following dialog. Speak (or key in) the account number and PIN assigned to your Portal Server account.


This is Voice Portal, by Sun.

Please say or key in your account number.


415 555 5940


Got it.

And what s your PIN?




Hello, John. You’re signed in.

Here are the portal channels you can choose from: Personal Notes, Notes.

You can also say add a channel.

Which would you like?

Using a Phone

To access Portal Server software by phone, simply dial the number assigned to the voice server by your telecommunications service provider.

Using Session Initiation Protocol

If you are using a SIP software phone, you must specify the SIP address of your Voice Server software (not Portal Server software). Use the following URL format:


Where vws means “access the Nuance Voice Web Server service” on the server named, and 5060 is the port that Nuance Voice Web Server is listening on for SIP connection requests.

Using Native Audio

If you have configured the Nuance Voice Web Server for native audio, start it using the Nuance vws command. The server starts and immediately accesses Portal Server software.