Java(tm) Developers Kit

Version 1.0

Downloading Instructions, Microsoft Windows NT (Intel) and Windows 95

Java(tm) Developer's Kit (JDK) 1.0 Release

The Java(tm) Developers Kit (JDK) lets you write applets that conform to the new, frozen applet API for the Java Programming Language. There have been several changes since the Beta 2 release - these changes are described in Changes Since the Last Release.

The JDK comes with two documents. The COPYRIGHT file has copyright and license information about the JDK. The README file has information about the JDK, including:

why we made the JDK,
what packages comprise the final applet API, and
how to get in touch with us.

How to download the 1.0 release

The 1.0 Windows release supports only Microsoft Windows NT/Intel and Windows 95.

As a self-extracting archive file, the 1.0 release is just over 3.7 MB. Uncompressed and unpacked it will take up just over 5.6 MB. Documentation is not included in this archive file; it may be found under Java Developers Kit.

The downloading, installing, and configuring process can be broken down into the following steps:

Download the archive file
Remove Previous JDK
Unpack the archive file
Update environment variables

If you experience trouble along the way, check the Troubleshooting section at the end of this document or our general Java/HotJava FAQ.

Step 1: Download

The simplest way to download the release is to click on one of the following links. (Note: The java.sun.com server at Sun is frequently swamped with requests. Using a mirror site near you may be faster.)

ftp://ftp.javasoft.com/pub/JDK-1_0-win32-x86.exe (ftp.javasoft.com server at Sun)
ftp://sunsite.unc.edu/pub/languages/java/JDK-1_0-win32-x86.exe (Sunsite UNC)

This will automatically download a self extracting archive file to your machine which you can execute to unpack.

If you prefer, you can download the release via anonymous ftp from one of the following sites:

ftp.javasoft.com in pub/JDK-1_0-win32-x86.exe
sunsite.unc.edu in pub/languages/java/JDK-1_0-win32-x86.exe

Don't forget to put ftp in binary mode before downloading!

    $ ftp ftp.javasoft.com
    Name (ftp.javasoft.com): anonymous
    331 Guest login ok, send your complete e-mail address as password.
    Password: user@machine
	<< informational messages <<
    ftp> binary
    200 Type set to I.
    ftp> cd pub
	<< more informational messages <<
    250 CWD command successful.
    ftp> get JDK-1_0-win32-x86.exe
    200 PORT command successful.
    150 Opening BINARY mode data connection for JDK-1_0-win32-x86.exe (3720379 bytes).
    226 Transfer complete.
    local: JDK-1_0-win32-x86.exe remote: JDK-1_0-win32-x86.exe
    3720379 bytes received in 1.4e+02 seconds (30 Kbytes/s)
    ftp> quit

Before proceeding further, check that you have downloaded the full, un-corrupted file. As shown just above, the size of the file should be 3,720,379 bytes.

Step 2: Remove previous versions of JDK

There should not be any copies of previous versions of the Java Developers Kit on your computer.

If you have stored any additional Java source code files (files you have written or files you have received from someone else) in a directory under the main JDK Java directory, you should move those files to a new directory before deleting previous version of the JDK. You can delete the entire Java directory tree using the following command:

   deltree /Y C:\java

Step 3: Unpack

After removing the previous version of the JDK, execute the new self-extracting archive to unpack the JDK files. You should unpack the file in the root directory of C drive to create C:\java. If you want the JDK in some other directory, unpack the archive file in that directory. Unpacking the archive will create a java parent directory and all of the necessary sub-directories for this release.

Unpacking the archive will also create src.zip and lib/classes.zip. DO NOT UNZIP THE CLASSES.ZIP FILE. If you want to review the source for some of the JDK class libraries, you may unzip the src.zip file. However, you must use an unzip program that maintains long file names to unzip src.zip. One such unzip utility program is UnZip 5.12 which can be found at UUNet FTP Site. Look for the file unz512xN.exe or a later version.

Step 4: Update environment variables

After unpacking, you should add the java\bin directory onto the Path. The easiest way to accomplish this is to edit the AUTOEXEC.BAT file and make the change to the path statement there.

If you have set the CLASSPATH environment variable you may need to update it. You must replace CLASSPATH entries that pointed to the java\classes directory to point to java\lib\classes.zip. Again, the easiest way to accomplish this is to edit the AUTOEXEC.BAT file and make the change to the CLASSPATH environment variable there. See the Troubleshooting section below for more information.

After completing these changes to AUTOEXEC.BAT, save the file and reboot, so that the changes take effect.

Start Using the JDK

Your computer system should now be configured and ready to use the Java Development Kit.

You can start the Applet Viewer by doing the following:

1. cd to a directory containing an html file:

    cd java\demo\TicTacToe

2. Run the appletviewer on the html file:

    appletviewer example1.html

Please read the Known Bugs page for additional information.

Troubleshooting

If you see the following error message
```
   net.socketException: errno = 10047
```
OR
```
   Unsupported version of Windows Socket API
```
check which TCP/IP drivers you have installed. The Applet Viewer only supports the Microsoft TCP/IP drivers included with Windows 95. If you are using third-party drivers (e.g., Trumpet Winsock), you'll need to change over to the native Microsoft TCP/IP drivers if you want to load applets over the network.
If the Applet Viewer does not load applets then you might try the following:
1. set HOMEDRIVE=c:
  set HOMEPATH=\
  and restart the Applet Viewer (in the same DOS box)
2. set HOME=c:\
  and restart the Applet Viewer (in the same DOS box)
If none of these work, try:
```
    java -verbose sun.applet.AppletViewer
```
This lists the classes that are being loaded. From this output, you can determine which class the Applet Viewer is trying to load and where it's trying to load it from. Check to make sure that the class exists and is not corrupted in some way.
Error Message: Exception in thread NULL
If you are getting the fatal error message: Exception in thread NULL, when running java, javac, or appetviewer, you should check your CLASSPATH environment variable. It may list the the 'classes' directory from an older JDK release. You can either unset the CLASSPATH variable, or set it to include only the latest version of the JDK class library. For example:
```
	> set CLASSPATH=.;C:\java\lib\classes.zip
```
This will make sure that you are using the correct classes for the JDK 1.0 release.
Cannot close Applet Viewer copyright window (Windows 95 only)
In Microsoft Windows 95, the launch bar may partially cover the Applet Viewer copyright notice window Accept and Reject buttons. If this happens, you can move the Windows 95 launch bar to the side of the desktop to allow access to the copyright window Accept and Reject buttons.

Last Updated: 01/19/96

Java Developers Kit