| 1 | = Creating custom OS images = |
| 2 | |
| 3 | In order to use an OS other than the one currently supported (Debian Linux kernel 2.6.12), you may do one of the following |
| 4 | * 1) provide your own (frisbee) image of the OS of your choice '''or ''' |
| 5 | * 2) install the OS of your choice on our nodes from scratch. |
| 6 | |
| 7 | == For Approach 1) == |
| 8 | Here are a few guidelines |
| 9 | * when you create your image, it occupies less than 20gb (make that 15 to be safe). |
| 10 | * your OS image supports the following: |
| 11 | * a serial console @9600,8,n,1 on the first serial port |
| 12 | * driver support for 2 Marvell gigabit network card |
| 13 | * and dhcp on the 2nd wired interface. |
| 14 | * have wireless drivers (Atheros and Intel) support and a set of corresponding utilities installed |
| 15 | |
| 16 | After you have an image, simply use |
| 17 | {{{ |
| 18 | saveNode x,y |
| 19 | }}} |
| 20 | to save the image of the node in our repository for further use |
| 21 | |
| 22 | == For Approach 2) == |
| 23 | Our nodes support installation of any OS via network installers. |
| 24 | |
| 25 | Please be sure the installer for the OS of your choice provides |
| 26 | a serial console on the first serial port @9600,8,n,1 and has network |
| 27 | drivers for the Marvell gigabit network cards (I believe they are officially |
| 28 | Yukon compatible but I believe Marvell cards are mostly identical). |
| 29 | |
| 30 | * The PXE service can be queried from any console at http://pxe:5012/pxe/. |
| 31 | * The XML interface is self explanatory. |
| 32 | * Copy your boot script to /tftpboot on repository2 and control the boot behavior of your node via the PXE service. |
| 33 | |
| 34 | To interact with your node, follow the instructions on our FAQ concerning |
| 35 | interaction via serial consoles |
| 36 | |