IBM Research
Tour Previous Tour Middle Tour Next


Quick Start

Installing WBI Java Development Kit 4.5


First, unzip the distribution, It will create its own root directory wbij45.

This operation creates several directories:

/wbij45/binoptional native code used by WBI
/wbij45/com/ibm/wbi/examplessource code and class files for example plugins
/wbij45/datafiles used by some example plugins
/wbij45/docHTML documentation
/wbij45/etcconfiguration files
/wbij45/libsupport classes (contained in JAR files)

Starting WBI

For Win95/98/NT systems, change to the WBI root directory and type the following command:
The distribution also contains a standard Unix shell script ( and an OS/2 batch file (Run.cmd).

Alternatively, change to the WBI root directory, set the CLASSPATH to include:

  • . {current directory}
  • lib/wbij45.jar
  • lib/ras.jar
  • lib/xerces.jar
and launch WBI using the following command:
To use the WBI Graphical User Interface (GUI), start it with
java -g
Note: The GUI requires Java Swing, which is part of Java 2 SDK, but must be installed separately for older versions of the Sun JDK. The GUI also requires that the Xerces XML Java Parser (lib/xerces.jar) is in your CLASSPATH.

Using the Demo Plugin

First, you must register the Demo Plugin either thrugh the command line interface of through WBI's GUI. If you are using the command line, type
register com/ibm/wbi/examples/demo/demo.reg
If you are using the GUI, select Plugins->Register and then select the same file (as above) in the file system.

Note: WBI can handle requests either as a web server or as an HTTP proxy (see also Proxies & Servers).

  1. Start your favorite web browser

  2. To access WBI as a server

  3. To use WBI as a proxy
    • Configure your browser to use an HTTP proxy at machine localhost (or on port 8088.
      • On Netscape Navigator 3, this setting is under Options | Network Preferences... | Proxies | Manual Proxy Configuration (View button)
      • On Netscape Navigator/Communicator 4, this setting is under Edit | Preferences... | Advanced | Proxies | Manual Proxy Configuration (View button)
      • On Internet Explorer 4, this setting is under View | Internet Options | Connection | Proxy Server (Advanced button)
      • On Internet Explorer 5, this setting is under Tools | Internet Options | Connections
    • If you are connected via a Local Area Network (LAN), the proxy settings are under Lan Settings. Check the Use Proxy Server check box, and set the HTTP proxy server under the Advanced button.
    • If you are connected via dialup, select the appropriate dialer from the list, and click on the Settings button. Check the Use Proxy Server check box, and set the HTTP proxy server under the Advanced button.
  4. Go to the URL: http://_demo. If this doesn't work, try reading the troubleshooting section below.
  5. Follow the links to see simple examples of WBI generators
  6. Notice that as you browse around the web, WBI now adds an extra annotation and link at the top of every page. This is a simple example of WBI's ability to transform a user's web experience.
  7. NOTE: You are now running your browser with WBI as its proxy. All of your web access through HTTP is being controlled by WBI. Your browser WILL NOT WORK if WBI is not running, unless you change its proxy settings back.


Operating WBI through a proxy server or socks server:
WBI's default setting assumes that your computer is connected directly to the internet. If this is not the case, you must change WBI's proxy/socks settings. These settings are stored in a configuration file. You can change the settings via the WBI setup page by going to (if WBI is running as a web server on port 8088) or http://_wbi/setup (if WBI is running as the browser's proxy). You can also edit the configuration file directly.