image.sh Instructions
- Build Machine
- release.sh Instructions
- image.sh Instructions
- Customization
- Write Image
- Post Installation
- Known Issues
 | Project Status Please note that this project is no longer active. If you are interested in taking over the code base please let me know. |
Overview
The image.sh script takes the binary packages and uses the host build machine to create a compact flash bootable image.
The image.sh script is part of the zip on the Downloads page but can be viewed here. It will create an soekris.img file in /root/greenfrog/image.
The script is based on install.md and on Makefile.inc.
The script includes the following steps:
- Create an empty disk image based on the compact flash geometry.
- Mount the disk image as a virtual device
- Prepare the filesystem, disklabel, fdisk and create a new filesystem.
- Mount the new filesystem untar the binaries, install the GENERIC kernel.
- Finish installing the OS (installing the reduced /etc/rc, /etc/fstab etc).
- Unmounting the filesystem and virtual device.
Compact Flash drive geometry
Compact flash cards are like hard drives and have certian physical geometries. The drive geometry that the destination device reports when the compact flash card is installed is required for the image.sh script.
Soekris drive geometry
To get compact flash card geometry from the Soekris device, insert the compact flash card into the Soekris, connect a serial console and turn it on. On the boot screen will display the drive geometry as the device detects it.
 | Tip Hyperterm on Windows or minicom on Linux can be used with a serial cable as a serial console. |
 | Example If the Soekris net4501 displays this in the top right corner of the screen at startup: LBA 1006-16-63 Then Cylinders-Heads-Sectors/Track are 1006-16-63 for this card. |
Other device drive geometry
In general, most devices have a BIOS mode that will show the drive geometries of installed devices.
Running image.sh
Edit the greenfrog.conf and set the drive geometry variables:
CYLINDERS=1006 HEADS=16 SECTORSPERTRACK=63
To run the image.sh script, as root type:
./image.sh all
| Please be aware The root password for the image is taken from the build machine. |
Next Customization.