Installing the Phone.com Connector on Windows NT


This document provides information about installing the Phone.com Connector on Windows NT. For additional information, including known issues and platform support, see the Phone.com Connector Release Notes. This document includes:


1.0 Pre-Installation Checklist

The Phone.com Connector requires an operational BusinessWare server, the appropriate license from Vitria, and the Openwave UP.SDK, as discussed in this section.

1.1 BusinessWare Software

BusinessWare must be installed and running on the Windows NT server before you can install the Phone.com Connector. See the BusinessWare Installation Guide for NT for complete information about installing BusinessWare.

1.2 Connector License

The Phone.com Connector requires a license separate from the BusinessWare license; you can obtain the appropriate license from your Vitria Sales Representative.

1.3 Openwave UP.SDK

The Phone.com Connector requires libraries and other software components from the Openwave UP.SDK. For example, the notification events that the connector sends use data from the UP.SDK library, as does the UP.Simulator that enables you to test the transmission of notifications from BusinessWare without the use of an actual mobile phone or wireless device.

You can obtain the UP.SDK from the Openwave website. (Navigate to the Phone.com developer section). The Openwave UP.SDK must be installed before you can install the Phone.com Connector.

2.0 Installation

Installing the Phone.com Connector requires that you first install the Openwave UP.SDK, then install the Phone.com Connector, as discussed below.

2.1 Installing the Openwave UP.SDK

You can obtain the UP.SDK from Openwave's Phone.com software developer site. Registering at the site (at no cost) enables you to download and use the UP.SDK, and it also enables you to provision up to 5 subscriber accounts on the UP.Link gateway server—you can use these accounts to test the Phone.com connector in a basic connection model. Brief instructions for creating a subscriber account are below. More detailed instructions are available at Openwave's Phone.com web site.

  1. Register as a developer at Openwave's developer web site.
  2. Download and install the Openwave UP.SDK from the Openwave Phone.com developer web site. The installation process installs the software components in the directory you choose and adds a program group to the Windows NT Start menu. The UP.Simulator is a menu item under the UP.SDK program group.
  3. Activate your UP.Web account on Phone.com's UP.Link server by going to UP.Phone provisioning section of Phone.com's developer web site and follow the instructions to create a subscriber account. (When you register as a developer, Phone.com automatically creates a Subscription identity for you, but you may need to lookup this account and note the subscriber account name and other information.)
  4. Configure the UP.Simulator on your Windows NT machine, and test it by using the UP.SDK SendNtfn Tool. The SendNtfn tool is located in the UP.SDK program group on the Windows NT machine where you installed the UP.SDK.

    The entire process of registering at the web site and installing the UP.SDK takes less than 10 minutes. Later, when the Phone.com Connector is installed, you can configure and use the UP.Simulator to test the connector in the context of a BusinessWare connection model. Using the UP.Simulator enables you to test the connector without using an actual wireless phone to receive notifications.

2.2 Installing the Phone.com Connector

The installation program uses the Windows standard InstallShield program, which makes the appropriate changes to the Registry and places various .jar files that comprise the package into the appropriate directories. To install the Phone.com Connector:

  1. Log on to the Windows NT machine using the account name for the BusinessWare installation.
  2. Stop the BusinessWare server process by going to the Services control panel (from the Windows NT Start menu, select Settings > Control Panel > Services). Select the BusinessWare server from among those in the list and click the Stop button.
  3. Close the Services control panel and minimize the control panel.
  4. Navigate to the location of the PhoneDotCom_1.0_Setup.exe file, and then double-click on the file to launch the installation process. The Openwave Installation Verification box displays.
  5. The installer searches for the UP.SDK 4.1 installation, and then displays the Openwave Installation Verification dialog containing the path.
  6. Click Yes to accept the location of the UP.SDK library (UPNotify.dll). Alternatively, you can click No to open a Browse window and select another UP.SDK installation. Be sure to enter the full pathname to the \lib sub-directory of UP.SDK installation if you change it from the location found by the installer. Once you have selected an alternate sub-directory for your UP.SDK \lib installation, click Next to continue.
    The connector installation Welcome splashscreen displays.
  7. Click on the Next button to proceed. An Information box displays the message that Setup will search for the BusinessWare installation and install the necessary files. Once the installation program finds the BusinessWare installation, a subsequent Information box displays notifying you of the location of BusinessWare on your system.
  8. Click on the OK button to install the connector. The installation program installs the files for the connector.
  9. After the files are copied, click on the Finish button in the Setup Complete screen.
  10. When installation is complete, you are prompted to restart you computer. After restarting, the BusinessWare services will start.

You can now begin to use the Phone.com Connector. See the Phone.com Connector document for information about creating and using connection models that incorporate wireless notification functionality.


Copyright 1995-2001 Vitria Technology, Inc. All rights reserved.
Last updated: January 29, 2001