Come installare OpenWrt su un router con ap51-flash

Questo mini-howto spiega come installare OpenWrt su vari router, quali fonera, ubiquiti, Linksys WRT54GL, ed altri, tramite una utility chiamata ap51-flash.

Scaricare l'immagine di OpenWrt per il proprio router

Le immagini gia' pronte di OpwenWrt Kamikaze 8.09.2 si possono trovare qui:

http://downloads.openwrt.org/kamikaze/8.09.2/

I nomi delle directory rispecchiano i vari "target" supportati (la lista dei dispositivi supportati da OpenWrt ed i relativi target puo' essere trovata qui: http://oldwiki.openwrt.org/TableOfHardware.html). Nello specifico:

• fonera, ubiquiti NanoStation : http://downloads.openwrt.org/kamikaze/8.09.2/atheros/

• Wrt54Gl e asus wl500g: http://downloads.openwrt.org/kamikaze/8.09.2/brcm-2.4/

• ...

I file che devono essere scaricati di solito sono due:

• l'immagine del filesystem. I due formati principali sono JfFs2 e SquashFs. Il preferito a Ninux.org e' SquashFs. Il nome contiene la parola "root". Per esempio, per atheros: http://downloads.openwrt.org/kamikaze/8.09.2/atheros/openwrt-atheros-root.squashfs

• l'immagine del kernel. Il nome contiene la parola "vmlinuz", e di solito si usa l'LZMA. Per esempio, per atheros: http://downloads.openwrt.org/kamikaze/8.09.2/atheros/openwrt-atheros-vmlinux.lzma

Per alcuni target, invece, bisogna scaricare un unico file .bin che contiene sia l'immagine del filesystem che il kernel.

Scaricare e compilare ap51-flash

Per scaricare ap51-flash, una utility che permette di installare OpenWrt su vari dispostivi, bisogna fare il checkout della versione trunk e poi compilare. In altre parole, basta seguire la seguente procedura:

• installare il necessario per compilare sul proprio sistema (per debian/ubuntu sudo apt-get install build-essential)

• installare subversion sul proprio sistema (per debian/ubuntu: sudo apt-get install subversion)

• fare il checkout e compilare:

    svn checkout http://dev.open-mesh.com/downloads/svn/ap51-flash/trunk/ ap51flash
    cd ap51flash
    make 

Flashare il dispositivo, ovvero installare OpwenWrt sul router

Stando dentro alla directory ap51flash e digitando il comando ap51-flash senza parametri si ottiene l'help:

$ ./ap51-flash 
Usage:
./ap51-flash [ethdevice] rootfs.bin kernel.lzma   flashes your rootfs and kernel
./ap51-flash [ethdevice] ubnt.bin   flashes your ubiquiti image
./ap51-flash -v   prints version information

The 'ethdevice' has to be one of the devices that are part of the supported device list which follows.
You can either specify its name or the interface number.

Quindi:

• tenere il dispositivo/router spento, scollegato dall'alimentazione, ma attaccato con un cavo di rete alla porta ethernet del PC.

• usare ap51flash come super-user e come spiegato nell'help. Per esempio, se l'immagine del filesystem e del kernel per il target atheros si trovano dentro alla propria home, digitare:

  $ sudo ./ap51flash eth0 openwrt-atheros-root.squashfs openwrt-atheros-vmlinux.lzma

• dopo aver digitato il comando al punto precedente, e quindi dopo aver fatto partire ap51-flash, collegare l'alimentazione al router. Per alcuni router (ubiquiti, wrt54gl, asus wl-500g) bisogna tenere premuto il tasto "reset" mentre si collega l'alimentazione.

• ap51-flash si occupera' di installare OpenWrt e di notificarvi quando il lavoro sara' concluso. Durante questa fase non scollegare il router ne' dall'alimentazione ne' dal cavo di rete, altrimenti il router potrebbe diventare inservibile!

Finito!

Quando l'installazione sara' conclusa, il router sara' raggiungibile all'indirizzo IP 192.168.1.1. La prima volta entrate in telnet (telnet 192.168.1.1) e modificate la password di root (sul terminale del telnet passwd).

Buon divertimento!