CyberTools® Browser Information

I. Minimum Browser Configurations
II. Starting the Application
III. Browser's Security Windows and Java™ Privileges
IV. Browser Connects to the Database Server
V. Proxy Servers
VI. Firewalls

I. Minimum Browser Configurations

Your browser and/or your organization cannot block pop-ups from *.cybertoolsforlibraries.com (or the name of your server delivering this software). If you do have a pop-up blocker, then put the appropriate names into its pop-up exception list.

Your browser must enable Java™ and JavaScript.

A. Microsoft Windows Users with Internet Explorer

It is important to have the most current version of Java™ for Microsoft's Internet Explorer. If you do not, then you will suffer from a variety of problems. Microsoft used to have easy access to its latest version of Java™, which they called the Microsoft Virtual Machine. On July 10, 2002, they removed this easy access and replaced it with the standard Windows Update (for more information, please see http://www.microsoft.com/java/ ). Therefore, you have a few choices:

1) CyberTools recommends using the Sun Java™ Plug-in version 1.4 (or better) for Microsoft Internet Explorer found at http://java.com/ . It replaces the Microsoft Virtual Machine.

2) Download the March 4, 2002 Microsoft Virtual Machine from the CyberTools ftp site. As Microsoft Visual J++ licensee and developer, "the license grants rights to redistribute the Microsoft VM in conjunction with and as part of your applications" (see http://www.microsoft.com/java/xp.htm ). Therefore, we have posted the Microsoft Virtual Machine on our ftp site plum.cybertools.biz. The login user name is anonymous and the password is your e-mail address. You'll need to change the directory to pub/tools (e.g., cd pub/tools) and get the binary file msjavx86.exe. Once this installation file is on your workstation, you need to find it with Windows Explorer and double click on it to run it. The file msjavx86.exe is the property and copyright of Microsoft Corporation. Neither Microsoft Corporation nor CyberTools Inc. warrant its installation or the use of the Microsoft Virtual Machine. CyberTools prefers that you use the Sun Java™ Plug-in.

3) Go to http://www.microsoft.com/ and perform a Windows Update. CyberTools does not recommend this method since you may receive more than you wanted.

B. Microsoft Windows Users with Netscape

For Netscape, you need to download the entire browser. Go to http://channels.netscape.com/ns/browsers/ and select the link to [Free Download].

Netscape 6 (or better) on MS Windows uses the Sun Java™, and it works well.

C. Apple Macintosh Users with Netscape

On the Apple Macintosh, Netscape 4.5 (through but excluding 6) uses it own Java™, but does NOT support the following:

Netscape 6 uses the Apple JVM, it will not support CyberTools' Java™ programs at all. On the Mac, Internet Explorer is setup to use the Apple JVM and IE works well on this platform.

D. Apple Macintosh Users with Internet Explorer

For this application, IE is more reliable than Netscape, particularly when IE is configured (using the preferences menu) to use the Apple JVM. OS 8 users will need to download the Apple JVM from Apple, whereas OS 9 systems should have the Apple JVM already installed. Download JVM from Apple Now.

II. Starting the Application

When you first start the applcation, you might see a web page with this content:

Making connection ...
This page might ask you to "Close Window?", meaning close this instance of the browser. Please select a push button that will close the original browser. By closing this window you will be able to work better: the software will start another instance of your browser, making the first instance unnecessary.

Java™ and Javascript must be enabled. Disable pop-up blockers for *.cybertoolsforlibraries.com (or for your own server that might deliver this software).

If this page does not start the application after a few minutes, then please see the CyberJ Browser Information page Starting the Application.

Testing java capabilities...

A. If you are asked to close the window, please do so.

B. If the above web page includes:

Java™ is not working with your browser.
Please see CyberJ Browser Information.
If you haven't installed Java™ yet, please see Minimum Browser Configurations found above. Otherwise, continue to the next step.

C. Your browser, or your organization, might block pop-ups.

If so, then put *.cybertoolsforlibraries.com (or the name of your server delivering this software) into the pop-up exception list.

D. Otherwise, if MS Windows and Sun's Java™, then Java™ didn't install correctly.

Please try the following:

1. Go to your [Start] button, and select Settings->Control Panel->Java™ Plug-In, and panel Browsers. If your browser isn't checked, please select it and then select [Apply]. Close all instances of your browser and test again.

2. See Sun's Enable Java™ software through your Web browser which tells you how to check if Java™ is installed properly.

3. Now go to Sun's Test your Java™ Virtual Machine. Was it successful?

III. Browser's Security Windows and Java™ Privileges

When the application starts, it actually creates a new, small instance of your browser that might look like this:

CyberJ in Small Browser

One of two security warnings (shown here) pops up. If you see the window on the left, then select "Always". If you see the window on the right, then select "Always trust content from CyberTools" and then select "Yes". You will never see this message again.

Sun Java Security Warning Microsoft Virtual Machine Warning

In order for the application to work well, please accept these requests from your browser, even though the browser might identify them as "high risk" or "low risk." You do NOT expose your computer to any danger by accepting these CyberTools requests from your browser.

If you do not grant privileges, then you will be:

IV. Browser Connects to the Database Server

Once you granted the browser privileges, the small browser should have an "Attached" message:
CyberJ attached

If you see this message, then congratulations! You have a direct connection from your browser to the database server. The subsequent application windows should be very fast. You should feel as though the server is next to your desk. If you don't have a direct connection, then the message will report "java.net ConnectException: Connection refused" and then report that it is making a tunnel connection:
CyberJ Tunnel

For many of our users, the tunnel connection is fast enough. Others may report that windows can take many seconds to appear. We can help you fix this. Tunneling is slow if your organization has an Internet bandwidth problem, or a slow firewall and/or a slow proxy server. CyberTools's servers are exceptionally fast, and our bandwidth is nearly always wide open. To fix this tunneling problem, your organization needs to allow a direct connection to CyberTools's servers. You do this by following the next two steps, Proxy Servers and Firewalls.

V. Proxy Servers

Proxy servers slow down CyberTools. If your organization is using a proxy server, then your browser needs to ignore the proxy server to achieve a direct connection to the database server. You can do this step yourself: you do not need your IT staff. For Internet Explorer, go to the menu bar and select Tools->Internet Options->Connections->LAN Settings. If "Use a proxy server" is selected, then select its [Advanced] push button, and add to the Exceptions the value "*.cybertoolsforlibraries.com" (or your server's name) without the quotes:

Then select the [OK] button on this window and all subsequent windows.

For Netscape, use the menu bar's Edit->Preferences->Advanced->Proxies and add to field "No Proxy for:" the value ".cybertoolsforlibraries.com" (or your server's name) without the quotes:

Then select the [OK] button on this window and all subsequent windows.

VI. Firewalls

If you are attempting to connect to CyberTools servers, your organization needs to allow a direct connection to CyberTools's servers *.cybertoolsforlibraries.com for port 20,004. The IP numbers are currently 66.205.80.66 through 70 with the mask of 255.255.255.248, i.e., the block 66.205.80.65/29. Please don't use the IP numbers since our IP numbers have historically changed every two years. Once your IT staff implements this "hole", then you will no longer tunnel, and the application will be very fast.

If you are connecting to your own server, your firewall needs to open ports 20,000 through 21,000 to the target server, unless your web master is running CyRouter. Check with your IT staff and/or support@cybertoolsforlibraries.com.

Copyright © CyberTools Inc. 2004, except for images of Microsoft's Internet Explorer and Netscape. CyberTools and CyberJ are registered trademarks of CyberTools, Inc. in the U.S. and other countries. Java is a registered trademark of Sun Microsystems in the U.S. and other countries.