PDF de programación - Linksys WRT54G y DD-WRT - Guía práctica

Servicio de Información Mesoamericano sobre Agricultura Sostenible (SIMAS)
Linksys WRT54G y DD-WRT - Guía práctica (ultima revisión:junio 2006)

Linksys WRT54G y DD-WRT - Guía práctica
1

Introducción
Este documento es una guía práctica con explicaciones básicas de la teoría y ejemplos
de configuración, para entender el funcionamiento y la configuración de un router
Linksys WRT54GL -o cualquier otro tipo como G, GS, WAP54G, etc.- usando el firmware
DD-WRT. El documento no pretende dar una descripción completa del firmware DD-
WRT (OpenWrt o Linux), sino un mejor entendimiento del uso y las posibilidades de DD-
WRT.

Para comprender en más detalle como funciona el firmware y todas sus opciones u
OpenWrt en general, se recomienda estudiar las documentaciones en Internet, en por su
mayoría en ingles.

• Sito principal de DD-WRT: www.dd-wrt.com
• Descargar firmware DD-WRT: http://www.dd-wrt.com/dd-wrtv3/dd-wrt/downloads.html
•

Instalación de firmware DD-WRT (español): http://www.dd-
wrt.com/wiki/index.php/Instalaci%C3%B3n

• Wiki de DD-WRT (en primer lugar ingles y alemán, sino también algunas cosas en

español): www.dd-wrt.com/wiki/index.php/Main_Page

• Forum de DD-WRT: www.dd-wrt.com/phpBB2
• Sitio principal de OpenWrt: openwrt.org
• Página alternativa con ejemplos de configuración: www.geek-pages.com

2

2.1

Componentes del Router y Firmware
El router Linksys inalámbrico se ofrece en varios modelos y tipos. Por razones de
memoria, el firmware de DD-WRT no soporta todas las versiones de hardware o con
limitaciones. Por eso se recomienda leer esto, antes de comprarlo (solo inglés):
• http://www.dd-wrt.com/wiki/index.php/Linksys_WRT54G/GL/GS/GX
• http://en.wikipedia.org/wiki/Wrt54g

Sistema Operativo y Comandos
El sistema operativo esta basado en una versión light (simplificado) de OpenWRT
(Linux) que se llama BusyBox. Una descripción más completa de BusyBox se encuentra
en: www.busybox.net/downloads/BusyBox.html

Por defecto el nombre de usuario es root y la contraseña admin (para la sesión (Telnet)
igual como el Web-GUI.

La siguiente tabla da una breve explicación de los comandos que se usará en esta
documentación.

Markus Erb

Página 1/31

WRT54Gx_Guia_practica.doc

Servicio de Información Mesoamericano sobre Agricultura Sostenible (SIMAS)
Linksys WRT54G y DD-WRT - Guía práctica (ultima revisión:junio 2006)

Comando
<comando> --help o –h o –?
more <archivo>
more /etc/hosts
<comando> ¦ more
nvram show ¦ more
(para salir crt+z)
less <archivo>
less /etc/hosts
comando ¦ less
nvram show ¦ less
(para salir :q)
grep <texto> <archivo>
grep 127.0.0.1 /etc/hosts

find <directorio> -name <archvio>
find /etc -name hosts
find ¦ grep hosts
cat <archivo>
cat /etc/hosts
echo '<text>'
echo 'Hola clase'
echo '<text>' > <archivo>
echo '<text>' >> <archivo>
echo 'hola clase' >> saludos.txt
chmod <opción> <archivo>
chmod +x /jffs/config/rcS
chmod u-x /jffs/config/rcS

ls
ls -l
ls -L
ls -i
ls -A
ls -n
ifconfig <opción> <interfaz> <dirección>
ifconfig
ifconfig –a
ifconfig br0 up
netstat <optión>

-a
-e
-l

Efecto
Mostrar la ayuda del comando (si existe!)
Mostrar contenido de archivo en segmentos por
pantalla

Mostrar contenido de archivo con la posibilidad
de mover la posición

Buscar texto en un archivo
Nota: No funciona en combinación con find para
buscar texto en un todos los archivos
Buscar archivo en directorio y subdirectorios

Concatenar archivo(s) e imprimir contenido en
dispositivo de salida (por defecto en la pantalla)
Imprimir texto en dispositivo de salida (por
defecto en la pantalla)
En combinación con:
> guardar texto en archivo
>> agregar texto a archivo existente
Cambiar modo (permiso) de archivo
Opciones son uno o varias de las letras ugoa
(u:usuario, g:grupo, o:propietario, a:todos), uno
de los simbolos +-= (+:agregar, -:quitar, =:igual) y
uno o varias de las letras rwxst (r:leer, w:escribir,
x:ejecutar, s:¿?, t:¿?)
Listar contenido de directorio
- con forma completa
- con enlaces lógicos
- con i-node
- sin ocultar registros con . y ..
- en forma numérica
Configurar interfaz y dirección IP
Listar las interfaces activas
Listar todas (también inactivas)
Iniciar interfaz br0
Listar los enlaces de transporte (tcp y udp)
Todos los enlaces (escuchando y conectado)
Enlaces solo conectados (tcp y udp)
Enlaces solo escuchando

Markus Erb

Página 2/31

WRT54Gx_Guia_practica.doc

Comando

-r
-t
-u
-n

df

mount

Servicio de Información Mesoamericano sobre Agricultura Sostenible (SIMAS)
Linksys WRT54G y DD-WRT - Guía práctica (ultima revisión:junio 2006)

Efecto
Tabla de routing
Enlaces solo conectados, tipo tcp
Enlaces solo conectados , tipo udp
Información en forma numérica
Listar sistema de archivo con espacio usado y
disponible
Listar los discos físicos conectados. Los valores
mostrados son (equipo/disco; punto de conexión
[archivo]; tipo del sistema de archivo; solo leer
[ro], leer/escribir [rw]; dos campos no usados)
Montar directorio-1 a directorio-2

mount --bind <dir-1> <dir-2>
mount --bind /tmp/newhosts /etc/hosts
cat /proc/mounts
PATH="/sbin:/usr/sbin:/bin:/usr/bin:${PATH}" Agregar un directorio a los directorios globales

Listar los discos y directorios montados

2.2

NVRAM
El NVRAM (Non Volatile Random Access Memory) guarda todos los valores de las
variables que se usa para iniciar el router. Nota: Un error o daño en el NVRAM puede
causar que el router no inicie correctamente y que se pierda el control del router. En este
caso hay que consultar la página Web de DD-WRT o similares para buscar como
resolver este problema: www.dd-wrt.com/wiki/index.php/Index:FAQ

Comando
nvram show
nvram show ¦ grep <argumento>
nvram get <variable>
nvram set <variable>
nvram unset <variable>
nvram commit

Efecto
Listar valores del NVRAM
Listar solo valores que contienen el argumento
Obtener valor de variable del NVRAM
Poner valor de variable de NVRAM (solo en RAM)
Borrar valor de variable de NVRAM (solo en RAM)
Escribir valores en RAM a NVRAM

Ejemplo:
~# nvram show ¦ grep vlan0
vlan0hwname=et0
vlan0ports=3 2 1 0 5*
lan_ifnames=vlan0 eth1 eth2 eth3
~#

2.2.1 Variables rc_startup, rc_firewall, rc_shutdown

A parte de las variables del NVRAM existen también los comandos del sistema operativo
para configurar el router. Sin embargo, debido a que el sistema de archivo del Linksys no
permite escribir (con la excepción del JFFS) los cambios hechos, una vez iniciando el
equipo, se pierde cada vez que se reinicia.

Markus Erb

Página 3/31

WRT54Gx_Guia_practica.doc

Servicio de Información Mesoamericano sobre Agricultura Sostenible (SIMAS)
Linksys WRT54G y DD-WRT - Guía práctica (ultima revisión:junio 2006)
Para permitir ejecutar comandos durante el arranque del router, el NVRAM contiene la
variable rc_startup. Todos los comandos que asignados a la variable rc_startup se
ejecutaran sucesivamente cuando inicia el router. Eso es indispensable para la
administración de los bridges, las direcciones IP.

Para comandos y reglas del Firewall (cortafuego) existe la variable rc_firewall y para
comandos que se ejecuten antes de apagar el equipo, la variable rc_shutdown.

Existen dos maneras para asignar los comandos:

• En Administración -> Diagnóstico del Web GUI se permite asignar comandos al
variable rc_startup usando el botón Grabar Arranque y a la variable rc_firewall con el
botón Grabar Firewall. Además se puede ejecutar cualquier comando. Sin embargo
Ejecutar Comandos no graba el comando.

• Usando la consola se puede teclear nvram set rc_startup=' y poner comando por
comando (Nota: cambia el prompt de # a >). Después del último comando y para salir
de la variable, hay que poner el ' (coma alto). Asignar comandos a las variables
rc_firewall o rc_shutdown se hace de la misma manera, usando la variable
correspondiente.

# nvram set rc_startup='
> brctl addbr br2
> brctl addif br2 vlan2
> brctl stp br2 on
> ifconfig br2 192.168.2.1 netmask 255.255.255.0
> ifconfig vlan2 up'
#

2.3

JFFS (Journaled Flash File System)
En general el sistema de archivo del Linksys no permite escribir o guardar archivos. Eso
es un problema porque no permite guardar archivos y programas personales. Para
superar esta limitante, se implementó a partir de la versión 2.3 SP2 el JFFS para guardar
archivos pequeños. Sin embargo, la versión dd-wrt.v23_generic.bin no ofrece
suficiente memoria disponible para activar JFFS. Debido a eso hay que usar dd-
wrt.v23_nokaid_generic.bin o dd-wrt.v23_mini_generic.bin que no ofrecen todas las
opciones sino espacio de memoria.

Los siguientes dos comandos de la consola muestran los discos y espacios disponibles.
Nótese que el espacio del JFFS se limita a solo 576 kByte de memoria.

Markus Erb

Página 4/31

WRT54Gx_Guia_practica.doc

Servicio de Información Mesoamericano sobre Agricultura Sostenible (SIMAS)
Linksys WRT54G y DD-WRT - Guía práctica (ultima revisión:junio 2006)

• df (listar sistema de archivos)

/ # df
Filesystem 1k-blocks Used Available Use% Mounted on
/dev/root 2624 2624 0 100% /
/dev/mtdblock/4 576 324 252 56% /jffs
/ #

• mount (discos conectados)

/ # mount
/dev/root on / type squashfs (ro)
none on /dev type devfs (rw)
proc on /proc type proc (rw)
ramfs on /tmp type ramfs (rw)
/dev/mtdblock/4 on /jffs type jffs2 (rw)
/ #

Por defecto el JFFS esta desactivada. Existen dos posibilidades para activarlo:

• En Administración -> Administración del Web GUI se permite activar el JFFS2. Si
se hace por primera vez hay que activar también Limpiar JFFS2. Después del
reinicio del router, eso va automáticamente a Desactivar

• Usando la consola se puede usar las variables del NVRAM para activar e limpiar el

JFFS

# nvram set jffs_mounted=1
# nvram set enable_jffs2=1
# nvram set sys_enable_jffs2=1
# nvram set clean_jffs2=1
# nvram set sys_clean_jffs2=1

Una vez ac