MINIPUP 2.02R README The whole idea here is to enable you to carry both your software and data. Most of your software will be on the CD and some software plus all your data will be on a USB drive. This CD should be able to boot your PC from CD or DVD drive. For more information, please visit www.ec-tech.org ----------------------------------------------------------- BOOTING: Press DEL at boot time to change the boot settings (check the boot screen for the proper key to press). Set CD/DVD as the first boot device, insert this CD and Save the changes. The PC will now boot from CD/DVD. Note: This step is done only once for your PC. FIRST BOOT - Choose US QWERTY keyboard if the keyboard choice dialog comes up. SET SCREEN: You will be asked for your screen setting. The quick choice is XVESA where you choose your screen resolution. Choose 800x600x16 or 1024x768x16. Note: This step is done only once for every save file. It will never be repeated if you are using a save file. See how to save a "save file" below. INSIDE MINIPUP: You will see a familiar desktop, but it uses single-click to open files - not a problem, really. Click on HOME to open your files directory. The top- level folders will show that this directory of yours is /root (root is the administrator's name in Linux). You can get to the top level by clicking on the up arrow (at the top left of the File Manager window). DECIDE WHERE TO SAVE FILES: Save your work and be mobile by using a USB drive. Any USB drive with 128 MB or more free space can be used for saving your work, with 202 MB free space as ideal. This would allow for: - 128 MB personal Save File named pup_save.3fs - 72 MB Open Office add-on named o115_202.sfs - 2 MB Lamp Server add-on named lamp_202.sfs Without OpenOffice, you will need only 130 MB free space. Mount that USB drive now and copy there lamp_202.sfs (you can add o115_202.sfs later if space allows). Notes: a. Mounting Drives - Click on the drives icon to open MUT (Media Utility Tool). You will see the drive icons and labels - USB drive will have the name sda1 or sdb1, hard disk drive will be named hda1, hda5, and so on. Click on "Mount" to mount your chosen drive. You should mount the CD-ROM and the USB drive now. When the folders have been opened, drag the lamp_202.sfs from the CD-ROM folder to the USB drive folder. To reopen the folders later, find "Rox" opposite the drive icon (in MUT) and click on it (Rox is the File Manager of Minipup). b. Saving to Hard Drive - You can use the hard disk for saving, but if it is NTFS-formatted (as in WindowsXP), you have to first resize it with Gparted and create a new Linux "ext2" partition for your data. Look for Gparted in Menu - Control Panel. Remember that your save file pup_save.3fs should be visible (after reboot) in the hard drive, and you should place the lamp_202.sfs in the same location, then reboot to be able to use your PC as server. c. Adding Partition - The usual benefit of partitioning is being able to add virtual memory (swap) to your limited RAM. You can add from 128 MB to 512 MB virtual RAM (swap) by resizing your existing partition and adding new ones. When you do this, do some arithmetic: Total MB to be freed = (Swap) + (ext2 file storage). If you have VFAT/FAT partition (Win95, Win98), you will need only Swap. If you have NTFS partition (WinXP), you will need at least 512 MB for your files. PARTITIONING WITH GPARTED WILL NOT HARM YOUR PC, BUT BACKUP YOUR DATA JUST IN CASE. ALSO, NEVER ALLOW ANY FREE SPACE BEFORE YOUR WINDOWS PARTITION - ALL FREE SPACE MUST BE AFTER IT. IF WIN-RESIZING FAILS, FIRST DEFRAG AND SCANDISK WINDOWS (AND RESTART AT LEAST 2X TO MAKE SURE THAT THAT THE PC IS SHUT DOWN NORMALLY). SHUTDOWN AND SAVE: Choosing Shutdown from the Menu will commence shutdown and creation of your personal save file. Choose the USB drive sda1 (or similar - it should have sd in the name instead of hd). Size of 64 MB is OK, but 128 MB is recommended. NEXT BOOT: Next time you boot the minipup CD, make sure that your USB drive is plugged in so your Save file will be used automatically. That save file is named pup_save.3fs. To use the LAMP server, you should have done the steps described above. (Same instruction for using Open Office.) PREPARE SERVER: This process will make your PC a true server: Open a console to set your IP number, like 192.168.0.100. Type this: ifconfig eth0 192.168.0.100 [then press ENTER]. That is eth and zero for your first (and only?) LAN card. While there could be another number assigned to you by a network administrator, it may be useful to use one number consistently. To verify that the number is entered correctly, type in console: ifconfig [then press ENTER]. Notes: (1) For a unique set of IP numbers in a big LAN, use the Setup - Ethernet/Network Wizard to enter eth0's static IP numbers. Get the numbers from your LAN administrator. (2) To isolate yourself in a network (as when a number of teachers are working in the same network at the same time, using a common IP number), disconnect the LAN cable from the PC - don't forget to plug it in again after shutdown! ACTIVATE THE SERVER: Open a console (terminal) window and type this: apachectl start [then press ENTER]. This will start your server. Open a browser and visit your IP address, like 192.168.0.100. From there, you can administer your virtual website. Make sure that you shutdown normally with your USB drive still in the PC to make sure that all changes to your virtual website are saved. Note: apachectl stop or apachectl restart are also valid console commands (self-explanatory). Pressing the UPARROW key will show you the previous commands, so no need to re- type previous commands. Note for unresponsive server scripts: Your server likes to run for user "nobody", but at times Puppy can change owner- ship of the server files at /root/www/htdocs to "root". So the solution is to give back ownership to "nobody" with the console command: chown -R nobody:nobody /root/www/htdocs [then press ENTER]. You can go back to this command in console anytime by pressing the UPARROW key. OPEN OFFICE: If you have copied o115_202.sfs to your USB drive and restarted the PC using the CD (while keeping your USB drive plugged in), Open Office should be ready. Click on HOME and find the OpenOffice folder. Drag and drop the Start icon to the desktop and start OpenOffice from there by clicking on any Open Office program icon. The Open Office version is 1.1.5. The 202 that you saw in its file name is a minipup file numbering code. KEEPING THE CD: With enough PC memory (256 MB is ideal), you should be able to eject the CD after starting the PC with it. Eject soon after starting if you are using another PC in another place (that is, using a PC that is not your own). MINI-CD: Minipup CD will fit a small mini-CD. DiskCopy it now. USING USB FLASH DRIVE: If you install minipup to the USB flash drive and your PC can boot from it (USB), then all you need is your USB flash drive to run your server. Use the Setup - Universal Installer to do the quick installation. Have fun with your minipup portable server and office suite!