Version 8 (modified by seskar, 9 years ago) ( diff )

Go back —> Documentation

Creating custom OS images

In order to use an OS other than the ones provided with stock images (Ubuntu based images), you can either provide your own (frisbee) image of the OS of your choice (that was prepared off-site) or use the netboot method on ORBIT infrastructure. Regardless of the method, the resulting image should support:

  • a serial console (@115K, 8, n, 1) on the first serial port
  • driver support for 2 gigabit network card
  • and dhcp on the 2nd wired gigabit network interface

Installing custom OS with PXE netboot method

The metod is based on Preboot Execution Environment (PXE) which is using a combination of DHCP and tftp services to download initial installation package (network installer software and it's configuration) onto the node. Once the installation package is downloaded, the control transfers to the installer.

Please be sure the installer for the OS of your choice provides a serial console on the first serial port (@115K,8,n,1) and has appropriate network drivers.

We will illustrate this process on the natty

  • The XML interface is self explanatory.
  • Copy your boot script to your tftp server (e.g. /tftpboot on repository1)
  • Configure the boot behavior of your node via the PXE aggregate manager.

The PXE aggregate manager at:


will show you all of the available URLs. What you need to use is:




You have to come from the domain console to use this service (i.e. if you are working with the node in sb1 you have to issue this on console.sb1).

To interact with your node, follow the instructions on our FAQ concerning interaction via serial consoles

After you have an image, simply use

omf save x,y

to save the image of the node in our repository for further use

Ubunty natty installation example

Create /tftpboot/ubuntu-natty direcotry and download network appropriate installation files:

guest@repository1.:/tftpboot# mkdir ubuntu-natty
guest@repository1.:/tftpboot# cd ubuntu-natty
guest@repository1.:/tftpboot/ubuntu-natty# wget
--2011-09-13 10:00:46--
Resolving,,, ...
Connecting to||:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 4521296 (4.3M) [text/plain]
Saving to: `linux'

100%[========================================>] 4,521,296   1.46M/s   in 2.9s    

2011-09-13 10:00:49 (1.46 MB/s) - `linux' saved [4521296/4521296]

guest@repository1.:/tftpboot/ubuntu-natty# wget
--2011-09-13 10:00:59--
Resolving,,, ...
Connecting to||:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 7987143 (7.6M) [application/x-gzip]
Saving to: `initrd.gz'

100%[========================================>] 7,987,143   2.26M/s   in 3.4s    

2011-09-13 10:01:03 (2.26 MB/s) - `initrd.gz' saved [7987143/7987143]


Create pxe configuraiton file in /tftpboot/pxelinux.cfg/ubuntu-natty that instruct PXE process to download installer kernel and filesystem from /tftpboot/ubunty-natty directory:

SERIAL 0 115000 0
LABEL ubuntu-natty
# ubuntu installer is installed in /tftpboot/ubuntu-natty (linux and initrd.gz).
KERNEL ubuntu-natty/linux
APPEND initrd=ubuntu-natty/initrd.gz ramdisk_size=32768 root=/dev/rd/0 rw contrpre
seed/locale=en_US kbd-chooser/method=us netcfg/choose_interface=eth1 --

Wiki page "Software/fImages/SaveNode" does not exist

Note: See TracWiki for help on using the wiki.