Guifi.net - Wiki Hispano - Contribuciones del usuario [es]

Cloudy plug-ins

2015-12-03T17:22:43Z

Conxuro:

== ¿Qué es un plug-in? ==

Cloudy es una distribución de Linux basada en Debian que proporciona a los usuarios una interfaz simple y cómoda para gestionar diferentes servicios que pueden usarse a través de una red comunitaria; en nuestro caso, Guifi.

Al mismo tiempo, Cloudy ofrece una serie de herramientas que permiten a un usuario añadir un servicio de su agrado sin tener grandes conocimientos sobre redes e informática en general. Automaticamente, estos servicios se publican mediante Avahi, de manera que todo el que utilice Cloudy podrá hacer uso de estos servicios.

Otra manera de llamar estos servicios que se pueden poner y quitar de forma sencilla es ''plug-in''. Por tanto, entendemos por plug-in a un programa o software que un usuario quiere añadir a la distribución y que puede ser gestionado de forma simple des de la interfaz web que provee Cloudy.

== Añadir servicios a Cloudy ==

=== Una pequeña introducción ===

Esta guía te enseñará el proceso para añadir un nuevo servicio en la distribución Cloudy.

Para serclaro y dar algunos ejemplos al mismo tiempo, integraremos un servicio bastante simple mostrando algunos trozos de código por el camino. Para seguir el tutorial con más facilidad o bien para integrar servicios más complejos, estaría bien tener algunos conocimientos de Bash<ref name="Bash">(http://www.tldp.org/LDP/Bash-Beginners-Guide/Bash-Beginners-Guide.pdf)</ref> y de PHP<ref name="PHP">(https://php.net/manual/es/index.php)</ref>.

Por simplicidad utilizaremos Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. Es un buen candidato ya que:

* Es independiente y no se ''federa'' ni se comunica con otros nodos.
* Está hecho en Go, es facil de distribuir e instalar.
* No necesita archivos de configuración.
* No necesita muchos recursos.

=== Obtener el binario ===

Lo primero que hemos de investigar es como descargar e instalar el binario en Cloudy. La mayoria de software que podemos encontrar está por defecto en los paquetes de Debian, pero Pastecat no está. Si se diera el caso de que estuviera, solo tendríamos que ejecutar el comando <code>apt-get install pastecat</code> desde PHP.

Pero como este no es el caso, tendremos que obtener el binario por otro lado. Una opcion es coger el código fuente y compilarlo nosotros mismos, pero el problema de esto es que Cloudy necesitaria incluir muchas herramientas y librerias de desarrollo, y este no es el objetivo.

La mejor opción si un paquete de Debian no está disponible en los repositorios es descargar los binarios de otro lugar seguro. Podemos utilizar el servicio de ''"releases"'' de Github para ello. Las dos opciones nos dan un archivo ejecutable que tendríamos que ser capaces de ejecutar directamente sobre Cloudy.

En este caso en particular descargaremos los binarios desde el repositorio git con la siguiente linea de comandos:

<code>
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386_v0.3.0
</code>

Nótese que en este caso en concreto estamos descargando una versión específica para Linux con arquitectura i386.

Fijaos que tener un servicio en los paquetes de Debian tiene muchas ventajas:

* Las actualizaciones son simples y no necesitan trabajo extra desde Cloudy.
* El paquete está compilado para Debian de manera segura.
* Los archivos de ''init.d'' ya vienen por defecto.
* Los paquetes de Debian suelen contener correciones.

=== Probarlo ===

Antes de añadir un servicio deberíamos configurarlo y probarlo nosotros directamente para ver cómo funciona y que realmente funciona. También hemos de entender qué opciones de configuración o de linea de comandos necesitamos para hacer uso de este servicio en particular y como lo gestionariamos una vez este funcionando.

=== Añadir el controlador ===

En <code>web/plug/controllers</code> tenenmos un archivo PHP para cada servicio, llamado controlador (o 'controller' en inglés). Este archivo contiene el codigo que se ejecutará cuando se visite la página de nuestro servicio desde la interfaz de Cloudy.

==== Añadir la función indice ====

Lo que queremos es que nuestro servicio esté integrado en la estructura web de Cloudy. Para ello, necesitamos crear unos cuantos ''scripts'' en PHP y añadirlos a nuestro sistema. De momento crearemos dos ''scripts'': <code>pastecat.php</code> y <code>pastecat.menu.php</code>. El primer archivo es el controlador, es decir, el ''script'' que renderiza la página y tiene toda la información tal como botones o redireccionamientos. El otro es el que permite que nuestro servicio se muestre en los menus superiores desplegables de Cloudy.

El código del menú será similar a esto:

<code php>
<?php
//peerstreamer.menu.php
addMenu('Pastecat','pastecat','Clommunity');
</code>

Por ahora, utilizaremos un ''script'' muy simple en PHP como controlador:

<code php>
<?php
//pastecat
$title="Pastecat";

function index(){
global $paspath,$title;
global $staticFile;

$page=hlc(t($title));
$page .= hl(t("Minimalist pastebin engine written in Go"),4);
$page .= par(t("A simple and self-hosted pastebin service written in Go").' '.t("Can use a variety of storage backends").' '.t(" Designed to optionally remove pastes after a certain period of time.").' '.("If using a persistent storage backend, pastes will be kept between runs.").' '.t("This software runs the").' '."<a href='http://paste.cat'>".t("paste.cat")."</a>". t(" public service."));

return(array('type' => 'render','page' => $page));
}
</code>

En nuestro sistema Cloudy estos archivos han de ponerse en los directorios dentro de <code>/var/local/cDistro/plug/</code>. El primero ha de ir en <code>menus</code> y el segundo en el directori <code>controllers</code>. Una vez hecho esto podemos ir a la web de nuestro Cloudy y acceder al nuevo menú Pastecat.

==== Hacer que el controlador instale nuestro servicio ====

Como se ha comentado anteriormente, este paso es mucho más sencillo de hacer si el servicio está entre los paquetes de Debian. Como que no es el caso de Pastecat, lo tendremos que hacer manualmente. Normalmente hacer este proceso manualmente incluye una combinación de los comandos <code>wget</code>, <code>mv</code> y <code>chmod</code>. En general, es buena idea mantener los archivos de este tipo de servicios en <code>/opt/SERVICENAME</code>.

En nuestro caso particular, lo primero que necesitamos es descargar el binario de la ''release'' de Github. Para ello utilizaremos el comando: <code>wget</code>. Dada una URL a un archivo, este comando permite descargar este archivo en nuestro sistema, i es lo que haremos con:

<code bash>
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386_v0.3.0
</code>

Una vez tengamos el binario en nuestra máquina, lo moveremos al directorio /opt/pastecat/. Para mover los archivos por nuestro sistema usaremos el comando <code>mv</code>. Aun así, primero tendremos que crear el directorio donde pondremos el archivo. Para ello utilizaremos <code>mkdir</code> de la siguiente manera:

<code bash>
mkdir -p /opt/pastecat/
</code>

Una vez hayamos creado el directorio, es hora de mover el binario:

<code bash>
mv current_directory/pastecat_linux_386 /opt/pastecat/
</code>

Donde "current_directory" es el directorio donde previamente hemos descargado el binario. Como el nombre del binario depende de la arquitectura, para simplificar el código del controlador, cambiaremos el nombre del archivo ejecutable por algo más genérico y simple:

<code bash>
mv /opt/pastecat/pastecat_linux_386 /opt/pastecat/pastecat
</code>

Ahora nuestro binario se llama <code>pastecat</code> en lugar de <code>pastecat_linux_386</code>.

Estos pasos son los requisitos mínimos para instalar un servicio que no se ofrece directamente en los repositorios oficiales de Debian. Sin embargo, de cara a un usuario final, sería una pesadilla tener que hacer todos estos comandos en una consola conectado a través de <code>ssh</code> a su dispositivo, así que lo que haremos a continuación es crear un ''script'' en Bash que será llamado más adelante a traves de la interfaz web haciendo click en un botón.

Este ''script'' es la primera versión del controlador de Pastecat. Por ahora solo incluiremos una función para instalar Pastecat en nuestro dispositivo. Más adelante incluiremos otras funciones para proveer a nuestro ''script'' de más servicios:

<code bash>
#!/bin/bash
PCPATH="/opt/pastecat/"

doInstall() {
if isInstall
then
echo "Pastecat is already installed."
return
fi

# Creating directory and switching
mkdir -p $pcpath && cd $pcpath

# Getting file
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386_v0.3.0

# Changing name so controller can invoke it generically
mv pastecat_linux_386 pastecat
chmod +x pastecat

cd -
}

isInstalled() {
[ -d $pcpath ] && return 0
return 1
}

case $1 in
"install")
shift
doInstall $@
;;
esac
</code>

Podemos ver como los últimos pasos se han concentrado en una misma función, permmiténdonos instalar el software en el dispositivo de una manera mas sencilla.

==== Hacer que el controlador utilitce Pastecat ====

===== Ejecutar el servicio =====

El paso siguiente es hacer que nuestro software se pueda utilizar desde la intarfaz web. Para ello incluiremos una nueva opción en nuestra página principal de Pastecat e incluiremos una nueva función en nuestro controlador para gestionar el binario. Añadiremos un botón en el código PHP de la siguiente manera:

<code bash>
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));
</code>

Ha de ir justo después del mensaje <code>Pastecat is installed</code>. A continuación se ha de implementar la función <code>publish</code> en el mismo PHP. Esta función es la responsable de llamar a la función correspondiente desde el controlador y anunciar nuestro servicio utilizando Avahi. La diferencia con esta función es que requiere un formulario para introducir datos, así que al final acabaremos teniendo dos funciones: una ''get'' i una ''post'':

<code php>
function publish_get() {
global $pcpath,$title;
global $staticFile;

$page = hlc(t($title));
$page .= hlc(t('Publish a pastecat server'),2);
$page .= par(t("Write the port to publish your Pastecat service"));
$page .= createForm(array('class'=>'form-horizontal'));
$page .= addInput('description',t('Describe this server'));
$page .= addSubmit(array('label'=>t('Publish'),'class'=>'btn btn-primary'));
$page .= addButton(array('label'=>t('Cancel'),'href'=>$staticFile.'/peerstreamer'));

return(array('type' => 'render','page' => $page));
}

function publish_post() {
$port = $_POST['port'];
$description = $_POST['description'];
$ip = "";

<nowiki>$page = "<pre>";
$page .= _pcsource($description);
$page .= "</pre>";</nowiki>

return(array('type' => 'render','page' => $page));
}
</code>

Como podemos ver en la función <code>post</code> estamos invocando otra función. El motivo de hacer esto es escribir el código de manera más simple y modular. En esta última funcion por fin llamamos al script:

<code php>
function _pcsource($port,$description) {
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;

$page = "";
$device = getCommunityDev()['output'][0];
$ipserver = getCommunityIP()['output'][0];

if ($description == "") $description = $type;

$cmd = $pcutils." publish '$port' '$description';
execute_program_detached($cmd);

$page .= t($ipserver);
$page .= par(t('Published this server.'));

$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));

return($page)
}
</code>

Lo siguiente que hemos de hacer es crear una función <code>publish</code> en el controlador, por lo que añadiremos una nueva función al controlador básico que tenemos en la sección '''3.2'''. Primero añadiremos un nuevo paámetro llamado ''publish'', asi que la primera parte en ejecutarse del ''script'' sera:

<code bash>
if [ $# -lt 1 ]
then
doHelp
fi

case $1 in
"install")
shift
doInstall $@
;;
"publish")
shift
doServer $@
;;
esac
</code>

Como se puede ver, cuando el primer argumento del ''script'' es <code>publish</code>, desplazamos (''shift'') el resto de argumentos y llamamos a la funcion <code>doServer</code>. En esta función hemos de poner en marcha el servicio con los argumentos correspondientes, así que lo primero queharemos será poner estos parámetros en variables locales. Una vez hecho esto lo más lógico sería lanzar la aplicación directamente, pero como el ''script'' se llama con permisos de "root" (no recomendable), hemos de lanzar Pastecat como usuario <code>nobody</code>. El problema es que el usuario <code>nobody</code> no tiene casi permisos y Pastecat necesita algunos persmisos para crear directorios y archivos de texto. Para permitir que <code>nobody</code> pueda hacerlo, primero crearemos un directorio con permisos a casi todos los usuarios. Para esto, utilizaremos el comando <code>chmod</code> de nuevo. Ahora el usuario puede crear archivos y directorios dentro de este mismo directorio, y en consecuencia podemos ejecutar Pastecat. Finalmente hay que mantener el PID en una variable en caso de que lo necesitemos más adelante (que ya os adelantamos que sí lo necesitaremos):

<code bash>
doServer() {
# Turning machine into a server

local port=${1:-""}
local description=${2:-""}
local ip=${3:-"0.0.0.0"}

# Creating directory with nobody permissions
mkdir -p "/var/local/pastecat"
chmod 777 "/var/local/pastecat" && cd "/var/local/pastecat"

# Running pastecat
cmd='su '$PCUSER' -c "{ '$PCPATH$PCPROG' -l :'$port' > '$LOGFILE' 2>&1 & }; echo \$!"'
pidpc=$(eval $cmd) # keeping PID for future needs...

cd -

# Using the PID, we could carry on process control so if the pastecat process die, we can also
# stop the avahi process to avoid "false connections"

return
}
</code>

Fijaos que ahora estamos utilizando algunas variables globales que no estaban definidas antes, como <code>PCUSER</code> y <code>LOGFILE</code>. Estas variables tienen los siguientes valores:

<code bash>
PCPATH="/opt/pastecat/"
PCPROG="pastecat"
LOGFILE="/dev/null"
PCUSER="nobody
</code>

===== Parar el servicio =====

En algún momento es posible que queramos parar nuestro servicio. Para esto crearemos un botón para hacerlo. Lo primero que hacer sería crear el botón, pero si pensamos un poco veremos que antes de crearlo necesitamos una manera de saber si nuestro servicio esta ejecutándose o no. Además, también necesitamos una manera de parar nuestro servicio. Como estamos ejecutando sobre Linux, podemos parar el servicio fácilmente utilizando el comando <code>kill</code>. El problema es que para utilizar este comando primero necesitamos saber el número de identificación del proceso (PID). Por suerte, ja nos quedamos con este número cuando creamos el servidor de Pastecat; en concreto con la linea <code>pidpc=$(eval $cmd)</code>.

Ahora que tenemos todo lo que necesitamos para matar nuestro proceso vamos a ver como lo hacemos para que PHP pueda saber si el servicio está ejecutándose o no. Una manera fácil y eficiente de hacerlo es almacenando algunos datos útiles en un archivo y borrarlo cuando se pare Pastecat. De esta manera nos aseguramos que el archivo sólo existe cuando Pastecat está activo. Este archivo lo crearemos desde el controlador aádiendo las siguientes lineas justo despues de la sentencia que hemos mencionado en el párafo anterior:

<code bash>
# Writting server info to file
info="$pidpc http://$ip:$port" # Separator is space character
echo $info > $PCFILE
</code>

Donde <code>$PCFILE</code> es una variable global que contiene <code>/var/run/pc.info</code>. Fijaos
que el contenido del archivo sera el PID del Pastecat y la dirección completa del servidor de este.

Ahora ya tenemos una manera de saber si el servicio está activo o no, de manera que añadiremos justo a continuación el botón 'stop' en la interfaz web. Modificaremos un poco el ''script'' PHP que teniamos antes, añadiendo un anuncio indicando si Pastecat se está ejecutando o no, y dos botones más cuando éste esté ejecutándose. Así pues, nuestra función índice contendrá el siguiente codigo dentro de la condición que comprueba si Pastecat está instalado o no:

<code php>
<nowiki>$page .= "<div class='alert alert-success text-center'>".t("Pastecat is installed")."</div>\n";
if ( isRunning() ) {
$page .= "<div class='alert alert-success text-center'>".t("Pastecat is running")."</div>\n";
$page .= addButton(array('label'=>t('Go to server'),'href'=>'http://'. getCommunityIP()['output'][0] .':'. $port));
$page .= addButton(array('label'=>t('Stop server'),'href'=>$staticFile.'/pastecat/stop'));
} else {
$page .= "<div class='alert alert-error text-center'>".t("Pastecat is not running")."</div>\n";
}
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));</nowiki>
</code>

En este trozo de código podemos apreciar dos nuevas cosas. La priemra es una función de comprobación llamada <code>isRunning()</code>. Esta función se parece mucho a la funcion que utilizamos para comprar si Pastecat esta instalado o no:

<code php>
function isRunning() {
// Returns whether pastecat is running or not
global $pcfile;

return(file_exists($pcfile));
}
</code>

Es tan simple como parece, solamente comprueba que el archivo creado cuando se lanza el servidor de Pastecat aun existe. Lo segundo que podemos ver nuevo en nuestro codigo es la existencia de una nueva función llamada <code>stop</code>. Esta funcion invocará otra función en el controlador que parará el servidor de Pastecat:

<code php>
function stop() {
// Stops Pastecat server
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;

$page = "";
$cmd = $pcutils." stop ";
execute_program_detached($cmd);

return(array('type'=>'redirect','url'=>$staticFile.'/pastecat'));
}
</code>

Para hacer que el controlador entienda esta orden tendremos que modificarla sentencia <code>case</code> y añadir la nueva función. En el <code>case</code> añadiremos lo siguiente debajo de la opción <code>install</code>:

<code bash>
"stop")
shift
doStop $@
;;
</code>

Esto llama a la función <code>doStop</code> dentro del mismo controlador. Esta función será similar a:

<code bash>
doStop() {
# Stopping pastecat server
pcpid=$(cat $PCFILE | cut -d' ' -f1)
kill $pcpid

# Removing info file
rm $PCFILE
}
</code>

Esta función coge el PID de Pastecat del archivo que hemos creado antes, mata el proceso y finalmente borra el archivo de manera que PHP pueda detectar que Pastecat se ha parado.

Ahora podemos crear un servidor de Pastecat y pararlo. Aun así, aun hay algo que falta: hacer que el resto de usuarios puedan ver nuestro servicio. Para esto usaremos Avahi.

=== Publicación de servicios Avahi ===

Una de las mejores cosas de Cloudy es la caracteristica de publicar nuestros servicios con Avahi, permitiendo a otros usuarios saber qué ofrecemos y que puedan unirse a nuestro servicio. Para hacer esto primero hemos de añadir algunas lineas de código en el controlador PHP, justo debajo de la llamada al controlador en Bash para activar el servidor Pastecat. Añadiremos las siguientes lineas:

<code php>
$description = str_replace(' ', '', $description);
$temp = avahi_publish($avahi_type, $description, $port, "");
$page .= ptxt($temp);
</code>

Aisí al final nuestra función quedará así:

<code php>
function _pcsource($port,$description) {
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type;

$page = "";
$device = getCommunityDev()['output'][0];
$ipserver = getCommunityIP()['output'][0];

if ($description == "") $description = $type;

$cmd = $pcutils." publish '$port' '$description'";
execute_program_detached($cmd);

$page .= t($ipserver);
$page .= par(t('Published this server.'));
$description = str_replace(' ', '', $description);
$temp = avahi_publish($avahi_type, $description, $port, "");
$page .= ptxt($temp);

$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));

return($page)
}
</code>

Con este simple paso hemos anunciado nuestro servicio en la red de Avahi. Pero el trabajo no acaba aquí, queda aun una cosa mas por hacer: crear un botón y programarlo de manera que cuando se pulse nos redirija directamente a nuestro servidor de Pastecat.

Para hacer esto hay una carpeta llamada <code>avahi</code> dentro del directorio <code>plug</code>. Los ''scripts'' que definen la acción a llevar a cabo cuando se pulsan los botones estan en diferentes archivos dentro de este directorio. De este modo, crearemos un archivo llamado <code>pastecat.avahi.php</code> que contendrá:

<code php>
<?php
// plug/avahi/pastecat.avahi.php

addAvahi('pastecat','fpcserver');

function fpcserver($dates){
global $staticFile;

return ("<a class='btn' href='http://" .$dates['ip'] .":". $dates['port']."'>Go to server</a> ");
}
</code>

Esto creará un botón al lado del anuncio de Avahi que apuntará a nuestro servidor.

Ahora que ya tenemos nuestro servicio anunciado, queremos que este desaparezca una vez paremos el servidor de Pastecat. Este último paso es muy simple pero importante. Consiste en unas pocas lineas de código en la función 'stop' del ''script'' PHP. Hasta ahora, esta función solo llamaba al controlador Bash y paraba Pastecat, pero ahora también parará la publicación Avavhi y mostrará un breve comentario notificando que la llamada ha funcionado:

<code php>
$temp = avahi_unpublish($avahi_type, $port);
$flash = ptxt($temp);
setFlash($flash);
</code>

Estas lineas tienen que ser añadidas justo después de la sentencia <code>execute_program_detached($cmd)</code> en la función 'stop' de PHP.

=== Final ===

Finalmente añadir que todos los archivos implementados en este tutorial se pueden encontrar en un repositorio Github, que aparece en el apartado de Enlaces Externos, junto a este mismo tutorial en formato Markdown (md).

== Referencias ==

<references/>

== Enlaces externos ==

https://github.com/Clommunity/Doc/tree/master/plugins/pastecat

[[Categoría:Cloudy]]
[[ca:Cloudy_plug-ins]]
[[en:Cloudy_plug-ins]]

Cloudy web UI

2015-12-03T17:15:10Z

Conxuro:

== Introducción ==

La inferfaz web de usuario (web User Interface (UI)) de Cloudy utiliza una aplicación llamada cDistro <ref name="cdistro">cDistro git repository: https://github.com/Clommunity/cDistro</ref>.

''(Añadir qué es)''

== Configuración ==

La configuración de cDistro se encuentra en <s>/etc/cdistro.conf</s> /etc/cloudy/cloudy.conf

Por defecto tiene el siguiente formato:

#cdistro config
SERVER="/usr/bin/php"
OPTS=""
BINDIP="0.0.0.0"
PORT="7000"
DOCROOT="/var/local/cDistro"
# SSHAUTH=1 <- check user with ssh2 connection http://www.php.net/manual/en/function.ssh2-auth-password.php (Require: libssh2-php)
SSHAUTH=1
# LOGIN="root"
## PASSWORD = md5(md5('secret')) => php -r 'echo md5(md5("secret"))."\n";'
#PASSWORD="7022cd14c42ff272619d6beacdc9ffde"
PORT_SSL=7443

=== SERVER ===

La ruta del ejecutable PHP.

'''Ejemplo:'''

* "/usr/bin/php" - en el caso de Cloudy (Debian).

=== OPTS ===

Opciones de PHP.

''(Añadir referencias o más info y ejemplo)''

=== BINDIP ===

La dirección IP donde el servicio estará escuchando.

'''Ejemplo:'''

* "127.0.0.1" - aceptará sólo peticiones desde localhost.
* "0.0.0.0" - aceptará peticiones desde cualquier dirección.

=== PORT ===

El puerto que abrirà el servicio para escuchar peticiones.

'''Ejemplo:'''

* "7000" - abre el puerto 7000

=== DOCROOT ===

La ruta del ejecutable de la aplicación cDistro.

'''Ejemplo:'''

* "/var/local/cDistro" - en el caso de Cloudy.

=== SSLAUTH ===

Parámetro que permite autenticación vía SSH2 en la aplicación, es decir, para utilizar las credenciales que permita el servidor SSH del sistema.

Puede ser 0 o 1.

'''Ejemplo:'''

* "1" - activa esta opción.
* "0" - desactiva esta opción (requerirá definir usuario y contraseña).

=== LOGIN ===

El nombre de usuario para autenticarse en la aplicación.

Ha de ser una cadena sin espacios.

'''Ejemplo:'''

* "cloudy" - este usuario podrá hacer log-in con la contraseña de PASSWORD.

=== PASSWORD ===

La contraseña del usuario definido en LOGIN.

Ha de ser un ''hash'' sobre ''hash'' MD5 (hexadecimal), es decir, un ''hash'' del ''hash'' de la contraseña: md5(md5("PASSWORD")).

'''Ejemplo:'''

* "46d934e0f59ff1e2272f9f5f7950e5d9" - ''hash'' correspondiente a la cadena de carácteres "PASSWORD".

'''Ejemplos de cómo generar este ''hash'' en un terminal:'''

$ php -r 'echo md5(md5("PASSWORD"))."\n";'
46d934e0f59ff1e2272f9f5f7950e5d9
$ printf "PASSWORD" | md5sum | awk '{printf $1}' | md5sum | awk '{print $1}'
46d934e0f59ff1e2272f9f5f7950e5d9

=== PORT_SSL ===

Puerto que utilizará Cloudy en la interfaz web con HTTPS (si SSL está instalado).

'''Ejemplo:'''

* "7443" - se accederá a la web https://IP_SERVIDOR:7443.

== Referencias ==

<references/>

[[Categoría:Cloudy]]

Cloudy paquetes repositorio

2015-09-15T16:44:28Z

Conxuro: Página creada con «'''''Nota: este artículo puede estar desactualizado y debería ser revisado. Ten precaución si sigues esta guía, y mejor pregunta antes en las listas de correo.''''' ...»

'''''Nota: este artículo puede estar desactualizado y debería ser revisado. Ten precaución si sigues esta guía, y mejor pregunta antes en las listas de correo.'''''

== Subir paquetes al repositorio de software de Cloudy (proyecto Clommunity) ==

Estamos preparados para subir paquetes al repositorio público de Cloudy http://repo.clommunity-project.eu.

Aquí requeriremos claves públicas para firmar y subir paquetes. Por supuesto, puedes editar los scripts y cambiar las rutas ''(paths)'' de acuerdo a tus necesidades.

El repositorio está auto-firmado con una clave llamada "gcodis Distro Development Team", más información en el mismo repositorio: http://repo.clommunity-project.eu. El auto-firmado previene que el repositorio permanezca no firmado si alguien sube paquetes sin firmar. Una firma para el repositio, que es añadida en el lado del cliente para permitir la instalación de la distro, y otra firma que depende del mantenedor o desarrollador para firmar el paquete.

=== Claves públicas ===

Para subir paquetes necesitamos conseguir '''tus claves''' públicas:

* El '''ID de la clave pública GPG, subido a gpg.mit.edu'''. Con esta clave podrás firmar las subidas.
* La '''clave publica SSH''', para subir paquetes. Necesaria para acceder remotamente a la máquina del repositorio.

Los paquetes son subidos por defecto a la rama ''unstable'' (usa el "log de cambios" ''(changelog)'' para ello). Nosotros utilizamos la herramienta de Debian <code>dput</code> para subir los paquetes y firmarlos. El repositorio está auto-firmado con otra clave.

Puedes '''enviar''' las claves públicas o IDs a la lista de correo del proyecto: ''clommunity-wp4''. De esta manera tendremos acceso a las claves públicas cuando sea necesario.

=== Archivos ===

El archivo de configuración es:

* <code>.dput.cf</code> es un archivo de configuración que tiene que ser copiado en el directorio ''home'' como <code>~/.dput.cf</code>. Utilizado para subir paquetes con la herramienta de Debian <code>dput</code>.

<code>
[repo.clommunity-project.eu]
fqdn = repo.clommunity-project.eu
method = scp
login = repo
incoming = /var/www/debian/mini-dinstall/incoming
post_upload_command = ssh repo@repo.clommunity-project.eu "mini-dinstall -b"
</code>

=== Creando paquetes ===

Mira algunas maneras para crear paquetes en http://www.debian.org/doc/manuals/maint-guide/build.en.html.

=== Subiendo paquetes ===

Puedes usar el comando <code>dput</code> de la siguiente manera:

<code>
$ dput repo.clommunity-project.eu cloudy-base_0.1.3.5_i386.changes
</code>

Recuerda guardar las versiones previas del archivo <code>~/.dput.cf</code> en tu directorio <code>$HOME</code>.

Es importante escribir el nombre del repositorio ''(repo.clommunity-project.eu)''.

=== Mejoras continuas ===

El repositorio se mejora para funcionar mejor cuando es necesario dar un mejor servicio.

Gracias por tus esfuerzos.

[[Categoría:Cloudy]]

Cloudy Alix

2015-09-11T02:32:28Z

Conxuro: Página creada con «Alix es una [https://es.wikipedia.org/wiki/Placa_computadora SBC] con un procesador AMD (x86) y varias interfaces de entrada-salida (serie, miniPCI, Ethernet, etc.). Es por...»

Alix es una [https://es.wikipedia.org/wiki/Placa_computadora SBC] con un procesador AMD (x86) y varias interfaces de entrada-salida (serie, miniPCI, Ethernet, etc.). Es por ello que se tiene que utilizar un sistema operativo preparado con los controladores ''(drivers)'' corresponendientes para hacer funcionar estas interfaces.

''Nota: esta guía se ha hecho con una Debian especialmente preparada para funcionar en Alix, pero es posible que con otra distribución basada en Debian funcione con pasos similares.''

== Conseguir Debian para Alix ==

Puedes [https://code.google.com/p/debian-for-alix/ descargar de esta página] una imagen especial de Debian lista para funcionar en placas Alix una vez grabada en una tarjeta CF.

=== Características/servicios incluidos ===

* Sistema de archivos de sólo lectura, protege contra fallos de corriente y aumenta sustancialmente la vida de la tarjeta.

* Servicios comunes disponibles en el primer arranque:
** serial terminal ( 38400n8 )
** dnsmasq ( servidores DNS y DHCP )
** iptables ( reglas firewall y compartición de Internet )
** samba ( compartición de archivos de Microsoft Windows )
** cups ( servidor de impresora )
** vsftpd ( servidor FTP )
** nginx with fastcgi ( servidor HTTP )
** minidlna ( servidor multimedia )
** openssh ( terminal y SFTP )
** stunnel ( motor SSL, soporte HTTPS pre-configurado para ''nginx'' y ''transmission'' )
** tinyproxy ( servidor proxy HTTP/HTTPS )
** pptpd ( servidor VPN, MS Windows tiene un cliente incorporado )
** snmpd ( servidor SNMP )
** openvpn ( servidor y cliente VPN )
** openconnect ( cliente VPN client, compatible con Cisco )
** external storage automount and sharing basic web admin panel performance monitor ( on web panel )

* Servicios adicionales disponibles:
** transmission ( torrent p2p )
** hostapd ( wireless access point / necesita tarjeta miniPCI o usb wifi )

* Sistema de mantenimiento a través de <code>apt-get</code>, úsalo para actualizar, instalar o eliminar aplicaciones y parches.

* Ten en cuenta que es una Debian i386, por lo que cualquier software disponible para esta arquitectura puede ser instalado, considerando las limitaciones de potencia.

* Los archivos de imagen están disponibles para descargar en GoogleDrive:
** debian-for-alix-v1.img.bz2 (debian 6 based) version 1 wiki page
** debian-for-alix-v2.img.bz2 (debian 6 based) version 2 wiki page
** debian-for-alix-v3.img.bz2 (debian 7 based) Debian instalación básica, sólo servidor SSH y utilidades básicas, también el terminal serie está preparado, pero no tiene el sistema de ficheros en sólo lectura ni otras características.

* La configuración por defecto es:
<code>eth0: DHCP</code>

<code>eth1: static 172.16.210.254</code>

<code>eth2: sin configuración</code>

<code>usuario: alix (root tiene el acceso bloqueado)</code>

== Instalar la imagen Debian en la CF ==

=== Identificar la CF ===

La tarjeta CF necesita ser formateada con ext2. Asegúrate de qué dispositivo es tu tarjeta, de lo contrario podrías borrar el S.O. de tu ordenador. En este ejemplo la CF está en <code>/dev/sdb</code>.

Puedes probar mirando en <code>/proc/bus/usb/devices</code>. Deberías ver una sección con una linea ''S:'' y el nombre de tu lector, y una linea ''I:'' con <code>Driver=usb-storage</code>. Si lo ves, es que el kernel reconoce el dispositivo.

Instalar el paquete <code>sg3-utils</code> si lo tienes ya (en Debian: <code>apt-get install sg3-utils</code>). Para comprobar tus dispositivos SCSI, ejecuta el comando:
sg_scan -i

Deberías ver algo como esto:
/dev/sg0: scsi0 channel=0 id=0 lun=0 [em] type=0
eUSB Compact Flash 5.09 [wide=0 sync=0 cmdq=0 sftre=0 pq=0x0]

Muestra que el dispositivo “raw” SCSI asociado con tu lector es <code>/dev/sg0</code>. Puedes confirmar que el ''driver'' está funcionando mirando el archivo <code>/proc/scsi/scsi</code>. Ahora, para determinar el dispositivo SCSI real asociado con tu lector ejecuta el comando:
sg_map

Verás una salida como esta:
/dev/sg0 /dev/sdb

Eso es todo, tu lector de tarjetas es <code>/dev/sdb</code>. La primera (y probablemente la única) partición es <code>/dev/sdb1</code>.

=== Copiar la imagen en la CF ===

Para instalar la imagen en la tarjeta CF puedes hacerlo con el siguiente comando:
bzcat debian-for-alix-v3.img.bz2 | dd of=/dev/sdb bs=16k

== Instalar Cloudy ==

Para instalar Cloudy puedes seguir las instrucciones para [[Cloudy_en_Debian|convertir una instalación básica de Debian en Cloudy]] añadiendo al sistema los archivos y herramientas específicas de la distribución.

Lo llamamos "cloudynizar".

Recomendamos usar un script para automatizar el proceso. Puedes saber cómo en la [[cloudynizar|página de esta wiki que explica cómo "cloudynizar"]].

[[Categoría:Cloudy]]

Cloudy Beaglebone

2015-09-10T20:19:52Z

Conxuro: Página creada con «Beaglebone es una [https://es.wikipedia.org/wiki/Placa_computadora SBC] con un procesador ARM y varias interfaces de entrada-salida. Es por ello que se tiene que utilizar u...»

Beaglebone es una [https://es.wikipedia.org/wiki/Placa_computadora SBC] con un procesador ARM y varias interfaces de entrada-salida. Es por ello que se tiene que utilizar un sistema operativo preparado para funcionar en esta arquitectura y con los controladores ''(drivers)'' corresponendientes para hacer funcionar estas interfaces.

''Nota: esta guía se ha hecho con la distribución Ubuntu, pero es posible que con otra distribución basada en Debian funcione con los mismos pasos.''

== Instalar el sistema ==

* Insertar la tarjeta microSD en el ordenador y observar que dispositivo se registra tecleado <code>ls /dev/sd</code>. Si no estas seguro, elimina la tarjeta y la entrada desaparecerá. Una vez sepas que dispositivo corresponde a tu tarjeta sigue las siguientes instrucciones reemplazando <code>/dev/sdX</code> por el de tu microSD en tu sistema.

* Empezar particionando la tarjeta microSD escribiendo <code>fdisk /dev/sdX</code>.
# Inicializar una nueva tabla de particiones seleccionando <code>o</code>, luego verifica que este vacía seleccionando <code>p</code> ''(print)''.
# Crear una partición de arranque ''(boot)'' seleccionando <code>n</code> ''(new)'', luego <code>p</code> para ''primary'', y <code>1</code> para especificar la primera partición. Pulsar ''enter'' para aceptar el primer sector por defecto y especifica <code>4095</code> para el último sector.
# Cambiar el tipo de partición a FAT16 seleccionando <code>t</code> ''(type)'' y <code>e</code> para ''‘W95 FAT16 (LBA)’''.
# Marcar la partición como arrancable selecionando <code>a</code> y luego <code>1</code>.
# Crear la partición de datos para el sistema de ficheros seleccionado <code>n</code> ''(new)'', luego <code>1</code> ''(primary)'' y <code>2</code> para especificar la segunda partición. Aceptar los valores por defecto para el primer y último sector pulsando ''enter'' cada vez (x2).
# Pulsar <code>p</code> para ‘imprimir’ la tabla de particiones.
# Finalmente, guardar los cambios seleccionando <code>w</code> para "escribir" ''(write)'' la tabla de particiones y salir de ''fdisk''.

* Formatear las particiones e instalar el sistema de arranque y el sistema raíz.
# Formatear la partición 1 como FAT escribiendo <code>mkfs.vfat /dev/sdX1</code>.
# Formatear la partición 2 como ext4 escribiendo <code>mkfs.ext4 /dev/sdX2</code>.
# Instalar ''u-boot'' en la tarjeta microSD.
wget http://s3.armhf.com/dist/bone/bone-uboot.tar.xz
mkdir boot
mount /dev/sdX1 boot
tar xJvf bone-uboot.tar.xz -C boot
umount boot
# Instalar el sistema raiz de ficheros deseado en la tarjeta microSD (Ubuntu Trusty en este ejemplo).
wget http://s3.armhf.com/dist/bone/ubuntu-trusty-14.04-rootfs-3.14.4.1-bone-armhf.com.tar.xz
mkdir rootfs
mount /dev/sdX2 rootfs
tar xJvf ubuntu-trusty-14.04-rootfs-3.14.4.1-bone-armhf.com.tar.xz -C rootfs
umount rootfs

La tarjeta microSD ya está lista para arrancar. Nótese que para esta instalación de Ubuntu, el userid de login es ''ubuntu'' y la contraseña es ''ubuntu''.

''Nota: la caché de paquetes ha sido vaciada para reducir el tamaño de la imagen. Ejecuta <code>apt-get update</code> después de iniciar para actualizar la caché de paquetes, luego ejecuta <code>apt-get upgrade</code> para instalar las actualizaciones.''

== Instalar Cloudy ==

Para instalar Cloudy puedes seguir las instrucciones para [[Cloudy_en_Debian|convertir una instalación básica de Debian en Cloudy]] añadiendo al sistema los archivos y herramientas específicas de la distribución.

Lo llamamos "cloudynizar".

Recomendamos usar un script para automatizar el proceso. Puedes saber cómo en la [[cloudynizar|página de esta wiki que explica cómo "cloudynizar"]].

[[Categoría:Cloudy]]

Cloudy Raspberry Pi

2015-09-10T18:00:14Z

Conxuro:

La Raspberry Pi es un pequeño y económico ordenador del tamaño de una tarjeta de crédito, creado principalmente para ser utilizada con fines educativos y en pequeños proyectos.

Esta placa tiene un procesador ARM y diversas interfaces de entrada-salida; vídeo, audio, Ethernet, USB, GPIO, etc. Es por ello que se tiene que utilizar un sistema operativo preparado para funcionar en esta arquitectura y con los controladores (''drivers'') corresponendientes para hacer funcionar estas interfaces.

En nuestro caso, para instalar Cloudy se preparará la Raspberry Pi con una distribución ya adaptada basada en Debian como es Raspbian, y una vez hecho esto se "cloudynizará" para añadir todo el contenido propio de Cloudy.

'''''Nota:''' Esta guia, así como diversas pruebas de instalación de Cloudy, se ha hecho con el S.O. Raspbian; pero es posible que con otra distribución basada en Debian funcione con los mismos pasos.''

== Descargar Raspbian ==

Vamos a la [https://www.raspberrypi.org/downloads/ página oficial] y descargamos la imagen ISO del sistema operativo que nos servirá de base.

Alternativamente se puede utilizar una variante de Raspbian, la [http://sirlagz.net/2013/07/19/raspbian-server-edition-2-5/ Raspbian Server Edition], que está preparada sin paquetes innecessarios (sistema gráfico, audio, etc.) para el uso de la Raspberry Pi como servidor.

== Instalar y configurar Raspbian ==

Grabamos la imagen en una tarjeta de memoria SD. Según el sistema operativo de tu ordenador puedes seguir una de estas guías (en inglés) para grabar imágenes ISO.

* [http://www.raspberrypi.org/documentation/installation/installing-images/linux.md Linux]
* [http://www.raspberrypi.org/documentation/installation/installing-images/mac.md Mac OS]
* [http://www.raspberrypi.org/documentation/installation/installing-images/windows.md Windows]

A continuación instertamos la tarjeta y encendemos la placa para comenzar el proceso de configuración con la herramienta <code>raspi-config</code>.

Básicamente lo que se recomienda hacer es:
# Expandir el sistema de ficheros para utilizar todo el espacio de la SD.
# Cambiar la contrasseña del usuario '''pi''' (por defecto).
# Cambiar la localización si queremos otro idioma, el uso horario (''timezone'') y el mapa de teclado.
# En opciones avanzadas; activar el servidor SSH, cambiar el ''hostname'' y actualizar la <code>raspi-config</code>.

Si quieres hacer más cambios, puedes encontrar más información en la [https://www.raspberrypi.org/documentation/configuration/raspi-config.md documentación de raspi-config].

No nos extenderemos más en explicar como se instala y configura Raspbian ya que está ampliamente documentado en Internet.

=== Opciones adicionales ===

Como se ha comentaado más arriba, hay una versión personalizada para funcionar como servidor, que elimina paquetes innecesarios. Ésta tendría que funcionar igual que la Raspbian original, pero es más recomendable hacer esta adaptación después de manera manual o automatizándolo con el ''script'' que desinstala los paquetes para dejar el sistema como la Raspbian Server Edition.

Podéis obtener más información y descargar este ''script'' en [http://sirlagz.net/2013/08/03/raspbian-server-edition-scripts/ la siguiente página].

== Instalar Cloudy ==

Para instalar Cloudy puedes seguir las instrucciones para [[Cloudy_en_Debian|convertir una instalación básica de Debian en Cloudy]] añadiendo al sistema los archivos y herramientas específicas de la distribución.

Lo llamamos "cloudynizar".

Recomendamos usar un script para automatizar el proceso. Puedes saber cómo en la [[cloudynizar|página de esta wiki que explica cómo "cloudynizar"]].

[[Categoría:Cloudy]]

Cloudy en Debian

2015-09-10T17:41:33Z

Conxuro: Página creada con «Puedes convertir una instalación básica de Debian en Cloudy siguiendo estos pasos: 1. Entrar vía SSH como usuario root (o una vez logeado) o ejecuta los próximos coma...»

Puedes convertir una instalación básica de Debian en Cloudy siguiendo estos pasos:

1. Entrar vía SSH como usuario root (o una vez logeado) o ejecuta los próximos comandos con la herramienta ''sudo''.

2. Actualizar la fecha del servidor instalando un cliente NTP ''(opcional)''.

apt-get install ntp

3. Añadir los backports de Debian, y los repositorios de Clommunity y Guifi.
* Backports Debian:
echo "deb http://ftp.debian.org/debian wheezy-backports main contrib" > /etc/apt/sources.list.d/backports.list
* Repositorio Clommunity:
echo "deb http://repo.clommunity-project.eu/debian unstable/" > /etc/apt/sources.list.d/cloudy.list
gpg --keyserver pgpkeys.mit.edu --recv-key A59C5DC8 && gpg --export --armor A59C5DC8 | apt-key add -
* Repositorio Guifi:
echo "deb http://serveis.guifi.net/debian guifi/" > /etc/apt/sources.list.d/serveis.list
gpg --keyserver pgpkeys.mit.edu --recv-key 2E484DAB && gpg --export --armor 2E484DAB | apt-key add -

4. Instalar algunos paquetes de Debian.
apt-get update
apt-get upgrade
apt-get install -y openssh-server openssh-client getinconf-client curl unzip make avahi-utils tahoe-lafs mysql-server python2.7 g++ make checkinstall openjdk-6-jre locales php5 libssh2-php libapache2-mod-encoding

'''''Nota''': si aparece este error: "Error W: GPG error: http://ftp.debian.org wheezy-backports InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY8B48AD6246925553" usa este comando:
apt-get --allow-unauthenticated upgrade
''

5. Instalar los paquetes ''"non-Debian"'' de Cloudy.
curl "https://raw.githubusercontent.com/Clommunity/lbmake/master/hooks/getinconf-client.chroot" | sh -
curl "https://raw.githubusercontent.com/Clommunity/lbmake/master/hooks/avahi-ps.chroot" | sh -
curl "https://raw.githubusercontent.com/Clommunity/lbmake/master/hooks/cDistro.chroot" | sh -

g. Reiniciar.

Después de esto, podrás entrar a la interfaz web de usuario en http://IP_dispositivo:7000

[[Categoría:Cloudy]]

Cloudy Raspberry PI

2015-07-22T00:59:56Z

Conxuro: Página redirigida a Cloudy Raspberry Pi

#REDIRECT [[Cloudy_Raspberry_Pi]]

Cloudy Raspberry Pi

2015-07-21T23:22:29Z

Conxuro:

La Raspberry Pi es un pequeño y económico ordenador del tamaño de una tarjeta de crédito, creado principalmente para ser utilizada con fines educativos y en pequeños proyectos.

Esta placa tiene un procesador ARM y diversas interfaces de entrada-salida; vídeo, audio, Ethernet, USB, GPIO, etc. Es por ello que se tiene que utilizar un sistema operativo preparado para funcionar en esta arquitectura y con los controladores (''drivers'') corresponendientes para hacer funcionar estas interfaces.

En nuestro caso, para instalar Cloudy se preparará la Raspberry Pi con una distribución ya adaptada basada en Debian como es Raspbian, y una vez hecho esto se "cloudynizará" para añadir todo el contenido propio de Cloudy.

'''''Nota:''' Esta guia, así como diversas pruebas de instalación de Cloudy, se ha hecho con el S.O. Raspbian; pero es posible que con otra distribución basada en Debian funcione con los mismos pasos.''

== Descargar Raspbian ==

Vamos a la [https://www.raspberrypi.org/downloads/ página oficial] y descargamos la imagen ISO del sistema operativo que nos servirá de base.

Alternativamente se puede utilizar una variante de Raspbian, la [http://sirlagz.net/2013/07/19/raspbian-server-edition-2-5/ Raspbian Server Edition], que está preparada sin paquetes innecessarios (sistema gráfico, audio, etc.) para el uso de la Raspberry Pi como servidor.

== Instalar y configurar Raspbian ==

Grabamos la imagen en una tarjeta de memoria SD. Según el sistema operativo de tu ordenador puedes seguir una de estas guías (en inglés) para grabar imágenes ISO.

* [http://www.raspberrypi.org/documentation/installation/installing-images/linux.md Linux]
* [http://www.raspberrypi.org/documentation/installation/installing-images/mac.md Mac OS]
* [http://www.raspberrypi.org/documentation/installation/installing-images/windows.md Windows]

A continuación instertamos la tarjeta y encendemos la placa para comenzar el proceso de configuración con la herramienta <code>raspi-config</code>.

Básicamente lo que se recomienda hacer es:
# Expandir el sistema de ficheros para utilizar todo el espacio de la SD.
# Cambiar la contrasseña del usuario '''pi''' (por defecto).
# Cambiar la localización si queremos otro idioma, el uso horario (''timezone'') y el mapa de teclado.
# En opciones avanzadas; activar el servidor SSH, cambiar el ''hostname'' y actualizar la <code>raspi-config</code>.

Si quieres hacer más cambios, puedes encontrar más información en la [https://www.raspberrypi.org/documentation/configuration/raspi-config.md documentación de raspi-config].

No nos extenderemos más en explicar como se instala y configura Raspbian ya que está ampliamente documentado en Internet.

=== Opciones adicionales ===

Como se ha comentaado más arriba, hay una versión personalizada para funcionar como servidor, que elimina paquetes innecesarios. Ésta tendría que funcionar igual que la Raspbian original, pero es más recomendable hacer esta adaptación después de manera manual o automatizándolo con el ''script'' que desinstala los paquetes para dejar el sistema como la Raspbian Server Edition.

Podéis obtener más información y descargar este ''script'' en [http://sirlagz.net/2013/08/03/raspbian-server-edition-scripts/ la siguiente página].

== Instalar Cloudy ==

Para instalar Cloudy lo que hacemos es "cloudynizar" el sistema para añadir los ficheros y herramientas propios de la distribución Cloudy.

Para hacer esto, podéis seguir las instrucciones de la [[cloudynizar|página de esta wiki que explica cómo cloudynizar un sistema Debian]].

[[Categoría:Cloudy]]

Cloudy Raspberry Pi

2015-07-21T20:14:20Z

Conxuro: Página creada con «La Raspberry Pi es un pequeño y económico ordenador del tamaño de una tarjeta de crédito, creado principalmente para ser utilizada con fines educativos y en pequeños p...»

La Raspberry Pi es un pequeño y económico ordenador del tamaño de una tarjeta de crédito, creado principalmente para ser utilizada con fines educativos y en pequeños proyectos.

Esta placa tiene un procesador ARM y diversas interfaces de entrada-salida; vídeo, audio, Ethernet, USB, GPIO, etc. Es por ello que se tiene que utilizar un sistema operativo preparado para funcionar en esta arquitectura y con los controladores (''drivers'') corresponendientes para hacer funcionar estas interfaces.

En nuestro caso, para instalar Cloudy se preparará la Raspberry Pi con una distribución ya adaptada basada en Debian como es Raspbian, y una vez hecho esto se "cloudinizará" para añadir todo el contenido propio de Cloudy.

'''''Nota:''' Esta guia, así como diversas pruebas de instalación de Cloudy, se ha hecho con el S.O. Raspbian; pero es posible que con otra distribución basada en Debian funcione con los mismos pasos.''

== Descargar Raspbian ==

Vamos a la [https://www.raspberrypi.org/downloads/ página oficial] y descargamos la imagen ISO del sistema operativo que nos servirá de base.

Alternativamente se puede utilizar una variante de Raspbian, la [http://sirlagz.net/2013/07/19/raspbian-server-edition-2-5/ Raspbian Server Edition], que está preparada sin paquetes innecessarios (sistema gráfico, audio, etc.) para el uso de la Raspberry Pi como servidor.

== Instalar y configurar Raspbian ==

Grabamos la imagen en una tarjeta de memoria SD. Según el sistema operativo de tu ordenador puedes seguir una de estas guías (en inglés) para grabar imágenes ISO.

* [http://www.raspberrypi.org/documentation/installation/installing-images/linux.md Linux]
* [http://www.raspberrypi.org/documentation/installation/installing-images/mac.md Mac OS]
* [http://www.raspberrypi.org/documentation/installation/installing-images/windows.md Windows]

A continuación instertamos la tarjeta y encendemos la placa para comenzar el proceso de configuración con la herramienta <code>raspi-config</code>.

Básicamente lo que se recomienda hacer es:
# Expandir el sistema de ficheros para utilizar todo el espacio de la SD.
# Cambiar la contrasseña del usuario '''pi''' (por defecto).
# Cambiar la localización si queremos otro idioma, el uso horario (''timezone'') y el mapa de teclado.
# En opciones avanzadas; activar el servidor SSH, cambiar el ''hostname'' y actualizar la <code>raspi-config</code>.

Si quieres hacer más cambios, puedes encontrar más información en la [https://www.raspberrypi.org/documentation/configuration/raspi-config.md documentación de raspi-config].

No nos extenderemos más en explicar como se instala y configura Raspbian ya que está ampliamente documentado en Internet.

=== Opciones adicionales ===

Como se ha comentaado más arriba, hay una versión personalizada para funcionar como servidor, que elimina paquetes innecesarios. Ésta tendría que funcionar igual que la Raspbian original, pero es más recomendable hacer esta adaptación después de manera manual o automatizándolo con el ''script'' que desinstala los paquetes para dejar el sistema como la Raspbian Server Edition.

Podéis obtener más información y descargar este ''script'' en [http://sirlagz.net/2013/08/03/raspbian-server-edition-scripts/ la siguiente página].

== Instalar Cloudy ==

Para instalar Cloudy lo que hacemos es "cloudinizar" el sistema para añadir los ficheros y herramientas propios de la distribución Cloudy.

Para hacer esto, podéis seguir las instrucciones de la [[cloudinizar|página de esta wiki que explica cómo cloudinizar un sistema Debian]].

[[Categoría:Cloudy]]

Cloudy en nodo cliente

2015-07-17T15:35:06Z

Conxuro: Página creada con «Cloudy utiliza un sistema de publicación y búsqueda de servicios para compartirlos con otros Cloudys. Para hacer esto, actualmente se emplea [https://www.serfdom.io/ Serf...»

Cloudy utiliza un sistema de publicación y búsqueda de servicios para compartirlos con otros Cloudys. Para hacer esto, actualmente se emplea [https://www.serfdom.io/ Serf].

Este software abre un puerto TCP en el servidor (Cloudy) para escuchar peticiones y poder comunicarse con otros.

Por tanto, para que un Cloudy instalado en un nodo cliente pueda interactuar con los otros Cloudys es necesario hacer algunos pasos adicionales:

1. Saber la dirección IP pública del nodo (10.x.x.x); no la IP asignada a Cloudy sino la IP asignada al nodo cliente.
* Puedes ir a la página de [http://guifi.net Guifi] de tu nodo para saber cuál es la IP de éste.

2. Modificar un par de ficheros y declarar la IP pública del nodo. Tienes que añadir la IP a los ficheros de configuración para que el software pueda anunciar correctamente la IP pública y no la privada.
* Para hacerlo, con el usuario '''''root''''', entra por linea de comandos lo siguiente:
<pre>
root@cloudy:~# echo "ADVERTISE_IP=10.x.x.x" >> /etc/avahi-ps-serf.conf
root@cloudy:~# echo "PUBLIC_IP=10.x.x.x" >> /etc/getinconf-client.conf
root@cloudy:~# /etc/init.d/serf restart

(donde 10.x.x.x es la IP pública de tu nodo)
</pre>

'''Ejemplo:'''
En un nodo con dirección IP 10.1.2.3 los ficheros tendrían que ser como:
<pre>
/etc/avahi-ps-serf.conf
SERF_RPC_ADDR=127.0.0.1:7373
SERF_BIND=5000
SERF_JOIN=10.139.40.82:5000
ADVERTISE_IP=10.1.2.3

/etc/getinconf-client.conf
#!/bin/sh
# Automatically generate file
GTC_SERVER_URL=http://10.139.40.84/index.php
NETWORK_NAME=demo
NETWORK_KEY=demo
INTERNAL_DEV=eth0
# PORT=665
# GETINCONF_IGNORE=1
GETINCONF_IGNORE=1
PUBLIC_IP=10.1.2.3
</pre>

3. Hacer una redirección (''port forwarding'') del puerto 5000 (''Serf'') en el node. Y si quieres tener más servicios tendrás que redireccionar el puerto de cada uno de éstos.
* La configuración para hacer esto dependerá del dispositivo que tengas.

[[Categoría:Cloudy]]

Portada

2015-05-27T13:13:58Z

Conxuro:

__NOTITLE__
{| style="background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em;"
| valign="top" style="padding:12px 17px 5px 17px" |
'''Guifi.net''' es de todos, participa [[conectar|conectando]] tu [[tramo de la red]] con la de los demás.

Es un proyecto colaborativo [[organización horizontal|organizado horizontalmente]] que agrupa tanto a personas individuales como a colectivos, empresas y administraciones.

Es abierto, por lo que todo el mundo puede participar en igualdad de condiciones, en el marco de [http://guifi.net/es/ProcomunXOLN Procomún de la Red Abierta, Libre y Neutral]
<div style=" text-align: right">[[Guifi.net|Más sobre Guifi.net]]</div>
{| style="width:100%; background:#f6f6f6"
| style="background:#f6f6f6; text-align: right; width 30%" |<div style="width: 400px; margin: 0 auto; background-color: #fcfcfc; border: 1px solid #ccc; border-bottom: 5px groove #999999; border-right:5px groove #999999; text-align: center; padding: 0.4em;">
<div style="font-size: 162%; padding: 0.1em;">Bienvenid@ al wiki de '''Guifi.net'''</div>
<div style="font-size: 95%;">Documentación sobre la red abierta, libre y neutral.</div>
<div style="font-size: 85%;">En estos momentos tenemos [[Especial:Estadísticas|{{NUMBEROFARTICLES}}]] [[Especial:Todas|artículos]] en español.
[[Especial:PáginasRequeridas|Escribir una página requerida]]</div></div>
|}
{| style="background:#f6f6f6; width:100%;"
|''La documentación de guifi.net contiene los documentos de referencia para usuarios nuevos, experimentados y desarrolladores. Sé libre [[Qué es un wiki|de editar esta wiki]] para mejorar su contenido.''
|}
<div style=" text-align: center">Contacta: [http://guifi.net/es/forum/231 Foros] '''|''' [http://lists.guifi.net Listas de correo] '''|''' [http://irc.guifi.net/?channels=guifi Chat]</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; background:#FFFFE0; border:1px solid #EECFA1; padding:10px; margin-bottom:7px; vertical-align:top; -moz-border-radius:1em; -webkit-border-radius:1em; border-radius:1em;" |

<div id="mp-tfa">
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Cómo conectarse a Guifi.net
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;">

* [[tres pasos|Cómo dar de alta y enlazar un nodo]]
* [[Elige el material]]
* [[Configura tu ordenador]]
* [[Buenas Prácticas|Código de buenas prácticas]]

|}</div>

| style="border:1px solid transparent;" |
| style="width:50%;background:#f5fffa;border:1px solid #99CC33;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-itn">
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodos, islas y nuevas zonas
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;">
* [[Empezar el proyecto en una nueva zona]]
* [[Empezar una isla desde 0|Comenzar una isla desde cero]]
* [[Crear un supernodo]]
* [[Buenas Prácticas|Código de buenas prácticas]]</div></div>
|}</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; style="background:#f5faff;border:1px solid #cedff2;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-dyk">

<div style="float:right;">__TOC__</div>
== [[Legal]] ==
* [[Ayuntamientos]] / [[Anexo:Guifi.net en Ayuntamientos]]
* [[Associación|Constitución de una asociación]]
* [[Legislaciones|Legislaciones Países]]
* [[FAQ_Legal|FAQ]]
* [[Comunicación_comunidad|Cómo realizar la comunicación de instalación de nodo guifi.net a la Comunidad de Vecinos]]

== Red ==
=== Los básicos en la web ===
* [[Zona|Crear y modificar una zona]]
* [[Añadir_un_nodo_de_guifi.net|Añadir un nodo de guifi.net]]
* [[Servicios|Crear servicios y vincularlos en los servidores]]
* [[Herramientas|Herramientas (localización de IPs y MACs, estadísticas, mapas de enrutamiento, etc.)]]

=== Infraestructura ===
* [[Crear_un_supernodo|Montaje de supernodos]]
* [[Filtros de red]]
* [[Enlaces virtuales]]
* [[Herramienta para buscar rangos de IPs libres]]
* [[Nanostations: Modificando configuración por consola]]
* [[Configuración de antena TP-LINK TL-WA7510N]]

=== Mesh ===
* [[Abrir_redes_tipo_mesh_a_trav%C3%A9s_de_Guifi.net#Crear_una_nube_Mesh|Crear una nube Mesh en Guifi.net]]
* [[Abrir_redes_tipo_mesh_a_trav%C3%A9s_de_Guifi.net#Conectarse_a_una_red_Mesh|Conectarse a una nube Mesh de Guifi.net]]
* [[:ca:Annex:subxarxes_mesh|Listado de redes Mesh (catalán)]]
* [[Quick_Mesh_Project|Quick Mesh Project (qMp)]]
* [[Alix+GSF|ALIX + Conectarse a la nube de gracia con mesh]]
* [[Mesh|Otros artículos sobre Mesh]]

=== Enrutamientos y conceptos de redes ===
{{div col|cols=2}}
* [[Enrutamientos]]
* [[Peerings]]
* [[IPv4]]
* [[IPv6]]
* [[Criterios de asignación de direcciones IPv4]]
* [[ARP]]
* [[Cables_UTP|Cables UTP]]
{{div end}}

=== General ===
{{div col|cols=2}}
* [[Cómo se vertebra la red: Troncal, puntos de acceso y conexiones simples]]
* [[La seguridad en la red abierta]]
* [[Aplicaciones | Aplicaciones de guifi.net]]
* [[Recursos externos]]
* [[Instalar firmware Ubiquiti Rocket M5]]
{{div end}}

== Sistemas ==

=== Servicios básicos ===
{{div col|cols=2}}
* [[Configurar Repositorio APT guifi]]
* [[Servidor Proxy]]
* [[Squid autentificándose contra squid]]
* [[Servidor de gráficas]]
* [[SNPservices]]
* [[Servidor DNS]]
* [[Servidor Reloj|Servidor de Reloj (NTP)]]
* [[Configurar red]]
{{div end}}

=== Servicios de compartición de ficheros ===
{{div col|cols=2}}
* [[Servidor FTP]]
* [[Servidor Peer 2 Peer]]
* [[Servidor DCC]]
{{div end}}

=== Servicios de mensajería ===
{{div col|cols=2}}
* [[Servidor de Correo]]
* [[Webmail]]
* [[Servidor Jabber]]
* [[Servidor IRC]]
* [[Mailman]]
{{div end}}

=== Servicios de Voz y Vídeo ===
{{div col|cols=2}}
* [[VoIP|Servidor de VeuIP (VoIP)]]
* [[Servidor Radio Streaming]]
{{div end}}

=== Otros Servicios ===
{{div col|cols=2}}
* [[LDAP|Servidor LDAP]]
* [[Apache|Servidor web Apache]]
* [[Servidor Repositorio Linux]]
* [[Servidor Repositorio Linux (Cache)]]
* [[Servidor Iperf]]
* [[Servidor repositorio subversion]]
* [[DHCP|Servidor DHCP]]
* [[MySQL]] (Bases de Datos)
* [[Proxmox]] (virtualitzación)
* [[Cacti]] (monitorización)
* [[Clamav]] (antivirus con GNU/Linux)
* [[Trac]] (sistema de gestión de tiquets)
* [[Monitor]] (Monitorización de la red distribuida)
{{div end}}

=== Sistema ===
{{div col|cols=2}}
* [[ACPI]]
* [[Bridges_con_Linux|Bridges con GNU/Linux]]
* [[Chroot]]
* [[Corkscrew]]
* [[Distribución guinux]]
* [[Servidor compacto con una routerstation]]
* [[Comtrend_hg536%2B]] Reciclar router de Jazztel o telefónica como router neutro con OpenWRT
{{div end}}

=== Cloudy ===
* [[Qué es Cloudy]]
* [[Cloudy plug-ins]]
* [[Cloudy|Otros artículos sobre Cloudy]]

== Estándares de transmisión de datos y organizaciones colaboradoras ==
{{div col|cols=2}}
* [http://es.wikipedia.org/wiki/IEEE_802.11 IEEE 802.11]
* [http://es.wikipedia.org/wiki/Multimedia_over_Coax_Alliance Multimedia over Coax Alliance]
* [http://en.wikipedia.org/wiki/HomePNA HomePNA]
* [[Aprovechar el cable de antena de televisión]]
{{div end}}

== [[Instaladores]] ==
{{div col|cols=2}}
* [[Pararrayos]]
* [[Aprovechar el cable de antena de televisión]]
* [[Presupuestos]]
* [http://guifi.net/ca/node/12486 Comunidad de vecinos, caso de ejemplo]
* [[Reinicio remoto de nodos]]
* [[Campanarios]]
{{div end}}

== Desarrolladores ==
{{div col|cols=2}}
* [[Preparando el entorno de desarrollo]]
* [[Manual editor wiki]]
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]
* [[Actualizaciones módulos drupal]]
* [[Mapas de nodos en la web]]
* [http://gitorious.org/guifi Repositorios del código del proyecto guifi.net]
* [[Mapa del código]]
* [[API de Guifi]]
* [[CNML]]
* [[Empotrar_mapa_de_guifi|Empotrar el mapa de Guifi-Google Maps en una web]]
* [[Unsóloclic]]
* [[:Categoría:router|Routers]]
* [[:Categoría:Telefonía móvil|Telefonía móvil sobre guifi.net]]
* [[Guifi.net Studio]]
{{div end}}

== Diseñadores ==
{{div col|cols=2}}
* [[Logos]]
* [[Maquetación de las distintas páginas web]]
* [[Usabilidad]]
* [[Presentaciones de guifi.net]]
{{div end}}

== Desarrollo colectivo de la red ==
{{div col|cols=2}}
* [[Cursos]]
* [[Necesidades]]
{{div end}}

== Glosario ==
{{Acontecimientos}}

* [[Términos usados habitualmente]]
* [[Guia Rápida de Guifi.net]]
* [[Preguntas Frecuentes]]
* [http://guifi.net/es/ESDocs Documentos basados en la web de guifi.net] antigua "ComEsFa"

{{clear}}
|}

= Accesos Rápidos =
* [http://planet.guifi.net Planet]
* [http://guifi.net/es/ProcomunXOLN Procomún XOLN (Licencia de la red)]
* [http://guifi.net/es/maps Mapa guifi]
* [http://guifi.net/es/grups Webs Regionales]
* [http://trac.guifi.net Reporta Errores de la web]
* [http://fundacio.guifi.net Fundación]
* [http://lists.guifi.net Listas de Correo]

[[ca:Portada]]
[[en:Main Page]]
[[eu:Azala]]
[[fr:Accueil]]
[[gl:Portada]]
[[pt:Página principal]]

Cloudy 64bits

2015-05-13T14:00:43Z

Conxuro:

Actualmente sólo existe generada la versión de 32 bits, sin embargo, puedes crear la versió de 64 bits de la siguiente manera:

Primero, descarga el sistema de generación o "constructor" de imágenes ''(image builder)'':

<pre>
apt-get install build-essential live-build imagemagick curl debootstrap git unzip
git clone http://dev.cloudy.community/guifi.net/cloudy-image-builder.git
</pre>

A continuación modifica las siguientes variables del archivo ''Makefile'':

<pre>
ARCH ?= amd64
FLAVOUR ?= amd64
</pre>

Finalmente, puedes generar la imagen con el siguiente comando:

<pre>sudo make</pre>

Una vez la imagen ha sido creada, tendrás una versión Cloudy de 64 bits en <code>./devel/binary.hybrid.iso</code>

----

Alternativamente puedes "Cloudynizar" una Debian de 64 bits para convertirla en Cloudy.

Lee cómo en la página [[Cloudynizar]] de la wiki.

[[Categoría:Cloudy]]

Cloudinizar

2015-05-13T12:59:30Z

Conxuro: Página redirigida a Cloudynizar

#REDIRECT [[Cloudynizar]]

Cloudynizar

2015-05-13T12:56:08Z

Conxuro: Página creada con «Una alternativa para instalar Cloudy es modificando un sistema Debian GNU/Linux, o basado en Debian, aplicando un ''script'' que convierte el sistema en un Cloudy. Para ha...»

Una alternativa para instalar Cloudy es modificando un sistema Debian GNU/Linux, o basado en Debian, aplicando un ''script'' que convierte el sistema en un Cloudy.

Para hacerlo puedes ejecutar los siguientes comandos:

<pre>
git clone https://github.com/Clommunity/cloudynitzar && cd cloudynitzar
chmod +x cloudynitzar.sh
sudo ./cloudynitzar
</pre>

[[Categoría:Cloudy]]

Cloudy 64bits

2015-05-13T12:38:29Z

Conxuro:

Cloudy 64bits

2015-05-13T12:37:31Z

Conxuro: Página creada con «Actualmente sólo existe generada la versión de 32 bits, sin embargo, puedes crear la versió de 64 bits de la siguiente manera: Primero, descarga el sistema de generaci...»

Actualmente sólo existe generada la versión de 32 bits, sin embargo, puedes crear la versió de 64 bits de la siguiente manera:

Primero, descarga el sistema de generación o "constructor" de imágenes ''(image builder)'':

<pre>
apt-get install build-essential live-build imagemagick curl debootstrap git unzip
git clone http://dev.cloudy.community/guifi.net/cloudy-image-builder.git
</pre>

A continuación modifica las siguientes variables del archivo ''Makefile'':

<pre>
ARCH ?= amd64
FLAVOUR ?= amd64
</pre>

Finalmente, puedes generar la imágen con el siguiente comando:

<pre>sudo make</pre>

Una vez la imágen ha sido creada, tendrás una versión Cloudy de 64 bits en <code>./devel/binary.hybrid.iso</code>

[[Categoría:Cloudy]]

Qué es Cloudy

2015-05-13T12:13:30Z

Conxuro:

Cloudy web UI

2015-05-12T18:49:46Z

Conxuro: Página creada con « == Introducción == La inferfaz web de usuario (web User Interface (UI)) de Cloudy utiliza una aplicación llamada cDistro <ref name="cdistro">cDistro git repository: htt...»

== Introducción ==

La inferfaz web de usuario (web User Interface (UI)) de Cloudy utiliza una aplicación llamada cDistro <ref name="cdistro">cDistro git repository: http://dev.cloudy.community/Guifi.net/web-interface</ref>.

''(Añadir qué es)''

== Configuración ==

La configuración de cDistro se encuentra en /etc/cdistro.conf

Por defecto tiene el siguiente formato:

#cdistro config
SERVER="/usr/bin/php"
OPTS=""
BINDIP="0.0.0.0"
PORT="7000"
DOCROOT="/var/local/cDistro"
# SSHAUTH=1 <- check user with ssh2 connection http://www.php.net/manual/en/function.ssh2-auth-password.php (Require: libssh2-php)
SSHAUTH=1
# LOGIN="root"
## PASSWORD = md5(md5('secret')) => php -r 'echo md5(md5("secret"))."\n";'
#PASSWORD="7022cd14c42ff272619d6beacdc9ffde"
PORT_SSL=7443

=== SERVER ===

La ruta del ejecutable PHP.

'''Ejemplo:'''

* "/usr/bin/php" - en el caso de Cloudy (Debian).

=== OPTS ===

Opciones de PHP.

''(Añadir referencias o más info y ejemplo)''

=== BINDIP ===

La dirección IP donde el servicio estará escuchando.

'''Ejemplo:'''

* "127.0.0.1" - aceptará sólo peticiones desde localhost.
* "0.0.0.0" - aceptará peticiones desde cualquier dirección.

=== PORT ===

El puerto que abrirà el servicio para escuchar peticiones.

'''Ejemplo:'''

* "7000" - abre el puerto 7000

=== DOCROOT ===

La ruta del ejecutable de la aplicación cDistro.

'''Ejemplo:'''

* "/var/local/cDistro" - en el caso de Cloudy.

=== SSLAUTH ===

Parámetro que permite autenticación vía SSH2 en la aplicación, es decir, para utilizar las credenciales que permita el servidor SSH del sistema.

Puede ser 0 o 1.

'''Ejemplo:'''

* "1" - activa esta opción.
* "0" - desactiva esta opción (requerirá definir usuario y contraseña).

=== LOGIN ===

El nombre de usuario para autenticarse en la aplicación.

Ha de ser una cadena sin espacios.

'''Ejemplo:'''

* "cloudy" - este usuario podrá hacer log-in con la contraseña de PASSWORD.

=== PASSWORD ===

La contraseña del usuario definido en LOGIN.

Ha de ser un ''hash'' sobre ''hash'' MD5 (hexadecimal), es decir, un ''hash'' del ''hash'' de la contraseña: md5(md5("PASSWORD")).

'''Ejemplo:'''

* "46d934e0f59ff1e2272f9f5f7950e5d9" - ''hash'' correspondiente a la cadena de carácteres "PASSWORD".

'''Ejemplos de cómo generar este ''hash'' en un terminal:'''

$ php -r 'echo md5(md5("PASSWORD"))."\n";'
46d934e0f59ff1e2272f9f5f7950e5d9
$ printf "PASSWORD" | md5sum | awk '{printf $1}' | md5sum | awk '{print $1}'
46d934e0f59ff1e2272f9f5f7950e5d9

=== PORT_SSL ===

Puerto que utilizará Cloudy en la interfaz web con HTTPS (si SSL está instalado).

'''Ejemplo:'''

* "7443" - se accederá a la web https://IP_SERVIDOR:7443.

== Referencias ==

<references/>

[[Categoría:Cloudy]]

Cloudy plug-ins

2015-04-24T14:46:09Z

Conxuro:

== ¿Qué es un plug-in? ==

Cloudy es una distribución de Linux basada en Debian que proporciona a los usuarios una interfaz simple y cómoda para gestionar diferentes servicios que pueden usarse a través de una red comunitaria; en nuestro caso, Guifi.

Al mismo tiempo, Cloudy ofrece una serie de herramientas que permiten a un usuario añadir un servicio de su agrado sin tener grandes conocimientos sobre redes e informática en general. Automaticamente, estos servicios se publican mediante Avahi, de manera que todo el que utilice Cloudy podrá hacer uso de estos servicios.

Otra manera de llamar estos servicios que se pueden poner y quitar de forma sencilla es ''plug-in''. Por tanto, entendemos por plug-in a un programa o software que un usuario quiere añadir a la distribución y que puede ser gestionado de forma simple des de la interfaz web que provee Cloudy.

== Añadir servicios a Cloudy ==

=== Una pequeña introducción ===

Esta guía te enseñará el proceso para añadir un nuevo servicio en la distribución Cloudy.

Para serclaro y dar algunos ejemplos al mismo tiempo, integraremos un servicio bastante simple mostrando algunos trozos de código por el camino. Para seguir el tutorial con más facilidad o bien para integrar servicios más complejos, estaría bien tener algunos conocimientos de Bash<ref name="Bash">(http://www.tldp.org/LDP/Bash-Beginners-Guide/Bash-Beginners-Guide.pdf)</ref> y de PHP<ref name="PHP">(https://php.net/manual/es/index.php)</ref>.

Por simplicidad utilizaremos Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. Es un buen candidato ya que:

* Es independiente y no se ''federa'' ni se comunica con otros nodos.
* Está hecho en Go, es facil de distribuir e instalar.
* No necesita archivos de configuración.
* No necesita muchos recursos.

=== Obtener el binario ===

Lo primero que hemos de investigar es como descargar e instalar el binario en Cloudy. La mayoria de software que podemos encontrar está por defecto en los paquetes de Debian, pero Pastecat no está. Si se diera el caso de que estuviera, solo tendríamos que ejecutar el comando <code>apt-get install pastecat</code> desde PHP.

Pero como este no es el caso, tendremos que obtener el binario por otro lado. Una opcion es coger el código fuente y compilarlo nosotros mismos, pero el problema de esto es que Cloudy necesitaria incluir muchas herramientas y librerias de desarrollo, y este no es el objetivo.

La mejor opción si un paquete de Debian no está disponible en los repositorios es descargar los binarios de otro lugar seguro. Podemos utilizar el servicio de ''"releases"'' de Github para ello. Las dos opciones nos dan un archivo ejecutable que tendríamos que ser capaces de ejecutar directamente sobre Cloudy.

En este caso en particular descargaremos los binarios desde el repositorio git con la siguiente linea de comandos:

<code>
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386
</code>

Nótese que en este caso en concreto estamos descargando una versión específica para Linux con arquitectura i386.

Fijaos que tener un servicio en los paquetes de Debian tiene muchas ventajas:

* Las actualizaciones son simples y no necesitan trabajo extra desde Cloudy.
* El paquete está compilado para Debian de manera segura.
* Los archivos de ''init.d'' ya vienen por defecto.
* Los paquetes de Debian suelen contener correciones.

=== Probarlo ===

Antes de añadir un servicio deberíamos configurarlo y probarlo nosotros directamente para ver cómo funciona y que realmente funciona. También hemos de entender qué opciones de configuración o de linea de comandos necesitamos para hacer uso de este servicio en particular y como lo gestionariamos una vez este funcionando.

=== Añadir el controlador ===

En <code>web/plug/controllers</code> tenenmos un archivo PHP para cada servicio, llamado controlador (o 'controller' en inglés). Este archivo contiene el codigo que se ejecutará cuando se visite la página de nuestro servicio desde la interfaz de Cloudy.

==== Añadir la función indice ====

Lo que queremos es que nuestro servicio esté integrado en la estructura web de Cloudy. Para ello, necesitamos crear unos cuantos ''scripts'' en PHP y añadirlos a nuestro sistema. De momento crearemos dos ''scripts'': <code>pastecat.php</code> y <code>pastecat.menu.php</code>. El primer archivo es el controlador, es decir, el ''script'' que renderiza la página y tiene toda la información tal como botones o redireccionamientos. El otro es el que permite que nuestro servicio se muestre en los menus superiores desplegables de Cloudy.

El código del menú será similar a esto:

<code php>
<?php
//peerstreamer.menu.php
addMenu('Pastecat','pastecat','Clommunity');
</code>

Por ahora, utilizaremos un ''script'' muy simple en PHP como controlador:

<code php>
<?php
//pastecat
$title="Pastecat";

function index(){
global $paspath,$title;
global $staticFile;

$page=hlc(t($title));
$page .= hl(t("Minimalist pastebin engine written in Go"),4);
$page .= par(t("A simple and self-hosted pastebin service written in Go").' '.t("Can use a variety of storage backends").' '.t(" Designed to optionally remove pastes after a certain period of time.").' '.("If using a persistent storage backend, pastes will be kept between runs.").' '.t("This software runs the").' '."<a href='http://paste.cat'>".t("paste.cat")."</a>". t(" public service."));

return(array('type' => 'render','page' => $page));
}
</code>

En nuestro sistema Cloudy estos archivos han de ponerse en los directorios dentro de <code>/var/local/cDistro/plug/</code>. El primero ha de ir en <code>menus</code> y el segundo en el directori <code>controllers</code>. Una vez hecho esto podemos ir a la web de nuestro Cloudy y acceder al nuevo menú Pastecat.

==== Hacer que el controlador instale nuestro servicio ====

Como se ha comentado anteriormente, este paso es mucho más sencillo de hacer si el servicio está entre los paquetes de Debian. Como que no es el caso de Pastecat, lo tendremos que hacer manualmente. Normalmente hacer este proceso manualmente incluye una combinación de los comandos <code>wget</code>, <code>mv</code> y <code>chmod</code>. En general, es buena idea mantener los archivos de este tipo de servicios en <code>/opt/SERVICENAME</code>.

En nuestro caso particular, lo primero que necesitamos es descargar el binario de la ''release'' de Github. Para ello utilizaremos el comando: <code>wget</code>. Dada una URL a un archivo, este comando permite descargar este archivo en nuestro sistema, i es lo que haremos con:

<code bash>
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386
</code>

Una vez tengamos el binario en nuestra máquina, lo moveremos al directorio /opt/pastecat/. Para mover los archivos por nuestro sistema usaremos el comando <code>mv</code>. Aun así, primero tendremos que crear el directorio donde pondremos el archivo. Para ello utilizaremos <code>mkdir</code> de la siguiente manera:

<code bash>
mkdir -p /opt/pastecat/
</code>

Una vez hayamos creado el directorio, es hora de mover el binario:

<code bash>
mv current_directory/pastecat_linux_386 /opt/pastecat/
</code>

Donde "current_directory" es el directorio donde previamente hemos descargado el binario. Como el nombre del binario depende de la arquitectura, para simplificar el código del controlador, cambiaremos el nombre del archivo ejecutable por algo más genérico y simple:

<code bash>
mv /opt/pastecat/pastecat_linux_386 /opt/pastecat/pastecat
</code>

Ahora nuestro binario se llama <code>pastecat</code> en lugar de <code>pastecat_linux_386</code>.

Estos pasos son los requisitos mínimos para instalar un servicio que no se ofrece directamente en los repositorios oficiales de Debian. Sin embargo, de cara a un usuario final, sería una pesadilla tener que hacer todos estos comandos en una consola conectado a través de <code>ssh</code> a su dispositivo, así que lo que haremos a continuación es crear un ''script'' en Bash que será llamado más adelante a traves de la interfaz web haciendo click en un botón.

Este ''script'' es la primera versión del controlador de Pastecat. Por ahora solo incluiremos una función para instalar Pastecat en nuestro dispositivo. Más adelante incluiremos otras funciones para proveer a nuestro ''script'' de más servicios:

<code bash>
#!/bin/bash
PCPATH="/opt/pastecat/"

doInstall() {
if isInstall
then
echo "Pastecat is already installed."
return
fi

# Creating directory and switching
mkdir -p $pcpath && cd $pcpath

# Getting file
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386

# Changing name so controller can invoke it generically
mv pastecat_linux_386 pastecat
chmod +x pastecat

cd -
}

isInstalled() {
[ -d $pcpath ] && return 0
return 1
}

case $1 in
"install")
shift
doInstall $@
;;
esac
</code>

Podemos ver como los últimos pasos se han concentrado en una misma función, permmiténdonos instalar el software en el dispositivo de una manera mas sencilla.

==== Hacer que el controlador utilitce Pastecat ====

===== Ejecutar el servicio =====

El paso siguiente es hacer que nuestro software se pueda utilizar desde la intarfaz web. Para ello incluiremos una nueva opción en nuestra página principal de Pastecat e incluiremos una nueva función en nuestro controlador para gestionar el binario. Añadiremos un botón en el código PHP de la siguiente manera:

<code bash>
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));
</code>

Ha de ir justo después del mensaje <code>Pastecat is installed</code>. A continuación se ha de implementar la función <code>publish</code> en el mismo PHP. Esta función es la responsable de llamar a la función correspondiente desde el controlador y anunciar nuestro servicio utilizando Avahi. La diferencia con esta función es que requiere un formulario para introducir datos, así que al final acabaremos teniendo dos funciones: una ''get'' i una ''post'':

<code php>
function publish_get() {
global $pcpath,$title;
global $staticFile;

$page = hlc(t($title));
$page .= hlc(t('Publish a pastecat server'),2);
$page .= par(t("Write the port to publish your Pastecat service"));
$page .= createForm(array('class'=>'form-horizontal'));
$page .= addInput('description',t('Describe this server'));
$page .= addSubmit(array('label'=>t('Publish'),'class'=>'btn btn-primary'));
$page .= addButton(array('label'=>t('Cancel'),'href'=>$staticFile.'/peerstreamer'));

return(array('type' => 'render','page' => $page));
}

function publish_post() {
$port = $_POST['port'];
$description = $_POST['description'];
$ip = "";

<nowiki>$page = "<pre>";
$page .= _pcsource($description);
$page .= "</pre>";</nowiki>

return(array('type' => 'render','page' => $page));
}
</code>

Como podemos ver en la función <code>post</code> estamos invocando otra función. El motivo de hacer esto es escribir el código de manera más simple y modular. En esta última funcion por fin llamamos al script:

<code php>
function _pcsource($port,$description) {
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;

$page = "";
$device = getCommunityDev()['output'][0];
$ipserver = getCommunityIP()['output'][0];

if ($description == "") $description = $type;

$cmd = $pcutils." publish '$port' '$description';
execute_program_detached($cmd);

$page .= t($ipserver);
$page .= par(t('Published this server.'));

$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));

return($page)
}
</code>

Lo siguiente que hemos de hacer es crear una función <code>publish</code> en el controlador, por lo que añadiremos una nueva función al controlador básico que tenemos en la sección '''3.2'''. Primero añadiremos un nuevo paámetro llamado ''publish'', asi que la primera parte en ejecutarse del ''script'' sera:

<code bash>
if [ $# -lt 1 ]
then
doHelp
fi

case $1 in
"install")
shift
doInstall $@
;;
"publish")
shift
doServer $@
;;
esac
</code>

Como se puede ver, cuando el primer argumento del ''script'' es <code>publish</code>, desplazamos (''shift'') el resto de argumentos y llamamos a la funcion <code>doServer</code>. En esta función hemos de poner en marcha el servicio con los argumentos correspondientes, así que lo primero queharemos será poner estos parámetros en variables locales. Una vez hecho esto lo más lógico sería lanzar la aplicación directamente, pero como el ''script'' se llama con permisos de "root" (no recomendable), hemos de lanzar Pastecat como usuario <code>nobody</code>. El problema es que el usuario <code>nobody</code> no tiene casi permisos y Pastecat necesita algunos persmisos para crear directorios y archivos de texto. Para permitir que <code>nobody</code> pueda hacerlo, primero crearemos un directorio con permisos a casi todos los usuarios. Para esto, utilizaremos el comando <code>chmod</code> de nuevo. Ahora el usuario puede crear archivos y directorios dentro de este mismo directorio, y en consecuencia podemos ejecutar Pastecat. Finalmente hay que mantener el PID en una variable en caso de que lo necesitemos más adelante (que ya os adelantamos que sí lo necesitaremos):

<code bash>
doServer() {
# Turning machine into a server

local port=${1:-""}
local description=${2:-""}
local ip=${3:-"0.0.0.0"}

# Creating directory with nobody permissions
mkdir -p "/var/local/pastecat"
chmod 777 "/var/local/pastecat" && cd "/var/local/pastecat"

# Running pastecat
cmd='su '$PCUSER' -c "{ '$PCPATH$PCPROG' -l :'$port' > '$LOGFILE' 2>&1 & }; echo \$!"'
pidpc=$(eval $cmd) # keeping PID for future needs...

cd -

# Using the PID, we could carry on process control so if the pastecat process die, we can also
# stop the avahi process to avoid "false connections"

return
}
</code>

Fijaos que ahora estamos utilizando algunas variables globales que no estaban definidas antes, como <code>PCUSER</code> y <code>LOGFILE</code>. Estas variables tienen los siguientes valores:

<code bash>
PCPATH="/opt/pastecat/"
PCPROG="pastecat"
LOGFILE="/dev/null"
PCUSER="nobody
</code>

===== Parar el servicio =====

En algún momento es posible que queramos parar nuestro servicio. Para esto crearemos un botón para hacerlo. Lo primero que hacer sería crear el botón, pero si pensamos un poco veremos que antes de crearlo necesitamos una manera de saber si nuestro servicio esta ejecutándose o no. Además, también necesitamos una manera de parar nuestro servicio. Como estamos ejecutando sobre Linux, podemos parar el servicio fácilmente utilizando el comando <code>kill</code>. El problema es que para utilizar este comando primero necesitamos saber el número de identificación del proceso (PID). Por suerte, ja nos quedamos con este número cuando creamos el servidor de Pastecat; en concreto con la linea <code>pidpc=$(eval $cmd)</code>.

Ahora que tenemos todo lo que necesitamos para matar nuestro proceso vamos a ver como lo hacemos para que PHP pueda saber si el servicio está ejecutándose o no. Una manera fácil y eficiente de hacerlo es almacenando algunos datos útiles en un archivo y borrarlo cuando se pare Pastecat. De esta manera nos aseguramos que el archivo sólo existe cuando Pastecat está activo. Este archivo lo crearemos desde el controlador aádiendo las siguientes lineas justo despues de la sentencia que hemos mencionado en el párafo anterior:

<code bash>
# Writting server info to file
info="$pidpc http://$ip:$port" # Separator is space character
echo $info > $PCFILE
</code>

Donde <code>$PCFILE</code> es una variable global que contiene <code>/var/run/pc.info</code>. Fijaos
que el contenido del archivo sera el PID del Pastecat y la dirección completa del servidor de este.

Ahora ya tenemos una manera de saber si el servicio está activo o no, de manera que añadiremos justo a continuación el botón 'stop' en la interfaz web. Modificaremos un poco el ''script'' PHP que teniamos antes, añadiendo un anuncio indicando si Pastecat se está ejecutando o no, y dos botones más cuando éste esté ejecutándose. Así pues, nuestra función índice contendrá el siguiente codigo dentro de la condición que comprueba si Pastecat está instalado o no:

<code php>
<nowiki>$page .= "<div class='alert alert-success text-center'>".t("Pastecat is installed")."</div>\n";
if ( isRunning() ) {
$page .= "<div class='alert alert-success text-center'>".t("Pastecat is running")."</div>\n";
$page .= addButton(array('label'=>t('Go to server'),'href'=>'http://'. getCommunityIP()['output'][0] .':'. $port));
$page .= addButton(array('label'=>t('Stop server'),'href'=>$staticFile.'/pastecat/stop'));
} else {
$page .= "<div class='alert alert-error text-center'>".t("Pastecat is not running")."</div>\n";
}
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));</nowiki>
</code>

En este trozo de código podemos apreciar dos nuevas cosas. La priemra es una función de comprobación llamada <code>isRunning()</code>. Esta función se parece mucho a la funcion que utilizamos para comprar si Pastecat esta instalado o no:

<code php>
function isRunning() {
// Returns whether pastecat is running or not
global $pcfile;

return(file_exists($pcfile));
}
</code>

Es tan simple como parece, solamente comprueba que el archivo creado cuando se lanza el servidor de Pastecat aun existe. Lo segundo que podemos ver nuevo en nuestro codigo es la existencia de una nueva función llamada <code>stop</code>. Esta funcion invocará otra función en el controlador que parará el servidor de Pastecat:

<code php>
function stop() {
// Stops Pastecat server
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;

$page = "";
$cmd = $pcutils." stop ";
execute_program_detached($cmd);

return(array('type'=>'redirect','url'=>$staticFile.'/pastecat'));
}
</code>

Para hacer que el controlador entienda esta orden tendremos que modificarla sentencia <code>case</code> y añadir la nueva función. En el <code>case</code> añadiremos lo siguiente debajo de la opción <code>install</code>:

<code bash>
"stop")
shift
doStop $@
;;
</code>

Esto llama a la función <code>doStop</code> dentro del mismo controlador. Esta función será similar a:

<code bash>
doStop() {
# Stopping pastecat server
pcpid=$(cat $PCFILE | cut -d' ' -f1)
kill $pcpid

# Removing info file
rm $PCFILE
}
</code>

Esta función coge el PID de Pastecat del archivo que hemos creado antes, mata el proceso y finalmente borra el archivo de manera que PHP pueda detectar que Pastecat se ha parado.

Ahora podemos crear un servidor de Pastecat y pararlo. Aun así, aun hay algo que falta: hacer que el resto de usuarios puedan ver nuestro servicio. Para esto usaremos Avahi.

=== Publicación de servicios Avahi ===

Una de las mejores cosas de Cloudy es la caracteristica de publicar nuestros servicios con Avahi, permitiendo a otros usuarios saber qué ofrecemos y que puedan unirse a nuestro servicio. Para hacer esto primero hemos de añadir algunas lineas de código en el controlador PHP, justo debajo de la llamada al controlador en Bash para activar el servidor Pastecat. Añadiremos las siguientes lineas:

<code php>
$description = str_replace(' ', '', $description);
$temp = avahi_publish($avahi_type, $description, $port, "");
$page .= ptxt($temp);
</code>

Aisí al final nuestra función quedará así:

<code php>
function _pcsource($port,$description) {
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type;

$page = "";
$device = getCommunityDev()['output'][0];
$ipserver = getCommunityIP()['output'][0];

if ($description == "") $description = $type;

$cmd = $pcutils." publish '$port' '$description'";
execute_program_detached($cmd);

$page .= t($ipserver);
$page .= par(t('Published this server.'));
$description = str_replace(' ', '', $description);
$temp = avahi_publish($avahi_type, $description, $port, "");
$page .= ptxt($temp);

$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));

return($page)
}
</code>

Con este simple paso hemos anunciado nuestro servicio en la red de Avahi. Pero el trabajo no acaba aquí, queda aun una cosa mas por hacer: crear un botón y programarlo de manera que cuando se pulse nos redirija directamente a nuestro servidor de Pastecat.

Para hacer esto hay una carpeta llamada <code>avahi</code> dentro del directorio <code>plug</code>. Los ''scripts'' que definen la acción a llevar a cabo cuando se pulsan los botones estan en diferentes archivos dentro de este directorio. De este modo, crearemos un archivo llamado <code>pastecat.avahi.php</code> que contendrá:

<code php>
<?php
// plug/avahi/pastecat.avahi.php

addAvahi('pastecat','fpcserver');

function fpcserver($dates){
global $staticFile;

return ("<a class='btn' href='http://" .$dates['ip'] .":". $dates['port']."'>Go to server</a> ");
}
</code>

Esto creará un botón al lado del anuncio de Avahi que apuntará a nuestro servidor.

Ahora que ya tenemos nuestro servicio anunciado, queremos que este desaparezca una vez paremos el servidor de Pastecat. Este último paso es muy simple pero importante. Consiste en unas pocas lineas de código en la función 'stop' del ''script'' PHP. Hasta ahora, esta función solo llamaba al controlador Bash y paraba Pastecat, pero ahora también parará la publicación Avavhi y mostrará un breve comentario notificando que la llamada ha funcionado:

<code php>
$temp = avahi_unpublish($avahi_type, $port);
$flash = ptxt($temp);
setFlash($flash);
</code>

Estas lineas tienen que ser añadidas justo después de la sentencia <code>execute_program_detached($cmd)</code> en la función 'stop' de PHP.

=== Final ===

Finalmente añadir que todos los archivos implementados en este tutorial se pueden encontrar en un repositorio Github, que aparece en el apartado de Enlaces Externos, junto a este mismo tutorial en formato Markdown (md).

== Referencias ==

<references/>

== Enlaces externos ==

https://github.com/Clommunity/Doc/tree/master/plugins/pastecat

[[Categoría:Cloudy]]
[[ca:Cloudy_plug-ins]]
[[en:Cloudy_plug-ins]]

Cloudy plug-ins

2015-04-22T16:56:05Z

Conxuro:

Qué es Cloudy

2015-02-19T14:45:56Z

Conxuro:

[[File:clommunity-logo.png|right|100px]]
[[File:Logo_guifi.svg|right|100px]]

Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> es una distribución basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desarrollada en el marco del proyecto europeo CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref>

Esta distribución, inspirada en la idea de la antigua [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el despliegue y la gestión de los servicios de red en la nube ''(cloud services)''<ref name="cloud-services">Cloud computing: http://es.wikipedia.org/wiki/Computaci%C3%B3n_en_la_nube</ref>, así como la compartición de estos. Pensada en particular para los usuarios de redes comunitarias.<ref name="CN">Redes comunitarias: http://es.wikipedia.org/wiki/Comunidad_inal%C3%A1mbrica</ref>

----

== Introducción ==

Antes de la adopción general de servicios en la nube ''(cloud services)''<ref name="cloud-services"/> los usuarios de redes comunitarias <ref name="CN"/> ya compartían o proveían servicios y recursos a la comunidad; sin embargo, estos usuarios eran una minoria. Una de las principales razones es la barrera tecnológica. Antes de proveer contenidos, los usuarios que quieren compartir información con la comunidad tienen primero que preocuparse de los aspectos técnicos como el despliegue/montaje de un servidor con un conjunto de servicios.

En el pasado, los usuarios de Guifi.net, intentaron superar este problema publicando una distribución GNU/Linux llamada [[Guinux]] <ref name="guinux"/>, que daba a los usuarios finales una solución fácil para ofrecer servicios a la comunidad (tales como [[Servidor_Proxy|proxy web]], [[Servidor_DNS|servidor DNS]], [[SNPservices|monitorización y gráficas]]).

La clave principal de [[Guinux]] era un conjunto de ''scripts''<ref>http://es.wikipedia.org/wiki/Script</ref> que automatitzaban el proceso de configuración. Los usuarios solo tenían que introducir unos pocos parámetros como la dirección de correo electrónico y el identificador del nodo. Enseguida, después de estar disponible la distribución, el número de usuarios compartiendo recursos aumentó considerablemente.

De acuerdo con esto, quedó claro que reduciendo (o eliminando) la barrera d'entrada tecnológica animó a los usuarios a proveer de más servicios y a compartir sus recursos con la comunidad. Para ello, uno de los objetivos principales del proyecto CLOMMUNITY <ref name="clommunity"/> es publicar una distribución GNU/Linux, llamada Cloudy, dirigida a los usuarios, para fomentar la transición y adopción del entorno Cloud en redes comunitarias ''(Community Network Cloud)''.

=== Motivación ===

La distribución Cloudy ha sido pensada para satisfacer los siguientes requisitos:

# '''Distribución''': para potenciar la distribución de servicios en las redes comunitarias (CN; community networks) es necesaria una plataforma para publicar y descubrir estos servicios. De este modo, el acceso a los servicios no depende de despliegues estáticos de redes y la estructura es consciente de las condiciones dinámicamente cambiantes de las CN. El software elegido para la publicación y descubrimiento de servicios es Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.
# '''Descentralitzación''': una capa de red común es necesaria para permitir a todos los nodos de la nube comunicarse entre ellos directamente. Una buena manera de construir esto es creando una "capa 2 de red virtual" basada en un servicio VPN<ref>Red Privada Virtual: http://es.wikipedia.org/wiki/Red_privada_virtual</ref>. Entre las opciones disponibles, se ha elegido Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ya que cumple todos los requisitos y es sencillo de configurar y administrar. Para coordinar los dispositivos con Tinc VPN, se ha desarrollado una herramienta para automatizar el despliegue del sistema. Este software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, se encarga del proceso de configuración de Tinc VPN y del intercambio de claves con el resto de nodos de la nube.
# '''Facilidad de uso y experiencia de usuario''': para este objetivo, se ha desarrollado una plataforma web de administración destinada a integrar la instalación y configuración de los servicios en la nube habilitados en la distribución Cloudy. Una interfaz web simple y agradable <ref>Interfaz web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> está disponible para los usuarios como solución fácil de configuración, administración y monitorización de los servicios ''cloud'' activos en el nodo.
# '''Software libre''': la distribución está basada en Debian GNU/Linux<ref name="debian"/>. A parte de ser una de les distribuciones más populars y cumplir con los requisitos técnicos, ha sido elegida ya que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda y garantiza que el software será siempre abierto y libre.

== Requisitos mínimos ==

Al ser una sistema basado en Debian, tiene los mismos requisitos de hardware.<ref>Requisitos mínimos: https://www.debian.org/releases/stable/i386/ch03s04.html.es</ref>

La imagen del sistema Cloudy trae una serie de configuraciones y paquetes adicionales; por lo que hace que sean necesarios alrededor de '''450 MiB de espacio de almacenamiento'''.

De todos modos, es '''recomendable''' contar con '''al menos 1 GiB'''.

Si se quiere utilizar algunos servicios como PeerStreamer (leer más abajo) los requisitos mínimos aumentarán, tanto de espacio como de memoria y procesamiento.

== Conseguir Cloudy ==

Actualmente puedes obtener la distribución Cloudy mediante la descarga de una imagen ISO para grabar en un CD o memoria USB, o de un ''template'' para ejecutar directamente en una máquina virtual (contenedor LXC<ref>Linux containers (LXC): https://linuxcontainers.org/</ref> o OpenVZ<ref>http://openvz.org</ref>).

Alternativamente puedes bajar el codigo y compilarlo tú mismo.

=== Descarga la imagen ===

Ves a la página de Cloudy donde están las imagenes almacenadas:

http://repo.clommunity-project.eu/images/

Actualmente aun está en desarrollo y por tanto '''sólo está disponible la rama ''unstable'''''.

Ahí encontrarás:

* cloudy.README - Relación de paquetes adicionales incluidos en la imagen del sistema.
* cloudy.container.tar.gz - ''Template'' para crear una VM.
* cloudy.iso - Imatge ISO

==== Grabar la imagen ISO (Linux) ====

Los archivos ISO son ''live install CD images'', es decir, tienen un sistema de instalación que se ejecuta justo al iniciar la máquina desde el dispositivo (CD/DVD/USB).

Puedes grabarlo en:

* En un CD o DVD:

$ apt-get install xorriso
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso

* En una memoria USB:

$ dd if=cloudy.iso of=${USBSTICK}

=== Compilar ===

Para construir o compilar Cloudy se necesitan algunos programas en la máquina para poder descargar el código fuente, generar los binarios, manipular las imágenes ISO, etc.

1. Descargar los paquetes necesarios (ejemple con la herramienta ''apt'' de los sistemas basados en Debian):
sudo apt-get install build-essential live-build imagemagick curl debootstrap git unzip

2. Descargar el "constructor" ''LBmake'' (Live-Build Make) para crear la imagen:
git clone https://github.com/Clommunity/lbmake

3. Compilar y generar la imagen ISO (y el Linux Container):

* Ir al directorio donde se ha bajado el código de ''LBmake'' y compilar utilizando la herramienta de Linux ''make'':
cd lbmake
sudo make

4. Una vez generada la imagen puedes probarla virtualizando el sistema con QEMU.<ref>QEMU processor emulator: http://wiki.qemu.org/Main_Page</ref>

* Generar una imagen de disco y utilizar la imagen ISO como Live CD para la instalación:
qemu-img create -f qcow2 disk.qcow2 4G
qemu-system-i386 -enable-kvm -cdrom devel/binary.hybrid.iso -hda disk.qcow2

''NOTA: si tienes una máquina relativamente reciente, añadiendo la opción '-enable-kvm' se aprovecha la virtualitzación por hardware, con lo que aumentará la rápidez/fluidez.''

==== Linux container ====

Opcionalmente, a parte de la imagen ISO se puede crear un ''Linux Container'' con el siguiente comando:
sudo make container

''NOTA: antes de generar el contenedor (linux container) primero se tiene que haber creado la imagen ISO. En caso de que no fuera así, el comando anterior generará primero la ISO y después el contenedor.''

== Instalación ==

Como se explica en la introducción, la distribución Cloudy está basada en Debian GNU/Linux y contenida en una imagen ISO ''live''.

Puedes probar a arrancar el sistema desde el dispositivo externo (CD/DVD/USB), o bien iniciar el proceso de instalación, seleccionando la opción corresponendiente en el menú.

[[File:cloudy-boot-install.png|center]]

La instalación es igual que con un Debian estándar <ref>Debian installation procedure: http://www.debian.org/releases/stable/i386/</ref>, y los pasos se pueden resumir en:

# Escoger la opción ''Install'' en el menú de inicio. (min 0:06)
# Seleccionar el idioma por defecto de la instalación y del sistema. (min 0:12)
# Seleccionar tu ubicación. (min 0:16)
# Seleccionar el mapa de teclado. (min 0:19)
# Cambiar/asignar el nombre del sistema. (min 1:21)
# Añadir la contraseña de ''root''. (min 1:37)
# Crear una nueva cuenta de usuario con contraseña. (min 1:45)
# Particionar el disco. En el ejemplo se ha utilizado todo el disco con una sola partición. (min 2:02)
# Configurar el gestor de paquetes, añadiendo una réplica del repositorio de Debian más próximo. (min 3:10)
# Instalar el cargador (''boot loader'') GRUB en el registro maestro de arranque del disco (''master boot record''). (min 4:34)
# Finalizar la instalación para reiniciar la máquina e iniciar el nuevo sistema. (min 4:43)

''NOTA: las referencias en paréntesis corresponden al momento aproximado en el ejemplo en video <ref>Cloudy installation: http://videos.guifi.net/guifimedia/@cloudy/Cloudy%20installation.mp4</ref> del proceso de instalación.''

== Cómo actualizar ==

El sistema de actualización permite comprobar y actualizar los paquetes propios de Cloudy para no tener que reinstalar el sistema ni perder los datos.

En la versión actual, en el menú '''''System > Update''''', se puede comprobar si hay una versión nueva de los paquetes de Cloudy y actualizarlos uno a uno. También está la opción para hacer un ''upgrade'' general del sistema (paquetes de Debian).

[[File:cloudy-update.png|center|1024px]]

== Primeros pasos ==

Para acceder al sistema de configuración se hace mediante un navegador web entrando en la '''dirección''' de la máquina servidor en el '''puerto 7000'''.
http://DIRECCIÓN_IP:7000

Credenciales:
* '''Usuario:''' root
* '''Contraseña:''' root ''(por defecto en el container, y seleccionada durante la instalación con la imagen ISO)''

[[File:cloudy-home.png|center|1024px]]

Una vez dentro podemos ver la página inicial con información general del sistema y un menú superior con diferentes secciones, dividido en dos partes.

1. A la '''izquierda''' tenemos las opciones de configuración y monitorización del '''sistema'''.

* '''Cloudy:''' página de inicio.
* '''System:''' actualizaciones, configuración de usuario, desconexión.
* '''Languages:''' selecció de l'idioma.

2. A la '''derecha''' tenemos las opciones de configuración y gestión de los '''servicios'''.
* '''Search:''' herramientas para anunciar y buscar servicios en la red. Permite utilizar diferentes programas para ello.
* '''Clommunity:''' servicios introducidos en el proyecto CLOMMUNITY.
* '''Guifi.net:''' servicios habitualmente utilizados en la red de Guifi.net.

=== Servicios ===

A continuación podéis ver qué servicios hay acutalmente disponibles en Cloudy para ser configurados fácilmente a través de la interfaz web.

''"Por hacer: explicación de cada uno de los servicios (puede verse en inglés en la página de Cloudy <ref>Cloudy contents: http://cloudy.community/features/</ref>"''

==== Clommunity ====
* Getinconf (gestión del cliente TincVPN)
* OpenVZ Web Panel (gestión de máquinas virtuales)
* Peer Streamer (streaming distribuido)
* Syncthing (sincronización de archivos en red)
* Tahofe-LAFS (sistema de ficheros distribuido)
* Webdav server

==== Guifi ====
* Proxy3 (proxy web)
[[File:cloudy-guifi-proxy.png|center]]

* SNPServices (monitorización/gráficas)
[[File:cloudy-guifi-snpservices.png|center]]

* DNSServices (DNS)
[[File:cloudy-guifi-dnsservices.png|center]]

== Referencias ==

<references/>

== Enllaces externos ==

* http://cloudy.community
* http://wiki.clommunity-project.eu/soft:cloudservices
* http://clommunity-project.eu
* http://guifi.net

[[Categoría:Cloudy]]

Cloudy

2015-01-26T17:14:48Z

Conxuro: Página redirigida a Categoría:Cloudy

#REDIRECT [[Categoría:Cloudy]]

Categoría:Cloudy

2015-01-26T17:12:55Z

Conxuro: Página creada con «Más información (en inglés): * http://cloudy.community * http://wiki.clommunity-project.eu/soft:cloudservices»

Más información (en inglés):
* http://cloudy.community
* http://wiki.clommunity-project.eu/soft:cloudservices

Qué es Cloudy

2015-01-26T17:12:15Z

Conxuro:

[[File:clommunity-logo.png|right|100px]]
[[File:Logo_guifi.svg|right|100px]]

Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> es una distribución basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desarrollada en el marco del proyecto europeo CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref>

Esta distribución, inspirada en la idea de la antigua [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el despliegue y la gestión de los servicios de red en la nube ''(cloud services)''<ref name="cloud-services">Cloud computing: http://es.wikipedia.org/wiki/Computaci%C3%B3n_en_la_nube</ref>, así como la compartición de estos. Pensada en particular para los usuarios de redes comunitarias.<ref name="CN">Redes comunitarias: http://es.wikipedia.org/wiki/Comunidad_inal%C3%A1mbrica</ref>

----

== Introducción ==

Antes de la adopción general de servicios en la nube ''(cloud services)''<ref name="cloud-services"/> los usuarios de redes comunitarias <ref name="CN"/> ya compartían o proveían servicios y recursos a la comunidad; sin embargo, estos usuarios eran una minoria. Una de las principales razones es la barrera tecnológica. Antes de proveer contenidos, los usuarios que quieren compartir información con la comunidad tienen primero que preocuparse de los aspectos técnicos como el despliegue/montaje de un servidor con un conjunto de servicios.

En el pasado, los usuarios de Guifi.net, intentaron superar este problema publicando una distribución GNU/Linux llamada [[Guinux]] <ref name="guinux"/>, que daba a los usuarios finales una solución fácil para ofrecer servicios a la comunidad (tales como [[Servidor_Proxy|proxy web]], [[Servidor_DNS|servidor DNS]], [[SNPservices|monitorización y gráficas]]).

La clave principal de [[Guinux]] era un conjunto de ''scripts''<ref>http://es.wikipedia.org/wiki/Script</ref> que automatitzaban el proceso de configuración. Los usuarios solo tenían que introducir unos pocos parámetros como la dirección de correo electrónico y el identificador del nodo. Enseguida, después de estar disponible la distribución, el número de usuarios compartiendo recursos aumentó considerablemente.

De acuerdo con esto, quedó claro que reduciendo (o eliminando) la barrera d'entrada tecnológica animó a los usuarios a proveer de más servicios y a compartir sus recursos con la comunidad. Para ello, uno de los objetivos principales del proyecto CLOMMUNITY <ref name="clommunity"/> es publicar una distribución GNU/Linux, llamada Cloudy, dirigida a los usuarios, para fomentar la transición y adopción del entorno Cloud en redes comunitarias ''(Community Network Cloud)''.

=== Motivación ===

La distribución Cloudy ha sido pensada para satisfacer los siguientes requisitos:

# '''Distribución''': para potenciar la distribución de servicios en las redes comunitarias (CN; community networks) es necesaria una plataforma para publicar y descubrir estos servicios. De este modo, el acceso a los servicios no depende de despliegues estáticos de redes y la estructura es consciente de las condiciones dinámicamente cambiantes de las CN. El software elegido para la publicación y descubrimiento de servicios es Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.
# '''Descentralitzación''': una capa de red común es necesaria para permitir a todos los nodos de la nube comunicarse entre ellos directamente. Una buena manera de construir esto es creando una "capa 2 de red virtual" basada en un servicio VPN<ref>Red Privada Virtual: http://es.wikipedia.org/wiki/Red_privada_virtual</ref>. Entre las opciones disponibles, se ha elegido Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ya que cumple todos los requisitos y es sencillo de configurar y administrar. Para coordinar los dispositivos con Tinc VPN, se ha desarrollado una herramienta para automatizar el despliegue del sistema. Este software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, se encarga del proceso de configuración de Tinc VPN y del intercambio de claves con el resto de nodos de la nube.
# '''Facilidad de uso y experiencia de usuario''': para este objetivo, se ha desarrollado una plataforma web de administración destinada a integrar la instalación y configuración de los servicios en la nube habilitados en la distribución Cloudy. Una interfaz web simple y agradable <ref>Interfaz web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> está disponible para los usuarios como solución fácil de configuración, administración y monitorización de los servicios ''cloud'' activos en el nodo.
# '''Software libre''': la distribución está basada en Debian GNU/Linux<ref name="debian"/>. A parte de ser una de les distribuciones más populars y cumplir con los requisitos técnicos, ha sido elegida ya que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda y garantiza que el software será siempre abierto y libre.

== Requisitos mínimos ==

Al ser una sistema basado en Debian, tiene los mismos requisitos de hardware.<ref>Requisitos mínimos: https://www.debian.org/releases/stable/i386/ch03s04.html.es</ref>

La imagen del sistema Cloudy trae una serie de configuraciones y paquetes adicionales; por lo que hace que sean necesarios alrededor de '''450 MiB de espacio de almacenamiento'''.

De todos modos, es '''recomendable''' contar con '''al menos 1 GiB'''.

Si se quiere utilizar algunos servicios como PeerStreamer (leer más abajo) los requisitos mínimos aumentarán, tanto de espacio como de memoria y procesamiento.

== Conseguir Cloudy ==

Actualmente puedes obtener la distribución Cloudy mediante la descarga de una imagen ISO para grabar en un CD o memoria USB, o de un ''template'' para ejecutar directamente en una máquina virtual (contenedor LXC<ref>Linux containers (LXC): https://linuxcontainers.org/</ref> o OpenVZ<ref>http://openvz.org</ref>).

Alternativamente puedes bajar el codigo y compilarlo tú mismo.

=== Descarga la imagen ===

Ves a la página de Cloudy donde están las imagenes almacenadas:

http://repo.clommunity-project.eu/images/

Actualmente aun está en desarrollo y por tanto '''sólo está disponible la rama ''unstable'''''.

Ahí encontrarás:

* cloudy.README - Relación de paquetes adicionales incluidos en la imagen del sistema.
* cloudy.container.tar.gz - ''Template'' para crear una VM.
* cloudy.iso - Imatge ISO

==== Grabar la imagen ISO (Linux) ====

Los archivos ISO son ''live install CD images'', es decir, tienen un sistema de instalación que se ejecuta justo al iniciar la máquina desde el dispositivo (CD/DVD/USB).

Puedes grabarlo en:

* En un CD o DVD:

$ apt-get install xorriso
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso

* En una memoria USB:

$ dd if=cloudy.iso of=${USBSTICK}

=== Compilar ===

Para construir o compilar Cloudy se necesitan algunos programas en la máquina para poder descargar el código fuente, generar los binarios, manipular las imágenes ISO, etc.

1. Descargar los paquetes necesarios (ejemple con la herramienta ''apt'' de los sistemas basados en Debian):
sudo apt-get install build-essential live-build imagemagick curl debootstrap git unzip

2. Descargar el "constructor" ''LBmake'' (Live-Build Make) para crear la imagen:
git clone https://github.com/Clommunity/lbmake

3. Compilar y generar la imagen ISO (y el Linux Container):

* Ir al directorio donde se ha bajado el código de ''LBmake'' y compilar utilizando la herramienta de Linux ''make'':
cd lbmake
sudo make

4. Una vez generada la imagen puedes probarla virtualizando el sistema con QEMU.<ref>QEMU processor emulator: http://wiki.qemu.org/Main_Page</ref>

* Generar una imagen de disco y utilizar la imagen ISO como Live CD para la instalación:
qemu-img create -f qcow2 disk.qcow2 4G
qemu-system-i386 -enable-kvm -cdrom devel/binary.hybrid.iso -hda disk.qcow2

''NOTA: si tienes una máquina relativamente reciente, añadiendo la opción '-enable-kvm' se aprovecha la virtualitzación por hardware, con lo que aumentará la rápidez/fluidez.''

==== Linux container ====

Opcionalmente, a parte de la imagen ISO se puede crear un ''Linux Container'' con el siguiente comando:
sudo make container

''NOTA: antes de generar el contenedor (linux container) primero se tiene que haber creado la imagen ISO. En caso de que no fuera así, el comando anterior generará primero la ISO y después el contenedor.''

== Instalación ==

Como se explica en la introducción, la distribución Cloudy está basada en Debian GNU/Linux y contenida en una imagen ISO ''live''.

Puedes probar a arrancar el sistema desde el dispositivo externo (CD/DVD/USB), o bien iniciar el proceso de instalación, seleccionando la opción corresponendiente en el menú.

[[File:cloudy-boot-install.png|center]]

La instalación es igual que con un Debian estándar <ref>Debian installation procedure: http://www.debian.org/releases/stable/i386/</ref>, y los pasos se pueden resumir en:

# Escoger la opción ''Install'' en el menú de inicio. (min 0:06)
# Seleccionar el idioma por defecto de la instalación y del sistema. (min 0:12)
# Seleccionar tu ubicación. (min 0:16)
# Seleccionar el mapa de teclado. (min 0:19)
# Cambiar/asignar el nombre del sistema. (min 1:21)
# Añadir la contraseña de ''root''. (min 1:37)
# Crear una nueva cuenta de usuario con contraseña. (min 1:45)
# Particionar el disco. En el ejemplo se ha utilizado todo el disco con una sola partición. (min 2:02)
# Configurar el gestor de paquetes, añadiendo una réplica del repositorio de Debian más próximo. (min 3:10)
# Instalar el cargador (''boot loader'') GRUB en el registro maestro de arranque del disco (''master boot record''). (min 4:34)
# Finalizar la instalación para reiniciar la máquina e iniciar el nuevo sistema. (min 4:43)

''NOTA: las referencias en paréntesis corresponden al momento aproximado en el ejemplo en video <ref>Cloudy installation: http://videos.guifi.net/guifimedia/2014-05%20Cloudy,%20the%20community%20distro/cloudy-installation.mp4</ref> del proceso de instalación.''

== Cómo actualizar ==

El sistema de actualización permite comprobar y actualizar los paquetes propios de Cloudy para no tener que reinstalar el sistema ni perder los datos.

En la versión actual, en el menú '''''System > Update''''', se puede comprobar si hay una versión nueva de los paquetes de Cloudy y actualizarlos uno a uno. También está la opción para hacer un ''upgrade'' general del sistema (paquetes de Debian).

[[File:cloudy-update.png|center|1024px]]

== Primeros pasos ==

Para acceder al sistema de configuración se hace mediante un navegador web entrando en la '''dirección''' de la máquina servidor en el '''puerto 7000'''.
http://DIRECCIÓN_IP:7000

Credenciales:
* '''Usuario:''' root
* '''Contraseña:''' root ''(por defecto en el container, y seleccionada durante la instalación con la imagen ISO)''

[[File:cloudy-home.png|center|1024px]]

Una vez dentro podemos ver la página inicial con información general del sistema y un menú superior con diferentes secciones, dividido en dos partes.

1. A la '''izquierda''' tenemos las opciones de configuración y monitorización del '''sistema'''.

* '''Cloudy:''' página de inicio.
* '''System:''' actualizaciones, configuración de usuario, desconexión.
* '''Languages:''' selecció de l'idioma.

2. A la '''derecha''' tenemos las opciones de configuración y gestión de los '''servicios'''.
* '''Search:''' herramientas para anunciar y buscar servicios en la red. Permite utilizar diferentes programas para ello.
* '''Clommunity:''' servicios introducidos en el proyecto CLOMMUNITY.
* '''Guifi.net:''' servicios habitualmente utilizados en la red de Guifi.net.

=== Servicios ===

A continuación podéis ver qué servicios hay acutalmente disponibles en Cloudy para ser configurados fácilmente a través de la interfaz web.

''"Por hacer: explicación de cada uno de los servicios (puede verse en inglés en la página de Cloudy <ref>Cloudy contents: http://cloudy.community/features/</ref>"''

==== Clommunity ====
* Getinconf (gestión del cliente TincVPN)
* OpenVZ Web Panel (gestión de máquinas virtuales)
* Peer Streamer (streaming distribuido)
* Syncthing (sincronización de archivos en red)
* Tahofe-LAFS (sistema de ficheros distribuido)
* Webdav server

==== Guifi ====
* Proxy3 (proxy web)
[[File:cloudy-guifi-proxy.png|center]]

* SNPServices (monitorización/gráficas)
[[File:cloudy-guifi-snpservices.png|center]]

* DNSServices (DNS)
[[File:cloudy-guifi-dnsservices.png|center]]

== Referencias ==

<references/>

== Enllaces externos ==

* http://cloudy.community
* http://wiki.clommunity-project.eu/soft:cloudservices
* http://clommunity-project.eu
* http://guifi.net

[[Categoría:Cloudy]]

Cloudy

2015-01-26T17:05:20Z

Conxuro: Página redirigida a Categoria:Cloudy

#REDIRECT [[Categoria:Cloudy]]

Qué es Cloudy

2015-01-26T17:02:58Z

Conxuro: Página creada con «100px 100px Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> e...»

[[File:clommunity-logo.png|right|100px]]
[[File:Logo_guifi.svg|right|100px]]

Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> es una distribución basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desarrollada en el marco del proyecto europeo CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref>

Esta distribución, inspirada en la idea de la antigua [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el despliegue y la gestión de los servicios de red en la nube ''(cloud services)''<ref name="cloud-services">Cloud computing: http://es.wikipedia.org/wiki/Computaci%C3%B3n_en_la_nube</ref>, así como la compartición de estos. Pensada en particular para los usuarios de redes comunitarias.<ref name="CN">Redes comunitarias: http://es.wikipedia.org/wiki/Comunidad_inal%C3%A1mbrica</ref>

----

== Introducción ==

Antes de la adopción general de servicios en la nube ''(cloud services)''<ref name="cloud-services"/> los usuarios de redes comunitarias <ref name="CN"/> ya compartían o proveían servicios y recursos a la comunidad; sin embargo, estos usuarios eran una minoria. Una de las principales razones es la barrera tecnológica. Antes de proveer contenidos, los usuarios que quieren compartir información con la comunidad tienen primero que preocuparse de los aspectos técnicos como el despliegue/montaje de un servidor con un conjunto de servicios.

En el pasado, los usuarios de Guifi.net, intentaron superar este problema publicando una distribución GNU/Linux llamada [[Guinux]] <ref name="guinux"/>, que daba a los usuarios finales una solución fácil para ofrecer servicios a la comunidad (tales como [[Servidor_Proxy|proxy web]], [[Servidor_DNS|servidor DNS]], [[SNPservices|monitorización y gráficas]]).

La clave principal de [[Guinux]] era un conjunto de ''scripts''<ref>http://es.wikipedia.org/wiki/Script</ref> que automatitzaban el proceso de configuración. Los usuarios solo tenían que introducir unos pocos parámetros como la dirección de correo electrónico y el identificador del nodo. Enseguida, después de estar disponible la distribución, el número de usuarios compartiendo recursos aumentó considerablemente.

De acuerdo con esto, quedó claro que reduciendo (o eliminando) la barrera d'entrada tecnológica animó a los usuarios a proveer de más servicios y a compartir sus recursos con la comunidad. Para ello, uno de los objetivos principales del proyecto CLOMMUNITY <ref name="clommunity"/> es publicar una distribución GNU/Linux, llamada Cloudy, dirigida a los usuarios, para fomentar la transición y adopción del entorno Cloud en redes comunitarias ''(Community Network Cloud)''.

=== Motivación ===

La distribución Cloudy ha sido pensada para satisfacer los siguientes requisitos:

# '''Distribución''': para potenciar la distribución de servicios en las redes comunitarias (CN; community networks) es necesaria una plataforma para publicar y descubrir estos servicios. De este modo, el acceso a los servicios no depende de despliegues estáticos de redes y la estructura es consciente de las condiciones dinámicamente cambiantes de las CN. El software elegido para la publicación y descubrimiento de servicios es Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.
# '''Descentralitzación''': una capa de red común es necesaria para permitir a todos los nodos de la nube comunicarse entre ellos directamente. Una buena manera de construir esto es creando una "capa 2 de red virtual" basada en un servicio VPN<ref>Red Privada Virtual: http://es.wikipedia.org/wiki/Red_privada_virtual</ref>. Entre las opciones disponibles, se ha elegido Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ya que cumple todos los requisitos y es sencillo de configurar y administrar. Para coordinar los dispositivos con Tinc VPN, se ha desarrollado una herramienta para automatizar el despliegue del sistema. Este software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, se encarga del proceso de configuración de Tinc VPN y del intercambio de claves con el resto de nodos de la nube.
# '''Facilidad de uso y experiencia de usuario''': para este objetivo, se ha desarrollado una plataforma web de administración destinada a integrar la instalación y configuración de los servicios en la nube habilitados en la distribución Cloudy. Una interfaz web simple y agradable <ref>Interfaz web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> está disponible para los usuarios como solución fácil de configuración, administración y monitorización de los servicios ''cloud'' activos en el nodo.
# '''Software libre''': la distribución está basada en Debian GNU/Linux<ref name="debian"/>. A parte de ser una de les distribuciones más populars y cumplir con los requisitos técnicos, ha sido elegida ya que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda y garantiza que el software será siempre abierto y libre.

== Requisitos mínimos ==

Al ser una sistema basado en Debian, tiene los mismos requisitos de hardware.<ref>Requisitos mínimos: https://www.debian.org/releases/stable/i386/ch03s04.html.es</ref>

La imagen del sistema Cloudy trae una serie de configuraciones y paquetes adicionales; por lo que hace que sean necesarios alrededor de '''450 MiB de espacio de almacenamiento'''.

De todos modos, es '''recomendable''' contar con '''al menos 1 GiB'''.

Si se quiere utilizar algunos servicios como PeerStreamer (leer más abajo) los requisitos mínimos aumentarán, tanto de espacio como de memoria y procesamiento.

== Conseguir Cloudy ==

Actualmente puedes obtener la distribución Cloudy mediante la descarga de una imagen ISO para grabar en un CD o memoria USB, o de un ''template'' para ejecutar directamente en una máquina virtual (contenedor LXC<ref>Linux containers (LXC): https://linuxcontainers.org/</ref> o OpenVZ<ref>http://openvz.org</ref>).

Alternativamente puedes bajar el codigo y compilarlo tú mismo.

=== Descarga la imagen ===

Ves a la página de Cloudy donde están las imagenes almacenadas:

http://repo.clommunity-project.eu/images/

Actualmente aun está en desarrollo y por tanto '''sólo está disponible la rama ''unstable'''''.

Ahí encontrarás:

* cloudy.README - Relación de paquetes adicionales incluidos en la imagen del sistema.
* cloudy.container.tar.gz - ''Template'' para crear una VM.
* cloudy.iso - Imatge ISO

==== Grabar la imagen ISO (Linux) ====

Los archivos ISO son ''live install CD images'', es decir, tienen un sistema de instalación que se ejecuta justo al iniciar la máquina desde el dispositivo (CD/DVD/USB).

Puedes grabarlo en:

* En un CD o DVD:

$ apt-get install xorriso
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso

* En una memoria USB:

$ dd if=cloudy.iso of=${USBSTICK}

=== Compilar ===

Para construir o compilar Cloudy se necesitan algunos programas en la máquina para poder descargar el código fuente, generar los binarios, manipular las imágenes ISO, etc.

1. Descargar los paquetes necesarios (ejemple con la herramienta ''apt'' de los sistemas basados en Debian):
sudo apt-get install build-essential live-build imagemagick curl debootstrap git unzip

2. Descargar el "constructor" ''LBmake'' (Live-Build Make) para crear la imagen:
git clone https://github.com/Clommunity/lbmake

3. Compilar y generar la imagen ISO (y el Linux Container):

* Ir al directorio donde se ha bajado el código de ''LBmake'' y compilar utilizando la herramienta de Linux ''make'':
cd lbmake
sudo make

4. Una vez generada la imagen puedes probarla virtualizando el sistema con QEMU.<ref>QEMU processor emulator: http://wiki.qemu.org/Main_Page</ref>

* Generar una imagen de disco y utilizar la imagen ISO como Live CD para la instalación:
qemu-img create -f qcow2 disk.qcow2 4G
qemu-system-i386 -enable-kvm -cdrom devel/binary.hybrid.iso -hda disk.qcow2

''NOTA: si tienes una máquina relativamente reciente, añadiendo la opción '-enable-kvm' se aprovecha la virtualitzación por hardware, con lo que aumentará la rápidez/fluidez.''

==== Linux container ====

Opcionalmente, a parte de la imagen ISO se puede crear un ''Linux Container'' con el siguiente comando:
sudo make container

''NOTA: antes de generar el contenedor (linux container) primero se tiene que haber creado la imagen ISO. En caso de que no fuera así, el comando anterior generará primero la ISO y después el contenedor.''

== Instalación ==

Como se explica en la introducción, la distribución Cloudy está basada en Debian GNU/Linux y contenida en una imagen ISO ''live''.

Puedes probar a arrancar el sistema desde el dispositivo externo (CD/DVD/USB), o bien iniciar el proceso de instalación, seleccionando la opción corresponendiente en el menú.

[[File:cloudy-boot-install.png|center]]

La instalación es igual que con un Debian estándar <ref>Debian installation procedure: http://www.debian.org/releases/stable/i386/</ref>, y los pasos se pueden resumir en:

# Escoger la opción ''Install'' en el menú de inicio. (min 0:06)
# Seleccionar el idioma por defecto de la instalación y del sistema. (min 0:12)
# Seleccionar tu ubicación. (min 0:16)
# Seleccionar el mapa de teclado. (min 0:19)
# Cambiar/asignar el nombre del sistema. (min 1:21)
# Añadir la contraseña de ''root''. (min 1:37)
# Crear una nueva cuenta de usuario con contraseña. (min 1:45)
# Particionar el disco. En el ejemplo se ha utilizado todo el disco con una sola partición. (min 2:02)
# Configurar el gestor de paquetes, añadiendo una réplica del repositorio de Debian más próximo. (min 3:10)
# Instalar el cargador (''boot loader'') GRUB en el registro maestro de arranque del disco (''master boot record''). (min 4:34)
# Finalizar la instalación para reiniciar la máquina e iniciar el nuevo sistema. (min 4:43)

''NOTA: las referencias en paréntesis corresponden al momento aproximado en el ejemplo en video <ref>Cloudy installation: http://videos.guifi.net/guifimedia/2014-05%20Cloudy,%20the%20community%20distro/cloudy-installation.mp4</ref> del proceso de instalación.''

== Cómo actualizar ==

El sistema de actualización permite comprobar y actualizar los paquetes propios de Cloudy para no tener que reinstalar el sistema ni perder los datos.

En la versión actual, en el menú '''''System > Update''''', se puede comprobar si hay una versión nueva de los paquetes de Cloudy y actualizarlos uno a uno. También está la opción para hacer un ''upgrade'' general del sistema (paquetes de Debian).

[[File:cloudy-update.png|center|1024px]]

== Primeros pasos ==

Para acceder al sistema de configuración se hace mediante un navegador web entrando en la '''dirección''' de la máquina servidor en el '''puerto 7000'''.
http://DIRECCIÓN_IP:7000

Credenciales:
* '''Usuario:''' root
* '''Contraseña:''' root ''(por defecto en el container, y seleccionada durante la instalación con la imagen ISO)''

[[File:cloudy-home.png|center|1024px]]

Una vez dentro podemos ver la página inicial con información general del sistema y un menú superior con diferentes secciones, dividido en dos partes.

1. A la '''izquierda''' tenemos las opciones de configuración y monitorización del '''sistema'''.

* '''Cloudy:''' página de inicio.
* '''System:''' actualizaciones, configuración de usuario, desconexión.
* '''Languages:''' selecció de l'idioma.

2. A la '''derecha''' tenemos las opciones de configuración y gestión de los '''servicios'''.
* '''Search:''' herramientas para anunciar y buscar servicios en la red. Permite utilizar diferentes programas para ello.
* '''Clommunity:''' servicios introducidos en el proyecto CLOMMUNITY.
* '''Guifi.net:''' servicios habitualmente utilizados en la red de Guifi.net.

=== Servicios ===

A continuación podéis ver qué servicios hay acutalmente disponibles en Cloudy para ser configurados fácilmente a través de la interfaz web.

''"Por hacer: explicación de cada uno de los servicios (puede verse en inglés en la página de Cloudy <ref>Cloudy contents: http://cloudy.community/features/</ref>"''

==== Clommunity ====
* Getinconf (gestión del cliente TincVPN)
* OpenVZ Web Panel (gestión de máquinas virtuales)
* Peer Streamer (streaming distribuido)
* Syncthing (sincronización de archivos en red)
* Tahofe-LAFS (sistema de ficheros distribuido)
* Webdav server

==== Guifi ====
* Proxy3 (proxy web)
[[File:cloudy-guifi-proxy.png|center]]

* SNPServices (monitorización/gráficas)
[[File:cloudy-guifi-snpservices.png|center]]

* DNSServices (DNS)
[[File:cloudy-guifi-dnsservices.png|center]]

== Referencias ==

<references/>

== Enllaces externos ==

* http://cloudy.community
* http://wiki.clommunity-project.eu/soft:cloudservices
* http://clommunity-project.eu
* http://guifi.net

[[Categoria:Cloudy]]

Portada

2014-06-25T14:12:33Z

Conxuro: /* Mesh */

__NOTITLE__
{| style="background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em;"
| valign="top" style="padding:12px 17px 5px 17px" |
'''Guifi.net''' es de todos, participa [[conectar|conectando]] tu [[tramo de la red]] con la de los demás.

Es un proyecto colaborativo [[organización horizontal|organizado horizontalmente]] que agrupa tanto a personas individuales como a colectivos, empresas y administraciones.

Es abierto, por lo que todo el mundo puede participar en igualdad de condiciones, en el marco de [http://guifi.net/es/ProcomunXOLN Procomún de la Red Abierta, Libre y Neutral]
<div style=" text-align: right">[[Guifi.net|Más sobre Guifi.net]]</div>
{| style="width:100%; background:#f6f6f6"
| style="background:#f6f6f6; text-align: right; width 30%" |<div style="width: 400px; margin: 0 auto; background-color: #fcfcfc; border: 1px solid #ccc; border-bottom: 5px groove #999999; border-right:5px groove #999999; text-align: center; padding: 0.4em;">
<div style="font-size: 162%; padding: 0.1em;">Bienvenid@ al wiki de '''Guifi.net'''</div>
<div style="font-size: 95%;">Documentación sobre la red abierta, libre y neutral.</div>
<div style="font-size: 85%;">En estos momentos tenemos [[Especial:Estadísticas|{{NUMBEROFARTICLES}}]] [[Especial:Todas|artículos]] en español.
[[Especial:PáginasRequeridas|Escribir una página requerida]]</div></div>
|}
{| style="background:#f6f6f6; width:100%;"
|''La documentación de guifi.net contiene los documentos de referencia para usuarios nuevos, experimentados y desarrolladores. Sé libre [[Qué es un wiki|de editar esta wiki]] para mejorar su contenido.''
|}
<div style=" text-align: center">Contacta: [http://guifi.net/es/forum/231 Foros] '''|''' [http://lists.guifi.net Listas de correo] '''|''' [http://irc.guifi.net/?channels=guifi Chat]</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; background:#FFFFE0; border:1px solid #EECFA1; padding:10px; margin-bottom:7px; vertical-align:top; -moz-border-radius:1em; -webkit-border-radius:1em; border-radius:1em;" |

<div id="mp-tfa">
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Cómo conectarse a Guifi.net
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;">

* [[tres pasos|Cómo dar de alta y enlazar un nodo]]
* [[Elige el material]]
* [[Configura tu ordenador]]
* [[Buenas Prácticas|Código de buenas prácticas]]

|}</div>

| style="border:1px solid transparent;" |
| style="width:50%;background:#f5fffa;border:1px solid #99CC33;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-itn">
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodos e islas
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;">
* [[Empezar una isla desde 0|Comenzar una isla desde cero]]
* [[Crear un supernodo]]
* [[Buenas Prácticas|Código de buenas prácticas]]</div></div>
|}</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; style="background:#f5faff;border:1px solid #cedff2;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-dyk">

<div style="float:right;">__TOC__</div>
== [[Legal]] ==
* [[Ayuntamientos]] / [[Anexo:Guifi.net en Ayuntamientos]]
* [[Associación|Constitución de una asociación]]
* [[Legislaciones|Legislaciones Países]]
* [[FAQ_Legal|FAQ]]
* [[Comunicación_comunidad|Cómo realizar la comunicación de instalación de nodo guifi.net a la Comunidad de Vecinos]]

== Red ==
=== Los básicos en la web ===
* [[Zona|Crear y modificar una zona]]
* [[Añadir_un_nodo_de_guifi.net|Añadir un nodo de guifi.net]]
* [[Servicios|Crear servicios y vincularlos en los servidores]]
* [[Herramientas|Herramientas (localización de IPs y MACs, estadísticas, mapas de enrutamiento, etc.)]]

=== Infraestructura ===
* [[Crear_un_supernodo|Montaje de supernodos]]
* [[Filtros de red]]
* [[Enlaces virtuales]]
* [[Herramienta para buscar rangos de IPs libres]]
* [[Nanostations: Modificando configuración por consola]]
* [[Configuración de antena TP-LINK TL-WA7510N]]

=== Mesh ===
* [[Abrir_redes_tipo_mesh_a_trav%C3%A9s_de_Guifi.net#Crear_una_nube_Mesh|Crear una nube Mesh en Guifi.net]]
* [[Abrir_redes_tipo_mesh_a_trav%C3%A9s_de_Guifi.net#Conectarse_a_una_red_Mesh|Conectarse a una nube Mesh de Guifi.net]]
* [[:ca:Annex:subxarxes_mesh|Listado de redes Mesh (catalán)]]
* [[Quick_Mesh_Project|Quick Mesh Project (qMp)]]
* [[Alix+GSF|ALIX + Conectarse a la nube de gracia con mesh]]
* [[Mesh|Otros artículos sobre Mesh]]

=== Enrutamientos y conceptos de redes ===
{{div col|cols=2}}
* [[Enrutamientos]]
* [[Peerings]]
* [[IPv4]]
* [[IPv6]]
* [[Criterios de asignación de direcciones IPv4]]
* [[ARP]]
* [[Cables_UTP|Cables UTP]]
{{div end}}

=== General ===
{{div col|cols=2}}
* [[Cómo se vertebra la red: Troncal, puntos de acceso y conexiones simples]]
* [[La seguridad en la red abierta]]
* [[Aplicaciones | Aplicaciones de guifi.net]]
* [[Recursos externos]]
* [[Instalar firmware Ubiquiti Rocket M5]]
{{div end}}

== Sistemas ==
* [[Distribución guinux]]
* [[Servidor compacto con una routerstation]]
* [[Comtrend_hg536%2B]] Reciclar router de Jazztel o telefónica como router neutro con OpenWRT

=== Servicios básicos ===
{{div col|cols=2}}
* [[Configurar Repositorio APT guifi]]
* [[Servidor Proxy]]
* [[Squid autentificándose contra squid]]
* [[Servidor de gráficas]]
* [[SNPservices]]
* [[Servidor DNS]]
* [[Servidor Reloj|Servidor de Reloj (NTP)]]
* [[Configurar red]]
{{div end}}

=== Servicios de compartición de ficheros ===
{{div col|cols=2}}
* [[Servidor FTP]]
* [[Servidor Peer 2 Peer]]
* [[Servidor DCC]]
{{div end}}

=== Servicios de mensajería ===
{{div col|cols=2}}
* [[Servidor de Correo]]
* [[Webmail]]
* [[Servidor Jabber]]
* [[Servidor IRC]]
* [[Mailman]]
{{div end}}

=== Servicios de Voz y Vídeo ===
{{div col|cols=2}}
* [[VoIP|Servidor de VeuIP (VoIP)]]
* [[Servidor Radio Streaming]]
{{div end}}

=== Otros Servicios ===
{{div col|cols=2}}
* [[LDAP|Servidor LDAP]]
* [[Apache|Servidor web Apache]]
* [[Servidor Repositorio Linux]]
* [[Servidor Repositorio Linux (Cache)]]
* [[Servidor Iperf]]
* [[Servidor repositorio subversion]]
* [[DHCP|Servidor DHCP]]
* [[MySQL]] (Bases de Datos)
* [[Proxmox]] (virtualitzación)
* [[Cacti]] (monitorización)
* [[Clamav]] (antivirus con GNU/Linux)
* [[Trac]] (sistema de gestión de tiquets)
* [[Monitor]] (Monitorización de la red distribuida)
{{div end}}

=== Sistema ===
{{div col|cols=2}}
* [[ACPI]]
* [[Bridges_con_Linux|Bridges con GNU/Linux]]
* [[Chroot]]
* [[Corkscrew]]
{{div end}}

== Estandares de transmisión de datos y organizaciones colaboradoras ==
{{div col|cols=2}}
* [http://es.wikipedia.org/wiki/IEEE_802.11 IEEE 802.11]
* [http://es.wikipedia.org/wiki/Multimedia_over_Coax_Alliance Multimedia over Coax Alliance]
* [http://en.wikipedia.org/wiki/HomePNA HomePNA]
* [[Aprovechar el cable de antena de televisión]]
{{div end}}

== [[Instaladores]] ==
{{div col|cols=2}}
* [[Pararrayos]]
* [[Aprovechar el cable de antena de televisión]]
* [[Presupuestos]]
* [http://guifi.net/ca/node/12486 Comunidad de vecinos, caso de ejemplo]
* [[Reinicio remoto de nodos]]
* [[Campanarios]]
{{div end}}

== Desarrolladores ==
{{div col|cols=2}}
* [[Preparando el entorno de desarrollo]]
* [[Manual editor wiki]]
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]
* [[Actualizaciones módulos drupal]]
* [[Mapas de nodos en la web]]
* [http://gitorious.org/guifi Repositorios del código del proyecto guifi.net]
* [[Mapa del código]]
* [[API de Guifi]]
* [[CNML]]
* [[Empotrar_mapa_de_guifi|Empotrar el mapa de Guifi-Google Maps en una web]]
* [[Unsóloclic]]
* [[:Categoría:router|Routers]]
* [[:Categoría:Telefonía móvil|Telefonía móvil sobre guifi.net]]
* [[Guifi.net Studio]]
{{div end}}

== Diseñadores ==
{{div col|cols=2}}
* [[Logos]]
* [[Maquetación de las distintas páginas web]]
* [[Usabilidad]]
* [[Presentaciones de guifi.net]]
{{div end}}

== Desarrollo colectivo de la red ==
{{div col|cols=2}}
* [[Cursos]]
* [[Necesidades]]
{{div end}}

== Glosario ==
{{Acontecimientos}}

* [[Términos usados habitualmente]]
* [[Guia Rápida de Guifi.net]]
* [[Preguntas Frecuentes]]
* [http://guifi.net/es/ESDocs Documentos basados en la web de guifi.net] antigua "ComEsFa"

{{clear}}
|}

= Accesos Rápidos =
* [http://planet.guifi.net Planet]
* [http://guifi.net/es/ProcomunXOLN Procomún XOLN (Licencia de la red)]
* [http://guifi.net/es/maps Mapa guifi]
* [http://guifi.net/es/grups Webs Regionales]
* [http://trac.guifi.net Reporta Errores de la web]
* [http://fundacio.guifi.net Fundación]
* [http://lists.guifi.net Listas de Correo]

[[ca:Portada]]
[[en:Main Page]]
[[eu:Azala]]
[[fr:Accueil]]
[[gl:Portada]]
[[pt:Página principal]]

Portada

2014-06-25T14:06:12Z

Conxuro: /* Mesh */

__NOTITLE__
{| style="background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em;"
| valign="top" style="padding:12px 17px 5px 17px" |
'''Guifi.net''' es de todos, participa [[conectar|conectando]] tu [[tramo de la red]] con la de los demás.

Es un proyecto colaborativo [[organización horizontal|organizado horizontalmente]] que agrupa tanto a personas individuales como a colectivos, empresas y administraciones.

Es abierto, por lo que todo el mundo puede participar en igualdad de condiciones, en el marco de [http://guifi.net/es/ProcomunXOLN Procomún de la Red Abierta, Libre y Neutral]
<div style=" text-align: right">[[Guifi.net|Más sobre Guifi.net]]</div>
{| style="width:100%; background:#f6f6f6"
| style="background:#f6f6f6; text-align: right; width 30%" |<div style="width: 400px; margin: 0 auto; background-color: #fcfcfc; border: 1px solid #ccc; border-bottom: 5px groove #999999; border-right:5px groove #999999; text-align: center; padding: 0.4em;">
<div style="font-size: 162%; padding: 0.1em;">Bienvenid@ al wiki de '''Guifi.net'''</div>
<div style="font-size: 95%;">Documentación sobre la red abierta, libre y neutral.</div>
<div style="font-size: 85%;">En estos momentos tenemos [[Especial:Estadísticas|{{NUMBEROFARTICLES}}]] [[Especial:Todas|artículos]] en español.
[[Especial:PáginasRequeridas|Escribir una página requerida]]</div></div>
|}
{| style="background:#f6f6f6; width:100%;"
|''La documentación de guifi.net contiene los documentos de referencia para usuarios nuevos, experimentados y desarrolladores. Sé libre [[Qué es un wiki|de editar esta wiki]] para mejorar su contenido.''
|}
<div style=" text-align: center">Contacta: [http://guifi.net/es/forum/231 Foros] '''|''' [http://lists.guifi.net Listas de correo] '''|''' [http://irc.guifi.net/?channels=guifi Chat]</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; background:#FFFFE0; border:1px solid #EECFA1; padding:10px; margin-bottom:7px; vertical-align:top; -moz-border-radius:1em; -webkit-border-radius:1em; border-radius:1em;" |

<div id="mp-tfa">
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Cómo conectarse a Guifi.net
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;">

* [[tres pasos|Cómo dar de alta y enlazar un nodo]]
* [[Elige el material]]
* [[Configura tu ordenador]]
* [[Buenas Prácticas|Código de buenas prácticas]]

|}</div>

| style="border:1px solid transparent;" |
| style="width:50%;background:#f5fffa;border:1px solid #99CC33;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-itn">
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodos e islas
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;">
* [[Empezar una isla desde 0|Comenzar una isla desde cero]]
* [[Crear un supernodo]]
* [[Buenas Prácticas|Código de buenas prácticas]]</div></div>
|}</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; style="background:#f5faff;border:1px solid #cedff2;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-dyk">

<div style="float:right;">__TOC__</div>
== [[Legal]] ==
* [[Ayuntamientos]] / [[Anexo:Guifi.net en Ayuntamientos]]
* [[Associación|Constitución de una asociación]]
* [[Legislaciones|Legislaciones Países]]
* [[FAQ_Legal|FAQ]]
* [[Comunicación_comunidad|Cómo realizar la comunicación de instalación de nodo guifi.net a la Comunidad de Vecinos]]

== Red ==
=== Los básicos en la web ===
* [[Zona|Crear y modificar una zona]]
* [[Añadir_un_nodo_de_guifi.net|Añadir un nodo de guifi.net]]
* [[Servicios|Crear servicios y vincularlos en los servidores]]
* [[Herramientas|Herramientas (localización de IPs y MACs, estadísticas, mapas de enrutamiento, etc.)]]

=== Infraestructura ===
* [[Crear_un_supernodo|Montaje de supernodos]]
* [[Filtros de red]]
* [[Enlaces virtuales]]
* [[Herramienta para buscar rangos de IPs libres]]
* [[Nanostations: Modificando configuración por consola]]
* [[Configuración de antena TP-LINK TL-WA7510N]]

=== Mesh ===
* [[Abrir_redes_tipo_mesh_a_trav%C3%A9s_de_Guifi.net#Crear_una_nube_Mesh|Crear una nube Mesh en Guifi.net]]
* [[Abrir_redes_tipo_mesh_a_trav%C3%A9s_de_Guifi.net#Conectarse_a_una_red_Mesh|Conectarse a una nube Mesh de Guifi.net]]
* [[Quick_Mesh_Project|Quick Mesh Project (qMp)]]
* [[Alix+GSF|ALIX + Conectarse a la nube de gracia con mesh]]
* [[Mesh|Otros artículos sobre Mesh]]

=== Enrutamientos y conceptos de redes ===
{{div col|cols=2}}
* [[Enrutamientos]]
* [[Peerings]]
* [[IPv4]]
* [[IPv6]]
* [[Criterios de asignación de direcciones IPv4]]
* [[ARP]]
* [[Cables_UTP|Cables UTP]]
{{div end}}

=== General ===
{{div col|cols=2}}
* [[Cómo se vertebra la red: Troncal, puntos de acceso y conexiones simples]]
* [[La seguridad en la red abierta]]
* [[Aplicaciones | Aplicaciones de guifi.net]]
* [[Recursos externos]]
* [[Instalar firmware Ubiquiti Rocket M5]]
{{div end}}

== Sistemas ==
* [[Distribución guinux]]
* [[Servidor compacto con una routerstation]]
* [[Comtrend_hg536%2B]] Reciclar router de Jazztel o telefónica como router neutro con OpenWRT

=== Servicios básicos ===
{{div col|cols=2}}
* [[Configurar Repositorio APT guifi]]
* [[Servidor Proxy]]
* [[Squid autentificándose contra squid]]
* [[Servidor de gráficas]]
* [[SNPservices]]
* [[Servidor DNS]]
* [[Servidor Reloj|Servidor de Reloj (NTP)]]
* [[Configurar red]]
{{div end}}

=== Servicios de compartición de ficheros ===
{{div col|cols=2}}
* [[Servidor FTP]]
* [[Servidor Peer 2 Peer]]
* [[Servidor DCC]]
{{div end}}

=== Servicios de mensajería ===
{{div col|cols=2}}
* [[Servidor de Correo]]
* [[Webmail]]
* [[Servidor Jabber]]
* [[Servidor IRC]]
* [[Mailman]]
{{div end}}

=== Servicios de Voz y Vídeo ===
{{div col|cols=2}}
* [[VoIP|Servidor de VeuIP (VoIP)]]
* [[Servidor Radio Streaming]]
{{div end}}

=== Otros Servicios ===
{{div col|cols=2}}
* [[LDAP|Servidor LDAP]]
* [[Apache|Servidor web Apache]]
* [[Servidor Repositorio Linux]]
* [[Servidor Repositorio Linux (Cache)]]
* [[Servidor Iperf]]
* [[Servidor repositorio subversion]]
* [[DHCP|Servidor DHCP]]
* [[MySQL]] (Bases de Datos)
* [[Proxmox]] (virtualitzación)
* [[Cacti]] (monitorización)
* [[Clamav]] (antivirus con GNU/Linux)
* [[Trac]] (sistema de gestión de tiquets)
* [[Monitor]] (Monitorización de la red distribuida)
{{div end}}

=== Sistema ===
{{div col|cols=2}}
* [[ACPI]]
* [[Bridges_con_Linux|Bridges con GNU/Linux]]
* [[Chroot]]
* [[Corkscrew]]
{{div end}}

== Estandares de transmisión de datos y organizaciones colaboradoras ==
{{div col|cols=2}}
* [http://es.wikipedia.org/wiki/IEEE_802.11 IEEE 802.11]
* [http://es.wikipedia.org/wiki/Multimedia_over_Coax_Alliance Multimedia over Coax Alliance]
* [http://en.wikipedia.org/wiki/HomePNA HomePNA]
* [[Aprovechar el cable de antena de televisión]]
{{div end}}

== [[Instaladores]] ==
{{div col|cols=2}}
* [[Pararrayos]]
* [[Aprovechar el cable de antena de televisión]]
* [[Presupuestos]]
* [http://guifi.net/ca/node/12486 Comunidad de vecinos, caso de ejemplo]
* [[Reinicio remoto de nodos]]
* [[Campanarios]]
{{div end}}

== Desarrolladores ==
{{div col|cols=2}}
* [[Preparando el entorno de desarrollo]]
* [[Manual editor wiki]]
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]
* [[Actualizaciones módulos drupal]]
* [[Mapas de nodos en la web]]
* [http://gitorious.org/guifi Repositorios del código del proyecto guifi.net]
* [[Mapa del código]]
* [[API de Guifi]]
* [[CNML]]
* [[Empotrar_mapa_de_guifi|Empotrar el mapa de Guifi-Google Maps en una web]]
* [[Unsóloclic]]
* [[:Categoría:router|Routers]]
* [[:Categoría:Telefonía móvil|Telefonía móvil sobre guifi.net]]
* [[Guifi.net Studio]]
{{div end}}

== Diseñadores ==
{{div col|cols=2}}
* [[Logos]]
* [[Maquetación de las distintas páginas web]]
* [[Usabilidad]]
* [[Presentaciones de guifi.net]]
{{div end}}

== Desarrollo colectivo de la red ==
{{div col|cols=2}}
* [[Cursos]]
* [[Necesidades]]
{{div end}}

== Glosario ==
{{Acontecimientos}}

* [[Términos usados habitualmente]]
* [[Guia Rápida de Guifi.net]]
* [[Preguntas Frecuentes]]
* [http://guifi.net/es/ESDocs Documentos basados en la web de guifi.net] antigua "ComEsFa"

{{clear}}
|}

= Accesos Rápidos =
* [http://planet.guifi.net Planet]
* [http://guifi.net/es/ProcomunXOLN Procomún XOLN (Licencia de la red)]
* [http://guifi.net/es/maps Mapa guifi]
* [http://guifi.net/es/grups Webs Regionales]
* [http://trac.guifi.net Reporta Errores de la web]
* [http://fundacio.guifi.net Fundación]
* [http://lists.guifi.net Listas de Correo]

[[ca:Portada]]
[[en:Main Page]]
[[eu:Azala]]
[[fr:Accueil]]
[[gl:Portada]]
[[pt:Página principal]]

Portada

2014-06-25T14:02:49Z

Conxuro: /* Mesh */

__NOTITLE__
{| style="background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em;"
| valign="top" style="padding:12px 17px 5px 17px" |
'''Guifi.net''' es de todos, participa [[conectar|conectando]] tu [[tramo de la red]] con la de los demás.

Es un proyecto colaborativo [[organización horizontal|organizado horizontalmente]] que agrupa tanto a personas individuales como a colectivos, empresas y administraciones.

Es abierto, por lo que todo el mundo puede participar en igualdad de condiciones, en el marco de [http://guifi.net/es/ProcomunXOLN Procomún de la Red Abierta, Libre y Neutral]
<div style=" text-align: right">[[Guifi.net|Más sobre Guifi.net]]</div>
{| style="width:100%; background:#f6f6f6"
| style="background:#f6f6f6; text-align: right; width 30%" |<div style="width: 400px; margin: 0 auto; background-color: #fcfcfc; border: 1px solid #ccc; border-bottom: 5px groove #999999; border-right:5px groove #999999; text-align: center; padding: 0.4em;">
<div style="font-size: 162%; padding: 0.1em;">Bienvenid@ al wiki de '''Guifi.net'''</div>
<div style="font-size: 95%;">Documentación sobre la red abierta, libre y neutral.</div>
<div style="font-size: 85%;">En estos momentos tenemos [[Especial:Estadísticas|{{NUMBEROFARTICLES}}]] [[Especial:Todas|artículos]] en español.
[[Especial:PáginasRequeridas|Escribir una página requerida]]</div></div>
|}
{| style="background:#f6f6f6; width:100%;"
|''La documentación de guifi.net contiene los documentos de referencia para usuarios nuevos, experimentados y desarrolladores. Sé libre [[Qué es un wiki|de editar esta wiki]] para mejorar su contenido.''
|}
<div style=" text-align: center">Contacta: [http://guifi.net/es/forum/231 Foros] '''|''' [http://lists.guifi.net Listas de correo] '''|''' [http://irc.guifi.net/?channels=guifi Chat]</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; background:#FFFFE0; border:1px solid #EECFA1; padding:10px; margin-bottom:7px; vertical-align:top; -moz-border-radius:1em; -webkit-border-radius:1em; border-radius:1em;" |

<div id="mp-tfa">
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Cómo conectarse a Guifi.net
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;">

* [[tres pasos|Cómo dar de alta y enlazar un nodo]]
* [[Elige el material]]
* [[Configura tu ordenador]]
* [[Buenas Prácticas|Código de buenas prácticas]]

|}</div>

| style="border:1px solid transparent;" |
| style="width:50%;background:#f5fffa;border:1px solid #99CC33;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-itn">
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodos e islas
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;">
* [[Empezar una isla desde 0|Comenzar una isla desde cero]]
* [[Crear un supernodo]]
* [[Buenas Prácticas|Código de buenas prácticas]]</div></div>
|}</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; style="background:#f5faff;border:1px solid #cedff2;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-dyk">

<div style="float:right;">__TOC__</div>
== [[Legal]] ==
* [[Ayuntamientos]] / [[Anexo:Guifi.net en Ayuntamientos]]
* [[Associación|Constitución de una asociación]]
* [[Legislaciones|Legislaciones Países]]
* [[FAQ_Legal|FAQ]]
* [[Comunicación_comunidad|Cómo realizar la comunicación de instalación de nodo guifi.net a la Comunidad de Vecinos]]

== Red ==
=== Los básicos en la web ===
* [[Zona|Crear y modificar una zona]]
* [[Añadir_un_nodo_de_guifi.net|Añadir un nodo de guifi.net]]
* [[Servicios|Crear servicios y vincularlos en los servidores]]
* [[Herramientas|Herramientas (localización de IPs y MACs, estadísticas, mapas de enrutamiento, etc.)]]

=== Infraestructura ===
* [[Crear_un_supernodo|Montaje de supernodos]]
* [[Filtros de red]]
* [[Enlaces virtuales]]
* [[Herramienta para buscar rangos de IPs libres]]
* [[Nanostations: Modificando configuración por consola]]
* [[Configuración de antena TP-LINK TL-WA7510N]]

=== Mesh ===
* [[Abrir_redes_tipo_mesh_a_trav%C3%A9s_de_Guifi.net#Crear_una_nube_Mesh|Crear una nube Mesh en Guifi.net]]
* [[Abrir_redes_tipo_mesh_a_trav%C3%A9s_de_Guifi.net#Conectarse_a_una_red_Mesh|Conectarse a una nube Mesh de Guifi.net]]
* [[Alix+GSF|ALIX + Conectarse a la nube de gracia con mesh]]
* [[Mesh|Otros artículos sobre Mesh]]

=== Enrutamientos y conceptos de redes ===
{{div col|cols=2}}
* [[Enrutamientos]]
* [[Peerings]]
* [[IPv4]]
* [[IPv6]]
* [[Criterios de asignación de direcciones IPv4]]
* [[ARP]]
* [[Cables_UTP|Cables UTP]]
{{div end}}

=== General ===
{{div col|cols=2}}
* [[Cómo se vertebra la red: Troncal, puntos de acceso y conexiones simples]]
* [[La seguridad en la red abierta]]
* [[Aplicaciones | Aplicaciones de guifi.net]]
* [[Recursos externos]]
* [[Instalar firmware Ubiquiti Rocket M5]]
{{div end}}

== Sistemas ==
* [[Distribución guinux]]
* [[Servidor compacto con una routerstation]]
* [[Comtrend_hg536%2B]] Reciclar router de Jazztel o telefónica como router neutro con OpenWRT

=== Servicios básicos ===
{{div col|cols=2}}
* [[Configurar Repositorio APT guifi]]
* [[Servidor Proxy]]
* [[Squid autentificándose contra squid]]
* [[Servidor de gráficas]]
* [[SNPservices]]
* [[Servidor DNS]]
* [[Servidor Reloj|Servidor de Reloj (NTP)]]
* [[Configurar red]]
{{div end}}

=== Servicios de compartición de ficheros ===
{{div col|cols=2}}
* [[Servidor FTP]]
* [[Servidor Peer 2 Peer]]
* [[Servidor DCC]]
{{div end}}

=== Servicios de mensajería ===
{{div col|cols=2}}
* [[Servidor de Correo]]
* [[Webmail]]
* [[Servidor Jabber]]
* [[Servidor IRC]]
* [[Mailman]]
{{div end}}

=== Servicios de Voz y Vídeo ===
{{div col|cols=2}}
* [[VoIP|Servidor de VeuIP (VoIP)]]
* [[Servidor Radio Streaming]]
{{div end}}

=== Otros Servicios ===
{{div col|cols=2}}
* [[LDAP|Servidor LDAP]]
* [[Apache|Servidor web Apache]]
* [[Servidor Repositorio Linux]]
* [[Servidor Repositorio Linux (Cache)]]
* [[Servidor Iperf]]
* [[Servidor repositorio subversion]]
* [[DHCP|Servidor DHCP]]
* [[MySQL]] (Bases de Datos)
* [[Proxmox]] (virtualitzación)
* [[Cacti]] (monitorización)
* [[Clamav]] (antivirus con GNU/Linux)
* [[Trac]] (sistema de gestión de tiquets)
* [[Monitor]] (Monitorización de la red distribuida)
{{div end}}

=== Sistema ===
{{div col|cols=2}}
* [[ACPI]]
* [[Bridges_con_Linux|Bridges con GNU/Linux]]
* [[Chroot]]
* [[Corkscrew]]
{{div end}}

== Estandares de transmisión de datos y organizaciones colaboradoras ==
{{div col|cols=2}}
* [http://es.wikipedia.org/wiki/IEEE_802.11 IEEE 802.11]
* [http://es.wikipedia.org/wiki/Multimedia_over_Coax_Alliance Multimedia over Coax Alliance]
* [http://en.wikipedia.org/wiki/HomePNA HomePNA]
* [[Aprovechar el cable de antena de televisión]]
{{div end}}

== [[Instaladores]] ==
{{div col|cols=2}}
* [[Pararrayos]]
* [[Aprovechar el cable de antena de televisión]]
* [[Presupuestos]]
* [http://guifi.net/ca/node/12486 Comunidad de vecinos, caso de ejemplo]
* [[Reinicio remoto de nodos]]
* [[Campanarios]]
{{div end}}

== Desarrolladores ==
{{div col|cols=2}}
* [[Preparando el entorno de desarrollo]]
* [[Manual editor wiki]]
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]
* [[Actualizaciones módulos drupal]]
* [[Mapas de nodos en la web]]
* [http://gitorious.org/guifi Repositorios del código del proyecto guifi.net]
* [[Mapa del código]]
* [[API de Guifi]]
* [[CNML]]
* [[Empotrar_mapa_de_guifi|Empotrar el mapa de Guifi-Google Maps en una web]]
* [[Unsóloclic]]
* [[:Categoría:router|Routers]]
* [[:Categoría:Telefonía móvil|Telefonía móvil sobre guifi.net]]
* [[Guifi.net Studio]]
{{div end}}

== Diseñadores ==
{{div col|cols=2}}
* [[Logos]]
* [[Maquetación de las distintas páginas web]]
* [[Usabilidad]]
* [[Presentaciones de guifi.net]]
{{div end}}

== Desarrollo colectivo de la red ==
{{div col|cols=2}}
* [[Cursos]]
* [[Necesidades]]
{{div end}}

== Glosario ==
{{Acontecimientos}}

* [[Términos usados habitualmente]]
* [[Guia Rápida de Guifi.net]]
* [[Preguntas Frecuentes]]
* [http://guifi.net/es/ESDocs Documentos basados en la web de guifi.net] antigua "ComEsFa"

{{clear}}
|}

= Accesos Rápidos =
* [http://planet.guifi.net Planet]
* [http://guifi.net/es/ProcomunXOLN Procomún XOLN (Licencia de la red)]
* [http://guifi.net/es/maps Mapa guifi]
* [http://guifi.net/es/grups Webs Regionales]
* [http://trac.guifi.net Reporta Errores de la web]
* [http://fundacio.guifi.net Fundación]
* [http://lists.guifi.net Listas de Correo]

[[ca:Portada]]
[[en:Main Page]]
[[eu:Azala]]
[[fr:Accueil]]
[[gl:Portada]]
[[pt:Página principal]]

Abrir redes tipo mesh a través de Guifi.net

2013-10-04T18:36:40Z

Conxuro:

[[File:GSF-logo.png|right]]
[[File:Qmp_small.png|right|200px]]
Este manual explica cómo integrar con Guifi.net las redes mesh (también conocidas como [[MANET]] y entendidas como redes que funcionan con protocolos de enrutamiento dinámico cómo [[B.A.T.M.A.N.-adv]], [[BMX6]] u [[protocolos de enrutament dinámico|otros]]) de forma que se intercambian datos con el resto de la red libre a través de [[IPv4]].

El manual se basa en la manera de dar de alta los nodos mesh en la web de Guifi.net.

Originalmente, en [[Guifi.net]], para realizar este tipo de redes, se utilizaba un software/firmware desarrollado por la comunidad del barrio de Gràcia de Barcelona, [[GSF|Gràcia Sense Fils (GSF)]].

Actualmente, se utiliza habitualmente el software desarrollado en el proyecto [[Quick_Mesh_Project|Quick Mesh Project (qMp)]].

Desde junio de 2013 se han aplicado unos pequeños cambios para adaptar la web mejor a les redes Mesh, concretamente con [[Quick_Mesh_Project|qMp]].

Ahora, ya no hay tipos de zonas (ad-hoc, infraestructura) y lo que hay es un nuevo tipo de radio "Mesh".

Además, para poder realizar una mejor agregación IP en las zonas, se define un nuevo tipo de direcciones IP "Mesh", que es la que se asigna a los dispositivos con estas radios.

== Crear una nube Mesh ==

La finalidad de crear una nube Mesh es permitir agrupar los nodos que se conectarán a este tipo de redes, y reservar y asignar direcciones IP en la web sólo para estos nodos.

=== Crear una nueva zona ===

Se puede crear una nueva zona en la web siguiendo estos [[Zona|pasos para configurarla]], o bien utilizar una existente.

=== Agregar un rango IP ===

Lo más importante de todo, es agregar un nuevo direccionamiento IP de tipo Mesh en la zona, sea nueva o no, para que se puedan asignar IPs a los dispositivos que se conecten en Mesh.

[[File:MeshNetwork1.png|Afegir un rang nou]]

=== Limitaciones actuales ===

* La web '''no permite realizar búsquedas de rangos IPs de tipo Mesh'''.
** Se tiene que utilizar la herramienta de [http://guifi.net/es/guifi/menu/ip/ipsearch/10.1.%2525 búsqueda de direcciones IP] para ver los rangos disponibles.
** Se tiene que agregar manualmente la IP base de red y la máscara.
* La web '''no distingue si un rango IP está en uso''' si no se agrega exactamente la misma dirección y máscara.
:''P.ej. Si se agrega una red 10.1.4.0/24, lo permite, a pesar de que el rango 10.1.0.0/21 esté asignado previamente (sólo lo evitaría si intentamos agregar 10.1.0.0/21 de nuevo).''

== Conectarse a una red Mesh ==

Para conectarse a una de las redes Mesh con qMp existentes a Guifi.net, primero hay que seguir los [[Tres_pasos|"tres pasos para unirse a Guifi.net"]]; es decir:
# Registrarse en la web
# Crear un nodo
# Agregar un dispositivo

=== Agregar un dispositivo ===

* Primero es necesario seleccionar el modelo de dispositivo, concretamente uno de los [http://qmp.cat/projects/qmp/wiki/Devices soportados (en)] por qMp.
* A diferencia de otras redes de Guifi.net, para enlazar y conectar a una red Mesh, al crear un dispositivo nuevo tiene que agregarse '''una radio de tipo "Mesh"'''.

[[File:MeshRadio1.png|Añadir una radio para enlazar en Mesh]]

* Una vez agregada la radio se tienen que configurar los siguientes parámetros:
** '''MAC''': aquí hay que agregar el [http://es.wikipedia.org/wiki/BSSID BSSID] que se utilice en la zona Mesh donde se quiere conectar. Normalmente con qMp se utiliza ''''02:CA:FF:EE:BA:BE''''.
** '''SSID''': identificador Wifi de tu dispositivo. ''Recomendado poner algo como '''guifi.net-qMp-NOMBREDELNODO''' para ser reconocido facilmente al hacer un scan''.
** '''Protocolo''': normalmente se utilizan enlaces a 5GHz, ya sean '''802.11a''' o '''más habitualmente 802.11n''' en dispositivos nuevos.
** '''Canal''': el número de canal Wifi con el que enlazan las antenas en una zona Mesh. ''Hay que colocarlo bien, ya que cada zona utiliza uno (o varios) diferentes''.
* Se asignará automáticamente un rango de direcciones IP /27 que serán las que el router/antena tendrá disponibles para comunicarse y para asignar a los dispositivos finales (ordenadores, móbiles, etc.).

[[File:MeshRadio2.png|Parámetros de la radio para enlazar en Mesh]]

* Finalmente, se tendrá que instalar el software qMp en el dispositivo con los parámetros que se han configurado en la web (BSSID, SSID, Canal, IP, etc.).
** Podéis seguir los pasos de http://es.wiki.guifi.net/wiki/QMP para instalar y configurar qMp.

=== Nodos frontera ===

Un nodo frontera es un nodo que interconecta una red Mesh con el resto de Guifi.net.

Como mínimo son necesarios dos dispositivos, o bien, uno con dos antenas/radios.

Hay dos maneras de montar un nodo frontera:

:1. Nodos frontera sólo con qMp.
: Utilizando el paquete de Quagga para OpenWRT.

''[Completar]''

:2. Nodos frontera con diferentes dispositivos.
: Podéis ver un tipo de configuración "híbrida" con [[Node_frontera_amb_qMp|qMp y una RB Mikrotik]].

''[Completar]''

=== Limitaciones actuales ===

Actualmente la web de Guifi.net presenta algunas limitaciones para crear y representar las redes Mesh.

* No se puede crear un dispositivo con una radio para Mesh y otra para infraestructura, y a la vez '''reservar un rango IP diferente (Mesh,public)''' para cada una, ya que la interfaz wlan/lan se crea asociada sólo a la primera radio añadida y, luego, sólo se pueden agregar nuevos rangos IP a ésta interfaz.
** Para permitir asignar una (o varias) IP a cada radio/cable se tendrían que hacer cambios más grandes en la web, así como adaptar la BBDD. Cómo no está previsto a corto plazo, de momento, es aconsejable en dispositivos mixtos crear primero la radio Mesh y luego la radio AP, para que la primera sea la asociada a la interfaz wlan/lan, y luego, si se precisa, agregar manualmente IP's del rango "público".

* Si hay '''algún nodo que tiene visión hacia dos redes Mesh''' (p.ej. GSF-Vallcarca, UPC-Sants), automáticamente no se podrá asignar una IP de cada rango, ya que el nodo tendría que estar a la vez en dos subzonas.
** Para solucionar esto, se podría hacer, o bien dejar el nodo en la zona superior (p.ej. Barcelona) y agregar las IP de las Mesh manualmente por un administrador en los diferentes dispositivos; ó bien dejarlo en una zona/nube que tenga rango IP Mesh, y agregar manualmente el rango de la otra Mesh a otro dispositivo.

* De momento, '''no se pueden representar/pintar en el mapa los enlaces Mesh''', ya que, al ser dinámicos, no está implementada la opción en la web.
** Para ver los nodos en un mapa, podéis mirar el que hay integrado en el software qMp dentro del dispositivo.
** O bien, en el mapa de Altermesh, seleccionando qMp.cat en el desplegable (combo box): http://map.qmp.cat/

== Recomendaciones ==

* En lo que respecta al direccionamiento IP, hay un rango reservado en la zona "World", y puede que sea recomendable (aunque sea por claridad) que las diferentes zonas Mesh tengan subrangos de éste.

* Reservar rangos IP de tipo Mesh para las zonas con máscara de al menos /21.

''REVISAR: http://ca.wiki.guifi.net/wiki/Criteris_d%27assignaci%C3%B3_d%27adreces_IPv4(cat)''

== Ver también ==

* [[Quick_Mesh_Project|Quick Mesh Project (qMp)]]
* [[Altermesh]]
* [[Instalación de qMp en RouterStation Pro]]
* [[MonsterBox]]
* [[MANET]]
* [[qMp al Jardí Botànic de Barcelona]]

== Enlaces externos ==

* [http://qmp.cat/ Web del projecte qMp]
* [http://graciasensefils.net/ Gracia Sense Fils]
* [http://guifisants.net/ Guifi Sants]
* [http://poblenousensefils.net/ Poble Nou Sense Fils]

; Listas de correo
* [https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-users qmp-users ''(ENG)'']
* [https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-dev qmp-dev ''(ENG)'']
* [https://llistes.guifi.net/sympa/info/guifi-mesh guifi-mesh]
* [https://llistes.graciasensefils.net/pipermail/graciasensefils/ gsf usuaris]
* [https://llistes.graciasensefils.net/pipermail/gsf-dev/ <strike>gsf-dev</strike> ''(cerrada)'']
* [https://mail.guifisants.net/cgi-bin/mailman/listinfo/llista guifi sants]

[[Categoría:MANET]]

[[ca:Obrir xarxes tipus mesh a través de Guifi.net]]