Preparing to migrate VoiceXML and Java applications

You should read this section only if you have existing VoiceXML or Java applications.

As was explained in Planning the migration of Java and VoiceXML applications, if you are already using any VoiceXML 2.0, you do not need to make any changes to them before they can be used with Blueworx Voice Response Version 6.1. Note that if you are still using VoiceXML 1.0 applications, these are not supported in Blueworx Voice Response Version 6.1.

However, to continue using the function in VoiceXML 1.0 applications, you can upgrade them to the VoiceXML 2.0 specification by using the migration tool that is provided in the WebSphere Voice Toolkit Version 6.0.1, which can be downloaded free from: 
http://www.ibm.com/software/pervasive/voice_toolkit
Some editing may be required and you will have to make a change to the AppName entry in the configuration file (see Blueworx Voice Response for AIX: Deploying and Managing VoiceXML and Java Applications for details).

Although Java applications that were developed using JavaBeans can still run, the programming tools used with this method are no longer supported, so you should develop any new Java applications using the Java API. If you are currently using the old Java and VoiceXML Environment (DTBE) that supported VoiceXML 1.0 applications, you must remove it before you can start the migration to Blueworx Voice Response Version 6.1. Before doing this, backup any voice segments and configuration files (.cff) that you use, and then restore them after migration. The actions are documented in the following instructions:

Backing-up VoiceXML and Java data
  1. Log on as dtuser. Type the following command and press Enter: 
    cd /var/dirTalk/DTBE/native/aix
  2. All users: to prevent the new default.sample.cff from being overwritten when you restore the old one, type the following command (substituting newname with a name of your choice) and press Enter: 
    cp default.sample.cff  newname.cff
  3. All users: to back up your .cff files, type the following command (substituting backupfile with a name of your choice) and press Enter: 
    ls *.cff | grep -v -F default.sample.cff | xargs tar -cvf  backupfile.tar
  4. Java users only: to add your voice segments to the backupfile.tar file, type the following command and press Enter: 
    find /usr/lpp/dirTalk/db/current_dir/voice/ext/%A | xargs tar -uvf backupfile .tar
  5. Move the following files to a safe place (for example, on another system, on a writable CD, or on tape):
    • The backupfile you just created.
    • If you are going to install a new version of AIX, your applications programs and application-related data.
Removing the previous Java and VoiceXML environment (DTBE)
  1. If Blueworx Voice Response is running, shut it down by entering: 
    wvrstop -c
  2. Log on as root if you are not logged on already.
  3. Type smitty remove and press Enter.
  4. In the Remove Installed Software panel:

    In the SOFTWARE name field, press F4, and from the list select all files that start with dirTalk.DTBE .

    In the REMOVE dependent software? field, select yes.

    Press Enter

  5. Exit from SMIT
Check level of Java prior to new installation
  1. Check that you have the correct version of Java installed by entering: 
     java -version

    If the data that is displayed includes the following (build pap3260sr7-20091215_02(SR7)), you have Java 6.0 SR7 installed. If you do not have this level, you must install it now. You can download it from http://www.ibm.com/developerworks/java/jdk/aix/service.html .

Next step:

Parent topic: Software installation