|
|
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]]
| |