*** CACMAC.README *** Ê This document contains basic information to help you get started with CACMAC. It explains what CACMAC is, how to get it and install it, and what to do next. Please note that CACMAC is only for Penn State faculty, staff, and students. Other individuals should get these programs through their normal distribution channels. *** Warning *** Before installing the CACMAC software, it is a good idea to backup your hard disk. Since CACMAC has the ability to over-write files on your Mac, you should backup anything important before beginning the installation. *** What is CACMAC? *** CACMAC is a collection of programs and files you need in order to access the Internet from a Macintosh at Penn State. This collection is for both Macs on the backbone and those that will connect via modem and phone line. *** How can I get CACMAC? *** CACMAC is available free of charge by bringing at least five high density diskettes to the CAC Helpdesk at 12 Willard Building. If you prefer, you can send the disks via campus mail, but be sure to include a note specifying that you want CACMAC. Alternatively, if you have access to a machine that has Fetch or another anonymous FTP client, you can use that to get CACMAC. Connect to ftp.cac.psu.edu, then copy all of the files in the /pub/access/mac directory that begin "cacmac." Note that it takes quite a long time to download the files, especially if you're connecting via modem. For a 28.8 connection, the download takes about an hour; on a 14.4 modem it should take about twice that long. *** You may need to get TCP too *** You may need to get a TCP driver separately from getting CACMAC. TCP is the software that lets your Mac communicate on the Internet. You need TCP whether you are on the backbone or connecting via modem. TCP drivers are included with system 7.5, so if you have 7.5 or later, you already have TCP. In many Penn State departments, the network administrator installs and configures TCP, so if your administrator has indicated that your machine is "on the backbone," then you can assume that TCP is already installed. If your system is older than 7.5 then you will need to get the MacTCP driver. MacTCP is available free of charge from the CAC Helpdesk. Or if you know how to use Fetch or another FTP client, you can connect to access.psu.edu and look for mactcp.bin in the /pub directory. Note that anonymous FTP is not permitted; you must give your access ID and password to connect. The reason that MacTCP is not simply included in the CACMAC package (which would certainly make things simpler) is that the CAC's agreement with Apple (who wrote MacTCP) is that we keep track of who's been given a copy of MacTCP. So although MacTCP is free, it's necessary to go through a separate procedure to get it. *** What else do I need? *** If you'll be connecting with a modem or if you want to use email or news programs, you need to get an Access Account. This is a userid and password that enable you to connect to Penn State's "access server". To apply for an Access Account, stop by the CAC Helpdesk at 12 Willard Building or 215 Computer Building or call the CAC's Accounts Office at 814-865-4772 to have an application mailed to you. All Penn State faculty, staff, and students are entitled to an Access Account free of charge. *** System 7.1 is required *** Your Mac needs to be running system 7.1 or later in order to use the CACMAC clients. If you're running system 6 and you have at least 4 megs of RAM, we recommend you upgrade to system 7. With system 6, some parts of CACMAC can run. If you're running system 7.0, there is a free upgrade you can use. Contact the CAC Helpdesk for information. *** Components of CACMAC *** The current version of CACMAC is 2.2.1 and is comprised of the following: TCP Ñ Not the proprietary part, just documentation and the preferences file FreePPP 1.0.5 Ñ required for dial-in connection Eudora 1.5.4 Ñ send and receive email Fetch 3.0.1 Ñ FTP client for copying files from other computers Internews 1.1 Ñ read and post network news Netscape 3.0 Ñ provides access to the World Wide Web (WWW) OASIS 1.4 Ñ allows students to access transcript information Ph 1.2 Ñ look up phone book info Telnet 2.6 Ñ change password and connect to other computers Tn3270 2.4a7 Ñ logon to PSUVM or OAS Ê *** Installing CACMAC *** 1. When you get CACMAC, it will be on several disks, each with one file, except for the first disk which also contains cacmac.readme, the file you're currently reading. If you get CACMAC via FTP, you'll have all of these files on your hard disk. There's no need to copy them to floppy. Double click the cacmac icon which is on the first disk. 2. Click Continue on the first screen. The second screen gives information about CACMAC. Be sure to scroll down to read it all. You can choose to print this information or to save it to a file. When you're ready to proceed, click Continue. 3. On the next screen, you're asked to choose whether you want to install all of the components of CACMAC (if so, click Install) or whether you want a "custom" installation (click Custom) where you can choose which components are installed. 4. If you choose Custom, the next screen invites you to select the programs you want to install by clicking them. To select several programs, hold down the command key (that's the one with an apple on it) while clicking. Click the scroll bar to see more programs. Refer to the information in this document for help deciding which programs to get. When you've finished selecting the components you want, click Install. 5. You're now asked to choose a folder where the software will be installed. A dialog box suggests the folder Internet Access Clients. Unless you have good reason to choose another name, we advise you to click Install now. If you use the name that's being suggested (rather than typing in another name) it will make updates to the software easier later. 6. While the software is being installed, a display box shows the progress, and you're asked to insert the other floppies. Depending on how much of the package you're installing and the speed of your machine, this step can take a while. You'll be notified when the installation is complete. 7. Once all of the software is installed, it's a good idea to rebuild your desktop. Restart the Mac while holding down the option key and the command key (that's the one with the apple on it). It's okay to skip this step, but if you see some odd problems in which applications can't be found when you try to launch them, rebuilding the desktop will usually solve the problem. *** What to do next *** Once you've installed CACMAC, please refer to the following documents which are included in the CACMAC distribution. ¥ CACMAC Guide - information for users of the CACMAC package ¥ PSU "program-name" info - Documentation included with each of the programs installed gives more detailed information on how to configure and use the specific program. You must customize Eudora, PPP, and TCP before using them. You may also want to customize some of the other packages. *** Getting Help *** If you have problems with any of the components of CACMAC, contact the CAC Helpdesk by stopping by 12 Willard Building, by phone at (814) 863-1035 or by sending email to helpdesk@psu.edu. There are various know problems that occasionally occur, so please refer to the Troubleshooting section for additional help. *** Troubleshooting *** ---> Machine crashes If your Mac crashes while installing CACMAC, it is likely that the CACMAC program needs more memory. Insert the first floppy and single click cacmac to select it. If you're installing CACMAC directly from your hard disk, just single click cacmac. Then select Get Info under the File menu. Press the tab key until the value beside Minimum Size is selected and increase this value. Do the same for Preferred Size. Then try the installation procedure again. ---> The disk "Untitled" is requested If during the installation procedure you're asked to insert the disk "Untitled," it is because whoever made the disks for you neglected to put an internal label on each of the disks. Try giving it the first disk, then try each of the others to see if you can figure out which disk it needs. If you can't solve it, then abort the procedure and put a label on each disk. To label a disk, insert it, single click with the end of the arrow pointing to the wording (not to the icon), wait a second or two, and then type a label name. Label the disks cacmac.1, cacmac.2, etc. Then start the installation procedure again. ---> Some icons seem to be missing Once CACMAC is installed, it's often the case that the icons do not all appear in the Internet Access Launchers folder. This is due to a bug in the package we used to create CACMAC. Select Clean Up Window under the Special menu. If you still don't see everything, try moving icons around. Often one icon gets placed on top of another, totally obscuring the icon under it. ---> Programs won't launch If you double-click an item in the Internet Access Launchers folder but the application isn't properly launched (you might get an error message saying the application can't be found or you might get another error message), in most cases rebuilding the desktop will solve the problem. Hold down the option key and the command key (that's the one with an apple on it) while restarting the Mac. *** Revision History *** Version 2.2.1 - 12/3/96 ¥ Fix problem with SoundApp helper (part of Netscape) Version 2.2 - 11/5/96 ¥ Upgrade Netscape to 3.0 Version 2.1 - 9/5/96 ¥ Upgrade Oasis to 1.4 Version 2.0.1 ¥ Add ObjectSupportLib extension (used by Eudora) Version 2.0 ¥ Upgrade Eudora to 1.5.4, Fetch to 3.0.1, Netscape to 2.0.2, Oasis to 1.3 ¥ Upgrade PPP to FreePPP 1.0.5 ¥ Drop Turbogopher from package Version 1.0.4 ¥ Set up Internews for separate "Private Newsgroups" category; upgrade to Internews 1.1 ¥ Minor changes to documentation Version 1.0.3 ¥ Upgrade OASIS to version 1.2 Version 1.0.2 ¥ Updated Access Guide Version 1.0.1 ¥ Added Troubleshooting chapter in Cacmac Guide ¥ Clarified Early Users chapter in PSU Eudora info ¥ Fixed buttons in PSU Netscape info