All Forums
 Embedded Linux
 Linux Downloads and Documents
 Full Debian Distribution 2006-08-29 (Etch)
 Forum Locked
 Send Topic to a Friend
 Printer Friendly
Author Topic  

jhess

135 Posts

Posted - 31 Aug 2006 :  15:28:03  Show Profile  Email Poster

Full Debian Distribution 2006-08-29 (Etch)

This is a full linux root file system from the Debian (Etch) distribution for ADS embedded computer systems. This distribution is intended to be used on our platforms for development of embedded applications. It includes compilers, debuggers, libraries, etc. Additionally, Debian provides many thousands of optional packages that can be downloaded, installed and configured with a simple command.

Debian Root 2006-08-29


Debian comes in three versions: 'stable', 'testing', and 'unstable'. 'testing' is the version provided in this distribution. Debian 'testing' is reliable, but it changes on a daily basis. This tar file contains a snapshot of 'testing'.

Initrd for Debian Root 2006-08-29 is an initial ramdisk that is needed to bootstrap the Debian root file system when booting from a microdrive.

The shell script, debian_install.sh, can be run on a Linux system and will install a kernel, the root file system and the initrd (initial ramdisk) on a hard drive such as an Hitachi Microdrive (TM) an external USB drive, or an IDE drive. The script reformats the hard drive and creates three partitions:

  1. kernel and initial ramdisk
  2. swap space
  3. EXT3 root file system


README-install.txt is a text file that describes the use of the debian_install shell script and provides notes regarding the root file system, initrd, etc.

The following files are included in this release:
portal/root_config_usb.txt
portal/tty_config.txt
portal/root_config.txt
portal/start.txt
portal/hw_config.txt
portal/root_config_usb_install.txt
bitsyXb/root_config_usb.txt
bitsyXb/tty_config.txt
bitsyXb/root_config.txt
bitsyXb/hw_config_16bpp.txt
bitsyXb/start.txt
bitsyXb/root_config_usb_install.txt
sphere/root_config_usb.txt
sphere/tty_config.txt
sphere/root_config.txt
sphere/hw_config_16bpp.txt
sphere/start.txt
sphere/root_config_usb_install.txt
sphere/root_config_ide_install.txt
vix/root_config_usb.txt
vix/tty_config.txt
vix/root_config.txt
vix/hw_config_16bpp.txt
vix/start.txt
vix/root_config_usb_install.txt
debian-root.tar.gz
MD5SUMS
README-install.txt
debian_install.sh
cmdline_bitsyx.txt
ramdisk.gz
initrd.gz
cmdline.txt
README.txt
700050-4101k.partno


Installation
Download the files from the links above and follow the instructions in the README-install.txt file to install the image to a USB disk, microdrive, or IDE disk.

For systems such as the BitsyXb, Sphere, VIX, and Portal, which use the u-boot bootloader, a set of u-boot configuration files is needed. See this topic for all the available files, download the appropriate files and copy them to a compact flash card. Note that you will need at a minimum start.txt, full root root_config.txt, and a tty_config.txt file for your system. A hw_config.txt file for your system's frame buffer is recommended for best performace of the X Window System.

Also copy onto the card the kernel zImage file for the kernel you want to use.

Review our FAQs regarding handling of Hitachi Microdrives (TM).

For additional information about using a USB hard drive or NFS, see our topic on running full Debian without a Microdrive.


Login
The root password for the ADS Debian distributions is 'rootme'. After installing the system, you should begin by logging is as 'root' on the serial port (debug port), and using the "passwd" command to change this password.

Normally, the serial (debug) port on ADS boards is also the system console. You can change this by changing the value of 'console=' on the kernel command line (cmdline.txt) or tty_config.txt file. See the appropriate bootloader manual for your ADS board for more details.

There is an additional command line option, 'SERIALGETTY=', which controls which serial port is used for logins. This can be different from the 'console=' parameter, which controls which terminal recieves the kernel messages.

There is also an optional command line option, 'SERIALBAUD=', which controls the speed of the serial port used for logins.


Configuring the network interface
By default, the ADS Debian distribution will attempt to auto- configure the network interfaces using DHCP. If you do not have a DHCP server on your network or you do not wish to use DHCP, you can configure a static IP address by editing the file /etc/network/interfaces and changing the line
 iface eth0 inet dhcp 
to read
 iface eth0 inet static address  netmask  broadcast  gateway  
Where the addresses are in dotted-quad notation (aaa.bbb.ccc.ddd)

You should also change /etc/resolv.conf to list the proper nameservers for your network.


Using your system for native development
The ADS Debian distribution comes with native compilers, editors and debuggers so you can begin developing your application directly on your embedded computer system. In most cases, you could even attach a keyboard and begin working without needing any other systems. However, most people find the VGA screen on the development kit too small for serious program development.

You can use 'ssh' from a linux workstation to access your embedded system over the network. ssh X-forwarding is enabled by default - allowing X clients running on the embedded board to display on your workstation screen. Once you log in to your board via ssh, you should have a DISPLAY environment variable set by ssh - DO NOT CHANGE IT or X forwarding will stop working.

Starting an X program (xterm, etc.) from your SSH session should automatically display the program on your Linux workstation.

The SSH daemon is not started automatically. See the notes below on SSH for more details.

The ADS Debian distribution comes with many common development libraries, including C, C++, x11 and gtk. See the section on 'Installing additional Debian Packages' for information on installing any development libraries you may need that are not included by default.

NOTE: Compiling a kernel or kernel modules natively on the system is not recommended. You should use the proper cross-compiler as listed in the 'Getting Started' section of the ADS Linux support pages


Installing additional Debian packages
Debian's 'apt-get' command allows you to easily install any of thousands of pre-compiled packages available for ARM. Before using apt, however, you must "update" it to ensure that it has access to the most recent list of packages.

By default, apt-get is configured to use the master Debian package repository for most packages, and suppliment this with a few ADS-specific packages from an ADS Debian package repository. While you can reconfigure apt to use a Debian mirror closer to you for better download speeds, we recommend that you leave the configuration for the ADS repository as-is so you can access sources and updates for ADS-specific packages.

A list of Debian's mirrors can be found at this URL: http://www.debian.org/mirror/list

After configuring apt, you should run
 apt-get update 
to pull the latest package lists from your chosen mirror.

After updating, you can install a package with the command
 apt-get install  
You can look at a list of thousands of Debian packages available for installation by visiting Debian's package site at http://packages.debian.org/

When searching or browsing the package list, you should select the 'testing' distribution. ('etch' is the code-name for the current 'testing' branch of Debian)

If you are going to downloading the same files from the debian site many times, you might consider setting up a proxy server like Squid on your server or workstation. Once you have squid working (you can test it with your browser), add a line like the following to the file /etc/apt/apt.conf for your server:
 Acquire::http::Proxy "http://192.168.1.1:3128"; 


Using SSH/SCP/SFTP
The Debian root filesystems now support ssh (and the companion SCP and SFTP protocols) for enhanced security for remote access. The ssh system has replaced telnet and ftp functionality with the more secure ssh and scp commands. Use 'man ssh' for more information. By default, the SSH server is not started but does allow root access. (This is a change from previous behaviour.) To start the ssh server, run '/etc/init.d/ssh start' from the command line. To make the system start SSH automatically at boot-time, create a symbolic link from /etc/rc3.d/S20ssh to /etc/init.d/ssh. This will start the ssh server automatically at runlevel 3 (runlevel 3 is the default).

The SSH daemon has been designed with security in mind, but no software can ever be 'bug-proof'. If you do not require network remote access, disable SSH by removing the ssh start files from the /etc/rc*.d directories.

Before you start the SSH server, please be sure you have at least changed the root password!

You should seek the advice of an experienced systems administrator or security professional before deploying a networked system.


Using FTP
FTP is not enabled by default. To enable the FTP daemon (server), edit /etc/inetd.conf and uncomment the line for the FTP service.

FTP is not a secure protocol! The authentication information (usernames, passwords) is sent over the wire in clear text! Wherever possible, users are encouraged to switch to SSH/SCP/SFTP.

When enabled, the FTP daemon allows anonymous upload to /usr/ftp/incoming. While the '731' permissions on this directory prevent an anonymous user from listing any files uploaded there, a user who knows the name of an uploaded file can retrieve it. This could allow malicious users to abuse the FTP service (by turning it into an illegal file drop or 'warez server') on a system that has the FTP daemon enabled.

If you need to enable non-anonymous FTP, you will need to edit the file /etc/pam.d/ftp (see the comments in that file). FTP access for the root user will still not be allowed; you should create a non-privileged user for FTP access.


Care and handling of disk drives
The microdrive or USB disk is much like the disk drive on your workstation. You are probably careful to shutdown your workstation before powering it off. You should be equally careful with Debian on the microdrive - run the shutdown command and wait for it to complete before removing the power from your board. Also, the Microdrive is a very fragile piece of equipment. It is especially sensitive to pressure on the top and bottom (large flat areas) of the drive. When handling a Microdrive, always hold it by its edges! To remove a Microdrive from a PCMCIA slot adapter, use your thumbnails to push it out of the adapter from the front (where the pins connect to the drive) rather than pulling the drive out from the back.


Verification
MD5SUMS provides MD5 checksums for all files in this release.


History
This distribution is a Debian Etch distribution for ADS embedded computer systems. It supercedes our previous 2006-05-26 Debian distribution. This filesystem features a new Xserver which uses Keith Packard's kdrive Xserver from freedesktop.org. Xads is a superset of Xfbdev, with additions to support SM501 HW copy and fill and Xvideo (on the VGX and Portal), support for Xvideo on the PXA270 (on the BitsyXb), and acceleration for the EP9315 on the Sphere.

  Topic  
 Forum Locked
 Send Topic to a Friend
 Printer Friendly
Jump To:
Eurotech Support Forums © Eurotech Inc. Go To Top Of Page
This page was generated in 0.06 seconds. Snitz Forums 2000