Quick Start

Installing WBI Java Development Kit 4.5

Unzipping

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

This operation creates several directories:

Directory	Contents
`/wbij45/bin`	optional native code used by WBI
`/wbij45/com/ibm/wbi/examples`	source code and class files for example plugins
`/wbij45/data`	files used by some example plugins
`/wbij45/doc`	HTML documentation
`/wbij45/etc`	configuration files
`/wbij45/lib`	support classes (contained in JAR files)

Starting WBI

For Win95/98/NT systems, change to the WBI root directory and type the following command:

Run

The distribution also contains a standard Unix shell script (Run.sh) 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:

java com.ibm.wbi.Run

To use the WBI Graphical User Interface (GUI), start it with

java com.ibm.wbi.Run -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).

Start your favorite web browser
To access WBI as a server
- Go to http://localhost:8088/ or http://127.0.0.1:8088/
- Follow the links to see simple examples of WBI generators
To use WBI as a proxy
- Configure your browser to use an HTTP proxy at machine localhost (or 127.0.0.1) 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.
Go to the URL: http://_demo. If this doesn't work, try reading the troubleshooting section below.
Follow the links to see simple examples of WBI generators
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.
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.

Troubleshooting

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 http://127.0.0.1:8088/_wbi/setup (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.