BuenosAiresLibre Wiki BALLS Mapa Galería Chat

Obelisco/Docs

Documentación de Obelisco x86

Contents

  1. Documentación de Obelisco x86
    1. Desarrollo
    2. Características de Obelisco
    3. Instalación
      1. Obtener la imágen
      2. Verificar la imágen
      3. Preparación antes de la instalación
        1. Documentación
        2. Planificación
      4. Instalación
        1. M$ Windoors
        2. GNU/Linux
    4. Configuración inicial
      1. Asignar password
      2. Configuración inicial
        1. Automática
        2. Manual
    5. Usando Obelisco
      1. Usando Obelisco por primera vez
      2. Pasos a seguir
      3. RTFM
    6. Configuración de Obelisco en detalle
    7. Misc
      1. Instalación al estilo Voyage
        1. Preparación
        2. Particionar el HD/CF
        3. Formatear el HD/CF
        4. Descargar Obelisco
        5. Iniciar la instalación Voyage
      2. VMWare
    8. Changelog
    9. Configuraciones particulares

ESTA PÁGINA NECESITA DE TU COLABORACIÓN. GRACIAS.

Desarrollo

Características de Obelisco

  • Para ver un breve listado de las características y funcionalidades principales de Obelisco, junto con el software que incluye instalado, ver Características.

Instalación

Obtener la imágen

  1. Bajar la imágen correspondiente de la sección de descarga.

    • Ejemplo: wget http://www.buenosaireslibre.org/obelisco/x86/obelisco-x86-YYYYMMDD.img

      • Reemplazar YYYMMDD por la versión correspondiente.

Verificar la imágen

  1. Para asegurarse que el archivo se descargó correctamente y garantizar su instalación, verificar el mismo con la utilidad MD5SUM.

    • Utilizar el comando md5sum en GNU/Linux o md5sum.exe en M$ Windoors.

    • Ejemplo: 
      • md5sum -c md5sums-YYYYMMDD.txt
      • Tiene que indicar que la suma coincide.
        • Reemplazar YYYMMDD por la versión correspondiente.

Preparación antes de la instalación

  • Obelisco se puede instalar en un disco rígido (HD) o en una memoria Compact Flash (CF) (que funciona como un disco rígido).

  • Ese HD/CF se conecta a una PC dónde se realizará la instalación, distinta del ProAp que será utilizado como AP/Nodo.

    • Esa PC necesita tener un sistema operativo M$ Windoors o GNU/Linux ya funcionando (puede ser una versión Live CD).

  • Otra alternativa es tener el HD/CF directamente conectado al ProAp que será utilizado como AP/Nodo y bootear en el mismo una distribución GNU/Linux desde un Live CD.

Documentación

  1. Antes de avanzar deberías leer toda la documentación para tener una idea general de los pasos que realizarás.

Planificación

  1. Es MUY recomendable escribir en papel la configuración pretendida para ahorrarse tiempo y dudas.

Instalación

M$ Windoors

  1. Tenés que bajarte physdiskwrite.

  2. Ejecutá physdiskwrite obelisco-x86-YYYYMMDD.img y cuando te lo pregunte, indicá el nombre del HD/CF que hayas conectado, y que será utilizado para el ProAp.

    • Reemplazar YYYMMDD por la versión correspondiente.
    • . Algo parecido a lo siguiente deberías ver: 
      • D:\>physdiskwrite obelisco-x86-YYYYMMDD.img

physdiskwrite v0.5.1 by Manuel Kasper <mk@neon1.net>

Searching for physical drives...

Information for \\.\PhysicalDrive0:
   Windows:       cyl: 7752
                  tpc: 240
                  spt: 63
   C/H/S:         16383/16/63
   Model:         HTS541060G9AT00
   Serial number:       MPB3LAXGGLT9WM
   Firmware rev.: MB3IA60A

Information for \\.\PhysicalDrive1:
   Windows:       cyl: 15
                  tpc: 255
                  spt: 63

Information for \\.\PhysicalDrive2:
DeviceIoControl() failed on \\.\PhysicalDrive2.

Information for \\.\PhysicalDrive3:
DeviceIoControl() failed on \\.\PhysicalDrive3.

Information for \\.\PhysicalDrive4:
DeviceIoControl() failed on \\.\PhysicalDrive4.

Which disk do you want to write? (0..1) 1
About to overwrite the contents of disk 1 with new data. Proceed? (y/n) y
Found compressed image file
129024000/129024000 bytes written in total

D:\>

  3. En este punto se copiará la imágen al HD/CF destino y quedará listo para ser utilizado en tu ProAp.

GNU/Linux

  1. El HD/CF estará accesible desde el GNU/Linux que estés usando como "instalador", y sólo necesitarás saber el nombre del dispositivo asignado al HD/CF.

    • De ahora en adelante, se asume que el HD/CF tiene asignado el nombre de dispositivo /dev/sdb.

    • Para el sistema GNU/Linux que se utilizará como "instalador" se puede aprovechar el Live CD ofrecido por Voyage Linux.

      • NOTA: En la página de Voyage Linux dice que la versión 0.4.1 es ahora estable, pero en la sección descargar todavía figura como inestable. El cambio más importante es el soporte para placas ALIX.

    • Este método de instalación requiere que tengas gunzip y dd.

  2. Ejecutá gunzip -c obelisco-x86-YYYYMMDD.img | dd of=/dev/sdb

    • Reemplazar YYYMMDD por la versión correspondiente.

    • El dispositivo /dev/sdb corresponde al ejemplo utilizado hasta el momento. Utilizá el que corresponda en tu caso.

  3. En este punto se copiará la imágen al HD/CF destino y quedará listo para ser utilizado en tu ProAp.

    • NOTA: Si después de copiar la imagen de Obelisco y cuando inician el Grub muestra Error 2. (Me pasó en una Pentium 233MMX 32MB RAM disco IDE 2GB)

      • Vayan al BIOS.

      • STANDART CMOS SETUP.

      • Cambien el mode del disco a NORMAL.

      • Escape y luego F10 y grabar los cambios.

Configuración inicial

Asignar password

  1. Ingresar al equipo desde la consola, con el usuario root.

    • La contraseña por defecto es: obelisco

  2. Cambiá la contraseña.

    • Para ello tenés que re-montar el sistema de archivos para lectura-escritura con el comando: remountrw

    • Para cambiar la constraseña, ejecutá el comando: passwd

    • Cuando termines, volvé a re-montar el sistema de archivos para sólo-lectura con el comando: remountro

Configuración inicial

  1. Se asume que estás conectado mediante la consola al Obelisco en el ProAp que será utilizado como AP/Nodo y que el mismo tiene todas las placas ethernet y/o wireless conectadas.

  2. Ejecutá remountrw.

  3. Ejecutá proap-cfg.sh y con cuidado indicá que función cumplirá cada interfaz de red.

    • Este script modifica el contenido del archivo /etc/proap.cfg para que esté acorde a las interfaces de red que disponés.

    • También modifica /etc/network/interfaces para que inicialice sólo las interfaces de red necesarias.

    • BALConfig tomará la definición de interfaces de /etc/proap.cfg para configurarlas apropiadamente.

Automática

  1. Configurar Obelisco con el comando: 

    • balconfig defaults
    • El equipo quedará configurado con valores por defecto y se reiniciará al finalizar la configuración para que la misma sea aplicada.
      • El proceso de configuración automática puede tomar unos 40 segundos.
    • Configuración por defecto que será utilizada:

      • 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

    • Si no lo hiciste antes, sólo te quedaría pendiente asignarle una contraseña al usuario root cómo se describe en la sección Asignar password.

Manual

  1. Configurar Obelisco con el comando balconfig, respondiendo correctamente a todas las preguntas que realiza el script.

    • Si completaste la plantilla de configuración mencionada anteriormente, deberías utilizar los datos que escribiste allí.

    • El asistente de configuración BALConfig intenta ser lo más sencillo y liviano posible, y por lo tanto no tiene todas las validaciones ideales sobre la información que ingreses.

      • Entonces, completá los datos a conciencia.
    • Tener en cuenta que al ejecutar el asistente seguramente se modifiquen las direcciones IPs, las cuales deberás utilizar al conectarte por SSH después de reiniciar el equipo.
  2. El asistente te realizará una última pregunta, para aplicar y guardar definitivamente la configuración.

    • Tener en cuenta que para ello el ProAp se reiniciará.

Usando Obelisco

Usando Obelisco por primera vez

  1. Ya estás en condiciones de usar Obelisco según la configuración que le hayas aplicado.

    • No deberías volver a modificar la configuración salvo que necesites una especial para tu caso.
  2. Para probarlo, podés conectar una PC/Laptop en la interfaz que hayas designado como LAN y te asignará una dirección IP automáticamente.
  3. De la misma forma, podés conectar una PC/Laptop en forma inalámbrica (al nombre de red ESSID que hayas elegido) y te asignará una dirección IP automáticamente.

  4. Si sos un felíz usuario de Obelisco lo podrías hacer saber en la lista de correo general y compartir tu experiencia.

  5. Si tuviste algún problema, avisanos que te daremos una mano. Ver Cómo obtener ayuda

Pasos a seguir

  1. Ya tenés tu ProAp con Obelisco instalado y configurado. Un problema menos !

  2. Preocupate por conseguir Clientes para tu Nodo/AP y/o de enlazarte con otros Nodos/APs de la zona !!

  3. Los ProAp deberían ser configurados una vez y quedar funcionando de esa manera.

  4. No es la idea que estés probando instalarle mil aplicaciones, probar cien configuraciones distintas, etc.
  5. Si querés hacer esto último, prestá atención a la siguiente sección (RTFM).

RTFM

  1. Seguí leyendo TODA la documentación de Obelisco antes de preguntar cómo hacer algo !!!

    • Toda la documentación de Obelisco-MIPS te puede ser útil. Ver: Obelisco/Docs/MIPS

      • Incluidos todos los links a páginas externas e inclusive a los que te puedan llevar ellas.

Configuración de Obelisco en detalle

  • COMPLETAR

Misc

Instalación al estilo Voyage

Preparación

  • Obelisco se puede instalar en un disco rígido (HD) o en una memoria Compact Flash (CF) (que funciona como un disco rígido).

  • Ese HD/CF se conecta a una PC dónde se realizará la instalación, distinta del ProAp que será utilizado como AP/Nodo.

    • Esa PC necesita tener un sistema operativo GNU/Linux ya funcionando (puede ser una versión Live CD).

  • Otra alternativa es tener el HD/CF directamente conectado al ProAp que será utilizado como AP/Nodo y bootear en el mismo una distribución GNU/Linux desde un Live CD.

  • En cualquier caso, el HD/CF estará accesible desde el GNU/Linux que estés usando como "instalador", y sólo necesitarás saber el nombre del dispositivo asignado al HD/CF.

    • De ahora en adelante, se asume que el HD/CF tiene asignado el nombre de dispositivo /dev/sdb.

  • Para el sistema GNU/Linux que se utilizará como "instalador" se puede aprovechar el Live CD ofrecido por Voyage Linux: http://www.voyage.hk/download/ISO/voyage-0.3.1.iso

  • La instalación requiere que tengas rsync y grub.

    • apt-get install rsync

    • apt-get install grub

Particionar el HD/CF

  • Con sólo hacer una única partición primaria es suficiente.

  • Para ello utlizar la utilidad fdisk.

    • Ejemplo: fdisk /dev/sdb

  • No olvides marcar la partición como activa/booteable.

Formatear el HD/CF

  • Formatear la partición con el sistema de archivos EXT2.

  • Para ello utilizar la utilidad mkfs.ext2.

    • Ejemplo: mkfs.ext2 /dev/sdb1

      • Para HD viejos (o de dudoso funcionamiento) es aconsejable ejecutar mkfs.ext2 -c /dev/hda1 (notar el parámetro -c) para que al mismo tiempo verifique si tiene sectores defectuosos.

  • Ajustar parámetros del sistema de archivos con tune2fs.

    • Ejemplo: tune2fs -c 0 /dev/sdb1

Descargar Obelisco

  • Bajar la versión disponible de Obelisco

    • Ejemplo: wget http://www.buenosaireslibre.org/obelisco/x86/pre/obelisco-x86-YYYYMMDD.tar.gz

      • Reemplazar YYYMMDD por la versión correspondiente.
  • Bajar el archivo MD5SUM.

    • Ejemplo: wget http://www.buenosaireslibre.org/obelisco/x86/pre/md5sums-YYYYMMDD.txt

      • Reemplazar YYYMMDD por la versión correspondiente.

  • Comprobar el archivo con la utilidad md5sum.

    • Ejemplo: md5sum -c md5sums-YYYYMMDD.txt

      • Tiene que indicar que la suma coincide.
        • Reemplazar YYYMMDD por la versión correspondiente.

  • Descomprimir el archivo con la utilidad tar.

    • Ejemplo: tar --numeric-owner -zxvf obelisco-x86-YYYYMMDD.tar.gz

    • Es importante descomprimirlo logueado como usuario root o con los mismos privilegios.

      • Reemplazar YYYMMDD por la versión correspondiente.

Iniciar la instalación Voyage

  • Los siguientes pasos podrían simplificarse con un script personalizado para Obelisco... hay que hacerlo...

  • cd voyage-obelisco (Dónde hayas descomprimido el archivo en la sección anterior)

  • ./usr/local/sbin/voyage.update

    • Se debe ejecutar como root o con los mismos privilegios.

  • A continuación aparece un menú con 6 pasos a seguir:

    • Paso 1 Create new Voyage Linux disk

      • What would you like to do?

      •   1 - Create new Voyage Linux disk

      •   2 - Update existing Voyage configuration

      •   3 - Exit

      •       (default=1 [Create new Voyage Linux disk]): 1 (Seleccionar 1)

    • Paso 2 Select Target profile

      • Please select Voyage profile:

      •   1 - 4501/4801

      •   2 - 4511/4521

      •   3 - Generic PC

      •   4 - Notebook (pcmcia)

      •   5 - WRAP

      •       (default=5 [WRAP]): 4 (Seleccionar 4)

        • Se utiliza Notebook (pcmcia) para tener soporte pcmcia (necesario en algunas placas inalámbricas).

    • Paso 3 Select Target Disk

      • Which device accesses the target disk [/dev/hde]? ''/dev/sdb''

        • Corresponde al HD/CF dónde se instalará, en nuestro caso, siguiendo los ejemplos, escribí: /dev/sdb

    • Paso 4 Select Target Bootstrap Loader

      • Which loader do you want (grub or lilo) [grub]?  (Seleccionar grub)

    • Paso 5 Configure Target Console

      • Select terminal type:

      •   1 - Serial Terminal

      •   2 - Console Interface

      •        (default=1 [Serial Terminal]): 2 (Seleccionar 2)

        • Se indica Console interface para que puedas utilizar un monitor (CRT/LCD/etc) como consola.

    • Paso 6 Copy Distribution to Target

      • En este punto se copiarán todos los archivos al HD/CF destino y quedará listo para ser utilizado en tu ProAp.

VMWare

  • Si querés probar Obelisco-x86 antes de instalarlo en un ProAp, podés seguir los siguientes pasos:

    1. Bajar VMWare Player de http://www.vmware.com/products/player/

    2. Bajar el archivo obelisco-x86-voyage-vmware.vmx disponible en:

    3. Bajar la imágen VMWare acorde a la última versión disponible de Obelisco-X86.

      • Archivo con extensión vmdk, disponible en la página de Descarga.

    4. Cambiar el nombre del archivo vmdk recién bajado para que sea: obelisco-x86-voyage-vmware.vmdk

    5. Abrir el archivo obelisco-x86-voyage-vmware.vmx con el VMWare Player.

      • A partir de este momento, debería abrirse el VMWare Player mostrando el proceso de booteo del Obelisco-x86.
    6. Listo!
  • Notas:
    • Tené en cuenta que esta imágen VMWare no es ni pretende ser completamente funcional, ya que, por ejemplo, no podrías agregar interfaces inalámbricas.
    • Está disponible sólo para que puedas experimentar antes de instalarlo en tu AP/Nodo y/o puedas colaborar con el testing/desarrollo de Obelisco-x86.

Changelog

  • Ver los distintos cambios realizados durante el desarrollo en: Changelog.

Configuraciones particulares

Wiki: Obelisco/Docs/x86 (last edited 2012-05-23 15:20:02 by CarlosSaavedra)

USLA