Installation guide

The following must be installed on your system:

• Optional : HP OCMP VoiceXML SDK version 2.4C2. For supporting documentation, see the Telecom infrastructure documents. If you do not install the HP OCMP VoiceXML SDK and its required components on your system, you cannot launch the SDK from the toolkit.
• Java Developer's Kit version 1.4.2 (version 1.5 is not supported)
• Eclipse platform, version 3.1.x available in a .zip format
• Eclipse FTP and WebDAV 3.1.x support plug-in; installation instructions are included in this section
• Tomcat web server, version 5 or above

This document assumes you are already familiar with:

• CCXML
• VoiceXML
• HP OCMP and OCMP VoiceXML SDKs

You may need to enable an HTTP proxy connection in Eclipse to avoid issues with firewalls when attempting to use Eclipse Update Manager.

To enable an HTTP proxy connection:

1. Select Window > Preferences from the Eclipse menu bar.
2. In the left pane, select Install/Update.
3. In the Proxy settings group, check Enable HTTP proxy connection and fill in your HTTP proxy host address and port.
4. Click Apply and OK.

This section describes how to manually install the required FTP and Webdav plug-in for Eclipse 3.1.x.

Important: Do not use the update manager to install the FTP and Webdav plugin. It proposes only the version 3.0 of this plugin and the version 3.1.x is required to run the HP OpenCall Voice Application Developer Toolkit.

Please proceed as described below to manually install the plug-in:

1. Download FTP and Webdav plugin 3.1.x. It is located on the same page as the Eclipse SDK 3.1.x.
2. Stop Eclipse if it is running.
3. Unzipped the plug-in in the directory that contains your Eclipse directory. For instance if you unzipped Eclipse in C:\myDev\, also unzip the FTP and Webdav plugin in C:\myDev\.
4. Start Eclipse and check that the FTP and Webdav plug-in is installed by clicking on Help > About Eclipse. Click on Feature details. The FTP and Webdav plug-in should be listed. Check that the version is 3.1 or greater.

This section describes how to manually install the HP OpenCall Voice Application Developer Toolkit plug-in.

Important: The FTP and Webdav plug-in must be installed before continuing. See Installing the FTP and Webdav plugin.

The HP OpenCall Voice Application Developer Toolkit package contains two individual plug-ins. Both plug-ins must be unzipped in the <eclipse home>/plugins directory for complete functionality:

• HP OpenCall Voice Application Developer Toolkit plug-in (com.hp.ocmp.vxml.cde.vxmlbinplugin_<version>)
• HP OpenCall Voice Application Developer Toolkit User Guide plug-in (com.hp.ocmp.vxml.cde.doc.user_<version>)

Note: You must restart Eclipse after you install new plug-ins for your changes to take effect.

This section describes how to use the Eclipse Update Manager to install the HP OpenCall Voice Application Developer Toolkit. Update Manager is the preferred method for installing plug-ins.

Important: The FTP and Webdav plug-in must be installed before continuing. See Installing the FTP and Webdav plugin.

For information about using Eclipse Update Manager, please refer to Installing new features with the update manager in the Eclipse on-line help (Help > Help Contents, Workbench User Guide > Tasks > Updating features with the update manager > Installing new features with the update manager).

If you choose not to use Eclipse Update Manager to install the plug-in, you can manually install these plug-ins by unzipping the appropriate files into <eclipse home>/plugins directory. This is described in Installing the HP OpenCall Voice Application Developer Toolkit manually.

To use Update Manager to install the HP OpenCall Voice Application Developer Toolkit:

1. Once you have obtained the .zip for use with Eclipse Update Manager, unzip it in a local folder.
2. In the Eclipse menu bar, select Help > Software Updates > Find and Install.
3. Select Search for new features to install and click Next.
4. Click New Local Site.
5. Browse to the local folder where you unzipped the HP OpenCall Voice Application Developer Toolkit and click OK.
6. Select <local folder>\HP_VXML_DE_<version> and click Next.
7. Select the HP OpenCall Voice Application Developer Toolkit from the list of features to install and continue following the onscreen instructions until the HP OpenCall Voice Application Developer Toolkit is installed successfully.

Note: You must restart Eclipse after you install new plug-ins for your changes to take effect.

This section contains instructions to upgrade existing workspace in a new version of Eclipse. They have been extracted from the release notes of Eclipse SDK. For more information on compatibility between Eclipse version, please consult the Eclipse release notes.

Users who don't use "-data"

If you weren't previously using "-data" to specify your workspace, follow these steps to upgrade:

1. Find the workspace directory used by your old version of Eclipse. Typically this is located inside the directory in which Eclipse was installed in a subdirectory called "workspace". If you are using a shortcut or script to launch Eclipse, then it will be under the current working directory of that shortcut or script in a subdirectory called "workspace". For Windows users, this is specified by the "Start in:" argument in your shortcut properties.
2. Copy this workspace directory to a new, empty location outside of any Eclipse install directory.
3. Install the new version of Eclipse in a new location, separate from any old version of Eclipse.
4. If you had installed additional features and plug-ins into your old Eclipse, you should re-install them in the new Eclipse.
5. Start this new version of Eclipse and select this location using the workspace chooser dialog at startup (or use "-data" command line argument to pre-select the workspace location).

Users who do use "-data"

If you were previously using the "-data" argument to start Eclipse, your upgrade path is much easier:

1. Optionally copy your workspace directory to a new, empty location outside of any Eclipse install directory as a backup.
2. Install the new version of Eclipse in a new location, separate from any old versions of Eclipse.
3. If you had installed additional features and plug-ins into your old Eclipse, you should re-install them in the new Eclipse.
4. Start this new version of Eclipse and select this location using the workspace chooser dialog at startup (or use "-data" command line argument to pre-select the workspace location).

Note: Copying your workspace is recommended because, after you've upgraded your workspace, you won't be able to use it again with an older version of Eclipse. If you ever want to go "back in time" to an earlier release, you will need that backup.

There is no specific instruction to upgrade a Voice Application project from a previous version to a new version. Just follow the upgrade instructions of Eclipse workspace.

You are now ready to create CCXML and VoiceXML projects using the HP OpenCall Voice Application Developer Toolkit in Eclipse. For more information on creating, building, deploying, and testing your CCXML/VoiceXML project, go to the HP OpenCall Voice Application Developer Toolkit User Guide in Eclipse by selecting Help > Help Contents from the Eclipse menu bar and choosing the HP OCMP Voice Application Developer Toolkit User Guide. Expand the Getting Started section and read the Getting Started topic.