Avaya Aura® Experience Portal 6.0 Service Pack 2

Release Note (Issue 9)

April 2013

Contents

Introduction

Problems Fixed

Product Information

Installation Notes

Installing the Oracle JDBC driver

Fresh Installs

Upgrades from Voice Portal 5.x

Upgrades from Experience Portal 6.0.x

OVA Deployments

Known Issues

Compatibility Issues

Documentation Issues

Installation Issues

OVA Deployment Issues

System Operation Issues

External System Issues

More Information

Introduction

This document contains Experience Portal 6.0 Service Pack 2 product information that is not included in the product documentation. This document highlights known issues about the Experience 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

NumberProblem Description
wi01054455VoiceXML Interpreter hangs if SessionManager terminates the call before PREPARE stage finishes
wi01052911MPP does not properly send property "inputmodes" to Loquendo speech servers
wi01051884Call hangs if "Support Remote DTMF Processing" set to "yes" and "Transcription Speech Data" set to "Text and Speech"
wi01047476VoiceXML Interpreter does not properly reset bargein type when call flow returns from subdialog
wi01044117CCXML Interpreter core dump
wi01043706Need to update java-1.6.0-openjdk package in Avaya Linux
wi01041788Script packcore.sh displays spurious errors
wi01041769No alarm generated when speech server goes down
wi01041432Experience Portal does not correctly parse all NLSML speech results
wi01041415Summarize By RTP Statistics option of Call Summary Report does not properly handle huge values for RTP packets lost
wi01041239Hanging up before recognition request causes the session to hang for 10 minutes
wi01040953Port sometimes hangs when VoiceXML Interpreter encounters serious error
wi01040659Output from script iaversion.php contains incorrect value for rollback
wi01040239Script InstallAppServer.sh does not create Tomcat user "expportal"
wi01039865VoiceXML Interpreter does not properly handle prompts when application server does not include "Content-Length" attribute
wi01039500VoiceXML Interpreter should include file name and element hierarchy in script error description
wi01038823SessionManager core dump
wi01038510Script restorempplogs.sh does not work as expected
wi01037882VoiceXML Interpreter does not properly handle multiple HTTP 100 responses
wi01037859Need to update kernel in Avaya Linux
wi01037854Need to update dhcp package in Avaya Linux
wi01036601Script UpdateRootCertificate displays Java exception
wi01036567VoiceXML Interpreter sometimes incorrectly reports a timeout when uploading large recorded audio content
wi01036258EPM should not try to collect report data from MPP that is not responding
wi01034253Need to update krb5 package in Avaya Linux
wi01034215Need to update BIND package in Avaya Linux
wi01034213Need to update glibc package in Avaya Linux
wi01030650Telephony ports fail to come up after MPP reboot
wi01029914MPP does not properly handle ASR result when active grammar has slots
wi01029899Need to update sudo package in Avaya Linux
wi01029896Need to update openjpeg package in Avaya Linux
wi01029892Need to update libtiff package in Avaya Linux
wi01029879Once a call to one Avaya Aura Session Manager fails over to another Session Manager it should stay there even if first Session Manager comes back up
wi01025035MPP sometimes sends vendor specific parameters to speech server in wrong format
wi01022220Need to update cifs-utils package in Avaya Linux
wi01022218Need to update sos package in Avaya Linux
wi01022214Need to update openssh package in Avaya Linux
wi01022210Need to update busybox package in Avaya Linux
wi01022207Need to update qt package in Avaya Linux
wi01022205Need to update rsyslog package in Avaya Linux
wi01021475Need to update expat package in Avaya Linux
wi01018886SessionManager core dump
wi01016776Unrecognized hints in CCXML tag <disconnect> cause SessionManager to hang
wi01013819VoiceXML application sometimes hangs after a consultative transfer
wi01011136Packing log files from MPP Service Menu sometimes fails
wi01010656Increase maximum number of VoiceXML redirects to 50
wi01009563SIP transfer fails if attempted while re-INVITE request is being processed
wi01009545Inbound fax detection incorrectly requires enhanced call classification license
wi01009505MPP does not properly handle ASR results that contain multi-byte characters
wi01008856MPP does not properly send unknown SIP headers on REFER request
wi01007525Need to update Apache Tomcat
wi01002454Need to update libtiff package in Avaya Linux
wi01002451Need to update freetype package
wi01002449Need to update samba package in Avaya Linux
wi01002447Need to update rpm package in Avaya Linux
wi01002445Need to update gnutls package in Avaya Linux
wi01002443Need to update libtasn1 package in Avaya Linux
wi01001648Cannot schedule a Data Export Report
wi01001304Add support for vendor specific tags in speech recognition results
wi00999039MPP does not properly handle DTMF result when active grammar has slots
wi00997370Co-resident application server should not allow HTTP methods DELETE and PUT
wi00995304Need a way for CCXML applications to determine H.323 station
wi00988447Need to update PostgreSQL
wi00988326Need to update cvs package in Avaya Linux
wi00985545Need to update Java
wi00984625Need to update libpng package
wi00984519Need to update libvorbis package in Avaya Linux
wi00984516Need to update Apache httpd server
wi00984511Need to update mysql packages in Avaya Linux
wi00977157Need to update openssl package
wi00975718Need to update PHP package
wi00975713Need to update libxml2 package
wi00970632Need to update Tomcat
wi00859860Logoff command in EPM does not always log user out

Product Information

The Experience Portal Documentation Library is available on the Experience Portal service pack DVD. To access the Experience 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 Aura® Experience 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: The documentation library contains references to Avaya Media Server (AMS) and Windows Server 2008 R2 SP1; both of which are not supported in Experience Portal 6.0.x. Please ignore these references.

The instructions for deploying Experience Portal from OVA files in a VMware environment are not included on the Experience Portal DVD. Download the documents below from the Avaya support Web site at http://support.avaya.com.

Note: License agreements for each of the third-party components that ship with Experience Portal can be found in the Experience Portal DVD directory /Licenses.

Installation Notes

Important: Before installing or upgrading Experience 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.

Installing the Oracle JDBC driver

The Oracle JDBC driver is no longer shipped with Experience Portal. If you wish to connect your Experience Portal system to an external Oracle database, then you must first obtain the JDBC driver from Oracle.

To download the Oracle JDBC driver:

  1. From a machine with Internet access, open a web browser.
  2. Navigate to the page http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html.
  3. From section Oracle Database 11g Release 2 (11.2.0.3) JDBC Drivers, download the following files:
  4. ojdbc6.jar
    orai18n.jar

    Important: Some web browsers are known to change the file extension of these files to .zip when the files are downloaded. If this happens, rename the files back to ojdbc6.jar and orai18n.jar.

To have the Oracle JDBC driver installed by the Experience Portal install program, complete the steps below after installing or upgrading Linux but before installing or upgrading Experience Portal.

Note: If you do not complete these steps until after installing or upgrading Experience Portal, then in addition to the steps below you will need to run the script InstallOracleJDBC.sh as described in Oracle JDBC driver.

On the Primary EPM server and each Auxiliary EPM server:

  1. Log into Linux on the EPM server using the user account that will be used to install Experience Portal.
  2. Note: Generally the account used is either root or sroot.

  3. Execute the command below to create folder ~/OracleJDBC:
  4. mkdir ~/OracleJDBC
  5. Copy the driver files ojdbc6.jar and orai18n.jar to folder ~/OracleJDBC.

Important: Leave the Oracle JDBC driver files in directory ~/OracleJDBC even after installing or upgrading Experience Portal. These files will be needed again if you ever install or upgrade Experience Portal in the future.

Fresh Installs

This service pack can be used to do a fresh install of a new Experience Portal system. You do not need to install Experience Portal 6.0 before installing this service pack.

For detailed installation procedures, see either Implementing Avaya Aura Experience Portal on multiple servers or Implementing Avaya Aura Experience 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 Experience Portal installation.

Upgrades from Voice Portal 5.x

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 to Avaya Aura Experience Portal 6.0.x. Note that before upgrading the Voice Portal software to Experience Portal you must upgrade the Linux operating system.

Upgrades from Experience Portal 6.0.x

Important: Before starting an upgrade, you should back up your Experience Portal database. If the upgrade fails for any reason, you will need this backup to restore your system to its prior state.

This service pack does not require a new version of Linux. However, you should upgrade Linux as part of installing this service pack in order to pick up numerous security fixes in the operating system.

If you are upgrading the operating system on each server as part of installing this service pack, then you should generally follow the upgrade procedure documented in Upgrading to Avaya Aura Experience Portal 6.0.x.

Note: If you are a software-only customer, ignore the portions of Upgrading to Avaya Aura Experience Portal 6.0.x that tell you to do a fresh install of Red Hat Enterprise Linux Server. You may simply upgrade Linux instead. Additionally, ignore the instructions to run the script RestoreProps.sh. When you upgrade Linux instead of doing a fresh install, your existing database will be preserved.

If you are not upgrading the operating system on each server as part of installing this service pack, then you should still follow the upgrade procedure documented in Upgrading to Avaya Aura Experience Portal 6.0.x when upgrading a single-server Experience Portal system or when upgrading the Primary EPM and Auxiliary EPM servers in a multi-server Experience Portal system. Simply skip the steps in Upgrading to Avaya Aura Experience Portal 6.0.x that relate to upgrading the operating system.

If you are upgrading a multi-server system and you are not upgrading the operating system, then you can upgrade all of your Experience Portal 6.0.x MPP servers using the Software Upgrade web page of the EPM. See the help topics under Administering Avaya Aura Experience Portal > Media Processing Platforms > Software Upgrade for instructions how to do this.

OVA Deployments

For instructions on how to deploy Experience Portal from OVA files in a VMware environment, see the document Deploying Avaya Aura Experience Portal in an Avaya Customer Experience Virtualized Environment. It can be downloaded from the Avaya support Web site at http://support.avaya.com.

Known Issues

Compatibility Issues

Privacy Manager role

A new user role named Privacy Manager was added in Experience Portal 6.0. This role is required in order for the user to change the values on the Privacy Settings page of the EPM. It is also required in order to change several of the values related to session transcription data on the Change Application page.

Previously, any user with the Administration role could perform the tasks that now require the Privacy Manager role. This means that all users with the Administration role will lose capability when the system is upgraded unless you give those users the Privacy Manager role as well.

Application logging

If you are running Dialog Designer applications on Experience Portal 6.0.x, those applications should use Dialog Designer runtime version 5.1 SP3 or later. There is an issue that causes application logging to fail intermittently when earlier versions of Dialog Designer runtime are used with Experience Portal 6.0.x.

External database URL

On the Report Database Settings page of the EPM there is a field named URL. In Voice Portal 5.x, if you used an external Oracle database and the value entered for URL contained a leading space, no error was reported. Storing report data in the Oracle database worked.

In Experience Portal 6.0.x, if the value of URL contains a leading space, Experience Portal will not be able to access the external database. After upgrading your system, verify that the Report Database Settings field URL does not contain a leading space.

Oracle JDBC driver

As noted earlier, the Oracle JDBC driver is no longer shipped with Experience Portal. If you follow the procedures in Installing the OracleJDBC driver before installing or upgrading your Primary EPM server and any Auxiliary EPM servers, then the Oracle JDBC driver will be installed in the correct directory by the Experience Portal install or upgrade program.

To install the Oracle JDBC driver after you have installed your Experience Portal system, first follow the procedures in Installing the OracleJDBC driver. Then, follow the procedure below.

On the Primary EPM server and each Auxiliary EPM server:

  1. Log into Linux on the EPM server as a user with root privileges.
  2. Execute the command below to stop the vpms service:
  3. /sbin/service vpms stop
  4. Execute the command below to navigate to the appropriate directory:
  5. cd $AVAYA_HOME/Support/Database
  6. Execute the command below to install the JDBC driver:
  7. bash InstallOracleJDBC.sh

    Important: Do not execute InstallOracleJDBC.sh on a server until you have downloaded the Oracle driver and placed it in directory ~/OracleJDBC on that server as described in Installing the OracleJDBC driver.

  8. Execute the command below to start the vpms service:
  9. /sbin/service vpms start

Package mod_dnssd

Depending upon the options you select when installing Red Hat Enterprise Linux Server, the package mod_dnssd may be installed. There is a compatibility issue between Experience Portal and mod_dnssd. It is recommended that you not install mod_dnssd.

If the package mod_dnssd is installed at the time Experience Portal is installed, the Experience Portal installer will automatically disable the incompatible entry in the mod_dnssd configuration file and display the warning message below. This message is merely a warning and may safely be ignored.

Possible Error during operation: Install/Configure Apache for VPMS
- Start error description -
Notice: Incompatible DNSSDEnable entry found in
/etc/httpd/conf.d/mod_dnssd.conf. Automatically disabling this entry. Please
see Experience Portal documentation for more details. This notice is not an error.

Note: This problem does not arise if you do a default ("Basic Server") install of Red Hat Enterprise Linux Server. Also, this issue does not apply to systems that use the Avaya provided version of Linux.

Network interfaces move

When you install Red Hat Enterprise Linux Server 6 on a server that previously had Red Hat Enterprise Linux 5 installed on it, you may find that logical network interfaces eth0, eth1, etc. have moved to different physical network ports on the server. For example, the port that was interface eth0 on Red Hat Enterprise Linux 5 might become interface eth2 on Red Hat Enterprise Linux Server 6, while the port that was interface eth2 on Red Hat Enterprise Linux 5 might become logical network interface eth0 on Red Hat Enterprise Linux Server 6. Similarly, the ports associated with network interfaces eth1 and eth3 might be reversed after you upgrade Linux. If this happens, you will either need to move any network cables that are plugged into the server to match the Linux network configuration, or you will need to change the Linux network configuration.

Documentation Issues

Upgrading the 5.0 or 5.1 Voice Portal software interactively

The help topic Upgrading to 6.0.x > Upgrading the VPMS and MPP software on different servers > Upgrading the 5.0 or 5.1 Voice Portal software interactively contains errors.

In step 10 you are instructed to verify the values shown on the Version Confirmation screen in column Install Type. If you are upgrading a server that uses the Avaya provided version of Linux, then the column Install Type should say Upgrade for all selected features, as the help topic states. However, if you are upgrading a server that uses Red Hat Enterprise Linux Server, then only the feature EPM will have an Install Type of Upgrade. In this case, the Install Type of feature Documentation will be Full Install.

Upgrading the 5.0 or 5.1 Voice Portal software interactively on a single server

The help topic Upgrading to 6.0.x > Upgrading the Voice Portal software on a single server > Upgrading the 5.0 or 5.1 Voice Portal software interactively on a single server contains errors.

In step 10 you are instructed to verify the values shown on the Version Confirmation screen in column Install Type. If you are upgrading a server that uses the Avaya provided version of Linux, then the column Install Type should say Upgrade for all selected features, as the help topic states. However, if you are upgrading a server that uses Red Hat Enterprise Linux Server, then only the feature EPM will have an Install Type of Upgrade. In this case, the Install Type of features Documentation and MPP will be Full Install.

Upgrading the 5.0 or 5.1 auxiliary Voice Portal software interactively

The help topic Upgrading to 6.0.x > Upgrading the 5.0 or 5.1 auxiliary VPMS server > Upgrading the 5.0 or 5.1 auxiliary Voice Portal software interactively contains errors.

In step 11 you are instructed to verify the values shown on the Version Confirmation screen in column Install Type. If you are upgrading a server that uses the Avaya provided version of Linux, then the column Install Type should say Upgrade for all selected features, as the help topic states. However, if you are upgrading a server that uses Red Hat Enterprise Linux Server, then only the feature EPM will have an Install Type of Upgrade. In this case, the Install Type of feature Documentation will be Full Install.

Third party logs for ASR and TTS servers

The Help topic Troubleshooting Avaya Aura Experience Portal > Avaya Aura Experience Portal log files > Third party logs for ASR and TTS servers contains errors. Log files can be found on third party speech servers as follows:

Nuance Speech Server 5.1.x with Nuance Recognizer 9.x and Nuance Vocalizer 5.0.x
Nuance Speech Server 5.0.x with Nuance Recognizer 9.x and RealSpeak 4.5.x

Loquendo MRCP Server 7.2.x
Loquendo Speech Server 7.0.x

* Only if option lasrEnableLogging enabled in Loquendo management console.

** Only if option lttsEnableLogging enabled in Loquendo management console.

Installation Issues

Disk partitions

On a Primary EPM server, the Experience Portal database might grow to be quite large. The report data generated automatically by Experience Portal causes the database to grow by approximately 4GB for every one million calls processed. If your applications use the Experience Portal application logging feature, the database grows even faster.

By default, the Experience Portal database resides in the directory /var/lib/pgsql/data. If you are a software-only customer, when you install Red Hat Enterprise Linux Server on your EPM server you should ensure that the disk partitions you define provide adequate space for the Experience Portal database. Note that the default partition scheme provided by Red Hat Enterprise Linux Server has proven adequate for most Experience Portal installations. It results in the Experience 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/ExperiencePortal/MPP/logs. If you are a software-only customer, when you install Red Hat Enterprise Linux Server 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 Server has proven adequate for most Experience 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 Avaya Aura Experience Portal > Media Processing Platforms > Moving the MPP logs to a different location for instructions on how to change where MPP logs are stored.

File /etc/hosts not correct on Red Hat Enterprise Linux Server

Depending upon the options you select when installing Red Hat Enterprise Linux Server, the file /etc/hosts may contain incorrect information. This incorrect information will cause the Experience Portal install program to fail.

To test for this problem:

  1. Log into Linux on the Experience Portal server as a user with root privileges.
  2. Execute the command below to see the server's IP address:
  3. hostname -i

If the IP address displayed is correct, then /etc/hosts is correct. If the output from hostname -i contains both the server's real IP address and the IPv4 loopback address (127.0.0.1), then follow the procedure below.

To correct file /etc/hosts:

  1. Open the file /etc/hosts in a text editor.
  2. Remove the server's host name from the line that contains the IPv6 loopback address (::1).
  3. Save and close the file.
  4. Execute the command below to disable the NetworkManager service:
  5. chkconfig NetworkManager off
  6. Reboot the server

Note: This problem does not arise if you do a default ("Basic Server") install of Red Hat Enterprise Linux Server. Also, this issue does not apply to systems that use the Avaya provided version of Linux.

Installing on Red Hat Enterprise Linux Server 6.1

If you are installing this service pack on Red Hat Enterprise Linux Server 6.1, then before installing or upgrading Experience Portal you may need to manually install several packages from Red Hat that are not installed by default. The packages that you need to manually install after doing a default ("Basic Server") install of Red Hat Enterprise Linux Server 6.1 are shown below.

All of the packages listed can be found in the directory /Packages on your Red Hat Enterprise Linux Server DVD. These packages can also be found in the directory /Utilities/RedHat6.1Prerequisites on your Experience Portal 6.0 Service Pack 2 DVD.

audit-libs-python-2.1-5.el6.i686.rpm
libselinux-python-2.0.94-5.el6.i686.rpm
libsemanage-python-2.0.43-4.el6.i686.rpm
policycoreutils-python-2.0.83-19.8.el6_0.i686.rpm
setools-libs-3.3.7-4.el6.i686.rpm
setools-libs-python-3.3.7-4.el6.i686.rpm

Note: To avoid dependency issues among these packages, you should install all of the packages listed above with a single rpm command.

Note: The package list above assumes that you have done a default ("Basic Server") install of Red Hat Enterprise Linux Server 6.1. If you have a different configuration of Red Hat Enterprise Linux Server 6.1, then you may need to install additional packages from your Red Hat Enterprise Linux Server DVD in order to resolve dependency issues encountered while installing the packages listed above.

Note: This issue does not apply to systems that use the Avaya provided version of Linux.

Installing on Red Hat Enterprise Linux Server 6.2

If you are installing this service pack on Red Hat Enterprise Linux Server 6.2, then before installing or upgrading Experience Portal you may need to manually install several packages from Red Hat that are not installed by default. The packages that you need to manually install after doing a default ("Basic Server") install of Red Hat Enterprise Linux Server 6.2 are shown below.

All of the packages listed can be found in the directory /Packages on your Red Hat Enterprise Linux Server DVD. These packages can also be found in the directory /Utilities/RedHat6.2Prerequisites on your Experience Portal 6.0 Service Pack 2 DVD.

audit-libs-python-2.1.3-3.el6.i686.rpm
libselinux-python-2.0.94-5.2.el6.i686.rpm
libsemanage-python-2.0.43-4.1.el6.i686.rpm
policycoreutils-python-2.0.83-19.18.el6.i686.rpm
setools-libs-3.3.7-4.el6.i686.rpm
setools-libs-python-3.3.7-4.el6.i686.rpm

Note: To avoid dependency issues among these packages, you should install all of the packages listed above with a single rpm command.

Note: The package list above assumes that you have done a default ("Basic Server") install of Red Hat Enterprise Linux Server 6.2. If you have a different configuration of Red Hat Enterprise Linux Server 6.2, then you may need to install additional packages from your Red Hat Enterprise Linux Server DVD in order to resolve dependency issues encountered while installing the packages listed above.

Note: This issue does not apply to systems that use the Avaya provided version of Linux.

Installing on Red Hat Enterprise Linux Server 6.3

If you are installing this service pack on Red Hat Enterprise Linux Server 6.3, then before installing or upgrading Experience Portal you may need to manually install several packages from Red Hat that are not installed by default. The packages that you need to manually install after doing a default ("Basic Server") install of Red Hat Enterprise Linux Server 6.3 are shown below.

All of the packages listed can be found in the directory /Packages on your Red Hat Enterprise Linux Server DVD. These packages can also be found in the directory /Utilities/RedHat6.3Prerequisites on your Experience Portal 6.0 Service Pack 2 DVD.

audit-libs-python-2.2-2.el6.i686.rpm
libselinux-python-2.0.94-5.3.el6.i686.rpm
libsemanage-python-2.0.43-4.1.el6.i686.rpm
policycoreutils-python-2.0.83-19.24.el6.i686.rpm
setools-libs-3.3.7-4.el6.i686.rpm
setools-libs-python-3.3.7-4.el6.i686.rpm

Note: To avoid dependency issues among these packages, you should install all of the packages listed above with a single rpm command.

Note: The package list above assumes that you have done a default ("Basic Server") install of Red Hat Enterprise Linux Server 6.3. If you have a different configuration of Red Hat Enterprise Linux Server 6.3, then you may need to install additional packages from your Red Hat Enterprise Linux Server DVD in order to resolve dependency issues encountered while installing the packages listed above.

Note: This issue does not apply to systems that use the Avaya provided version of Linux.

Use same Linux account on upgrades

When you install or upgrade the Experience Portal software, the install or upgrade program (installvp or autoupgradevp) must be run as a Linux user with root privileges. Typically, the account used is either root or sroot. When upgrading a system that already has Voice Portal or Experience Portal installed, if the upgrade program is run using a different Linux account than was used during the previous install or upgrade, the upgrade may fail.

To work around this issue, always upgrade using the same Linux account that was used during the previous installation.

Prerequisite installer fails to install PHP

During the portion of the install program where prerequisites are installed, a message similar to the following may be displayed:

||  >>>>>>Starting RPM installation: 'rpm -U --replacepkgs /mnt/cdrom/
||    external/common_rpms
||  error: not an rpm package
||  error: /mnt/cdrom/external/common_rpms: not an rpm package (or package
||    manifest): Is a directory

||  >>>>>>RPM Installation failed: Exit Code: 1

If prerequisite installation fails, the installation will not continue.

To resolve this issue:

  1. Manually install the packages php-pdo and php-process. You can find these two packages in the directory /external/common_rpms on the Experience Portal DVD.
  2. Important: If your server has a different version of PHP installed than the version on the Experience Portal DVD, then obtain the packages php-pdo and php-process from wherever you obtained the other PHP packages on your server.

  3. Re-execute the Experience Portal installation.

Auxiliary VPMS stops working when Primary VPMS is upgraded

After you upgrade your Primary VPMS to Experience Portal your Auxiliary VPMS will no longer be able to communicate with it. To resolve this issue, upgrade your Auxiliary VPMS to Experience Portal.

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.

Auxiliary EPM stops working if Primary EPM is reinstalled

When you do a fresh install of a Primary EPM a new security certificate is generated for that server. If the Primary EPM is part of an existing Experience Portal system, then any Auxiliary EPM servers that are part of the system will no longer be able to communicate with the Primary EPM because they do not know about the new security certificate.

To resolve this issue, on each Auxiliary EPM server:

  1. Log into Linux on the Auxiliary EPM server as a user with root privileges.
  2. Execute the command below to navigate to the appropriate directory:
  3. cd $AVAYA_HOME/Support/VP-Tools
  4. Execute the command below to retrieve the new security certificate from the Primary EPM:
  5. ./setup_vpms.php <PrimaryEPM>

    Note: The <PrimaryEPM> above is the name or IP address of the Primary EPM server that manages this Auxiliary EPM.

  6. Follow the on-screen prompts to install the security certificate, restart Apache, and configure Network Time Protocol (NTP).

Co-resident application server not started automatically on Avaya Linux

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:

  1. After upgrading Avaya Linux, upgrade the Experience Portal software.
  2. Execute the command below to start the co-resident application server:
  3. /sbin/service appserver start

Note: This issue does not apply to software-only customers who provide their own Red Hat Enterprise Linux Server.

Voice Portal 5.0.x does not recognize Experience Portal 6.0 license

Normally, when you upgrade a system from one release to another release where a new license file is required the recommended procedure is to install the new license file before upgrading the software. This is because the old software should work with the new license file, but the new software will not work with the old license file.

Unfortunately, Voice Portal 5.0.x does not recognize Experience Portal 6.0 licenses. So, if you install the Experience Portal license before upgrading your Voice Portal 5.0.x system to Experience Portal, your system will stop operating until the software is upgraded.

To work around this issue, upgrade your Voice Portal 5.0.x system to Experience Portal 6.0.x before installing the Experience Portal 6.0 license. Although Experience Portal 6.0.x will not recognize the Voice Portal 5.0 license, Experience Portal 6.0.x will operate without a license for up to 30 days.

Note: This issue only applies to Voice Portal 5.0.x. Voice Portal 5.1.x customers should upgrade the license file before upgrading the software, as usual.

Upgrade script RestoreProps.sh fails on backups taken from Voice Portal 5.0 systems

If you are upgrading a system that uses Red Hat Enterprise Linux Server rather than the Avaya provided version of Linux, then you must use the System Backup web page of the VPMS to create a backup package for your existing system before starting the upgrade. During the upgrade process you will run a script called RestoreProps.sh that reads this backup package.

RestoreProps.sh cannot read backup packages created by Voice Portal 5.0 systems. If you are upgrading a Voice Portal 5.0 system that uses Red Hat Enterprise Linux, then you must first upgrade that system to Voice Portal 5.0 SP2 before upgrading the system to Experience Portal 6.0.x.

Note: This issue does not apply to systems that use the Avaya provided version of Linux. It also does not apply to systems that are running Voice Portal 5.0 SP1 or later.

Two MPP system may stop taking calls when using Software Upgrade web page

When you use the Software Upgrade web page of the EPM to upgrade multiple MPP servers, the MPP servers are stopped and upgraded one at a time so that the system can continue to process calls during the upgrade. However, it can happen that after one MPP is upgraded the next MPP is taken out of service before the first MPP is all the way up and ready to answer calls. On a two MPP system, this means that both MPP servers can be out of service at the same time.

To work around this issue, when using the Software Upgrade web page on a two MPP system, do not upgrade both MPP servers at the same time. Instead, upgrade one MPP, wait for it to start taking calls, then upgrade the other MPP.

Error reinstalling MPP

When you uninstall and reinstall the MPP software you may see the error below at the end of the Experience Portal install program. This error may safely be ignored.

Installing MPP...
Possible Error during operation: Stop mppmonitor
- Start error description -
initctl: Method "Get" with signature "ss" on interface
"org.freedesktop.DBus.Properties" doesn't exist

- End error description -
...done installing MPP

OVA Deployment Issues

IP address fields sometimes clipped when deploying via vCenter

When an Experience Portal OVA is deployed via vCenter, a screen labeled Properties is displayed where you enter Linux network and Experience Portal specific parameters. Several of the fields on this screen accept input in IP address format. On some computers, the vSphere Client program clips these fields such that only the first three octets of the address are visible. The fourth octet can be entered, but you may have to scroll the window in order to see it.

User sometimes prompted to configure Experience Portal after deploying via vCenter

When an Experience Portal OVA is deployed via vCenter, all configurable parameter values are entered during the vSphere Client OVF deployment wizard. Those parameters values are not actually applied to the deployed virtual machine, though, until the virtual machine boots up for the first time. It can take several minutes during that initial boot for the configuration process to complete. If you remotely log into Linux (via SSH) during this configuration process, you may be told that Experience Portal has not been configured and asked if you would like to configure Experience Portal now.

When you remotely log into Linux after deploying a virtual machine via vCenter, if you are asked if you want to configure Experience Portal, respond n ("no"). Log out of the remote Linux session. Wait for the boot process to complete. Log into Linux via the console. Verify that there are no deployment errors displayed on the console. Once the Experience Portal configuration process completes, you will no longer be prompted to configure Experience Portal when you log into Linux.

Note: This problem does not arise if you initially log into a newly deployed virtual machine via the console window of the vSphere Client. The console will not prompt you to log in until after the Experience Portal configuration has completed.

System Operation Issues

Cannot mount DVD on Avaya Linux

When you execute the command mount /mnt/cdrom on Avaya Linux, you might see the error below:

mount: No medium found

Typically, this error occurs because the wrong physical device is mapped to the mount point /mnt/cdrom in the file /etc/fstab.

To correct file /etc/fstab:

  1. Log into Linux on the Experience Portal server as a user with root privileges.
  2. Execute the command below to display information about your DVD devices:
  3. cat /proc/sys/dev/cdrom/info

    It will display a table of information similar to the following:

    drive name:sr0hda
    drive speed:024
    drive # of slots:11
    Can close tray:11
    ...
  4. In the output displayed, find the row for drive speed.
  5. Within the row for drive speed, find the column that contains a non-zero value.
  6. Note: In the example output shown above, the column you are looking for contains the value 24.

  7. In the column you just found, go up one row to find the drive name.
  8. Note: In the example output shown above, the drive name you are looking for is hda.

  9. Execute the command below to display a list of device special files associated with your DVD devices:
  10. ls -l /dev | grep cdrom

    It will display a list similar to the following:

    lrwxrwxrwx1srootroot4Aug 31 08:11cdrom -> scd0
    lrwxrwxrwx1srootroot3Aug 16 11:16cdrom-hda -> hda
    lrwxrwxrwx1srootroot4Aug 31 08:11cdrom-sr0 -> scd0
  11. In the output displayed, find the line for the drive name that you found earlier.
  12. Note: In the example output shown above, you are looking for the line that ends cdrom-hda -> hda.

  13. In the line you just found, find the device special file name just to the left of the drive name.
  14. Note: In this example the device special file name is cdrom-hda.

  15. Open the file /etc/fstab in a text editor.
  16. Find the line below:
  17. /dev/cdrom   /mnt/cdrom   iso9660 noauto,owner,ro 0   2
  18. Change /dev/cdrom to the path to of the device special file that you just found.
  19. Note: In this example the corrected line reads as follows:

    /dev/cdrom-hda   /mnt/cdrom   iso9660 noauto,owner,ro 0   2
  20. Save and close the file.

Cannot back up to Windows file share

The Backup Server page of the EPM, which is accessed from the System Backup page, allows you to configure Experience Portal to store database backups on a file server running either Linux or Windows. In the field Server Address you typically enter the IP address of your file server. However, if your file server is running certain versions of Windows, Experience Portal will not be able to access the file server using its IP address.

To work around this issue, if Experience Portal cannot access your file server using its IP address then enter the fully qualified domain name (FQDN) of the file server in the field Server Address on the EPM page Backup Server.

Database restore fails if an Auxiliary EPM is running

Early in the database restore process, the existing database on the Primary EPM is deleted so that a new database can be created and populated from a backup package. Deleting the existing database on the Primary EPM fails if an Auxiliary EPM is connected to the database. This causes the restore to fail and leaves the database in an unpredictable state.

To work around this issue, stop all Auxiliary EPM servers in the system before attempting a database restore on the Primary EPM. Restart all Auxiliary EPM servers after the database restore completes successfully.

For instructions on how to stop and start the Auxiliary EPM servers, see the help topic Administering Avaya Aura Experience Portal > Server and database administration > EPM server administration > Stopping the vpms service.

MPP core dump when speech server configuration changes

Under rare circumstances, an Experience Portal MPP will generate a core dump after you make a change on any Change ASR Server page or Change TTS Server page of the EPM.

To work around this issue, restart all MPP servers any time you make a configuration change to a speech server, such as changing the server's IP address or changing the communication protocol used.

Changing server host name or IP address

If the host name or IP address of any Experience Portal server changes, then you must run the utility do_UpdateHost.

If the host name or IP address of a Primary EPM or Auxiliary EPM server changes, you must additionally perform the following steps on that server after running do_UpdateHost:

  1. Log into Linux as a user with root privileges.
  2. Execute the command below to stop the vpms service:
  3. /sbin/service vpms stop
  4. Execute the command below to copy a core services configuration file to the correct location:
  5. cp -p /tmp/BootstrapDBResource.dat /opt/coreservices/scc/runtime/
  6. Execute the command below to start the vpms service:
  7. /sbin/service vpms start

Application logging

If you are running a Dialog Designer or Orchestration Designer application that does application logging, and your Experience Portal system is configured to handle more than 75 simultaneous calls, then you must make the following configuration change on your Primary EPM:

  1. Log into Linux on the Primary EPM server as a user with root privileges.
  2. Open the file $CATALINA_HOME/conf/server.xml in a text editor.
  3. Find the entry maxThreads="500" under <Connector port="3009".
  4. Change the value from 500 to 1000.
  5. Save and close the file.
  6. Execute the command below to restart the vpms service:
  7. /sbin/service vpms restart

Supporting non-English applications

Application language

When an application runs on the MPP, the VoiceXML Interpreter defaults to the language configured in the Language field on the Browser Settings page of the EPM. The default value for this field is English(USA) 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.

Default event handlers

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 EPM. The default event handlers shipped with Experience Portal play an error prompt spoken in English. If your application uses a language other than English, then 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. Experience Portal will automatically search for prompt files in the appropriate directory.

Sending DTMF digits

A feature new in Experience Portal 6.0 is the ability for VoiceXML applications to request that the system send DTMF digits. This feature is most commonly used when an application running on Experience Portal is communicating with some other automated system rather than a human. Previously, the only way for Experience Portal applications to send DTMF digits was to play an audio file that contains a recording of the digits to be sent.

Below is a sample VoiceXML application that demonstrates how to send the digits 1 2 3 4:

<?xml version="1.0" encoding="UTF-8"?>
<vxml version="2.1"
    xmlns="http://www.w3.org/2001/vxml"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.w3.org/2001/vxml
        http://www.w3.org/TR/2007/REC-voicexml21-20070619/vxml.xsd">
    <form>
        <field>
            <prompt>
                <audio src="builtin://senddigit/1234"/>
            </prompt>
        </field>
    </form>
</vxml>

Making outcall using SIP

Normally, on an Experience Portal system that has both H.323 and SIP configured, when a CCXML application does a <createcall> the MPP will look for an available H.323 port to place the call on before it will look for an available SIP port. A feature new in Experience Portal 6.0 SP1 is the ability for CCXML applications to request that the MPP look for an available SIP port first. The application can now pass a hint named suggest_sip on the <createcall> request.

Below is a snippet of CCXML code that demonstrates how to make an outcall using SIP:

<var name="suggest_sip" expr="true"/>
<script>var hints= new Object(); hints.suggest_sip = suggest_sip; </script>
<createcall dest="'14085551234'" hints="hints"/>

External System Issues

Apache Tomcat

Application logging on Linux application server

If you are running a Dialog Designer or Orchestration Designer application that does application logging, and your Primary EPM goes out of service, Dialog Designer/Orchestration Designer temporarily stores the application log data on your application server while waiting for the Primary EPM to come back in service. If your application server is Tomcat running on Linux and the Primary EPM 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:

  1. Log into Linux on the Tomcat server as a user with root privileges.
  2. Open the file /etc/init.d/tomcat in a text editor.
  3. Find the start() procedure.
  4. Add the following line to the start procedure before Tomcat is started:
  5. ulimit -n 8192
  6. Save and close the file.
  7. Execute the command below to restart the tomcat service:
  8. /sbin/service tomcat restart

Change Tomcat startup options to improve garbage collection on your application server:

  1. Log into Linux on the Tomcat server as a user with root privileges.
  2. Open the file /etc/init.d/tomcat in a text editor.
  3. Find the line that begins with export JAVA_OPTS=.
  4. Change this line to read as follows.
    Important: All of the text below must be entered on a single line.
  5. export JAVA_OPTS="-server -Xmx1024m -XX:MaxNewSize=30m -X:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:CMSInitiatingOccupancyFraction=60-XX:ThreadStackSize=512"
  6. Save and close the file.
  7. Execute the command below to restart the tomcat service:
  8. /sbin/service tomcat restart

Avaya Aura® Session Manager

Installing Experience Portal certificate

In order for Experience Portal to establish a TLS connection to a Session Manager server, you must install the security certificate from Experience Portal on Session Manager.

If your Session Manager is version 6.x, refer to your Session Manager product documentation for instructions on how to install a security certificate on Session Manager. The relevant information can be found in the document Administering Avaya Aura® Session Manager in Chapter 3: Managing Security.

If your Session Manager is version 5.x, please contact Avaya technical support for help with installing the Experience Portal security certificate on Session Manager.

Session Manager Certificate URL

In order for Experience Portal to establish a TLS connection to a Session Manager server, you must install the security certificate from Session Manager on Experience 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. Depending on your Session Manager configuration, the SM-100 asset may be either hardware or software.

Avaya Aura® SIP Enablement Services (SES)

Call distribution not balanced when an MPP is down

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.

SES Certificate URL

In order for Experience Portal to establish a TLS connection to a SIP Enablement Services (SES) server, you must install the security certificate from SES on Experience 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.

Loquendo speech servers

Note: Refer to the appropriate interoperability guide that came with your Loquendo software for instructions on configuring your Loquendo speech servers and configuring Experience Portal to work with them. With Loquendo MRCP Server 7.2 software the appropriate document is called Avaya Interoperability Guide. With Loquendo Speech Suite 7.0 software the appropriate document is called Avaya Voice Portal Interoperability HowTo.

Stability issues with MRCPv2

Experience Portal communicates with speech servers using either Media Resource Control Protocol version one (MRCPv1) or Media Resource Control Protocol version two (MRCPv2). A variety of issues, including failure to acquire speech resources and long latencies, have been observed when Experience Portal uses MRCPv2 to communicate with Loquendo speech servers. To avoid these issues, configure Experience Portal to use MRCPv1 when communicating with Loquendo speech servers.

Microsoft Internet Explorer

Security problem trying to play utterances

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.

Cannot view exported file

When you click the Export button on any EPM 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

  1. In Internet Explorer, select Tools > Internet Options.
  2. On the Internet Options page, select the Advanced tab.
  3. On the Advanced tab, disable the Do not save encrypted pages to disk option, which is located in the Security section.

Cannot view report output from e-mail link

While viewing an e-mail that was sent by Experience 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

Microsoft SQL Server 2008

Cannot access remote database

Recent versions of Java include code to handle cipher block chaining (CBC) attacks. Unfortunately, this security enhancement sometimes prevents Experience Portal from connecting to a Microsoft SQL Server 2008 external database. To work around this issue you must disable CBC protection in Java.

On the Primary EPM server and each Auxiliary EPM server:

  1. Log into Linux on the EPM server as a user with root privileges.
  2. Open the file /etc/profile in a text editor.
  3. Find the line that begins with export JAVA_OPTS=.
  4. Change this line to include the text -Djsse.enableCBCProtection=false as shown below.
    Important: All of the text below must be entered on a single line.
  5. JAVA_OPTS="-server -XX:MaxNewSize=256m -Xmx1024M -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -XX:ThreadStackSize=1024 -Ddss.port=31050 -XX:PermSize=256m -XX:MaxPermSize=256m -XX:+HeapDumpOnOutOfMemoryError -XX:GCTimeRatio=19 -XX:CMSInitiatingOccupancyFraction=60 -Dcom.sun.management.jmxremote -XX:SurvivorRatio=8 -XX:TargetSurvivorRatio=90 -XX:MaxTenuringThreshold=0 -XX:+UseCMSCompactAtFullCollection -XX:CMSFullGCsBeforeCompaction=1 -Dsun.lang.ClassLoader.allowArraySyntax=true -XX:-DoEscapeAnalysis -Djsse.enableCBCProtection=false"
  6. Save and close the file.
  7. Reboot the server

Nuance speech servers

Remote DTMF Detection

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.

Property inputmodes

Normally, a VoiceXML application can use the property inputmodes to control whether the speech server recognizes speech input, DTMF input, or both. However, Nuance speech servers do not support the property inputmodes when accessed over a Media Resource Control Protocol version one (MRCPv1) connection. To use property inputmodes with a Nuance speech server you must configure Experience Portal to communicate with that speech server using Media Resource Control Protocol version two (MRCPv2).

Recognition timeout while playing a long prompt

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:

  1. On the Nuance server, open the file $NSSSVRSDK/config/NSSserver.cfg in a text editor.
  2. Find the line in the form of the following:
  3. 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.

  4. Increase the timeout value XXXXXX on the line found above.
  5. Find the line in the form of the following:
  6. 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.

  7. Increase the timeout value XXXXXX on the line found above.
  8. Save and close the file.
  9. Restart the Nuance server.

For a Nuance Speech Server running on Windows:

  1. On the Nuance server, open the file %NSSSVRSDK%\config\NSSserver.cfg in a text editor.
  2. Find the line in the form of the following:
  3. 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.

  4. Increase the timeout value XXXXXX on the line found above.
  5. Find the line in the form of the following:
  6. 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.

  7. Increase the timeout value XXXXXX on the line found above.
  8. Save and close the file.
  9. Restart the Nuance server.

Getting recognition results on <nomatch> event

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:

  1. On the Nuance server, open the file $NSSSVRSDK/config/NSSserver.cfg in a text editor.
  2. Find the line for parameter server.mrcp2.osrspeechrecog.mrcpdefaults.VSP.server.osrspeechrecog.result.sendnomatch.
  3. Change this line to read as follows.
    Important: All of the text below must be entered on a single line.
  4. server.mrcp2.osrspeechrecog.mrcpdefaults.VSP.server.osrspeechrecog.result.sendnomatch VXIString true

    Important: If present, be sure to remove the # character at the beginning of the above line to uncomment it.

  5. Find the line for parameter server.mrcp1.osrspeechrecog.result.sendnomatch.
  6. Change this line to read as follows.
    Important: All of the text below must be entered on a single line.
  7. server.mrcp1.osrspeechrecog.result.sendnomatch VXIString true

    Important: If present, be sure to remove the # character at the beginning of the above line to uncomment it.

  8. Save and close the file.
  9. Open the file $SWISRSDK/config/Baseline.xml in a text editor.
  10. If using NRec 9.0.11 or 9.0.12:
    1. Find the series of lines beginning with the following:
    2. <param name="swisr_result_enable_speech_mode">
    3. Change the series of lines to read as follows:
    4. <param name="swisr_result_enable_speech_mode">
          <value>1</value>
      </param>
  11. If using NRec 9.0.13 or later:
    1. Find the series of lines beginning with the following:
    2. <param name="swirec_result_enable_speech_mode">
    3. Change the series of lines to read as follows:
    4. <param name="swirec_result_enable_speech_mode">
          <value>1</value>
      </param>
  12. Save and close the file.
  13. Restart the Nuance server.

For a Nuance Speech Server running on Windows:

  1. On the Nuance server, open the file %NSSSVRSDK%\config\NSSserver.cfg in a text editor.
  2. Find the line for parameter server.mrcp2.osrspeechrecog.mrcpdefaults.VSP.server.osrspeechrecog.result.sendnomatch.
  3. Change this line to read as follows.
    Important: All of the text below must be entered on a single line.
  4. server.mrcp2.osrspeechrecog.mrcpdefaults.VSP.server.osrspeechrecog.result.sendnomatch VXIString true

    Important: If present, be sure to remove the # character at the beginning of the above line to uncomment it.

  5. Find the line for parameter server.mrcp1.osrspeechrecog.result.sendnomatch.
  6. Change this line to read as follows.
    Important: All of the text below must be entered on a single line.
  7. server.mrcp1.osrspeechrecog.result.sendnomatch VXIString true

    Important: If present, be sure to remove the # character at the beginning of the above line to uncomment it.

  8. Save and close the file.
  9. Open the file %SWISRSDK%\config\Baseline.xml in a text editor.
  10. If using NRec 9.0.11 or 9.0.12:
    1. Find the series of lines beginning with the following:
    2. <param name="swisr_result_enable_speech_mode">
    3. Change the series of lines to read as follows:
    4. <param name="swisr_result_enable_speech_mode">
          <value>1</value>
      </param>
  11. If using NRec 9.0.13 or later:
    1. Find the series of lines beginning with the following:
    2. <param name="swirec_result_enable_speech_mode">
    3. Change the series of lines to read as follows:
    4. <param name="swirec_result_enable_speech_mode">
          <value>1</value>
      </param>
  12. Save and close the file.
  13. Restart the Nuance server.

Chinese TTS using Nuance Speech Server 5.0

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:

  1. On the Nuance server, open the file $NSSSVRSDK/config/NSSserver.cfg in a text editor.
  2. Find the series of lines below:
  3. server.rsspeechsynth.languageid.zh VXIString Mandarin Chinese
    server.rsspeechsynth.languageid.zh-CN VXIString Mandarin Chinese
    server.rsspeechsynth.languageid.zh-guoyu VXIString Mandarin Chinese
  4. Change the series of lines to read as follows:
  5. 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
  6. Save and close the file.
  7. Restart the Nuance server.

For a Nuance Speech Server running on Windows:

  1. On the Nuance server, open the registry editor.
  2. Create or edit registry keys as necessary to match the values shown below:
  3. [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"
  4. Close the registry editor.
  5. Open the file %NSSSVRSDK%\config\NSSserver.cfg in a text editor.
  6. Find the series of lines below:
  7. server.rsspeechsynth.languageid.zh VXIString Mandarin Chinese
    server.rsspeechsynth.languageid.zh-CN VXIString Mandarin Chinese
    server.rsspeechsynth.languageid.zh-guoyu VXIString Mandarin Chinese
  8. Change the series of lines to read as follows:
  9. 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
  10. Save and close the file.
  11. Restart the Nuance server.

More Information

Online: