How to use the Window Manager?

There are dozens of Window Managers available. Right-click on the desktop to open a menu. Click here to learn more about some Window Managers in Debian's repositories.

I don't know how to set up the network

Usually a network manager or configuration tool does this for you. There are three applications that take care of network management in LinuxBBQ, and Ceni is shipped with this release.

ceni

Open a terminal, and enter:

sudo ceni

Choose the card you want to reconfigure (cursors up and down), then hit [Enter]. Next, first remove the configuration, then repeat the selection of the card.
If it is a wireless card you try to set up, you first have to Scan or Roam. Use the Tab key (left of Q) to jump through the input fields and [Space] or [Enter] to select. If you are on a router that distributes IP addresses via DHCP, be sure to select that option.
If your network works but you cannot connect to websites, be sure that you have chosen a DNS server, either in your routers setup, or in Ceni. The DNS server that work well are:

    8.8.8.8
    8.8.4.4
    208.67.220.220
    208.67.222.222

Choose one or two of these and enter them separated with a comma in Ceni's interface.

wicd

For users who installed Wicd, please follow these steps:

Find the wicd icon in the system tray:

wicd_icon

Left-click on the icon and Wicd's user interface pops up. If there is no "Preferences" entry visible, make sure that you resize the interface by clicking and holding the right lower corner and pulling it to the left or right.

wicd_visible_pref

Select the "Preferences" entry. In the field "Wireless interface" enter the device name, for example: wlan0

wireless_interfaces

Click on "OK". This brings you back to the main interface. There, select "Network" and set up your connection.

How do I start Applications?

Generally, using dmenu: press [Alt] + [F3] and then enter the first letters of the app you want to start.

Other ways to start applications are:
  • using a configurable menu tool like 9menu (shipped with "Oyster")
  • using grun and bind it to a key combo, for example Alt - F2 (shipped with "Oyster")
  • via autostart (refer to the manual page of your Window Manager)
  • through a menu in a panel (not every WM supports panels)
  • through the terminal
If you are unsure, post your question on our forums. Generally, most users prefer to run dmenu.

Localization

Localization sets the system language.

Become root (or super-user/su/sudo) and type

dpkg-reconfigure locales

Select the locale(s) you want to generate. At the end, you'll be asked which one should be the default. If you have users who access the system through ssh, it is recommended that you choose None as your default locale.


UPDATE GRUB

GRUB is the default bootloader on most Linux systems.

On some computers it happens that after installing a Linux OS all other entries (for example to start Windows or other Operating Systems) in the boot menu disappear. Don't worry about this. Start the LinuxBBQ System Tool (Openbox menu -> Help) and select to "Update GRUB". Another way is to invoke:

sudo update-grub

Then reboot (sudo reboot).

If the menu entries are still missing, you have probably more than one hard drive in your computer. Reboot into a live system (from USB) and then Start the LinuxBBQ System Tool (Openbox menu -> Help) and select to "Rescue GRUB".This should do the trick.
If it still fails, you can do it manually: First find out which of the hard drives carries the Linux OS you want to have booted up by default:

sudo fdisk -l

This will show a rather long list of recognized devices. There should be an entry that looks similar to this:

/dev/sdb1    *    2048    204802047    102400000    83    Linux

Note the asterisk '*' that shows us that this partition is the boot partition, in our example sdb1. The GRUB should now be written into /dev/sdb (without number)

sudo grub-install /dev/sdb

After this, update GRUB again:

sudo update-grub

and reboot. If it is still not fixed, you should follow the guide on how to install GRUB from a chrooted environment.

install GRUB from chroot

Assumption 1: Linux is installed on /dev/sda1 but is not accessible via grub
Assumption 2: /dev/sda1 is the root partition, and you do not have a separate boot partition
Goal: reinstall GRUB in mbr of /dev/sda:

Boot from LiveCD or USB, then in the terminal window enter:

TARGET=/media/sda1
sudo mkdir -p $TARGET
sudo mount /dev/sda1 $TARGET
sudo mount --bind /dev     $TARGET/dev
sudo mount --bind /dev/pts $TARGET/dev/pts
sudo mount --bind /proc    $TARGET/proc
sudo mount --bind /sys     $TARGET/sys
sudo chroot $TARGET /bin/bash

This places you in a root terminal on the system. Do whatever you want to do there, e.g. re-install GRUB

grub-install /dev/sda
update-grub

To exit from chroot: press control-D or enter exit

This brings you back to where you were in the live session and you can unmount

sudo umount -l $TARGET/dev/pts
sudo umount -l $TARGET/dev
sudo umount -l $TARGET/proc
sudo umount -l $TARGET/sys

Thats it.

This and That

Change your resolution with

arandr

If you want to control your sound output, open a terminal and run

alsamixer

The look and feel of applications can be set up and changed with

lxappearance

To generate a list of your hardware, open terminal and run

inxi

To find out which kernel you are using, open a terminal and run

uname -r

To get a list of the PCI devices of your system, run in terminal

lspci -nnk

o get a list of the USB devices of your system, run

lsusb

To remove old kernels (experienced users!) run

sudo kernel-remover

This small application shows you orphaned packages that are considered safe to remove

deborphan

You can create a snapshot of your installed system. Be sure you have enough free space left on the drive. Also refer to the "README" file in your home folder. The command to start the snapshot utility from terminal is

sudo bbqsnapshot

 

Further information on "BBQsnapshot"


To create your own Oyster remaster (Roast Your Own!) follow this:


STEPS 1-5 FOR CREATING THE REMASTER FROM A LIVE SESSION


1) Check the block devices of your computer with

    sudo blkid


2) Create a mount point

    sudo mkdir /media/roast


3) Mount a partition in which you have sufficient space to write the ISO image on. In this example we use /dev/sda5

    sudo mount /dev/sda5 /media/roast


4) As super-user (sudo or su -) edit the configuration file:

    leafpad /etc/bbqsnapshot.conf


5) Scroll down to lines 35 and 36.
   You are running a Live session, so you will not be able to write to your live media.
   Replace the lines to something like this:

snapshot_dir="/media/roast/home/snapshot"
work_dir="/media/roast/home/work"


NOTE: Make sure that you DO NOT HAVE an existing directory or folder named /home/work on the target drive!

This is very important, because the work directory will be removed when the snapshot tool finishes.


STEPS 6-11 FOR LIVE SESSIONS AND INSTALLED SESSIONS

6) Close all other active applications.
   Clean up your system with bleachbit (and carefully with bleachbit as root)
  
   As super-user (sudo or su -) start

bbqsnapshot

7) Verify that you have enough space on the drive and hit Enter.

8) The tool will now copy the existing system to the work directory. By default, this is "/home/work/"

Make sure that you DO NOT HAVE an existing directory of that name.
Copying the files can take 5-10 minutes.

Do not perform any other activities on the computer, because they will be copied.


9) You can now change the boot loader entries. This is optional.

10) As last step, the tool will squash the copy of the system and write it to the snapshot folder.
By default, this is "/home/snapshot/"

This procedure can take up to 30 minutes. You can perform other (not too resource-intensive) activities on the computer in the meantime.

11) Your ISO is finished. You will find it in the snapshot folder and can copy it to USB or CD.

   

sudo blkid

    # find your USB drive, for example /dev/sdc  and  /dev/sdc1
   

dd if=/home/snapshot/linuxbbq-xxxxx.iso of=/dev/sdc

12) You're done. Restart the PC and choose to boot from USB.

Thanks for reading and happy roasting!

Online Resources