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.
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:
- spup-nnn.sfs (where nnn is the version e.g., spup-490.sfs)
- initrd.gz
- vmlinuz
- click-to-verify-lhp or click-to-verify-mariner
- Optional: SFS files e.g., 5-Mariner-5C_490.sfs
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.
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?
- You can enlarge your pupsave with Resize personal storage file in the
System Menu.
- Open /initrd/pup_rw with Gdmap
graphical disk usage in the Utilities/File Menus. Really quick
way to see where the space is going.
- If you aren't using
Moblock (part of the KDE
SFS add-on) for a while, move moblock-monitor into the DisabledItems
folders in both and /Autostart and /Startup.
On restart that will trigger
a cleanup of about 300M of blocklists, which are found in
/var/spool/blockcontrol and /var/lib/blockcontrol.
- /root/.wine
will fill
up quickly if you run/install anything in Wine. In a Frugal Install I
like to wipe it
clean occasionally by deleting /initrd/pup_rw/root/.wine
and
rebooting--a bit like
reformatting in Windows.
(Back up /root/.wine
first if there's anything important in there!)
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.
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
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.
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
IceWM
Keyboard shortcuts (hotkeys)--for KDE4 see System Settings |
Keyboard
& Mouse
- Alt+Tab Switch Window
(Shift+Alt+Tab to reverse direction)
- Ctrl+Esc Root Menu (aka 'Start Menu'.
'Windows' key has same action.)
- Ctrl+Alt+R Rxvt Terminal ('Windows' key+R has same
action.)
- Ctrl+Alt+C Calculator ('Windows' key+C has same
action.)
- Ctrl+Alt+F Pfind File Search Utility
Console Switching
- Ctrl+Alt+F1 Console Messages
- Ctrl+Alt+F2 Login Console (default password for root is woofwoof.)
- Ctrl+Alt+F7 Back to X Windows
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
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.