Note

To compile an OpenMCT image you have to install at least gcc, make, automake and svn on your build host system. You also need several other tools, like SquashFS or JFFS2 to create filesystems for the image.

Get OpenMCT Source

First of all you have to download the OpenMCT source tree via svn. This can be done with the following command:

$ cd ~
$ svn co http://svn.openmct.org/svn/trunk/openmct/ ~/openmct
.....
Checked out revision 284.
$

Now you have the complete source tree in the openmct directory.

Prepare OpenMCT for build process

Before you build the Image you have to know which product code will be used for your image. Look at the following list, to get the correct product code:

• 0x4 : Claxan SA 110 / Claxan SA 113 / Intellinet SOHO SERVER / Tritton TRI-ASA1120/200
• 0x5 : Claxan NAS 110 / Intellinet SOHO NAS / Tritton TRI-NAS080/120/200
• 0x6 : IO BOSS

Now you have to choose which packages should be included in your OpenMCT image. At the moment you can choose from the following list:

• dnrd
• iptables
  
• dropbear
  
• smartmontools
• rsync
• ppp
• pptpd
• pptp
• portmap
• debootstrap
• vserver
• debianvserver
• nfsutils
• fcp
• vsftpd
  
  

Configure OpenMCT

Then you create your own config file by running make with parameter config and variable MCT. Afterwards you can change the default settings by editing .config.

$ make config MCT=sa
CONFIGURE OpenMCT
$ vi .config
...
$

The config file contains some variables, that can be changed. Have a look at the following list:

• IMAGEPRODCODE
  This variable contains the product code
  
• IMAGEMODE
  This variable must be 0x503
  
• IMAGEVERSION
  Here you can define your OpenMCT image version. OpenMCT 1.0 uses 0x100, Claxan SA 1.56 uses 0x156
  
• IMAGESUBVERSION
  Just another information for your image. This should be the actual revision number
  
• IMAGEFLASHKERNELSIZE
  This value defines the maximum kernel size. Its important that there will be enough space for the kernel image.
  An OpenMCT kernel image with nearly all features requires about 1033 KB. Default Size is 1088.
  
• IMAGEFLASHROOTSIZE
  Here you can define the size for your root filesystem (SquashFS format). Default value is 2112. For example the OpenMCT root SquashFS requires about 2072 KB and contains 7 MB of data files.
  
• IMAGEFLASHETCSIZE
  Finally you can also set the size of /etc filesystem (JFFS2 format). Default value is 704.
• IMAGEFILENAME
  Well just define an output image filename
• IMAGERELEASEFILENAME
  Here you can define a filename, that will be used in /etc directory for the image information
• IMAGEHOSTNAME
  Just define your hostname here
• ETH0IPADDR
  Define your eth0 default IP address here (this is the WAN ip address when you use a SA)
• ETH1IPADDR
  This IP address can only be used when you have a SA (with LAN and WAN interface). This will
  be the IP address of the LAN interface.
  

NOTE: IMAGEFLASHKERNELSIZE + IMAGEFLASHROOTSIZE + IMAGEFLASHETCSIZE = 3904

To change the kernel config you have to edit packages/system/linux/configs/config. For example if you don't want GRSecurity Support or PPPOE you can disable this. You can also enable another features, that are not enabled
in the default configuration.

You also have to set the variable IMAGEPACKAGES. Here you have to specify which packages should be included in your Image.

IMAGEPACKAGES=  packages/base/busybox \
                packages/base/coreutils \
                packages/net/dnrd \
                packages/net/dropbear \
                packages/net/iptables \
                packages/net/nfsutils \
                packages/net/ntp \
                packages/net/ppp \
                packages/net/pptp \
                packages/net/pppoe \
                packages/net/rsync \
                packages/net/tcpwrapper \
                packages/net/portmap \
                packages/net/pptpd \
                packages/net/vsftpd \
                packages/system/debootstrap \
                packages/system/fcp \
                packages/system/proccgi \
                packages/system/smartd \
                packages/system/vserver \
                packages/system/vserverdebiantools \
                packages/system/webadmin

Set Mountpoint for Harddisk

OpenMCT uses /usr as mountpoint for the harddisk. You can change this in the base fstab file in
packages/build/buildroot/configs/fstab. You can also change the directory for your files in /etc.

$ cat configs/root/etc/fstab
proc    /proc           proc    defaults         0 0
tmpfs   /tmp            ramfs   defaults         0 0
/dev/mtdblock/3         /etc    jffs2   defaults 0 0
/dev/discs/disc0/part1  /usr    ext3    defaults 0 0
$

Build your OpenMCT Image

So, you simply have to type make to build your OpenMCT image.

$ make
WGET linux-2.4.32
...
[*] writing header to file 'OpenMCT_0x100_0x00_0x04.bin'...
[*] writing kernel to file 'OpenMCT_0x100_0x00_0x04.bin'...
[*] writing ramdisk to file 'OpenMCT_0x100_0x00_0x04.bin'...

Now you have a complete OpenMCT in your current directory.

Have fun