» Support » Software » Search » LPI-LNX-LUNA-R1.00 » ReadMe

ReadMe: LPI-LNX-LUNA-R1.00

VersaLogic Debian Live Hybrid Image for the Intel Luna Pier (Atom D425/D525) Platform

Boards Supported Iguana (VL-EPIC-25)
Kernel Version 2.6.32-5
Debian Linux Version (Squeeze/Stable)
Quick Login Instructions
Root User
Login root
Password password
Regular User
Login user
Password password


  1. Legal Disclaimer
  2. Purpose
  3. Hardware Requirements
  4. Installation Instructions
  5. What to Do Once the Installation Is Finished
  6. Adding New Programs to a Debian Installation
  7. Advanced User Package (AUP)
  8. Important Notes (Highly Recommended)
  9. Known Issues (Highly Recommended)
  10. References


VersaLogic is making no claims of usability, efficacy or warranty. Information in this document is provided in connection with VersaLogic products. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. VersaLogic assumes no liability whatsoever, and VersaLogic disclaims any express or implied warranty relating to the sale and/or use of VersaLogic products, including liability or warranties relating to fitness for a particular purpose, merchantability or infringement of any patent, copyright or other intellectual property right. VersaLogic products are not intended for use in life-saving or life-sustaining applications.

VersaLogic disclaims all warranties and liabilities for the use of this document and the information contained herein, and assumes no responsibility for any errors which may appear in this document, nor does VersaLogic make a commitment to update the information contained herein. VersaLogic reserves the right to make changes to this document at any time without notice.


Installing Debian can be a difficult and time consuming effort, even when using the latest installer guide added with the release of "Lenny". Our goals are to make the Debian OS installation as painless as possible for our customers, provide multiple installation images that balance footprint versus functionality in different ways, and to pre-configure any product-specific support such as video, cardbus, etc. This also constitutes the difference between our installation and the Debian "Squeeze" CD/DVD installation.


  1. USB Mouse & Keyboard
  3. (a) SATA device (hard drive)
    -- or --
    (b) USB hard drive
    -- or --
    (c) USB flash drive
    on which the system will be installed
  4. 256 MB RAM (min.)
  5. FPD or CRT monitor with LVDS adapter


  1. The Live Hybrid image can be copied to a USB thumb drive in the Linux environment using the command:
    dd if=<name of hybrid image> of=/dev/sdb
    The "of=" section should list the device name of your USB thumb drive - check by scanning the bottom of dmesg after inserting your thumb drive and you should have messages stating which device the thumb drive was mounted as.

    Do not add the partition number from the dmesg listing. For example, a drive mounted as /dev/sdb1 should be used as: dd if=binary-hybrid.iso of=/dev/sdb.

    If desired, the Live Hybrid image can be burned onto a DVD drive using the appropriate Windows or Linux software, asyou would for a normal .iso image.
  2. The image will boot automatically into the boot-loader menu. You can choose to run from the install media without installing (run in live mode) or install the image to a hard disk. The image will install to the first hard disk it finds - it will erase any data on the install disk, so be careful to use the correct disk.

    If you are planning to install on a USB device, make sure that the following settings are ENABLED in BIOS settings:
    1. Firmbase LEGACY USB
    2. Firmbase USB BOOT
    3. Firmbase EHCI/USB 2.0
  3. The installer will take you step-by-step through the installation process.


  1. Reboot your system once the installation process succeeds.
  2. Press the Delete key to go to BIOS Settings. Go to the Boot section.
  3. Under the BOOT DEVICE PRIORITIZATION section, assign the device on which you installed the image as the first device to boot from - "0".
  4. Save the BIOS settings and reboot.
  5. You should see the GRUB bootloader screen and it will automatically boot into your new system in a few seconds.
  6. Once the system boots and presents the login screen, you will have to log into the system.
    1. To login as a regular user:
      Login user
      Password password
    2. To perform root tasks:
      sudo <taskname>
      and you will be prompted for the root password ("password") The root user will be able to perform all administrative tasks.


Even though we have tried to provide a good base of installed programs, it would not be practical for us to provide everything that is available to everyone. In this section, we will provide a basic tutorial on how to add new software to your installed base system.

Adding Additional Software

Once you have your basic installation completed, the next thing you will probably want to do is add additional software. The APT suite of programs is, by far, the easiest way to accomplish this task. APT is an acronym for Advanced Package Tool which is essentially an automated dependency resolver and front end for the dpkg program. It will figure out what the dependencies are for a given software package and then it will manage the calls to dpkg which actually does the work of installing them. Together, apt and dpkg make installing new packages very straightforward.


Let's go through an example. You want to first make sure you are connected to the Internet--all three of the Debian installations contained on the VersaLogic Debian install CD are configured to use DHCP, by default. And, in most cases, you just need to connect an Ethernet cable to your network to use it. At the console prompt, type "apt-get update" and 'enter'. This will refresh the local package database. It's a good practice to do this step fairly often (before you are about to install new software) to make sure that the latest package information is available to APT.

Once that process is finished, type:

apt-get install traceroute

then press Enter. "traceroute" is in the name of the package we want to install, so APT will go find any packages that have that name, and often automatically decides which one is best for your system. It also determines what other packages need to be installed to make traceroute work, and it will go ahead and install those as well.

There might be some software that could be in Debian's Contrib and Non-free sections. To install software from these sections, modify the following line in the /etc/apt/sources.list file:

deb squeeze main
-- to --
deb squeeze main contrib non-free

Installing Packages From Testing Repositories (i.e. Other Than Stable)

By default, APT will look in /etc/apt/sources.list to determine where to download the packages from. We have set up the system to look in a Stable online repository by default, but if it doesn't exist there, APT can also look in a Testing repository (testing means that the package is being tested and has been stable for at least 14 days, but has not yet been added to the formal Debian stable release). This scheme strikes the best balance between system stability and package availability since, unlike other Linux distributions, Debian's developers can take years to move testing packages to stable (which happens only for major releases). To enable APT to download packages from the testing repository, you will have to uncomment the following lines (by removing the leading # symbol) from the /etc/apt/sources.list file:

#deb testing main contrib
#deb-src testing main contrib

Additional Information/Links for the APT Package Management System

Debian essentially maintains three types of distributions:

  1. Stable
  2. Testing
  3. Unstable

For more information, refer to the following web sites:


APT Configuration Files

Refer to the following files to customize the apt-get system:

  1. /etc/apt/apt.conf
  2. /etc/apt/sources.list
  3. /etc/apt/preferences

Also, please run the command:

#apt-get update

every time you decide to install any package. This is very important as it will keep the local repository synchronized with the Debian repository.

7.0 Advanced User Package (AUP)

If you don't want to install the VersaLogic Debian image and would like to have your own custom install (Debian or a non-Debian), then this section is for you. No matter which distro you choose, you will need a kernel with all of the updated hardware support. The files in the downloaded zip file are used for the following:

  1. The kernel source version for Iguana is 2.6.32
  2. Kernel Image - Installable .deb file (for Debian-based distros)
  3. Kernel Config file (.config)
  4. Kernel Header files
  5. Patch to apply to the 2.6.32 source to get the VersaLogic level of kernel source

You need to unzip the file first to access the above contents.


  1. The hybrid iso is based on a VersaLogic customized Debian kernel using the Debian Backported kernel source 2.6.39.
  2. If you connect a USB device such as a hard drive or CD-ROM, you should be able to access it under the `/media/` directory.


There are no known issues at this time.


Following is a list of books and web sites that we recommend to anyone who wants to learn more about Debian or GNU/Linux in general:

  1. Debian System, Concepts and Techniques, by Martin F. Krafft, Open Source Press, 2005.
  2. GNU/Linux Application Programming, by M. Tim Jones, Charles River Media, 2005.
  3. Debian's official home on the Internet:
  4. The X.Org Foundation provides an open source implementation of the X Window System:
  5. Newsgroup: comp.os.linux contains plenty of free advice.

Copyright © 2013 VersaLogic Corp. All rights reserved.