Difference between revisions of "Getting started with Linux on CM-iAM"

From Compulab Mediawiki
Jump to: navigation, search
m (1 revision(s))
 
Line 1: Line 1:
== Overview  ==
+
#REDIRECT [[CM-iAM: Linux: Getting started]]
 
 
Linux for the CM-iAM/SB-iAM is based on Ubuntu 9.04. [http://www.compulab.co.il/iam/download/release/iam-linux-release.zip The Linux package for CM-iAM] includes a ready-to-run NAND flash image, Linux kernel configuration and source code, dedicated repository with graphic drivers, media player and kernel related packages.
 
 
 
==  Package contents ==
 
The CompuLab Linux package for CM-iAM contains the following components:
 
 
 
=== run-time disk images ===
 
* {{filename|sb-iam.ubuntu-9.04.NAND.img.bz2}} - archived image of local NAND disk. Contains fully configured Ubuntu 9.04
 
 
 
=== kernel ===
 
* '''2.6.28''' kernel sources and configuration file customized by Compulab.
 
* The kernel is also present as a package in ''debian repository''.
 
 
 
=== debian repository ===
 
* To be consistent with Ubuntu/Debian packaging standards, we created a simple local repository that resides in {{filename|/opt/compulab/}} in the run-time image.
 
* This repository contains binaries and sources for all the custom packages provided by CompuLab, such as kernel, graphic drivers, libraries, etc. Please read more about working with a repository in [http://www.debian.org/doc/manuals/repository-howto/repository-howto Debian Repository HOWTO]
 
 
 
=== scripts ===
 
Miscellaneous useful scripts
 
* {{filename|image_mount.sh}} - utility to mount run-time image partitions on a host workstation
 
* {{filename|image_creator.sh}} - utility to create installation and recovery image for bootable USB flash drive. Run this script from {{filename|scripts}} directory in the package, {{filename|sb-iam.ubuntu-9.04.USB.img}} will be created in the {{filename|images}} directory.
 
 
 
== Boot from external device  ==
 
It`s possible to boot not only from the local NAND disk, but also from an external storage device such as a USB flash disk, SATA disk or MMC/SD/SDIO card. At it`s initial state, the local NAND disk is empty and booting from an external device is the only option. Below booting from disk-on-key is described.
 
* Obtain any Linux workstation and download [http://www.compulab.co.il/iam/download/release/iam-linux-release.zip Linux kernel package for CM-iAM] to it.
 
* Unzip ''iam-linux-release.zip'' to some place on your Linux workstation.
 
* Open '''Applications->Accessories->Terminal'''
 
* Get root permitions using the {{cmd|su}} command.
 
* Run {{cmd|image_creator.sh}} script from {{filename|scripts}} directory in the package, {{filename|sb-iam.ubuntu-9.04.USB.img}} will be created in the {{filename|images}} directory.
 
<pre>
 
# cd /path/to/downloaded/iam-linux-release/scripts/
 
# ls
 
image_creator.sh image_mount.sh
 
# ./image_creator.sh
 
(some output here)
 
../images/sb-iam.ubuntu-9.04.USB.img is ready.
 
# ls ../images/
 
sb-iam.ubuntu-9.04.USB.img sb-iam.ubuntu-9.04.NAND.img.bz2
 
</pre>
 
{{Note|Currently created {{filename|sb-iam.ubuntu-9.04.USB.img}} is nearly identical to {{filename|sb-iam.ubuntu-9.04.NAND.img}}. The images differ only in device numbering in {{filename|/boot/grub/menu.lst}} and {{filename|/etc/fstab}}. Also {{filename|sb-iam.ubuntu-9.04.USB.img}} contains archived {{filename|sb-iam.ubuntu-9.04.NAND.img}} in {{filename|/home/user/Desktop/}} }}
 
 
 
* Prepare an external storage device, 4GB or more capacity will be enough.
 
* Connect the USB flash drive to the Linux workstation.  We assume here it's recognized as {{filename|/dev/sdb}}.
 
* Extract the USB image directly to the connected USB flash drive using the following command:
 
<pre>
 
# dd if=../images/sb-iam.ubuntu-9.04.USB.img of=/dev/sdb bs=2M
 
</pre>
 
* Insert formatted USB flash drive into an empty USB slot on the SB-iAM baseboard, ensuring that no other external storage device is connected.
 
* Power on the SB-iAM. In BIOS, choose your USB flash drive as the first boot device and reboot.
 
* Welcome to Ubuntu 9.04 for SB-iAM, username: '''user''', password: '''111111'''
 
{{Note|Bootable USB image {{filename|sb-iam.ubuntu-9.04.USB.img}} contains a filesystem with 1.2GB empty space. If your storage device is bigger than 4GB - you can easily reformat it with the {{cmd|fdisk}} and {{cmd|resize2fs}} utilities to get more empty space.}}
 
 
 
== Boot from local NAND disk  ==
 
* Boot from external device as described above.
 
* {{filename|sb-iam.ubuntu-9.04.NAND.img.bz2}} image file will appear on the desktop.
 
* Open '''Applications->Accessories->Terminal'''
 
* Get root permitions using the {{cmd|su}} command, root password is "111111".
 
* Extract the image file directly to the local NAND disk using the following command:
 
<pre>
 
root@sb-iam:/home/user# bzip2 -dc /home/user/Desktop/sb-iam.ubuntu-9.04.NAND.img.bz2 | dd of=/dev/sda bs=2M
 
</pre>
 
* Reboot, choose in BIOS, local NAND disk as first boot device, save changes.
 
* Welcome to Ubuntu 9.04 for SB-iAM, username: '''user''', password: '''111111'''
 
 
 
== See also ==
 
 
 
* [[Linux Kernel for CM-iAM]]
 
* [[Ubuntu Linux for CM-iAM]]
 

Latest revision as of 08:03, 23 December 2009