Avaya Aura® Experience Portal 6.0 Service Pack 1

Release Note (Issue 9)

June 2012

Contents

Introduction

Problems Fixed

Product Information

Installation Notes

Fresh Installs

Upgrades from Voice Portal 5.x

Upgrades from Experience Portal 6.0

Known Issues

Documentation Issues

Installation Issues

Compatibility Issues

System Operation Issues

External System Issues

More Information

Introduction

This document contains Experience Portal 6.0 Service Pack 1 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

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:

• What's new between Voice Portal 5.1 and Avaya Aura Experience Portal 6.0
• Planning for Avaya Aura Experience Portal
• Implementing Avaya Aura Experience Portal on multiple servers
• Implementing Avaya Aura Experience Portal on a single server
• Upgrading to Avaya Aura Experience Portal 6.0.x
• Administering Avaya Aura Experience Portal
• Avaya Aura Experience Portal web interface page reference
• Avaya Aura Experience Portal events and associated alarms
• Troubleshooting Avaya Aura Experience Portal

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:

• Avaya Aura Experience Portal 6.0 Security White Paper

Note: The Experience Portal Documentation Library shipped with this service pack is newer than the documentation library that shipped with Experience Portal 6.0.

Note: The documentation library contains references to Avaya Media Server (AMS) and Windows Server 2008 R2 SP1 which are not supported in Experience Portal 6.0 but are targeted for a future release.

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:

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 as a user with root privileges.
2. Execute the command below to create folder ~/OracleJDBC:

mkdir ~/OracleJDBC

3. 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

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 may choose to upgrade Linux as part of installing this service pack.

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 MPP servers using the Software Upgrade web page of the EPM. 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 EPM:

1. Log into Linux on the MPP server as a user with root privileges.
2. Execute the command below to download a security certificate from the Primary EPM.

$AVAYA_IA_HOME/bin/DownloadPK.bash <PrimaryEPM>

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

To upgrade all of your Experience Portal 6.0 MPP servers:

1. After upgrading the Primary EPM server, log into the EPM web interface using an account with administrative privileges.
2. Navigate to the Software Upgrade web page.
3. Select the checkbox that selects all of the MPP servers listed.
4. In the New Version selection box, select the file name for this service pack.
5. Select the Upgrade button.

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. MPP servers 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 MPP servers that are still awaiting upgrade will not be upgraded. This is to avoid the possibility of an upgrade issue causing all MPP servers to go out of service at the same time.

Co-resident application server

If you are upgrading a single server Experience Portal 6.0 system that includes a co-resident application server, then you need to manually edit the configuration of that application server.

To correct the configuration of the co-resident application server:

1. Log into Linux on the Experience Portal server as a user with root privileges.
2. Execute the command below to stop the appserver service:

/sbin/service appserver stop

3. Open the file $APPSERVER_HOME/conf/web.xml in a text editor.
4. Insert the lines below just before the tag </web-app>.

<security-constraint>

<web-resource-collection>

<web-resource-name>DisabledMethods</web-resource-name>

<url-pattern>/*</url-pattern>

<http-method>DELETE</http-method>

<http-method>PUT</http-method>

<http-method>OPTIONS</http-method>

</web-resource-collection>

<auth-constraint/>

</security-constraint>

5. Save and close the file.
6. Execute the command below to delete an unused file:

rm $APPSERVER_HOME/webapps/ROOT/favicon.ico

7. Execute the command below to start the appserver service:

/sbin/service appserver start

Known Issues

Documentation Issues

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

• Linux: All logs located in $NSSSVRSDK/logs
• Windows: All logs located in %NSSSVRSDK%\logs

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

• Linux:
• LMS/LSS: /var/opt/Loquendo/Platform/logs
• ASR: /var/opt/Loquendo/Platform/logs/LASR*
• TTS: /var/opt/Loquendo/Platform/logs/LTTS**
• Windows:
• LMS: %APPDATA%\Loquendo\Platform\logs
• ASR: %APPDATA%\Loquendo\Platform\logs\LASR*
• TTS: %APPDATA%\Loquendo\Platform\logs\LTTS**

* Only if option lasrEnableLogging enabled in Loquendo management console.

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

Installation Issues

Root access on Avaya Linux

The Experience Portal installation program must be run from an account that has root privileges. If you are installing or upgrading Experience 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.

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:

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:

chkconfig NetworkManager off

5. 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 1 DVD.

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 1 DVD.

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.

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.

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:

/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 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 does not recognize Experience Portal 6.0 licenses. So, if you install the Experience Portal license before upgrading your Voice Portal 5.0 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 system to Experience Portal 6.0 before installing the Experience Portal 6.0 license. Although Experience Portal 6.0 will not recognize the Voice Portal 5.0 license, Experience Portal 6.0 will operate without license for up to 30 days.

Note: This issue only applies to Voice Portal 5.0. Voice Portal 5.1 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.

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.

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, 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.

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, 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:

/sbin/service vpms stop

3. Execute the command below to navigate to the appropriate directory:

cd $AVAYA_HOME/Support/Database

4. Execute the command below install the JDBC driver:

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.

5. Execute the command below to start the vpms service:

/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.

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:

cat /proc/sys/dev/cdrom/info

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

drive name:	sr0	hda
drive speed:	0	24
drive # of slots:	1	1
Can close tray:	1	1
...

3. In the output displayed, find the row for drive speed.
4. Within the row for drive speed, find the column that contains a non-zero value.

Note: In the example output shown above, the column you are looking for contains the value 24.

5. In the column you just found, go up one row to find the drive name.

Note: In the example output shown above, the drive name you are looking for is hda.

6. Execute the command below to display a list of device special files associated with your DVD devices:

ls -l /dev | grep cdrom

It will display a list similar to the following:

lrwxrwxrwx	1	sroot	root	4	Aug 31 08:11	cdrom -> scd0
lrwxrwxrwx	1	sroot	root	3	Aug 16 11:16	cdrom-hda -> hda
lrwxrwxrwx	1	sroot	root	4	Aug 31 08:11	cdrom-sr0 -> scd0

7. In the output displayed, find the line for the drive name that you found earlier.

Note: In the example output shown above, you are looking for the line that ends cdrom-hda -> hda.

8. In the line you just found, find the device special file name just to the left of the drive name.

Note: In this example the device special file name is cdrom-hda.

9. Open the file /etc/fstab in a text editor.
10. Find the line below:

/dev/cdrom   /mnt/cdrom   iso9660 noauto,owner,ro 0   2

11. Change /dev/cdrom to the path to of the device special file that you just found.

Note: In this example the corrected line reads as follows:

/dev/cdrom-hda   /mnt/cdrom   iso9660 noauto,owner,ro 0   2

12. Save and close the file.

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:

/sbin/service vpms stop

3. Execute the command below to copy a core services configuration file to the correct location:

cp -p /tmp/BootstrapDBResource.dat /opt/coreservices/scc/runtime/

4. Execute the command below to start the vpms service:

/sbin/service vpms start

Replacing a Primary EPM server

To replace a Primary EPM server you must perform several tasks that include: install Linux on the new server, install Experience Portal on the new server, and restore on the new server an Experience Portal backup taken from the old server. Below is an additional procedure that needs to be followed during this process. This procedure should be performed before you restore the Experience Portal backup on the new newer.

Important: This additional procedure is needed any time a database restore is performed after a fresh install of Experience 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 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:

cd $AVAYA_HOME/Support/VP-Tools

3. Execute the command below to retrieve the security certificate from the Primary EPM:

bash setup_vpms.php <PrimaryEPM>

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

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

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.

Scheduled Data Export Reports do not work

If you attempt to schedule a new Data Export Report, Experience Portal Manager displays a null pointer exception. Any existing scheduled Data Export Reports do not produce any output.

To resolve this issue, install hotfix wi01001648-EPM-6.0.1.0.0802.tar.gz on your Primary EPM server.

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="8009".
4. Change the value from 500 to 1000.
5. Save and close the file.
6. Execute the command below to restart the vpms service:

/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, 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 contained 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:

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 send make an outcall using SIP:

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:

ulimit -n 8192

5. Save and close the file.
6. Execute the command below to restart the tomcat service:

/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.

export JAVA_OPTS="-server -Xmx1024m -XX:MaxNewSize=30m -X:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:CMSInitiatingOccupancyFraction=60-XX:ThreadStackSize=512"

5. Save and close the file.
6. Execute the command below to restart the tomcat service:

/sbin/service tomcat restart

Avaya Aura® 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.

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 the procedure to install a security certificate is not in your Session Manager documentation, then please contact Avaya Support for help with installing the Experience Portal security certificate on Session Manager.

Avaya Aura® SIP Enablement Services (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.

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.

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:

• Use the Save button and view the file after it is downloaded to your local PC.

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:

• Change the name of the scheduled report on Experience Portal to not use multi-byte characters.

Or

• Upgrade the browser on the client PC to Internet Explorer 7.0 or later.

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.

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:

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.

3. Increase the timeout value XXXXXX on the line found above.
4. Find the line in the form of the following:

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.

5. Increase the timeout value XXXXXX on the line found above.
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 file %NSSSVRSDK%\config\NSSserver.cfg in a text editor.
2. Find the line in the form of the following:

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.

3. Increase the timeout value XXXXXX on the line found above.
4. Find the line in the form of the following:

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.

5. Increase the timeout value XXXXXX on the line found above.
6. Save and close the file.
7. 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.

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.

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

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.

6. Save and close the file.
7. Open the file $SWISRSDK/config/Baseline.xml in a text editor.
8. If using NRec 9.0.11 or 9.0.12:
1. Find the series of lines beginning with the following:

<param name="swisr_result_enable_speech_mode">

2. Change the series of lines to read as follows:

<param name="swisr_result_enable_speech_mode">

<value>1</value>

</param>

9. If using NRec 9.0.13 or later:
1. Find the series of lines beginning with the following:

<param name="swirec_result_enable_speech_mode">

2. Change the series of lines to read as follows:

<param name="swirec_result_enable_speech_mode">

<value>1</value>

</param>

10. Save and close the file.
11. 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.

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.

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

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.

6. Save and close the file.
7. Open the file %SWISRSDK%\config\Baseline.xml in a text editor.
8. If using NRec 9.0.11 or 9.0.12:
1. Find the series of lines beginning with the following:

<param name="swisr_result_enable_speech_mode">

2. Change the series of lines to read as follows:

<param name="swisr_result_enable_speech_mode">

<value>1</value>

</param>

9. If using NRec 9.0.13 or later:
1. Find the series of lines beginning with the following:

<param name="swirec_result_enable_speech_mode">

2. Change the series of lines to read as follows:

<param name="swirec_result_enable_speech_mode">

<value>1</value>

</param>

10. Save and close the file.
11. 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:

server.rsspeechsynth.languageid.zh VXIString Mandarin Chinese

server.rsspeechsynth.languageid.zh-CN VXIString Mandarin Chinese

server.rsspeechsynth.languageid.zh-guoyu VXIString Mandarin Chinese

3. Change the series of lines to read as follows:

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

4. Save and close the file.
5. 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:

[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"

3. Close the registry editor.
4. Open the file %NSSSVRSDK%\config\NSSserver.cfg in a text editor.
5. Find the series of lines below:

server.rsspeechsynth.languageid.zh VXIString Mandarin Chinese

server.rsspeechsynth.languageid.zh-CN VXIString Mandarin Chinese

server.rsspeechsynth.languageid.zh-guoyu VXIString Mandarin Chinese

6. Change the series of lines to read as follows:

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

7. Save and close the file.
8. Restart the Nuance server.

More Information

Online:

• http://www.avaya.com
• http://support.avaya.com