home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 35 Internet
/
35-Internet.zip
/
wbi11os2.zip
/
readme.txt
< prev
next >
Wrap
Text File
|
1996-08-15
|
28KB
|
654 lines
Web Browser Intelligence Agent Information
==============================================================================
IBM Intelligent Agent development and IBM Research is proud to introduce a
personal web browsing agent. The IBM Web Browser Intelligence (WBI) agent
will enhance your ability to use the World Wide Web. The WBI agent
will be your personal assistant when using the WWW. Your WBI agent will:
- Remember everywhere you have been
- Allow you to search through the information you have seen
- Notice patterns in your web browsing and suggest shortcuts
- Watch your favorite web pages for changes
- Test the speed of links from pages to let you know if they are fast or slow
- Provide you with both Proxy and Socks connectivity independent of your
browser
- Make you "browser independent" so you can switch browsers and not lose
information
- Let you look back in "web time" to see how you have visited pages in the
past
- Improve your productivity in using the WWW
==============================================================================
System Requirements
Operating Systems: IBM OS/2 or Microsoft Windows 95
Disk Space: Requires 5 megabytes to install the WBI agent. Once running, your
agent will require space to store information about your
travels on the web. It is recommended that you allocate at least
10 megabytes of disk space for both the agent and its data.
Connectivity: Requires a direct TCP/IP connection via TCP/IP, PPP, or SLIP.
Your machine must be able to directly access the internet (or
intranet). Many on-line services cannot be used by your WBI
agent, as they do not provide your machine with a direct
internet connection. Some services, such as Advantis, provide
direct connections. Special configuration instructions are
included below in case your machine's internet address is not
the same every time you connect.
The WBI agent can be configured to use an HTTP Proxy, Socks
connection, or local direct connection to the internet.
Browser: Your WBI agent "speaks" to your browser using the standard HTML 2.0
language. For best performance, your browser should support tables.
WBI has been tested with OS/2 WebExplorer, NetScape
Navigator 2.0, and MicroSoft Internet Explorer.
==============================================================================
Installing Your WBI Agent
Before you continue with the installation, please read these
instructions in their entirety. You will need about 5 megabytes
of free space to install WBI.
There are minor differences in the installation procedure
between OS/2 and Windows 95.
OS/2 Instructions
-----------------
A self-extracting file, WBI11OS2.EXE, is provided. Execute
this program from an OS/2 command line in a temporary
directory. Then type "install".
The installation will lead you through a series of questions
as it attempts to configure WBI on your machine. In
particular, it will configure WBI using settings from a
previous installation of WBI, or by extracting the necessary
information from Web Explorer (if it exists). In addition,
it will attempt to configure Web Explorer to use WBI by
default. If WBI does not configure itself or the browser
correctly, refer to the instructions for manual configuration
provided below.
The installation will copy files to the proper directories
and create a WBI folder on your desktop.
After installation is complete, you can erase the WBI11OS2.EXE
file -- if you want to save about 5 megabytes of disk space.
If installation was successful, you will now be able to
start WBI by double clicking on the "Web Browser
Intelligence" icon in the "WBI" folder on the desktop. Once
WBI is running, start up Web Explorer as you normally do.
If configuration was successful, WBI's annotations will be
apparent on the first web page you visit. There will be a
toolbar at the top of the page, and "web traffic lights"
highlights links on the page as well. To modify WBI's
configuration, go to the setup screen by clicking on "Setup" in
WBI's toolbar.
If WBI does not work right out of the box, consult the
instructions below for manually configuring WBI.
Windows 95 Instructions
-----------------------
A self-extracting file, WBI11W95.EXE, is provided. Execute
this file from an MS-DOS command line, or via RUN from the
Start menu.
The installation will lead you through a series of questions
as it attempts to configure WBI on your machine. In
particular, it will configure WBI using settings from a
previous installation of WBI, or by extracting the necessary
information from Netscape or Internet Explorer (if these
exist). In addition, it will attempt to configure these
browsers to use WBI by default. If you use a different
browser, or if WBI does not configure itself or the browser
correctly, refer to the instructions for manual configuration
provided below.
The installation will copy files to the correct directories
and create a WBI icon on the Start menu under "Programs".
After instalation is complete you can erase the WBI11W95.EXE --
if you want to save about 5 megabytes of disk space.
If installation was successful, you should now be able to
start WBI using the "Web Browser Intelligence" item under the
"Programs" folder of the "Start" menu. Once WBI is running,
start up your browser (Netscape or Internet Explorer) as you
normally do.
If configuration was successful, WBI's annotations will be
apparent on the first web page you visit. There will be a
toolbar at the top of the page, and "web traffic lights"
highlights links on the page as well. To modify WBI's
configuration, go to the setup screen by clicking on "Setup" in
WBI's toolbar.
If WBI does not work right out of the box, consult the
instructions in the next section for manually configuring WBI.
==============================================================================
Manually Configuring WBI
If the WBI installation does not configure itself and/or your
browser correctly, then you can try to configure these manually.
You must configure WBI to work with both your browser and the
Web. Follow these steps.
1. Establish how your browser communicates with WBI.
The WBI agent sits between your browser and the Web. You must
configure your browser to talk to WBI and you must configure
WBI to talk to the Web.
Your browser talks to WBI the same way your browser talks to
a HTTP Proxy server on the Web.
Before you can tell your broswer about WBI you must first
find the internet address (or IP number) your agent can use.
There are two ways to communicate with WBI:
a. Using localhost.
If you are using Windows 95, you can use the special
hostname "localhost" to communicate with WBI. Proceed
to step 2 below.
If you are using OS/2, you might also be
able to use the special hostname "localhost" to
communicate with WBI. To determine whether you are
already configured to use localhost under OS/2, issue
the command
netstat -a
in a command window. There should be 1 or more response
lines. If one of the lines shows the following:
addr 127.0.0.1 interface 0 mask ff000000 boradcast
then you are configured to use localhost (the 127.0.0.1 is
the important thing here. If this line is not present
you can configure TCP/IP to enable localhost. To do this,
- Double-click on the TCP/IP icon on the OS/2 desktop
or in the OS/2 System folder.
- Double-click on the TCP/IP Configuration icon.
- If the notebook page that appears is titled
"Configure Network Interface Parameters", then
- Select "loopback interface" under
"Interface to Configure"
- Check the "Enable Interface" checkbox
- Verify that the "IP Address" is 127.0.0.1
- Exit TCP/IP Configuration and TCP/IP, and
restart TCP/IP using the "tcpstart" command in OS/2
If you do not have a TCP/IP Configuration icon, your
version of OS/2 might not have this function. To try to
enable the localhost interface, issue the command
ifconfig lo 127.0.0.1
in an OS/2 command window. Be advised that this is not
remembered by OS/2 when you reboot, so you will need to
issue this command each time your machine is
booted.
Alternatively, you can specify "localhost" using
the special IP address 127.0.0.1 -- that is,
whenever the directions below ask for a
hostname, use the number 127.0.0.1 instead.
Otherwise, you probably have an older version of TCP/IP
for OS/2. Refer to your documentation for enabling the
loopback interface.
b. Using your machine's hostname.
If you cannot (or do not want to) use localhost, you can
use the hostname of your machine instead.
For OS/2, issue the
HOSTNAME
command in a a command window. This will tell you the
name of your machine.
For Windows 95, the hostname can be found through the
Network Control Panel icon. From the Start menu, select
Settings, then Control Panel, then double click on the
Network icon. Under the Configuration tab, double click
on TCP/IP. Select the DNS Configuraton tab. Your
hostname is listed in the Host field.
Now you have what you need to tell your browser how to talk to your
WBI agent.
2. Configure your browser to talk to WBI.
Your browser can talk to an HTTP Proxy server. You must change
your browser configuration so that the browser talks directly to
WBI rather than to the Web.
NetScape Navigator 2.0 instructions:
a. "Options" from the toolbar
b. "Network Preferences"
c. "Proxies" tab
d. "Manual Proxy Configuration" and "View"
e. Check to see if there is information already filled into the
HTTP Proxy and SOCKS Host areas. If so, record this information!
You will need this to configure WBI in Step 4.
f. Under HTTP, enter either:
localhost or
hostname where hostname was determined
in Step 1 above
g. Enter 8088 as the Port number next to HTTP Proxy. This is the
port your agent will be "listening" on.
h. Click ok to return to the Proxies screen and ok again to return
to the main screen
Turn off browser caching in Netscape Navigator. WBI needs to see
all your Web activityb to best determine usage patterns. If the
browser caches web pages, the WBI agent will not see everything you do.
WBI will do caching itself so you will see little difference in performance.
To turn off caching,
i. "Options" from the toolbar
j. "Network Preferences"
k. "Caching" tab
l. Set both Memory Size and Disk Size to zero
m. Click on ok to return to the main screen
-----------------------------------------------------------------------
Microsoft Internet Explorer
a. Get to the "Internet Properties" screen by either:
- Right clicking on Internet Explorer icon and select "Properties"
or
- Double clicking on "My Computer", Select "Control Panel", Select
"Internet"
b. "Connection" tab
c. Check "Connect to the Internet through a proxy server"
d. "Change Proxy settings..."
e. Check and see if there is information already filled into the
HTTP Proxy and SOCKS Host areas. If so, record this information!
You will need this to tell your agent how to talk to the
internet in Step 4.
f. Enter under HTTP either:
localhost or
hostname where hostname was determined
from Step 1 above
g. Enter 8088 as the Port number next to HTTP Proxy. This is the
port your agent will be "listening" on.
h. "OK"
Turn off browser caching. As of this writing there is no way to
disable all browser caching in Microsoft Internet Explorer.
Because of this, there will be times when the information
returned from the WBI agent will seem out of date. In these cases
you will need to click on "Refresh" on the menubar to see the latest
information from the agent. We recommend that you reduce the amount
of browser caching to 1%, the lowest setting possible.
h. "Advanced" tab
i. Move slider arrow until 1% appears
j. "Empty Folder..."
k. "OK"
----------------------------------------------------------------------
IBM OS/2 WebExplorer:
a. "Configure" from main screen
b. "Servers..."
c. Check "Enable Proxy?"
d. Make sure "Enable Socks Server?" is unchecked. You will fill
in a SOCKS server name (if needed) later when configuring your
WBI agent.
e. Check and see if there is information already filled into the
HTTP Proxy and SOCKS Server areas. If so, record this
information! You will need this to tell your agent how to talk
to the internet in Step 4.
Enter either
http://localhost:8088/ or
http://hostname:8088/ where hostname was determined
from Step 1 above in HTTP Proxy
f. "OK"
NOTE: It is important to make sure that the Proxy name ends with a
slash "/". Failure to do this will result in WBI
returning an error (invalid protocol) when you try to
use it from Web Explorer.
Older versions of WebExplorer (before version 1.1)
require you to quit and then restart WebExplorer
for configuration changes to take effect.
Turn off browser caching. The WBI agent needs to see all of your
Web activity to best determine usage patterns. If the browser caches
web pages, WBI will not see everything you do. WBI will do caching
itself so you will see little difference in performance.
g. "Configure" from main screen
h. "Caching..."
i. Check "Disable all caching"
j. "OK"
----------------------------------------------------------------------
3. Start the WBI agent.
In OS/2, double click on the "WBI" program icon on the
desktop.
In Windows 95, select "Web Browser Intelligence" in the Start
menu's "Programs" folder.
Once the agent is running, start your browser as usual.
- If your browser automatically loads a web page, then wait a moment
otherwise
- Select a web page
4. Configure WBI.
If WBI has not been configured, WBI will display a
configuration screen the first time your browser tries
to get to a web page. You must fill in some information
so that your agent can to talk to the Web on behalf of
your browser.
The configuration (or Setup) screen contains following settings:
a. Socks Server: is the name of a Socks server if one is available.
Fill in the name of the socks server and the port if necessary.
Typically socks servers use port 1080. If you were previously
using a socks server, this information was available in the
"configure" or "connections" section of your browser settings.
If your current browser does not support a socks server but
your network does, you can use your WBI agent to connect you
to a socks server!
This field can be left blank if no Socks server is being used.
b. Proxy Server: is the name of your HTTP proxy server.
Fill in the name of the proxy server and the port if necessary.
Typically proxy servers use port 80. If you were previously using
a proxy server, this information was available in the "configure"
or "connections" section of your browser.
This field can be left blank if no Proxy server is being used.
When specifying a proxy for WBI, use ONLY the server name.
For example,
good: myproxy.server.company.com
bad: http://myproxy.server.company.com/
Note: If you are behind a firewall and you want to access pages
outside of your local site, then you will need to fill in
one of SOCKS or PROXY.
c. No Proxy field allows you to specify domains that should be treated
as local if you are behind a firewall, that is, domains that do not
require going through SOCKS or PROXY servers.
No Proxy entries are of the form 'domain:port', and domains can be
specified using '*' as a wildcard. For instance, to say that
access to machines in the domain 'almaden.ibm.com' should not go
through a proxy or socks server, you would list '*.almaden.ibm.com:80'
in the NO PROXY field. List as many NO PROXY entries as you like
separated by spaces.
This field can be left blank.
d. Cache Size: The number of pages that your agent will remember
in your machine. This is used to keep you from going
out to the web every time you want to visit a web
page that you have already seen.
e. Index Size: The amount of disk space (in megabytes) that will be
set aside by your agent to remember information
about web pages. It is very important to set this
value correctly now. It CANNOT be changed in
the future. The larger the number, the more your
agent will be able to remember. A recommended
value is 10MB but the size should be determined
by your available disk space.
f. Web Traffic Lights: This function will place a green, yellow or
red light next to the links on each web page
to indicate the speed of the link.
This can be turned on or off from this page.
g. Short Cuts: This function allows your agent to look for
patterns in your web browsing and put links on web
page that it has determined is a shortcut.
This function can be turned on or off from this page.
h. Graphical WBI Toolbar: When checked will provide a graphical
toolbar at the top of each web page. This allows the
user to "talk" to the agent. When this is unchecked,
a row of words are provided rather than an image. This
should be done for browsers that handle text only.
i. Show WBI Background Image: When checked, WBI generated screens
will have it's own background. When unchecked the
default browser background is used.
When you have entered all the information, use the "Yes" button to
send the data to your agent. From here, your agent will now
take you to the page you originally asked for at the beginning of
Step 4.
NOTE: There are 4 ways to get to the WBI Setup page:
- On your first connect to the agent from the browser
(if you used manual configuration)
- Following links from the "Help" button on the WBI Toolbar
- Clicking on "SETUP" on the WBI Toolbar
- Using the url http://_wbi/setup
==============================================================================
Using your WBI Agent
You can now use your WBI agent to assist you in browsing the
web. When you visit a web page, your agent will add information
to that page. A WBI agent "toolbar" is added to the top of each
page. From here you can select one of several agent functions.
You can:
- Use "History" to search for information you have previously seen
- Use "Watch" to find out when specific web pages change
- Use "Look Here" (if available) to see which pages have changed
- Use "Path" to show trails you have previously followed from a
specific page
If you have turned on the "Web Traffic Lights" function, green, yellow or
red bars will be placed next to the links on each page.
If you have turned on the "ShortCuts" function, your agent will
tell you about web pages that you have OFTEN visited shortly
after visiting the page you are currently on. WBI adds shortcut
links in the upper left hand corner of the page, to the left of
the toolbar.
WBI has three command line arguments that can be used at start
up: -? lists the options, -m starts the program minimized (i.e.,
without the graphical interface), and -v pops up a window that
shows verbose details of all sorts of WBI activity. You can
both start it minimized and verbose, but the options must be
listed separately (as in "wbi -m -v").
For more information, use the online help provided under the "Help"
button on the WBI toolbar.
For information on some "undocumented" features and settings,
see the file "UnDoc.txt".
==============================================================================
Feedback to IBM
The Web Browser Intelligence agent is currently a technology
demonstration of an intelligent agent. If you have problems,
comments, or suggestions for improvements please send e-mail to
wbiagent@vnet.ibm.com.
==============================================================================
Changes & Fixes from Alpha 1.0 to 1.1
-------------------------------------
Several cases of index corruption have been eliminated.
Corrupted index does not grow infinitely, but is automatically erased and
re-created.
WBI error pages explain the cause of the error in much greater detail and also
have a link to the WBI setup page.
The DOS window (under Win95) that comes up and says "File not found" has been
removed.
MANY small access violation fixes (generally more stable code).
After a fresh install, if the first page you request ends in .html, .gif, or
.jpg then you didn't go to the setup page but instead received an error
screen.
WBIBG doesn't die right away when CTRL-C is hit, but allows a little time for
cleanup. A time out was also added to avoid waiting forever in case a rogue
thread refuses to finish. This fix also makes normal shutdown of WBI or by
the WBI 'Quit' button more graceful.
Setup screen has instructions and slightly modified layout.
Watch function only reports a page has changed if the server responds 200
Document OK, thus if the server is down it won't tell you that the page has
changed.
On the setup screen, the second time you hit submit the index size was changed
to 2MB. Now it stays at the originally selected value.
"No proxy" support. The setup has a field for bypass proxy on. The format of
this field is "dotted.host.address:port host:port ...".
Note that the host can begin or end with an '*' as a wildcard and the :port is
optional. Also, the list is seperated by spaces. All of the following are
valid:
w3.almaden.ibm.com
w3.* *.almaden.*
*.ibm.com:8080
The priority of servers is changed. Now, if both proxy and socks are set
then the proxy server is reached through the socks machine.
"Traffic Lights" now does head requests instead of pings. Thus it also works
with proxies, where before if you had a proxy set testlink would automatically
turn off.
Timeouts were added to the link checker, so that if a document is not
received in ten minutes then the request is aborted.
The watch list now has a "Mark all as read" button (Check latest build for
actual text). This button has the effect of going and looking at all the
changed documents. Thus you won't be renotified until the document changes
again.
The bug of getting old files from the cache after hitting the "Reload" button
(i.e. you look at a page, go away, come back, know it is out of date, hit
reload, see the new page, go away, come back and get the old page) has been
fixed.
The Win95 installation automatically configures itself when either Netscape
Navigator or Microsoft Internet Explorer are installed.
The OS/2 installation automatically configures itself when Web Explorer is
installed.
Added a "Setup" button to the WBI toolbar.
Default index size changed from 10 MB to 5 MB.
Moved the Win95 WBI executable to the root of the Start Menu.
Shortcuts were not appearing when histories got long.
Shortcuts were being turned on automatically after being turned off
manually.
WBI now prevents multiple copies of itself from being run simultaneously.
Added the '-m' option to WBI to automatically minimize its window.
Added the '-v' option to WBI to display verbose output on what it is doing.
Added 'text only' and 'no background image' switches for low-performance
browsers. (See the undoc.txt file for how to turn them on through the
WBI.INI file.)