BuenosAiresLibre Wiki BALLS Mapa Galería Chat

Obelisco

BALConfig

Contents

  1. BALConfig
    1. Introducción
    2. Consideraciones previas
      1. Cómo usar BALConfig
      2. Archivos de configuración
      3. Parámetros
    3. Descripción de las preguntas
      1. General
      2. Tipo de Nodo
      3. Extra: WDS (Wireless Distribution System)
      4. Acceso a Internet
      5. Funcionalidad Portal Cautivo
      6. Extra: Túneles por Internet con OpenVPN
      7. Extra: MMC/SD Mod
    4. Configuración por defecto (defaults)
    5. Plantilla de configuración
    6. Captura de texto

Introducción

Obelisco BALConfig, o BALConfig, es el asistente de configuración que mediante preguntas realiza la configuración del Nodo/AP en base a las respuestas obtenidas.

Consideraciones previas

  1. BALConfig es un shell script basado principalmente en el shell ash.

  2. Al iniciar, verifica que boot_wait esté en on para que ante cualquier inconveniente de configuración exista una manera de restaurarlo.

Cómo usar BALConfig

  1. Para iniciar BALConfig, basta con ejecutar el comando balconfig en el router.

  2. Luego de presentar el título e información del hardware detectado, comenzará a realizar distintas preguntas sobre la configuración del equipo.

    • En casi todas las preguntas, mostrará un valor por defecto (entre paréntesis) que podrá ser utilizado cómo respuesta, simplemente presionando la tecla enter.

    • En muchas preguntas, los valores que muestre por defecto cómo respuesta posible se irán modificando en base a respuestas obtenidas anteriormente.
      • Ejemplo: Cuando ingreses una dirección IP 10.4.x.x en la próxima pregunta te ofrecerá la máscara de subred 255.255.255.224, pero si hubieses ingresado una dirección IP 172.16.x.x te ofrecería una máscara de subred 255.255.255.240.

        • En este ejemplo en particular ofrece esas máscaras de subred basado en los requerimientos de la RedBAL.

  3. Si es necesario borrar un valor de configuración, responder con blank.

    • Ejemplo, si no se quiere especificar un servidor DNS, responder blank.

  4. Si es necesario utilizar espacios, responder reemplazando los espacios por #.

    • Ejemplo, en lugar de responder a una pregunta Mi Nombre, responder Mi#Nombre.

  5. Si te equivocaste en una respuesta, podés volver a empezar de nuevo la configuración para corregirlo, que BALConfig recordará las respuestas que hayas ingresado hasta ese momento y te las ofrecerá como valores por defecto.

Archivos de configuración

  1. Al realizar la configuración, BALConfig genera un archivo temporal (/tmp/balconfig.cfg).

    • Si existe un archivo de configuración, previamente generado con BALConfig, en /tmp/balconfig.cfg, tomará como valores por defecto los allí especificados.

  2. Al finalizar la configuración, BALConfig guardará una copia del archivo de configuración en /etc/balconfig.cfg.

    • Si al ejecutar BALConfig existe un archivo de configuración, previamente generado con BALConfig, en /etc/balconfig.cfg, tomará como valores por defecto los allí especificados.
  3. Si querés guardar la configuración de tu equipo, copiate el archivo /etc/balconfig.cfg

Parámetros

  1. No hace falta ejecutar BALConfig con parámetros.
    • Sin parámetros BALConfig se ejecutará normalmente, realizando todas las preguntas, esperando por respuestas y al finalizar, dejando al usuario que confirme la configuración.
    • Pero, BALConfig puede aceptar un parámetro que indica el tipo de configuración a realizar.

    • Las opciones son test, kamikaze, auto, extra y defaults:

test

no modifica la configuración del router, sólo imprime los cambios que se generarían en nvram.

kamikaze

modifica la configuración, la aplica automáticamente (sin consultar) con nvram commit y reinicia el router con reboot.

auto

no realiza preguntas, sólo configura el router utilizando un archivo de configuración, previamente generado con BALConfig, existente en /etc/balconfig.cfg o /tmp/balconfig.cfg.

extra

realiza una configuración normal, pero agregando preguntas extras de opciones experimentales o avanzadas. Usar esta opción si se sabe lo que se está haciendo.

defaults

configura el router con valores por defecto. Ver Configuración Automática.

  • Ejemplo: Al ejecutar balconfig auto no realizará preguntas y tratará de configurar el equipo automáticamente con las opciones almacenadas en /etc/balconfig.cfg.

Descripción de las preguntas

General

  1. Nombre Wiki del Nodo

    • Valor por defecto: NodoObelisco

    • Descripción: Corresponde al nombre Wiki (Ver WikiName y GuíaPáginaNodo) de la página que contiene información del Nodo/AP.

      • Esta información será publicada con la funcionalidad de Portal Cautivo.

  2. URL del Wiki del Nodo

    • Valor por defecto: http://wiki.buenosaireslibre.org/(Valor de la respuesta obtenida de la pregunta anterior)

    • Descripción: Generará automáticamente la dirección URL para poder acceder a la página que contiene información del Nodo/AP.

      • Esta información será publicada con la funcionalidad de Portal Cautivo.

  3. Nombre Wiki del responsable del Nodo

  4. e-mail para contacto del responsable

  5. Tipo de Nodo

    • Valor por defecto: AP-Aislado

    • Descripción: Corresponde a los roles especificados en Participaciones.

      • Responder exactamente como indican las opciones, respetando mayúsculas y minúsculas.
      • Según la respuesta especificada, cambiarán la cantidad de preguntas que se realizarán a continuación.

      • Esta información será publicada con la funcionalidad de Portal Cautivo

Tipo de Nodo

  1. Nombre de red, hostname, del Nodo

    • Valor por defecto: obelisco
    • Descripción: Es el nombre de red (hostname) del equipo.

      • Generalmente tiene relación con el nombre del Nodo, con el WikiName del Nodo.

      • Ejemplo: Si el WikiName del Nodo es NodoFiumicino, el hostname será fiumicino.

      • Esta información será publicada con la funcionalidad de Portal Cautivo

  2. IP Address

    • Valor por defecto: 10.4.0.1
    • Descripción: Especifica la dirección IP principal que se le asignará al equipo.
      • Dado que la interfaz inalámbrica y los 4 puertos del switch forman una única interfaz, se denomina LAN a la interfaz (bridge) que los agrupa.
      • Las interfaces están agrupadas en el bridge br0.

  3. Netmask

    • Valor por defecto: 255.255.255.224
    • Descripción: Es la máscara de red (o subred) principal que se utilizará para la interfaz LAN, relacionada con la dirección IP de LAN antes especificada.

  4. Default Gateway

    • Valor por defecto: blank
    • Descripción: Corresponde a la dirección IP de la puerta de enlace por defecto hacia otras redes que no conozca el router que se está configurando.
      • Si el equipo está solamente conectado a otro router, debería ser la dirección IP de dicho router.

  5. DNS Server

    • Valor por defecto: blank
    • Descripción: Es la dirección IP del servidor de nombres a utilizar.
      • En el caso de la configuración de un Cliente, corresponde al servidor DNS remoto a utilizar para la resolución de nombres.
      • En el caso de la configuración de un Nodo/AP, corresponde al servidor DNS remoto a utilizar para la resolución de nombres que no sean locales, que no pueda resolver el propio router.
      • Si el router está conectado a Internet, podría corresponder al servidor DNS del proveedor de la conexión a Internet.

  6. Wireless SSID

    • Valor por defecto: [Valor de la respuesta obtenida de la pregunta hostname]@buenosaireslibre.org

    • Descripción: Es el nombre de la red inalámbrica (SSID) a utilizar por la interfaz inalámbrica.

      • En el caso de un Nodo/AP, debe respetar lo acordado como SSID para BuenosAiresLibre. Ver RedBAL.

      • En el caso de configurar un Cliente, se debe especifica el SSID al cual se conectará el equipo.

      • Esta información será publicada con la funcionalidad de Portal Cautivo

  7. Wireless Channel

    • Valor por defecto: 6
    • Descripción: Es el canal a utilizar por la interfaz inalámbrica.

      • Esta información será publicada con la funcionalidad de Portal Cautivo

  8. Extra: Wireless TX Power en miliwatts

    • Valor por defecto: blank
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Esta opción está para probar si causa algún efecto el cambio de la configuración de la potencia con la que emite el equipo.
      • Hasta ahora parece que no sube la potencia en ningún equipo.

  9. Extra: Seleccionar antena

    • Valor por defecto: auto
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Dado que los equipos poseen dos antenas (para hacer diversity), permite seleccionar cuál se utilizará para transmisión y recepción. Esto te puede mejorar el enlace.

      • La antena main es la que está cerca del botón de reset en los Linksys WRT54G/S (sin importar el modelo).

      • La antena main es la que viene con el conector RP-SMA en los Motorola WR850G v2.

  10. Extra: Distancia en metros del enlace (mayor a 1500)

    • Valor por defecto: blank
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Esta opción está para probar si mejora la conexión en enlaces mayores a 1.5 Km.

  11. Extra: Syslog Server

    • Valor por defecto: blank
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Dirección IP del servidor de Syslog al cual se le enviarán todos los logs del router.
      • Es útil para centralizar los logs en un único equipo, con mayor seguridad y capacidad de almacenamiento.

  12. Extra: Cliente en Modo Master

    • Valor por defecto: no
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.

    • Descripción: En caso de realizarse un enlace punto-a-punto entre dos Nodos/AP, uno de los extremos necesitará estar en Modo Master. Ver RedBAL.

  13. PORT2 IP Address

    • Valor por defecto: 172.16.166.1
    • Descripción: En el caso de configurar un AP-Conectado o Nodo, se debe especificar una dirección IP para el puerto 2 del switch del router.
      • En este puerto se puede conectar otro router, u otro AP en modo Cliente con enlace a un Nodo/AP remoto.

  14. PORT2 Netmask

    • Valor por defecto: 255.255.255.240
    • Descripción: Es la máscara de subred correspondiente a la dirección IP anterior.

  15. PORT3 IP Address

    • Valor por defecto: blank
    • Descripción: En el caso de configurar un Nodo, se debe especificar una dirección IP para el puerto 3 del switch del router.
      • En este puerto se puede conectar otro router, u otro AP en modo Cliente con enlace a un Nodo/AP remoto.

  16. PORT3 Netmask

    • Valor por defecto: blank
    • Descripción: Es la máscara de subred correspondiete a la dirección IP anterior.

Extra: WDS (Wireless Distribution System)

  1. Configurar WDS

    • Valor por defecto: no
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.

    • Descripción: Si bien se desalienta la utilización de WDS en la RedBAL, hay casos particulares dónde podrá ser la única opción de integrarse a la red.

  2. Listado de direcciones MAC habilitadas, separadas por #

    • Valor por defecto: blank
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Responder aquí con todas las direcciones MAC de los Nodos/APs remotos con los que se establecerá un enlace WDS. Las mismas deben estar separadas por el caracter #.
      • Ejemplo: 01:02:03:04:05:06#11:22:33:44:55:66

  3. WDS IP Address

    • Valor por defecto: 172.16.167.1
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Dirección IP a utilizar en la interfaz WDS (bridge br1).

      • Utilizar direcciones IP de las SubredesAsignadas al Nodo/AP, en el rango 172.16.x.x.

  4. WDS Netmask

    • Valor por defecto: blank
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Máscara de subred asociada a la dirección IP anterior.

Acceso a Internet

  1. Configurar Internet

    • Valor por defecto: no

    • Descripción: En el caso de configurar un Nodo/AP, se debe responder con si o no si se desea configurar una conexión a Internet.

      • Si bien no está relacionado con los [Objetivos Objetivo de BuenosAiresLibre] el acceso a Internet, muchos de sus integrantes podrían querer administrar la conexión desde el router y para ello se incluye soporte a la configuración del acceso.

  2. Tipo de Acceso

    • Valor por defecto: dhcp
    • Descripción: Corresponde a las dos opciones más habituales de acceso a Internet (static, dhcp, pppoe).

      • Si se elige dhcp, se configurará el puerto WAN del swicth para que obtenga la configuración IP automáticamente de un servidor DHCP conectado a dicho puerto. Generalmente para conexión a Internet por Cable-Módem.

      • Si se elige pppoe, se configurará el puerto WAN del switch para que inicie una conexión PPPOE con un módem ADSL conectado en ese puerto.

      • Si se elige static, se configurará el puerto WAN del switch con una dirección IP fija.

        • Ejemplo: Esta opción se puede utilizar cuando se recibe Internet desde un router existente en la red local.

  3. Usuario ISP

    • Valor por defecto: blank

    • Descripción: En el caso de la configuración por pppoe, se debe especificar el usuario a utilizar en la conexión ADSL.

  4. Contraseña ISP

    • Valor por defecto: blank
    • Descripción: Corresponde a la contraseña del usuario anteriormente especificado.

  5. WAN IP Address

    • Valor por defecto: 192.168.0.2

    • Descripción: En el caso de la configuración static, se debe especificar la dirección IP a utilizar en el puerto WAN del switch.

  6. WAN Netmask

    • Valor por defecto: 255.255.255.0

    • Descripción: En el caso de la configuración static, máscara de subred asociada a la dirección IP anterior.

  7. WAN Default Gateway

    • Valor por defecto: 192.168.0.1

    • Descripción: En el caso de la configuración static, corresponde a la puerta de enlace por defecto hacia Internet.

  8. WAN DNS Server

    • Valor por defecto: 192.168.0.1

    • Descripción: En el caso de la configuración static, corresponde al servidor de nombres de Internet.

  9. Extra: Habilitar NAT en puerto WAN

    • Valor por defecto: blank
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.

    • Descripción: En casos particulares, podrías querer desactivar el NAT en el puerto WAN, cuando se configura el acceso a Internet por dhcp o static.

Funcionalidad Portal Cautivo

  1. Habilitar funcionalidad de Portal Cautivo

    • Valor por defecto: no
    • Descripción: En el caso de configurar un Nodo/AP, se debe responder si se desea habilitar o no la funcionalidad de Portal Cautivo.

      • Al habilitar esta funcionalidad, no será posible acceder a otros hosts o redes que no sean de la RedBAL (y otros destinos aceptados, relacionados con el proyecto).

      • Si se intenta navegar con un web browser por Internet (o por una dirección IP que no sea de BAL, o de los destinos aceptados), se verá la información publicada por el Nodo/AP.

  2. Listado de direcciones IP excluídas, separadas por #

    • Valor por defecto: blank
    • Descripción: Aquí se deben especificar las direcciones IP de cada uno de los Clientes o hosts conectados a tu Nodo/AP, a los que se les brindará acceso sin restricciones a Internet.

      • Esta opción te evita tener que escribir/modificar a mano un archivo de texto, cómo se hacía en las versiones anteriores de Obelisco.

      • Separar las direcciones IP con el caracter #.

      • Responder none si se desea modificar el archivo /etc/hosts.inet a mano y evitar que BALConfig lo modifique.

      • Responder blank si se desea que no se excluyan direcciones IP.

        • Ejemplo: 10.4.0.2#10.4.0.10#10.4.0.15

  3. Extra: Portal Cautivo, tipo de log

    • Valor por defecto: file
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Te permite seleccionar dónde se registarán los accesos de los visitantes: en el syslog o en el archivo /tmp/portal.log.

Extra: Túneles por Internet con OpenVPN

  1. Habilitar servidor OpenVPN

    • Valor por defecto: no
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.

  2. Dirección IP a utilizar en este extremo del túnel

    • Valor por defecto: 172.16.166.33
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.

  3. Habilitar cliente OpenVPN

    • Valor por defecto: no
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.

  4. Dirección IP en Internet del Servidor

    • Valor por defecto: auto
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.

      • Ver Obelisco/Docs/OpenVPN

      • La opción auto corresponde a una idea loca que se discutió por IRC, pero que nunca se implementó.

      • Especificar allí una dirección IP pública en Internet.

  5. Dirección IP a utilizar en este extremo del túnel

    • Valor por defecto: 172.16.166.50
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.

Extra: MMC/SD Mod

  1. Habilitar soporte MMC/SD

    • Valor por defecto: no
    • Descripción: Funcionalidad extra/experimental/avanzada que sólo deberías utilizar si sabés lo que estás haciendo.
    • Descripción: Al habilitar esta opción cargará durante el inicio el módulo necesario para levantar la memoria MMC/SD y tratará de montar algunas particiones.
      • Con esta opción activa, se desactiva el botón SES/Cisco en routers Linksys, y el comportamiento de los LEDs en el panel frontal será errático, debido a la naturaleza del driver MMC/SD.

Configuración por defecto (defaults)

  • Dirección IP: 10.4.0.1
  • Máscara de red: 255.255.255.224

  • ESSID: <obelisco AT ARROBA buenosaireslibre.org>

  • Canal: 6

  • Modo/Participación: AP-Aislado

  • DHCP Server: Habilitado (Asignará direcciones IP entre 10.4.0.20 y 10.4.0.30)
  • DNS Server: Habilitado
  • Protocolo de enrutamiento dinámico OLSR: Habilitado
  • Puerto WAN (Para acceso a Internet ?): DHCP

  • PortalCautivo: Habilitado

Plantilla de configuración

  • Para estar bien preparado antes de iniciar la configuración de Obelisco, y evitar dudas durante el proceso, podés contar con los siguientes documentos PDF, que podrás imprimir y utilizar cómo ayuda.

    • El documento obelisco-balconfig.pdf contiene una hoja con todas las preguntas, sus opciones y valores por defecto, para que puedas saber de antemano que datos necesitarás completar durante la configuración.

    • El documento obelisco-balconfig-plantilla.pdf es similar al anterior, pero tiene en blanco los valores, para que puedas completar allí los correspondientes a la configuración personalizada de tu Nodo/AP.

      • Este documento luego te puede ser útil como documentación del Nodo/AP.

    • El documento obelisco-balconfig-extra.pdf contiene las opciones extra de configuración de Obelisco, que deberías utilizar si sabés lo que estás haciendo.

  • Descargar:

Captura de texto

  • A continuación un ejemplo de ejecución de balconfig con el parámetro extra, dónde se pueden ver casi todas las opciones de configuración disponibles:

    • Se aceptaron los valores por defecto en la mayoría de las preguntas. 
      Obelisco BALConfig
-------------------

Para mayor información visitar:
http://wiki.buenosaireslibre.org/Obelisco


Hardware detectado: Linksys WRT54G v2


Por favor, responder cuidadosamente:

Nombre Wiki del Nodo (NodoObelisco):
URL del Wiki del Nodo (http://wiki.buenosaireslibre.org/NodoObelisco):
Nombre Wiki del responsable del Nodo (MiNombre):
e-mail para contacto del responsable (bal-general@listas.buenosaireslibre.org):
Tipo de Nodo [Cliente|AP-Aislado|AP-Conectado|Nodo] (AP-Aislado): Nodo

Tipo de Nodo: Nodo

Nombre de red, hostname, del Nodo (obelisco):
IP Address (10.4.0.1):
Netmask (255.255.255.224):
Default Gateway (blank):
DNS Server (blank):
Wireless SSID (obelisco@buenosaireslibre.org):
Wireless Channel (6):
Extra: Wireless TX Power en miliwatts (blank): 
Extra: Seleccionar antena [auto|main|aux|diversity] (auto):
Extra: Distancia en metros del enlace (mayor a 1500) (blank):
Extra: Syslog Server (blank): 
PORT2 IP Address (172.16.166.1):
PORT2 Netmask (255.255.255.240):
PORT3 IP Address (172.16.166.17):
PORT3 Netmask (255.255.255.240):

Extra: WDS (Wireless Distribution System)

Configurar WDS [si|no]? (no): si
Listado de direcciones MAC habilitadas, separadas por # (blank):
WDS IP Address (172.16.167.1):
WDS Netmask (255.255.255.240):

Acceso a Internet

Configurar Internet [si|no] (no): si
Tipo de acceso [static|dhcp|pppoe] (dhcp): static
WAN IP Address (192.168.0.2):
WAN Netmask (255.255.255.0):
WAN Default Gateway (192.168.0.1):
WAN DNS Server (192.168.0.1):
Extra: Habilitar NAT en puerto WAN [si|no] (si):

Funcionalidad Portal Cautivo

Habilitar funcionalidad de Portal Cautivo [si|no] (si):
Listado de direcciones IP excluídas, separadas por # (none):
Extra: Portal Cautivo, tipo de log [file|syslog] (file):

Extra: Túneles por Internet con OpenVPN

Por favor, leer bien la documentación de Obelisco para entender que implica activarlo

Habilitar servidor OpenVPN [si|no] (no): si
Dirección IP a utilizar en este extremo del túnel (172.16.166.33):

Máscara de red a utilizar en ambos extremos: 255.255.255.240

Dirección IP a utilizar en el extremo cliente: 172.16.166.34

Habilitar cliente OpenVPN [si|no] (no): si
Dirección IP en Internet del Servidor (auto): 200.200.211.211
Dirección IP a utilizar en este extremo del túnel (172.16.166.50):

Máscara de red a utilizar en ambos extremos: 255.255.255.240

Dirección IP a utilizar en el extremo server: 172.16.166.49


Extra: MMC/SD Mod

Habilitar soporte MMC/SD [si|no] (no): si


No detener la ejecución !!!, aplicando en memoria la configuración...



Configuración aplicada en memoria !!

Guardar definitivamente los cambios de configuración ? [si|no] (si):

Guardando cambios... se reiniciará el equipo...

REBOOT !!!

CategoryObelisco

Wiki: Obelisco/BALConfig (last edited 2008-09-28 09:18:09 by localhost)

USLA