Graphic by Keith Ohlfs

CS111, Wellesley College, Fall 1999

Software Installation
[CS111 Home Page] [Syllabus] [Lecture Notes] [Assignments] [Programs] [Documentation] [Software Installation] [FAQ] [CS Dept.] [CWIS]

This document explains how to install CS111-specific software onto Macintosh computers. (We do not officially support a Java development environment on PCs. However, we can point you to some information about Symantec Cafe for the PC if you're interested.) This document assumes that standard applications, such as Netscape, Fetch, and Telnet are already properly installed on your Macintosh. Make sure that you have versions of these packages that are at least as up-to-date as those used in lab. In particular, you should have Netscape version 3.0.2 or better and Fetch version 3.0.3.

The single course-specific software package is the Symantec Cafe 1.5 Integrated Development Environment (IDE) for Java. If the machine you are working on does not already have this software installed (here's how to check), then follow the instructions for installing Symantec Cafe 1.5. Additionally, there is a folder of various Fetch and Symantec Cafe patches that must be installed on a machine in order for it to behave like the machines in E101. See the instructions for installing CS111 patches.

Is Symantec Cafe 1.5 Already on my Machine?

Before attempting to install Symantec Cafe 1.5 on a Macintosh, you should check to make sure that it is not already there. There are two tests: first try the quick test, and if that fails try the thorough test:

Installing Symantec Cafe 1.5

If you need to install Symantec Cafe 1.5, you have a choice between installing Wellesley's key-servered version and an unkeyservered-version.

The following instructions assume that you are installing the key-servered version of Symantec Cafe 1.5 by downloading it from a Macintosh file server. You may be able to circumvent many of these step if you install the key-servered version of Symantec Cafe 1.5 from the Wellesley Macintosh CD; ask an ITS consultant for help in this regard.

To install a key-servered version of Symantec Cafe 1.5 from the AppleTalk network, follow these steps:

  1. Use the Chooser to connect as a guest to the Public folder on Flicka within the Science Center zone. Ask an ITS consultant or friend for help with this step if you need it.
  2. On the Public file server, find the KeyServered Software folder and open it.
  3. In your local hard disk, find the Key Servered Software folder. If one does not exist on your local machine, create one on your local hard disk.
  4. Copy the Symantec Cafe 1.5 folder from the KeyServered Software folder within the Public file server to the Key Servered Software folder on your local hard disk.
  5. Close the Public file server
  6. Open the local version of the Symantec Cafe 1.5 folder.
  7. Open the System Folder on the local hard drive.
  8. Select the Applet Viewer and Symantec Project Manager applications within the Symantec Cafe 1.5 folder. In the File pull-down menu of the Finder, select Make Alias. Drop the resulting alias icons into the Apple Menu Items subfolder of the System folder. You may wish to edit the names of the aliases to begin with a space character or an asterisk (*), so that they appear higher up in the apple menu.
  9. Find the folder labelled For Extensions within the Symantec Cafe 1.5 folder and open it. Move the contents of the For Extensions folder into the Extensions folder within the System Folder.
  10. Reboot the machine by selecting Restart from the Special pull-down menu.
  11. When the machine has rebooted, launch the Applet Viewer and Symantec Project Manager applications from the apple menu, and perform some simple testing of these application. If the applications do not work, contact an ITS consultant or a CS111 instructor or tutor.
  12. As the last step of the installation process, follow the instructions for installing the patch files in the next section.

Installing CS111 Patches

Even if Symantec Cafe 1.5 is properly installed on your machine, you still need to install the CS111 patch files in order to make Fetch and the Symantec Project Manager behave appropriately (like they do in the E101 laboratory). Follow these steps to install the CS111 patch files:

  1. Use Fetch to connect to cs111.wellesley.edu using your usual CS111 username and password.Within the Fetch window, navigate to /usr/users/cs111/download, and download the file CS111 Mac Files.sea.hqx to the desktop of your local machine. Upon dowloading, the file should be automatically converted to a file labelled CS111 Mac Files.sea (i.e., there should be no .hqx extension in the downloaded file). If this conversion is not performed, contact an ITS consultant for help.
  2. Double-click on the .sea file. You will be prompted to see if you want to continue with the unstuffing process; click Continue. You will be prompted for a location to write the unstuffed file; indicate that it should be left on the desktop. After these two dialogs, the file will be unstuffed, and a folder named CS111 Mac Files (no extensions) should appear on the desktop.
  3. The CS111 Mac Files folder contains four items. Ignore the Test folder. The three items should be installed in your local system as follows:
    • First, Quit out of Fetch and Quit out of Symantec Project Manager, if they are running on your machine. On your local hard drive, open the System Folder. Select and drag the Fetch Prefs and Symantec Project Manager Prefs from the CS111 Mac Files folder into the Preferences subfolder of the System Folder. You will be asked if it is OK to overwrite files. Indicate yes.
    • On your local hard drive, open the Key Servered Software folder. Select and drag the (Project Models) folder from the CS111 Mac Files folder into the Symantec Cafe 1.5 subfolder of the Key Servered Software folder. You will be asked if it is OK to overwrite files. Indicate yes.
  4. Congratulations! You have completed the installation of the CS111 patch files.