Information for Labdooers (Volunteers)

In this guide you will find useful information for Labdooers (Labdoo users), including information about how to sanitize laptops, how to package them ready for traveling, or general tricks and tips among others. While this document attempts to be comprehensive, if you have any questions that do not get answered in this guide, please post them directly in any of the Labdoo Teams and one member of the Labdoo community will provide an answer.

TIP. While you proceed reading this Labdooer manual, we also encourage you to check out the Labdoo Toolkit, a centralized place where you will find handy tools to help you carry out your mini-missions.

Tags: 

Labdoo Guide to Rescue a Laptop

There are several strategies to collect unused laptops from your local community. Many of the people you know have unused laptops sitting idly and the objective is to give them an option to repurpose them and convert them into powerful educational devices. Here are some ideas to help you find and rescue idle laptops.

1. Think of 5 people who will most likely donate their used laptops.

They can be your parents, your co-workers, your relatives, your class-mates or your friends. If you are a student or a teacher in a school, you can write a letter to the students parents asking for unused laptops. Many parents work for companies that have unused laptops.

2. Pitch potential donors with the 3 favorite things you like about Labdoo.

When talking with potential laptop donors, tell them about the Labdoo story. Tell them for instance about the notions of using collaboration to spread education around the world and without incurring any economic or environmental cost. You can get some ideas from the Labdoo Value, Philosophy and Principles.

3. Be proactive!

Contact the potential donors, in person or by e-mail. Describe the benefits that each player with the Labdoo platform receives. Here are some examples of benefits:

  • A benefit to the donor: They are basically helping themselves clear out old things and making more space.
  • A benefit to the community: The carbon footprint produced by a laptop is equivalent to 2 trees! (or 1500 liters of water, or 270 soda cans). Recycling laptops properly helps keep our environment green.
  • A benefit to the children who receive the laptops: The repurposed laptops are powerful tools to help underprivileged children receive an education. Once the donated laptop arrives at its destination, the donor will be able to follow the link assigned to the laptop he/she donated and see pictures of those children using the laptops.

Additional Tips.
1. Understand that what you are doing is creating a positive impact. A change in perspective can change your whole approach!
2. If you are too shy to ask face-to-face, hand written letters or emails are good alternatives.
3. Use your social networking skills and tools to bring awareness. Write a post on your favorite social networks (Facebook, Twitter, Google Plus, etc.) letting people know about your laptop collecting activities.
4. Don’t let the idea of rejection stop you. It happens to everyone, and it’s part of the learning process. The cause you are promoting is your best ally.
5. Leave friendly reminders to the people who promised you a laptop. Many donors need frequent reminders that they should take proper action on their idle laptops when they still hold value.
6. You can be creative and come up with your own laptop collection strategy.

Tagging a Laptop with a Labdoo ID Number

Each dootronic contributed to the Labdoo platform needs to be tagged and labeled with its unique Labdoo Indentifier (ID) to ensure that donors can track their donation all the way to the final destination school and/or the recycling factory.

The following steps describe the process of tagging a Labdoo laptop.

  1. Login to Labdoo.org by clicking on the "Login" link located on the top right corner of www.labdoo.org.
  2. On the top pull-down menu, select "Dootronics" -> "Tag it!"
  3. Fill in the information about your dootronic (Make sure you fill all the fields marked with a "*")
  4. If the donor desires so, it's very important to add the donor's email address to ensure that he/she can receive email updates about the status of the dootronic. Here's how:
    - Under Create Dootronic, select the second tab "Additional Information".
    - Scroll down to the field 'Additional notification emails'.
    - Fill in the donor's email address in this field.
  5. Click "Save" once you are done. A unique Labdoo ID number will be assigned to the laptop.
  6. On the new page after clicking 'save', click on "Print tags" to print the "Labdoo ID" labels. (Alternatively, you can manually write the Labdoo ID number on the preprint blank label sheets that you will find in this link.
  7. Tape the labels to (1) the laptop, (2) its power adapter, and all (3) the parts which come with the laptop. Ensure the taping is resistant so that the label does not get detached from the laptop.

Below is an example of a laptop tagging page.


Figure. Example of tagging procedure.

How To Sanitize a Laptop

The process of sanitizing a laptop involves three aspects: (1) physically cleaning the laptop's appearance (2) cleaning up the laptop from any previous information and (3) installing the education software.

The base education software package installed in every Labdoo laptop is called Edubuntu. Edubuntu is a powerful free software platform including education applications covering all of areas of science, from pre-school level to high-school level and available in more than 130 languages.You can learn more about Edubuntu directly from https://www.edubuntu.org/. In addition to the Edubuntu platform, laptops can optionally be preloaded with additional education content such as an offline version of Wikipedia and other Open Education Resources (OER).

Labdoo provides two laptop sanitation manuals: a simple sanitation guide and an advanced sanitation guide. If you are new to the Labdoo Project, we recommend you to follow the simple sanitation guide. If you need to deal with large numbers of laptops and are experienced, we recommend you to use the advanced sanitation guide. Remember also that as a last resort and if you don't have the time to sanitize your own computer, you can always bring it to your closest hub and have the labdooers there sanitize it for you (click on 'Hubs -> View' to go to the list of Labdoo hubs).

The simple sanitation guide installs the base Edubuntu platform (preloaded with all the Edubuntu education applications) and it allows you to optionally install extra education packages via some scripts. The advanced sanitation guide uses pre-configured images and it allows you to install all the packages (both the Edubuntu platform plus all the extra education packages) in one shot using the image. The next table summarizes the packages that are installed by each method.


Content Simple
Method
Simple Method
Plus Scripts
Advanced
Method
Lubuntu LTS (Operating System) Yes Yes Yes
Edubuntu Educational Software (base education packages) Yes Yes Yes
Office Suite (Libreoffice) Yes Yes Yes
Wikipedia for schools "wikidoo" (English offline lexicon suitable for children) No Yes Yes
License-free manuals for Ubuntu, Libreoffice, etc. No Yes Yes
License-free e-Books No Yes Yes
XOWA, access to 800+ Offline Wikis in regional languages No Yes Yes
RACHEL, access to Khan Academy, Edison for Robotics, CK-12 Textbooks, UNESCO's IICBA Electronic Library, Great Books of the World, OLPC Educational Packages, or MIT Scratch, among many others No Yes Yes
Barrier-free access for blind or hearing impaired user No Yes Yes
Browser-based English course, Multimedia based following UK Curriculum No Yes Yes
Offline video tutorials for user No Yes Yes
Optimized user flow to avoid accidental system changes No Yes Yes
Preparation for virtual machines (VM VirtualBox) No Yes Yes
Virus scanner and tool ClamAV No Yes Yes
Suggested minimum size of disk drive 20 GB 30 GB to 80 GB 30 GB to 80 GB

Please continue reading this guide to learn the step by step process of sanitizing a laptop by choosing one of the two available methods: simple or advanced.

Sanitation Guide: Simple Method

Introduction

This brief document describes the process of sanitizing a laptop according to the Simple Method.

[TIPS. If you'd like to get tips on how to collect unused laptops from your local community, please click here. After the laptop gets sanitized, you can click here to learn different ways to package the laptops to make them ready for traveling to a needy school. If in any of these steps you get stuck during the sanitizing process, you can post your questions in the wall of the Labdoo QA Team so that others can help you.]

Sanitation Steps

The current standard process of sanitizing a laptop is as follows:

  1. If the laptop is not already tagged with a Labdoo ID number, please follow the instruction under "tagging a laptop" page. Make sure you print 3 labels and attach two of them to the laptop and one to the AC adapter following the instructions that you will find in the website.
  2. Download the Lubuntu 16.04 release from this link (this is a large .iso image):
    http://cdimage.ubuntu.com/lubuntu/releases/16.04/release/lubuntu-16.04-d...

    Note. If your computer is powerful enough and has more than 1GB of memory RAM, you can instead download Ubuntu 16.04 which provides better graphics but requires more computing resources:
    http://releases.ubuntu.com/16.04/ubuntu-16.04-desktop-i386.iso

    Note. If you prefer to download the previous 14.04 Lubuntu version, you can do so from this link: http://cdimage.ubuntu.com/lubuntu/releases/14.04/release/lubuntu-14.04-d...

  3. Burn the downloaded file into a CD. Make sure you burn the downloaded file as an ISO image. If you don't know how to do that, you can follow the instructions from any one these links depending on the type of computer your are using to burn the CD:
    (Note: you can either use a CD or a DVD, the burning process is the same. We recommend to use a CD because some older computers do not accept DVD.)
    - Burning a CD using a Windows computer.
    - Burning a CD using an Ubuntu computer.
    - Burning a CD using a Apple/Mac computer.
  4. Insert the Lubuntu CD into the laptop you intend to sanitize and boot the laptop from the CD. Upon booting the laptop with the CD, you should see the Linux installation menu. If you don't see it, you need to enter into the bios of the laptop and change the booting order of your computer to make sure it first boots from the CD. For more information on how to configure the bios, see this page.
  5. Upon seeing the Lubuntu installation menu, start by selecting the installation language; for instance, choose “English”.
  6. Select “Install Lubuntu”.
  7. Select the language to be installed in the laptop. If you don't know the destination country, select “English”. If you know the destination country, select that country's language.
  8. In the "Wireless" screen, if you have internet connection, you may select the network you use from the list and enter its password. Otherwise, leave it as default.
  9. The next window is just to confirm the laptop fit into the minimum Hard Drive requirement. Hit "continue" once.
  10. Now we are going to do a small trick to ensure we completely remove any previous private data from the computer. Please press at the same time the keys 'Alt + CTRL + F3'. This will take you to a terminal window. In this terminal window, please enter first the following command: sudo apt-get install coreutils
    [press enter]. Once this command is executed, run this other command: sudo shred /dev/sda -f -v --iterations=2 [press enter]. (If this second command does not work, you can try with 'hda' instead of 'sda', like this: sudo shred /dev/hda -f -v --iterations=2.) This second command launches a process that will run for about 1 hour or so, and overwrites the disk with random values. After this process is done, press at the same time the keys 'Alt + CTRL + F7' to continue the installation process and go to the next step. (Please see the video in this page for a complementary illdustration of this step.)
    Note: If the above does not work, an alternative method is to reboot the computer and select the option "Try Ubuntu" to boot Ubuntu in trial mode. Then once Ubuntu is booted, open a terminal by pressing the keys [Ctrl+Alt+T] at the same time. In this terminal, type the same 'shred' commands described in the previous paragraph. Once the shred process is completed, reboot again and redo all the installation steps again but omitting this step.
  11. Select the destination country. If you don't know it, pick the country you are located.
  12. Where it says “detect keyboard”, say “No”.
  13. In the next screen, pick the country of origin of your keyboard.
  14. When it tries to configure the network, press “cancel” (there is no need to do network installation since you have the CD and the updates are installed later).
  15. When it asks for the “Your name”, please enter the word “labdoo”.
  16. When it asks for the “Your computer name”, please enter the word labdoo with it's Labdoo ID number (eg. labdoo_000003454).
  17. When it asks for the “username”, please enter the word “labdoo”.
  18. When it asks for the “password”, please enter the word “labdoo”.
  19. When it asks for the “Confirm your password”, please enter the word “labdoo”.
  20. Select any time zone you want if the system asks you.
  21. When it says “Partitioning method”, please say “Guided – use entire disk”.
  22. When asked for HTTP proxy information, please leave it empty and just press “Continue”.
  23. When it says “Install the GRUB boot loader”, please say “Yes”.
  24. When it says “Is the system clock set to UTC”, please say “Yes”.
  25. This completes the installation of the basic operating system. Next, reboot the machine and log into the Lubuntu system using the username “labdoo and password “labdoo”. Once you are into the Lubuntu system, Make sure also that the laptop is connected to the Internet, via Ethernet cable or via WIFI. Finally, type ALT+CTRL+t to open a terminal window, and in it, type the following commands:

    sudo apt-get update [and press ENTER]
    sudo apt-get install edubuntu-desktop libreoffice [and press ENTER]
    sudo apt-get upgrade [and press ENTER]
    The last two commands could take from a few minutes up to an hour or so to complete.

  26. Install the Labdoo logo as a background image in your desktop to give it a friendly look. You can download the Labdoo desktop image from this page and then by right-clicking on your computer desktop you can select the option 'Desktop preferences' and install the image.
  27. Finally, if you have extra time, you can also install additional educational software (such as an offline version of the Wikipedia, and more educational applications) by following the instructions in this page. This step is not mandatory as the laptop at this point already has a good number of educational applications, but it's a good thing to do if you have that extra time.

What to expect next

Congratulations! You have now successfully completed your laptop drive campaign and sanitized your laptops, so they are now ready to be packed and travel. Please go to the Packaging the laptop for travelling section to learn how to get the laptops ready for dootrips.

  • If you are traveling yourself to a school project, you can bring the laptops in your luggage. Try to distribute as many laptops to as many people traveling with you as possible because some countries have a limit on the amount of laptops that can be carried per person.
  • If you are not traveling, then get in touch with one of the Labdoo hubs (for instance, one which is closest to you) from the hubs list. The Labdoo hub will help you decide which school your laptop should be sent to and it will also help you get in touch with the travelers going to that school so the laptops can be picked up from you.

Sanitation Guide: Advanced Method

There are two different advanced methods. The 'Advanced Method (Without Network)' will allow you to clone Labdoo laptops from your USB or DVD drive and without the need to use a network. The 'Advanced Method (With Network)' will allow you to clone Labdoo laptops from a server and over the network.

Please notice that these methods are mutually exclusive. Choose one method or the other, depending on your preferences and resources.

If you have any questions, remember that you can write them to the Labdoo quality assurance team wall and someone will provide the answers.

Choosing the Right Labdoo Images for your Computer

Both advanced methods use Labdoo images to install the complete operating system and educational packages. Use the following table to choose the correct image depending on your computer.


Figure. Choose your Labdoo image by following these steps.

Advanced Method (Without Network)

Introduction

This wiki page will guide you through the process of sanitizing a laptop and installing the education software according to the advanced method (without network). The advanced method is based on the process of cloning the Labdoo/Lubuntu image, which includes all the necessary software. This process is a bit more complex than the sanitation process based on the simple method, but its advantage resides in that it will allow you to sanitize laptops and install a very large and complete education package in a more efficient and speedier way.

Sanitation Steps

Follow the next steps to sanitize a Labdoo laptop according to the advanced method. If you have any questions or doubts through the process, please post your queries in the Labdoo Quality Assurance Team and another Labdooer will provide an answer.

Embedded in the descriptions of each of following steps you will also encounter two videos. We recommend you to watch them as they provide valuable graphical insights about the installation process.


Video. Advanced method part 1.


  1. Download Parted Magic tool.

    Start first by downloading the license-free tool Parted Magic. Choose to download the Parted Magic image from one of the following two links:

    Download and burn the Parted Magic ISO image into a bootable CD or a USB stick.

  2. Start Parted Magic.

    Insert your Parted Magic CD or USB stick into the laptop you want to sanitize and boot it. (Make sure that the bios of your laptop is set to boot first from the CD drive or from the USB stick. For information on how to configure the booting order using the bios please refer to this page.)

    Once Parted Magic starts, select the default option 'Default settings (Runs from RAM)'. This option should work for most of computers, but if you find any issues, you can manually set a different configuration by using the various options found in the Parted Magic menu. In this case, see also the above video for an explanation of some of the options.

    Once parted magic has completed booting, you will be presented with a graphical desktop with various icons. It's important to start by deleting all the data from the laptop hard disk to ensure all previous private information is erased. You can do this by clicking on the icon 'Disk eraser' and follow the instructions. The deletion can take some time, so go grab a cup of coffee in the meantime if needed.

  3. Download the Labdoo/Lubuntu ISO image.

    Prior to selecting a proper Lubuntu/Edubuntu image for your laptop, you need to know what type of laptop you have. To do so, once Parted Magic is booted, click on the black screen icon found in the task bar at the bottom of your screen. This will open a terminal window. In this terminal, type the following command:

    grep -q 'lm' /proc/cpuinfo && echo "My CPU is a 64 bits one" || echo "My CPU is a 32 bits one"

    The output will tell you whether you have a 32 or a 64 bit computer. Based on this information, you can now download the most suitable Labdoo image from the following link: http://ftp.labdoo.org/download/images/

    Notice that there are different images, so you will need to make sure you download the right one based on the characteristics of your laptop and the type of education software you want to install. The following README file (located also in the above link folder) describes each image and will help you decide the right image for your laptop: http://ftp.labdoo.org/download/images/README-EN.txt

    You can also refer to the following diagram to decide which image is best for your computer:


    Figure. Choose your Labdoo image by following these steps.

    Store the downloaded zipped image file on an external USB disk-drive/memory stick or in another computer connected to your local network. If you handle several images create a folder for each image and copy each image into its own folder. If you are using a local device such as a USB disk or memory stick, please store these image folders under the first top level folder to ensure that Clonezilla (described in the next step) will be able to find them.

    Now go to that folder and unzip the downloaded file using the following command:

    tar zxf FILENAME.tar.gz

    (substitute FILENAME by the name of the file). This will uncompress the downloaded file.

    Each Labdoo image comes with a checksum file containing an MD5SUM value. Using this MD5SUM value you can check if the download was completed with no errors. How to handle and compare MD5SUM depends on the operating system of your computer. To compare the MD5SUM using a Linux machine, open a terminal and go into the folder where both the unzipped file and the MD5SUM file are located and execute the following command:

    md5sum -c MD5SUM

    To learn more about MD5SUM you can check: http://en.wikipedia.org/wiki/MD5

  4. Install the Labdoo/Lubuntu image.

    Labdoo images are complete copies that include all the operating system and education software. So by cloning them into your laptop, you will have a newly sanitized computer ready to deliver education to children. Follow the next steps to carry out the cloning process.

    • While running Parted Magic, double click the icon 'Clonezilla' to start the image cloning process.
    • Select the option 'Image' (instead of device).
    • Next, select the 'Storage Media' on which the Labdoo/Lubuntu image you downloaded in the previous step is stored. Read the instructions on the screen as they will guide you too.
    • Next, select 'Expert Mode'. We need to use expert mode because the Labdoo/Lubuntu image 'remembers' the size of the original disk upon which it was created. If the target disk in the new cloned laptop is smaller, you will get an error in beginners mode ('target disk too small'). In Expert Mode you can enable the option '-icds' to avoid this check (see below).
    • Select 'Restore Disk' to restore the image.
    • Select the Labdoo/Lubuntu image that you previously downloaded.
    • Select the target disk.
    • Mark in expert mode the option list '-icds' by using the space button ('do not check if the size of the origin disk is larger than the target disk').
    • Answer the following questions with "Y" (Yes).
    • At this point, the cloning process will start and it will last from 15 to 30 minutes. Once finished, the complete Lubuntu operating system plus all the education software and Labdoo settings are installed and ready to use! this is the big advantage of using this cloning process, if you were to instead download all the education packages from the Internet it would take you a good amount of hours.

    Note: If you are cloning a 14.04 image (or higher) using 'Clonezilla 2012/10' you may get at the end two red error messages saying that certain GRUB files and settings are missing. You can ignore this message, everything is ok.

  5. Steps to complete the configuration of the laptop after the cloning process.


    Video. Advanced method part 2.


    Once you have completed the previous cloning process, start the Partition Editor by clicking on the Gparted Icon found on the desktop. This tool will help you adapt the size of your computer through the following steps:

    • Click on the Linux swap space, click on the option "Resize / Move" and drag it using the mouse to the end of the disk (please make sure that the mouse pointer shows arrows to the left AND to the right side, as otherwise you will be enlarging the swap space instead).
    • The swap size also needs to be adapted to the size of the memory (RAM) of your laptop. Both should match. For instance, if your laptop's RAM is 1GB, configure your swap partition to be also 1GB. Use the mouse or fill in the data you need in the shown table. Then press OK.
    • Next step is to enlarge the data / software partition, usually named partition 'sda1'. Click at the end of this partition and drag it all the way to the right. A small gap (1 MB) will be left which cannot be used, that is ok.
    • Click on the green hook 'Apply' and confirm it. The computer will then be busy for a while adjusting the partition sizes.
    • Once the computer finishes the previous process, reboot it by clicking on the lower left corner of the screen of the Parted Magic desktop. You laptop is now ready to help unleash education somewhere in the planet!

Advanced Method (With Network)

Introduction

This wiki will lead you through the process of sanitizing Labdoo laptops using ready-to-use images over the network. This process is powerful because it allows you to sanitize laptops using a fast and efficient cloning process and hence it is ideal if you are dealing with a large number of laptops. However, this process is a bit more complex too, and hence we consider it an advanced method. If you are new to Labdoo and inexperienced with computers, we recommend you to use the Simple Sanitation Method, but if you are up for learning a cool way to install powerful software in a computer, this is your guide.

Images are a complete software copy of an installed Labdoo computer, containing everything from the operating system, software, educational content and all the optimized settings. Except for adapting the final configuration to the country of the destination edoovillage (language and keyboard) and setting the hostname, the cloning process takes care of everything for you in one shot.

Go ahead into the next section for a step by step description of the Sanitation process based on images.

Steps to Follow

# Installbox
########################################

The Installbox setup allows you to automatically install Linux clients on large scale.

### Pre-Requirements

- A laptop with wireless LAN and gigabit ethernet port
- A gigabit switch
- Network cables to connect the clients
- Wireless internet access where you are NOT using the IPv4 network address 192.168.20.0/24

# Installbox Setup
########################################

- Download the customized ISO image: http://id-install-prd.ethz.ch/labdoo/installbox/jessie/debian-jessie-ins...
- Either burn the image to a CD or write it to a USB key using dd if=debian-jessie-installbox.iso of=/dev/sdb
(replace sdb with the device node of your USB key, if necessary).
- Boot the laptop using the CD or the USB key.
- Please do not connect the ethernet cable yet.
- Select the Install option during boot.
- You will be prompted to select the keyboard layout, choose the one that fits for you.
- During network setup please select the wireless interface. There should be two interfaces listed:
eth0 (which is ethernet, don't select this one!) and wlan0.
Note: If you do not see those two interfaces here, please abort the installation as your device is not supported then.
- When you have selected wlan0, the installer will search for wireless networks available. Choose your network please.
Most modern wireless networks use WPA/PSK for authentication, so if you are unsure, you can probably select this option.
- Type in your Wireless password in the next step. Please note that it's displayed in clear text.
- Relax, the rest of the installation should work fully automated.
- After a while the device reboots, you can now connect an ethernet cable from the installbox laptop to the gigabit switch.
- You should now be able to connect any client to the switch and select ethernet boot.
On Lenovo you can press F12 and choose the network interface as boot device.
- On the installbox, a NFS export has been created on /exports.
This will be available to all clients on the LAN and should contain the clonezilla images.

# PXE Boot Options
########################################

When you boot a client, the boot menu will show the following options:

- Clonezilla Autorestore x86
This should be started on a client where you want to apply the default image. No interaction needed, all existing data will be deleted.
It will restore an image called linux-x86 which must be available in /exports on the installbox.

- Clonezilla Autorestore x86_64
Same as Autorestore x86 but for the 64bit variant. It will automatically restore an image called linux-x86_64

- Preseed x86
Prepare a 32bit master installation

- Preseed x86_64
Prepare a 64bit master installation

- Clonezilla Autosave x86
Create an image of a master installation. It will automatically written to the NFS share /exports and will be named linux-x86.
Note: This will overwrite an existing image of the same name on the installbox.

- Clonezilla Autosave x86_64
Same as Autosave x68 but for the 64bit variant. It will automatically write a disk image to the installbox at /exports/linux-x86_64.
Note: This will overwrite an existing image of the same name on the installbox.

- Clonezilla Live
Just the default live image with all options and the NFS share already mounted

- SystemRescueCD
A universal system recovery toolbox. It also contains gparted for manual partitioning.
To start gparted, simply type startx and then click on the gparted icon in the taskbar.

- Boot and Nuke
starts dban and will automatically wipe all data on disk

Note: on all options you can press the tab key in order to change settings manually.
To permanently adjust the file, edit /var/lib/tftpboot/prd/pxelinux.cfg/default on the installbox.

# Workflow
########################################

After you have set up the installbox a typical workflow would be the following:

1. Create a master image

- Choose another laptop on which you want to create the master image
- Connect the laptop to a port on the gigabit switch
- Follow the steps described in the 'Prepare Master Image' section

Alternatively you can download a prepared master image. See 'Image Creation Cutoff' section below for further details.

2. Provision laptops with the newly created master image

- after the master image has been stored on the installbox, choose the relevant Clonezilla Autorestore option from the PXE menu

Once you have created a master image, there is no need to re-create it other than changes needs to be done to it.
Next time, you can just start provisioning clients using the Autorestore option.

Hint: if unsure, just create a master image for the x86 architecture. This should work on nearly every machine.

# Image Creation Cutoff
########################################

If you do not want to prepare an image on your own, you can download the prebuild image for the x86 architecture.

To do so, execute the following commands on the installbox:

sudo wget -c http://id-install-prd.ethz.ch/labdoo/installbox/jessie/linux-x86.tar.gz -O /exports/linux-x86.tar.gz
sudo tar xvzf /exports/linux-x86.tar.gz -C /exports/

Note: the download of the image might take quite a long time, depending on your internet connection.
If the download is interrupted for some reason, you can resume it by executing exactly the wget command from above again.

This image is set up for Swiss German Keyboard layout. If you want to customize it:
- Deploy a machine using the 'Clonezilla Autorestore x86' function.
- Boot it and make your customization.
- Boot the SystemRescueCD and start gparted.
- Shrink the root partition to ~ 30000MB.
- Remove any existing version of the image by running sudo rm -rf /exports/linux-x86 on the installbox.
- Reboot the client that contains your modifications and select the Clonezilla Autosave option for x86.
This will save your modified version to the installbox.

# Prepare Master Image
########################################

In order to prepare a master image from scratch, please make sure that your installbox laptop has a working wireless lan internet connection.

### Preseed

On a client that is connected to the gigabit switch, start the pxe boot and select either Preseed for x86 or x86_64.
This will set up a base install of lubuntu with a user called labdoo with password labdoo.

After preseeding, boot into the newly installed system and apply the customization from:

http://ftp.labdoo.org/download/images/installskripts/

If you want to modify the preseed file, e.g. to setup a different user account, just edit /var/lib/tftpboot/trusty/preseed.cfg

Hint: to change the keyboard layout (which defaults to us), simply run dpkg-reconfigure keyboard-configuration after installation.

### Creating the Image

When the client has been set up according to your needs, reboot and select the relevant Clonezilla Autosave option that fits the architecture of your master setup.

This will automatically save an image to the installbox which can afterwards be applied to other clients using the Clonezilla Autorestore function for that architecture.

Note: this automated process has been optimized for image installations on systems with at least 40GB HDD/SSD space.
If you are in need of installing in on machines with smaller disks, please shrink the root partition before creating the image.

# Image Requirements
########################################

If you do not want to use the images that can be prepared with the installbox setup, please make sure that your images
fulfill the following requirements:

- images that should be deployed automatically using this setup must have the following partition layout:
/dev/sda1 - swap (suggested size 2GB)
/dev/sda2 - root / ext4
- after preparation of the master, please shrink the root partition to it's minimal size possible.
This ensures that the image will be deployable on small drives as well.

# Resetting the Installbox
########################################

You can reset the changes made to the installbox default settings at any time by running /usr/local/sbin/applypuppet as root.

# Making of the Installbox ISO
########################################

This step is not necessary and just for informational purpose. It describes how the ISO for the installbox has been created.

apt-get install -y bsdtar genisoimage syslinux-utils
cd ~
rm -rf cd
mkdir cd
wget http://cdimage.debian.org/cdimage/unofficial/non-free/cd-including-firmw...
bsdtar -C cd -xf firmware-8.2.0-i386-netinst.iso
vi cd/isolinux/txt.cfg
- append vga=788 initrd=/install.386/initrd.gz --- quiet
+ append vga=788 initrd=/install.386/initrd.gz url=http://id-install-prd.ethz.ch/labdoo/installbox/jessie/preseed.cfg locale=en_US.UTF-8 ipv6.disable=1 debconf_debug=5 netcfg/get_domain=domain.example netcfg/dhcp_timeout=60 netcfg/get_hostname=installbox --- quiet
quit vi with ESC :wq!
vi cd/isolinux/gtk.cfg
- append vga=788 initrd=/install.386/gtk/initrd.gz --- quiet
+ append vga=788 initrd=/install.386/gtk/initrd.gz url=http://id-install-prd.ethz.ch/labdoo/installbox/jessie/preseed.cfg locale=en_US.UTF-8 ipv6.disable=1 debconf_debug=5 netcfg/get_domain=domain.example netcfg/dhcp_timeout=60 netcfg/get_hostname=installbox --- quiet
quit vi with ESC :wq!
cd cd; md5sum `find ! -name "md5sum.txt" ! -path "./isolinux/*" -follow -type f` > md5sum.txt; cd ..
genisoimage -o debian-jessie-installbox.iso -r -J -no-emul-boot -boot-load-size 4 -boot-info-table -b isolinux/isolinux.bin -c isolinux/boot.cat ./cd
isohybrid debian-jessie-installbox.iso

# Additional Notes
########################################

- There is a script available on the installbox called /usr/local/sbin/pxesync.
It can sync the files needed for PXE boot for the Ubuntu and Debian distributions.

# Changelog
########################################

20150930 v0.2
- added prebuild image

20150928 v0.1
- initial setup

Advanced Method (Without Network): Autodeploy (In BETA)


BETA NOTE: this page describes a new method to install Labdoo images which is currently under trial and development. This method will likely replace our current "Advanced Method (Without Network)" installation method although currently it's still in beta phase. Feel free to try it out and provide feedback. If in doubt, use our default "Advanced Method (Without Network)" or "Advanced Method (With Network)" methods described in the previous sections.

Introduction and Approach
This method consists in using the script "autodeploy.sh" which automates most of the steps in the installation process. By using this script, you will avoid having to manually perform steps such as deleting data using Parted Magic, selecting the matching image, or adapting the partitions among others, because the script autodeploy.sh performs this automatically.

The autodeploy script will perform these tasks automatically:

  • Deleting data from the hard disk using random generated data.
  • Selecting the best matching image for cloning your computer, depending on the CPU type (32 or 64 Bit) and the size of the hard drive. (See diagram below.)
  • Installation of the matching image from an external drive. (Either from an external USB drive or from a server.)
  • Calculation of the best size for the swapping partition and adapting the swapping space.
  • Writing of the the installation protocol into a protocol file.

After using the script, the computer is ready to be used except for the final steps to adapt it to the needs of the destination school/edoovillage. You will be able to directly go to the Section Post-Installation Configuration to perform these final adjustment steps.


Figure. The auto deploy script automatically chooses the best Labdoo image based on the specifications of each computer.

Running the Autodeploy Script

In this section we detail the steps that you need to follow to install a Labdoo image using the Autodeploy script:

  • Save the executable script autodeploy in a storage of your choice, typically in an USB disk or a server.
  • Boot Parted Magic. [Note: the script autodeploy.sh runs on Parted Magic (10.2012 and 08.2013)]
  • Once parted magic is booted, copy the autodeploy script to your computer.
    • Open the File Manager (double click on the blue icon in the upper left corner of the desktop).
    • Clicking on the left column to the drive containing the script (e.g. on a USB drive) will open a 2nd tab,
    • Right mouse click on the script you want to copy (Copy).
    • Click on the 1st tab (root), right mouse click to paste the script to the "/root" directory.
    • Open a terminal, click on the terminal icon in the task bar.
    • Type in terminal /root/autodeploy.sh [Enter]
  • Follow the instructions from the script

Adapting the Autodeploy Script (only recommended for advanced users)

In some occasions you may need to modify the autodeploy script to adjust its behavior to your specific needs or goals. The next descriptions explain some of the options you can modify in the script.

[Note: line numbers may change depending on the version of the script you are using, but the same concept applies.]

[Hint: By adding or removing # lines in the script can be activated or deactivated.]

  • Lines 5-8: Names of the images for cloning (please do not change these parameters, as the names are preset by the Labdoo team.)
  • Lines 10-11: Shut down the computer automatically after the installation is finished (0=no/Default; 1= yes).
  • Lines 13-14: Example to connect to a local server (LAN); paths and passwords have to be set as needed in your local network. If in doubt contact your local administrator.

# We thank the team of Labdoo Hub Düsseldorf (Germany) for developing this time-saving script!

Post-Installation Configuration

In this section we describe the set of final post-installation steps. These steps need to be followed once you have completed the installation of the Labdoo image (as described in the previous sections) to ensure that the system is properly configured and ready to be delivered to a destination school. You can rely on both the text description as well as the videos below to complete these steps.


Video 1. System settings (language, keyboard, driver tunnings, etc.)

[Download this video]

Video 2. Adapt system files hosts and hostname.

[Download this video]


  1. Change the host name.
    The host name of the computer needs to be set to the Labdoo identifier. First, you will need to tag the laptop following the steps described under this page. Once you have tagged the computer, modify the file hosts as follows:
    • Open a terminal (press CTL + Alt + T) and type sudo nano /etc/hosts (Enter)
    • Add the line "127.0.0.1 labdoo-123456789" to this file, substituting 123456789 with the 9 digit Labdoo ID of the laptop obtained when you tagged it.
    • Save the file by pressing CTL + o (the letter o, not the number 0)
    • Leave the editor by pressing CTL + x
    • Now open a terminal (press CTL + Alt + T) and type sudo nano /etc/hostname (Enter)
    • Change the host name to the value "labdoo-123456789", substituting 123456789 for the Labdoo ID of the laptop obtained when you tagged it.
    • Save the file by pressing CTL + o (the letter o, not the number 0)
    • Leave the editor by pressing CTL + x
  2. Check the graphic resolution. se
    Go to Preferences → Monitor Settings → select the resolution you need or stay with the resolution already set → Apply.
  3. Check the keyboard and language settings.
    Right mouse click on the country language icon that you will in the launch bar → select "Keyboard Layout Handler" Settings → uncheck "Keep system layout" → click '+Add' to add up to 4 keyboard layouts or '-Remove' to remove them → Close.
  4. Install additional languages.
    Go to the menu and select: Preferences → Language Support → Install / remove Languages → add a hook at the language(s) you want to add (remove a language by removing the hook) → Apply Changes. The computer must be connected to the Internet so that i can download and install the language(s).

    To change to another user language move the needed language by mouse (keep left button pressed) to the top of the language list and drop it → Apply System Wide → all users will use this language. For more details refer also to the (L)Ubuntu manuals under the laptop folder /home/labdoo/Public/manuals-ubuntu.

    HINT. If you send the computer to a country using a "non-latin" alphabet you should stay with the English language. This way the user may more easily learn about the keyboard switch. You also need to understand the foreign language and know the keyboard layout to use the computer. E.g. typing the password "labdoo" using the Chinese or Arabian keyboard layouts will result into something different and will not be accepted as password.

    Regional Formats. Click on the tab "regional formats", click on the triangle → select needed setting (will change format of time / date and currency) → Apply System Wide.

  5. Check for specific driver requirements.

    Preferences → Software & Updates → Additional Drivers → wait a while → If "no additional drivers available" shows up, no further steps have to be taken. If a list of drivers are shown, select and install the needed driver(s) and apply Changes.

How to clean a laptop to make it look new again

The donated used laptops often come dirty in appearance. After making sure the laptop is not broken, the next step to take is to clean the laptop case.

Here's how to properly cleaning a laptop.

What you need are: some soft clothes, a small bottle of 91% isopropyl alcohol, a box of cotton swabs

LCD Screen
LCD screens are pretty delicate, and you don't want to press hard on them, because that can burn out the pixels. Instead, grab a dry soft cloth and gently wipe the screen. If you need to, add a little bit of alcohol. In most cases, that should be all you need. Do not use anything paper-based, like paper towel, Kleenex, or toilet paper, since it can scratch up your screen.

Keyboard
Clean dirty keys with a swab of rubbing alcohol to remove oil, grime, and germs. Don't forget to turn the laptop's power off before you start cleaning.

Warnings: Isopropyl alcohol vapor is more dense than air and is highly flammable with a very wide combustible range. It should be kept away from heat and open flame.

Choose a right AC adapter

All laptops use Direct Current (DC) power to operate. DC is electrical energy that flows consistently in one direction. Our wall outlets use Alternating Current (AC) , which varies constantly, but results in a positive flow of current. Laptops can't work on this kind of power, so an AC adapter is required to convert the wall outlet's current to DC power. Many laptops use different styles of connectors so it can be hard to find the best adapter to fit.

There are several ways to find a right power adapter for the laptop

1. Get the laptop's model number and check online.
2. Get the power requirements for the laptop. Look for the amperage and the voltage required. You also need to compare the connector head type of power adapter with the outlet hole on the laptop.They need to match to ensure that the adapter can plug into the laptop.

Voltage (V)
Voltage is the amount of potential energy between two points on a circuit which creates power to charge the laptop. If the voltage of the laptop is different from that provided by the adapter, it won't be able to create the correct charge needed to pull the electrical energy into the laptop. Finding the right voltage is also very important to keeping the power from shorting out the laptop. A voltage that's too high will overload the laptop's circuits.

Amperage (A)
An ampere is a unit of measure of the rate of electron flow or current in an electrical conductor. The amperage on laptop power adapters needs to match or exceed the amperage required by the laptop.

Packaging the Laptops Ready for Traveling

Packaging the laptops ready for traveling

Once a laptop has been sanitized, we need to package it so it can travel to a destination school. The main goals of the packaging are two-fold: (1) the packaging should protect the laptop from any possible rough traveling conditions; (2) the packaging should make visible the Labdoo identifier of the laptop, for both its AC adapter and the laptop itself. A recommended approach is to use transparent, bubble plastic wrap and to tape the Labdoo identifier in big letters outside, for both the laptop and its AC adapter, as shown in the following pictures:


Figure. A good way to pack your dootronics: use a wrapping material to properly protect them and write the Labdoo IDs clearly outside both the devices and the AC adapters.

You are welcome to use other packaging approaches based on what's available to you, as long as the laptop is well protected and its Labdoo identifier is made visible externally.

Installing Additional Education Packages

When sanitizing a computer, the minimum requirement is to install (1) the Lubuntu operating system, (2) the Edubuntu Education Package and (3) the Office Suite (Libre office). The Edubuntu package is a powerful education suite containing very valuable applications for children of all ages and for many areas of science. In addition to this package and optionally, you can also add even more education packages to your computer by installing some more software applications following the steps described in the next sections.

Notice that if you sanitize your computer following the advanced method, the images you install already include these additional education packages, so you don't need to do anything else. However, if you sanitized the computer using the simple method, the following sections will guide you through the process of manually installing the additional education packages. Remember that these are optional packages, so you can decide to install all, some or none.

Installing RACHEL Education Package

RACHEL is a free collection of educational content in English and Spanish. It includes powerful packages such as Wikipedia, Khan Academy, Edison for Robotics, CK-12 Textbooks, UNESCO's IICBA Electronic Library, MedlinePlus Medical Encyclopedia, Great Books of the World, OLPC Educational Packages, or MIT Scratch, among many others. To get an overview of what the package includes, please refer to the project's main page at http://rachelfriends.org/ (Download Wikis also http://dev.worldpossible.org/cgi/rachelmods.pl). A live demo of the package can also be accessed from http://www.rachel.worldpossible.org/.

Rachel occupies about 20-25GB of disk space and it is recommended to install only on disk drives of 50GB or higher.

If you sanitized your laptop using the advanced method and choosing an image that comes with RACHEL preloaded, there is nothing else you will need to do as you will be able to enjoy RACHEL directly out of the box. Otherwise, if you sanitized your laptop using the simple method, then continue reading to manually do the installation.

To install RACHEL, first you need to download the package into your local disk. You can choose to download it from either the RACHEL server http://rachelfriends.org/ or from the Labdoo FTP server http://ftp.labdoo.org/download/wiki-archive/wikis/.

RACHEL and other related educational content in English (EN), French (FR), Spanish (ES), Hindi (HI), German (DE), Portugese (PT): can be downloaded from here: http://ftp.labdoo.org/download/wiki-archive/wikis

Installing RACHEL on a Laptop
Once you have downloaded RACHEL, unzip it in a new folder /home/labdoo/Public/wikis (the downloading and unzipping operations could take some time depending on the speed of your network and computer). Once unzipped, double click on the file /home/labdoo/Public/wikis/EN/RACHEL-EN/www/starthere.html to open a web browser that will take you to the start page of RACHEL.

Note. The first folder "Wikipedia for Schools" is equivalent to the Xowa package; hence, if your Labdoo laptop already has Xowa installed, you can remove this folder from RACHEL, which will give you back 6,5 GB of disk space.

To make access for users easier, we recommend to make the default web browser page point to RACHEL's initial page. For that, open the web browser (this instructions are for Firefox but similar steps apply to other browsers) and go to:

File => Open File [ navigate to
/home/labdoo/Public/wikis/bin/www/starthere.html ] => Open

Then go to:

Edit => Preferences [ opens a window for the settings,
click on "Use current Pages" and close the tab "Preferences" ]

Please repeat any of the configuration steps for both the 'labdoo' and the 'student' users.

Installing RACHEL on a Tablet

The RACHEL package includes also an installation file for Android (apk file): http://rachelfriends.org/downloads/public_ftp/z-rachelandroid_APK/. Notice however that as long as you read the RACHEL content in a web browser from a tablet, it is not necessary to install this apk-file. That means that you can just copy and unzip the RACHEL file to the tablet and open the file "starthere.html" from the tablet's web browser. With this method, you can use RACHEL with any tablet (not just Android) just by using the tablet's web browser. Some tablets may not have enough built-in disk space to store RACHEL. If that's the case, you will need to include an external storage card and install RACHEL in it.

Note. RACHEL is much more than just content for a web browser as it also includes executable files. Some of these executable files may not be compatible with the Labdoo operating system. However, these additional programs do not take much disk space, and hence we recommend to leave them where they are so that schools abroad can still have the option to copy these tools to other compatible platforms and use them.

Tags: 

Installing Education Packages Using Scripts

In addition to installing the base Edubuntu education package, users are encouraged to also install a set of additional valuable education resources. These additional resources are installed by executing a set of scripts through a simple process described in this section. If you have questions or suggestions please write your messages directly in the Labdoo QA Team Wall.

List of Available Scripts

All Labdoo scripts can be downloaded from the FTP server http://ftp.labdoo.org/download/images/installskripts/
To execute a script the computer must be connected to the Internet.

Recommended scripts:

Additional helpful scripts (optional):

Scripts for special usages (usually only for experienced users):

The following steps describe how to install a script.

Step 1. Download a Script
- From a Labdoo laptop, open the web browser and go to this link: http://ftp.labdoo.org/download/images/installskripts/
- Right click with your mouse on the link of the script that you want to install.
- Select "Save link as" and save the file in the desktop of a Labdoo laptop (/home/labdoo/Desktop).

Step 2. Execute a Script
Open a terminal (press CTRL + Alt + T at the same time) and execute the following commands:

cd ~/Desktop
ls
chmod u+x ./installscript-content.sh
sudo ./installscript-content.sh

(change the script 'installscript-content.sh' for the name of the script you want to install.)

This will run the script and automatically install a new education software package.

Hint. Some scripts will ask for passwords or settings through the installation process. Please keep an eye on the screen to provide the necessary inputs.

Hint. Some scripts are fast, some need hours. It depends on the speed of your internal connection and on the speed of the laptop.

Installing Xowa Wikis

The Tool Xowa allows access to more than 800 offline wikis so that children can read knowledge content even when they don't have access to the Internet. Remember that Xowa comes already pre-installed if you use the advanced sanitation guide. Otherwise, if you used the simple sanitation guide, you can manually install Xowa using the scripts as explained in this page.

Download XOWA as a zipped file from the Labdoo FTP server

Please check first if the needed Xowa wiki bundle is available as a tar.gz file from our FTP server http://ftp.labdoo.org/download/wiki-archive/xowa-wikis/. If not, send an email to Labdoo-DACH@Labdoo.org and we will try to prepare and upload the Xowa wiki bundle you need.

Once you download the tar.gz file from the FTP server above, please unzip it into the folder ~/home/labdoo/Public/xowa/wiki. Then run the script set-rights-folder-files-Public-correct.sh from http://ftp.labdoo.org/download/images/installskripts/ (you can download this file and double-click on it) to allow access for all users.

Alternatively, if you want to download and install XOWA by yourself, there are 2 ways:

  • Version 1: only text, no pictures and no graphics (use this one if you have a small hard drive)
  • Version 2: includes version 1 plus linked pictures and graphics (recommended, as it is more user-friendly and informative, although it needs more disk space)

After you have installed Xowa, you can start it by double clicking on the Xowa starter icon that you will find in the laptop desktop.

There are 2 ways to install a specific wiki part of the Xowa suite. Scroll down the main page of Xowa, so you see "Links":

  • Import Online (supports version 1): Click in the column 'set up' on the Download link to start the download, which might last for some hours.
  • Import Offline (supports versions 1 and 2): This is the recommended method. We recommend to download by script -> select the needed wiki and language -> Category system: version 2 -> Import: click on Generate script -> repeat until your scripts contains all the needed wikis and then click on "Run script".

    A word of caution. Not every wiki is available in all languages, e.g. often wikivoyage is missing. When running an Offline Import you are able to select a non existing wiki and generate a script entry, but the script will crash when executing. So please check if a certain wiki exists first. Here is a trick on how to easily check: open 2 tabs on your browser (file -> New tab); use one tab to watch the online Import table, and the other tab to watch the offline import page; in the online page you are able to search for the needed language and wiki and quickly see if a certain wiki exists.

Matching Wiki Versions

The Xowa wikis can only be run with the same Xowa release that was used to download them. Labdoo updates Xowa every 6 months (in the beginning and in the middle of a year) to minimize the work for downloading wikis. So if you download new wikis at home and want to take a USB stick to an Edoovillage, ensure you do that with the same Xowa version that was installed in the laptops deployed at that Edoovillage.

Enabling Arbitrary Access to the Xowa Folder
Initially, only the default user 'labdoo' can access the manually installed Xowa wikis. To enable access for any other users, you can use a a script that you will also find in the desktop. This script is called set-rights-folder-files-Public-correct.sh (see this page). Please run this script every time educational content is installed in the folder /Public. The script starts without further input, runs for about 1 - 5 minutes, depending on the computer, and closes automatically.

BOKS- Community Development Classes

BOKS is a set of classes designed to help lift communities out of poverty. It involves the cumulative knowledge of doctors, nutritionists and agricultural experts who have worked among the world's poor, and pooling that information into a practical, and easy-to-use video curriculum.

Thanks to ISOM.org for granting Labdoo the right to freely distribute this curriculum with the Labdoo laptops. You can watch a brief class introductory on the video below

You may download the zip file of the classes to be installed in your Labdoo laptops; however, please do not distribute this class material otherwise without prior consents from ISOM.org directly in order to avoid violating copyright laws.

We have BOKS in 4 different languages: English, Spanish, Chinese and Swahili.

Some of the classes combine Christian teachings to help people overcome certain physical challenges; we have added a (C) in front of those classes. Please respect the laptop recipient school's cultural background and install the classes with care. Thank you!

Class Descriptions:
=================
01. BASIC HYGIENE AND HEALTH
(C)1. The Importance of Safe Drinking Water (Dr. Daniel Fountain)
(C)2. How to Build Sufficient Latrines (Dr. Daniel Fountain)
3. Water Purification and the Moringa Tree (Beth Doerr)
4. Smokeless Cooking and Alternative Fuels (Beth Doerr)
02. BASIC MEDICAL PREVENTION AND CARE
1. How to Prevent and Treat Malaria (Dr. Daniel Fountain)
2. How to Prevent and Treat Diarrhea (Dr Daniel Fountain)
3. How to Prevent HIV (Dr. Daniel Fountain)
4. Caring for Sick Patients at Home (Dr. Daniel Fountain)
5. Overview of the AIDS Problem (Dr. Carolyn Klaus)
6. AIDS Prevention, Education and Treatment (Dr. Carolyn Klaus)
7. How People Who Have AIDS, Can Live with Those Who Don't (Dr. Carolyn Klaus)
(C)8. Latrines: How to Practically Help People Who are Suffering with AIDS (Dr. Carolyn Klaus)
03. BASIC DENTAL CARE
1. A Dental Overview (Dr. Brent Wong)
2. Proper Oral Hygiene (Dr. Brent Wong)
04. FAMILY HEALTH
1. Guarding Your Family's Health through Good Nutrition (Dr. Daniel Fountain)
2. Building a Strong Marriage (Dr. Daniel Fountain)
(C)3. Healthy Sexual Behavior (Dr. Daniel Fountain)
(C)4. Teaching Children — Part One (Dr. Daniel Fountain)
(C)5. Teaching Children — Part Two (Dr. Daniel Fountain)
05. BASIC AGRICULTURE AND FARMING
1. Caring for Your Land (Dr. Daniel Fountain)
2. Overcoming Poverty through Effective Farming Techniques (Dr. Daniel Fountain)
3. Reforestation (Dr. Daniel Fountain)
4. How to Prevent Erosion from Destroying your Farm(Dr. Daniel Fountain)
5. Effective Methods for Raising Animals (Dr. Daniel Fountain)
6. Composting (Larry Yarger)
7. Rooftop Farming (Dr. Tim Motis)
06.PREGNANCY AND CHILDBIRTH
1. Pregnancy Overview (Dr. Daniel Fountain)
2. Meeting the Needs of Pregnant Women (Dr. Daniel Fountain)
3. Childbirth (Dr Daniel Fountain)
4. Overcoming Pregnancy Complications (Dr. Daniel Fountain)
07.CHILD DEVELOPMENT
1. Nutrition (Dr. Michelle Shwinandan)
2. Immunization and Hygiene (Dr. Michelle Shwinandan)
3. Infant Development (Dr. Michelle Shwinandan)
(C)4. Toddler Development (Dr. Michelle Shwinandan)
08. THE FEMALE REPRODUCTIVE CYCLE
1. Menstruation (Dr. Vanessa Reynolds)
2. Menopause (Dr. Vanessa Reynolds)
09. FOUNDATIONS and STRATEGY FOR DEVELOPMENT
1-4. The 10 Seed Principle (4 sessions) (Dr. Ravi layakaran)
10. EFFECTIVE LIVESTOCK CARE (English Version Only)
1. Pens and Grazing Locations (Dr. Peter Quesenberry )
2. Clean Living Conditions (Dr. Peter Quesenberry )
3. Disease Prevention (Dr. Peter Quesenberry )
4. Examination of a Cow (Dr. Peter Quesenberry )
5. General Livestock Examination (Dr. Fred Gardner)
6. Animal Restraint Techniques (Drs. Quesenberry/Gardner)
7. Wound Treatment (Drs. Quesenberry/Gardner)
8. Internal and External Parasites (Dr. Peter Quesenberry )
9. The Basics of Animal Nutrition (Dr. Peter Quesenberry )
10. Fractures and Lameness (Drs. Quesenberry/Gardner)
11. Making Local Medicines (Dr Jean Reed)
12. Emergency First Aid (Dr Peter Quesenberry )
13. Working with the Local Community (Dr Jean Reed)

Installing Wikipedia for Schools

Introduction

Wikipedia for Schools is a free subset of educational wikipedia content for children and schools. It follows the British curriculum for schools and is available in the languages of English (Release 2008 and 2013), Spanish, French and Portuguese. The English wikipedia for schools is part of the English RACHEL collection too.

Wikipedia for schools occupies about 6.5GB of disk space, except for the English Release 2008 which occupies about 2.5GB.

To install Wikipedia for schools, first download the package into your local disk. You can download the file in the required language from the Labdoo FTP server at http://ftp.labdoo.org/download/wiki-archive/. Open the language folder you need (e.g. EN for English) and download the archive *wikipedia_for_schools* you need.

Installing Wikipedia for schools on a Labdoo laptop

Once you have downloaded the file, unzip it in the folder /home/labdoo/Public/wikis (the downloading and unzipping operations could take some time depending on the speed of your network and computer). Once unzipped, double click on the file file /home/labdoo/Public/wikis/xx/xx-wikipedia-for-schools/index.html (where xx is the country / language code ) to open a web browser that will take you to the initial page of wikipedia for schools.

To make access easier, we recommend to make the default web browser page point to the Wikipedia for Schools initial page. For that, open the web browser (this instructions are for Firefox but similar steps apply to other browsers) and go to File => Open File [ navigate to /home/labdoo/Public/xx/xx-wikipedia-for-schools/index.html ] => Open. Then go to Edit => Preferences [ opens a window for the settings, click on "Use current Pages" and close the tab "Preferences" ] . Please repeat any of the configuration steps for both the 'labdoo' and the 'student' user accounts that come with the Labdoo computer.

Overview Educational Content FTP Server

This page will find an overview and a list of available educational content in various languages, which can be downloaded from our FTP server http://ftp.labdoo.org/download/wiki-archive.

Most educational content was taken from KHAN Academy and RACHEL project. Beside some manuals and video tutorials the Labdoo images for cloning come without any content! So you are able to choose and install the best content for your school / project, depending on the language(s) spoken, age, request and size of your disc drive.

Of cause you can also browse through the above mentioned World Possible web-site and download the content you need using rsync tool. But not everybody knows how to use that tool. We prepared the content, which can be viewed in any browser easily, but dropped the content, needing a server or database installation.

Preparation

  • Create a folder according the language(s) you need, e.g. /home/labdoo/Public/wikis/EN for English and so on,
  • Download the index-file from and into the language folder you are working on, e.g. /home/labdoo/Public/wikis/EN/index-en.html,
  • open this index-file in a tab of the browser of your choice, e.g. Firefox, and save the tabs in the settings of your browser, so it will be opened and shown to the students at a school when starting the browser.

Download archive(s) and unzip to content folder

  • Download and unzip the archive(s) to the folder /Public/wikis/xx (xx = language code, e.g. EN, DE, FR, ES etc.) of user labdoo. You can download the archive(s) you need, just right mouse click and "save as",
  • unzip here and delete the archive, once it is unzipped.
  • When you run several installation please save the archives on a local server or external USB disc drive, so you do not have to download each time each file again.

Due to the amount of the content you have to pre-select the content you are going to install, may-be discuss the best content with the school or project partner. Or you copy the archives to an external device and the traveller/dootripper takes it to the school, so they can decide on site which content to use best.

[An installation tool to allow an easy content installation is under development, but not available yet.]

Wiki/Content folder http://ftp.labdoo.org/download/wiki-archive

RACHEL / wikis collection

The Labdoo team and users would like to thank the Khan Academy and Worldpossible.org for publishing the OER Open Educational Resources. In case of any question please send a mail to Labdoo-DACH@Labdoo.org, thank you.

Ubuntu Software Center

You can also install additional applications directly from your computer by using the Ubuntu Software Center. Once your laptop is booted, log in and click on the menu icon, then click on 'System Tools' and then select 'Ubuntu Software Center'. (This path could be slightly different depending on the version of your Ubuntu/Lubuntu system.) This will open a search engine from where you can look for thousands of applications and from where you can download and install the ones you select. Enjoy the many free educational applications that you will also find in this software data base!


Figure. Install new applications by going to the Ubuntu Software Center.
(This view could be slightly different depending on the version of your Ubuntu/Lubuntu system.)

List of Countries Voltages and Power Plugs

Different countries have different power plugs and voltages. One good news is that practically all (if not all) portable computers (laptops, tablets, etc.) accept all voltage inputs. So the only adapter that we need to consider when contributing a dootronic is the power plug needed in the destination school. Unlike voltage adapters, power plugs are just mechanical, and so they are very inexpensive (between $1 and $3 typically). Because it is difficult to tell where each dootronic will be destined, the general rule is that the responsibility to acquire the power plugs falls under the recipient school and the NGO or organization which is supporting it.

In the following list you will encounter the specifications of the power plugs and voltages for each country.

countries voltage (V) power plug
A
Afghanistan 220 G
Algeria 127/220 B, G
American Samoa 120/240 A, C, K, M
Angola 220 B
Anguilla 240 D
Argentina 220 B, C
Aruba 115/127 A, B, G, K, M
Australia 240 C, N
Austria 220 A, B
Azores 220 B, G
B
Bahamas 120 K, M
Bahrain 220 D, G
Bangladesh 220 B, G
Barbados 115 K, M
Belgium 220 B, F
Belize 110 K, M
Benin 220 G
Bermuda 120 C, D, K, M
Birma 230 D, G
Bolivia 110-115/220 A, B, K, M
Bosnia Herzegovina 220 A, B
Botswana 220 D, G
Brazil 110-220 B, K, M
Bulgaria 220 A, B
Burkina Faso 220 B, N
Burundi 220 A, B, F
C
Cambodia 120/220 B
Cameroon 220-230 B, F
Canada 120 K, M
Canarian Islands 220 B, F
Cape Verde 220 A, B
Channel Islands 240 B, D
Chile 220 B, I
PR China 220 B, C
Christmas Island 240 C
Columbia 110-220 B, M
Cook Islands 240 C
Costa Rica 120 K, M
Cyprus 240 D
D
Danmark 220 B, E
Dominica 230 D
Dominican Rupublic 110 K, M
Dschibuti 220 B, F
E
Ecuador 120 B, K, M
Egypt 220 B
El Salvador 115 K, M
Equatorial Guinea 220 B
F
Fidschi 240 C
Finnland 220 A, B
Frankreich 220 B, F
Französisch-Guayana 220 B, F
G
Gabun 220 B, F
Gambia 220 D
Germany 220 A, B
Ghana 220 B, D, G
Gibraltar 240 B, D
Grenada 230 B, D, G
Greece 220 A, B
Greenland 220 B, E
Great Britain 240 D, G
Guadeloupe 220 B, F
Guam 110-120 K, M
Guatemala 120 K, M
Guayana 110 B, D, G, K, M
Guinea 220 B, F
Guinea-Bissau 220 A, B
H
Haiti 110-250 K, M
Honduras 110 K, M
Hongkong 200 D, G
Hungary 220 A
I
India 220-250 B, G
Indonesia 220 A, B
Isle of Man 240 B, D
Iran 220 A, B
Ireland 220 A, D
Island 220 A, B
Israel 230 A, H
Italy 220 B, I
Ivory Coast 220 B
J
Jamaica 110 K, M
Japan 100 J, M
Jemen 220 B, D, G
Jordan 220 A, B, D
K
Kaiman Islands 120 K, M
Katar 240 D, G
Kenya 240 D, G
Kokos Islands 240 C, N
Kongo 220 B
Korea 100/220 A, K, M
Kroatia 220 A, B
Kuwait 240 B, D, G
L
Laos 220 B, K, M
Lesotho 240 B, G
Libanon 110-220 B
Liberia 120 D, M
Libyia 127-230 G, I
Liechtenstein 220 L
Luxemburg 220 A, B
M
Macau 220 B, G
Madagaskar 220 B, F
Madeira 220 B, G
Malawi 230 D
Malaysia 240 D
Maldivea 230 G
Mali 220 B, F
Malta 240 D
Marianen Islands 115 K, M
Marocco 220 A, B, F, G
Martinique 220 B, F
Mauretania 220 B
Mauritius 230 B, D, G
Mexico 127 K, M
Monaco 220 B, F
Mongolia 220 B
Montserrat 230 D, K, M
Mosambique 220 A, B
N
Namibia 220-250 G
Nepal 220 G
Netherlands 220 A, B
New Caledonia 220 B, F
New Zealand 230 C, N
Nicaragua 120 K, M
Niederlänische Antillen 120-127/220 A, B, K, M
Niger 220 B
Nigeria 230 D, G
Norfolk-Inseln 240 C
Norway 220 A, B
O
Okinawa 100-120 M
Oman 240 D, G
P
Pakistan 230 B, G
Panama 110-120 K, M
Papua-Neuguinea 240 C, N
Paraguay 220 B
Peru 110/220 K, M
Philippines 115 B, K, M
Pitcairn Islands 240 G
Poland 220 A, B
Portugal 220 A, B, G
Puerto Rico 120 K, M
R
Ruanda 220 B
Romania 220 A, B
Russia 220 A, B
S
Saint-Pierre 115 K, M
Sankt Christopher-Nevis 230 D, G
Sankt Lucia 240 D
Sankt Vincent 230 D
Saudi Arabia 127/220 A, F, K, M
Sweden 220 A, B
Switzerland 220 B, L
Senegal 220 F
Seychelles 240 D, G
Sierra Leone 230 D, G
Singapur 230 B, D, G
Slowakia 220 A, B
Slowenia 220 A, B
Somalia 110/220 B, F
Spain 220 B, F
Sri Lanka 230 G
South-Africa 220-250 G
Sudan 240 A, B, D
Surinam 110/220 A, B, K, M
Swasiland 230 G
Syria 220 B
T
Tahiti 220 F
Taiwan 110 K, M
Tanzania 230 D, G
Thailand 220 B, K
Togo 220 B, F
Tonga 115 C, G
Trinidad Tobago 115/230 D, G, M
Tschad 200 A, F
Tschechian Republic 220 B, F
Tunesia 220 B
Turkey 220 A, B
U
Uganda 240 G
Uruguay 220 B, C
United States (US) 120 K
V
Venezuela 220 K, M
V.A.Emirate 220 D, G
Vietnam 120/220 B, F, M
Virgin Islands 120 K, M
W
West-Samoa 230 C
Z
Zambia 220 D
Zentralafrik. Rep. 220 B
Zimbabwe 220 D, G

Connect to Labdoo FTP server

Labdoo FTP server allows users to download useful documents and images for Labdoo devices. Many thanks to i2cat's support; it is hosted at its office in Barcelona .

There are several different ways to connect and download files from the Labdoo FTP server. Here are a few simple ways.

Browser

Open a internet browser (URL: http://ftp.labdoo.org/download/ ) (Make sure the URL begins with “http://” and not “ftp://). All the files underneath this level is license free to be downloaded.

To Download a file, right click its link and store it by clicking on "Save link as ..." (It is possible the name may be different depending on the type of internet browser and operating-system you use).
Pro: Easy access without needing other software or password;
Con: Files can only be downloaded one by one, not in a bulk.

Connect to the FTP server

It is easy to connect your PC or local server to the FTP server with ftp tools if you need to download massive files. Depending on the operating system, there are free tools available such as Filezilla or rsync. Many NAS / local server / local storage systems also offer a way to connect and synchronize files to your local storage. New modifications on files will be mirrored automatically. In some file systems, you are able to link/mount external FTP servers as a drive.

The user account is username: labdoo and the password is: labdoo. This user is not able to change or delete files, but can download them. If you need other privileges to write files, please contact us and explain your purpose at contact@Labdoo.org.

Settings for Filezilla

Server = ftp.labdoo.org/download/
User = labdoo
Password = labdoo
Protocol = sftp

You may also change the start directory in the Filezilla by going to settings → Advanced → directory. By changing the start directory, you won't need to click through the directory tree every time when you login.

Connecting using a file explorer

In case of any questions, please email us at contact@Labdoo.org, Thank you!

Tips and Tricks, Suggested Solutions

The following section describes relevant learning experiences gained by Labdooers around the world who (like you) are helping to sanitize laptops and make them ready for needy schools. It will teach you tips and tricks that will be very handy when sanitizing your laptops. If you are not able to find a solution to your problem in this section, please ask your questions to the Labdoo QA team and another Labdooer there will provide an answer for you.

Delete All Data on Hard Disk

We want to ensure all data stored in every donated computer is properly erased before installing the new operating system. Therefore learning how to properly erase the hard drive is the first step in the laptop sanitation process.

You have 2 options to completely wipe out all previously stored information in the computer (user information as well as all the previously installed softwares and operating system)

Method1: Using Lubuntu disk

  1. Boot your laptop with your Lubuntu disk (see the simple sanitation guide to learn how to create a Lubuntu disk)
  2. On the Lubuntu menu, select the option 'Try Lubuntu'. This will start Lubuntu on the laptop.
  3. Once booted, press at the same time the keys ALT+CTRL+F3. This will take you to a terminal console.
  4. In the terminal console, type the following command to ensure that the shred application is available:

    apt-get install coreutils

    (you need to have your laptop connected to the Internet for the above command to succeed)

  5. Now type the next command:

    sudo shred /dev/sda -f -v --iterations=2

    If this command does not work, you can try with 'hda' instead of 'sda', like this: sudo shred /dev/hda -f -v --iterations=2.

  6. Now wait for about an hour or so for the previous command to complete. At the end of this process, the laptop hard drive will have all of its previous data fully removed. You can now press ALT+CTRL+F7 to return back to the Lubuntu initial screen and turn off the laptop.

Method 2: Using Parted Magic disk

  1. Boot your laptop with Parted Magic disk (see Advanced Method(Without Network) to learn how to create a Parted Magic disk)
  2. Once booted, click on the bottom ROXT Terminal (xterm icon on the lower right) This will take you to a terminal console.
  3. In the terminal console, type the following command to ensure that the shred application is available:
    sudo shred /dev/sda -f -v --iterations=2

    If this command does not work, you can try with 'hda' instead of 'sda', like this: sudo shred /dev/hda -f -v --iterations=2.

  4. Now wait for about an hour or so for the previous command to complete. At the end of this process, the laptop hard drive will have all of its previous data fully removed. You can now shutdown the laptop from Parted Magic window.
Tags: 

Adapt Bluetooth's Name (Optional)

If you sanitized your laptop via the advanced method, then due to the cloning process, the name of the laptop's bluethooth device will be identical to all clones. To assign a unique name to your device, run the following command on a terminal:

sudo hciconfig hci0 name ’labdoo-XYZ-0'

Where XYZ is the Labdoo ID of the laptop.

Add a 2nd Disk Drive

If the installed hard disk becomes too small and the computer allows the installation of a 2nd disk, you can configure such 2nd disk to mount automatically during booting time. To do so you have to:

  • Press ALT+CTRL+T at the same time to start a terminal, and type the following command to initiate the file manager in superuser mode: sudo pcmanfm & (enter).
  • Navigate to the folder /mnt and create inside it a new folder with the name of the 2nd disk.
  • Get the UUID (ID of the disk-drive) of the 2nd disk by typing the command sudo blkid, search for your 2nd drive in the list and write down its UUID.
  • Type the following command to edit the fstab file: sudo nano /etc/fstab [Enter]
  • Add at the end of the fstab file a new line as follows (in one single line):
    UUID=[add here the UUID of the 2nd disk you wrote down above]
    /mnt/[add here the name of the 2nd disk folder you created above] auto defaults 0 0

    (Make sure to leave a space character between each entry)
    Leave the file editor by pressing CTRL+X then Y (to save) and [Enter].
  • Optionally, to allow access for all users to your 2nd disk do as follows: Open your file manager in superuser mode again sudo pcmanfm &, go to your 2nd disk folder and right click on it with your mouse. Under properties, select "Access rights for others", check the "Allow create or delete new files / folders", and then "Apply to all folders".

Re-boot your computer. The new disk should be automatically mounted.

Add a Local Printer as Network Printer

If you have a printer directly connected to your Labdoo computer (via USB or a Centronics cable), you can share access to the printer from other computers via a local network. To do so you need to use CUPS (Common Unix Printing System) as follows.

Configuring the Labdoo computer attached to the printer:

  • Open the web browser and type the URL address http://localhost:631
  • On the admin page http://localhost:631/admin/ select “Share printers connected to this system”.
  • Select under ”Printers” the connected printer.
  • Click on the menu “Administration” and on “Printer”.
  • Leave “Actual connection” unchanged → Proceed → select “Allow access to this printer / share”.
  • Optional: add a name for the place of installation → Proceed → Change settings.

Showing the printer on other Labdoo computers connected via the network:

  • Open the web browser and type the URL address http://localhost:631/admin
  • Select the option “Show printers shared by other systems” → Change settings.

After this you should see the printer in the menu “Printer". Maybe you have to wait a little bit before the printer is shown or re-load the page http://localhost:631/admin/.

Configuring the Bios

How to change the booting order of a laptop from the bios

BIOS (Basic Input Output Subsystem) is a programmable chip that controls how information is passed to various devices in the computer system. A typical method to access the BIOS settings screen is to press ESC, F1, F2, F8 or F10 right after you start your computer.

BIOS settings allow you to run a boot sequence from a hard drive, a CD-ROM drive, the network, or an external device. You may configure the order that your computer searches these physical devices for the boot sequence.

The first device in the order list has the first boot priority. To install the Labdoo software you will need to ensure the CD-ROM, the USB or the network (depending on which method you use to install the software) are given the highest booting priority.

Note: in the case of a USB installation, before you set boot priority for the USB device, plug the device into a USB port to ensure the BIOS will be able to detect it.

To specify the boot sequence:

  1. Start the computer and press ESC, F1, F2, F8 or F10 (depending on the BIOS manufacturer, try them all if needed) multiple times during the initial startup screen. A menu may appear.
  2. Choose to enter BIOS setup. The BIOS setup utility page appears.
  3. Use the arrow keys to select the BOOT tab. System devices appear in order of priority.
  4. To give the CD/DVD, the USB or the Network the highest boot sequence priority, move such device to the first position in the list.
  5. Save and exit the BIOS setup utility.
  6. The computer will restart and will initiate its booting process by looking first at the device you gave the highest priority, allowing you to install the Labdoo software.

Figure. Illustration of the BIOS boot menu where you can change the booting order.

Troubleshooting potential issues with the bios.

In some rare cases the BIOS could be reset during the process of deleting the hard drive information from the system, or some times older laptops do not support internal and/or external USB keyboards during the booting process. It might happen that you are not able to use the arrow keys (up, down, right, left) to configure the BIOS. In such cases the USB control (and sometimes the internal keyboard) was deactivated. A possible solution is to connect an external PS/2 or USB keyboard, and continue to install or adjust the BIOS.

DKMS (Automatically Driver Updates)

Dynamic Kernel Module Support (DKMS) is a program/framework that enables generating Linux kernel modules whose sources generally reside outside the kernel source tree. The concept is to have DKMS modules automatically rebuilt when a new kernel is installed.

An essential feature of DKMS is that it automatically recompiles all DKMS modules if a new kernel version is installed. This allows drivers and devices outside of the mainline kernel to continue working after a Linux kernel upgrade.

To install DKMS, do as follows:

- Open a terminal by pressing at the same time the keys ALT + CTRL T
- Type in the following command:
sudo apt-get install build-essential dkms [Enter] + [Password] + [Enter]

Note: DKMS is already installed if you cloned a laptop using the advanced method or if you used the installscript-software.sh.

Check for Disk Errors with GSMART

To check whether a disk has potentially any errors, you can use the Lubuntu tool GSMART. Since it is not installed by default, it must be installed via the Ubuntu Software Center. Select GSMART and install it. After installation, start it and initiate a check. This software includes a quick check (about 10-20 minutes) or a detailed check (about 30 - 60 minutes).

In case you want to check multiple disks, you can use a hard disk adapter. The adapter should support IDE and/or SATA via a USB connection to your laptop.

Installation of Restricted Codecs

Please notice that the usage of restricted codecs might depend on local laws. It might be illegal in some countries to install and use certain codecs (commercial/proprietary third-party packages) and multimedia extensions. Check your local regulations first prior to proceeding with the installation of the following software.

As in all software for Ubuntu, there are two ways to do the installation: via the Ubuntu Sofware Center or via the command line.

The installation via the Ubuntu Software Center is as follows. Open the Ubuntu Software Center (or the Synaptic Package Manager) and search for "restricted codecs". Select the package found and click on install. During the installation you will need to accept an EULA license agreement. To have full support to watch DVDs you must also install libdvdcss2 and non-free-codecs from the Medibuntu Repository. Please notice that in Europe these repositories are not allowed to be used. Further information can be read here: http://www.videolan.org/developers/libdvdcss.html

The same installation can be done via the command line through the following steps. Open a terminal by pressing at the same time the keys ALT+CTRL+T. Then type the following commands:

sudo apt-get install ubuntu-restricted-extras -y (Enter)
sudo apt-get install non-free-codecs -y (Enter)
sudo apt-get install curl -y (Enter)
curl ftp://ftp.videolan.org/pub/debian/videolan-apt.asc | (Enter)
sudo apt-key add -echo "deb ftp://ftp.videolan.org/pub/debian/stable ./" | (Enter)
sudo tee /etc/apt/sources.list.d/libdvdcss.list (Enter)
sudo apt-get update (Enter)

Enhanced Intel Graphical Interface

If you have a computer with an Intel graphical interface, there is a cool free tool by Intel Graphics for Linux that you can install, check it out: https://01.org/linuxgraphics/

To install it do as follows:

  • Open Firefox and go to https://01.org/linuxgraphics/downloads
  • Depending on the Ubuntu release (version 32 or 64 bits) download the matching software and install it.
  • Once installed, find the newly installed application and run it. It will guide you through the process of configuring your system for Intel Graphics. Once done, you will need to restart your computer to load the new configuration.

Kernel Panic Caused by Defective in Memory/RAM

If the computer crashes often during the boot process, there is a possibility that it is because of a defective memory (RAM) module. (There could be other reasons too naturally).

To check if the RAM module is working properly (memory modules) do as follows:

  • Boot the system and press SHIFT at the same time.
  • The GRUB menu will show up. Click on Memtest86 (memory test).
  • The system will perform a memory test. At the end of this test, the defective parts (if any) will be listed and marked in red.

Hint: To know exactly which memory module is defective, you can remove all memory modules and check each of them individually by running the above test.

Wired LAN Interface is Not Working

In some systems, the wired (cable) LAN interface may not be recognized. The symptom is that the interface shows up when you click on the network manager icon but it shows as deactivated. To get it to work, try the following:

  • Open a terminal by pressing ALT+CTRL+T and type the following command: sudo nano /etc/NetworkManager/NetworkManager.conf
  • Check and change this line: managed=falsemanaged=true
  • Save the file and restart the network manager: sudo service network-manager restart

LXDE - Create a link to folders or files

To create a symbolic link:

Using the file manager. Open file manager PCMan, click on the folder or file, press CTRL+SHIFT and click on the folder/file at the same time, then drag and move it to the desktop or the location where you want to create the symbolic link.

Using a terminal. Open a terminal by pressing ALT+CTRL+T and type:

ln -s -t [path to location where you want to create the link] [folder or file that you want to link] (Enter)

For example: ln -s -t /home/labdoo/Desktop /home/labdoo/Public/videos

More information at: http://wiki.ubuntuusers.de/PCMan_File_Manager

MD5 Checksums

MD5 is a common way to calculate checksums to test if a file was downloaded correctly. You can read more about MD5 here http://en.wikipedia.org/wiki/MD5.

In the folders of your unzipped Labdoo images for cloning you will find a file MD5SUM. Use these files to check if the downloaded images are healthy and not corrupted by the download process as follows.

Check that the downloaded images are correct:

  • Open a Lubuntu terminal
  • Navigate to the folder where the files are located cd ...(path) [enter]
  • Execute the commandmd5sum -c MD5SUM [enter]

Create MD5 checksums:

Open a terminal in the folder with the files and execute in a terminal
md5sum * > MD5SUM (Enter)

16.04 LTS does not boot, graphic resolution on screen low

When you start (L)Ubuntu 16.04 LTS the first time in some cases it will not boot correctly. Boot process will stop. But you will be able to start using the "Recovery Mode". In other cases the laptops starts, but the resolution on screen is very poor (often 640 x 480 pixel). Both can be (often) solved:

Computer will not boot (hangs, black monitor)

  • Keep the Shift-button pressed when turning laptop on, press again after the BIOS messages shown, until the Grub menu is shown (GRUB controls the start process). You will also see the GRUB menu if power (I/O) is turned off during a start process.
  • Select "advanced options" and a Linux-Kernel and "Recovery-Start", just accept the next entries (press Enter) and log-in as labdoo user.
  • Open a terminal and type sudo nano /etc/default/grub (Enter). This will open the GRUB configuration file. If you are not familiar with the nano editor can use leafpad instead sudo leafpad /etc/default/grub (Enter)
  • First approach: Search for the line GRUB_CMDLINE_LINUX_DEFAULT="quiet splash" and change it GRUB_CMDLINE_LINUX_DEFAULT="nomodeset splash". Store and end editor (using nano editor by typing STRG/CTL and the letter o, then press Enter, next type STRG/CTL and x)
  • Then open a terminal and type sudo update-grub (Enter). This will finally store the changes made within the GRUB configuration.
  • Reboot computer. Often the computer will start now and you will see the user log-in.

Computer does not boot or graphical resolution is wrong

If the graphical resolution is wrong (usually too low) or if the computer will not boot, even you tried the hint above, try:

  • Open a terminal and type sudo nano /etc/default/grub (Enter). This will open the GRUB configuration file. If you are not familiar with the nano editor can use leafpad instead sudo leafpad /etc/default/grub (Enter)
  • Search the line # GRUB_GFXMODE=640x480 and remove "#" at the beginning of the line. Change the pre-set resolution of "640x480" in the setting you need for the graphic resolution. Important: you may only use a resolution supported by your video card! You can get the possible resolution(s) as follows using the (L)Ubuntu desktop or Parted Magic:
    • (L)Ubuntu Desktop: Menü Auswahl Preferences (Einstellungen) → ARandR → Outputs (Ausgabegerät) → default → Resolution (Auflösung) → zeigt die möglichen Auflösungen an
    • Parted Magic:
      • (L)Ubuntu Desktop: Menu, select Preferences → ARandR → Outputs → default → Resolution → will show available settings for resolution
      • System Profiler → Display → Resolution
  • Store the modification and end editor.
  • Then open a terminal and type sudo update-grub (Enter). This will finally store the changes made within the GRUB configuration.

Having made these changes you have a good chance to start your laptops using (L)Ubuntu 16.04 LTS, showing a good resolution on screen.

Change keyboard layout when logging in (Boot)

The Image for Cloning "remembers" the keyboard layout of the computer, on which the image was generated. Usually Images are produced on computers having a German keyboard - sorry for that :( When you start a computer with a different keyboard layout you might have a problem to log-in properly. You are able to change the keyboard layout for each user after logging in. But that will not solve the problem. First you have to log-in and next you have to change a system setting.

Here is the layout of a German keyboard so you should be able to find the letters labdoo (our standard password to log-in). After logging in you should change the keyboard layout first and next change the keyboard system setting.

For LXDE/MATE and Log-in (Light-DM)

Having booted you are able to log-in. The computer will get the keyboard layout of the file /etc/default/keyboard. You change it as follows:

  • Open a terminal,
  • type sudo nano /etc/default/keyboard and press (Enter)
  • in the terminal window search for the line XKBLAYOUT="de"
  • change de to the keyboard layout you need e.g. en, fr etc.
  • optional: Changing the next line XKBVARIANT="" you can add a country specific keyboard layout (e.g. "ch" für eine deutsch-schweizer Tastatur de-ch or a special Spanish variant etc.)
  • Save modified file (Ctl/Strg + O (enter), close terminal by pressing Ctl/Strg + X)

Important: The keyboard layout for the users labdoo or student will not be changed by this setting. After logging in you can change the user keyboard as described here https://www.labdoo.org/content/post-installation-configuration.

Monitor is only showing a small part of the full screen

The installation process was successful and you are able to boot, but when logging in you are only able to see a part of the screen (usually the upper right screen corner) with a poor resolution.

This could be because in the BIOS setting not enough RAM was allocated for the screen memory, e.g. 1 MB instead of 8 MB or more. Please check the bios and increase the memory allocated for the screen memory if necessary.

Windows look-alike user interface

For the explained reasons and advantages, Labdoo uses the Linux operating system. However, some users prefer a graphical user interface (GUI) which looks like Windows so that the learning curve for some users is even lower. In this page you will find a guide on how to install and configure the Lubuntu GUI to look similar to Windows.

Those using Labdoo Images for Cloning can stop reading here, as the images are coming with pre-installed Windows 10 themes and icons that can be activated.

Installation

Windows 10-look alike user interface might be for instance downloaded from here:

Unpack the archive and move the files using superuser rights to these two folders (you can open a terminal with ALT+CTRL+T and then type sudo pcmanfm [enter] to open a file browser from where you can move the files):

  • Move themes to /usr/share/themes
  • Move icons to /usr/share/icons

Check the rights to access and update them, if needed (right click on the file, and select Properties → Permissions → View = anyone; change = only owner; Access = anyone).

Activate

In order to activate the new themes, click on the Lubuntu-start button on the left bottom corner of the screen and select Preferences → Customize Look and Feel → select in the tab widget the Windows theme → click on the icon theme and select Winx-x.x.x → close the window.

To undo / switch back to the default Linux theme just select another theme (Lubuntu-default) and icon theme (Lubuntu) or other layouts that you may like.

NTP - set clock automatically via internet

The tool to be installed is named NTP – Network Time Protocol (open a terminal: sudo apt-get install ntp → Enter or alternativ via the software center) for Network Time Protocol.

You don't have to adjust anything else. The time is taken from web server. You are able to define time zone and server. Online access is needed.

NTP is already part of the Labdoo images and install scripts.

NVIDIA grafical drivers, problems and solutions

  1. If a computer is not able to boot and if you are not able to log-in sometimes you are still able to have access via terminal:
  2. Either using CTL+ALT+t (if logged in), CTL+Alt+F3 or follow the GRUB information using the recovery mode:
    sudo apt-get purge nvidia-current (Enter)
    sudo apt-get install linux-headers-generic (Enter)
    Reboot.

  3. Preferences --> Additional Drivers --> wait a while and if proprietary drivers are offered for downlaod.
  4. NVIDIA driversfrom PPA (source) of developer community
  5. Herefor you have to add an additional source for software (PPA). Please be aware of potential risks of adding sources (PPA) to your computer:

    CTL + ALT + F3 (in recovery mode) or CTL + Alt + t if logged-in opens terminal

    log-in as user labdoo and password labdoo,
    sudo su (enter) + Passwort labdoo eingeben (enter)

    To add PPA for Ubuntu 14.04 / 13.10 / 13.04 / 12.10
    sudo apt-add-repository ppa:xorg-edgers/ppa (enter)

    To add PPA for Ubuntu 12.04 / 11.10 / 11.04 / 10.04
    sudo apt-add-repository ppa:ubuntu-x-swat/x-updates (enter)

    and:
    sudo apt-get update (enter)
    sudo apt-get install nvidia-current nvidia-settings (enter)
    sudo reboot (enter), um Laptop neu zu starten.

  6. If your computer is older (built before 2004) it does not make sense as this card is not supported anymore. It is worth a try to use either Lubuntu 12.04 LTS or to use the Labdoo Image for cloning for Lubuntu 12.04 LTS.

Open a terminal

Often you will read "open a terminal". Here is explained how to do so:

Either press at the same time the 3 keys CTL + Alt + t.

Or alternatively → System tools → click on UXterm or XTerm

The terminal window will be shown.

At the beginning of each line you can read name of the user @ name of the laptop, e.g. labdoo@labdoo-000004xxx. You are now able to type in your comands.

When executing a command line wait until you see again this beginning of a line.

To close a terminal either type “exit” → Enter eingeben, when the command is proceeded.

During the installation process of Lubuntu or during the boot process you are able to press CTL + Alt + F3 and you get access to the terminal level. Using CTL + Alt + F7 you get back.

Remove former Linux kernel releases

If you update to newer linux kernels the old kernels stay on the disc. Each kernel need about 60 - 140 MB. To remove them you have to open a terminal:

To rmeove former Linux kernels execute in a terminal:

sudo dpkg -l | grep linux-image (Enter)

The result should look like

ii linux-image-3.2.0-31-generic 3.2.0-31.50 Linux kernel image for version 3.2.0 on 64 bit x86 SMP
ii linux-image-3.2.0-32-generic 3.2.0-32.51 Linux kernel image for version 3.2.0 on 64 bit x86 SMP
ii linux-image-3.2.0-33-generic 3.2.0-33.52 Linux kernel image for version 3.2.0 on 64 bit x86 SMP
ii linux-image-generic 3.2.0.33.36

In this example you might delete the kernels 3.2.0-31 and 3.2.0-32 (the numbers might differ from your list, please exchange). The last 2 kernels with the higher release numbers shoud remain:

sudo apt-get remove --purge linux-image-3.2.0-31-generic (Enter)

Search files in all folders and delete them (optional)

Open a terminal (CTL + Alt + t) and execute

only to search and list: find ./ -type f name „Dateiname“ (Enter)

search and delete: find ./ -type f name „Dateiname“ -delete (Enter) (Be careful!!!)

Installation of VirtualBox

When you are installing VirtualBox the first time manually please follow these steps (if you are cloning you can ignore this wiki page):

After having installed VirtualBox you have to add the matching Extension Pack. Important: Please make sure that the release number of VirtualBox and Extension Pack are identical! For this purpose, start VirtualBox (either using the icon on the bottom left Lubuntu --> Run --> virtualbox (Enter) or by Accessories --> VirtualBox) and open Help --> About VirtualBox to see the release-no. of VirtualBox. Next step is to open File --> Preferences --> Extensions to see the release-no. of the Oracle VM VitualBox Extension Pack. Both must match, if not please follow the steps explained below.

Update, Update to a higher VitualBox release number

If the VirtualBox is only patched without upgrading to a higher version n further actions have to be taken. In longer intervals the (L)Ubuntu distribution upgrades VirtualBox to a higher version number (most recently in December 2015 to 4.3.34). In such a case, the Extension Pack will not automatically be updated. For this purpose, proceed as follows:

    To Update the Extension Pack
  • open as described above File --> Preferences --> Extensions and delete the former installed Extension Pack (click on the blue square with the red X)
  • Then download the matching Extension Pack from here https://www.virtualbox.org/wiki/Downloads, "Open with VirtualBox", and follow the steps to install it, ready
    Update of the iso-file for the virtual machines (VM)
  • To add the Extension Pack to a virtual machine itself you have to update a file in a system folder:
  • Open http://download.virtualbox.org/virtualbox/ and navigate to the sub-folder, which matches with the release no. of your actual VirtualBox,
  • download the file VBoxGuestAdditions_x.x.xx.iso (x.x.xx is actually 4.3.34) (it will be stored in the folder home/labdoo/Downloads),
  • open a terminal and type gksu pcmanfm (Enter and password) to start the file-manager as super-user (you need that to modify system folders, be careful),
  • navigate to the folder /home/labdoo/Downloads and change the name of the downloaded iso-file to VBoxGuestAdditions.iso (remove the version no. from the file name),
  • open a 2nd tab in the file-manager (click on the "+" within a frame in the left upper corner), navigate in the 2nd tab to the folder /usr/share/virtualbox/. Here you will be only able to write, if you started the file-manager as super-user.
  • Now copy the file VBoxGuestAdditions.iso from the folder /home/labdoo/Downloads into the folder /usr/share/virtualbox/ and overwrite the former iso-file. Ready, now everything is prepared to add the Extension Pack to a virtual machine (VM) in the future on this computer.

WiFi cards will not be detected

1. Initial Considerations.

Before you check for the cause of a non-functioning wireless card (WiFi) please check that:

  • The wireless LAN (WiFi) function is properly activated via the hardware switch/slider (often on one side of the laptop) or via a function key on the computer keyboard,
  • There is a wireless card (WiFi) installed (often we get laptop donations without a wireless card), see below Check which WiFi chip is installed and check the manufacturer name. In case there is no WiFi card installed you can add one or use a connection via LAN (cable).

Sometimes older or very new WiFi Cards are not recognized automatically. The following check list provides a set of steps that you can try to fix this situation.

2. Check list.

  • Check if specific drivers are needed
  • Preferences → Software & Updates → Additional Drivers → wait a while
    → either "no additional drivers available" is hown → no further action should be needed, or
    → a list of availble drivers is shown → click the driver you want to use → Apply Changes

  • Check which WiFi chip is installed and check the manufacturer name
  • Open a terminal and execute:
    lspci | grep -i net (enter)
    or
    to show chip set and manufacturer:
    lspci -nnk | grep -i net -A2 (enter)
    or in case of using an USB Wifi stick:
    lsusb (enter)
    Note: Some build-in WiFi cards are recognized as an external USB, so if in doubt try also these commands.

    To check if your WiFi card is supported:
    https://help.ubuntu.com/community/WifiDocs/WirelessCardsSupported
    http://linux-wless.passys.nl/
    http://wireless.kernel.org/en/users/Devices
    http://wiki.ubuntuusers.de/WLAN/Karten
    http://wiki.ubuntuusers.de/Systeminformationen_ermitteln?redirect=no#Har...

  • Check if the Broadcom WiFi chip is not detected
  • If your WiFi card is based on the Broadcom chip set you are able to install:
    sudo apt-get update (enter)
    sudo apt-get install firmware-b43-installer (enter)

    After rebooting the system it should work. If not activate the driver by hand:
    sudo modprobe -r b43 bcma (enter)

  • Try installing Linux Backport Modules
  • Linux Backport Modules can be installed to get support for many older Wifi cards. The Backport Modules are already part of Labdoo Image for Cloning and installscript-software.sh.

    A detailed list of the supported WiFi cards can be found here:
    http://wiki.ubuntuusers.de/WLAN/Linux-backports-modules
    http://wireless.kernel.org/en/users/Drivers

    To install execute in a terminal:
    for Lubuntu 12.04: sudo apt-get install linux-backports-modules-cw-3.6-$(uname -r) (Enter)
    for Lubuntu 10.04: sudo apt-get install linux-backports-modules-wireless-$(uname -r) (Enter)
    and for all Lubuntu versions: sudo apt-get install linux-firmware-nonfree (Enter)

    If it does not work you can try:

  • Try installing NdisWrapper
  • Details at: http://wiki.ubuntuusers.de/WLAN/NdisWrapper

    Please check, if

    • the 32 Bit or 64 Bit driver of the WiFi card matches with your Lubuntu version (32 or 64 Bit)
    • the .inf file of the driver is enclosed, e.g. Intel encloses .inf only in the .zip version, not enclosed in the .exe!

    Follow the instruction in the upper Wiki (please add here an English Wiki link).

    If this does not work try:

  • Try installing the native WiFi driver of the manufacturer.
  • Please search in web for more information.

acer - special keys are not detected

Some acer laptops (and Medion in Germany) have special keys e.g. to activate WiFi, but these keys are not detected.

From Linux kernel 3.2 or Lubuntu 12.04 there is a core module wistron_btns, offering the same functionality as before acerhk (not needed anymore).

wistron_btns has the advantage that it is part of the kernel. So installing and compiling is not needed. And 64 Bit systems are supported as well.

To use and activate open a terminal and execute:
sudo modprobe -v wistron_btns (enter)

Taken from: http://wiki.ubuntuusers.de/Acer_Hotkeys

apt-offline - update computer offline

There is the tool apt-offline. You can download an update at a place, where you have access to internet, e.g. at home. apt-offline allows you to easily upgrade or install new packages on your offline PC, by using another online PC.

To Install apt-offline (execute in a terminal, press ENTER):
sudo apt-get install apt-offline (Enter)

Upgrading:
On the offline PC: sudo apt-offline set /tmp/apt-offline.sig
On the online PC: sudo apt-offline get C:\apt-offline.sig --bug-reports --threads 5
On the offline PC: sudo apt-offline install /media/USB/apt-offline.zip

Installing
On the offline PC: sudo apt-offline set abuse-offline.sig --install-packages abuse --src-build-dep --install-src-packages abuse
On the online PC: sudo apt-offline get abuse-offline.sig --no-checksum --bundle abuse-offline.zip
On the offline PC: sudo apt-offline install /media/USB/abuse-offline.zip

More info
http://apt-offline.alioth.debian.org/
http://www.debian-administration.org/article/Offline_Package_Management_...
http://ubuntuforums.org/showpost.php&p=10198406&postcount=5

broken packages, interrupted installation, Update to new Lubuntu release

The following hints were taken from
http://wiki.ubuntuusers.de/aptitude
http://wiki.ubuntuusers.de/Paketverwaltung/Problembehebung
http://wiki.ubuntuusers.de/apt/apt-get

The installation was interupted unpredictable:
sudo dpkg --configure -a (Enter, Password Enter)

“Broken” packages are reported, repare:
sudo apt-get install -f (Enter, Password Enter)

Update without upgrading to a new ubuntu release
sudo apt-get install dist-upgrade (Enter, Password Enter)

Repare “broken” packages or to delete the cache of the program list:
sudo apt-get clean (Enter, Password Enter)

To reload the program list again
sudo aptitude -f install (Enter, Password Enter)

Package administration is not usable anymore
Should the package administration become unusable during an upgrade or dist-upgrade you can use:
sudo aptitude -f install (Enter, Password Enter)

After an update of the existing installation:
sudo aptitude safe-upgrade -f (Enter, Password Enter)

After running a version upgrade to a new ubuntu version:
sudo aptitude full-upgrade -f (Enter, Password Enter)

After these statements you should always run
sudo dpkg --configure -a (Enter, Password Enter)

graphic card - check which graphical interface is installed

Open References → Monitor stettings for a first information. Open a terminal:

Show name / chip set:
lspci -nnk | grep -i VGA -A2 (Enter)

driver version
Show driver name and release version:
glxinfo | grep 'OpenGL version string' (Enter)

graphic mode (resolution)
Show the resolution set and all possible screen resolutions and the interfaces:
xrandr (Enter)

install Skype

To install Skype the source "Canonical Partners" must be activated. Otherwise you will get the message "Skype cannot be found".

Hint: If you installed the computer using Cloning of Images it is NOT necessary to activate the Canonical partners programs, as that was already done within the image. Please proceed to the next chapter.

Activate source Canonical Partners

Click on the Lubuntu-Icon (Start) in the lower left corner → System Tools → Lubuntu Software Center → click on the tool symbol in the right upper corner of this window (sometime click on the triangle first to show the tool symbol) → in the window opening click on "Open Software Properties" → click on Tab "Other Software" → make a hook to select "Canonical Partners", you will be asked for the administrator password → click on Close → there is a suggestion to re-laod the software list, please do so.

If you have added Canonical Partners you can start to install Skype:

Installing Skype

Open a terminal and type

sudo apt-get install skype (Enter, tayp password, Enter, answer next question using y)

Only to make sure, if you get the message "Skype not found": Did you add the Canonical Partner Programs as recommended above? Another reason might be you missed to update the software list. so open a terminal and execute sudo apt-get update (Enter).

To get a Skype start icon on the desktop:

Click on the Lubuntu-Start Logo in the left lower corner → click on "Internet" → the list of internet programs will be shown → right mouse click on Skype → Left mouse click on "Add to desktop" → a double click on the Skype icon on the desktop will start Skype.

More details → https://help.ubuntu.com/community/Skype

monitor settings (advanced)

If the standard monitor settings of Lubuntu do not fulfil your needs try the tool ARandR, e.g. when you connect a 2nd monitor or a beamer.
http://wiki.ubuntuusers.de/RandR#Grafische-Werkzeuge
https://help.ubuntu.com/community/Lubuntu/MultiDisplay
ARandR offers you a nice user interfaces and advanced options e.g. to make both screens work as one large monitor or as two separted.

Since September 2015 ARandR is part of Labdoo Images for Cloning and of installschript-software.sh.

You can install ARandA as follows:

    either
  • open a terminal,
  • sudo apt-get install ARandR (Enter, password, enter)
  • or

  • via the Lubuntu Software Centre

Only 12.04 LTS: LXDE / Lubuntu: switch keyboard layout (LXKeymap)

Note: the following is only needed for Lubuntu 12.04 LTS, since in lubuntu 14.04 LTS keyboard layout switching works well without this.

In version 12.04, Lubuntu / LXDE comes without no tool to switch keyboard layout. With the tool lxkeymap it can be solved easily.

To install lxkeymap open a terminal [ALT+CTRL+T] and execute the following command:

sudo apt-get install lxkeymap [Enter]

Open in menu "settings" -> Lxkeymap

There is a known bug in 12.04 LTS which does not allow to use several keyboard layouts in parallel. Just open Lxkeymap and manually switch the keyboard layout. In 14.04 LTS this bug is fixed and also lxkeymap is not needed.

user concept, add user student

When installing Lubuntu-Installation the first user created is labdoo (who is also administrator and should be reserved for the teachers, as this user may destroy the system by mistake). If you install via cloning or if you use the installation scripts the additional user student will be created automatically.

The user student kas less rights, e.g. is not able to install or delete software and is not able to destroy the system.

Here is the manuel way, how to create a user student:

Start here → System Tools → User + Groups → unlock → +add user → system password (labdoo) → student as name, e.g. withpassword labdoo → Account Type = Standard (as suggested) → Create → click on password (account disabled) → input of password labdoo and acknowledge → Change → optional: cahnge language of user student.

Open a terminal and type (by executing this zhe user student will become member of the group labdoo):
sudo usermod -aG labdoo student (Enter)

Please note:
Each new user takes disc space. So please do not create more users.

As a standard user you are not able to destroy a system by mistake (or at least it is very hard). The user labdoo (administrator) should only be used by teachers.

Each user has his own folder and files in the directory /home/....(name of the user). But the folder home/labdoo/Public is a public folder. All users should have access here. To go there open the file explorer → filesystem → home → labdoo → folder /Public (you can add a bookmark to navigate here more easily).

If you add content of your own in /Public there is a script http://ftp.labdoo.org/download/images/installskripts/set-rights-folder-f... to ensure all rights are set correctly.

In addition there is the user guest. guest needs no password to log-in. But guest is not able to change or store anything. When logging out all his input will be deleted automatically.

virus scanner ClamAV

You should not need a virus scanner using Lubuntu. Linux usually needs no virus scanner due to the Linux security concept. There are very few viruses for Linux desktop in the web. Nevertheless some companies offer virus scanner for Linux, e.g. for file server being used also by Windows clients.

Also some edoovillages asked to have a tool to scan USB disc drives of pupils to remove viruses from USB drives of the students. So please install ClamAV for your projects (ClamAV will be installed if you use the installationskript or images for cloning).

So we recommend the license free, open source virus scanner ClamAV
https://help.ubuntu.com/community/ClamAV

Open a terminal and execute:
sudo apt-get install clamav clamav-freshclam clamav-docs clamav-daemon clamtk (Enter)

And you should install the Firefox Plugin Fireclam, so downloads will be automaticaly checked on viruses using ClamAV.

Knoppix Adriane (technique)

The following modifications will

  • improve the access from Knoppix Adriane to Labdoo laptops,
  • improve usage for blind or visually impaired users,
  • just has to run, who wants to create a bootable USB stick via Knoppix Adriane and
  • are only recommended to experienced users.

However, these steps are not necessary if

  • you installed a pre-set Image for Cloning on an USB disc drive (stick) or
  • within Germany and Switzerland you can retrieve 16 GB USB sticks (with pre-installed learning wikipedia) by sending a mail to Labdoo-DACH@Labdoo.org. The Labdoo clubs in Swiss and German charitable association would be happy, if the costs would be covered by a donation.

Suggested changes for Knoppix Adriane (USB Sticks) and Lubuntu

  • Compiz Settings (only Knoppix Adriane (LXDE), not required for Lubuntu)
  • Menu → Preferences → CompizConfig Settings Manager →

    • General → General Options → Desktop size → Horizontal virtual size = 1
    • Desktop, remove all hooks (Desktop Cube, Expo,Viewport Switcher, Rotate Cube)
    • Effects, remove all hooks, except the one for Windows decoration
  • Remove Aumix from the starter panel (only for Knoppix Adriane)
  • Right mouse click on the starter panel → "Application Launch Bar" Settings → click on aumix → - Remove - Close

  • Pre-Set Adriane as Boot setting within grub (only for Knoppix Adriane)
  • Open 3 files in an editor e.g. sudo nano /home/knoppix/Desktop/KNOPPIX/boot/syslinux/ and change in the line "DEFAULT" auto into adriane, then store the file:

    • syslinux.cfg
    • syslnx32.cfg
    • syslnx64.cfg

    Optional: You are able to change the standard screen resolution of Adriane (640x480). But you must choose a resolution supported by the computer used. And not blind, but visually impaired users (being able to see some details) might need a low resolution to get large letters. And when you start Adriane the graphical desktop LXDE will heritage the resolution by Adriane, if being switched to. You are able to change the screen resolution within LXDE.

  • Desktop, File manager PCMANFM settings (nur Knoppix Adriane)
  • Open file manager PCmanfm → edit → Preferences → General →

    • Set hook to activate "Move deleted files to trash can"
    • de-sctivate (remove hook) at "open files with single click"
    • Volume Management → add hooks at "Mount mountable volumes" and "Mount removable volumes"
    • Layout → Show in Places → add hook at "Trash can" and "Devices"
  • Orca settings (for Knoppix Adriane and Lubuntu)
    • open a terminal (press Alt + Ctl/Strg+ t at the same time) → type orca -s (Enter)
    • Keyboard → Laptop (or leave if run on a PC, will (de-)active number keypad)
    • mouse → activate "Preset tooltips"
    • mouse → activate "Speak objects under mouse"
  • Script to toggle screen reader Orca on/off (toggle_orca.sh)
  • The script toggle_orca.sh solves to toggle the screen reader Orca on / off by using the key combination Alt + Windows/Super + o. The script can be downloaded from here http://ftp.labdoo.org/download/images/installskripts/toggle_orca.sh

  • Script toggle_orca.sh (for Knoppix Adriane)
    • Store script in the folder as /home/knoppix/.toggle_orca.sh (the leading "." in the file name will make the file hidden, invisible; to show hidden files activate in PCmanfm "show hidden files",
    • make file executable (→ Properties → Permissions → make file executable)
    • Open Compiz settings manager → General → Commands → if line empty add e.g. in Command Line 2:
      /bin/sh /home/knoppix/.toggle_orca.sh
    • click on tab "Key Bindings" → click in an empty line on button "disabled" → to switch it to "enabled" → Left mouse click on "grab key ..."
    • type the needed key combination ( here Alt + Windows/Super + o ) → confirm and close "OK".

    If everything was proceeded correctly you are now able to switch screen reader Orca now on / off by keep the keys Alt + Windows/Super + o pressed at the same time.

  • Script toggle_orca.sh to toggle in Lubuntu using the window manager Openbox (nur Lubuntu)
    • As described before, but store script in folder /usr/share/labdoo (start in a terminal sudo PCMANFM (Enter), as you need super-user rights to create this new folder and store the script)
    • make the script executable → Properties → Permissions. End and close file manager PCMANFM as super-user and start it again as labdoo user (click on icon PCmanfm).
    • open on FTP-Server the filei http://ftp.labdoo.org/download/images/installskripts/keybinding_toggle_o... and copy / paste the content (Ctrl + C)
    • activate in file manager PCMANFM → menu View → Show hidden (Ctrl + H) and open in folder /home/labdoo/.config/openbox the file lubuntu-rc.xml in an editor (right mouse click, open in an editor e.g. Leafpad)
    • Search in the editor for the text <keyboard>, next insert the copied text from clipboard between the lines <keyboard> and </keyboard>. The code from file keybinding_toggle_orca.txt will be inserted, store and close file.
    • execute in terminal openbox --reconfigure
    • repeat these steps also for the user student, but as student is not allowed to run code in a terminal → Startbutton → Run → type here openbox --reconfigure and Enter.

    If everything was proceeded correctly you are now able to switch screen reader Orca now on / off by keep the keys Alt + Windows/Super + o pressed at the same time.

  • Set-up tool pico2wave (for Knoppix Adriane and Lubuntu)
  • pico2wave by SVOX is a complete speach synthesizer to convert German, French or English text into spoken words (sound, Wave file). Für some languages special control files are available. For other languages e.g. Italian or Spanish these control files have to created first (volunteers needed).

    Install pico2wave

    To install it run in a terminal, when computer is connected to web:

    1. in terminal: sudo apt-get update (Enter)
    2. in terminal: sudo apt-get install libttspico-utils sox xsel libav-tools (Enter)

    Beside the installation of pico2wave 3 more files have to be installed and adapted (for Lubuntu: in /usr/share/labdoo, in Knoppix in /home/knoppix/.). Please follow those steps described above for Orca or see tutorial https://www.youtube.com/watch?v=UjBtKRd7c34:

    Download and store these files in the corresponding folders and make files executable for everyone.

  • Volume settings (Knoppix Adriane and Lubuntu)
  • Open in a terminal → alsamixer → (m) = Mute off, move from setting to setting by ← or →, adjust volume setting using the keys ↑ or ↓.

  • Mount the disc drive of a Labdoo laptop (/sda1) when booting (only Knoppix Adriane)
  • Helpful, if you run Knoppix Adriane on a USB Stick in combination with a Labdoo laptop, to get easier access to the educational content. Open an editor as super-user; run in a terminal sudo leafpad (Enter), navigate to the folder:

    • open file /etc/fstab and change lines:
      # Automount sda1 as sda1
      /dev/sda1 /media/sda1 ext4 defaults 0 2
      Store file.
    • Add to the end of /etc/adriane/adriane.conf:
      # Mount sda1
      sudo mkdir /media/sda1
      sudo mount -a
      Store file.

    Hint: In Adriane you can open a terminal → menu entry → Shell.

  • Adapt LXDE panel to look alike as on a Labdoo computer (only Knoppix Adriane)
  • Add needed applets for Tastaturumschalter etc. to the panel.

  • Add bookmarks to elinks Browser (for Knoppix Adriane and Lubuntu)
  • Start eLinks → navigate to the start file, in most cases index.html), mark it with the cursor and press (Enter) to open it → right mouse click opens a menu, click here → Bookmark document (a) → ready.

    To open a bookmark → press two times ESC → above a menu will show up → move the cursor and mark tools , press Enter → mark bookmarks (s) → will show all known bookmarks.

    Generate a Knoppix Adriane USB disc drive

    There are several ways to get an USB-disc drive (stick) with Knoppix Adriane software and educational content for blind users:

    1. you can ask Labdoo to send out a ready installed USB-disc drive (stick) by sending a m to Labdoo-DACHqLabdoo.org (only for Austria, Germany and Switzerland). Tell us how many USB-Discs you need and your postal address. Please understand that we have to cover the costs by donations.
    2. Or you produce an USB-disc drive yourself (only recommended for advanced users!) It will NOT WORK to copy an USB-disc to another USB-disc using a file manager. Some important data like boot information (MBR) will not be copied and will not be able to boot this stick. Labdoo recommends minimum 16 GB USB 2.0 disc drives to store Knoppix Adriane, local Wikipedia for Schools and ca. 4 GB free space for user data.
    3. You can get another USB disc drive

    • by copying a pre-installed USB-disc drive to another drive using Linux and the dd command (for details see below) or
    • download an image and restore it using dd command..
    • Copy one pre-installed USB-disc drive to another (only for experienced users)
    • You have got a pre-installed USB-disc drive Knoppix Adriane by Labdoo? Then buy an USB-disc drive (min. 16 GB). As only very few of the computer abroad have USB 3.0 slots we recommend to buy fast USB 2.0 disc drives. On older hardware USB 3.0 discs might not be recognized.

      You have got a Labdoo- or Linux laptop? Perfect, then you have got everything you need. Start the Labdoo-/Linux computer and log-in as user labdoo. Important: First plug-in the pre-installed origin USB-disc (which you want to copy, will usually get the name /sdb), next plug-in the USB drive you want to copy to (will get drive /sdc etc.) You are also able to copy several sticks at the same time (will become drive /sdd, /sde etc).

      Open a terminal and run lsblk -f (Enter). This will give you a list of all available drives. Drive /sda (mit den Partionen /sda1, /sda2 usw.) is the internal drive of the laptop. Never touch that! Leave it as it is!

      Next step is to run in a terminal:
      sudo dd if=/dev/sdb of=/dev/sdc status=progress Enter; this will copy all data from the origin USB drive (/sdb) to the target USB drive (/sdc etc.). This will last a while...

      Attention: the command dd is helpful, but dangerous! Check always, if origin and target drive are correct. Otherweise you might delete your own computer's data be mistake. We recommend not to use your own computer, but a Labdoo computer. dd is available on each Linux computer.

    • Re-store an image Knoppix_Adriane_dd_xx.gz using dd to an USB disc drive (only recommended for experienced users)
    • Download from the Labdoo FTP-Server the images, created using dd: http://ftp.labdoo.org/download/images/ (the images are named Knoppix_Adriane_dd_xx.gz, xx being space-holder for the language, EN = Englisch, FR = Französisch, DE = Deutsch, ES = Spanisch)

      Store the downloaded, zipped file in your home directory (/home/labdoo). You don't need to unzip it first. Next step is to connect the target USB disc drive to the computer, open a terminal and execute

    1. lsblk -f (Enter), to check if all drives are connected (in most cases the internal disc of the computer is /sda (do not delete that one!) and the connected USB disc drive becomes /sdb, /sdc etc.
    2. sudo gunzip -c Knoppix_Adriane_dd_xx.gz | sudo dd of=/dev/sdb status=progress (Enter, xx = space-holder for the language, replace accordingly). This will unzip and copy all data of the image to the USB drive. Change drive name accordingly if needed, e.g. /sdb in /sdc etc. if copying several USB drives in parallel

    After copying all data to a new USN drive you can unmount (remove secure) and shut down the computer. To use this new USB drive with a computer we recommend to change the boot sequence in BIOS settings. The USB-disc (stick) should be placed (get a higher boot priority) before the internal disc drive. Otherwise you can select manually the boot media each time you boot (often press F12). But for blind users this might be difficult.


    • Internal: Create an image using Shell and dd (only recommended for experienced users!)
    • To get an image from an ready installed USB disc drive with Knoppix Adriane use dd as well. In most cases the USB disc, to copy from, has the address / drive name /sdb (might change, so please check).

        Create image by terminal (shell)
      • Open a terminal and execute sudo dd if=/dev/sdb status=progress | gzip --best >Knoppix_Adriane_dd_xx.gz (Enter, replace xx by the language code you need). This will copy a zipped image file Knoppix_Adriane_dd_xx.gz an (ca. 12 GB) to your home directory /home/labdoo.