Split Point Lighthouse, Aireys Inlet, Victoria, Australia  Home
About
  Gallery   Tips 
Download Release Notes

Hints and Tips for Lighthouse Pup

System Requirements  Installation  Troubleshooting  Uninstallation/Upgrade

SFS Add-ons  Automount  Desktop  Command Line

Compiz-Fusion 
Release notes  Flash Version

If you
already have PuppyLinux please reboot in LiveCD or 'clean boot' from the Puppy CD-Rom by typing at the boot menu 'puppy pfix=ram' and make a back-up copy of your pupsave file before booting LighthousePup.

Acronyms

lhp or LHP = Lighthouse Pup
Linux   IceWM = Ice Window Manager     LXDE = Lightweight X11 Desktop Environment

JWM = Joe's Window Manager    KDE = 'K' Desktop Environment    SFS = Squash File System

System Requirements

The primary requirement is a machine set up in the BIOS to boot from the CD-ROM drive before other drives. (Floppy, then CD is OK if no floppy is inserted.) Other requirements differ by Window Manager (WM). The Lighthouse Base CD has JWM, IceWM, LXDE and Openbox. All should work with older hardware, though JWM is slightly faster than the others.

The Mariner ISO also makes KDE 3.5.10 and KDE4 Window Managers available after saving your session and rebooting, though you don't have to use them. Lighthouse Base and Mariner should boot and run all WM's except KDE with 256-512M RAM. For KDE3 I recommend at least 512M and KDE4 may need 768M+ with fairly recent hardware for best performance. A newer ATI or nVidia based graphics adapter is recommended for 3D apps and HD video. I wouldn't be surprised if Lighthouse Pup runs on a machine with less than 256M but I imagine it would be slow going at best.

I also recommend a Linux Swap partition, at least the size of the installed RAM. GParted in the System menu can be used, however on a Windows® box, note that GParted will pop up a message with tips on resizing an NTFS partition in Windows before creating the Linux Swap with GParted. Please read these tips as resizing a Vista/Win7 partition with GParted is not recommended. When saving your session onto a Windows partition it is wise to defragment the drive in Windows first (Start | Programs | Accessories | System Tools | Defragment.)

As Lighthouse Pup 4.43 is based on PuppyLinux 4.3.1 it's a good idea to have a standard Puppy 4.3.1 CD available for comparison and if something hardware-related doesn't work, you'll have a wider base of users to get help from.
Back to top

Installation
Download the ISO and burn to a CD / DVD. Start here if you're unfamiliar with ISOs and MD5s: Burning an ISO - Authoring/Burning Software - Using MD5 Checksums

No installation is required for the Base ISO, just enable booting from CD-Rom in your BIOS/setup menu. Reboot with the Lighthouse CD-Rom disc in your drive, at the boot menu type 'ram' or 'lhp pfix=ram' or 'puppy pfix=ram'. This is the Live-CD or 'clean boot' mode. The Mariner ISO is also a Live-CD but it includes SFS add-ons that need a Frugal Install as described below.

At reboot/shutdown you'll be prompted to save your personal files and settings in a pupsave file (Option 1). If you choose to let Lighthouse save your files and settings, the boot (startup) time can be reduced. No need to save to a partition (Option 2) as the pupsave file can be resized larger as desired. The only exception would be on a FAT32 partition where the maximum file size is just under 4GB.

After rebooting into your newly saved Lighthouse environment, click on the Pmount Drives icon on the desktop or KDE Quicklauncher, and the 'Mount' button for your CD/DVD drive. A window should open showing the files below. Then click on the File System icon on the desktop, click on 'mnt' and 'home'. Drag and drop the following files from the Lighthouse CD-Rom to this /mnt/home folder (where the spupsave.2fs file is located.) When prompted to copy or move the files, select copy. This is the recommended Frugal Install:
Note 1: A traditional full hard disk install is usually not necessary. It can make backups, upgrades, troubleshooting and customizing more difficult.
Note 2: All files except for the last (extra SFS files) can be placed in a directory one level deep so that multiple installs can be placed in the same partition. This is ideal when using a GRUB bootloader.

Switch to Previous System, e.g. other Linux, Windows®, etc.
There is a command line option at the boot menu to boot from the first hard drive by typing h. Or just remove the Lighthouse CD-Rom from its drive and reboot.
Back to top

Troubleshooting

If Lighthouse doesn't respond, first try Ctrl+Alt+Backspace. This will shut down X Windows to the command prompt. From the text mode prompt, type 'xwin' <Enter> to return to Lighthouse. If you've changed window managers try 'xwin startkde' or 'xwin starticewm' or 'xwin jwm'. On the outside chance that doesn't work try Ctrl+Alt+Delete or hit reset to reboot, or just hit the power, wait about 8 seconds and hit the power again.

You can verify the core Lighthouse base files on the CD-ROM or Frugal Installed drive by clicking on click-to-verify-lhp. This checks the md5sum on the core system files listed above. If this returns an error, restore the file(s) from your original ISO or CD-Rom (including click-to-verify-lhp) and re-try. If it still gives an error, re-download the ISO from www.lhpup.org/download.htm. What is MD5?

Low on free space in your pupsave file?

If a particular application fails to start, open a terminal window like Console-LHP on the launcher bar, or near the end of the System Menu. Type the apps executable name (usually all lower-case) and press <Enter>. The correct executable and can found by opening ROX-Filer (File System icon), click on Applications and locate the app's name. Right-click | Open As Text and find the line beginning with Exec=. Then type what follows the '=' in a terminal as above. Hit <Enter> and copy and paste the output into a new post on the Lighthouse Pup Forum. If it starts but something isn't right, you may need to kill the previous instance by typing (in a terminal) killall <executable> <Enter>, then re-type <executable> <Enter>.

Comments and questions are welcome at Puppy Derivatives Forum. Look for the thread labeled LighthousePup N.NN, where N.NN is the version you are using or interested in. In Lighthouse, type ver in a terminal window for version information.

Back to top

Uninstallation/Clean Upgrade

Reboot in LiveCD or 'clean boot' from your Lighthouse CD-Rom, typing at the boot menu 'ram'. Click on Pmount Drives and mount the drive where your spupsave.2fs is located. Delete or move to another folder all of the frugal install files listed above and rename 'spupsave.2fs' to spupsave.2fs.save or similar. Remove the CD-Rom from its drive and reboot. If desired, insert a new Lighthouse CD and continue with a frugal install as described above.

What is an SFS?

SFS (Squash File System) add-ons are compressed software files that are layered into the file system at boot up from a Frugal Install and initially take no space in the pupsave file. They often include many apps in one 'combo-pack'.

Place them in /mnt/home, root directory of the partition where your pupsave file is.
Then, using BootManager in the System menu, move desired SFS's to the right-hand pane, click OK and reboot.

If their name ends with _nnn it should match the LHP version you have, e.g.,
4-KDE-4.3.3c_443.sfs for LighthousePup-4.43-c.iso.

Automount-setup

Automount is enabled by default to mount all drives except CD/DVD during bootup. To disable Automount open /mnt in ROX-Filer, click on the Automount icon and uncheck Automount: all drives. There is also an entry in the Utility menu for Automount-setup.
Back to top


Desktop and User Interface

Internet/Network Connections -- Click on the 'Connect' desktop icon. You will then see at least two buttons, to choose the Dialup or Network Wizards -- click the latter if you have a wired or wireless broadband Internet connection. Once you are connected, you shoud see a 'blinky' icon on right side of the taskbar.

Autoraise and mouse focus

KDE4 Autoraise and focus settings
--see
System Settings | Window Behavior

KDE3 Autoraise and focus settings--see Control Center | Desktop | Window Behavior

Openbox Autoraise and focus is configured with the Openbox Configuration Manager. To enable click to focus, right click on desktop | Openbox | Obconfig | Mouse | uncheck 'Focus Windows when...' and this takes effect immediately.


Startup/shutdown sounds


To change IceWM/JWM/LXDE/Openbox startup and shutdown sounds, open /usr/share/audio folder:
    Change login.wav
and logout.wav symlinks to point at desired sound file.

For KDE4 login/logout sounds, also open /usr/share/audio folder:
    Change login_KDE.ogg and logout_KDE.ogg symlinks to point at desired sound; does not have point to an .ogg file.


Autostart Items

JWM/LXDE/Openbox see /Startup or /root/Startup; to disable an item from autostarting, move it to the DisabledItems folder (/Startup/DisabledItems)

X Windows Init Script /root/.xinitrc (File | Recent Files in Geany Text Editor.)


 IceWM
(Taskbar 'Rocket Icon') QuickLaunch | Advanced Settings | Open Autostart Folder. Move items to and from 'DisabledItems' folder to disable or enable autostart.
QuickLaunch | Advanced Settings | Edit X Windows Init Script
QuickLaunch | Advanced Settings | IceWM Settings | Edit Startup Script

 KDE Autostart Items in
/root/.kde/Autostart (Click the blue folder icon 'File System' | Autostart.)

Note: If KDM login manager is installed with xorgwizard | Advanced Settings, /root/.xinitrc is replaced by a script for each Window Manager in /usr/bin, e.g., /usr/bin/kdm2icewm,
/usr/bin/kdm2jwm
Back to top


IceWM Keyboard shortcuts (hotkeys)--for KDE4 see System Settings | Keyboard & Mouse

Command Line

Type phelp <Enter> in a terminal/console for getting started tips.

If desired, Lighthouse can be started to CL (without X Windows) with boot parameter puppy pfix=nox

The following default aliases (keystroke abbreviations) are in /etc/.bashrc to make life a bit easier:

alias l='ls'
alias la='ls -A' # include hidden, skip . and .. entries
alias ll='ls -Al | more' # include hidden, details, page at a time
alias lh='ls -Ahl | more' # as above plus human readable sizes (K=KiloBytes, M=MegaBytes, etc.)
alias clr='clear' # clear screen
alias ..='cd ..' # change to parent directory

alias win='xwin' # for congruence with MS/DOS
alias dir='ls -Al | more' # for congruence with MS/DOS
alias shutdown='poweroff' # for congruence with MS/DOS

Back to top
Release notes


This free software comes with absolutely no warranty. For GPL, LGPL, other licenses and documentation see /usr/share/doc, www.fsf.org/licensing and www.puppylinux.com/faq.htm.

www.puppylinux.org
Puppy Derivatives Forum
puppylinux.canada
AMD Green
licensed under the CC-GNU GPL
Creative Commons