Cygwin Software Installation Instructions ----------------------------------------- Print this file and read it completely before starting download and installation. Use the printout as a checklist during installation. 1. Open "Windows Explorer" or "My Computer" 2. Create a folder called "C:\Cygwin" 3. Open a web browser and go to: http://www.mdl.nws.noaa.gov/pub/Cygwin 4. Save "setup.exe" to C:\Cygwin 5. Go to C:\Cygwin 6. Double click on setup.exe A popup with the title "Cygwin Setup" will appear. 7. Click "Next" You will be asked to choose a download source. 8. Click "Install from Internet" 9. Click "Next" You will be asked to select the Root Install directory and options. 10. Insure the the Root Directory is C:\Cygwin NOTE: Do not install as Windows Administrator. Install as a normal user. 11. Click "Just Me" for "Install For" 12. Click "Unix" for "Default Text File Type" 13. Click "Next" You will be asked to select a local package directory. 14. Insure that it is C:\Cygwin 15. Click "Next" You will be asked to select an internet connection. 16. Click "Direct Connection" 17. Click "Next" You will be asked to choose a download site. 18. Type: "http://www.mdl.nws.noaa.gov/pub/Cygwin" 19. Click "ADD" 20. Click "Next" You will be advised that download has begun. A few seconds will pass. You will be asked to select packages. The packages list popup may take a few minutes before it responds to direction. Test it's readiness by clicking on the plus (+) sign next to "All". When the popup is ready, this will toggle between an expanded list and a list containing only the "All" entry. Put the list in expanded mode and continue. 21. For the category "+All - Default", click on the word "Default" until it reads "Install" This will change the word "Default" to the word "Install" for all categories. 22. For +Admin - Install, leave as is. 23. For +Archive - Install, leave as is. 24. For +Base - Install, leave as is. 25. For +Database - Install, click on the word "Install" until it reads "Default" 26. For +Devel - Install, click on the word "Install" until it reads "Default" 27. For +Doc - Install, leave as is. 28. For +Editors - Install, leave as is. 29. For +Games - Install, click on the word "Install" until it reads "Default" 30. For +Graphics - Install, leave as is. 31. For +Interpreters - Install, leave as is. 32. For +Libs - Install, leave as is. 33. For +Mail - Install, click on the word "Install" until it reads "Default" 34. For +Math - Install, leave as is. 35. For +Net - Install, leave as is. 36. For +Publishing - Install, leave as is. 37. For +Shells - Install, leave as is. 38. For +System - Install, leave as is. 39. For +Text - Install, leave as is. 40. For +Utils - Install, leave as is. 41. For +Web - Install, click on the word "Install" until it reads "Default" 42. For +XFree86 - Install, leave as is. 43. For +_PostInstallLast - Install, leave as is. 44. Click "Next" The installation will begin. It may take as long as 30-40 minutes. After the packages have been installed, you will be asked if you want to create icons. 45. Click "Create icon on Desktop" 46. Click "Add icon to Start Menu" 47. Click "Finish" A series of MSDOS windows will appear for post installation scripts to run. These should finish in 5-10 minutes. When the post installation scripts are finished there will be a Window with the title "Cygwin" open on your desktop. You may close it if you wish. A popup with the title "Cywin Setup" and the message "Installation Complete" will appear. 48. Click "OK" The Cygwin software installation is finished at this point. Local Customization ------------------- 1. Double click the Cygwin icon on your desktop. An MSDOS window will appear. It will run a few scripts. This will take only a moment or so. When this is done, it will give you a bash shell prompt. When the scripts finish running check for your user name and home directory. PCUSERNAME should be the same as your user name on MS Windows. 2. In the MSDOS window type the following: cat /etc/passwd If there is a usename that matches your PC username, then go to Step 8. If there is no username in the password file which matches your PC username, you will need to create one. 3. To do this, log into the Unix host you use the most and type: ypcat passwd | grep -i YOURUNIXUSERNAME 4. If that doesn't return anything then type: grep -i YOURUNIXUSERNAME /etc/passwd Use this string to create an entry in the Cygwin password file. 5. To do this type in the MS DOS window: vi /etc/passwd Go to the bottom of the file. Insert the string you obtained from your Unix session. 6. Edit the string so that it looks something like this: PCUSERNAME::GID:UID::/home/PCUSERNAME:/bin/bash There are 7 fields separated by a colon(:). PCUSERNAME= your PC user name GID=the number in the 3rd field of the password entry you obtained from your Unix session. UID=the number in the 4th field. EXAMPLE: fsmith::555:777::/home/fsmith:/bin/bash NOTES: The second field should be empty when you are done. Your UNIX username and your PC username may not match. That's ok. 7. Save and exit. 8. After you insure there is an entry for you in the password file, then continue by typing: cd / ls -ald home 9. If there is no home directory then type: mkdir home 10. If there IS a directory called "home", then type: cd home ls -ald * 11. If there is no directory which name matches your PC Username, then type: mkdir PCUSERNAME 12. Use the browser to save homefiles.tar to: C:/Cygwin/home/PCUSERNAME 13. Then untar homefiles.tar. To do this type: cd $HOME tar xvf homefiles.tar 14. Exit from the MS DOS window. 15. Restart by clicking the Cygwin icon. 16. An MSDOS window will pop up. You may minimize this window if you wish. It will accept no command input. Next, a large window the size of your monitor screen will appear. Inside the window will be two xterms and a clock. Download, installation, and customization of Cygwin is complete at this point. Use "ssh -X USERNAME@HOSTNAME" or "rxt USERNAME@HOSTNAME" to login to any Unix host you need to work on. Read each of the "README" files now in your home directory at your convenience. They contain information which should help with the use of Cygwin, ssh, and X11.