Contents
Introduction
This document contains Voice Portal 5.1 Service Pack 1 product information that is not included in the product documentation. This document highlights known issues about the Voice Portal product along with workarounds that are available.
Note: Before continuing, check the Avaya support Web site at http://support.avaya.com for an updated version of this document.
Problems Fixed
Number | Problem Description |
---|---|
wi00835221 | SessionManager fails to parse ANI that is prefixed by "+1" |
wi00835214 | Discontinuous Transfer setting has no effect |
wi00834363 | VPMS crashes after upgrade from Voice Portal 4.1 to VoicePortal 5.1 SP1 |
wi00834041 | SessionManager core dump on blind transfer |
wi00833303 | SIP status code should be sent to application on a transfer |
wi00833299 | Transfer to a call queue fails |
wi00829743 | CCXML call connected event does not contain SIP header information |
wi00829473 | vxmlmgr core dumps during VoiceXML conformance tests |
wi00828243 | Prompt latencies of 10+ seconds |
wi00826515 | Add several new outcall responses to MPP System Manager |
wi00826499 | Changes to Application Interface web service to support new return codes |
wi00826398 | <cancel> does not cancel the timer from <send> |
wi00826090 | Long log string causes vxmlmgr to core dump |
wi00826048 | Property enableExtendedExitFields should retain its value during upgrade |
wi00825613 | Null pointer exception when click Save on Change ASR/TTS pages with IBM WVS |
wi00824537 | LaunchVXML reporting NO_RESOURCE when MPP returns RC_TIMEOUT |
wi00822268 | Support for changing the recording start time |
wi00822253 | Backup Scheduler page of VPMS broken |
wi00817468 | Memory leak in CCXML interpreter |
wi00775047 | The wrong endpoints may get connected when <join> used after a previously connected endpoint has hung up |
wi00774716 | LaunchVXML reporting success when a non-working number called |
wi00734450 | Application Interface web service is returning error 50 (failed to communicate) when the system is under load |
wi00734313 | Tighten permissions on SessionManager and MediaManager files |
wi00733265 | Under load, Voice Portal only correctly detects answering machine calls 79% of the time |
wi00733243 | Transfer hangs when performed from error handler |
wi00732608 | When downloading error handlers, store files that are not VoiceXML, CCXML, or prompt in $AVAYA_MPP_HOME/web/config |
wi00732581 | Change call progression events to include To, From, and CallID headers |
wi00731685 | Allow Service Locator (SL) to work in environments where root_sudo disabled |
wi00731245 | Change httpd configuration on MPP to support config folder |
wi00717216 | Add config folder under /opt/Avaya/VoicePortal/MPP/web |
wi00700745 | Event PSNMP_I005 logged every 5 minutes after upgrade to Voice Portal 5.1 SP1 |
wi00692404 | Voice Portal 5.1 SP1 localization |
wi00691826 | Session Manager leaking memory under load |
wi00691825 | Session Manager core dumping when starting new MPP when no applications configured |
wi00691805 | Media Manager core dump following MPP restart |
wi00691795 | Add MPP Restart Required message on VoIP Settings page when Inband DTMF Detection changed |
wi00691769 | Required VoiceXML 2.0 assertion 1019 fails in SP1 |
wi00691489 | Transfer in VoiceXML error event handler hangs |
wi00686014 | Handle leak when playing prompts |
wi00601504 | Attribute xmlns should not be required on <ccxml> tag |
wi00599823 | CCXML core dump |
wi00599783 | CCXML memory leak |
wi00574812 | Add new status codes to the Application Interface Web Service |
wi00564111 | New category tag group in POM features.xml failed to merge to the main features.xml |
wi00564045 | Cannot dial phone number beginning with "*" |
wi00563291 | Disable Axis2 administrative console |
wi00554818 | vxmlmgr core dump when running application that has built-in grammar and the system has no ASR resource available |
wi00554519 | Video frame is garbled for a fraction of second |
wi00498487 | Disable SSLv2 for port 8443 |
wi00498468 | Add new field Inband DTMF Detection Enabled to VoIP Settings page |
wi00498348 | Update install to create property file with primary VPMS address |
wi00498327 | Enable application to send a re-INVITE to promote a no-media call |
wi00480896 | Do not show DTMF input in logs |
wi00480756 | Attributes entertone and exittone on <join> do not accept a relative path |
wi00479779 | Attribute eventid missing in events like connection.alerting, connection.redirected, connection.connected, etc. |
wi00464941 | Schema upgrade for 5.1 SP1 |
wi00463192 | Enhance Voice Portal test application to play status prompts for both good and bad outcomes |
wi00463150 | The graphical calendar widget no longer works well with IE8 |
wi00463118 | Invalid delay attribute on <send> does not throw error.semantic |
wi00462936 | Enable inband DTMF detection from VPMS web pages |
wi00462925 | Attribute timeout on <script> does not work |
wi00462882 | Invalid timeout attribute on <createccxml> does not throw error.semantic event |
wi00462712 | Attribute timeout on <createccxml> does not work |
wi00462695 | VoiceXML interpreter not detecting hang-up before fetching next page |
wi00462498 | Webroot specified in the src or next attribute does not work for <fetch>, <dialogstart>, <createccxml>, or <dialogprepare> |
wi00462495 | Certain audio files play garbled audio |
wi00462494 | Voice Portal cannot play two sequential audio files in parallel with a video file. |
wi00462489 | Changes to be compliant with section 508 of the Rehabilitation Act |
wi00462298 | VoiceXML interpreter does not properly handle caller hang-up during final prompt |
wi00461793 | Barge-in not working in Record node |
wi00461526 | MRCP v2 TLS timing out on SET-PARAMS |
wi00461492 | Prompts that require format conversion before playing sound distorted |
wi00428367 | Should not bind SIP connections to VoIP address |
wi00423861 | Script getmpplogs.sh does not work after running script mppMoveLogs.sh |
wi00411386 | Add support for call_classification_recorded_msg_timeout |
wi00410505 | Add capability to send unknown headers in BYE/CANCEL messages |
wi00410067 | Fix several localization issues |
wi00410026 | Modify Apache configuration to disable anonymous SSL ciphers |
wi00409880 | VoiceXML 2.0 Assertion #1010 failed with Loquendo Speech Server |
wi00409875 | Make configuration web pages Section 508 compliant |
wi00409695 | Add application server polling to MPP |
wi00409694 | VPMS work related to application server polling by MPP |
wi00409681 | Allow localization of date/time formats in Trace Viewer |
wi00409676 | Fix localization issues deferred in Voice Portal 5.1 |
wi00409668 | Fix report related localization issues |
wi00409665 | Optimize the Oracle record deletion mechanism to use less roll-back space |
wi00409441 | Make user management web pages Section 508 compliant |
wi00409438 | Localization (Phase 2) fixes |
wi00408135 | Fix error message when user tries to add MPP and MPP Numeric ID Range is too small |
wi00407999 | Required attributes eventide and scope of event error.semantic are undefined |
wi00407864 | Required attribute sessionid of event error.notallow is undefined |
wi00407858 | Event error.fetch is missing several required attributes |
wi00407849 | Event fetch.done is missing several required attributes |
wi00407491 | Event send.successful is not generated |
wi00400808 | Media Manager core dump |
wi00400557 | vxmlmgr core dump during outcall |
wi00400349 | Fix help topic Adding support for Nuance SWI_rawScore |
wi00399918 | Scheduled backups stop working if you do not unmount after a restore |
wi00399917 | Log event if files cannot be backed up because user avayavp does not have read access |
wi00399754 | Backup output is corrupt if user cancels backup in progress and then quickly restarts backup |
wi00399638 | Report-related documentation changes |
wi00399209 | Script do_UpdateHost is broken |
wi00388940 | On Login Options page, default should be LDAP Settings disabled |
wi00388938 | Do not allow users to import reports that they do not have permission to execute |
wi00388866 | On Browser Settings page, field Maximum Documents is not wide enough to allow largest legal value |
wi00388860 | Online Help specifies an incorrect range for Maximum Documents |
wi00388438 | First Prompt Latency shown in reports does not include time between when first play requested and first play started |
wi00388324 | A <fetch> tag with an invalid timeout attribute should throw error.semantic |
wi00388234 | Issues encountered with 508 compliancy tests |
wi00388141 | The Trusted Certificates page of the VPMS sometimes mistakenly warns that all MPPs must be restarted |
wi00387528 | POM alarm email notification missing attachment |
wi00386870 | Voice Portal cannot handle a call from CM that reaches Voice Portal after a domain change |
wi00385893 | Excessive permissions on files and directories |
wi00385707 | Overflow error when running report Call Summary - Summarize By RTP Statistics with Microsoft SQL Server database |
wi00385180 | Add topic VPMS running out of disk space to Troubleshooting Guide |
wi00383695 | Add documentation for the new LDAP enable radio button |
wi00381769 | Add mechanism to report currently configured VPMS even after OS upgrades |
wi00381452 | Doc changes for Upgrading the Voice Portal software on a single server, Chapter 5 |
wi00380036 | Doc changes for Implementing Voice Portal on a single server, Chapter 4 |
wi00378718 | Update documentation on how to customize main menu |
wi00378054 | Debug log incorrectly shows encryption and checksum information for non-Oracle databases |
wi00374806 | Need help topics for PSYSM00056, PSYSM00057, and PSYSM00058 |
wi00374340 | Remove book Converting a multi-server Voice Portal system to a single server system |
wi00373829 | The VoiceXML interpreter page cache can run the system out of memory |
wi00358786 | Add documentation for Axis2 web services |
wi00354428 | Disable Anonymous SSL Ciphers for VPMS and MPP apache configuration |
wi00340485 | Application Interface web service reporting success on some failed calls |
wi00319425 | ASR and TTS values H & M are not always calculated correctly |
wi00316616 | Session Manager leaking memory |
wi00311265 | Releasing port after call disconnected delayed because speech recognition is still on |
wi00070089 | VoiceXML variable name$.maxtime not always set correctly |
Product Information
The Voice Portal Documentation Library is available on the Voice Portal service pack DVD. To access the Voice Portal Documentation Library, place the service pack DVD into a Windows system and use Internet Explorer to view the file \Documentation\VoicePortalDocLibrary\_StartHere.html. From this page, you can access the following information:
Printable PDF files for most of the above are accessible from the page titled About the Avaya Voice Portal library and from the Print guides section of the table of contents.
Also available from the Print guides section of the table of contents are the white papers listed below:
Note: License agreements for each of the third-party components that ship with Voice Portal can be found in the Voice Portal DVD directory /Licenses.
Installation Notes
Important: Before installing or upgrading Voice Portal, please review the Known Issues section in this document for issues that are not addressed in the product documentation. Several of the issues listed there are related to installation.
Note: If you are a software-only customer, you are responsible for obtaining and installing the Red Hat Enterprise Linux operating system on which Voice Portal runs. While the Voice Portal 5.1 product documentation says that you must use Red Hat Enterprise Linux Server release 5.4, you may, optionally, use Red Hat Enterprise Linux Server release 5.5 instead.
This service pack can be used to do a fresh install of a new Voice Portal system. You do not need to install Voice Portal 5.1 before installing this service pack.
For detailed installation procedures, see either Implementing Voice Portal on multiple servers or Implementing Voice Portal on a single server, whichever is appropriate for your installation. These guides also contain important installation worksheets that should be filled out before starting the Voice Portal installation.
Important: Before starting an upgrade, you should back up your Voice Portal database. If the upgrade fails for any reason, you will need this backup to restore your system to its prior state.
For detailed upgrade procedures see Upgrading from Voice Portal 4.1 or 5.0 to Release 5.1. Note that this service pack requires Red Hat Enterprise Linux version 5.4 or later, or an Avaya Linux based on Red Hat Enterprise Linux 5.4 or later. This means that before upgrading the Voice Portal software you may need to upgrade the Linux operating system.
Important: Upgrading from Voice Portal 4.1 or 5.0 to Release 5.1 describes multiple methods for installing the Voice Portal software. If possible, you should use the "Automatic upgrade" method that has you run a script called autoupgradevp. This will avoid a known issue that can cause all of your MPPs to go into the Not Responding state if you upgrade your Primary VPMS using the script installvp.
If you are upgrading a Voice Portal system that was originally installed with Voice Portal 4.1 SP3 or earlier, then you need to upgrade the schema of your Voice Portal internal database. This schema upgrade is performed on the Primary VPMS after you upgrade to Voice Portal 5.1.
Note: If you are upgrading a system that was originally installed with Voice Portal 4.1 SP4 or later, then you do not need to perform the procedure below. However, if the system was originally installed with an earlier release and then upgraded to 4.1 SP4 or later, then you do need to perform the procedure below.
To upgrade the schema of your internal database:
/sbin/service vpms stop |
sudo -u postgres psql -d VoicePortal -c "alter table sdproperty alter column value type character varying(1024)" |
/sbin/service vpms start |
While upgrading your Primary VPMS server and any Auxiliary VPMS servers, follow the upgrade procedure documented in Upgrading from Voice Portal 4.1 or 5.0 to Release 5.1. You should also follow the upgrade procedure documented in Upgrading from Voice Portal 4.1 or 5.0 to Release 5.1 if you are upgrading the operating system as part of installing this service pack. In these cases, the procedure to install this service pack is the same as the procedure to upgrade from Voice Portal 5.0.x.
If you are not upgrading the operating system as part of installing this service pack, then you can upgrade all of your Voice Portal 5.1 MPP servers using the Software Upgrade web page of the VPMS. Before doing that, though, you must perform the one time procedure below on each MPP server that you wish to upgrade using the Software Upgrade web page.
Note: This step is not needed if it was already performed as part of an earlier upgrade.
To allow an MPP to be upgraded from the VPMS:
$AVAYA_IA_HOME/bin/DownloadPK.bash <VPMS_Server> |
Note: The <VPMS_Server> above is the host name or IP address of the Primary VPMS server that manages this MPP.
To upgrade all of your Voice Portal MPP servers:
Note: When you use the Software Upgrade web page to upgrade your MPP servers, each MPP is taken out of service while it is upgraded. MPPs are upgraded one at a time so that the system can continue to process calls during the upgrade process. Also, if the upgrade of any one MPP fails, then any other MPPs that are still awaiting upgrade will not be upgraded. This is to avoid the possibility of an upgrade issue causing all MPPs to go out of service at the same time.
Known Issues
The Voice Portal installation program must be run from an account that has root privileges. If you are installing or upgrading Voice Portal on a server that uses the Avaya provided version of Linux and you do not have root access, you should open a request with Avaya Support.
On a Primary VPMS server, the Voice Portal database might grow to be quite large. The report data generated automatically by Voice Portal causes the database to grow by approximately 4GB for every one million calls processed. If your applications use the Voice Portal application logging feature, the database grows even faster.
By default, the Voice Portal database resides in the directory /var/lib/pgsql/data. If you are a software-only customer, when you install Red Hat Enterprise Linux on your VPMS server you should ensure that the disk partitions you define provide adequate space for the Voice Portal database. Note that the default partition scheme provided by Red Hat Enterprise Linux has proven adequate for most Voice Portal installations. It results in the Voice Portal database residing in a partition that spans most of the hard disk.
On an MPP server, the MPP logs directory might grow to be quite large. This is particularly true if your applications use the VoiceXML <log> tag or CCXML <log> tag to generate application log data.
By default, the MPP logs reside in the directory /opt/Avaya/VoicePortal/MPP/logs. If you are a software-only customer, when you install Red Hat Enterprise Linux on your MPP server you should ensure that the disk partitions you define provide adequate space for the MPP logs. Note that the default partition scheme provided by Red Hat Enterprise Linux has proven adequate for most Voice Portal installations. It results in the MPP logs being in a partition that spans most of the hard disk.
Be aware that the partition scheme provided by Avaya Enterprise Linux results in the MPP logs residing in a relatively small disk partition. If you encounter space problems, see the help topic Administering Voice Portal > Media Processing Platforms > Moving the MPP logs to a different location for instructions on how to change where MPP logs are stored.
In some instances, when Red Hat Enterprise Linux Server 5.x is installed on a server where the console monitor is connected through a KVM switch the Red Hat install program does not correctly identify the type of monitor connected. One consequence of this is that the Red Hat install program runs in console mode, rather than the typical graphical mode. Another consequence is that after Red Hat Enterprise Linux Server 5.x is installed, it runs in console mode rather than graphical mode.
To configure Red Hat Enterprise Linux Server 5.x to run in graphical mode:
system-config-display |
id:5:initdefault: |
In some instances, when a Voice Portal 4.x system installed on an installation of Red Hat Enterprise Linux ES4 that does not include a graphical user interface is upgraded to Red Hat Enterprise Linux 5.x, the Linux console gets flooded with errors. This makes it difficult to log into the system.
Note: This problem can occur with both Red Hat Enterprise Linux and the version of Linux provided by Avaya.
To avoid this problem, follow the procedure below before upgrading to Red Hat Enterprise Linux 5.x:
Note: If you do not follow the procedure above before upgrading to Red Hat Enterprise Linux 5.x and you encounter the problem of the console being flooded with errors, you can resolve the issue by logging into the system remotely using an SSH client and then performing the procedure above. Alternatively, you can log into the system remotely and install Voice Portal.
If you are upgrading a system that uses the Avaya provided version of Linux, when you run the Linux upgrade script vpupgrade.sh you may see a message similar to the following:
cpartition: ERROR - boot label Uya1 from "lilo -v -q" output does not equate to / or /root2 in "mount" output
You may safely ignore this message.
If you are upgrading an MPP server that uses the Avaya provided version of Linux, when you run the Linux upgrade script vpupgrade.sh you may see a message similar to the following:
Error: Detected the MPP process, SessionManager, running.
Please use the VPMS to stop this MPP and change its
'Operation Mode' to 'Offline'.
You must take the MPP out of service in order to prevent vpupgrade.sh from aborting. As described in the error message, the best way to take an MPP out of service is to go to the MPP Manager page of the VPMS, stop the MPP, and then set the MPP mode to Offline. However, if the VPMS is reporting the state of the MPP as Not Responding, then that procedure will not work.
If you cannot stop the MPP through the VPMS web interface, then follow the procedure below:
/sbin/service mpp stop |
During the portion of the install program where prerequisites are installed, a message similar to the following might be displayed:
| | >>>>>>Starting RPM installation: 'rpm -U --replacepkgs *.rpm'
| | warning: php-4.3.9-3.22.9.i386.rpm: V3 DSA signature: NOKEY, key ID
| | db42a60e
| | error: Failed dependencies:
| | php = 4.3.9-3.22.4 is needed by (installed) php-ldap-4.3.9-3.22.4.i386
| | >>>>>>RPM Installation failed: Exit Code: 3
| | ====================================
| | RPM installation check: Expecting 'Found' >= 'Expected'.
| | Expected: php-pear-4.3.9-3.22.9.i386.rpm
| | php-4.3.9-3.22.9.i386.rpm
| | php-domxml-4.3.9-3.22.9.i386.rpm
| | Found: php-pear-4.3.9-3.22.4 Out of Date
| | php-4.3.9-3.22.4 Out of Date
| | php-domxml-4.3.9-3.22.9.i386.rpm Not Installed
If prerequisite installation fails, the installation will not continue.
To resolve this issue:
rpm -e --nodeps php-ldap |
During the portion of the install program where prerequisites are installed, a message similar to the following might be displayed:
| | >>>>>>Starting RPM installation: 'rpm -U --replacepkgs xorg-x11-server
| | -Xvfb-1.1.1-48.41.el5.i386.rpm'
| | warning: xorg-x11-server-Xvfb-1.1.1-48.41.el5.i386.rpm: Header V3 DSA
| | signature: NOKEY, key ID 37017186
| | file /usr/share/man/man1/Xserver.1x.gz from install of xorg-x11-server
| | -Xvfb-1.1.1-48.41.el5.i386 conflicts with file from package xorg-x11-
| | server-Xnest-1.1.1-48.67.el5.i386
| | >>>>>>RPM Installation failed: Exit Code: 1
If prerequisite installation fails, the installation will not continue.
To resolve this issue:
rpm -i xorg-x11-server-Xvfb-1.1.1-48.67.el5.i386.rpm |
During the portion of the install program where Voice Portal is actually installed and the install program displays Installation Progress, a message similar to the following might be displayed:
avc: granted {setbool} for pid=xxxx comm='setsebool' scontext...
This message does not indicate that an error has occurred. You may safely ignore this message.
After you upgrade your Primary VPMS, all of your MPPs might go into the Restart Needed state. If this happens, the MPPs will continue to process calls normally but will need to be restarted at some point. You can either restart the MPPs immediately after you upgrade the Primary VPMS, or you can wait and restart each MPP after it is upgraded.
After you upgrade your Primary VPMS your Auxiliary VPMS will no longer be able to communicate with it. To resolve this issue, upgrade your Auxiliary VPMS to the same release of Voice Portal that your Primary VPMS is running.
Note: While the Auxiliary VPMS is not able to communicate with the Primary VPMS, it will still be able to communicate with the MPP servers. Therefore, outcall requests made through the Application Interface web service on the Auxiliary VPMS will continue to succeed.
After you upgrade an Auxiliary VPMS (formerly Secondary VPMS) server to Voice Portal 5.1, you must manually restart the Apache httpd server.
To restart the httpd server:
/sbin/service httpd restart |
If you upgrade a system that includes a Secondary VPMS to Voice Portal 5.1, on the VPMS Servers page of the VPMS web application the Secondary VPMS will be renamed VPMS2. This behavior is by design. In Voice Portal 5.1, the term Secondary VPMS has been replaced by Auxiliary VPMS.
After you upgrade Avaya Linux on a single server system that includes a co-resident application server, the co-resident application server should start automatically but it does not.
To resolve this issue:
/sbin/service appserver start |
When you install either a Voice Portal Primary VPMS or a Voice Portal Auxiliary VPMS, the system file /etc/mailcap is corrupted. This corruption is caused by the Java Development Kit that is installed by Voice Portal.
Note: The file /etc/mailcap is used by Linux to determine which program should open a particular file based on the file's MIME type.
To resolve this issue:
text/html; /usr/bin/htmlview %s ; copiousoutput\napplication/x-java-jnlp-file; /usr/bin/javaws %s |
text/html; /usr/bin/htmlview %s ; copiousoutput |
application/x-java-jnlp-file; /usr/bin/javaws %s |
In Voice Portal 5.1 the SIP domain name received from the SIP proxy on an incoming call is validated against the value of SIP Domain entered on the Add SIP Connection (or Change SIP Connection) page of the VPMS. If the domain names do not match, Voice Portal will not answer the call. Previous versions of Voice Portal did not validate the SIP domain name received from the SIP proxy.
Because of this change, it is possible that an improperly configured system that worked with previous releases of Voice Portal stops working when upgraded to Voice Portal 5.1.
When upgrading a system to Voice Portal 5.1, verify that the SIP domain name configured on Voice Portal matches the SIP domain name configured on any attached SIP proxies.
An enhancement to the call classification code in Voice Portal 5.1 means that CCXML applications that make outcalls may now receive the event <start_of_voice>. This event occurs after an outcall is answered, at the point where Voice Portal starts trying to determine whether the call was answered by a human or an answering machine. Previous versions of Voice Portal did not send the event <start_of_voice>.
Because of this change, CCXML applications that worked with previous releases of Voice Portal may stop working when the system is upgraded to Voice Portal 5.1. Applications that were modeled after the Voice Portal page default.ccxml from previous releases are likely to suffer from this problem. These applications need to be modified to properly handle the event <start_of_voice>.
Note: In most cases applications can simply ignore the event <start_of_voice>. Where problems occur is when an application looks for a certain set of events and aborts if it receives an unexpected event. These applications need to recognize <start_of_voice> as an expected event.
The version of the sample application BloominBloomsLite that shipped with Dialog Designer 5.0 does not work correctly with Voice Portal 5.1. If you use BloominBloomsLite, use the version that ships with Dialog Designer 5.0 SP1, or newer.
Video applications written for Voice Portal 5.0 might not operate correctly on Voice Portal 5.0 SP1 and later. In Voice Portal 5.0, if a video is played in parallel with audio that is longer than the video, then at the end of the video the last frame will remain on the screen while the audio finishes. Starting with Voice Portal 5.0 SP1, the screen will go blank when the video finishes playing, unless the application writer specifies a video duration that is longer than the actual length of the video.
Note: Application writers should refer to the version of the sample application BloominBloomsLite that ships with Dialog Designer 5.0 SP1, or newer, for examples of video application best practices.
If you have Proactive Outreach Manager (POM) installed on your Voice Portal system and you upgrade Voice Portal, POM may stop working. See the section Upgrading Voice Portal and/or Avaytised linux in the document Implementing Proactive Outreach Manager for instructions on how to make POM work again.
Note: Implementing Proactive Outreach Manager can be found in the Print Guides section of the POM Help system.
When you install the Primary VPMS, a root security certificate is generated. Voice Portal 5.1 generates a root certificate that is valid for ten years. However, some previous versions of Voice Portal generated a root certificate that was valid for only one year. If your root certificate is about to expire, you may see a message similar to the following on the VPMS home page:
SIP: The root CA certificate will expire in 30 days.
To generate a new root certificate:
cd $AVAYA_HOME/Support/VP-Tools |
bash UpdateRootCertificate |
Important: After generating a new root certificate, you must restart all of your MPPs. Also, if you have installed the Voice Portal root certificate on any other servers, such as SIP proxies, in order to support TLS connections, then you must update all of those other servers with the new Voice Portal certificate.
People calling into applications running on a very heavily loaded MPP may occasionally experience delays of several seconds between prompts. This symptom can be caused by file system latencies within Linux. To address this issue, try one or more of the solutions below:
Or
Or
Or
If your application refers to a media a file (for example, a .3gp video) using a secure HTTP URL (one that begins with "https"), then you must install the security certificate from the server that holds the media file on your Voice Portal system. To install the security certificate on Voice Portal, go to the Certificates page of the VPMS and select the Trusted Certificates tab.
As a matter of security policy, Avaya recommends that the Linux service named portmap be disabled. By default, the portmap service is disabled on Avaya Linux. However, on Red Hat Enterprise Linux 5.x the portmap service is enabled by default.
To disable the portmap service:
chkconfig portmap off |
/sbin/service portmap stop |
Note: The Voice Portal backup procedure requires you to have the portmap service enabled. Similarly, you will need to enable the portmap service if you wish to use NFS.
In Voice Portal 5.1 if you have multiple SIP proxies configured and an outcall request fails because the chosen SIP proxy is out of service, Voice Portal will automatically retry the outcall using a different SIP proxy. However, it may take Voice Portal up to thirty seconds to retry the outcall using a different SIP proxy. Writers of applications that request outcalls using either the LaunchVXML method of the Application Interface web service or the CCXML tag <createcall> should consider this failover time when choosing a timeout to specify on the outcall request. If the timeout specified is too short, the outcall request will time out before Voice Portal has found a working SIP proxy.
Note: If a LaunchVXML request times out, it is still possible that Voice Portal will eventually complete the outcall and launch the requested application.
If your application makes an outcall with call classification enabled in either a SIP environment or an H.323 environment that has Special Application 8874 (also known as "the green feature") enabled, then the call classification timer does not begin until Voice Portal receives an indication from the telephony switch that the far end has answered the call. Therefore, if a call goes unanswered, the application will not receive a call classification timeout. It will receive a connection timeout instead.
In an H.323 environment that does not have Special Application 8874 enabled, on the other hand, Voice Portal does not receive any indication from the telephony switch when the far end has answered the call. In this case, Voice Portal considers the call connected as soon as the call is initiated and Voice Portal immediately starts the call classification timer. If a call goes unanswered, your application will not receive a connection timeout. It will receive a call classification timeout.
If the host name or IP address of any Voice Portal server changes, then you must run the utility do_UpdateHost.
If the host name or IP address of a Primary VPMS or Auxiliary VPMS server changes, you must additionally perform the following steps on that server after running doUpdateHost:
/sbin/service vpms stop |
cp -p /tmp/BootstrapDBResource.dat /opt/coreservices/scc/runtime/ |
/sbin/service vpms start |
To replace a Primary VPMS server you must perform several tasks that include: install Linux on the new server, install Voice Portal on the new server, and restore on the new server a Voice Portal database backup taken from the old server. Below are some additional procedures that need to be followed during this process. The first procedure should be performed before you restore the Voice Portal database backup on the new newer. The second procedure should be performed after you restore the database.
Important: These additional procedures are needed any time a database restore is performed after a fresh install of Voice Portal; even if the underlying server hardware has not changed.
Before following the procedure documented in Restoring data backed up from System Backup follow the procedure below.
For each Auxiliary VPMS server:
cd $AVAYA_HOME/Support/VP-Tools |
bash setup_vpms.php <PrimaryVPMS> |
Note: The <PrimaryVPMS> above is the name or IP address of your Primary VPMS server.
After following the procedure documented in Restoring data backed up from System Backup follow the procedure below.
/sbin/service vpms restart |
Under rare circumstances, a Voice Portal MPP will generate a core dump after you make a change to the network configuration on one of your speech servers. If you make a network configuration change on a speech server, such as changing the server's IP address, reboot the speech server. This should prevent the situation that causes the MPP to core dump.
If you are running a Dialog Designer application that does application logging, and your Voice Portal system is configured to handle more than 75 simultaneous calls, you must make the following configuration change on your Primary VPMS:
/sbin/service vpms restart |
When an application runs on the MPP, the VoiceXML Interpreter defaults to the language configured in the Language field on the AVB Settings page of the VPMS. The default value for this field is en-US. If your application uses a language other than the one configured for the system, the application must specify the correct language using the xml:lang attribute. Applications can specify the language either globally on each page, or as part of each individual <grammar> tag and <prompt> tag.
When the VoiceXML interpreter or CCXML interpreter generates an event to a page that does not have a handler defined for that event, the interpreter invokes the appropriate default event handler configured on the Event Handlers page of the VPMS. The default event handlers shipped with Voice Portal play an error prompt spoken in English. If your application uses a language other than English, you must configure a default event handler appropriate for that application.
Note: If you are writing code that will be used as a default event handler and the code refers to prerecorded prompt files, refer to those prompt files by file name as opposed to file path. Voice Portal will automatically search for prompt files in the appropriate directory.
If you are running a Dialog Designer application that does application logging, and your VPMS goes out of service, Dialog Designer temporarily stores the application log data on your application server while waiting for the VPMS to come back in service. If your application server is Tomcat running on Linux and the VPMS stays out of service for a long time, Tomcat might crash because the system runs out of file handles.
If you encounter this problem, do one or both of the following on your application server.
Increase the Linux file handle limit on your application server:
ulimit -n 8192 |
/sbin/service tomcat restart |
Change Tomcat startup options to improve garbage collection on your application server:
export JAVA_OPTS="-server -Xmx1024m -XX:MaxNewSize=30m -X:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:CMSInitiatingOccupancyFraction=60-XX:ThreadStackSize=512" |
/sbin/service tomcat restart |
In order for Voice Portal to establish a TLS connection to a Session Manager server, you must install the security certificate from Session Manager on Voice Portal. The correct URL to obtain the security certificate from Session Manager is:
https://<Session_Manager_SM-100>:5061
Note: The <Session_Manager_SM-100> above is the name or IP address of the SM-100 asset within your Session Manager server.
In order for Voice Portal to establish a TLS connection to a Session Manager server, you must install the security certificate from Voice Portal on Session Manager. Please contact Avaya technical support for help with installing the Voice Portal security certificate on Session Manager.
In order for Voice Portal to establish a TLS connection to a SIP Enablement Services (SES) server, you must install the security certificate from SES on Voice Portal. The correct URL to obtain the security certificate from SES is:
https://<SES_Server>:5061
Note: The <SES_Server> above is the name or IP address of your SES server.
When all the MPPs in your system are in service, the SES properly balances the call load among the MPPs. If one MPP is taken out of service, though, all calls originally intended for the out-of-service MPP are rolled over to one of the remaining MPPs rather than being spread evenly among all of the remaining MPPs.
Note: Generally, this load imbalance will not cause any problems with the remaining MPPs taking calls. However, if your application makes any outcalls, such as during a bridged transfer, then it may encounter no-resource errors. These errors will occur if the MPP taking additional load from the out of service MPP has all ports busy.
Under some conditions, an MPP server may consume ASR/TTS resources on a Loquendo speech server even when there are no calls active on that MPP. This can prevent other MPP servers that share the same Loquendo speech server from being able to obtain speech resources when they are processing a call.
To work around this issue:
You might see the error "A security problem occurred" from the Windows Media Player while playing an utterance from a Session Detail report. To listen to the utterance, right-click the utterance link and select Save Target As. For more information, see http://support.microsoft.com/default.aspx?scid=kb;en-us;885136.
When you click the Export button on any VPMS page that includes this option, a File Download dialog box containing Open, Save, and Cancel buttons is displayed. If the Internet Explorer security option Do not save encrypted pages to disk is enabled, the Open button will not function properly.
To work around this issue, either:
Or
While viewing an e-mail that was sent by Voice Portal as the result of a scheduled report running, if you click the link to view the report output you may see either a blank page or the following message:
The requested file is no longer available.
This problem has only been observed when the scheduled report name contains multi-byte characters and the browser used is Internet Explorer 6.0.
To work around this issue, either:
Or
If you are using Nuance speech servers and you have any applications with the Advanced Parameter Support Remote DTMF Processing set to Yes, then your Nuance speech servers must all be running NSS 5.0.4 or later. This is to prevent <noinput> VoiceXML exceptions from occurring for remote DTMF detection.
If your application plays a long prompt with barge-in enabled, the Nuance speech server may return a recognition timeout event before the prompt has completed playing. To remedy this problem, increase the session timeout parameter on the Nuance speech server to be longer than your longest application prompt.
For a Nuance Speech Server running on Linux:
server.mrcp2.sip.sessionTimeout VXIInteger XXXXXX |
Note: The XXXXXX above is the session timeout in milliseconds. For example, for a two minute timeout XXXXXX would be 120000.
server.mrcp1.rtsp.sessionTimeout VXIInteger XXXXXX |
Note: The XXXXXX above is the session timeout in milliseconds. For example, for a two minute timeout XXXXXX would be 120000.
For a Nuance Speech Server running on Windows:
server.mrcp2.sip.sessionTimeout VXIInteger XXXXXX |
Note: The XXXXXX above is the session timeout in milliseconds. For example, for a two minute timeout XXXXXX would be 120000.
server.mrcp1.rtsp.sessionTimeout VXIInteger XXXXXX |
Note: The XXXXXX above is the session timeout in milliseconds. For example, for a two minute timeout XXXXXX would be 120000.
If you are using Nuance speech servers in their default configuration, when your application receives a <nomatch> event in response to a recognition request the application variable application.lastresult$ will not be updated with any recognition results. If you want your application to receive recognition results when a <nomatch> event is generated, then your Nuance speech servers must all be running NSS 5.0.7 or later and they must all be running NRec 9.0.11 or later. Additionally, you must perform the procedure below on each of your Nuance speech servers.
For a Nuance Speech Server running on Linux:
server.mrcp2.osrspeechrecog.mrcpdefaults.VSP.server.osrspeechrecog.result.sendnomatch VXIString true |
Note: If present, be sure to remove the # character at the beginning of the above line to uncomment it.
server.mrcp1.osrspeechrecog.result.sendnomatch VXIString true |
Note: If present, be sure to remove the # character at the beginning of the above line to uncomment it.
<param name="swisr_result_enable_speech_mode"> |
<param name="swisr_result_enable_speech_mode"> |
<value>1</value> |
</param> |
<param name="swirec_result_enable_speech_mode"> |
<param name="swirec_result_enable_speech_mode"> |
<value>1</value> |
</param> |
For a Nuance Speech Server running on Windows:
server.mrcp2.osrspeechrecog.mrcpdefaults.VSP.server.osrspeechrecog.result.sendnomatch VXIString true |
Note: If present, be sure to remove the # character at the beginning of the above line to uncomment it.
server.mrcp1.osrspeechrecog.result.sendnomatch VXIString true |
Note: If present, be sure to remove the # character at the beginning of the above line to uncomment it.
<param name="swisr_result_enable_speech_mode"> |
<param name="swisr_result_enable_speech_mode"> |
<value>1</value> |
</param> |
<param name="swirec_result_enable_speech_mode"> |
<param name="swirec_result_enable_speech_mode"> |
<value>1</value> |
</param> |
In order to generate either Traditional Chinese or Simplified Chinese TTS using Nuance RealSpeak 4.0.10, you must configure RealSpeak correctly and ensure that the application behaves properly.
To generate Traditional Chinese:
server.realspeak4.language.XX.ShortName VXIString zh-guoyu |
Note: The XX above is a number.
server.realspeak4.language.XX.ShortName VXIString zh-CN |
Note: The XX above is a number.
server.realspeak4.language.XX.ShortName VXIString zh-guoyu |
Note: The XX above is a number.
server.realspeak4.language.XX.ShortName VXIString zh-CN |
server.realspeak4.language.XX.FullName VXIString Mandarin Chinese Big5 |
server.realspeak4.language.XX.Voice VXIString Mei-Ling |
server.realspeak4.language.XX.Gender VXIString female |
Note: The XX above is a number.
To generate Simplified Chinese:
server.realspeak4.language.XX.ShortName VXIString zh-guoyu |
Note: The XX above is a number.
server.realspeak4.language.XX.ShortName VXIString zh-CN |
Note: The XX above is a number.
server.realspeak4.language.XX.ShortName VXIString zh-guoyu |
Note: The XX above is a number.
server.realspeak4.language.XX.ShortName VXIString zh-CN |
server.realspeak4.language.XX.FullName VXIString Mandarin Chinese GB |
server.realspeak4.language.XX.Voice VXIString Mei-Ling |
server.realspeak4.language.XX.Gender VXIString female |
Note: The XX above is a number.
In order to generate either Traditional Chinese or Simplified Chinese TTS using Nuance RealSpeak voice Mei-Ling 4.0.6 with Nuance Speech Server (NSS) 5.0.x, you must configure NSS correctly.
For a Nuance Speech Server running on Linux:
server.rsspeechsynth.languageid.zh VXIString Mandarin Chinese |
server.rsspeechsynth.languageid.zh-CN VXIString Mandarin Chinese |
server.rsspeechsynth.languageid.zh-guoyu VXIString Mandarin Chinese |
server.rsspeechsynth.languageid.zh VXIString Mandarin Chinese |
server.rsspeechsynth.languageid.zh-CN VXIString Mandarin Chinese GB |
server.rsspeechsynth.languageid.zh-guoyu VXIString Mandarin Chinese B5 |
For a Nuance Speech Server running on Windows:
[HKEY_LOCAL_MACHINE\SOFTWARE\ScanSoft\RealSpeak 4.0\Language Resources\Mandarin Chinese B5 (Mei-Ling)] |
"Gender"="female" |
"LanguageName"="Mandarin Chinese B5" |
"LanguageTag"="zh-guoyu-b5" |
"VoiceName"="Mei-Ling" |
[HKEY_LOCAL_MACHINE\SOFTWARE\ScanSoft\RealSpeak 4.0\Language Resources\Mandarin Chinese GB (Mei-Ling)] |
"Gender"="female" |
"LanguageName"="Mandarin Chinese GB" |
"LanguageTag"="zh-guoyu-gb" |
"VoiceName"="Mei-Ling" |
server.rsspeechsynth.languageid.zh VXIString Mandarin Chinese |
server.rsspeechsynth.languageid.zh-CN VXIString Mandarin Chinese |
server.rsspeechsynth.languageid.zh-guoyu VXIString Mandarin Chinese |
server.rsspeechsynth.languageid.zh VXIString Mandarin Chinese |
server.rsspeechsynth.languageid.zh-CN VXIString Mandarin Chinese GB |
server.rsspeechsynth.languageid.zh-guoyu VXIString Mandarin Chinese B5 |
More Information
Online: