Nw conf

De LugroMesh

Favor de editar esta página para agregar más contenido

El presente documento sirve de ayuda para utilizar el sistema de configuración nw_conf que viene por defecto en el firmware Nigthwing.

Tabla de contenidos

Sobre el sistema de configuración

nw_conf fue pensado para realizar configuraciones a los nodos desde una interface sencilla. Consta de una serie de menús los cuales se van accediendo vía teclado y permiten desde la configuración de las claves, hasta aspectos más avanzados que permiten que el firmaware pueda ser usado para otras redes distintas a LUGRo-Mesh.

La forma de acceder al sistema de configuración es mediante acceso vía ssh al nodo, ya sea desde la interface privada o la LAN, como se puede ver en la documentación Ingresar al router una vez que ha sido flasheado con Nightwing y ejecutar el comando nw_conf:

root@nightwing:~# nw_conf

Menú Principal

====================================================
    _   ___       __    __           _
   / | / (_)___ _/ /_  / /__      __(_)___  ____ _
  /  |/ / / __ `/ __ \/ __/ | /| / / / __ \/ __ `/
 / /|  / / /_/ / / / / /_ | |/ |/ / / / / / /_/ /
/_/ |_/_/\__, /_/ /_/\__/ |__/|__/_/_/ /_/\__, /
        /____/ The beauty of simplicity  /____/
    >< http://nightwing.lugro-mesh.org.ar/ >< 
	      >< (C) 2008 - 2010 ><
  This program comes with ABSOLUTELY NO WARRANTY
   This is free software, and you are welcome to 
     redistribute it under certain conditions
====================================================
 N I G H T W I N G  M E N U 
 1 . See node values 
 2 . Basic Config
 3 . Advanced Config
 4 . BMX Config
 5 . Exit
Select an option [1 - 5]:

1 . See node values

En este punto se pueden ver los valores con los que está configurado el nodo. El mismo también se encuentra presente vía la página web del nodo en la solapa Info. En caso que el nodo esté en modo cliente se mostrara, si es que puede establecer comunicación con otro nodo, cual es su nodo gateway, es decir, aquel que le permite salir a Internet. Gateway IP: 5.x.y.z


**************** Node values ******************
***********************************************
Node ID: 1111
Firmware Version: 0.7
Node Mode: gateway
Gateway Class: 1024
Routing Class: 1
Host Name: nightwing
Server Log IP: xxx.xxx.xxx.xxx
Visualisation Server: 69.61.11.215
Node Channel: 11
Wireless Mode: 11g
Antenna Mode: auto
Mesh BSSID: 02:ca:ff:ee:ba:be
Node TS: Mode Disable
Share Rate: 1024 kbps
Public AP SSID: lugro-mesh-1111
Private AP SSID: lugro-secure-1111
WiFiDog Server: wifidog.lugro-mesh.org.ar
WiFiDog SSL: yes
Current DNS: 69.61.11.215
Press any key to continue [enter] . . .

2 . Basic Config

**************** Basic Config *****************
***********************************************
a. Change Root password
b. Change WPA2 passphrase
c. Change Web admin access
d. Change WiFiDog access
e. Change Host Name
f. Change Wireless mode
g. Change Traffic Shaping Configuration
h. Back to main menu

Select an option [a - h]:

a. Change Root password

Mediante éste comando se podrá cambiar la password de root (único usuario para acceder vía ssh al nodo) que por defecto es lugro-mesh

Se sugiere cambiar la password por defecto.

b. Change WPA2 passphrase

Mediante éste punto en el menú se puede cambiar la password por defecto para poder ingresar a la interface privada del nodo. La clave por defecto es Lugr0-mesh. Se sugiere cambiar la password por defecto.

Tener en cuenta que la clave tiene que ser superior a 8 caracteres e inferior a 63, caso contrario el sistema reportará que el largo de la misma no es aceptable.

c. Change Web admin access

El firmware cuenta con un sistema de configuración vía web o Web Admin que permite ver información del nodo y realizar la actualización del mismo mediante la utilización de las imágenes combined que están en la sección download del sitio web de Nightwing. El usuario por defecto es admin y la clave lugro-mesh. Este punto del menú permite que se cambie la password por defecto.

d. Change WiFiDog access

Dado que existe lo que consideramos un error en el componente wifidog gateway permite ver las mac address de quienes estén conectados al nodo por la interface pública y desde la propia interface pública, sin pedir usuario y contraseña. Por ello, se ha agregado un usuario y pass para que se pueda ingresar. Por defecto el usuario es admin y la clave es Lugr0-mesh. Con éste punto se podrá cambiar tanto el usuario como la password para ingresar a este punto. Se sugiere cambiar la password por defecto.

e. Change Host Name

Este punto sirve para cambiar el nombre del nodo (el que se muestra luego de root@ al entrar vía ssh). Por defecto el mismo se llama nightwing.

f. Change Wireless mode

En éste punto se puede optar por alguno de los tres modos 802.11 soportados por el firmware

  • 11b
  • 11bg
  • 11g

Por defecto se encuentra en 11g

g. Change Traffic Shaping Configuration

El firmware integra un sistema de traffic shaping (o TS) que puede ser habilitado o no. Por defecto el sistema de TS está deshabilitado y con un valor de 1024 kbps. Este valor también es utilizado para setear el gateway class de bmx y es el valor que se anuncia en la mesh y solo tiene sentido en modo gateway. Dado que se quiere mostrar la realidad de la cantidad de ancho de banda a Internet que el dueño del nodo quiere ofrecer a la red, se sugiere configurar el valor deseado aunque no se habilite el TS. De está forma se estará informando a la red mesh de un dato que sirve para determinar las mejores rutas posibles.


El menú que se verá al ingresar en este punto es el siguiente:

**************** Traffic Shapping *************
***********************************************
a. Enable/Disable Traffic Shapping
b. How Much Do You Want To Share
c. Back to main menu
Select an option [a - c]:
a. Enable/Disable Traffic Shapping

Este punto permite habilitar o deshabilitar el sistema de traffic shaping (o TS).

b. How Much Do You Want To Share

Este punto permite especificar en kbps la cantidad de kilobits por segundo que quieren ser anunciados en la mesh y limitado vía traffic shaping. Al momento de cambiar el valor y en caso de que esté habilitado el TS, se reiniciara el mismo para poder tomar los valores nuevos.

c. Back to main menu

Regresa al menú anterior

h. Back to main menu

Regresa al menú anterior

3 . Advanced Config

*************** Advanced Config ***************
***********************************************
a. Change Channel
b. Change Antenna Mode Selection (Only for capable device)
c. Change Log Server IP
d. Change Mesh BSSID
e. Change WiFiDog Server
f. Change WiFiDog SSL
g. Change DNS
h. Change Public AP SSID
i. Change Private AP SSID
j. Change Visualisation Server
k. Return to Factory Default 
l. Back to main menu
Select an option [a - l]: 

a. Change Channel

Este punto permite cambiar el canal por defecto en el que está funcionando el nodo. Por defecto el canal es el 11.

b. Change Antenna Mode Selection (Only for capable device)

En caso de contar con un dispositivo con antena externa, este punto permite seleccionar la misma. Para poder realizar el cambio se utiliza la primer letra de cada uno de los modos:

Select [a]uto - [h]orizontal - [v]ertical - [e]xternal :

Los modos incluyen polarización horizontal o vertical.

Por defecto el modo se encuentra en vertical lo cual sirve para todos los dispositivos utilizados en el proyecto. En caso de requerir utilizar una antena externa como el soportado por los dispositivos Nanostation2 y Bullet2 se tendrá que configurar el modo a external.

c. Change Log Server IP

Dado que se trabaja con dispositivos de muy bajo almacenamiento, el firmware está preparado para poder enviar los logs del mismo a un servidor de logs externo. En éste punto se deberá poner la dirección ip del mismo.

d. Change Mesh BSSID

La red LUGRo-Mesh posee su propio BSSID (Basic Service Set Identifier) que es un identificador de 48 bits que identifica al BSS (Basic Service Set). Si se requiere crear un nuevo BSS este identificador puede ser cambiado con éste punto.

e. Change WiFiDog Server

La red LUGRo-Mesh utiliza un servidor de Wifidog configurado en un servidor en Internet . La configuración para la red LUGRo-Mesh es wifidog.lugro-mesh.org.ar. En caso de necesitar crear otra red o utilizar otro servidor, este punto puede ser cambiado por el FQDN del servidor a utilizar.

f. Change WiFiDog SSL

Wifidog puede utilizar SSL para el portal. Esta opción es la que está por defecto configurada. En caso de que el servidor de wifidog que se utilice no soporte SSL este punto puede ser cambiado.

g. Change DNS

Para los usuarios conectados a la interface pública o para los que accedan a través de la red MESH, se utiliza un servidor de DNS en particular, lo cual permite la utilización del sistema de [Software_Utilizado#OpenDNS|OpenDNS] configurado en LUGRo-Mesh.

h. Change Public AP SSID

El SSID (Service Set IDentifier) es un código incluido en todos los paquetes de una red inalámbrica. En el caso del AP Público de la red LUGRo-Mesh se utiliza:

lugro-mesh-{NODO_ID}

Donde NODO_ID es calculado en forma automática y no puede ser modificado del SSID. Con este punto se puede cambiar la parte de "lugro-mesh-" para refleje la red que se está usando. Solicitamos a todos los que tienen un nodo de la red LUGRo-Mesh que no cambien éste punto.

i. Change Private AP SSID

El SSID (Service Set IDentifier) es un código incluido en todos los paquetes de una red inalámbrica. En el caso del AP Privado de la red LUGRo-Mesh que posee encriptación mediante WPA2 se utiliza:

lugro-secure-{NODO_ID}

Donde NODO_ID es calculado en forma automática y no puede ser modificado del SSID. Con este punto se puede cambiar la parte de "lugro-secure-" si se requiere.

j. Change Visualisation Server

La conexiones entre los nodos son informadas al servidor central para poder generar un grafo de conexión y mostrar los vínculos en el mapa de la red LUGRo-Mesh. En caso que se requiera utilizar otro servidor de visualización, se puede especificar en este punto mediante la ip del mismo. ATENCIÓN: No admite nombres FQDN.

k. Return to Factory Default

Con éste punto se puede volver a la configuración por defecto del firmware Nightwing. ATENCIÓN: No sirve para volver el firmware original del equipo.

l. Back to main menu

Regresa al menú anterior

4 . BMX Config

****************** BMX Config *****************
***********************************************
a. Change Routing Class
b. Back to main menu
Select an option [a - b]: 

a. Change Routing Class

   Sólo útil en el modo cliente

Nos permite cambiar la forma de elegir el nodo gateway al cuál conectarnos para recibir Internet. Los valores posibles son:

  1. Usa la conexión a Internet que sea más rapida.
  2. Usa la conexión a Internet que sea más estable.
  3. Usa la conexión a Internet que sea más estable; pero apenas aparece una mejor, cambia.

b. Back to main menu

Regresa al menú anterior

5 . Exit

Muchos de los cambios que se realizan requieren el reinicio del equipo para que tomen efecto. Aunque no todos lo son (ejemplo el cambio de la clave de root) otros si lo son (ej: cambio de clave WPA2). El mensaje siguiente aparece sin distinción en todos los casos al salir del nw_conf.

Close menu 
-ATTENTION: Some changes take effect after reboot- 
root@nightwing:~#
Herramientas personales
Nightwing