IBM WebSphere Voice Toolkit
V6.0.1
Installation Readme

November 2005

(C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Note:
Before using this information and the product it supports, read the general information under Notices in this document.

IBM^(R) WebSphere^(R) Voice Toolkit is the new name of the previously released software entitled Voice Toolkit for WebSphere Studio. Also, for users familiar with Voice Toolkit for WebSphere Studio software and documentation, the term call flow is now referred to as communication flow.

Contents

This document contains the following topics about installing the IBM WebSphere Voice Toolkit.

• Introduction
• Hardware requirements
• Software requirements
• Installation
• Getting started
• Known installation problems
• Uninstallation
• Notices
• Trademarks

Introduction

This readme provides information on installing the IBM WebSphere Voice Toolkit, which includes the following features:

• An integrated development environment (IDE), a Communication Flow Builder editor, a VoiceXML editor, a CCXML editor, a Lexicon editor, and editors for creating grammars written in SRGS (XML or ABNF)
• VoiceXML 2.0 and VoiceXML 2.1 support
• Conversion tools for VoiceXML, audio, and grammar files.
• A pronunciation builder and an audio recorder
• Audio Prompt manager
• Voice Trace Analyzer for use with WebSphere Voice Server V5.1 log files.
• A speech recognition engine and data, Text-to-Speech (TTS) engines, grammar compiler, and other modules necessary for the desktop runtime (simulation and debug modes) environment.
• Plug-ins and tools for developing grammars and pronunciations for use with MRCP servers.

Getting help

Readme files are located in the <IBM_Rational_dir>\VoiceToolkit\Readme directory, where <IBM_Rational_dir> is the full path to the IBM Rational Software Development Platform. By default, this path is as follows: Program Files\IBM\Rational\Software Development Platform\6.0\VoiceToolkit\Readme

For additional information about the samples included with the toolkit, see the sample readme files that are located in each of the sample directories in <IBM_Rational_dir>\VoiceToolkit\Samples.

For information on using the WebSphere Voice Toolkit, refer to the online Help. To view Help after starting the IBM Rational Software Development Platform, click Help > Help Contents. When the Help window appears, select Developing Voice applications from the Contents pane.

Hardware requirements

• System suitable for running Microsoft(R) Windows(R) XP
• System suitable for running the Rational Software Development Platform [installed with Rational Application Developer (RAD), Rational Web Developer (RWD), or Rational Software Architect (RSA)]
• Minimum of an Intel(R) Pentium(R) III 880 MHz processor or equivalent (1.0 GHz recommended)
• 1GB RAM minimum
• A display adapter setting of at least 256 colors and 1024x768 resolution or higher
• Sound card and speakers for audio playback
• 800 MB minimum free disk space (in addition to the disk space requirement for RAD/RWD), plus additional space for the installation options selected by the user
• For installation, an additional 800 MB temporary space on the drive specified in your user TMP environment variable

Software requirements

• Microsoft Windows XP (Service Pack 1 or higher)
• Rational Application Developer (RAD), Version 6.0.1, Rational Web Developer (RWD), Version 6.0.1, or Rational Software Architect (RSA), Version 6.0.1

Notes:

• Install the Rational Software Development Platform (one of the three products listed above) as well as the optional feature WebSphere Application Server V5.1 under the installation component Install WebSphere Test Environment V5.x.


• The Rational Software Development Platform ships with the Rhino JavaScript Interpreter v1.5 release 2, however this toolkit package has been optimized to work with Rhino JavaScript Interpreter v1.5 release 3. It is recommended that this version, Rhino JavaScript Interpreter v1.5 release 3, be downloaded from http://www.mozilla.org/rhino/download.html using the download link rhino15R3.zip.
  Important:
  Do not install any other version than v1.5 release 3, as this will cause error conditions with this product.
  • To install the Rhino JavaScript Interpreter download the rhino15R3.zip, extract the file js.jar, and copy to the following directories:

    <IBM_Rational_dir>\eclipse\plugins\com.ibm.voicetools.es_6.0.1
    <IBM_Rational_dir>\runtimes\base_v51\InstalledApps\localhost\WVX5.1-localhost.ear

• For voice application developers planning to deploy their applications on non-Windows platforms, which support the VoiceXML 2.0 or VoiceXML 2.1 standards, use Windows as the development platform, and deploy the application to the server on whatever platform you choose.

Installation

This section contains the following topics:

• Prerequisites
• Installing the WebSphere Voice Toolkit
• Installing Local Server Environment
• Installing speech technologies

Prerequisites

• If you have any of the following products installed, you must remove these programs before installing this release:
  • IBM WebSphere Voice Toolkit
  • IBM Voice Toolkit for WebSphere Studio
  • WebSphere Voice Application Access Toolkit
  • IBM Multimodal Toolkit for WebSphere Studio
  • Any IBM product that has text-to-speech (TTS)
  • WebSphere Voice Server SDK or other previously-installed speech runtime engines
    Notes:
    • You must have the JRE 1.3.1 installed to uninstall this SDK.
    • After uninstalling the speech runtime engine, you might need to manually delete the speech root environment variables. To do so, follow these steps:

      1. Right-click the My Computer desktop icon and select Properties.
      2. On the System Properties dialog, click the Advanced tab, and then click the Environment Variables button.
      3. In the Environment Variables window, under System variables, scroll to find the SPCH_ROOT, SPCH_BIN, and IBMVS environment variables. Select these variables, and then click Delete.
      4. Click OK to close the dialog.
      5. For the changes to take effect, restart your system.

• To use the Communication Flow Builder tool, set your display setting to small fonts. To do so, click Start > Control Panel and then select Display. On the Display Properties dialog, select the Appearance tab, and select the smallest Font Size, Normal.
  

Installing the WebSphere Voice Toolkit

Follow the instructions in the installation wizard to install the toolkit.

Before you install:

• If your system is running low on resources, you might notice a delay between the progress indicator and the first installation panel.
  
• Errors that occur during the installation will be logged in the voicetools_log.txt file, located in the directory location identified by your TMP environment variable.
  
• Once the installation process has started, the cancel button might be unresponsive and require you to click the button several times before it reappears.
  
• When files are downloaded during installation, they unpack to the ~~VoiceTools~~/6.0.1 folder in the directory specified in your TMP variable. The files are required for the install process, and after installation they can be deleted if you do not plan to install again. If you might install again, you can add the executable (Voicetools_Setup.exe) to the directory with the files, and keep the files with the executable, or copy them to a CD. Then if you decide to install additional features or speech technologies at a later time, use the executable to automatically connect to the Internet download site to access the required files.

  Note:
  If you want to refresh your installation, you must remove the ~~VoiceTools~~ directory.

Installing Local Server Environment

The local server environment is used to provide simulation capability on your system. To install this option, select Custom setup type and select Local Server Environment.

Installing speech technology

Choose Custom setup type during installation and use the installation wizard to install the language (Speech Technology) that you will use with the local runtime environment.

---

Getting started

To launch the WebSphere Voice Toolkit, click the Start button, and point to All Programs and then IBM Rational. Next, click your base product, such as IBM Rational Application Developer > Rational Application Developer.

• If you cannot access the toolkit after installation, following these steps:
  1. Start your Rational Software Development Platform.
  2. Click Help > Software Updates > Manage Configuration. The Product Configuration window is displayed.
  3. Expand the first entry, which points to the eclipse directory. The list displays the toolkit features.
  4. Select VoiceXML Application Development feature 6.0.1 and from the Available Tasks list, select Enable.
  5. Select VoiceXML Application Simulation feature 6.0.1 and from the Available Tasks list, select Enable.
  6. Restart your Rational Software Development Platform.
  
  
• The projects and files that you create using the toolkit are saved in the workspace location that you select when you open the IBM Rational Software Development Platform. If you uninstall the toolkit, the workspace remains on your system so that the files are still available.
  
• When running the toolkit, there are temporary .ulw and .pkg files that are placed in the directory specified in your TMP variable. Sometimes these files are not removed automatically when you close the toolkit or if the toolkit unexpectedly closes. You will need to remove these files when uninstalling the toolkit or as needed.


• In addition to the toolkit help, this package includes certain related publications. To view or print these publications, you must use the Adobe Reader version 4.0.5 or later. For optimum viewing, use Adobe Reader version 7.0. To download Adobe Reader, go to the Adobe Web site at www.adobe.com. Click Get Adobe Reader, and follow the directions.

---

Known installation problems

This section covers known installation problems and limitations on Windows. Refer to the IBM WebSphere Voice Toolkit V6.0.1 Readme for information about problems and limitations that affect actual use of the product.

• You must uninstall any products that contain IBM TTS before installing the WebSphere Voice Toolkit. If you have uninstalled those IBM TTS products, but you are still seeing the error message "Found IBM TTS installed in different location" while installing the toolkit, you should follow these steps:

1. Run regedit.exe. To do so, click Start > Run.
2. Find the registry value for the key:
   

   HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ Windows\ CurrentVersion\ App Paths\ ibmtts50.dll\ Path

   Next, verify that the TTS engine has been uninstalled from the referenced path on your machine.
3. Delete the registry key:
   

   HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ Windows\ CurrentVersion\ App Paths\ ibmtts50.dll

4. Retry the installation of the WebSphere Voice Toolkit.

• During installation you might receive an Unhandled Exception error message stating Setup will now terminate. If you receive this message, click OK and uninstall this program. Close all applications running on your system and try installing this program again.
  
• To avoid issues related to a lengthy path, it is recommended that the Rational Software Development Platform product be installed to a directory such as C:/rad6 or similar.
  
• The TTS portion of the install might produce a "Catastrophic Failure" error message. Close all applications running on your system and try installing this program again.
  
• If you have Windows XP installed with Service Pack 1 and Windows XP Hotfix Q328310 applied, you might encounter an InstallShield Ikernel Application Error during installation. If this occurs while installing the toolkit, you can find the resolution for your problem at:

  http://support.installshield.com/kb/view.asp?articleid=q108020

---

Uninstallation

Uninstalling the WebSphere Voice Toolkit

• Make sure the Voice toolkit is not running by closing RAD, RWD or RSA before uninstalling the toolkit. To uninstall this product, click Start > Control Panel and then select Add or Remove Programs. Select the IBM WebSphere Voice Toolkit program. Click Remove and follow the uninstallation wizard instructions.
  
  
 

Uninstall Failure

If you attempt to uninstall the toolkit, in rare circumstances (such as uninstalling the IBM Rational Software Development Platform before uninstalling the toolkit) the uninstall might fail and you get an Uninstaller Error.


• You need to remove any remaining entries in the Windows Registry. To do this:
  1. Run the Registry Editor (REGEDIT.EXE or REGEDT32.EXE)
  2. Delete the following keys:

  HKEY_LOCAL_MACHINE\ SOFTWARE\ IBM\ IBM WebSphere Voice Toolkit

  HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ Windows\ CurrentVersion\ Uninstall\ f8ea7098568963e941a11a81e7d5a9d5

At this point, you can manually remove the remaining folders and files installed by the toolkit.

---

Notices

The following paragraph does not apply to the United Kingdom or any country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and\or changes in the product(s) and\or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

---

Trademarks

The following terms are trademarks or registered trademarks of the International Business Machines Corporation in the United States, other countries, or both:

IBM
Rational
WebSphere

Intel and Pentium are trademarks or registered trademarks of Intel Corporation in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product, and service names may be trademarks or service marks of others.