Virtual OS/2 International Consumer Education
VOICE Home Page:
October 2001

[Newsletter Index]
[Previous Page] [Next Page]
[Feature Index]

File Sharing on the Gnutella Network using LimeWire: Installation.

By Timothy F. Sipples
IBM Corporation
© October 2001

Frank Berke's how-to article in the July, 2001 OS/2 VOICE newsletter describes LimeWire, a Java-based client for the Gnutella network. Frank does an excellent job describing this useful client and the genesis of the Gnutella network, essentially a successor to the Napster phenomenon for peer-to-peer file sharing.

There are some minor complexities running LimeWire on OS/2 Warp and eComStation systems, and this Part 2 article explains the details. These techniques may also give you a better understanding of the Java environment on these platforms and how to get other "100% pure" Java applications up-and-running on your PC.

NOTE: Please respect the copyrights of authors, artists, and their publishers. Use the Gnutella network only for legitimate file sharing.

Downloading the Software

LimeWire is compatible with both the free IBM-supplied Java 1.1.8 runtime as well as the subscription-only Java 2 (Version 1.3) runtime. You can get the Java 2 runtime as part of eComStation, the OS/2 Warp Convenience Pak, or with an IBM Software Choice subscription.

Assuming you'd like to run LimeWire with Java 1.1.8, you should download the following software packages:

  1. IBM's Java 1.1.8 Runtime with Unicode (or the full Developer's Kit)
  2. IBM's Java 1.1.8 Fix Package (specifically the RUNTIME.EXE file)
  3. Sun's Swing 1.1.1 Runtime (specifically the swingall.jar file)
  4. LimeWire (Zip version "for Other Operating Systems")
  5. Info-Zip's UnZip for OS/2 (if needed)

The IBM Java 1.1.8 Runtime with Unicode can be obtained from the IBM Software Choice web site. IBM's Java Development Centre in Hursley has a download site for RUNTIME.EXE, the latest fix package for the Java 1.1.8 runtime.

Although IBM supplies an optional Java Foundation Classes (JFC)/Swing runtime for OS/2 Warp JDK 1.1.8, LimeWire seems to run much better with the slightly more up-to-date Swing implementation from Sun. Obtain Sun's swingall.jar file from the JFC/Swing 1.1.1 Zip package.

Installation of the Java Environment

Install the Java 1.1.8 Runtime with Unicode per IBM's instructions. (Note that you'll need the IBM Feature Installer and Netscape browser to complete the installation.) Reboot after installation. Without starting Netscape, or any other application which uses Java, unzip the RUNTIME.EXE file to the drive where you installed Java. Allow RUNTIME.EXE to overwrite the old files.

To verify that the Java 1.1.8 runtime is installed and updated correctly, open an OS/2 Window and type the following at the command line:

java -fullversion

You should see something on your screen that looks like this line:

JAVA.EXE full version "JDK 1.1.8 IBM build o118-20010830 (JIT enabled: javax V3.5-IBMJDK1.1-20010830)"

Make sure the date code (20010830, or August 30, 2001) is the same or newer. Otherwise you may not have installed the Java fix correctly.

LimeWire Installation

Create a directory for LimeWire (such as C:\Apps\LimeWire), and unzip the file into this directory. Also, unzip the swingall.jar file to the same directory.

To start LimeWire from a desktop program object, drag a Program template from the Templates folder to your desktop. A tabbed notebook should pop up, with the Program tab selected. Fill in the following values:
Path and file name
 -classpath .;LimeWire.jar;collections.jar;swingall.jar;C:\Java11\Lib\ com.limegroup.gnutella.gui.Main 
Working directory

If you did not install Java 1.1.8 and/or LimeWire to Drive C, change the drive letters above as needed.

Click on the Icon tab, then fill in the name you'd like to assign to the program object (such as LimeWire). Finally, close the notebook to save these settings. Double click on this new program object to start LimeWire. (See Part 1 for information on how to use LimeWire.)


  1. These instructions work with LimeWire Version 1.1.6d, the latest non-beta version available at the time this newsletter went to press. Consult any README file provided with LimeWire for information on any changes to the startup and/or installation procedure.

  2. The icon file (LimeWire.ico) supplied with LimeWire is in Windows format and must be converted if you wish to use it with the LimeWire program object you create. I used PMView for OS/2 Warp to convert the icon file to OS/2 format.

    LimeWire icon

  3. While these instructions place Sun's Swing library in the same directory as LimeWire, you may choose to place it elsewhere (and even add it to the system CLASSPATH in CONFIG.SYS). Although Sun's implementation yields better results with LimeWire, that may not necessarily be the case in every instance, so I've chosen to add Sun's Swing only to LimeWire's CLASSPATH.

  4. LimeWire appears to work very well behind a firewall if OS/2 Warp's SOCKS support is enabled in the TCP/IP stack, for those firewalls that support SOCKS. File transfers with users also behind firewalls will fail, but LimeWire helpfully notes such IP addresses in red.

  5. The Help menu options in LimeWire don't seem to work, probably because they attempt to start up a web browser. You can still start your web browser manually and visit Limewire's web site for the online manual.

Developer: LimeWire -
Price: Free

Other links referenced:
  File Sharing on the Gnutella Network using LimeWire -
  IBM Software Choice, Subscription/Freeware -
  IBMJava 1.1.8 Update, Freeware -
  Sun's JFC/Swing 1.1.1, Freeware -

[Feature Index]
[Previous Page] [Newsletter Index] [Next Page]
VOICE Home Page: