Java and Eclipse: Download/Installation Instructions


You may want to print these instructions before proceeding. You should read each step completely before performing the action it describes. Because these products may change slightly each semester, I would appreciate it if you would let me know if you find any discrepancies between these instructions and what actually happens when you try to follow them.

IMPORTANT: Install Java first, BEFORE you install Eclipse.


Java

The following instructions were composed for installing Sun Java 1.5.0_08 (aka JDK 5.0 update 8). This may not be the latest version, but it is the one that we are using this semester. Note: Java is already installed as part of Mac OS X, so no further installation is necessary for these machines. Ensure, though, that you have the right version by typing java -version to the unix command prompt; the response should be something like java version "1.5.0_08"

A typical Java installation takes about 400 megabytes of disk space. The installation process reports the exact size.

Downloading

  1. Click Java SE Downloads
    A page, with this label in orange, will be displayed in your browser.

  2. Find the section labeled JDK 5.0 Update 8 and click its Download button (the fourth one from the top). Click Yes to the Security Window pop-up, if it appears. A page, with the label Download in orange, will be displayed in your browser.

  3. Click the Accept button, which appears under Required in red (it is in a small font: look for it carefully).
    Again, click Yes to the Security Window pop-up, if it appears. This page will re-display itself, with this information absent.

  4. Find the black bar labeled Windows Platform - J2SE(TM) Development Kit 5.0 Update 8

  5. Click the link labeled Windows Online Installation (typical download size is ~33.7MB), Multi-language

  6. Save the file it is about to download somewhere on your disk drive. The file will be named jdk-1_5_0_08-windows-i586-p-iftw.exe. The exact form of this interaction will depend on the version of your operating system (on mine clicked Save to the File Download - Security Warning pop-up; then I specified the location for the file; and then I clicked Close to the Download complete pop-up). Store this exe file somewhere permanent on your disk drive, so that you can reexecute it (reinstall Java) later, if necessary. This file is only about 250KB (1/4 MB).

  7. Terminate (X) any windows remaining from this process (e.g., the Download window).

Installing

  1. Double-click the file that you just downloaded, to run it.
    Click Run to the Open File - Security Warning pop-up. You will see a Windows Installer window temporarily then a Preparing to Install window temporarily. You will then see a License Agreement window.

  2. Click the "I accept the terms..." button.

  3. Click the Next> button.
    You will see a Custom Setup window, for J2SE Development Kit 5.0 Update 8. The default is to get a full installation (~264Mb), which is what you want.

  4. Click the Next> button.

  5. You will see an Installing window (for J2SE Development Kit 5.0 Update 8), whose progress is shown by progress bars (on various panes). Be patient: many megabytes of information is being downloaded and then used to perform the actual installation; sometimes the progress bars lool like they are making no progress.

  6. Eventually, you will see another Custom Setup window, for J2SE Runtime Environment 5.0 Update 8. The default is to get a full installation (~131Mb), which is what you want.

  7. Click the Next> button.

  8. You will see a Browser Registration window. Select whatever browsers you want to register for,

  9. Click the Next> button.

  10. You will see another Installing window (for J2SE Runtime Environment 5.0 Update 8), whose progress is shown by progress bars (on various panes). This installation will take less time than one for the Development Kit.

  11. Click the Finish button on the Installation Completed pop-up window.


Eclipse

The following instructions were composed for installing Eclipse 3.2 on Windows. The process for Mac/Linux should be similar. If later versions of Eclipse come out before I update these instructions, you might have to go through a slightly different process (please contact me if you do).

A typical installation takes about 134 Mb of disk space (plus the 120 Mb download, which you should keep on your machine, in case you need to reinstall it).

Downloading

  1. Click Eclipse 3.2
    A page, with the label eclipse downloads, will be displayed in your browser.

  2. In the first section, find the text Download Now: Eclipse SDK 3.2, Windows (120 MB)

  3. Click the icon to the left of this text, or the part of the text labeled Eclipse SDK 3.2
    If you are using a Mac, it should sense it and display Mac instead of Windows. If you are not using the operating system it recognizes, click the link labeled Other downloads for 3.2 instead.

  4. Click the icon to the left of the text Download from: for using the default mirror site (or click a site from the list displayed in the box).

  5. Click the Save button to download, somewhere on your disk, the file named eclipse-SDK-3.2-win32.zip (for PCs). The exact form of this interaction will depend on the version of your operating system. Store this zip file somewhere permanent on your disk drive, so that you can unzip it (recreate Eclipse) later, if necessary

  6. Terminate (X) any windows remaining from this process.

Installing

  1. Unzip this file that you just downloaded.
    On most Windows machines, you can It creates a folder named eclipse. You can leave this folder here or move it elsewhere on your disk drive.

  2. Create a shortcut on your desktop to the eclipse.exe file.
    On most Windows machines, you can Now you are ready to perform a one-time only setup of Eclipse.

  3. Double-click the shortcut to Eclipse that you just created. In the Workspace Launcher window, in the box following Workspace:, should appear something like C:\Documents and Settings\username\workspace (where username is your login on the machine). If you want, you can type in (or browse) another location for the workspace file to be created, but I advise accepting the default.

  4. Check the box labeled Use this as the default and do not ask again.
    Aside: you will be using one workspace during the semester, checking projects in and out of this workspace. If you ever want to re-enable the display of this window, once Eclipse starts, you can

  5. Click OK

  6. If you want easy access to the workspace, create a shortcut to it (see the instructions above), putting the shortcut on your desktop.

  7. Download (right-click and Save As) Course Library Jar into the same folder that you are using as your workspace (or move this file in the workspace fodler after downloading it elsewhere).

  8. In Eclipse, select Windows | Preferences

  9. Click the + in front of Java or double-click Java (after the +)

  10. Click Installed JREs

  11. Under the Name column, double-click jre1.5.0_08.

  12. Click the Add External Jars... button.

  13. In the Jar Selection window, navigate to your workspace folder, and double-click the file cs15-1xx.library.

  14. In the Edit JRE window, click OK

  15. In the Installed JREs window, click OK

  16. Terminate (X) the Welcome window
    You can always get it back by selecting Help | Welcome

  17. Terminate (X) the Eclipse window.