<!doctypehtml PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html lang=en xml:lang=en xmlns=http://www.w3.org/1999/xhtml><meta content="text/html; charset=utf-8"http-equiv=Content-Type><meta content="electronic commerce, ecommerce, ebusiness, e-business, e-commerce, enterprise software, net economy, Sun Microsystems, Sun Java Enterprise System, Sun Java System, Sun ONE, internet software"name=keywords><meta content="The Java Enterprise System enables the rapid deployment of business applications and Java Web services. With the Java Enterprise System, customers quickly realize the benefits of fully integrated, real-world tested, ready-to-use, industry-leading network services."name=Description><meta content="Sun JES 2.5.1 WDT"name=TemplateVersion><meta content="Fri Jan 28 14:24:39 2005"name=LASTUPDATED><meta content="Sun Java System Portal Server Mobile Access 6 2005Q1 Administration Guide"name=BookTitle><title>
   Chapter   6  Configuring Voice Access
  </title><link href=catalog.css rel=stylesheet><script laguage=javascript>top.window.focus();</script><script>window.ohcglobal || document.write('<script src="/en/dcommon/js/global.js">\x3C/script>')</script><body alink=#333366 bgcolor=#FFFFFF link=#594FBF text=#000000 topmargin=2 vlink=#9966cc><a name=top> </a><table summary="Header navigation table"border=0 cellspacing=4 width=100%><tbody><tr><td valign=bottom><p class=pNavigation><a href=http://www.sun.com/software/> <img alt="Sun Java logo"border=0 height=70 src=java.jpg valign=bottom> </a>     <a href=05apps.html> Previous </a>      <a href=index.html> Contents </a>      <a href=ix.html> Index </a>      <a href=glossary.html> Next </a>     </p><td align=right valign=top><a href=http://www.sun.com> <img alt="Sun logo"border=0 src=sun.gif valign=bottom> </a><tr><td align=right bgcolor=#594FBF colspan=2 valign=top><span class=cBookTitle> Sun Java System Portal Server Mobile Access 6 2005Q1 Administration Guide </span>  </table><blockquote><a name=wp8063> </a><h2 class=pChapNumber><span class=cGray> Chapter 6 </span> <br> <a name=wp20745> </a> Configuring Voice Access</h2><a name=wp20798> </a><p class=pParagraph>This chapter explains Portal Server Mobile Access software’s support for voice accessibility. It contains the following sections:<div class=pSmartList1><ul class=pSmartList1><a name=wp20835> </a><div class=pSmartList1><li><a href=06voice.html#wp20840> Understanding Voice Functionality </a></div><a name=wp20836> </a><div class=pSmartList1><li><a href=06voice.html#wp20860> Configuring Voice Access </a></div><a name=wp20838> </a><div class=pSmartList1><li><a href=06voice.html#wp20958> Installing a Nuance Voice Web Server </a></div><a name=wp20837> </a><div class=pSmartList1><li><a href=06voice.html#wp21063> Creating Voice-Accessible User Accounts </a></div><a name=wp20839> </a><div class=pSmartList1><li><a href=06voice.html#wp21052> Accessing Portal Server Software </a></div></ul></div><a name=wp20840> </a><h2 class=pHeading1><hr> Understanding Voice Functionality</h2><a name=wp20841> </a><p class=pParagraph>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).</p><a name=wp20842> </a><p class=pParagraph>This software provides the following voice-enabled functionality:<div class=pSmartList1><ul class=pSmartList1><a name=wp20846> </a><div class=pSmartList1><li><b class=cBold> Voice Authentication </b> —Allows users to speak (or key in) their account number and PIN to identify themselves to your portal site. This authentication process enables users to access the same content that is available to them on the standard Portal Desktop or the mobile Portal Desktop.</div><a name=wp20847> </a><div class=pSmartList1><li><b class=cBold> Channel management </b> —Allows users to select from the list of voice-enabled applications. Users can add and remove voice-enabled applications from their voice Portal Desktop.</div><a name=wp20848> </a><div class=pSmartList1><li><b class=cBold> Notes </b> —Allows users to hear a list of messages published to all Portal Server users.</div><a name=wp20849> </a><div class=pSmartList1><li><b class=cBold> Personal Notes </b> —Allows users to hear personal messages associated with their Portal Server account.</div></ul></div><a name=wp20860> </a><h2 class=pHeading1><hr> Configuring Voice Access</h2><a name=wp20861> </a><p class=pParagraph>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.</p><a name=wp20892> </a><p class=pParagraph>To access the voice functionality, a <em class=cEmphasis> voice server </em> must be configured to provide speech recognition, text to speech, and a VoiceXML browser.</p><a name=wp20893> </a><p class=pParagraph>This section discusses the following available configuration options:<div class=pSmartList1><ul class=pSmartList1><a name=wp20899> </a><div class=pSmartList1><li><a href=06voice.html#wp20903> Using a Voice Service Provider </a></div><a name=wp20898> </a><div class=pSmartList1><li><a href=06voice.html#wp20844> Using a Telephony System </a></div><a name=wp20900> </a><div class=pSmartList1><li><a href=06voice.html#wp20933> Using Session Initiation Protocol </a></div><a name=wp20901> </a><div class=pSmartList1><li><a href=06voice.html#wp20959> Using Native Audio </a></div></ul></div><a name=wp20903> </a><h3 class=pHeading2>Using a Voice Service Provider</h3><a name=wp20902> </a><p class=pParagraph>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.</p><a name=wp20908> </a><p class=pParagraph>To enable voice service provider access, perform the following steps:<div class=pSmartList1><ol class=pSmartList1 type=1><a name=wp20909> </a><div class=pSmartList1><li>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.</div><a name=wp20910> </a><div class=pSmartList1><li>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.</div><a name=wp20911> </a><div class=pSmartList1><li>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.</div></ol></div><a name=wp20844> </a><h3 class=pHeading2>Using a Telephony System</h3><a name=wp20924> </a><p class=pParagraph>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 Solaris™ Operating System (SPARC® Platform Edition), as well as Windows Intel platforms.</p><a name=wp20927> </a><p class=pParagraph>To use telephony system access, perform the following steps:<div class=pSmartList1><ol class=pSmartList1 type=1><a name=wp20928> </a><div class=pSmartList1><li>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.</div><a name=wp20932> </a><div class=pSmartList1><li>Test the DSP card configuration using a test utility, usually supplied with the DSP software.</div><a name=wp20931> </a><div class=pSmartList1><li>Provision a port or range of ports in your telephony switch, and configure the ports to use a protocol compatible with the DSP card.</div><a name=wp20930> </a><div class=pSmartList1><li>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.</div><a name=wp20929> </a><div class=pSmartList1><li>Refer to the section Installing a Nuance Voice Web Server to install the Nuance components.</div></ol></div><a name=wp20933> </a><h3 class=pHeading2>Using Session Initiation Protocol</h3><a name=wp20934> </a><p class=pParagraph>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.</p><a name=wp20935> </a><p class=pParagraph>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.</p><a name=wp21230> </a><p class=pParagraph>To set up a system for SIP access, perform the following steps:<div class=pSmartList1><ol class=pSmartList1 type=1><a name=wp20957> </a><div class=pSmartList1><li>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.</div><a name=wp20961> </a><div class=pSmartList1><li>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.</div><a name=wp20962> </a><div class=pSmartList1><li>Refer to the section Installing a Nuance Voice Web Server on page 58 to install the Nuance components.</div></ol></div><a name=wp20959> </a><h3 class=pHeading2>Using Native Audio</h3><a name=wp20960> </a><p class=pParagraph>The term <em class=cEmphasis> native audio </em> 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.</p><a name=wp20963> </a><p class=pParagraph>For systems running Microsoft Windows operating systems, the sound card must be SoundBlaster compatible. To use native audio access, perform the following steps:<div class=pSmartList1><ol class=pSmartList1 type=1><a name=wp20965> </a><div class=pSmartList1><li>Refer to the section <a href=06voice.html#wp20958> Installing a Nuance Voice Web Server </a> to install the Nuance components.</div><a name=wp20964> </a><div class=pSmartList1><li>Configure the Nuance Voice Web Server for native audio. Refer to the Nuance Voice Web Server documentation for details.</div></ol></div><a name=wp20958> </a><h2 class=pHeading1><hr> Installing a Nuance Voice Web Server</h2><div align=left><table summary="This table is used for Notes, Tips, and Cautions"border=0 id=wp20972 width=90%><caption></caption><tbody><tr><td colspan=2><hr noshade=-1><tr align=left valign=top><td><a name=wp20972> </a> <p class=pNote>Note</p><td><a name=wp20974> </a> <p class=pTableText>If you are using a voice service provider, you can skip this section.</p><tr><td colspan=2><hr noshade=-1></table></div><h2 class=pHeading1></h2><a name=wp20823> </a><p class=pParagraph>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.</p><a name=wp20995> </a><p class=pParagraph>To install the server, complete the following steps:<div class=pSmartList1><ol class=pSmartList1 type=1><a name=wp20826> </a><div class=pSmartList1><li>Select a dedicated system to use as the voice server. Refer to the Nuance Voice Web Server 2.0 Release Notes for hardware requirements.</div><a name=wp21024> </a><div class=pSmartList1><li>Obtain the Nuance Voice Platform software. Refer to the Nuance documentation for hardware requirements.</div><a name=wp21023> </a><div class=pSmartList1><li>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.</div><a name=wp21030> </a><div class=pSmartList1><li>Configure the Nuance Voice Web Server for native audio, SIP, or telephony access.</div><a name=wp21029> </a><div class=pSmartList1><li>Start the Nuance services, followed by the Nuance Voice Web Serve.</div><a name=wp21026> </a><div class=pSmartList1><li>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.</div></ol></div><a name=wp21031> </a><p class=pParagraph>When you have completed your installation, configure the Nuance software to access Portal Server software.</p><a name=wp21032> </a><p class=pParagraph>To do so, complete the following steps:<div class=pSmartList1><ol class=pSmartList1 type=1><a name=wp21028> </a><div class=pSmartList1><li>Shut down the Nuance Voice Web Server if it is running.</div><a name=wp21027> </a><div class=pSmartList1><li>Locate the <span class=cCode> browser.conf </span> file in the Nuance Voice Web Server installation. On Microsoft Windows operating systems, you will find this file in the following directory:</div><a name=wp21034> </a><p class=pCodelineIndent>C:\Nuance\VWS\conf\browser.conf</p><a name=wp21033> </a><div class=pSmartList1><li>Open the file using a text editor, and locate the following entry:</div><a name=wp21036> </a><p class=pCodelineIndent>browser.initialPage=%CONTENT%/%LOCALE/initial/dialogs/main.vxml</p><a name=wp21035> </a><div class=pSmartList1><li>Modify this entry to contain the URL of your Portal Server software installation.</div><a name=wp21038> </a><p class=pStepParaI1>For example:</p><a name=wp21039> </a><p class=pCodelineIndent>browser.initialPage=http://portal.example.com:58080/amserver/UI/Log in</p><a name=wp20824> </a><p class=pStepParaI1>where <span class=cCode> portal.example.com </span> is the host name of the system where Portal Server software is installed, and <span class=cCode> 58080 </span> is the port assigned to the portal web interface.</p><a name=wp21049> </a><div class=pSmartList1><li>Save the <span class=cCode> browser.conf </span> file.</div><a name=wp21062> </a><div class=pSmartList1><li>Restart the Nuance Voice Web Server. Voice Web Server initializes and waits for incoming calls.</div></ol></div><a name=wp21063> </a><h2 class=pHeading1><hr> Creating Voice-Accessible User Accounts</h2><a name=wp21064> </a><p class=pParagraph>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.</p><a name=wp21075> </a><p class=pParagraph>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.</p><a name=wp21076> </a><p class=pParagraph>Refer to the <em class=cEmphasis> Sun Java™ System Portal Server 6 2004Q2 Administration Guide </em> for information about creating user accounts.</p><a name=wp21052> </a><h2 class=pHeading1><hr> Accessing Portal Server Software</h2><a name=wp21085> </a><p class=pParagraph>This section describes the following ways of accessing Portal Server software:<div class=pSmartList1><ul class=pSmartList1><a name=wp21086> </a><div class=pSmartList1><li><a href=06voice.html#wp21089> Using a Voice Service Provider </a></div><a name=wp21087> </a><div class=pSmartList1><li><a href=06voice.html#wp21108> Using a Phone </a></div><a name=wp21174> </a><div class=pSmartList1><li><a href=06voice.html#wp21124> Using Session Initiation Protocol </a></div><a name=wp21088> </a><div class=pSmartList1><li><a href=06voice.html#wp20795> Using Native Audio </a></div></ul></div><a name=wp21089> </a><h3 class=pHeading2>Using a Voice Service Provider</h3><a name=wp21090> </a><p class=pParagraph>Call the number assigned by the service provider to your account.</p><a name=wp21091> </a><p class=pParagraph>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.</p><a name=wp21092> </a><p class=pParagraph><b class=cBold> System: </b></p><a name=wp21093> </a><p class=pParagraph>This is Voice Portal, by Sun.</p><a name=wp21053> </a><p class=pParagraph>Please say or key in your account number.</p><a name=wp21106> </a><p class=pParagraph><b class=cBold> User: </b></p><a name=wp21123> </a><p class=pParagraph>415 555 5940</p><a name=wp21107> </a><p class=pParagraph><b class=cBold> System: </b></p><a name=wp21112> </a><p class=pParagraph>Got it.</p><a name=wp21113> </a><p class=pParagraph>And what s your PIN?</p><a name=wp21111> </a><p class=pParagraph><b class=cBold> User: </b></p><a name=wp21114> </a><p class=pParagraph>1234</p><a name=wp21110> </a><p class=pParagraph><b class=cBold> System: </b></p><a name=wp21115> </a><p class=pParagraph>Hello, John. You’re signed in.</p><a name=wp21116> </a><p class=pParagraph>Here are the portal channels you can choose from: Personal Notes, Notes.</p><a name=wp21117> </a><p class=pParagraph>You can also say add a channel.</p><a name=wp21118> </a><p class=pParagraph>Which would you like?</p><a name=wp21108> </a><h3 class=pHeading2>Using a Phone</h3><a name=wp21109> </a><p class=pParagraph>To access Portal Server software by phone, simply dial the number assigned to the voice server by your telecommunications service provider.</p><a name=wp21124> </a><h3 class=pHeading2>Using Session Initiation Protocol</h3><a name=wp21125> </a><p class=pParagraph>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:</p><a name=wp21126> </a><p class=pCodeline>sip://vws@voiceserver.example.com:5060</p><a name=wp21127> </a><p class=pParagraph>Where <span class=cCode> vws </span> means “access the Nuance Voice Web Server service” on the server named <span class=cCode> voiceserver.example.com </span> , and <span class=cCode> 5060 </span> is the port that Nuance Voice Web Server is listening on for SIP connection requests.</p><a name=wp20795> </a><h3 class=pHeading2>Using Native Audio</h3><a name=wp21149> </a><p class=pParagraph>If you have configured the Nuance Voice Web Server for native audio, start it using the Nuance <span class=cCode> vws </span> command. The server starts and immediately accesses Portal Server software.</p><a name=wp21129> </a><p class=pParagraph></p><br><br><table summary="Footer navigation table"border=0 cellspacing=4 width=100%><tbody><tr><td><p class=pNavigation><a href=05apps.html> Previous </a>      <a href=index.html> Contents </a>      <a href=ix.html> Index </a>      <a href=glossary.html> Next </a>     </p></table><hr noshade=-1 size=1><p class=pFooter> <span class=footer> Part No: 819-1369-10.   <a class=footer href=copyright.html> Copyright </a> 2005 <a class=footer href=http://www.sun.com> Sun Microsystems, Inc. </a> All rights reserved. </span> </blockquote>