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 e.g., lupusave.2fs.bak before booting LighthousePup.

(If you're updating your existing Lighthouse to a new version, do the same but just type ram at the boot menu.)

Acronyms

LHP = Lighthouse Pup
Linux            IceWM = Ice Window Manager     JWM = Joe's Window Manager

KDE = 'K' Desktop Environment       LXDE = Lightweight X11 Desktop Environment

SFS = Squash File System            
  Xfce = Lightweight & full-featured desktop

System Requirements

For the LiveCD you'll want the 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. (If you already have Lighthouse or Puppy booting from GRUB, you can click on the ISO in ROX-Filer to mount it and then copy the files into a new folder one-level-deep at /mnt/home e.g, /mnt/home/lhp.) 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.

Some of the add-ons make KDE 3.5.10 or KDE4 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.

A Linux Swap partition is also recommended, 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.

Before applying any changes with GParted please boot from the LiveCD so that all partitions can be unmounted first. 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.

LHP 5.00 is based on a hybrid
of Quirky 1.20, Slackware 13.1 and Puppy 4.3.1, with some updates from the latest Woof.

Back to top

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

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.

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 <Enter>. This is the Live-CD or 'clean boot' mode. The Mariner ISO is the same 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. If the session save dialog doesn't respond to <Tab>, press S <Enter>. No need to save to a partition (Option 2) as the pupsave file can be resized later.

After rebooting into your newly saved Lighthouse environment, click on the Pmount Drives icon on the desktop or Wbar launcher, and the 'Mount' button for your CD/DVD drive. A window should open showing the files below. Then click on the File System icon, click on 'mnt' and 'home'. Drag and drop the following files from the Lighthouse CD-Rom to this /mnt/home folder e.g., /mnt/home/spup-490.sfs 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 Optional SFS files can be placed in a directory one level deep so that multiple installs can be placed in the same partition.
e.g., /mnt/home/lhp/spup-490.sfs (/mnt/home is actually a symlink to the root of the partition.) This is ideal when using a GRUB bootloader (Menu | System | Utility | GRUB Bootloader Config.)

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 <Enter>. 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 files 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, e.g., abiword) 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 'Exec=' 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. Please use 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. e.g., /mnt/home/OpenOffice.sfs This is the root directory of the partition where your pupsave file is. (/mnt/home is actually a symlink to the root of that partition.)
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.4.4-C_490.sfs for LHP 5.00C build 490.

Automount-setup

Automount is enabled by default to mount all drives 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 File System menu for Automount-setup. In LHP 5.00 and later you can selectively automount drives with Startmount.
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 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, open System Settings | Notifications | click on Event source: drop-down | KDE System Notifications.



Autostart Items

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

X Windows Init Script is /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 | IceWM Settings | Edit Startup Script
QuickLaunch | Advanced Settings | Edit X Windows Init Script

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

Note: If KDM login manager is installed with xorgwizard | Options & Tools, /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
Console Switching

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