88
edits
Changes
From IGEP - ISEE Wiki
no edit summary
Ubuntu 12.04.4 LTS (Hard Float) is the default IGEPv5 base distribution (it's included in IGEPv5 Full and Lite).
We will learn about install, use, generate packages, upgrade ...
What we learn in this chapter? Install, play and fun with Ubuntu distro ...
__TOC__
= Host Enviroment =
== Install Development packages ==
Now is time to install some packagesif you want to build your own distribution.
=== GCC, G++, libc Cross Compiler ===
You can install the cross compiler if you want to build u-boot, linux kernel or applications using your host PC and compile for IGEPv5 as target.
<pre>sudo apt-get install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf libc6-dev-armhf-armel-cross libc6-armel-armhf-cross
</pre>
=== Build Ubuntu packages ===
if you're idea is build ubuntu packages then you need install other packages
<pre>sudo apt-get install build-essential devscripts dh-make quilt autogen autoconf dh-autoreconf dh-buildinfo dh-make pkg-config
</pre>
=== Pbuilder ===
armv7l</pre>
Now you've in a chroot armhf emulation your rootfs ...
= Install Ubuntu Core 12.04.4 LTS (HF) in the IGEPv5 =
Ubuntu 12.04.4 LTS can be installed in MicroSD Card, the internal eMMC Flash or in a SSD Flash card, the minimum suggested capacity will be is 8 GiB available.
This tutorial will show you install step by step and customize the distribution base.<br>
=== Download Ubuntu 12.04.4 LTS (HF) ===
Ubuntu 12.04.4 LTS can be downloaded from our server at this [http://downloads.isee.biz/pub/igepv5_ce/arm-ubuntu/images/ubuntu-12.04.4-LTS-hf location]this is a unmodified ubuntu 12.04.4 image without any package. This distribution is based on [https://wiki.ubuntu.com/Core Ubuntu Core]<br>Ubuntu 12.04.4 LTS (with ISEE modifications) can be downloaded from our server at this [http://downloads.isee.biz/pub/igepv5_ce/releases/ location] all support is based on this distribution.<br> '''The changelog is located inside the /root directory<br> '''User '''root '''password''': letmein<br> '''User '''igep '''password''': igep'''
=== Initial Setup ===
sudo tar xvfz ../ubuntu-core-12.04.4-core-armhf.tar.gz
sudo cp /usr/bin/qemu-arm-static usr/bin
for m in `echo 'sys dev proc'`; do sudo mount /$m ./$m -o bind; donesudo LC_ALL=C chroot .</pre> <span style="color: rgb(255, 0, 0);">Note: remember remove the qemu-arm-static file after all. </prespan> Note: remember unmount (outside chroot) the sys proc and dev with: for m in `echo 'sys dev proc'`; do sudo umount ./$m; done
Now if you execute the command ls -al you should see a similar directory listing like this:
<pre>drwxr-xr-x 2 root root 4096 Feb 3 16:42 bin
=== Tunning your rootfs ===
We will share some interesting tricks that can be useful for your new rootfs. ==== Login in "root" without need of a password ==== You can edit the file /etc/shadow it should have a similar content like this <pre>root:*:16104:0:99999:7:::</pre> if you want eliminate the need of a password you must remove the * as <pre>root::16104:0:99999:7:::</pre> ==== Add password for root user<br> ==== Enter as root user and set the password with: <pre>$ passwd</pre> ==== Network configuration files for 'DHCP' client ====
auto lo
iface lo inet loopback
auto eth0
iface eth0 inet dhcp
* If you are behind a firewall inside a 'Corporate Network', the following 2 files may need to be edited to according to your Coporate settings:* Edit your /etc/resolv.conf file and have something similar to this: Remove the "<><>" symbols and replace by your own corporate DHCP and DNS servers adresses. domain <<something.dhcp.mycompany.com>> search <<something.dhcp.mycompany.com>> nameserver <<IP address of your DNS server 1>> nameserver <<IP address of your DNS server 2>> * Add the proxy settings: In your /etc/environment file, add something similar to this using your own corporate proxy server address and port number:
http_proxy="http://myproxy.ext.mycompany.com:80"
https_proxy="http://myproxy.ext.mycompany.com:80"
ftp_proxy="http://myproxy.ext.mycompany.com:80"
no_proxy="localhost,.mycompany.com"
In your /etc/apt/apt.conf.d/proxy, add similar to this using your own corporate proxy server address and port number:
Acquire
{
}
}
== Packages ==
The IGEPv5 debian repository is located here: http://downloads.isee.biz/repo/apt<br> Edit: /etc/apt/sources.list and add this line:<br>
<pre>deb http://downloads.isee.biz/repo/apt/ precise main non-free contrib</pre>
after that save the file and execute
<pre>apt-get update
</pre>
== Prepare your disk (microsd, eMMC or SSD disk) ==
First we need to prepare the disk (microsd, eMMC, or SSD disk), download this [http://downloads.isee.biz/pub/igepv5_ce/scripts/prepare-disk.sh script]<br>
Prerequisites: you must install these two packages before execute the script:<br>
<pre>sudo apt-get install bc dosfstools
</pre>
This script will create in your disk (microsd, eMMC, SSD disk) two new partitions, first one named boot and the second one named rootfs.<br>
Check your disk:<br>
Insert the disk in your PC or IGEPv5 and after that execute lsblk as:<br> mmcblock is for microsd card or eMMC sda is for your ssd disk
<pre>lsblk
sdb 8:16 1 3.8G 0 disk
├─sdb1 8:17 1 70.6M 0 part /media/boot
└─sdb2 8:18 1 3.7G 0 part /media/rootfs
</pre>
or is possible to look like this:<br>
<pre>root@localhost:~# lsblk
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sda 8:0 0 29.8G 0 disk
|-sda1 8:1 0 100M 0 part
`-sda2 8:2 0 29.7G 0 part /
mmcblk0boot0 179:8 0 2M 1 disk
mmcblk0boot1 179:16 0 2M 1 disk
mmcblk0 179:0 0 7.3G 0 disk
|-mmcblk0p1 179:1 0 70.6M 0 part
`-mmcblk0p2 179:2 0 7.2G 0 part
</pre>
Execute the script as root:<br>
<pre>sudo ./prepare_disk.sh
root@localhost:~# ./prepare-disk.sh
sda 8:0 0 29.8G 0 disk
mmcblk0boot0 179:8 0 2M 1 disk
mmcblk0boot1 179:16 0 2M 1 disk
mmcblk0 179:0 0 7.3G 0 disk
Select the disk: [sdx or mmcblkx]
</pre>
In the first case you should use sdb and in the second case you should use mmcblk0, write the appropiate disk name ...
After that it will ask you if you are sure !!!
After the script execution you will found two new partitions
<pre>mmcblk0 179:0 0 7.3G 0 disk
|-mmcblk0p1 179:1 0 70.6M 0 part
`-mmcblk0p2 179:2 0 7.2G 0 part
</pre>
In this case p1 (boot) and p2 (rootfs).
== Install your image in a MicroSD Card ==
First you need prepare your disk, check previous point.
Ubuntu 12.04.4 LTS (with ISEE modifications) can be downloaded from our server at this [http://downloads.isee.biz/pub/igepv5_ce/releases/ location] all support is based on this distribution.<br> '''The changelog is located inside the /root directory<br> '''User '''root '''password''': letmein<br> '''User '''igep '''password''': igep'''
Mount your microsd in your host PC or IGEPv5 after mount the disk it should show you two partitions, the first one boot when we will copy the MLO and u-boot.img and the second one where we uncompress the downloaded file.
=== Mount the microsd card partitions ===
Use the command mount if automount is not enabled as
<pre>mount /dev/mmcblk0p1 /mnt/p1
mount /dev/mmcblk0p2 /mnt/p2
</pre>
Copy MLO and u-boot.img (both files can be downloaded reside inside the package u-boot-xxxxxxx-omap5-isee.tar.bz2) inside /mnt/p1
<pre>cp MLO u-boot.img /mnt/p1
</pre>
go to /mnt/p2
Now uncompress the rootfs (downloaded file) <span style="color: rgb(255, 0, 0);">as root</span>
<pre>cd /mnt/p2
sudo tar xvfj ubuntu-core-12.04.4-isee-XXXXXXXXXXX-armhf.tar.bz2 (where xxxxxxx is the release name)
</pre>
Sync disk
<pre>$ sync
</pre>
Unmount the disks
<pre>umount /mnt/p1
umount /mnt/p2
</pre>
And finally eject the disk.
If automount is enabled the partitions will be accessed on:
/media/<your user>/boot
and
/media/<your user/rootfs
use both directories for copy the files in this case you don't need create the directories, you directly can copy and uncompress the file there.
== Install your image in a SATA SSD Disk ==
First you need prepare your disk, check previous point.
Ubuntu 12.04.4 LTS (with ISEE modifications) can be downloaded from our server at this [http://downloads.isee.biz/pub/igepv5_ce/releases/ location] all support is based on this distribution.<br> '''The changelog is located inside the /root directory<br> '''User '''root '''password''': letmein<br> '''User '''igep '''password''': igep'''
Mount your SSD disk in your IGEPv5 after mount the disk it should show you two partitions, the first one boot when we will copy the MLO and u-boot.img and the second one where we uncompress the downloaded file.
=== Mount the SSD disk partitions ===
Use the command mount:
<pre>mount /dev/sda1 /mnt/p1
mount /dev/sda2 /mnt/p2
</pre>
Copy MLO and u-boot.img (both files can be downloaded reside inside the package u-boot-xxxxxxx-omap5-isee.tar.bz2) inside /mnt/p1
<pre>cp MLO u-boot.img /mnt/p1
</pre>
go to /mnt/p2
Now uncompress the rootfs (downloaded file) <span style="color: rgb(255, 0, 0);">as root</span>
<pre>cd /mnt/p2
sudo tar xvfj ubuntu-core-12.04.4-isee-XXXXXXXXXXX-armhf.tar.bz2 (where xxxxxxx is the release name)
</pre>
Sync disk
<pre>$ sync
</pre>
Unmount the disks
<pre>umount /mnt/p1
umount /mnt/p2
</pre>
Reboot the board (remember set the board dips in the right boot setup, dip 8 ON)
== Install your image in the eMMC flash ==
First you need prepare your disk, check previous point.
Ubuntu 12.04.4 LTS (with ISEE modifications) can be downloaded from our server at this [http://downloads.isee.biz/pub/igepv5_ce/releases/ location] all support is based on this distribution.<br> '''The changelog is located inside the /root directory<br> '''User '''root '''password''': letmein<br> '''User '''igep '''password''': igep'''
Mount your eMMC in your IGEPv5 after mount the disk it should show you two partitions, the first one boot when we will copy the MLO and u-boot.img and the second one where we uncompress the downloaded file.
You can see the eMMC disk as MMC disk, take a look with the names just if you've the microsd plugged ...
=== Mount the eMMC partitions ===
Use the command mount if automount is not enabled as
<pre>mount /dev/mmcblk0p1 /mnt/p1
mount /dev/mmcblk0p2 /mnt/p2
</pre>
Copy MLO and u-boot.img (both files can be downloaded reside inside the package u-boot-xxxxxxx-omap5-isee.tar.bz2) inside /mnt/p1
<pre>cp MLO u-boot.img /mnt/p1
</pre>
go to /mnt/p2
Now uncompress the rootfs (downloaded file) <span style="color: rgb(255, 0, 0);">as root</span>
<pre>cd /mnt/p2
sudo tar xvfj ubuntu-core-12.04.4-isee-XXXXXXXXXXX-armhf.tar.bz2 (where xxxxxxx is the release name)
</pre>
Sync disk
<pre>$ sync
</pre>
Unmount the disks
<pre>umount /mnt/p1
umount /mnt/p2
</pre>
Reboot the board (remember set the board dips in the right boot setup)
== Special Warning about MicroSD Card and eMMc ==
The microsd card uses the interface mmc as the eMMC in some cases as when you boot from your microsd card the lsblk command can show you two mmc devices:
/dev/mmcblk0 <br> /dev/mmcblk1 <br>
Normally the 0 is the boot device (from where you boot), if you use the microsd card for boot : /dev/mmcblk0 and the eMMC is the /dev/mmcblk1 but if you boot from the eMMC and insert the microsd card then the eMMC is /dev/mmcblk0 and the microsd card be /dev/mmcblk1 <br> If you use the script for prepare the disk first be sure about which is your desired target due you can easily erase other disk.
= WORK WITH PACKAGES =
Maybe if you used ubuntu before you are familiar with the apt use, this is only an a introduction to apt use:<br> If you wish install a new package you should use:
<pre>$ apt-get install <package name>
$ apt-get install openssh-server
</pre>
If you wish locate any package you can use:
<pre>$ apt-cache search <name>
</pre>
it list the concordances with name, maybe it's useful use an alternative command:
<pre>$ apt-cache search <name> | grep "any string"
</pre>
If you wish remove any package you can use:
<pre>$ apt-get remove <package name>
</pre>
If you wish list the package content you can use:
<pre>dpkg -L <package name>
</pre>
If you wish list the packages installed in your system you can use:
<pre>dpkg -l
</pre>
or if you wish locate one:
<pre>dpkg -l <name>
</pre>
= BUGS =
The Bug tracking server is located [http://bug.isee.biz here], the bug tracking is open to all customers and there you can put your found bugs, requesting features or changes ...<br>
= CONTRIBUTE =
Please login in this wiki page with the same username and login that you use in the www.isee.biz page and put here your comments or improvements. You can write your comments or ask any question using our [http://www.isee.biz/support support forum]
= References =
http://www.omappedia.com/wiki/OMAP_Ubuntu_Core#Chroot.27ing_into_the_Ubuntu_Core_Filesystem
https://wiki.ubuntu.com/Core
http://cdimage.ubuntu.com/ubuntu-core/
https://github.com/DavidBercovitz/ubuntu-core
https://wiki.ubuntu.com/Core/InstallationExample
http://www.mattfischer.com/blog/?p=514
https://wiki.ubuntu.com/PbuilderHowto
http://manpages.ubuntu.com/manpages/lucid/man8/pbuilder.8.html
<br>
[[Category:Ubuntu]][[Category:Software distributions]]
<br>
