http://ca.wiki.guifi.net/w/api.php?action=feedcontributions&feedformat=atom&user=ConxuroGuifi.net - Wiki Català - Contribucions de l'usuari [ca]2026-07-29T01:29:45ZContribucions de l'usuariMediaWiki 1.22.0http://ca.wiki.guifi.net/wiki/Annex:subxarxes_meshAnnex:subxarxes mesh2016-03-04T13:03:46Z<p>Conxuro: </p>
<hr />
<div>{| class="wikitable sortable"<br />
|- style="background:#ececec;"<br />
! Abreviació de la comunitat <ref>Segons les [[convencions de noms]] s'hauria de fer servir la minúscula, en aquesta taula surten reflexades dues en alguns casos per reflexar que per motius històrics es poden trobar nodes encara amb la convenció de noms en majúscula (NOTA: S'ha d'acordar bé encara això)</ref><br />
! Nom de la xarxa - comunitat<br />
! Ubicació<br />
! [[ESSID]] comunitari<br />
! [[firmware]]<br />
! [[canal]] <ref name="canals">'''IMPORTANT++: els canals WiFi de 40 MHz han de seguir l'estàndar, pel que el 140- no és vàlid i S'HA DE CANVIAR a totes les zones'''</ref> <ref>Missatge a les llistes sobre els canals incorrectes: https://llistes.guifi.net/sympa/arc/guifi-mesh/2015-01/msg00000.html</ref><br />
! [[BSSID (adhoc)]]<br />
! [[Mesh id (802.11s)]]<br />
! [[vlan]]<br />
! IPv4<br />
! IPv6<br />
! Comentari<br />
|-<br />
| GSF - '''gsf'''<br />
| [[Gràcia Sense Fils]]<br />
| Vila de Gràcia al municipi de Barcelona<br />
|<br />
| [[gsffirm]] i [[qMp]]<br />
| 140- old 149+<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.0.0/21<br />
|<br />
|<br />
|-<br />
| GS - '''gs'''<br />
| [[GuifiSants]]<br />
| Sants - Les Corts al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+, 124+ i 140-<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.8.0/21<br />
|<br />
|<br />
|-<br />
| RAV - '''rav'''<br />
| [[Mesh al Raval]]<br />
| Barri del raval al municipi de Barcelona<br />
| Cada node te el seu, la URL al node de guifi.net, exemple guifi.net/bcnsalvadors24<br />
| [[qMp]]<br />
| 136-<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.16.0/21<br />
|<br />
|<br />
|-<br />
| UPC - '''upc'''<br />
| [[Mesh a la UPC]]<br />
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.24.0/21<br />
|<br />
|<br />
|-<br />
| HW<br />
| [[Hospitalet Wireless]]<br />
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat<br />
| <br />
| [[qMp]]<br />
| 124+<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.32.0/21<br />
|<br />
|<br />
|-<br />
| SJD - '''sjd'''<br />
| [http://www.guifibaix.coop Mesh a Sant Joan Despí]<br />
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 136-<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.40.0/21<br />
|<br />
|<br />
|-<br />
| vllc<br />
| [[Mesh a Vallcarca]]<br />
| Barri de Vallcarca i els Penitents al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+ i 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.48.0/21<br />
|<br />
|<br />
|-<br />
| SAND - '''sand'''<br />
| [[Mesh a Sant Andreu]]<br />
| Barri de Sant Andreu al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 132+ i 120-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.56.0/21<br />
|<br />
|<br />
|-<br />
| P9SF - '''p9sf'''<br />
| [[Poblenou Sense Fils]]<br />
| Poblenou al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140- old 132+ base 124+ alt<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.64.0/21<br />
|<br />
|<br />
|-<br />
| HCMT<br />
| [[Horta-Carmel-Montbau-Teixonera]]<br />
| Part nord del districte Horta-Guinardó al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 149+<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.72.0/21<br />
|<br />
|<br />
|-<br />
| SCC<br />
| [http://www.guifibaix.coop Mesh a Santa Coloma de Cervelló]<br />
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.80.0/21<br />
|<br />
|<br />
|-<br />
| PRLL<br />
| [http://www.guifibaix.coop Mesh al Prat]<br />
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat<br />
| <br />
| [[qMp]]<br />
| 136-<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.88.0/21<br />
|<br />
|<br />
|-<br />
| gll<br />
| [[Garraf Lliure]]<br />
| Comarca del Garraf a Barcelona<br />
| garraflliure.guifi.net<br />
| [[libre-mesh]]<br />
| 11 i 36<br />
|<br />
|<br />
|<br />
| 10.1.96.0/21<br />
|<br />
|<br />
|-<br />
| mtj<br />
| [[Montjuïc - Jardí Botànic]]<br />
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona<br />
| jardibotanic.integral.guifi.net<br />
| [[libre-mesh]]<br />
| 48<br />
|<br />
|<br />
| 11<br />
| 10.1.104.0/21<br />
| 2a00:1508:1:f000 o 2a00:1508:1:fe4c::/64<br />
|<br />
|-<br />
| CRNLL<br />
| [http://www.guifibaix.coop Mesh a Cornellà]<br />
| Municipi de Cornellà a la comarca de Baix Llobregat<br />
| <br />
| [[qMp]]<br />
| 136-<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.112.0/21<br />
|<br />
|<br />
|-<br />
| afrd<br />
| Aiguafreda<br />
| <br />
| <br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.120.0/21<br />
|<br />
|<br />
|-<br />
| Wales<br />
| [http://www.digitalmerthyr.org.uk Digital Merthyr]<br />
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.128.0/20, 10.1.224.0/21, 10.92.2.0/24<br />
|<br />
|<br />
|-<br />
| CIU<br />
| [[Mesh a Ciutadella]]<br />
| Ciutadella a l'illa de Menorca.<br />
|<br />
| [[qMp]]<br />
| 140- i més ...?<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.2.0.0/21<br />
|<br />
|<br />
|-<br />
| IRU<br />
| [[Mesh a Iruña]]<br />
| Iruña a Navarra<br />
| <br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi ha nodes amb IPs del rang antic que entra en conflicte amb el rang de Wales.'''</ref><br />
|<br />
|<br />
|-<br />
| ?<br />
| [[Xarxa híbrida de Castelldefels]]<br />
| Municipi de Castelldefels a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]] i [[RouterOS]]<br />
| ?<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.10.8.0/22<br />
|<br />
| Al mateix rang s'estan fent servir modes en [[infraestructura]] amb RouterOS i nodes [[mesh]] amb qMp. La IP inicial que s'està fent servir és la [https://guifi.net/ca/node/61866 10.10.10.1/22].<br />
|-<br />
| ?<br />
| [[Mesh de Castelló]]<br />
| Ciutat de Castelló al País Valencià<br />
|<br />
| [[qMp]]<br />
| -<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.4.0.0/21<br />
|<br />
|<br />
|-<br />
| ?<br />
| [[Mesh de Benicàssim]]<br />
| Ciutat de Benicàssim a la província de Castelló, País Valencià<br />
|<br />
| [[qMp]]<br />
| -<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.4.8.0/21<br />
|<br />
|<br />
|-<br />
| sn<br />
| [[Sierra Libre]]<br />
| Región de la Sierra Norte, en el Estado de Oaxaca, México<br />
| sierralibre.guifi.net<br />
| [[libre-mesh]]<br />
| <br />
|<br />
|<br />
|<br />
| 10.72.8.0/21<br />
|<br />
|<br />
|-<br />
|SFCM<br />
| Mesh a Sant Feliu de Codines<br />
| Sant Feliu de Codines, Valles Oriental, BCN<br />
| <br />
|[[qMp]]<br />
|<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
| <br />
| 10.91.176.0/22<br />
|<br />
|<br />
|-<br />
| eixD<br />
| [[Cooperativa Integral Catalana]]<br />
| Zona mesh guifi.net de la Cooperativa Integral Catalana<br />
| <br />
| [[libre-mesh]]<br />
| 9 i 140<br />
|<br />
|<br />
| 11<br />
| 10.1.152.0/21<br />
| 2a00:1508:1:f017::/64 2a00:1508:1:f018::/64 2a00:1508:1:f019::/64<br />
|<br />
|-<br />
| Rio<br />
| [[Rio de Janeiro]]<br />
| Estat de Rio de Janeiro al Brasil (es fa servir de manera estable a la subzona [https://guifi.net/Fuma%C3%A7a Fumaça - Porto Real])<br />
| <br />
| [[libre-mesh]]<br />
| <br />
|<br />
|<br />
| <br />
| [https://guifi.net/es/node/80001/view/ipv4 10.7.0.0/16]<br />
| <br />
|<br />
|}<br />
<references /><br />
<br />
[[categoria:MANET]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_plug-insCloudy plug-ins2015-12-03T17:20:34Z<p>Conxuro: </p>
<hr />
<div>== Què és un plug-in? ==<br />
<br />
Cloudy és una distribució de Linux basada en Debian que dona als usuaris una interfície simple i còmoda per gestionar diferents serveis que poden ser fets servir a través d'una xarxa comunitària; en el nostre cas, Guifi.<br />
<br />
Al mateix temps, Cloudy ofereix una sèrie d'eines que permeten a un usuari afegir un servei del seu gust sense haver de tenir grans coneixements sobre xarxes i informàtica en general. Automàticament, aquests serveis es publiquen mitjançant Avahi, de manera que tothom que disposi de Cloudy pot fer ús d'aquests servei.<br />
<br />
Una altra manera d'anomenar aquests serveis que es poden posar i treure de forma senzilla és plug-in. Així doncs, entenem per plug-in a un programa o software que un usuari vol afegir a la distribució i que pot ser gestionat de forma simple des de la interfície web que proveeix Cloudy.<br />
<br />
<br />
== Afegir serveis a Cloudy ==<br />
<br />
=== Una petita introducció ===<br />
<br />
Aquesta guia t'ensenyarà el procés per afegir un nou servei a la distribució Cloudy.<br />
<br />
Per tal de ser clar i donar alguns exemples al mateix temps, integrarem un servei bastant simple mostrant alguns troços de codi pel camí. Per seguir el tutorial amb més claredat, o bé per integrar serveis més complexes, fora bò que sapiguéssiu alguna cosa de Bash<ref name="Bash">(http://www.tldp.org/LDP/Bash-Beginners-Guide/Bash-Beginners-Guide.pdf)</ref> i de PHP<ref name="PHP">(https://php.net/manual/es/index.php)</ref>.<br />
<br />
Per simplicitat farem servir Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. És un bon candidat ja que:<br />
<br />
* És independent i no es ''federa'' ni es comunica amb altres nodes.<br />
* Està fet en Go, és fàcil de distribuïr i instal·lar.<br />
* No necessita fitxers de configuració.<br />
* No necessita gaires recursos.<br />
<br />
=== Obtenir el binari ===<br />
<br />
El primer que hem d'investigar és com descarregar i instal·lar el binari a Cloudy. La majoria del software que podem trobat està per defecte en els paquets de Debian, però el Pastecat no hi és. Si es donés el cas que hi fós, tan sols hauriem d'executar la comanda <code>apt-get install pastecat</code> des de PHP.<br />
<br />
Però com que aquest no és el cas, haurem de treure el binari d'algun altre lloc. Una opció és agafar el codi font i compilarl-lo nosaltres mateixos, però el problema d'això és que Cloudy necessitaría incloure moltes eines i llibreries per compil·lar, i aquest no és l'objectiu.<br />
<br />
La millor opció si un paquet de Debian no està disponible en els repositoris, és descarregar els binaris des d'algun lloc segur. Podem fer servir el servei de ''"releases"'' de Github per això. Les dues opcions ens deixen amb un fitxer executable que hauriem de ser capaços de córrer directe sobre Cloudy.<br />
<br />
En aquest cas en particular descarregarem els binaris des del repositori git amb la següent línia de comandes:<br />
<br />
<code><br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386_v0.3.0<br />
</code><br />
<br />
Noteu que en aquest cas en concret estem descarregant una versió específica per un Linux amb arquitectura i386.<br />
<br />
Fixeu-vos però, que tenir el servei en els paquets de Debian té moltes avantatges:<br />
<br />
* Les actualitzacions són simples i no necessiten feina extra des de Cloudy.<br />
* El paquet està compilat per Debian d'una manera segura.<br />
* Els fitxer de l'''init.d'' ja venen per defecte.<br />
* Els paquets de Debian solen contenir correccions.<br />
<br />
=== Provar-lo ===<br />
<br />
Abans d'afegir un servei hauriem de configurar-lo i provar-lo directament nosaltres mateixos per veure com funciona i que realment funciona. També hem entendre quines opcions de configuració o línies de comandes necessitarem per fer ús d'aquest servei en particular i com el gestionarem un cop estigui funcionant.<br />
<br />
=== Afegir el controlador ===<br />
<br />
En <code>web/plug/controllers</code> tenim un fitxer PHP per cada servei, anomenat controlador (o 'controller' en anglès). Aquest fitxer conté el codi que s'executarà quan es visiti la pàgina del nostre servei des de la interfície web de Cloudy.<br />
<br />
==== Afegir la funció índex ====<br />
<br />
El que volem fer és que el nostre servei estigui integrat en l'estructura web de Cloudy. Per fer això, necessitem crear uns quants ''scripts'' en PHP i afegir-los al nostre dispositiu. De moment necessitarem crear dos ''scripts'': <code>pastecat.php</code> i <code>pastecat.menu.php</code>. El primer fitxer és el controlador, és a dir, l'''script'' que renderitza la pàgina i té tota la informació tal com botons o redireccionaments. L'altre és el que permet que el nostre servei es mostri en els menus superiors desplegables de Cloudy.<br />
<br />
El codi del menú serà quelcom semblant a això:<br />
<br />
<code php> <br />
<?php<br />
//peerstreamer.menu.php<br />
addMenu('Pastecat','pastecat','Clommunity');<br />
</code><br />
<br />
Per ara, farem servir un ''script'' molt simple en PHP com a controlador:<br />
<br />
<code php> <br />
<?php<br />
//pastecat<br />
$title="Pastecat";<br />
<br />
function index(){<br />
global $paspath,$title;<br />
global $staticFile;<br />
<br />
$page=hlc(t($title));<br />
$page .= hl(t("Minimalist pastebin engine written in Go"),4);<br />
$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."));<br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
</code><br />
<br />
En el nostre sistema Cloudy aquests fitxers han de posar-se als directoris dins de <code>/var/local/cDistro/plug/</code>. El primer ha d'anar dins de <code>menus</code> i el segon al directori <code>controllers</code>. Un cop haguem fet això, podem anar al web del nostre dispositiu amb Cloudy i accedir al nou menú Pastecat.<br />
<br />
==== Fer que el controlador instal·li el nostre servei ====<br />
<br />
Com s'ha mencionat anteriorment, aquest pas és molt més senzill de realitzar si el servei està en els paquets de Debian. Com que no és el cas del Pastecat, ho haurem de fer manualment. Normalment, fer aquest procés manualment inclou una combinació de les comandes <code>wget</code>, <code>mv</code> i <code>chmod</code>. En general, és bona idea mantenir els fitxers d'aquest tipus de serveis a <code>/opt/SERVICENAME</code>.<br />
<br />
En el nostre cas en particular, la primera cosa que necessitem fer és descarregar el binari de la ''release'' de Github. per tal de fer això farem ús de la comanda mencionada abans: <code>wget</code>. Donada una URL a un fitxer, aquesta comanda en permet descarregar aquest fitxer al nostre sistema, i això és el que farem tot seguit amb:<br />
<br />
<code bash><br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386_v0.3.0<br />
</code><br />
<br />
Una cop tinguem el binari en la nostra màquina el mourem al directori /opt/pastecat/. Per tal de moure els fitxers pel nostre sistema farem servir la comanda <code>mv</code>. Tot i així, primer haurem de crear el directori on posarem el fitxer. Per fer això, utilitzarem <code>mkdir</code> de la següent manera:<br />
<br />
<code bash><br />
mkdir -p /opt/pastecat/<br />
</code><br />
<br />
Una vegada haguem creat el directori, és hora de moure-hi el binari:<br />
<br />
<code bash><br />
mv current_directory/pastecat_linux_386 /opt/pastecat/<br />
</code><br />
<br />
On "current_directory" és el directori on prèviament hem descarregat el binari. Com que el nom del binari depèn de l'arquitectura, per tal de simplificar el codi del controlador, canviarem el nom del fitxer executable a quelcom més genèric i simple:<br />
<br />
<code bash><br />
mv /opt/pastecat/pastecat_linux_386 /opt/pastecat/pastecat<br />
</code><br />
<br />
Ara el nostre binari es diu <code>pastecat</code> en comptes de <code>pastecat_linux_386</code><br />
<br />
Aquests passos són els mínim requerits per instal·lar un servei que no s'ofereix directament en els repositoris oficials de Debian. Nogensmenys, de cara a un usuari final, seria un malson haver de fet totes aquestes comandes en una consola connectat a través de <code>ssh</code> al seu dispositiu, així que el que farem tot seguit és crear un script en bash que serà cridat més endavant a través de la interfície web clicant un botó.<br />
<br />
Aquest ''script'' és la primera versió del controlador del Pastecat. Per ara només inclourem una funció per instal·lar el Pastecat en el nostre dispositiu. Més endavant inclourem algunes altres funcions per proveïr al nostre ''script'' amb més serveis:<br />
<br />
<code bash><br />
#!/bin/bash<br />
PCPATH="/opt/pastecat/"<br />
<br />
doInstall() {<br />
if isInstall<br />
then<br />
echo "Pastecat is already installed."<br />
return<br />
fi<br />
<br />
# Creating directory and switching<br />
mkdir -p $pcpath && cd $pcpath<br />
<br />
# Getting file<br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386_v0.3.0<br />
<br />
# Changing name so controller can invoke it generically<br />
mv pastecat_linux_386 pastecat<br />
chmod +x pastecat<br />
<br />
cd -<br />
}<br />
<br />
isInstalled() {<br />
[ -d $pcpath ] && return 0<br />
return 1<br />
}<br />
<br />
<br />
case $1 in<br />
"install")<br />
shift<br />
doInstall $@<br />
;;<br />
esac<br />
</code><br />
<br />
Podem veure com els últims passos s'han concentrat dins d'una mateixa funció, permetent-nos instal·lar el software en el dispositiu d'una forma més senzilla.<br />
<br />
==== Fer que el controlador utilitzi Pastecat ====<br />
<br />
===== Executar el servei =====<br />
<br />
El següent que volem fer és que el nostre software es pugui fer servir des de la interfície web. És per això que inclourem una nova opció a la nostra pàgina principal de Pastecat i inclourem una nova funció en el nostre controlador per gestionar el binari. Afegirem un botó en el PHP de la següent manera:<br />
<br />
<code bash><br />
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));<br />
</code><br />
<br />
Just després del missatge <code>Pastecat is installed</code>. El proper que cal fer és implementar la funció <code>publish</code> en el mateix PHP. Aquesta funció és la responsable de cridar a la funció corresponent des del controlador i anunciar el nostre servei fent servir Avahi. La diferència amb aquesta funció és que requereix un formulari per introduïr-hi dades, així que al final acabarem tenint dues funcions: una get i una post:<br />
<br />
<code php><br />
function publish_get() {<br />
global $pcpath,$title;<br />
global $staticFile;<br />
<br />
$page = hlc(t($title));<br />
$page .= hlc(t('Publish a pastecat server'),2);<br />
$page .= par(t("Write the port to publish your Pastecat service"));<br />
$page .= createForm(array('class'=>'form-horizontal'));<br />
$page .= addInput('description',t('Describe this server'));<br />
$page .= addSubmit(array('label'=>t('Publish'),'class'=>'btn btn-primary'));<br />
$page .= addButton(array('label'=>t('Cancel'),'href'=>$staticFile.'/peerstreamer'));<br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
<br />
function publish_post() {<br />
$port = $_POST['port'];<br />
$description = $_POST['description'];<br />
$ip = "";<br />
<br />
<nowiki>$page = "<pre>";<br />
$page .= _pcsource($description);<br />
$page .= "</pre>";</nowiki><br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
</code><br />
<br />
Com podem veure en la funció <code>post</code> estem invocant una altra funció. La raó de fer això és escriure un codi més simple i modular. En aquesta última funció per fi cridem a l'script:<br />
<br />
<code php><br />
function _pcsource($port,$description) {<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;<br />
<br />
$page = "";<br />
$device = getCommunityDev()['output'][0];<br />
$ipserver = getCommunityIP()['output'][0];<br />
<br />
if ($description == "") $description = $type;<br />
<br />
$cmd = $pcutils." publish '$port' '$description';<br />
execute_program_detached($cmd);<br />
<br />
$page .= t($ipserver);<br />
$page .= par(t('Published this server.'));<br />
<br />
$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));<br />
<br />
return($page)<br />
}<br />
</code><br />
<br />
El proper que hem de fer és crear una funció <code>publish</code> en el controlador, pel que afegirem una nova funció al controlador bàsic que teniem a la secció '''3.2'''. Primer afegirem un nou paràmetre anomenat ''publish'', així que la primera part a exeutar-se de l'''script'' serà:<br />
<br />
<code bash><br />
if [ $# -lt 1 ]<br />
then<br />
doHelp<br />
fi<br />
<br />
case $1 in<br />
"install")<br />
shift<br />
doInstall $@<br />
;;<br />
"publish")<br />
shift<br />
doServer $@<br />
;;<br />
esac<br />
</code><br />
<br />
Com podem veure, quan el primer argument de l'script és <code>publish</code>, desplazamos (''shift') la resta d'arguments i cridem a la funció <code>doServer</code>. En aquesta funció hem de posar en marxa el servei amb els arguments corresponents, així que el primer que farem serà posar aquests paràmetres en variables locals. Una vegada haguem fet això, el més lògic seria llençar l'aplicació directament, però com que l'script es crida amb permisos de "root" (i això és dolent) hem de llençar Pastecat com a usuari <code>nobody</code>. El problema és que l'usuari <code>nobody</code> no té quasi permisos i el Pastecat necessita alguns permisos per crear directoris i fitxers de text. Per permetre que <code>nobody</code> pugui fer aquestes coses, primer crearem un directori garantint permisos a casibé tothom. Per aconseguir això, farem servir la comanda <code>chmod</code> altre vegada. Ara, l'usuari pot crear fitxers i directoris dins d'aquest mateix directori, i en conseqüència, podem córrer Pastecat. Finalment, mantindre el PID en una variable en cas que el necessitem més endavant (que ja us dic que sí que el necessitarem):<br />
<br />
<code bash><br />
doServer() {<br />
# Turning machine into a server<br />
<br />
local port=${1:-""}<br />
local description=${2:-""}<br />
local ip=${3:-"0.0.0.0"}<br />
<br />
# Creating directory with nobody permissions<br />
mkdir -p "/var/local/pastecat"<br />
chmod 777 "/var/local/pastecat" && cd "/var/local/pastecat"<br />
<br />
# Running pastecat <br />
cmd='su '$PCUSER' -c "{ '$PCPATH$PCPROG' -l :'$port' > '$LOGFILE' 2>&1 & }; echo \$!"'<br />
pidpc=$(eval $cmd) # keeping PID for future needs...<br />
<br />
cd -<br />
<br />
# Using the PID, we could carry on process control so if the pastecat process die, we can also<br />
# stop the avahi process to avoid "false connections"<br />
<br />
return<br />
}<br />
</code><br />
<br />
Fixeu-vos que ara estem fent servir algunes variables globals que no estaven definides abans, com<br />
ara <code>PCUSER</code> i <code>LOGFILE</code>. Aquestes variables tenen els següents valors:<br />
<br />
<code bash><br />
PCPATH="/opt/pastecat/"<br />
PCPROG="pastecat"<br />
LOGFILE="/dev/null"<br />
PCUSER="nobody<br />
</code><br />
<br />
===== Aturar el servei =====<br />
<br />
En algun moment és possible que vulguem aturar el nostre servei. És per això que crearem un botó per fer-ho. La primera cosa a fer sería crear el botó, però si pensem una mica, veurem que abans de crear-lo necessitem una manera de saber si el nostre servei està corrent o no. A més a més, també necessitem una manera d'aturar el nostre servei. Com que estem corrent sobre Linux, podem aconseguir aturar el servei fàcilment fent servir la comanda <code>kill</code>. El problema és que per fer servir aquesta comanda primer necessitem saber el número d'identificació del procés (PID). Per sort nostra, ja vam quedar-nos amb aquest número quan vam crear el servidor de Pastecat; en concret amb la línia <code>pidpc=$(eval $cmd)</code>.<br />
<br />
Ara que tenim tot el que necessitem per matar el nostre procés, anem a veure com ho fem perquè el PHP pugui saber si el servei està corrent o no. Una manera fàcil i eficient de fer-ho és emmagatzemant algunes dades útils en un fitxer i borrar-lo quan s'aturi el Pastecat. D'aquesta manera ens assegurem que el fitxer només existeix quan el Pastecat està actiu. Aquest fitxer el crearem des del controlador afegint les següents línies just sota la sentència que hem mencionat en el paràgraf enterior:<br />
<br />
<code bash><br />
# Writting server info to file<br />
info="$pidpc http://$ip:$port" # Separator is space character<br />
echo $info > $PCFILE<br />
</code><br />
<br />
On <code>$PCFILE</code> és una variable global que conté <code>/var/run/pc.info</code>. Fixeu-vos que el contingut del fitxer serà el PID del Pastecat i la direcció completa del servidor d'aquest.<br />
<br />
Ara ja tenim una manera de saber si el servei està actiu o no, de manera que tot seguit afegirem el botó 'stop' a la interfície web. Modificarem una mica l'''script'' PHP que teniem abans, afegint un anunci indicant si el Pastecat s'està executant o no i 2 botons més quan aquest estigui corrent. Així doncs, la nostra funció índex contindrà el següent codi dins la condició que comproba si el Pastecat està instal·lat o no:<br />
<br />
<code php><br />
<nowiki>$page .= "<div class='alert alert-success text-center'>".t("Pastecat is installed")."</div>\n";<br />
if ( isRunning() ) {<br />
$page .= "<div class='alert alert-success text-center'>".t("Pastecat is running")."</div>\n";<br />
$page .= addButton(array('label'=>t('Go to server'),'href'=>'http://'. getCommunityIP()['output'][0] .':'. $port));<br />
$page .= addButton(array('label'=>t('Stop server'),'href'=>$staticFile.'/pastecat/stop'));<br />
} else {<br />
$page .= "<div class='alert alert-error text-center'>".t("Pastecat is not running")."</div>\n";<br />
}<br />
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));</nowiki><br />
</code><br />
<br />
En aquest tros de codi podem apreciar dues coses noves en el nostre codi. La primera és una funció de comprovació anomenada <code>isRunning()</code>. Aquesta funció s'assembla molt a la funció que feiem servir per comprovar si el Pastecat estava instal·lat o no:<br />
<br />
<code php><br />
function isRunning() {<br />
// Returns whether pastecat is running or not<br />
global $pcfile;<br />
<br />
return(file_exists($pcfile)); <br />
}<br />
</code><br />
<br />
És tant simple com sembla, només comprova que el fitxer creat quan es llença el server de Pastecat encara existeixi. La segona cosa que podem veure nova en el nostre codi és l'existència d'una nova funció anomenada <code>stop</code>. Aquesta funció invocarà una altra funció en el controlador que aturarà el servidor de Pastecat:<br />
<br />
<code php><br />
function stop() {<br />
// Stops Pastecat server<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;<br />
<br />
$page = "";<br />
$cmd = $pcutils." stop ";<br />
execute_program_detached($cmd);<br />
<br />
return(array('type'=>'redirect','url'=>$staticFile.'/pastecat'));<br />
}<br />
</code><br />
<br />
Per tal de fer que el controlador entengui aquesta ordre, haurem de modificar-ne la sentència <code>case</code> i afegir-hi la noca funció. En el <code>case</code> hi afegirem el següent sota de l'opció <code>install</code>:<br />
<br />
<code bash><br />
"stop")<br />
shift<br />
doStop $@<br />
;;<br />
</code><br />
<br />
Això crida a la funció <code>doStop</code> dins del mateix controlador. Aquesta funció serà semblant a això:<br />
<br />
<code bash><br />
doStop() {<br />
# Stopping pastecat server<br />
pcpid=$(cat $PCFILE | cut -d' ' -f1)<br />
kill $pcpid<br />
<br />
# Removing info file<br />
rm $PCFILE<br />
}<br />
</code><br />
<br />
Aquesta funció agafa el PID de Pastecat del fitxer que hem creat abans, mata el procés i finalment esborra el fitxer de manera que el php pugui detectar que el Pastecat s'ha aturat.<br />
<br />
Ara podem crear un servidor de Pastecat i aturar-lo. Tot i així, encara hi ha quelcom que manca: fer que la resta d'usuaris puguin veure el nostre servei. I és per això que utilitzarem Avahi.<br />
<br />
=== Publicació de serveis Avahi ===<br />
<br />
Una de les millors coses de Cloudy és la característica de publicar els nostres serveis com una publicació d'avahi, permetent als altres usuaris saber què oferim i unir-se al nostre servei. Per fer aixo, primer hem d'afegir algunes línies de codi al controlador php, just sota de la crida al controlador en bash per activar el servidor Pastecat. Afegirem les següents línies:<br />
<br />
<code php><br />
$description = str_replace(' ', '', $description);<br />
$temp = avahi_publish($avahi_type, $description, $port, "");<br />
$page .= ptxt($temp);<br />
</code><br />
<br />
Així que al final la nostra funció quedarà així:<br />
<br />
<code php><br />
function _pcsource($port,$description) {<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type;<br />
<br />
$page = "";<br />
$device = getCommunityDev()['output'][0];<br />
$ipserver = getCommunityIP()['output'][0];<br />
<br />
if ($description == "") $description = $type;<br />
<br />
$cmd = $pcutils." publish '$port' '$description'";<br />
execute_program_detached($cmd);<br />
<br />
$page .= t($ipserver);<br />
$page .= par(t('Published this server.'));<br />
$description = str_replace(' ', '', $description);<br />
$temp = avahi_publish($avahi_type, $description, $port, "");<br />
$page .= ptxt($temp);<br />
<br />
$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));<br />
<br />
return($page)<br />
}<br />
</code><br />
<br />
Amb aquest simple pas hem anunciat el nostre servei a la xarxa d'avahi. Tot i això la feina no acaba aquí, encara queda una cosa més a fer: crear un botó i programar-lo de manera que quan es cliqui, ens redirigeixi directament al nostre servidor de Pastecat.<br />
<br />
Per fer això hi ha una carpeta anomenada <code>avahi</code> dins del directori <code>plug</code>. Els ''scripts'' que defineixen l'acció a dur a terme quan es cliquen els botons d'avahi estan en diferents fitxers dins d'aquest directori. D'aquesta manera crearem un fitxer anomenat <code>pastecat.avahi.php</code> que contindrà:<br />
<br />
<code php><br />
<?php<br />
// plug/avahi/pastecat.avahi.php<br />
<br />
addAvahi('pastecat','fpcserver');<br />
<br />
function fpcserver($dates){<br />
global $staticFile;<br />
<br />
return ("<a class='btn' href='http://" .$dates['ip'] .":". $dates['port']."'>Go to server</a> ");<br />
}<br />
</code><br />
<br />
Això crearà un botó al costat de l'anunci d'avahi que apuntarà al nostre servidor.<br />
<br />
Ara que ja tenim el nostre servei anunciat, volem que aquest desaparegui un cop aturem el servidor Pastecat. Aquest últim pas és molt simple però important. Consisteix en unes poques línies de codi en la funció 'stop' de l'''script'' PHP. Fins ara, aquesta funció només cridava el controlador Bash i aturava el Pastecat, però ara també aturarà la publicació Avahi i mostrarà un breu comentari donant a conèixer que la crida ha funcionat:<br />
<br />
<code php><br />
$temp = avahi_unpublish($avahi_type, $port);<br />
$flash = ptxt($temp);<br />
setFlash($flash);<br />
</code><br />
<br />
Aquestes línies han de ser afegides just després de la sentència <code>execute_program_detached($cmd)</code> a la funció stop del php.<br />
<br />
=== Final ===<br />
<br />
Finalment afegir que tots els fitxers implementats durant aquest tutorial es poden trobar en un repositori GitHub que apareix a l'apartat d'Enllaços Externs, juntament amb aquest mateix tutorial en format Markdown (md).<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
https://github.com/Clommunity/Doc/tree/master/plugins/pastecat<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]<br />
[[en:Cloudy_plug-ins]]<br />
[[es:Cloudy_plug-ins]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_web_UICloudy web UI2015-12-03T17:15:14Z<p>Conxuro: </p>
<hr />
<div><br />
== Introducció ==<br />
<br />
La inferfície d'usuari web (web User Interface (UI)) de Cloudy utilitza una aplicació anomenada cDistro <ref name="cdistro">cDistro git repository: https://github.com/Clommunity/cDistro</ref>.<br />
<br />
''(Cal afegir què és)''<br />
<br />
<br />
<br />
== Configuració ==<br />
<br />
La configuració de cDistro es troba a <s>/etc/cdistro.conf</s> /etc/cloudy/cloudy.conf<br />
<br />
Per defecte té el següent format:<br />
<br />
#cdistro config<br />
SERVER="/usr/bin/php"<br />
OPTS=""<br />
BINDIP="0.0.0.0"<br />
PORT="7000"<br />
DOCROOT="/var/local/cDistro"<br />
# SSHAUTH=1 <- check user with ssh2 connection http://www.php.net/manual/en/function.ssh2-auth-password.php (Require: libssh2-php)<br />
SSHAUTH=1<br />
# LOGIN="root"<br />
## PASSWORD = md5(md5('secret')) => php -r 'echo md5(md5("secret"))."\n";'<br />
#PASSWORD="7022cd14c42ff272619d6beacdc9ffde"<br />
PORT_SSL=7443<br />
<br />
<br />
=== SERVER ===<br />
<br />
La ruta de l'executable PHP.<br />
<br />
'''Exemple:'''<br />
<br />
* "/usr/bin/php" - en el cas de Cloudy (Debian).<br />
<br />
<br />
=== OPTS ===<br />
<br />
Opcions de PHP.<br />
<br />
''(Cal afegir referències o més info i exemple)''<br />
<br />
<br />
=== BINDIP ===<br />
<br />
L'adreça IP on el servei estarà escoltant.<br />
<br />
'''Exemple:'''<br />
<br />
* "127.0.0.1" - acceptarà només peticions des de localhost.<br />
* "0.0.0.0" - acceptarà peticions des de qualsevol adreça.<br />
<br />
<br />
=== PORT ===<br />
<br />
El port que obrirà el servei per escoltar peticions.<br />
<br />
'''Exemple:'''<br />
<br />
* "7000" - obre el port 7000<br />
<br />
<br />
=== DOCROOT ===<br />
<br />
La ruta de l'executable de l'aplicació cDistro.<br />
<br />
'''Exemple:'''<br />
<br />
* "/var/local/cDistro" - en el cas de Cloudy.<br />
<br />
<br />
=== SSLAUTH ===<br />
<br />
Paràmetre que permet autenticació via SSH2 a l'aplicació, és a dir, per utilitzar les credencials que permeti el servidor SSH del sistema.<br />
<br />
Pot ser 0 o 1.<br />
<br />
'''Exemple:'''<br />
<br />
* "1" - activa aquesta opció.<br />
* "0" - desactiva aquesta opció (requerirà definir usuari i contrasenya).<br />
<br />
<br />
=== LOGIN ===<br />
<br />
El nom d'usuari per autenticar-se en l'aplicació.<br />
<br />
Ha de ser una cadena sense espais.<br />
<br />
'''Exemple:'''<br />
<br />
* "cloudy" - aquest usuari podrà fer log-in amb la contrasenya definida a PASSWORD.<br />
<br />
<br />
=== PASSWORD ===<br />
<br />
La contrasenya de l'usuari definit a LOGIN.<br />
<br />
Ha de ser un ''hash'' sobre ''hash'' MD5 (hexadecimal), és a dir, un ''hash'' del ''hash'' de la contrasenya: md5(md5("PASSWORD")).<br />
<br />
<br />
'''Exemple:'''<br />
<br />
* "46d934e0f59ff1e2272f9f5f7950e5d9" - ''hash'' corresponent a la cadena de caràcters "PASSWORD".<br />
<br />
'''Exemples de com generar aquest ''hash'' en un terminal:'''<br />
<br />
$ php -r 'echo md5(md5("PASSWORD"))."\n";'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
$ printf "PASSWORD" | md5sum | awk '{printf $1}' | md5sum | awk '{print $1}'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
<br />
<br />
=== PORT_SSL ===<br />
<br />
Port que utilitzarà Cloudy en la interfície web amb HTTPS (si SSL està instal·lat).<br />
<br />
'''Exemple:'''<br />
<br />
* "7443" - s'accedirà a la web https://IP_SERVIDOR:7443.<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_paquets_repositoriCloudy paquets repositori2015-09-15T16:43:52Z<p>Conxuro: Es crea la pàgina amb «'''''Nota: aquest article pot estar desactualitzat i hauria de ser revisat. Tingues precaució si segueixes aquesta guia, i millor pregunta abans en les llistes de cor...».</p>
<hr />
<div>'''''Nota: aquest article pot estar desactualitzat i hauria de ser revisat. Tingues precaució si segueixes aquesta guia, i millor pregunta abans en les llistes de correu.'''''<br />
<br />
<br />
<br />
== Pujar paquets al repositori de software de Cloudy (projecte Clommunity) ==<br />
<br />
Estem preparats per a pujar paquets al repositori públic de Cloudy http://repo.clommunity-project.eu.<br />
<br />
Aquí requerirem claus públiques per a signar i pujar paquets. Pots editar els scripts i canviar les rutes ''(paths)'' en quant a les teves necessitats.<br />
<br />
El repositori està auto-signat amb una clau anomenada "gcodis Distro Development Team", més informació en el mateix repositori: http://repo.clommunity-project.eu. L'auto-signat prevé que el repositori permaneixi no signat si algú puja paquets sense signar. Una signatura pel repositio, que es afegida en el costat del client per a permetre la instal·lació de la distro, i una altra que depèn del mantenidor o desenvolupador per a signar el paquet.<br />
<br />
<br />
=== Claus públiques ===<br />
<br />
Per a pujar paquets necessitem aconseguir '''les teves claus''' públiques:<br />
<br />
* L''''ID de la clau pública GPG, pujat a gpg.mit.edu'''. Amb aquesta clau podràs signar les pujades.<br />
* La '''clau publica SSH''', per a pujar paquets. Necessària per a accedir remotament a la màquina del repositori.<br />
<br />
Els paquets són pujats per defecte a la branca ''unstable'' (utilitza el "log de canvis" ''(changelog)'' per això). Nosaltres utilitzem l'eina de Debian <code>dput</code> per a pujar els paquets i signar-los. El repositori està auto-signat amb una altra clau.<br />
<br />
Pots '''enviar''' les claus públiques o IDs a la llista de correu del projecte: ''clommunity-wp4''. D'aquesta manera tindrem accés a les claus públiques quan sigui necessari.<br />
<br />
<br />
=== Arxius ===<br />
<br />
El arxiu de configuració és:<br />
<br />
* <code>.dput.cf</code> és un arxiu de configuració que ha de ser copiat en el directori ''home'' como <code>~/.dput.cf</code>. Utilitzat per a pujar paquets amb l'eina de Debian <code>dput</code>.<br />
<br />
<code><br />
[repo.clommunity-project.eu]<br />
fqdn = repo.clommunity-project.eu<br />
method = scp<br />
login = repo<br />
incoming = /var/www/debian/mini-dinstall/incoming<br />
post_upload_command = ssh repo@repo.clommunity-project.eu "mini-dinstall -b"<br />
</code><br />
<br />
<br />
=== Creant paquets ===<br />
<br />
Mira algunes maneres per a crear paquets en http://www.debian.org/doc/manuals/maint-guide/build.en.html.<br />
<br />
<br />
=== Pujant paquets ===<br />
<br />
Pots utilitzar la comanda <code>dput</code> de la següent manera:<br />
<br />
<code><br />
$ dput repo.clommunity-project.eu cloudy-base_0.1.3.5_i386.changes<br />
</code><br />
<br />
Recorda guardar les versions prèvies de l'arxiu <code>~/.dput.cf</code> en el teu directori <code>$HOME</code>.<br />
<br />
És important escriure el nom del repositori ''(repo.clommunity-project.eu)''.<br />
<br />
<br />
=== Millores contínues ===<br />
<br />
El repositori es millora per a funcionar millor quan és necessari donar un millor servei.<br />
<br />
Gràcies pels teus esforços.<br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_AlixCloudy Alix2015-09-11T02:32:30Z<p>Conxuro: Es crea la pàgina amb «Alix és una [https://en.wikipedia.org/wiki/Single-board_computer SBC] amb un processador AMD (x86) diverses interfícies d'entrada-sortida (sèrie, miniPCI, Ethernet,...».</p>
<hr />
<div>Alix és una [https://en.wikipedia.org/wiki/Single-board_computer SBC] amb un processador AMD (x86) diverses interfícies d'entrada-sortida (sèrie, miniPCI, Ethernet, etc.). És per això que s'ha de fer servir un sistema operatiu preparat amb els controladors ''(drivers)'' corresponents per a fer funcionar aquestes interfícies.<br />
<br />
''Nota: aquesta guia s'ha fet amb una Debian especialment preparada per a funcionar en Alix, però és possible que amb una altra distribució basada en Debian funcioni amb passos similars.''<br />
<br />
<br />
<br />
== Aconseguir Debian per Alix ==<br />
<br />
Pots [https://code.google.com/p/debian-for-alix/ descarregar d'aquesta pàgina] una imatge especial de Debian a punt per a funcionar en placas Alix un cop gravada en una targeta CF.<br />
<br />
=== Característiques/serveis inclosos ===<br />
<br />
* Sistema d'arxius de només lectura, protegeix contra fallades de corrent i augmenta substancialment la vida de la targeta.<br />
<br />
* Serveis comuns disponibles en la primera arrencada:<br />
** serial terminal ( 38400n8 )<br />
** dnsmasq ( servidors DNS i DHCP )<br />
** iptables ( regles firewall i compartició d'Internet )<br />
** samba ( compartició d'arxius de Microsoft Windows )<br />
** cups ( servidor d'impressora )<br />
** vsftpd ( servidor FTP )<br />
** nginx with fastcgi ( servidor HTTP )<br />
** minidlna ( servidor multimèdia )<br />
** openssh ( terminal i SFTP )<br />
** stunnel ( motor SSL, suport HTTPS pre-configurat per a ''nginx'' i ''transmission'' )<br />
** tinyproxy ( servidor proxy HTTP/HTTPS )<br />
** pptpd ( servidor VPN, MS Windows té un client incorporat )<br />
** snmpd ( servidor SNMP )<br />
** openvpn ( servidor i client VPN )<br />
** openconnect ( client VPN, compatible amb Cisco )<br />
** external storage automount and sharing basic web admin panel performance monitor ( on web panel )<br />
<br />
* Serveis addicionals disponibles:<br />
** transmission ( torrent p2p )<br />
** hostapd ( wireless access point / necessita targeta miniPCI o usb wifi )<br />
<br />
* Sistema de mantenimient a través de <code>apt-get</code>, utilitza'l per a actualitzar, instal·lar o eliminar aplicacions i ''patches''.<br />
<br />
* Tingues en compte que és una Debian i386, pel que qualsevol software disponible per aquesta arquitectura pot ser instal·lat, considerant les limitacions de potència.<br />
<br />
* Els arxius d'imatge estan disponibles per a descarregar en GoogleDrive:<br />
** debian-for-alix-v1.img.bz2 (debian 6 based) version 1 wiki page<br />
** debian-for-alix-v2.img.bz2 (debian 6 based) version 2 wiki page<br />
** debian-for-alix-v3.img.bz2 (debian 7 based) Debian instalació bàsica, només servidor SSH i utilitats bàsiques, també el terminal sèrie está preparat, perè no té el sistema d'arxius en només lectura ni altres característiques.<br />
<br />
* La configuració per defecte és:<br />
<code>eth0: DHCP</code><br />
<br />
<code>eth1: static 172.16.210.254</code><br />
<br />
<code>eth2: sense configuració</code><br />
<br />
<code>usuario: alix (root té l'accés bloquejat)</code><br />
<br />
<br />
<br />
== Instal·lar la imatge Debian en la CF ==<br />
<br />
=== Identificar la CF ===<br />
<br />
La targeta CF necessita ser formatejada amb ext2. Assegura't de quin dispositiu és la teva targeta, en cas contrari podries esborrar el S.O. del teu ordinador. En aquest exemple la CF està en <code>/dev/sdb</code>.<br />
<br />
Pots provar mirant en <code>/proc/bus/usb/devices</code>. Hauries de veure una secció amb una línia ''S:'' i el nom del teu lector, i una línia ''I:'' amb <code>Driver=usb-storage</code>. Si ho veus, és que el ''kernel'' reconeix el dispositiu.<br />
<br />
Instal·lar el paquet <code>sg3-utils</code> si no ho tens ja (en Debian: <code>apt-get install sg3-utils</code>). Per a comprovar els teus dispositius SCSI, executa la comanda:<br />
sg_scan -i<br />
<br />
Hauries de veure alguna cosa similar a això:<br />
/dev/sg0: scsi0 channel=0 id=0 lun=0 [em] type=0<br />
eUSB Compact Flash 5.09 [wide=0 sync=0 cmdq=0 sftre=0 pq=0x0] <br />
<br />
Mostra que el dispositiu “raw” SCSI associat amb el teu lector és <code>/dev/sg0</code>. Pots confirmar que el ''driver'' està funcionant mirant l'arxiu <code>/proc/scsi/scsi</code>. Ara, per a determinar el dispositiu SCSI real associat al teu lector executa la comanda:<br />
sg_map<br />
<br />
Veuràs una sortida com aquesta:<br />
/dev/sg0 /dev/sdb<br />
<br />
Això és tot, el teu lector de targetas és <code>/dev/sdb</code>. La primera (i probablement l'única) partició és <code>/dev/sdb1</code>.<br />
<br />
<br />
=== Copiar la imatge en la CF ===<br />
<br />
Per a instal·lar la imatge en la targeta CF pots fer-ho amb la següent comanda:<br />
bzcat debian-for-alix-v3.img.bz2 | dd of=/dev/sdb bs=16k<br />
<br />
<br />
<br />
== Instal·lar Cloudy ==<br />
<br />
Per instal·lar Cloudy pots seguir les instrucciones per a [[Cloudy_en_Debian|convertir una instal·lación bàsica de Debian en Cloudy]] afegint al sistema els arxius i eines específiques de la distribució.<br />
<br />
Ho anomenem "cloudynitzar".<br />
<br />
Recomanem utilitzar un script per a automatitzar el procés. Pots saber com en la [[cloudynitzar|pàgina d'aquesta wiki que explica com "cloudynitzar"]].<br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_BeagleboneCloudy Beaglebone2015-09-10T20:19:50Z<p>Conxuro: Es crea la pàgina amb «Beaglebone és una [https://en.wikipedia.org/wiki/Single-board_computera SBC] amb un procesador ARM i diverses interfícies d'entrada-sortida. És per això que s'ha d...».</p>
<hr />
<div>Beaglebone és una [https://en.wikipedia.org/wiki/Single-board_computera SBC] amb un procesador ARM i diverses interfícies d'entrada-sortida. És per això que s'ha de fer servir un sistema operatiu preparat per funcionar en aquesta arquitectura i amb els controladors ''(drivers)'' corresponents per a fer funcionar aquestes interfícies.<br />
<br />
''Nota: aquesta guia s'ha fet amb la distribució Ubuntu, però és possible que amb una altra distribució basada en Debian funcioni amb els mateixos passos.''<br />
<br />
<br />
<br />
== Instal·lar el sistema ==<br />
<br />
* Inserir la targeta microSD en l'ordinador i observar què dispositiu s'enregistra teclejant <code>ls /dev/sd</code>. Si no n'estàs segur, elimina la targeta i l'entrada desapareixerà. Un cop sabut quin dispositiu correspon a la tarjeta seguir les següents instruccions reemplaçant <code>/dev/sdX</code> pel de la teva microSD en tu sistema.<br />
<br />
<br />
* Començar particionant la targeta microSD escrivint <code>fdisk /dev/sdX</code>.<br />
# Inicialitzar una nova taula de particions seleccionant <code>o</code>, després verifica que estigui buida seleccionant <code>p</code> ''(print)''.<br />
# Crear una partició d'arrencada ''(boot)'' seleccionant <code>n</code> ''(new)'', després <code>p</code> per a ''primary'', i <code>1</code> per a especificar la primera partició. Pulsar ''enter'' per a acceptar el primer sector per defecte i especifica <code>4095</code> per a l'últim sector.<br />
# Canviar el tipus de partició a FAT16 seleccionant <code>t</code> ''(type)'' o <code>e</code> per a ''‘W95 FAT16 (LBA)’''.<br />
# Marcar la partició com a arrencable selecionant <code>a</code> i després <code>1</code>.<br />
# Crear la partició de dades per al sistema de fitxers seleccionant <code>n</code> ''(new)'', després <code>1</code> ''(primary)'' i <code>2</code> per a especificar la segona partició. Acceptar els valors per defecte pel primer i últim sector polsant ''enter'' cada cop (x2).<br />
# Polsar <code>p</code> per a ‘imprimir’ la taula de particions.<br />
# Finalment, guardar els canvis seleccionant <code>w</code> per "escriure" ''(write)'' la taula de particions i sortir de ''fdisk''.<br />
<br />
<br />
* Formatejar les particions i instal·lar el sistema d'arrencada i el sistema arrel.<br />
# Formatejar la partició 1 com a FAT escribint <code>mkfs.vfat /dev/sdX1</code>.<br />
# Formatejar la partició 2 com a ext4 escribint <code>mkfs.ext4 /dev/sdX2</code>.<br />
# Instal·lar ''u-boot'' en la targeta microSD.<br />
wget http://s3.armhf.com/dist/bone/bone-uboot.tar.xz<br />
mkdir boot<br />
mount /dev/sdX1 boot<br />
tar xJvf bone-uboot.tar.xz -C boot<br />
umount boot<br />
# Instal·lar el sistema arrel de fitxers desitjat en la tarjeta microSD (Ubuntu Trusty en aquest exemple).<br />
wget http://s3.armhf.com/dist/bone/ubuntu-trusty-14.04-rootfs-3.14.4.1-bone-armhf.com.tar.xz<br />
mkdir rootfs<br />
mount /dev/sdX2 rootfs<br />
tar xJvf ubuntu-trusty-14.04-rootfs-3.14.4.1-bone-armhf.com.tar.xz -C rootfs<br />
umount rootfs<br />
<br />
<br />
La targeta microSD ja està llesta per a arrencar. Cal notar que per a aquesta instal·lació d'Ubuntu, l'userid de login és ''ubuntu'' i la contrassenya és ''ubuntu''.<br />
<br />
''Nota: la memòria cau de paquets ha sigut buidada per a reduir la mida de la imatge. Executa <code>apt-get update</code> després d'iniciar per a actualitzar la memòria cau de paquets, tot seguit executa <code>apt-get upgrade</code> per a instal·lar les actualitzacions.''<br />
<br />
<br />
<br />
== Instal·lar Cloudy ==<br />
<br />
Per instal·lar Cloudy pots seguir les instrucciones per a [[Cloudy_en_Debian|convertir una instal·lación bàsica de Debian en Cloudy]] afegint al sistema els arxius i eines específiques de la distribució.<br />
<br />
Ho anomenem "cloudynizar".<br />
<br />
Recomanem utilitzar un script per a automatitzar el procés. Pots saber com en la [[cloudynitzar|pàgina d'aquesta wiki que explica com "cloudynitzar"]].<br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_Raspberry_PiCloudy Raspberry Pi2015-09-10T18:03:03Z<p>Conxuro: </p>
<hr />
<div>La Raspberry Pi és un petit i econòmic ordinador del tamany d'una tarjeta de crèdit, creat principalment per ser utilitzada amb fins educatius i de petits projectes.<br />
<br />
Aquesta placa té un processador ARM i diverses interfícies d'entrada-sortida; vídeo, audio, Ethernet, USB, GPIO, etc. És per això que s'ha de fer servir un sistema operatiu preparat per funcionar en aquesta arquitectura i amb els controladors (''drivers'') corresponents per a fer funcionar aquestes interfícies.<br />
<br />
En el nostre cas, per instal·lar Cloudy es prepararà la Raspberry Pi amb una distribució ja adaptada basada en Debian com es Raspbian, i un cop fet això es "cloudynitzarà" per afegir tot el contigut propi de Cloudy.<br />
<br />
<br />
'''''Nota:''' Aquesta guia, així com diverses proves d'instal·lació de Cloudy, s'ha fet amb el S.O. Raspbian; però es possible que amb una altra distribució basada en Debian funcioni amb els mateixos passos.''<br />
<br />
<br />
<br />
== Descarregar Raspbian ==<br />
<br />
Anem a la [https://www.raspberrypi.org/downloads/ pàgina oficial] i descarreguem la imatge ISO del sistema operatiu que ens servirà de base.<br />
<br />
Alternativament es pot utilitzar una variant de Raspbian, la [http://sirlagz.net/2013/07/19/raspbian-server-edition-2-5/ Raspbian Server Edition], que està preparada sense paquets innecessaris (sistema gràfic, audio, etc.) per a l'us de la Raspberry Pi com a servidor.<br />
<br />
<br />
<br />
== Instal·lar i configurar Raspbian ==<br />
<br />
Gravem la imatge a una tarjeta de memòria SD. Segons el sistema operatiu del teu ordinador pots seguir una d'aquestes guies (en anglès) per gravar imatges ISO.<br />
<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/linux.md Linux]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/mac.md Mac OS]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/windows.md Windows]<br />
<br />
A continuació instertem la tarjeta i encenem la placa per a començar el procés de configuració amb l'eina <code>raspi-config</code>.<br />
<br />
Bàsicament el que es recomana fer és:<br />
# Expandir el sistema de fitxers per utilitzar tot l'espai de la SD.<br />
# Canviar la contrassenya de l'usuari '''pi''' (per defecte).<br />
# Canviar la localització si volem un altra idioma, l'ús horari (''timezone'') i el mapa de teclat.<br />
# En opcions avançades; activar el servidor SSH, canviar el ''hostname'' i actualitzar la <code>raspi-config</code>.<br />
<br />
Si vols fer més canvis, pots trobar més informació a la [https://www.raspberrypi.org/documentation/configuration/raspi-config.md documentació de raspi-config].<br />
<br />
No ens estendrem més en explicar com s'instal·la i configura Raspbian ja que està ampliament documentat a Internet.<br />
<br />
=== Opcions addicionals ===<br />
<br />
Com s'ha comentat abans, hi ha una versió personalitzada per a funcionar com a servidor, que elimina paquets innecessaris. Aquesta hauria de funcionar igual que la Raspbian original, però es més recomanable fer aquesta adaptació després de manera manual o automatitzant-ho amb l'''script'' que desinstal·la els paquets per a deixar el sistema com a la Raspbian Server Edition.<br />
<br />
Podeu obtenir més informació i descarregar aquest ''script'' a [http://sirlagz.net/2013/08/03/raspbian-server-edition-scripts/ la següent pàgina].<br />
<br />
<br />
<br />
== Instal·lar Cloudy ==<br />
<br />
Per instal·lar Cloudy pots seguir les instrucciones per a [[Cloudy_en_Debian|convertir una instal·lación bàsica de Debian en Cloudy]] afegint al sistema els arxius i eines específiques de la distribució.<br />
<br />
Ho anomenem "cloudynizar".<br />
<br />
Recomanem utilitzar un script per a automatitzar el procés. Pots saber com en la [[cloudynitzar|pàgina d'aquesta wiki que explica com "cloudynitzar"]].<br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_en_DebianCloudy en Debian2015-09-10T17:47:12Z<p>Conxuro: Es crea la pàgina amb «Pots convertir una instal·lació bàsica de Debian en Cloudy tot seguint aquests passos: 1. Entrar via SSH com a usuari root (o un cop fet login) o executa les seg...».</p>
<hr />
<div>Pots convertir una instal·lació bàsica de Debian en Cloudy tot seguint aquests passos:<br />
<br />
<br />
1. Entrar via SSH com a usuari root (o un cop fet login) o executa les següents comandes amb l'eina ''sudo''.<br />
<br />
<br />
2. Actualitzar la data del servidor instal·lant un client NTP ''(opcional)''.<br />
<br />
apt-get install ntp<br />
<br />
<br />
3. Afegir els backports de Debian, i els repositoris de Clommunity i Guifi.<br />
* Backports de Debian:<br />
echo "deb http://ftp.debian.org/debian wheezy-backports main contrib" > /etc/apt/sources.list.d/backports.list <br />
* Repositori de Clommunity:<br />
echo "deb http://repo.clommunity-project.eu/debian unstable/" > /etc/apt/sources.list.d/cloudy.list <br />
gpg --keyserver pgpkeys.mit.edu --recv-key A59C5DC8 && gpg --export --armor A59C5DC8 | apt-key add - <br />
* Repositori de Guifi:<br />
echo "deb http://serveis.guifi.net/debian guifi/" > /etc/apt/sources.list.d/serveis.list <br />
gpg --keyserver pgpkeys.mit.edu --recv-key 2E484DAB && gpg --export --armor 2E484DAB | apt-key add -<br />
<br />
<br />
4. Instal·lar alguns paquets de Debian.<br />
apt-get update<br />
apt-get upgrade<br />
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 <br />
<br />
'''''Nota''': si surt aquest 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" utilitza aquesta comanda:<br />
apt-get --allow-unauthenticated upgrade<br />
''<br />
<br />
<br />
5. Instal·lar els paquets ''"non-Debian"'' de Cloudy.<br />
curl "https://raw.githubusercontent.com/Clommunity/lbmake/master/hooks/getinconf-client.chroot" | sh -<br />
curl "https://raw.githubusercontent.com/Clommunity/lbmake/master/hooks/avahi-ps.chroot" | sh -<br />
curl "https://raw.githubusercontent.com/Clommunity/lbmake/master/hooks/cDistro.chroot" | sh -<br />
<br />
<br />
g. Reiniciar.<br />
<br />
Després d'això, podràs entrar-hi a la interfície web d'usuari en http://IP_dispositiu:7000<br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_Raspberry_PICloudy Raspberry PI2015-07-22T01:00:53Z<p>Conxuro: Redirecció a Cloudy Raspberry Pi</p>
<hr />
<div>#REDIRECT [[Cloudy_Raspberry_Pi]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_Raspberry_PiCloudy Raspberry Pi2015-07-21T23:23:15Z<p>Conxuro: </p>
<hr />
<div>La Raspberry Pi és un petit i econòmic ordinador del tamany d'una tarjeta de crèdit, creat principalment per ser utilitzada amb fins educatius i de petits projectes.<br />
<br />
Aquesta placa té un processador ARM i diverses interfícies d'entrada-sortida; vídeo, audio, Ethernet, USB, GPIO, etc. És per això que s'ha de fer servir un sistema operatiu preparat per funcionar en aquesta arquitectura i amb els controladors (''drivers'') corresponents per a fer funcionar aquestes interfícies.<br />
<br />
En el nostre cas, per instal·lar Cloudy es prepararà la Raspberry Pi amb una distribució ja adaptada basada en Debian com es Raspbian, i un cop fet això es "cloudynitzarà" per afegir tot el contigut propi de Cloudy.<br />
<br />
<br />
'''''Nota:''' Aquesta guia, així com diverses proves d'instal·lació de Cloudy, s'ha fet amb el S.O. Raspbian; però es possible que amb una altra distribució basada en Debian funcioni amb els mateixos passos.''<br />
<br />
<br />
<br />
== Descarregar Raspbian ==<br />
<br />
Anem a la [https://www.raspberrypi.org/downloads/ pàgina oficial] i descarreguem la imatge ISO del sistema operatiu que ens servirà de base.<br />
<br />
Alternativament es pot utilitzar una variant de Raspbian, la [http://sirlagz.net/2013/07/19/raspbian-server-edition-2-5/ Raspbian Server Edition], que està preparada sense paquets innecessaris (sistema gràfic, audio, etc.) per a l'us de la Raspberry Pi com a servidor.<br />
<br />
<br />
<br />
== Instal·lar i configurar Raspbian ==<br />
<br />
Gravem la imatge a una tarjeta de memòria SD. Segons el sistema operatiu del teu ordinador pots seguir una d'aquestes guies (en anglès) per gravar imatges ISO.<br />
<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/linux.md Linux]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/mac.md Mac OS]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/windows.md Windows]<br />
<br />
A continuació instertem la tarjeta i encenem la placa per a començar el procés de configuració amb l'eina <code>raspi-config</code>.<br />
<br />
Bàsicament el que es recomana fer és:<br />
# Expandir el sistema de fitxers per utilitzar tot l'espai de la SD.<br />
# Canviar la contrassenya de l'usuari '''pi''' (per defecte).<br />
# Canviar la localització si volem un altra idioma, l'ús horari (''timezone'') i el mapa de teclat.<br />
# En opcions avançades; activar el servidor SSH, canviar el ''hostname'' i actualitzar la <code>raspi-config</code>.<br />
<br />
Si vols fer més canvis, pots trobar més informació a la [https://www.raspberrypi.org/documentation/configuration/raspi-config.md documentació de raspi-config].<br />
<br />
No ens estendrem més en explicar com s'instal·la i configura Raspbian ja que està ampliament documentat a Internet.<br />
<br />
=== Opcions addicionals ===<br />
<br />
Com s'ha comentat abans, hi ha una versió personalitzada per a funcionar com a servidor, que elimina paquets innecessaris. Aquesta hauria de funcionar igual que la Raspbian original, però es més recomanable fer aquesta adaptació després de manera manual o automatitzant-ho amb l'''script'' que desinstal·la els paquets per a deixar el sistema com a la Raspbian Server Edition.<br />
<br />
Podeu obtenir més informació i descarregar aquest ''script'' a [http://sirlagz.net/2013/08/03/raspbian-server-edition-scripts/ la següent pàgina].<br />
<br />
<br />
<br />
== Instal·lar Cloudy ==<br />
<br />
Per instal·lar Cloudy el que fem és "cloudynitzar" el sistema per afegir els fitxers i eines propis de la distribució Cloudy.<br />
<br />
Per fer això, podeu seguir les instruccions de la [[cloudynitzar|pàgina d'aquesta wiki que explica com cloudynitzar un sistema Debian]].<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_Raspberry_PiCloudy Raspberry Pi2015-07-21T23:21:42Z<p>Conxuro: </p>
<hr />
<div>La Raspberry Pi és un petit i econòmic ordinador del tamany d'una tarja de crèdit, creat principalment per ser utilitzada amb fins educatius i de petits projectes.<br />
<br />
Aquesta placa té un processador ARM i diverses interfícies d'entrada-sortida; vídeo, audio, Ethernet, USB, GPIO, etc. És per això que s'ha de fer servir un sistema operatiu preparat per funcionar en aquesta arquitectura i amb els controladors (''drivers'') corresponents per a fer funcionar aquestes interfícies.<br />
<br />
En el nostre cas, per instal·lar Cloudy es prepararà la Raspberry Pi amb una distribució ja adaptada basada en Debian com es Raspbian, i un cop fet això es "cloudynitzarà" per afegir tot el contigut propi de Cloudy.<br />
<br />
<br />
'''''Nota:''' Aquesta guia, així com diverses proves d'instal·lació de Cloudy, s'ha fet amb el S.O. Raspbian; però es possible que amb una altra distribució basada en Debian funcioni amb els mateixos passos.''<br />
<br />
<br />
<br />
== Descarregar Raspbian ==<br />
<br />
Anem a la [https://www.raspberrypi.org/downloads/ pàgina oficial] i descarreguem la imatge ISO del sistema operatiu que ens servirà de base.<br />
<br />
Alternativament es pot utilitzar una variant de Raspbian, la [http://sirlagz.net/2013/07/19/raspbian-server-edition-2-5/ Raspbian Server Edition], que està preparada sense paquets innecessaris (sistema gràfic, audio, etc.) per a l'us de la Raspberry Pi com a servidor.<br />
<br />
<br />
<br />
== Instal·lar i configurar Raspbian ==<br />
<br />
Gravem la imatge a una tarjeta de memòria SD. Segons el sistema operatiu del teu ordinador pots seguir una d'aquestes guies (en anglès) per gravar imatges ISO.<br />
<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/linux.md Linux]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/mac.md Mac OS]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/windows.md Windows]<br />
<br />
A continuació instertem la tarjeta i encenem la placa per a començar el procés de configuració amb l'eina <code>raspi-config</code>.<br />
<br />
Bàsicament el que es recomana fer és:<br />
# Expandir el sistema de fitxers per utilitzar tot l'espai de la SD.<br />
# Canviar la contrassenya de l'usuari '''pi''' (per defecte).<br />
# Canviar la localització si volem un altra idioma, l'ús horari (''timezone'') i el mapa de teclat.<br />
# En opcions avançades; activar el servidor SSH, canviar el ''hostname'' i actualitzar la <code>raspi-config</code>.<br />
<br />
Si vols fer més canvis, pots trobar més informació a la [https://www.raspberrypi.org/documentation/configuration/raspi-config.md documentació de raspi-config].<br />
<br />
No ens estendrem més en explicar com s'instal·la i configura Raspbian ja que està ampliament documentat a Internet.<br />
<br />
=== Opcions addicionals ===<br />
<br />
Com s'ha comentat abans, hi ha una versió personalitzada per a funcionar com a servidor, que elimina paquets innecessaris. Aquesta hauria de funcionar igual que la Raspbian original, però es més recomanable fer aquesta adaptació després de manera manual o automatitzant-ho amb l'''script'' que desinstal·la els paquets per a deixar el sistema com a la Raspbian Server Edition.<br />
<br />
Podeu obtenir més informació i descarregar aquest ''script'' a [http://sirlagz.net/2013/08/03/raspbian-server-edition-scripts/ la següent pàgina].<br />
<br />
<br />
<br />
== Instal·lar Cloudy ==<br />
<br />
Per instal·lar Cloudy el que fem és "cloudynitzar" el sistema per afegir els fitxers i eines propis de la distribució Cloudy.<br />
<br />
Per fer això, podeu seguir les instruccions de la [[cloudynitzar|pàgina d'aquesta wiki que explica com cloudynitzar un sistema Debian]].<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_Raspberry_PiCloudy Raspberry Pi2015-07-21T23:20:32Z<p>Conxuro: </p>
<hr />
<div>La Raspberry Pi és un petit i econòmic ordinador del tamany d'una tarja de crèdit, creat principalment per ser utilitzada amb fins educatius i de petits projectes.<br />
<br />
Aquesta placa té un processador ARM i diverses interfícies d'entrada-sortida; vídeo, audio, Ethernet, USB, GPIO, etc. És per això que s'ha de fer servir un sistema operatiu preparat per funcionar en aquesta arquitectura i amb els controladors (''drivers'') corresponents per a fer funcionar aquestes interfícies.<br />
<br />
En el nostre cas, per instal·lar Cloudy es prepararà la Raspberry Pi amb una distribució ja adaptada basada en Debian com es Raspbian, i un cop fet això es "cloudinitzarà" per afegir tot el contigut propi de Cloudy.<br />
<br />
<br />
'''''Nota:''' Aquesta guia, així com diverses proves d'instal·lació de Cloudy, s'ha fet amb el S.O. Raspbian; però es possible que amb una altra distribució basada en Debian funcioni amb els mateixos passos.''<br />
<br />
<br />
<br />
== Descarregar Raspbian ==<br />
<br />
Anem a la [https://www.raspberrypi.org/downloads/ pàgina oficial] i descarreguem la imatge ISO del sistema operatiu que ens servirà de base.<br />
<br />
Alternativament es pot utilitzar una variant de Raspbian, la [http://sirlagz.net/2013/07/19/raspbian-server-edition-2-5/ Raspbian Server Edition], que està preparada sense paquets innecessaris (sistema gràfic, audio, etc.) per a l'us de la Raspberry Pi com a servidor.<br />
<br />
<br />
<br />
== Instal·lar i configurar Raspbian ==<br />
<br />
Gravem la imatge a una tarjeta de memòria SD. Segons el sistema operatiu del teu ordinador pots seguir una d'aquestes guies (en anglès) per gravar imatges ISO.<br />
<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/linux.md Linux]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/mac.md Mac OS]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/windows.md Windows]<br />
<br />
A continuació instertem la tarjeta i encenem la placa per a començar el procés de configuració amb l'eina <code>raspi-config</code>.<br />
<br />
Bàsicament el que es recomana fer és:<br />
# Expandir el sistema de fitxers per utilitzar tot l'espai de la SD.<br />
# Canviar la contrassenya de l'usuari '''pi''' (per defecte).<br />
# Canviar la localització si volem un altra idioma, l'ús horari (''timezone'') i el mapa de teclat.<br />
# En opcions avançades; activar el servidor SSH, canviar el ''hostname'' i actualitzar la <code>raspi-config</code>.<br />
<br />
Si vols fer més canvis, pots trobar més informació a la [https://www.raspberrypi.org/documentation/configuration/raspi-config.md documentació de raspi-config].<br />
<br />
No ens estendrem més en explicar com s'instal·la i configura Raspbian ja que està ampliament documentat a Internet.<br />
<br />
=== Opcions addicionals ===<br />
<br />
Com s'ha comentat abans, hi ha una versió personalitzada per a funcionar com a servidor, que elimina paquets innecessaris. Aquesta hauria de funcionar igual que la Raspbian original, però es més recomanable fer aquesta adaptació després de manera manual o automatitzant-ho amb l'''script'' que desinstal·la els paquets per a deixar el sistema com a la Raspbian Server Edition.<br />
<br />
Podeu obtenir més informació i descarregar aquest ''script'' a [http://sirlagz.net/2013/08/03/raspbian-server-edition-scripts/ la següent pàgina].<br />
<br />
<br />
<br />
== Instal·lar Cloudy ==<br />
<br />
Per instal·lar Cloudy el que fem és "cloudinitzar" el sistema per afegir els fitxers i eines propis de la distribució Cloudy.<br />
<br />
Per fer això, podeu seguir les instruccions de la [[cloudinitzar|pàgina d'aquesta wiki que explica com cloudinitzar un sistema Debian]].<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_Raspberry_PiCloudy Raspberry Pi2015-07-21T19:44:08Z<p>Conxuro: Es crea la pàgina amb «La Raspberry Pi és un petit i econòmic ordinador del tamany d'una tarja de crèdit, creat principalment per a fins educatius i de petits projectes. Aquesta placa t...».</p>
<hr />
<div>La Raspberry Pi és un petit i econòmic ordinador del tamany d'una tarja de crèdit, creat principalment per a fins educatius i de petits projectes.<br />
<br />
Aquesta placa té un processador ARM i diverses interfícies d'entrada-sortida; vídeo, audio, Ethernet, USB, GPIO, etc. És per això que s'ha de fer servir un sistema operatiu preparat per funcionar amb aquesta arquitectura i amb els drivers corresponents per a fer funcionar aquestes interfícies.<br />
<br />
En el nostre cas, per instal·lar Cloudy es prepararà la Raspberry Pi amb una distribució ja adaptada basada en Debian com es Raspbian, i un cop fet això es "cloudinitzarà" per afegir tot el contigut propi de Cloudy.<br />
<br />
<br />
'''''Nota:''' Aquesta guia així com diverses proves d'instal·lació de Cloudy s'ha fet amb el S.O. Raspbian, però es possible que amb una altra distribució basada en Debian funcioni amb els mateixos passos.''<br />
<br />
<br />
== Descarregar Raspbian ==<br />
<br />
<br />
Anem a la [https://www.raspberrypi.org/downloads/ pàgina oficial] i descarreguem la imatge ISO del sistema operatiu que ens servirà de base.<br />
<br />
Alternativament es pot utilitzar una variant de Raspbian, la [http://sirlagz.net/2013/07/19/raspbian-server-edition-2-5/ Raspbian Server Edition], que està preparada sense paquets innecessaris (sistema gràfic, audio, etc.) per a l'us de la Raspberry Pi com a servidor.<br />
<br />
<br />
<br />
== Instal·lar i configurar Raspbian ==<br />
<br />
Gravarem la imatge a una tarja de memòria SD. Segons el sistema operatiu del teu ordinador pots seguir una d'aquestes guies per gravar imatges ISO.<br />
<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/linux.md Linux]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/mac.md Mac OS]<br />
* [http://www.raspberrypi.org/documentation/installation/installing-images/windows.md Windows]<br />
<br />
A continuació instertem la tarjeta i encendrem la placa per començar el procés de configuració amb l'eina <code>raspi-config</code>.<br />
<br />
Bàsicament el que es recomanable fer es:<br />
# Expandir el sistema de fitxers per utilitzar tot l'espai de la SD.<br />
# Canviar la contrassenya de l'usuari '''pi''' (per defecte).<br />
# Canviar la localització si volem un altra idioma, l'ús horari (''timezone'') i el mapa de teclat.<br />
# En opcions avançades; activar el servidor SSH, canviar el ''hostname'' i actualitzar la <code>raspi-config</code>.<br />
<br />
Si vols fer més canvis, pots trobar més informació a la [https://www.raspberrypi.org/documentation/configuration/raspi-config.md documentació de raspi-config].<br />
<br />
No ens estendrem molt més en explicar com s'instal·la i configura Raspbian ja que està ampliament documentat a Internet.<br />
<br />
<br />
=== Opcions addicionals ===<br />
<br />
Com s'ha comentat abans, hi ha una versió personalitzada per a funcionar com a servidor, que elimina paquets innecessaris. Aquesta hauria de funcionar igual que la Raspbian original, però es més recomanable fer aquesta adaptació després de manera manual o automatitzant-ho amb l'script que desinstal·la els paquets per a deixar el sistema com a la Raspbian Server Edition.<br />
<br />
Podeu obtenir més informació i descarregar aquest script a [http://sirlagz.net/2013/08/03/raspbian-server-edition-scripts/ la següent pàgina].<br />
<br />
<br />
<br />
== Instal·lar Cloudy ==<br />
<br />
Per instal·lar Cloudy el que fem és "cloudinitzar" el sistema per afegir els fitxers i eines propis de la distribució Cloudy.<br />
<br />
Per fer això podeu seguir les instruccions de la [[cloudinitzar|pàgina d'aquesta wiki que explica com cloudinitzar un sistema Debian]].<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_en_node_clientCloudy en node client2015-07-17T15:38:37Z<p>Conxuro: </p>
<hr />
<div>Cloudy utilitza un sistema de publicació i cerca de serveis per a compartir-los amb altres Cloudys. Per a fer això actualment es fa servir [https://www.serfdom.io/ Serf].<br />
<br />
Aquest programari obre un port TCP al servidor (Cloudy) per a escoltar peticions i poder communicar-se amb altres.<br />
<br />
Per tant, per a que un Cloudy instal·lat en un node client pugui interactuar amb els altres Cloudys cal fer alguns passos addicionals:<br />
<br />
<br />
1. Saber l'adreça IP pública del node (10.x.x.x); no la IP assignada al Cloudy sinó la IP assignada al node client.<br />
* Podeu anar a la pàgina de [http://guifi.net Guifi] del vostre node per a saber quina és la IP d'aquest.<br />
<br />
<br />
2. Modificar un parell de fitxers i declarar la IP pública del node. Heu d'afegir la IP als fitxers de configuració per tal de que el programari pugui anunciar correctament la IP pública i no la privada.<br />
* Per fer-ho, amb l'usuari '''''root''''', entreu per línia de comandes el següent:<br />
<pre><br />
root@cloudy:~# echo "ADVERTISE_IP=10.x.x.x" >> /etc/avahi-ps-serf.conf<br />
root@cloudy:~# echo "PUBLIC_IP=10.x.x.x" >> /etc/getinconf-client.conf<br />
root@cloudy:~# /etc/init.d/serf restart<br />
<br />
(on 10.x.x.x és la IP pública del vostre node.)<br />
</pre><br />
<br />
'''Exemple:'''<br />
A un node amb adreça IP 10.1.2.3 els fitxers haurien de ser com:<br />
<pre><br />
/etc/avahi-ps-serf.conf<br />
SERF_RPC_ADDR=127.0.0.1:7373<br />
SERF_BIND=5000<br />
SERF_JOIN=10.139.40.82:5000<br />
ADVERTISE_IP=10.1.2.3<br />
<br />
/etc/getinconf-client.conf <br />
#!/bin/sh<br />
# Automatically generate file<br />
GTC_SERVER_URL=http://10.139.40.84/index.php<br />
NETWORK_NAME=demo<br />
NETWORK_KEY=demo<br />
INTERNAL_DEV=eth0<br />
# PORT=665<br />
# GETINCONF_IGNORE=1<br />
GETINCONF_IGNORE=1<br />
PUBLIC_IP=10.1.2.3<br />
</pre><br />
<br />
<br />
3. Fer una redirecció (''port forwarding'') del port 5000 (''Serf'') al node. I si voleu tenir més serveis haureu de redireccionar el port de cadascun d'aquests.<br />
* La configuració per fer això dependrà del dispositiu que tingueu.<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_en_node_clientCloudy en node client2015-07-17T15:27:34Z<p>Conxuro: Es crea la pàgina amb «Cloudy utilitza un sistema de publicació i cerca de serveis per a compartir-los amb altres Cloudys. Per a fer això actualment es fa servir Serf.<ref name="Serf">(htt...».</p>
<hr />
<div>Cloudy utilitza un sistema de publicació i cerca de serveis per a compartir-los amb altres Cloudys. Per a fer això actualment es fa servir Serf.<ref name="Serf">(https://www.serfdom.io/)</ref><br />
<br />
Aquest programari obre un port TCP al servidor (Cloudy) per a escoltar peticions i poder communicar-se amb altres.<br />
<br />
Per tant, per a que un Cloudy instal·lat en un node client pugui interactuar amb els altres Cloudys cal fer alguns passos addicionals:<br />
<br />
<br />
1. Saber l'adreça IP pública del node (10.x.x.x); no la IP assignada al Cloudy sinó la IP assignada al node client.<br />
* Podeu anar a la [http://guifi.net pàgina de Guifi] del vostre node per a saber quina és la IP d'aquest.<br />
<br />
<br />
2. Modificar un parell de fitxers i declarar la IP pública del node. Heu d'afegir la IP als fitxers de configuració per tal de que el programari pugui anunciar correctament la IP pública i no la privada.<br />
* Per fer-ho, amb l'usuari '''''root''''' entreu per línia de comandes el següent:<br />
<pre><br />
root@cloudy:~# echo "ADVERTISE_IP=10.x.x.x" >> /etc/avahi-ps-serf.conf<br />
root@cloudy:~# echo "PUBLIC_IP=10.x.x.x" >> /etc/getinconf-client.conf<br />
root@cloudy:~# /etc/init.d/serf restart<br />
<br />
(on 10.x.x.x => és la IP pública del vostre node.)<br />
</pre><br />
<br />
'''Exemple:'''<br />
A un node amb adreça IP 10.1.2.3 els fitxers haurien de ser com:<br />
<pre><br />
/etc/avahi-ps-serf.conf<br />
SERF_RPC_ADDR=127.0.0.1:7373<br />
SERF_BIND=5000<br />
SERF_JOIN=10.139.40.82:5000<br />
ADVERTISE_IP=10.1.2.3<br />
<br />
/etc/getinconf-client.conf <br />
#!/bin/sh<br />
# Automatically generate file<br />
GTC_SERVER_URL=http://10.139.40.84/index.php<br />
NETWORK_NAME=demo<br />
NETWORK_KEY=demo<br />
INTERNAL_DEV=eth0<br />
# PORT=665<br />
# GETINCONF_IGNORE=1<br />
GETINCONF_IGNORE=1<br />
PUBLIC_IP=10.1.2.3<br />
</pre><br />
<br />
<br />
3. Fer una redirecció (''port forwarding'') del port 5000 (''Serf'') al node. I si voleu tenir més serveis haureu de redireccionar el port de cadascun d'aquests.<br />
* La configuració per fer això dependrà del dispositiu que tingueu.<br />
<br />
<br />
== References ==<br />
<br />
<references/></div>Conxurohttp://ca.wiki.guifi.net/wiki/PortadaPortada2015-05-27T13:07:09Z<p>Conxuro: </p>
<hr />
<div>__NOTITLE__<br />
{| style="background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em; width:100%;"<br />
| valign="top" style="padding:12px 17px 5px 17px" |<br />
'''Guifi.net''' és de tothom, participa-hi [[connectar|connectant]] el teu [[tram de xarxa]] amb el dels altres.<br />
<br />
És un projecte col·laboratiu [[organització horitzontal|organitzat horitzontalment]] que agrupa tan a persones individuals, col·lectius, empreses i administracions.<br />
<br />
És obert i per tant tothom hi pot participar en igualtat de condicions en el marc del [http://guifi.net/ComunsXOLN Comuns de la Xarxa Oberta, Lliure i Neutral]<br />
<div style=" text-align: right">[[Guifi.net|Més sobre Guifi.net]]</div><br />
{| style="width:100%; background:#f6f6f6"<br />
| 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;">Benvinguda al wiki de '''Guifi.net'''</div><br />
<div style="font-size: 95%;">Documentació sobre la xarxa oberta, lliure i neutral.</div><br />
<div style="font-size: 85%;">En aquests moments tenim [[Especial:Estadístiques|{{NUMBEROFARTICLES}}]] [[Especial:Llista_de_pàgines|articles]] en català.</div><br />
<div style="font-size: 85%;">Ajuda [[Què és un wiki#Categories|categoritzant]] un dels [[Especial:Pàgines_sense_categoria|articles sense categoritzar]], pots fer servir les [[Especial:Categories|categories ja existents]].</div><br />
</div><br />
|}<br />
{| style="background:#f6f6f6; width:100%;"<br />
|''A la documentació de guifi.net hi ha els documents de referència per a usuaris novells, experimentats i desenvolupadors. Sigues lliure [[Què és un wiki|d'editar aquest wiki]] per millorar-ne el seu contingut.''<br />
<div style=" text-align: center">Contacta: [http://guifi.net/forum Fòrums] '''|''' [http://llistes.guifi.net Llistes de correu] '''|''' [http://guifi.net/xat Xat]</div><br />
|}<br />
|}<br />
<br />
<br />
{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"<br />
| 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;" | <br />
<br />
<div id="mp-tfa"><!--Selector per a [[meta:Mobile]]--><br />
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"<br />
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Com unir-se a Guifi.net<br />
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" | <br />
|-<br />
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;"><br />
<br />
* [[tres passos|Com donar d'alta i enllaçar un node]]<br />
* [[Escull el material]]<br />
* [[Configura el teu ordinador]]<br />
* [http://guifi.net/ca/BonesPractiques Bones pràctiques]<br />
<br />
|}</div><br />
<br />
| style="border:1px solid transparent;" |<br />
| 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; " | <br />
<div id="mp-itn"><br />
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"<br />
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodes i illes<br />
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" | <br />
|-<br />
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;"><br />
* [[Començar una illa des de 0]]<br />
* [[Crear un supernode]]<br />
* [http://guifi.net/ca/BonesPractiques Bones pràctiques]</div></div><br />
|}</div><br />
|}<br />
<br />
{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"<br />
| 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; " | <br />
<div id="mp-dyk"><br />
<br />
<div style="float:right;">__TOC__</div><br />
== [[Legal]] ==<br />
* [[Particulars]]<br />
* [[Institucions]]<br />
* [[Empreses]]<br />
* [[Serveis_General]]<br />
* [[Associació|Constitució d'una associació]]<br />
<br />
== Finançament ==<br />
* [[Models de finançament]]<br />
<br />
== Xarxa ==<br />
=== Els bàsics a la web ===<br />
* [[Zona|Crear i modificar una zona]]<br />
* [[Afegir_un_node_de_guifi.net|Afegir un node de guifi.net]]<br />
* [[Serveis|Crear serveis i vincular-los als servidors]]<br />
* [[Usuaris dels Proxys Federats]]<br />
* [[Eines|Eines (localització de IPs i MACs, estadístiques, mapes d'enrutament, etc.)]]<br />
<br />
=== Infraestructura ===<br />
{{div col|cols=2}}<br />
* [[Crear_un_supernode|Muntatge de supernodes]]<br />
* [[Filtres de xarxes]]<br />
* [[Enllaços virtuals]]<br />
* [[Node frontera amb qMp]]<br />
* [[Hotspot]]<br />
* [[Eina per buscar rangs de IPs lliures]]<br />
* [[Creació de túnels PPTP (Debian/dd-wrt/Mikrotik)]]<br />
* [[PPTP_airos|Tunel PPTP desde antena AirOS]]<br />
* [[Script per detectar problemes de latència]]<br />
* [[Tweaks antenes]]<br />
* [[Fibra_òptica|Fibra Òptica]]<br />
* [[Gestio_vlans_ubnt_supernode|Vlan de gestió ubnt en supernode híbrid]]<br />
* [[Toughswitch_supernode_hibrid|Gestió supernode híbrid amb vlan i toughswitch]]<br />
* [[Fer_bonding_de_dues_ADSL_amb_Routerboard|Fer bonding de dues ADSL amb una Routerboard]]<br />
* [[Calcul_RF|Càlculs RF]]<br />
{{div end}}<br />
<br />
=== Mesh ===<br />
* [[Obrir_xarxes_tipus_mesh_a_trav%C3%A9s_de_Guifi.net|Crear una xarxa Mesh en Guifi.net]]<br />
* [[Connectar-se_a_una_xarxa_mesh|Connectar-se a una xarxa Mesh de Guifi.net]]<br />
* [[Annex:subxarxes_mesh|Llistat de les xarxes Mesh]]<br />
* [[Quick Mesh Project (qMp)]] ([[:es:Quick Mesh Project|es]])<br />
* [[Alix+GSF|Configurar Àlix per connectar-se al núvol Mesh de gràcia amb gsffirm]] (antic) ([[:es:Alix|es]])<br />
* [[Altermesh]] (roaming mesh en Capa 2 amb BATMAN-adv) ([[:es:Altermesh|es]])<br />
* [[Mesh|Altres articles sobre Mesh]]<br />
<br />
=== Enrutaments i conceptes de xarxes ===<br />
{{div col|cols=2}}<br />
* [[Enrutament]] --General--<br />
* [[Peerings]]<br />
* [[Tunejant salts-BGP PREPEND ]]<br />
* [[Redundància BGP-OSPF-BGP ]] <br />
* [[Agregacions BGP ]]<br />
* [[Pesos BGP]]<br />
* [[BGP 2 AS en 1 AS]] (útil per a supernodes amb 2 mikrotiks)<br />
* [[IPv4]]<br />
* [[IPv6]]<br />
* [[Criteris d'assignació d'adreces IPv4]]<br />
* [[ARP]]<br />
* [[Cables_UTP|Cables UTP]]<br />
* [http://packetlife.net/library/cheat-sheets/ Resum de conceptes de xarxa]<br />
{{div end}}<br />
<br />
=== General ===<br />
{{div col|cols=2}}<br />
* [[Com es vertebra la xarxa: Troncal, punts d'accés i connexions simples]]<br />
* [[La seguretat a la xarxa oberta]]<br />
* [[Aplicacions | Aplicacions de Guifi.net]]<br />
* [[Recursos externs]]<br />
* [[Instal·lar firmware Ubiquiti Rocket M5]]<br />
{{div end}}<br />
<br />
== Sistemes ==<br />
=== Serveis bàsics ===<br />
{{div col|cols=2}}<br />
* [[Configurar Repositori apt guifi]]<br />
* [[Servidor Proxy]]<br />
* [[Servidor de gràfiques]]<br />
* [[Servidor DNS]]<br />
* [[Servidor Rellotge|Servidor de Rellotge (NTP)]]<br />
* [[Servidor logs remots rsyslogd ]]<br />
* [[Configurar xarxa]]<br />
{{div end}}<br />
<br />
=== Serveis de compartició de fitxers ===<br />
* [[Servidor FTP]]<br />
* [[Servidor Peer 2 Peer]]<br />
* [[Servidor DCC]]<br />
<br />
=== Serveis de missatgeria ===<br />
* [[Servidor de Correu]]<br />
* [[Webmail]]<br />
* [[Servidor Jabber]]<br />
* [[Servidor IRC]]<br />
* [[Mailman]]<br />
* [[Whatsapp]]<br />
<br />
=== Serveis de Veu i Vídeo ===<br />
* [[VoIP|Servidor de VeuIP (VoIP)]]<br />
* [[Servidor Radio Streaming]]<br />
<br />
=== Altres Serveis ===<br />
{{div col|cols=2}}<br />
* [[LDAP|Servidor LDAP]]<br />
* [[Apache|Servidor web Apache]]<br />
* [[Servidor Repositori Linux]]<br />
* [[Servidor Repositori Linux (Cache)]]<br />
* [[Servidor Iperf]]<br />
* [[Servidor repositori subversion]]<br />
* [[DHCP|Servidor DHCP]]<br />
* [[MySQL]] (Bases de Dades)<br />
* [[Proxmox]] (virtualització)<br />
* [[Cacti]] (monitoratge)<br />
* [[Servei de notificació d'incidencies]] (Servei de notificació d'incidencies)<br />
* [[Monitoratge_Cacti_UBNT|Cacti per a trastos UBNT]]<br />
* [[Clamav]] (antivirus amb GNU/Linux)<br />
* [[Trac]] (sistema de gestió de tiquets)<br />
* [[Squid]] (configuracions avançades squid)<br />
* [[PXE]] (Instal·lació per xarxa)<br />
* [http://www.example.com Observium] (Monitoratge molt gràfic, GPL)<br />
{{div end}}<br />
<br />
=== Sistema ===<br />
* [[ACPI]]<br />
* [[Bridges_amb_Linux|Bridges amb GNU/Linux]]<br />
* [[Chroot]]<br />
* [[Corkscrew]]<br />
* [[Túnel Proxy SOCKS]]<br />
* [[Manteniment_de_discs_durs|Manteniment de discs durs]]<br />
<br />
=== Cloudy ===<br />
* [[Què és Cloudy]]<br />
* [[Cloudy plug-ins]]<br />
* [[Cloudy|Altres articles sobre Cloudy]]<br />
<br />
== Instal·ladors ==<br />
* [[Parallamps]]<br />
* [[Reaprofitar el cable d'antena de televisió]]<br />
* [[Pressupostos]]<br />
* [[Utilitzar RB Mikrotik com a tunel PPPoE Movistar-Jazztel-altres]]<br />
* [http://guifi.net/ca/node/12486 Comunitat de veïns, cas d'exemple]<br />
* [[Configuració de l'antena per a les gràfiques (SNMP)]]<br />
* [[Campanars]]<br />
* [[Accesos Routerboards]] - Per a instal·ladors principiants<br />
* [[Administració senzilla usuari Guifi amb Routerboard Mikrotik]] - Per a instal·ladors principiants<br />
<br />
== Desenvolupadors ==<br />
* [[Manual editor wiki]]<br />
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]<br />
* [[Actualitzacions mòduls drupal]]<br />
* [http://gitorious.org/guifi Repositoris de codi del projecte guifi.net]<br />
* [[Mapa del codi]]<br />
* [[API de Guifi]]<br />
* [[CNML]]<br />
* [[Empotrar el mapa de Guifi-Google Maps a una web]]<br />
* [[Unsolclic]]<br />
* [[Preparant l'entorn de desenvolupament]]<br />
* [[:Categoria:router|Routers]]<br />
* [[:Categoria:Telefonia mòbil|Telefonia mòbil]]<br />
* [[Eficiència energètica]]<br />
<br />
== Dissenyadors ==<br />
* [[Logos]]<br />
* [[Maquetació de les diverses pàgines web]]<br />
* [[Usabilitat]]<br />
* [[Presentacions de guifi.net]]<br />
<br />
== Desenvolupament col·lectiu de la xarxa ==<br />
* [[Cursos]]<br />
* [[Necessitats]]<br />
<br />
== Camp de treball ==<br />
* [http://camp2012.guifi.net Bloc del camp de treball 'Internet per a tothom! Vic 2012]<br />
<br />
== Glossari ==<br />
* [[Recull de termes emprats habitualment]]<br />
* [[Guia Ràpida de Guifi.net]]<br />
* [[Preguntes Freqüents]]<br />
* [http://guifi.net/ca/CADocs Documents ubicats a la web de guifi.net] antiga "ComEsFa"<br />
|}<br />
<br />
= Accessos Ràpids =<br />
* [http://planet.guifi.net Planet]<br />
* [http://guifi.net/cxoln Comuns (Llicència de la xarxa)]<br />
* [http://guifi.net/maps Mapa guifi]<br />
* [[Webs Regionals]]<br />
* [http://trac.guifi.net Reporta Errors de la web]<br />
* [http://fundacio.guifi.net Fundació]<br />
* [http://guifi.net/ca/info Recull de guies i manuals]<br />
* [http://etherpad.guifi.net/serveris-de-guifi Llistat de serveis variats entorn al projecte]<br />
[[es:Portada]]<br />
[[en:Main Page]]<br />
[[eu:Azala]]<br />
[[fr:Accueil]]<br />
[[gl:Portada]]<br />
[[pt:Página principal]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_64bitsCloudy 64bits2015-05-13T13:59:14Z<p>Conxuro: </p>
<hr />
<div>Actualment només existeix generada la versió de 32 bits, no obstant pots crear la versió de 64 bits de la següent manera:<br />
<br />
Primer, descarrega el sistema de generació o "constructor" d'imatges ''(image builder)'':<br />
<br />
<pre><br />
apt-get install build-essential live-build imagemagick curl debootstrap git unzip <br />
git clone http://dev.cloudy.community/guifi.net/cloudy-image-builder.git<br />
</pre><br />
<br />
A continuació modifica les següents variables del fitxer ''Makefile'':<br />
<br />
<pre><br />
ARCH ?= amd64<br />
FLAVOUR ?= amd64<br />
</pre><br />
<br />
Finalment, pots generar la imatge amb la següent comanda:<br />
<br />
<pre>sudo make</pre><br />
<br />
Un cop la imatge ha estat creada, tindràs una versió Cloudy de 64 bits en <code>./devel/binary.hybrid.iso</code><br />
<br />
<br />
----<br />
<br />
<br />
Alternativament pots "Cloudynitzar" una Debian de 64 bits per convertir-la en Cloudy.<br />
<br />
Llegeix com en la página [[Cloudynitzar]] de la wiki.<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/CloudynitzarCloudynitzar2015-05-13T12:58:38Z<p>Conxuro: Es crea la pàgina amb «Una alternativa per instal·lar Cloudy és modificant un sistema Debian GNU/Linux, o basat en Debian, aplicant un ''script'' que converteix el sistema en un Cloudy. P...».</p>
<hr />
<div>Una alternativa per instal·lar Cloudy és modificant un sistema Debian GNU/Linux, o basat en Debian, aplicant un ''script'' que converteix el sistema en un Cloudy.<br />
<br />
Per fer-ho pots executar aquestes comanades:<br />
<br />
<pre><br />
git clone https://github.com/Clommunity/cloudynitzar && cd cloudynitzar<br />
chmod +x cloudynitzar.sh<br />
sudo ./cloudynitzar<br />
</pre><br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/CloudinitzarCloudinitzar2015-05-13T12:58:31Z<p>Conxuro: Redirecció a Cloudynitzar</p>
<hr />
<div>#REDIRECT [[Cloudynitzar]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/CloudinitzarCloudinitzar2015-05-13T12:54:50Z<p>Conxuro: Es crea la pàgina amb «Una alternativa per instal·lar Cloudy és modificant un sistema Debian GNU/Linux, o basat en Debian, aplicant un ''script'' que converteix el sistema en un Cloudy. P...».</p>
<hr />
<div>Una alternativa per instal·lar Cloudy és modificant un sistema Debian GNU/Linux, o basat en Debian, aplicant un ''script'' que converteix el sistema en un Cloudy.<br />
<br />
Per fer-ho pots executar aquestes comanades:<br />
<br />
<pre><br />
git clone https://github.com/Clommunity/cloudynitzar && cd cloudynitzar<br />
chmod +x cloudynitzar.sh<br />
sudo ./cloudynitzar<br />
</pre><br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_64bitsCloudy 64bits2015-05-13T12:38:14Z<p>Conxuro: </p>
<hr />
<div>Actualment només existeix generada la versió de 32 bits, no obstant pots crear la versió de 64 bits de la següent manera:<br />
<br />
Primer, descarrega el sistema de generació o "constructor" d'imatges ''(image builder)'':<br />
<br />
<pre><br />
apt-get install build-essential live-build imagemagick curl debootstrap git unzip <br />
git clone http://dev.cloudy.community/guifi.net/cloudy-image-builder.git<br />
</pre><br />
<br />
A continuació modifica les següents variables del fitxer ''Makefile'':<br />
<br />
<pre><br />
ARCH ?= amd64<br />
FLAVOUR ?= amd64<br />
</pre><br />
<br />
Finalment, pots generar la imatge amb la següent comanda:<br />
<br />
<pre>sudo make</pre><br />
<br />
Un cop la imatge ha estat creada, tindràs una versió Cloudy de 64 bits en <code>./devel/binary.hybrid.iso</code><br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_64bitsCloudy 64bits2015-05-13T12:34:35Z<p>Conxuro: Es crea la pàgina amb «Actualment només existeix generada la versió de 32 bits, no obstant pots crear la versió de 64 bits de la següent manera: Primer, descarrega el sistema de generac...».</p>
<hr />
<div>Actualment només existeix generada la versió de 32 bits, no obstant pots crear la versió de 64 bits de la següent manera:<br />
<br />
Primer, descarrega el sistema de generació o "constructor" d'imatges ''(image builder)'':<br />
<br />
<pre><br />
apt-get install build-essential live-build imagemagick curl debootstrap git unzip <br />
git clone http://dev.cloudy.community/guifi.net/cloudy-image-builder.git<br />
</pre><br />
<br />
<br />
A continuació modifica les següents variables del fitxer ''Makefile'':<br />
<br />
<pre><br />
ARCH ?= amd64<br />
FLAVOUR ?= amd64<br />
</pre><br />
<br />
<br />
Finalment, pots generar la image amb la següent comanda:<br />
<br />
<pre>sudo make</pre><br />
<br />
<br />
Un cop la imatge ha estat creada, tindràs una versió Cloudy de 64 bits en <code>./devel/binary.hybrid.iso</code><br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_web_UICloudy web UI2015-05-12T18:50:51Z<p>Conxuro: </p>
<hr />
<div><br />
== Introducció ==<br />
<br />
La inferfície d'usuari web (web User Interface (UI)) de Cloudy utilitza una aplicació anomenada cDistro <ref name="cdistro">cDistro git repository: http://dev.cloudy.community/Guifi.net/web-interface</ref>.<br />
<br />
''(Cal afegir què és)''<br />
<br />
<br />
<br />
== Configuració ==<br />
<br />
La configuració de cDistro es troba a /etc/cdistro.conf<br />
<br />
Per defecte té el següent format:<br />
<br />
#cdistro config<br />
SERVER="/usr/bin/php"<br />
OPTS=""<br />
BINDIP="0.0.0.0"<br />
PORT="7000"<br />
DOCROOT="/var/local/cDistro"<br />
# SSHAUTH=1 <- check user with ssh2 connection http://www.php.net/manual/en/function.ssh2-auth-password.php (Require: libssh2-php)<br />
SSHAUTH=1<br />
# LOGIN="root"<br />
## PASSWORD = md5(md5('secret')) => php -r 'echo md5(md5("secret"))."\n";'<br />
#PASSWORD="7022cd14c42ff272619d6beacdc9ffde"<br />
PORT_SSL=7443<br />
<br />
<br />
=== SERVER ===<br />
<br />
La ruta de l'executable PHP.<br />
<br />
'''Exemple:'''<br />
<br />
* "/usr/bin/php" - en el cas de Cloudy (Debian).<br />
<br />
<br />
=== OPTS ===<br />
<br />
Opcions de PHP.<br />
<br />
''(Cal afegir referències o més info i exemple)''<br />
<br />
<br />
=== BINDIP ===<br />
<br />
L'adreça IP on el servei estarà escoltant.<br />
<br />
'''Exemple:'''<br />
<br />
* "127.0.0.1" - acceptarà només peticions des de localhost.<br />
* "0.0.0.0" - acceptarà peticions des de qualsevol adreça.<br />
<br />
<br />
=== PORT ===<br />
<br />
El port que obrirà el servei per escoltar peticions.<br />
<br />
'''Exemple:'''<br />
<br />
* "7000" - obre el port 7000<br />
<br />
<br />
=== DOCROOT ===<br />
<br />
La ruta de l'executable de l'aplicació cDistro.<br />
<br />
'''Exemple:'''<br />
<br />
* "/var/local/cDistro" - en el cas de Cloudy.<br />
<br />
<br />
=== SSLAUTH ===<br />
<br />
Paràmetre que permet autenticació via SSH2 a l'aplicació, és a dir, per utilitzar les credencials que permeti el servidor SSH del sistema.<br />
<br />
Pot ser 0 o 1.<br />
<br />
'''Exemple:'''<br />
<br />
* "1" - activa aquesta opció.<br />
* "0" - desactiva aquesta opció (requerirà definir usuari i contrasenya).<br />
<br />
<br />
=== LOGIN ===<br />
<br />
El nom d'usuari per autenticar-se en l'aplicació.<br />
<br />
Ha de ser una cadena sense espais.<br />
<br />
'''Exemple:'''<br />
<br />
* "cloudy" - aquest usuari podrà fer log-in amb la contrasenya definida a PASSWORD.<br />
<br />
<br />
=== PASSWORD ===<br />
<br />
La contrasenya de l'usuari definit a LOGIN.<br />
<br />
Ha de ser un ''hash'' sobre ''hash'' MD5 (hexadecimal), és a dir, un ''hash'' del ''hash'' de la contrasenya: md5(md5("PASSWORD")).<br />
<br />
<br />
'''Exemple:'''<br />
<br />
* "46d934e0f59ff1e2272f9f5f7950e5d9" - ''hash'' corresponent a la cadena de caràcters "PASSWORD".<br />
<br />
'''Exemples de com generar aquest ''hash'' en un terminal:'''<br />
<br />
$ php -r 'echo md5(md5("PASSWORD"))."\n";'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
$ printf "PASSWORD" | md5sum | awk '{printf $1}' | md5sum | awk '{print $1}'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
<br />
<br />
=== PORT_SSL ===<br />
<br />
Port que utilitzarà Cloudy en la interfície web amb HTTPS (si SSL està instal·lat).<br />
<br />
'''Exemple:'''<br />
<br />
* "7443" - s'accedirà a la web https://IP_SERVIDOR:7443.<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_web_UICloudy web UI2015-05-12T18:50:35Z<p>Conxuro: </p>
<hr />
<div><br />
== Introducció ==<br />
<br />
La inferfície d'usuari web (web User Interface (UI)) de Cloudy utilitza una aplicació anomenada cDistro <ref name="cdistro">cDistro git repository: http://dev.cloudy.community/Guifi.net/web-interface</ref>.<br />
<br />
''(Cal afegir què és)''<br />
<br />
<br />
<br />
== Configuració ==<br />
<br />
La configuració de cDistro es troba a /etc/cdistro.conf<br />
<br />
Per defecte té el següent format:<br />
<br />
#cdistro config<br />
SERVER="/usr/bin/php"<br />
OPTS=""<br />
BINDIP="0.0.0.0"<br />
PORT="7000"<br />
DOCROOT="/var/local/cDistro"<br />
# SSHAUTH=1 <- check user with ssh2 connection http://www.php.net/manual/en/function.ssh2-auth-password.php (Require: libssh2-php)<br />
SSHAUTH=1<br />
# LOGIN="root"<br />
## PASSWORD = md5(md5('secret')) => php -r 'echo md5(md5("secret"))."\n";'<br />
#PASSWORD="7022cd14c42ff272619d6beacdc9ffde"<br />
PORT_SSL=7443<br />
<br />
<br />
=== SERVER ===<br />
<br />
La ruta de l'executable PHP.<br />
<br />
'''Exemple:'''<br />
<br />
* "/usr/bin/php" - en el cas de Cloudy (Debian).<br />
<br />
<br />
=== OPTS ===<br />
<br />
Opcions de PHP.<br />
<br />
''(Cal afegir referències o més info i exemple)''<br />
<br />
<br />
=== BINDIP ===<br />
<br />
L'adreça IP on el servei estarà escoltant.<br />
<br />
'''Exemple:'''<br />
<br />
* "127.0.0.1" - acceptarà només peticions des de localhost.<br />
* "0.0.0.0" - acceptarà peticions des de qualsevol adreça.<br />
<br />
<br />
=== PORT ===<br />
<br />
El port que obrirà el servei per escoltar peticions.<br />
<br />
'''Exemple:'''<br />
<br />
* "7000" - obre el port 7000<br />
<br />
<br />
=== DOCROOT ===<br />
<br />
La ruta de l'executable de l'aplicació cDistro.<br />
<br />
'''Exemple:'''<br />
<br />
* "/var/local/cDistro" - en el cas de Cloudy.<br />
<br />
<br />
=== SSLAUTH ===<br />
<br />
Paràmetre que permet autenticació via SSH2 a l'aplicació, és a dir, per utilitzar les credencials que permeti el servidor SSH del sistema.<br />
<br />
Pot ser 0 o 1.<br />
<br />
'''Exemple:'''<br />
<br />
* "1" - activa aquesta opció.<br />
* "0" - desactiva aquesta opció (requerirà definir usuari i contrasenya).<br />
<br />
<br />
=== LOGIN ===<br />
<br />
El nom d'usuari per autenticar-se en l'aplicació.<br />
<br />
Ha de ser una cadena sense espais.<br />
<br />
'''Exemple:'''<br />
<br />
* "cloudy" - aquest usuari podrà fer log-in amb la contrasenya definida a PASSWORD.<br />
<br />
<br />
=== PASSWORD ===<br />
<br />
La contrasenya de l'usuari definit a LOGIN.<br />
<br />
Ha de ser un ''hash'' sobre ''hash'' MD5 (hexadecimal), és a dir, un ''hash'' del ''hash'' de la contrasenya: md5(md5("PASSWORD")).<br />
<br />
<br />
'''Exemple:'''<br />
<br />
* "46d934e0f59ff1e2272f9f5f7950e5d9" - ''hash'' corresponent a la cadena de caràcters "PASSWORD".<br />
<br />
'''Exemples de com generar aquest ''hash'' en un terminal:'''<br />
<br />
$ php -r 'echo md5(md5("PASSWORD"))."\n";'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
$ printf "PASSWORD" | md5sum | awk '{printf $1}' | md5sum | awk '{print $1}'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
<br />
<br />
=== PORT_SSL ===<br />
<br />
Port que utilitzará Cloudy en la interfície web amb HTTPS (si SSL està instal·lat).<br />
<br />
'''Exemple:'''<br />
<br />
* "7443" - s'accedirà a la web https://IP_SERVIDOR:7443.<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_web_UICloudy web UI2015-04-27T15:00:22Z<p>Conxuro: </p>
<hr />
<div><br />
== Introducció ==<br />
<br />
La inferfície d'usuari web (web User Interface (UI)) de Cloudy utilitza una aplicació anomenada cDistro <ref name="cdistro">cDistro git repository: http://dev.cloudy.community/Guifi.net/web-interface</ref>.<br />
<br />
''(Cal afegir què és)''<br />
<br />
<br />
<br />
== Configuració ==<br />
<br />
La configuració de cDistro es troba a /etc/cdistro.conf<br />
<br />
Per defecte té el següent format:<br />
<br />
#cdistro config<br />
SERVER="/usr/bin/php"<br />
OPTS=""<br />
BINDIP="0.0.0.0"<br />
PORT="7000"<br />
DOCROOT="/var/local/cDistro"<br />
# SSHAUTH=1 <- check user with ssh2 connection http://www.php.net/manual/en/function.ssh2-auth-password.php (Require: libssh2-php)<br />
SSHAUTH=1<br />
# LOGIN="root"<br />
## PASSWORD = md5(md5('secret')) => php -r 'echo md5(md5("secret"))."\n";'<br />
#PASSWORD="7022cd14c42ff272619d6beacdc9ffde"<br />
PORT_SSL=7443<br />
<br />
<br />
=== SERVER ===<br />
<br />
La ruta de l'executable PHP.<br />
<br />
'''Exemple:'''<br />
<br />
* "/usr/bin/php" - en el cas de Cloudy (Debian).<br />
<br />
<br />
=== OPTS ===<br />
<br />
Opcions de PHP.<br />
<br />
''(Cal afegir referències o més info i exemple)''<br />
<br />
<br />
=== BINDIP ===<br />
<br />
L'adreça IP on el servei estarà escoltant.<br />
<br />
'''Exemple:'''<br />
<br />
* "127.0.0.1" - acceptarà només peticions des de localhost<br />
* "0.0.0.0" - acceptarà peticions des de qualsevol adreça<br />
<br />
<br />
=== PORT ===<br />
<br />
El port que obrirà el servei per escoltar peticions.<br />
<br />
'''Exemple:'''<br />
<br />
* "7000" - obre el port 7000<br />
<br />
<br />
=== DOCROOT ===<br />
<br />
La ruta de l'executable de l'aplicació cDistro.<br />
<br />
'''Exemple:'''<br />
<br />
* "/var/local/cDistro" - en el cas de Cloudy.<br />
<br />
<br />
=== SSLAUTH ===<br />
<br />
Paràmetre que permet autenticació via SSH2 a l'aplicació, és a dir, per utilitzar les credencials que permeti el servidor SSH del sistema.<br />
<br />
Pot ser 0 o 1.<br />
<br />
'''Exemple:'''<br />
<br />
* "1" - activa aquesta opció<br />
* "0" - desactiva aquesta opció (requerirà definir usuari i contrasenya)<br />
<br />
<br />
=== LOGIN ===<br />
<br />
El nom d'usuari per autenticar-se en l'aplicació.<br />
<br />
Ha de ser una cadena sense espais.<br />
<br />
'''Exemple:'''<br />
<br />
* "cloudy" - aquest usuari podrà fer log-in amb la contrasenya definida a PASSWORD<br />
<br />
<br />
=== PASSWORD ===<br />
<br />
La contrasenya de l'usuari definit a LOGIN.<br />
<br />
Ha de ser un ''hash'' sobre ''hash'' MD5 (hexadecimal), és a dir, un ''hash'' del ''hash'' de la contrasenya: md5(md5("PASSWORD")).<br />
<br />
<br />
'''Exemple:'''<br />
<br />
* "46d934e0f59ff1e2272f9f5f7950e5d9" - ''hash'' corresponent a la cadena de caràcters "PASSWORD"<br />
<br />
'''Exemples de com generar aquest ''hash'' en un terminal:'''<br />
<br />
$ php -r 'echo md5(md5("PASSWORD"))."\n";'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
$ printf "PASSWORD" | md5sum | awk '{printf $1}' | md5sum | awk '{print $1}'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
<br />
<br />
=== PORT_SSL ===<br />
<br />
Port que utilitzará Cloudy en la interfície web amb HTTPS (si SSL está instal·lat).<br />
<br />
'''Exemple:'''<br />
<br />
* "7443" - s'accedirà a la web https://IP_SERVIDOR:7443<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_plug-insCloudy plug-ins2015-04-24T14:47:14Z<p>Conxuro: </p>
<hr />
<div>== Què és un plug-in? ==<br />
<br />
Cloudy és una distribució de Linux basada en Debian que dona als usuaris una interfície simple i còmoda per gestionar diferents serveis que poden ser fets servir a través d'una xarxa comunitària; en el nostre cas, Guifi.<br />
<br />
Al mateix temps, Cloudy ofereix una sèrie d'eines que permeten a un usuari afegir un servei del seu gust sense haver de tenir grans coneixements sobre xarxes i informàtica en general. Automàticament, aquests serveis es publiquen mitjançant Avahi, de manera que tothom que disposi de Cloudy pot fer ús d'aquests servei.<br />
<br />
Una altra manera d'anomenar aquests serveis que es poden posar i treure de forma senzilla és plug-in. Així doncs, entenem per plug-in a un programa o software que un usuari vol afegir a la distribució i que pot ser gestionat de forma simple des de la interfície web que proveeix Cloudy.<br />
<br />
<br />
== Afegir serveis a Cloudy ==<br />
<br />
=== Una petita introducció ===<br />
<br />
Aquesta guia t'ensenyarà el procés per afegir un nou servei a la distribució Cloudy.<br />
<br />
Per tal de ser clar i donar alguns exemples al mateix temps, integrarem un servei bastant simple mostrant alguns troços de codi pel camí. Per seguir el tutorial amb més claredat, o bé per integrar serveis més complexes, fora bò que sapiguéssiu alguna cosa de Bash<ref name="Bash">(http://www.tldp.org/LDP/Bash-Beginners-Guide/Bash-Beginners-Guide.pdf)</ref> i de PHP<ref name="PHP">(https://php.net/manual/es/index.php)</ref>.<br />
<br />
Per simplicitat farem servir Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. És un bon candidat ja que:<br />
<br />
* És independent i no es ''federa'' ni es comunica amb altres nodes.<br />
* Està fet en Go, és fàcil de distribuïr i instal·lar.<br />
* No necessita fitxers de configuració.<br />
* No necessita gaires recursos.<br />
<br />
=== Obtenir el binari ===<br />
<br />
El primer que hem d'investigar és com descarregar i instal·lar el binari a Cloudy. La majoria del software que podem trobat està per defecte en els paquets de Debian, però el Pastecat no hi és. Si es donés el cas que hi fós, tan sols hauriem d'executar la comanda <code>apt-get install pastecat</code> des de PHP.<br />
<br />
Però com que aquest no és el cas, haurem de treure el binari d'algun altre lloc. Una opció és agafar el codi font i compilarl-lo nosaltres mateixos, però el problema d'això és que Cloudy necessitaría incloure moltes eines i llibreries per compil·lar, i aquest no és l'objectiu.<br />
<br />
La millor opció si un paquet de Debian no està disponible en els repositoris, és descarregar els binaris des d'algun lloc segur. Podem fer servir el servei de ''"releases"'' de Github per això. Les dues opcions ens deixen amb un fitxer executable que hauriem de ser capaços de córrer directe sobre Cloudy.<br />
<br />
En aquest cas en particular descarregarem els binaris des del repositori git amb la següent línia de comandes:<br />
<br />
<code><br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
</code><br />
<br />
Noteu que en aquest cas en concret estem descarregant una versió específica per un Linux amb arquitectura i386.<br />
<br />
Fixeu-vos però, que tenir el servei en els paquets de Debian té moltes avantatges:<br />
<br />
* Les actualitzacions són simples i no necessiten feina extra des de Cloudy.<br />
* El paquet està compilat per Debian d'una manera segura.<br />
* Els fitxer de l'''init.d'' ja venen per defecte.<br />
* Els paquets de Debian solen contenir correccions.<br />
<br />
=== Provar-lo ===<br />
<br />
Abans d'afegir un servei hauriem de configurar-lo i provar-lo directament nosaltres mateixos per veure com funciona i que realment funciona. També hem entendre quines opcions de configuració o línies de comandes necessitarem per fer ús d'aquest servei en particular i com el gestionarem un cop estigui funcionant.<br />
<br />
=== Afegir el controlador ===<br />
<br />
En <code>web/plug/controllers</code> tenim un fitxer PHP per cada servei, anomenat controlador (o 'controller' en anglès). Aquest fitxer conté el codi que s'executarà quan es visiti la pàgina del nostre servei des de la interfície web de Cloudy.<br />
<br />
==== Afegir la funció índex ====<br />
<br />
El que volem fer és que el nostre servei estigui integrat en l'estructura web de Cloudy. Per fer això, necessitem crear uns quants ''scripts'' en PHP i afegir-los al nostre dispositiu. De moment necessitarem crear dos ''scripts'': <code>pastecat.php</code> i <code>pastecat.menu.php</code>. El primer fitxer és el controlador, és a dir, l'''script'' que renderitza la pàgina i té tota la informació tal com botons o redireccionaments. L'altre és el que permet que el nostre servei es mostri en els menus superiors desplegables de Cloudy.<br />
<br />
El codi del menú serà quelcom semblant a això:<br />
<br />
<code php> <br />
<?php<br />
//peerstreamer.menu.php<br />
addMenu('Pastecat','pastecat','Clommunity');<br />
</code><br />
<br />
Per ara, farem servir un ''script'' molt simple en PHP com a controlador:<br />
<br />
<code php> <br />
<?php<br />
//pastecat<br />
$title="Pastecat";<br />
<br />
function index(){<br />
global $paspath,$title;<br />
global $staticFile;<br />
<br />
$page=hlc(t($title));<br />
$page .= hl(t("Minimalist pastebin engine written in Go"),4);<br />
$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."));<br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
</code><br />
<br />
En el nostre sistema Cloudy aquests fitxers han de posar-se als directoris dins de <code>/var/local/cDistro/plug/</code>. El primer ha d'anar dins de <code>menus</code> i el segon al directori <code>controllers</code>. Un cop haguem fet això, podem anar al web del nostre dispositiu amb Cloudy i accedir al nou menú Pastecat.<br />
<br />
==== Fer que el controlador instal·li el nostre servei ====<br />
<br />
Com s'ha mencionat anteriorment, aquest pas és molt més senzill de realitzar si el servei està en els paquets de Debian. Com que no és el cas del Pastecat, ho haurem de fer manualment. Normalment, fer aquest procés manualment inclou una combinació de les comandes <code>wget</code>, <code>mv</code> i <code>chmod</code>. En general, és bona idea mantenir els fitxers d'aquest tipus de serveis a <code>/opt/SERVICENAME</code>.<br />
<br />
En el nostre cas en particular, la primera cosa que necessitem fer és descarregar el binari de la ''release'' de Github. per tal de fer això farem ús de la comanda mencionada abans: <code>wget</code>. Donada una URL a un fitxer, aquesta comanda en permet descarregar aquest fitxer al nostre sistema, i això és el que farem tot seguit amb:<br />
<br />
<code bash><br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
</code><br />
<br />
Una cop tinguem el binari en la nostra màquina el mourem al directori /opt/pastecat/. Per tal de moure els fitxers pel nostre sistema farem servir la comanda <code>mv</code>. Tot i així, primer haurem de crear el directori on posarem el fitxer. Per fer això, utilitzarem <code>mkdir</code> de la següent manera:<br />
<br />
<code bash><br />
mkdir -p /opt/pastecat/<br />
</code><br />
<br />
Una vegada haguem creat el directori, és hora de moure-hi el binari:<br />
<br />
<code bash><br />
mv current_directory/pastecat_linux_386 /opt/pastecat/<br />
</code><br />
<br />
On "current_directory" és el directori on prèviament hem descarregat el binari. Com que el nom del binari depèn de l'arquitectura, per tal de simplificar el codi del controlador, canviarem el nom del fitxer executable a quelcom més genèric i simple:<br />
<br />
<code bash><br />
mv /opt/pastecat/pastecat_linux_386 /opt/pastecat/pastecat<br />
</code><br />
<br />
Ara el nostre binari es diu <code>pastecat</code> en comptes de <code>pastecat_linux_386</code><br />
<br />
Aquests passos són els mínim requerits per instal·lar un servei que no s'ofereix directament en els repositoris oficials de Debian. Nogensmenys, de cara a un usuari final, seria un malson haver de fet totes aquestes comandes en una consola connectat a través de <code>ssh</code> al seu dispositiu, així que el que farem tot seguit és crear un script en bash que serà cridat més endavant a través de la interfície web clicant un botó.<br />
<br />
Aquest ''script'' és la primera versió del controlador del Pastecat. Per ara només inclourem una funció per instal·lar el Pastecat en el nostre dispositiu. Més endavant inclourem algunes altres funcions per proveïr al nostre ''script'' amb més serveis:<br />
<br />
<code bash><br />
#!/bin/bash<br />
PCPATH="/opt/pastecat/"<br />
<br />
doInstall() {<br />
if isInstall<br />
then<br />
echo "Pastecat is already installed."<br />
return<br />
fi<br />
<br />
# Creating directory and switching<br />
mkdir -p $pcpath && cd $pcpath<br />
<br />
# Getting file<br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
<br />
# Changing name so controller can invoke it generically<br />
mv pastecat_linux_386 pastecat<br />
chmod +x pastecat<br />
<br />
cd -<br />
}<br />
<br />
isInstalled() {<br />
[ -d $pcpath ] && return 0<br />
return 1<br />
}<br />
<br />
<br />
case $1 in<br />
"install")<br />
shift<br />
doInstall $@<br />
;;<br />
esac<br />
</code><br />
<br />
Podem veure com els últims passos s'han concentrat dins d'una mateixa funció, permetent-nos instal·lar el software en el dispositiu d'una forma més senzilla.<br />
<br />
==== Fer que el controlador utilitzi Pastecat ====<br />
<br />
===== Executar el servei =====<br />
<br />
El següent que volem fer és que el nostre software es pugui fer servir des de la interfície web. És per això que inclourem una nova opció a la nostra pàgina principal de Pastecat i inclourem una nova funció en el nostre controlador per gestionar el binari. Afegirem un botó en el PHP de la següent manera:<br />
<br />
<code bash><br />
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));<br />
</code><br />
<br />
Just després del missatge <code>Pastecat is installed</code>. El proper que cal fer és implementar la funció <code>publish</code> en el mateix PHP. Aquesta funció és la responsable de cridar a la funció corresponent des del controlador i anunciar el nostre servei fent servir Avahi. La diferència amb aquesta funció és que requereix un formulari per introduïr-hi dades, així que al final acabarem tenint dues funcions: una get i una post:<br />
<br />
<code php><br />
function publish_get() {<br />
global $pcpath,$title;<br />
global $staticFile;<br />
<br />
$page = hlc(t($title));<br />
$page .= hlc(t('Publish a pastecat server'),2);<br />
$page .= par(t("Write the port to publish your Pastecat service"));<br />
$page .= createForm(array('class'=>'form-horizontal'));<br />
$page .= addInput('description',t('Describe this server'));<br />
$page .= addSubmit(array('label'=>t('Publish'),'class'=>'btn btn-primary'));<br />
$page .= addButton(array('label'=>t('Cancel'),'href'=>$staticFile.'/peerstreamer'));<br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
<br />
function publish_post() {<br />
$port = $_POST['port'];<br />
$description = $_POST['description'];<br />
$ip = "";<br />
<br />
<nowiki>$page = "<pre>";<br />
$page .= _pcsource($description);<br />
$page .= "</pre>";</nowiki><br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
</code><br />
<br />
Com podem veure en la funció <code>post</code> estem invocant una altra funció. La raó de fer això és escriure un codi més simple i modular. En aquesta última funció per fi cridem a l'script:<br />
<br />
<code php><br />
function _pcsource($port,$description) {<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;<br />
<br />
$page = "";<br />
$device = getCommunityDev()['output'][0];<br />
$ipserver = getCommunityIP()['output'][0];<br />
<br />
if ($description == "") $description = $type;<br />
<br />
$cmd = $pcutils." publish '$port' '$description';<br />
execute_program_detached($cmd);<br />
<br />
$page .= t($ipserver);<br />
$page .= par(t('Published this server.'));<br />
<br />
$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));<br />
<br />
return($page)<br />
}<br />
</code><br />
<br />
El proper que hem de fer és crear una funció <code>publish</code> en el controlador, pel que afegirem una nova funció al controlador bàsic que teniem a la secció '''3.2'''. Primer afegirem un nou paràmetre anomenat ''publish'', així que la primera part a exeutar-se de l'''script'' serà:<br />
<br />
<code bash><br />
if [ $# -lt 1 ]<br />
then<br />
doHelp<br />
fi<br />
<br />
case $1 in<br />
"install")<br />
shift<br />
doInstall $@<br />
;;<br />
"publish")<br />
shift<br />
doServer $@<br />
;;<br />
esac<br />
</code><br />
<br />
Com podem veure, quan el primer argument de l'script és <code>publish</code>, desplazamos (''shift') la resta d'arguments i cridem a la funció <code>doServer</code>. En aquesta funció hem de posar en marxa el servei amb els arguments corresponents, així que el primer que farem serà posar aquests paràmetres en variables locals. Una vegada haguem fet això, el més lògic seria llençar l'aplicació directament, però com que l'script es crida amb permisos de "root" (i això és dolent) hem de llençar Pastecat com a usuari <code>nobody</code>. El problema és que l'usuari <code>nobody</code> no té quasi permisos i el Pastecat necessita alguns permisos per crear directoris i fitxers de text. Per permetre que <code>nobody</code> pugui fer aquestes coses, primer crearem un directori garantint permisos a casibé tothom. Per aconseguir això, farem servir la comanda <code>chmod</code> altre vegada. Ara, l'usuari pot crear fitxers i directoris dins d'aquest mateix directori, i en conseqüència, podem córrer Pastecat. Finalment, mantindre el PID en una variable en cas que el necessitem més endavant (que ja us dic que sí que el necessitarem):<br />
<br />
<code bash><br />
doServer() {<br />
# Turning machine into a server<br />
<br />
local port=${1:-""}<br />
local description=${2:-""}<br />
local ip=${3:-"0.0.0.0"}<br />
<br />
# Creating directory with nobody permissions<br />
mkdir -p "/var/local/pastecat"<br />
chmod 777 "/var/local/pastecat" && cd "/var/local/pastecat"<br />
<br />
# Running pastecat <br />
cmd='su '$PCUSER' -c "{ '$PCPATH$PCPROG' -l :'$port' > '$LOGFILE' 2>&1 & }; echo \$!"'<br />
pidpc=$(eval $cmd) # keeping PID for future needs...<br />
<br />
cd -<br />
<br />
# Using the PID, we could carry on process control so if the pastecat process die, we can also<br />
# stop the avahi process to avoid "false connections"<br />
<br />
return<br />
}<br />
</code><br />
<br />
Fixeu-vos que ara estem fent servir algunes variables globals que no estaven definides abans, com<br />
ara <code>PCUSER</code> i <code>LOGFILE</code>. Aquestes variables tenen els següents valors:<br />
<br />
<code bash><br />
PCPATH="/opt/pastecat/"<br />
PCPROG="pastecat"<br />
LOGFILE="/dev/null"<br />
PCUSER="nobody<br />
</code><br />
<br />
===== Aturar el servei =====<br />
<br />
En algun moment és possible que vulguem aturar el nostre servei. És per això que crearem un botó per fer-ho. La primera cosa a fer sería crear el botó, però si pensem una mica, veurem que abans de crear-lo necessitem una manera de saber si el nostre servei està corrent o no. A més a més, també necessitem una manera d'aturar el nostre servei. Com que estem corrent sobre Linux, podem aconseguir aturar el servei fàcilment fent servir la comanda <code>kill</code>. El problema és que per fer servir aquesta comanda primer necessitem saber el número d'identificació del procés (PID). Per sort nostra, ja vam quedar-nos amb aquest número quan vam crear el servidor de Pastecat; en concret amb la línia <code>pidpc=$(eval $cmd)</code>.<br />
<br />
Ara que tenim tot el que necessitem per matar el nostre procés, anem a veure com ho fem perquè el PHP pugui saber si el servei està corrent o no. Una manera fàcil i eficient de fer-ho és emmagatzemant algunes dades útils en un fitxer i borrar-lo quan s'aturi el Pastecat. D'aquesta manera ens assegurem que el fitxer només existeix quan el Pastecat està actiu. Aquest fitxer el crearem des del controlador afegint les següents línies just sota la sentència que hem mencionat en el paràgraf enterior:<br />
<br />
<code bash><br />
# Writting server info to file<br />
info="$pidpc http://$ip:$port" # Separator is space character<br />
echo $info > $PCFILE<br />
</code><br />
<br />
On <code>$PCFILE</code> és una variable global que conté <code>/var/run/pc.info</code>. Fixeu-vos que el contingut del fitxer serà el PID del Pastecat i la direcció completa del servidor d'aquest.<br />
<br />
Ara ja tenim una manera de saber si el servei està actiu o no, de manera que tot seguit afegirem el botó 'stop' a la interfície web. Modificarem una mica l'''script'' PHP que teniem abans, afegint un anunci indicant si el Pastecat s'està executant o no i 2 botons més quan aquest estigui corrent. Així doncs, la nostra funció índex contindrà el següent codi dins la condició que comproba si el Pastecat està instal·lat o no:<br />
<br />
<code php><br />
<nowiki>$page .= "<div class='alert alert-success text-center'>".t("Pastecat is installed")."</div>\n";<br />
if ( isRunning() ) {<br />
$page .= "<div class='alert alert-success text-center'>".t("Pastecat is running")."</div>\n";<br />
$page .= addButton(array('label'=>t('Go to server'),'href'=>'http://'. getCommunityIP()['output'][0] .':'. $port));<br />
$page .= addButton(array('label'=>t('Stop server'),'href'=>$staticFile.'/pastecat/stop'));<br />
} else {<br />
$page .= "<div class='alert alert-error text-center'>".t("Pastecat is not running")."</div>\n";<br />
}<br />
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));</nowiki><br />
</code><br />
<br />
En aquest tros de codi podem apreciar dues coses noves en el nostre codi. La primera és una funció de comprovació anomenada <code>isRunning()</code>. Aquesta funció s'assembla molt a la funció que feiem servir per comprovar si el Pastecat estava instal·lat o no:<br />
<br />
<code php><br />
function isRunning() {<br />
// Returns whether pastecat is running or not<br />
global $pcfile;<br />
<br />
return(file_exists($pcfile)); <br />
}<br />
</code><br />
<br />
És tant simple com sembla, només comprova que el fitxer creat quan es llença el server de Pastecat encara existeixi. La segona cosa que podem veure nova en el nostre codi és l'existència d'una nova funció anomenada <code>stop</code>. Aquesta funció invocarà una altra funció en el controlador que aturarà el servidor de Pastecat:<br />
<br />
<code php><br />
function stop() {<br />
// Stops Pastecat server<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;<br />
<br />
$page = "";<br />
$cmd = $pcutils." stop ";<br />
execute_program_detached($cmd);<br />
<br />
return(array('type'=>'redirect','url'=>$staticFile.'/pastecat'));<br />
}<br />
</code><br />
<br />
Per tal de fer que el controlador entengui aquesta ordre, haurem de modificar-ne la sentència <code>case</code> i afegir-hi la noca funció. En el <code>case</code> hi afegirem el següent sota de l'opció <code>install</code>:<br />
<br />
<code bash><br />
"stop")<br />
shift<br />
doStop $@<br />
;;<br />
</code><br />
<br />
Això crida a la funció <code>doStop</code> dins del mateix controlador. Aquesta funció serà semblant a això:<br />
<br />
<code bash><br />
doStop() {<br />
# Stopping pastecat server<br />
pcpid=$(cat $PCFILE | cut -d' ' -f1)<br />
kill $pcpid<br />
<br />
# Removing info file<br />
rm $PCFILE<br />
}<br />
</code><br />
<br />
Aquesta funció agafa el PID de Pastecat del fitxer que hem creat abans, mata el procés i finalment esborra el fitxer de manera que el php pugui detectar que el Pastecat s'ha aturat.<br />
<br />
Ara podem crear un servidor de Pastecat i aturar-lo. Tot i així, encara hi ha quelcom que manca: fer que la resta d'usuaris puguin veure el nostre servei. I és per això que utilitzarem Avahi.<br />
<br />
=== Publicació de serveis Avahi ===<br />
<br />
Una de les millors coses de Cloudy és la característica de publicar els nostres serveis com una publicació d'avahi, permetent als altres usuaris saber què oferim i unir-se al nostre servei. Per fer aixo, primer hem d'afegir algunes línies de codi al controlador php, just sota de la crida al controlador en bash per activar el servidor Pastecat. Afegirem les següents línies:<br />
<br />
<code php><br />
$description = str_replace(' ', '', $description);<br />
$temp = avahi_publish($avahi_type, $description, $port, "");<br />
$page .= ptxt($temp);<br />
</code><br />
<br />
Així que al final la nostra funció quedarà així:<br />
<br />
<code php><br />
function _pcsource($port,$description) {<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type;<br />
<br />
$page = "";<br />
$device = getCommunityDev()['output'][0];<br />
$ipserver = getCommunityIP()['output'][0];<br />
<br />
if ($description == "") $description = $type;<br />
<br />
$cmd = $pcutils." publish '$port' '$description'";<br />
execute_program_detached($cmd);<br />
<br />
$page .= t($ipserver);<br />
$page .= par(t('Published this server.'));<br />
$description = str_replace(' ', '', $description);<br />
$temp = avahi_publish($avahi_type, $description, $port, "");<br />
$page .= ptxt($temp);<br />
<br />
$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));<br />
<br />
return($page)<br />
}<br />
</code><br />
<br />
Amb aquest simple pas hem anunciat el nostre servei a la xarxa d'avahi. Tot i això la feina no acaba aquí, encara queda una cosa més a fer: crear un botó i programar-lo de manera que quan es cliqui, ens redirigeixi directament al nostre servidor de Pastecat.<br />
<br />
Per fer això hi ha una carpeta anomenada <code>avahi</code> dins del directori <code>plug</code>. Els ''scripts'' que defineixen l'acció a dur a terme quan es cliquen els botons d'avahi estan en diferents fitxers dins d'aquest directori. D'aquesta manera crearem un fitxer anomenat <code>pastecat.avahi.php</code> que contindrà:<br />
<br />
<code php><br />
<?php<br />
// plug/avahi/pastecat.avahi.php<br />
<br />
addAvahi('pastecat','fpcserver');<br />
<br />
function fpcserver($dates){<br />
global $staticFile;<br />
<br />
return ("<a class='btn' href='http://" .$dates['ip'] .":". $dates['port']."'>Go to server</a> ");<br />
}<br />
</code><br />
<br />
Això crearà un botó al costat de l'anunci d'avahi que apuntarà al nostre servidor.<br />
<br />
Ara que ja tenim el nostre servei anunciat, volem que aquest desaparegui un cop aturem el servidor Pastecat. Aquest últim pas és molt simple però important. Consisteix en unes poques línies de codi en la funció 'stop' de l'''script'' PHP. Fins ara, aquesta funció només cridava el controlador Bash i aturava el Pastecat, però ara també aturarà la publicació Avahi i mostrarà un breu comentari donant a conèixer que la crida ha funcionat:<br />
<br />
<code php><br />
$temp = avahi_unpublish($avahi_type, $port);<br />
$flash = ptxt($temp);<br />
setFlash($flash);<br />
</code><br />
<br />
Aquestes línies han de ser afegides just després de la sentència <code>execute_program_detached($cmd)</code> a la funció stop del php.<br />
<br />
=== Final ===<br />
<br />
Finalment afegir que tots els fitxers implementats durant aquest tutorial es poden trobar en un repositori GitHub que apareix a l'apartat d'Enllaços Externs, juntament amb aquest mateix tutorial en format Markdown (md).<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
https://github.com/Clommunity/Doc/tree/master/plugins/pastecat<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]<br />
[[en:Cloudy_plug-ins]]<br />
[[es:Cloudy_plug-ins]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_plug-insCloudy plug-ins2015-04-24T14:45:54Z<p>Conxuro: </p>
<hr />
<div>== Què és un plug-in? ==<br />
<br />
Cloudy és una distribució de Linux basada en Debian que dona als usuaris una interfície simple i còmoda per gestionar diferents serveis que poden ser fets servir a través d'una xarxa comunitària; en el nostre cas, Guifi.<br />
<br />
Al mateix temps, Cloudy ofereix una sèrie d'eines que permeten a un usuari afegir un servei del seu gust sense haver de tenir grans coneixements sobre xarxes i informàtica en general. Automàticament, aquests serveis es publiquen mitjançant Avahi, de manera que tothom que disposi de Cloudy pot fer ús d'aquests servei.<br />
<br />
Una altra manera d'anomenar aquests serveis que es poden posar i treure de forma senzilla és plug-in. Així doncs, entenem per plug-in a un programa o software que un usuari vol afegir a la distribució i que pot ser gestionat de forma simple des de la interfície web que proveeix Cloudy.<br />
<br />
<br />
== Afegir serveis a Cloudy ==<br />
<br />
=== Una petita introducció ===<br />
<br />
Aquesta guia t'ensenyarà el procés per afegir un nou servei a la distribució Cloudy.<br />
<br />
Per tal de ser clar i donar alguns exemples al mateix temps, integrarem un servei bastant simple mostrant alguns troços de codi pel camí. Per seguir el tutorial amb més claredat, o bé per integrar serveis més complexes, fora bò que sapiguéssiu alguna cosa de Bash<ref name="Bash">(http://www.tldp.org/LDP/Bash-Beginners-Guide/Bash-Beginners-Guide.pdf)</ref> i de PHP<ref name="PHP">(https://php.net/manual/es/index.php)</ref>.<br />
<br />
Per simplicitat farem servir Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. És un bon candidat ja que:<br />
<br />
* És independent i no es ''federa'' ni es comunica amb altres nodes.<br />
* Està fet en Go, és fàcil de distribuïr i instal·lar.<br />
* No necessita fitxers de configuració.<br />
* No necessita gaires recursos.<br />
<br />
=== Obtenir el binari ===<br />
<br />
El primer que hem d'investigar és com descarregar i instal·lar el binari a Cloudy. La majoria del software que podem trobat està per defecte en els paquets de Debian, però el Pastecat no hi és. Si es donés el cas que hi fós, tan sols hauriem d'executar la comanda <code>apt-get install pastecat</code> des de PHP.<br />
<br />
Però com que aquest no és el cas, haurem de treure el binari d'algun altre lloc. Una opció és agafar el codi font i compilarl-lo nosaltres mateixos, però el problema d'això és que Cloudy necessitaría incloure moltes eines i llibreries per compil·lar, i aquest no és l'objectiu.<br />
<br />
La millor opció si un paquet de Debian no està disponible en els repositoris, és descarregar els binaris des d'algun lloc segur. Podem fer servir el servei de ''"releases"'' de Github per això. Les dues opcions ens deixen amb un fitxer executable que hauriem de ser capaços de córrer directe sobre Cloudy.<br />
<br />
En aquest cas en particular descarregarem els binaris des del repositori git amb la següent línia de comandes:<br />
<br />
<code><br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
</code><br />
<br />
Noteu que en aquest cas en concret estem descarregant una versió específica per un Linux amb arquitectura i386.<br />
<br />
Fixeu-vos però, que tenir el servei en els paquets de Debian té moltes avantatges:<br />
<br />
* Les actualitzacions són simples i no necessiten feina extra des de Cloudy.<br />
* El paquet està compilat per Debian d'una manera segura.<br />
* Els fitxer de l'''init.d'' ja venen per defecte.<br />
* Els paquets de Debian solen contenir correccions.<br />
<br />
=== Provar-lo ===<br />
<br />
Abans d'afegir un servei hauriem de configurar-lo i provar-lo directament nosaltres mateixos per veure com funciona i que realment funciona. També hem entendre quines opcions de configuració o línies de comandes necessitarem per fer ús d'aquest servei en particular i com el gestionarem un cop estigui funcionant.<br />
<br />
=== Afegir el controlador ===<br />
<br />
En <code>web/plug/controllers</code> tenim un fitxer PHP per cada servei, anomenat controlador (o 'controller' en anglès). Aquest fitxer conté el codi que s'executarà quan es visiti la pàgina del nostre servei des de la interfície web de Cloudy.<br />
<br />
==== Afegint la funció índex ====<br />
<br />
El que volem fer és que el nostre servei estigui integrat en l'estructura web de Cloudy. Per fer això, necessitem crear uns quants ''scripts'' en PHP i afegir-los al nostre dispositiu. De moment necessitarem crear dos ''scripts'': <code>pastecat.php</code> i <code>pastecat.menu.php</code>. El primer fitxer és el controlador, és a dir, l'''script'' que renderitza la pàgina i té tota la informació tal com botons o redireccionaments. L'altre és el que permet que el nostre servei es mostri en els menus superiors desplegables de Cloudy.<br />
<br />
El codi del menú serà quelcom semblant a això:<br />
<br />
<code php> <br />
<?php<br />
//peerstreamer.menu.php<br />
addMenu('Pastecat','pastecat','Clommunity');<br />
</code><br />
<br />
Per ara, farem servir un ''script'' molt simple en PHP com a controlador:<br />
<br />
<code php> <br />
<?php<br />
//pastecat<br />
$title="Pastecat";<br />
<br />
function index(){<br />
global $paspath,$title;<br />
global $staticFile;<br />
<br />
$page=hlc(t($title));<br />
$page .= hl(t("Minimalist pastebin engine written in Go"),4);<br />
$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."));<br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
</code><br />
<br />
En el nostre sistema Cloudy aquests fitxers han de posar-se als directoris dins de <code>/var/local/cDistro/plug/</code>. El primer ha d'anar dins de <code>menus</code> i el segon al directori <code>controllers</code>. Un cop haguem fet això, podem anar al web del nostre dispositiu amb Cloudy i accedir al nou menú Pastecat.<br />
<br />
==== Fer que el controlador instal·li el nostre servei ====<br />
<br />
Com s'ha mencionat anteriorment, aquest pas és molt més senzill de realitzar si el servei està en els paquets de Debian. Com que no és el cas del Pastecat, ho haurem de fer manualment. Normalment, fer aquest procés manualment inclou una combinació de les comandes <code>wget</code>, <code>mv</code> i <code>chmod</code>. En general, és bona idea mantenir els fitxers d'aquest tipus de serveis a <code>/opt/SERVICENAME</code>.<br />
<br />
En el nostre cas en particular, la primera cosa que necessitem fer és descarregar el binari de la ''release'' de Github. per tal de fer això farem ús de la comanda mencionada abans: <code>wget</code>. Donada una URL a un fitxer, aquesta comanda en permet descarregar aquest fitxer al nostre sistema, i això és el que farem tot seguit amb:<br />
<br />
<code bash><br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
</code><br />
<br />
Una cop tinguem el binari en la nostra màquina el mourem al directori /opt/pastecat/. Per tal de moure els fitxers pel nostre sistema farem servir la comanda <code>mv</code>. Tot i així, primer haurem de crear el directori on posarem el fitxer. Per fer això, utilitzarem <code>mkdir</code> de la següent manera:<br />
<br />
<code bash><br />
mkdir -p /opt/pastecat/<br />
</code><br />
<br />
Una vegada haguem creat el directori, és hora de moure-hi el binari:<br />
<br />
<code bash><br />
mv current_directory/pastecat_linux_386 /opt/pastecat/<br />
</code><br />
<br />
On "current_directory" és el directori on prèviament hem descarregat el binari. Com que el nom del binari depèn de l'arquitectura, per tal de simplificar el codi del controlador, canviarem el nom del fitxer executable a quelcom més genèric i simple:<br />
<br />
<code bash><br />
mv /opt/pastecat/pastecat_linux_386 /opt/pastecat/pastecat<br />
</code><br />
<br />
Ara el nostre binari es diu <code>pastecat</code> en comptes de <code>pastecat_linux_386</code><br />
<br />
Aquests passos són els mínim requerits per instal·lar un servei que no s'ofereix directament en els repositoris oficials de Debian. Nogensmenys, de cara a un usuari final, seria un malson haver de fet totes aquestes comandes en una consola connectat a través de <code>ssh</code> al seu dispositiu, així que el que farem tot seguit és crear un script en bash que serà cridat més endavant a través de la interfície web clicant un botó.<br />
<br />
Aquest ''script'' és la primera versió del controlador del Pastecat. Per ara només inclourem una funció per instal·lar el Pastecat en el nostre dispositiu. Més endavant inclourem algunes altres funcions per proveïr al nostre ''script'' amb més serveis:<br />
<br />
<code bash><br />
#!/bin/bash<br />
PCPATH="/opt/pastecat/"<br />
<br />
doInstall() {<br />
if isInstall<br />
then<br />
echo "Pastecat is already installed."<br />
return<br />
fi<br />
<br />
# Creating directory and switching<br />
mkdir -p $pcpath && cd $pcpath<br />
<br />
# Getting file<br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
<br />
# Changing name so controller can invoke it generically<br />
mv pastecat_linux_386 pastecat<br />
chmod +x pastecat<br />
<br />
cd -<br />
}<br />
<br />
isInstalled() {<br />
[ -d $pcpath ] && return 0<br />
return 1<br />
}<br />
<br />
<br />
case $1 in<br />
"install")<br />
shift<br />
doInstall $@<br />
;;<br />
esac<br />
</code><br />
<br />
Podem veure com els últims passos s'han concentrat dins d'una mateixa funció, permetent-nos instal·lar el software en el dispositiu d'una forma més senzilla.<br />
<br />
==== Fent que el controlador utilitzi Pastecat ====<br />
<br />
===== Executar el servei =====<br />
<br />
El següent que volem fer és que el nostre software es pugui fer servir des de la interfície web. És per això que inclourem una nova opció a la nostra pàgina principal de Pastecat i inclourem una nova funció en el nostre controlador per gestionar el binari. Afegirem un botó en el PHP de la següent manera:<br />
<br />
<code bash><br />
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));<br />
</code><br />
<br />
Just després del missatge <code>Pastecat is installed</code>. El proper que cal fer és implementar la funció <code>publish</code> en el mateix PHP. Aquesta funció és la responsable de cridar a la funció corresponent des del controlador i anunciar el nostre servei fent servir Avahi. La diferència amb aquesta funció és que requereix un formulari per introduïr-hi dades, així que al final acabarem tenint dues funcions: una get i una post:<br />
<br />
<code php><br />
function publish_get() {<br />
global $pcpath,$title;<br />
global $staticFile;<br />
<br />
$page = hlc(t($title));<br />
$page .= hlc(t('Publish a pastecat server'),2);<br />
$page .= par(t("Write the port to publish your Pastecat service"));<br />
$page .= createForm(array('class'=>'form-horizontal'));<br />
$page .= addInput('description',t('Describe this server'));<br />
$page .= addSubmit(array('label'=>t('Publish'),'class'=>'btn btn-primary'));<br />
$page .= addButton(array('label'=>t('Cancel'),'href'=>$staticFile.'/peerstreamer'));<br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
<br />
function publish_post() {<br />
$port = $_POST['port'];<br />
$description = $_POST['description'];<br />
$ip = "";<br />
<br />
<nowiki>$page = "<pre>";<br />
$page .= _pcsource($description);<br />
$page .= "</pre>";</nowiki><br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
</code><br />
<br />
Com podem veure en la funció <code>post</code> estem invocant una altra funció. La raó de fer això és escriure un codi més simple i modular. En aquesta última funció per fi cridem a l'script:<br />
<br />
<code php><br />
function _pcsource($port,$description) {<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;<br />
<br />
$page = "";<br />
$device = getCommunityDev()['output'][0];<br />
$ipserver = getCommunityIP()['output'][0];<br />
<br />
if ($description == "") $description = $type;<br />
<br />
$cmd = $pcutils." publish '$port' '$description';<br />
execute_program_detached($cmd);<br />
<br />
$page .= t($ipserver);<br />
$page .= par(t('Published this server.'));<br />
<br />
$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));<br />
<br />
return($page)<br />
}<br />
</code><br />
<br />
El proper que hem de fer és crear una funció <code>publish</code> en el controlador, pel que afegirem una nova funció al controlador bàsic que teniem a la secció '''3.2'''. Primer afegirem un nou paràmetre anomenat ''publish'', així que la primera part a exeutar-se de l'''script'' serà:<br />
<br />
<code bash><br />
if [ $# -lt 1 ]<br />
then<br />
doHelp<br />
fi<br />
<br />
case $1 in<br />
"install")<br />
shift<br />
doInstall $@<br />
;;<br />
"publish")<br />
shift<br />
doServer $@<br />
;;<br />
esac<br />
</code><br />
<br />
Com podem veure, quan el primer argument de l'script és <code>publish</code>, desplazamos (''shift') la resta d'arguments i cridem a la funció <code>doServer</code>. En aquesta funció hem de posar en marxa el servei amb els arguments corresponents, així que el primer que farem serà posar aquests paràmetres en variables locals. Una vegada haguem fet això, el més lògic seria llençar l'aplicació directament, però com que l'script es crida amb permisos de "root" (i això és dolent) hem de llençar Pastecat com a usuari <code>nobody</code>. El problema és que l'usuari <code>nobody</code> no té quasi permisos i el Pastecat necessita alguns permisos per crear directoris i fitxers de text. Per permetre que <code>nobody</code> pugui fer aquestes coses, primer crearem un directori garantint permisos a casibé tothom. Per aconseguir això, farem servir la comanda <code>chmod</code> altre vegada. Ara, l'usuari pot crear fitxers i directoris dins d'aquest mateix directori, i en conseqüència, podem córrer Pastecat. Finalment, mantindre el PID en una variable en cas que el necessitem més endavant (que ja us dic que sí que el necessitarem):<br />
<br />
<code bash><br />
doServer() {<br />
# Turning machine into a server<br />
<br />
local port=${1:-""}<br />
local description=${2:-""}<br />
local ip=${3:-"0.0.0.0"}<br />
<br />
# Creating directory with nobody permissions<br />
mkdir -p "/var/local/pastecat"<br />
chmod 777 "/var/local/pastecat" && cd "/var/local/pastecat"<br />
<br />
# Running pastecat <br />
cmd='su '$PCUSER' -c "{ '$PCPATH$PCPROG' -l :'$port' > '$LOGFILE' 2>&1 & }; echo \$!"'<br />
pidpc=$(eval $cmd) # keeping PID for future needs...<br />
<br />
cd -<br />
<br />
# Using the PID, we could carry on process control so if the pastecat process die, we can also<br />
# stop the avahi process to avoid "false connections"<br />
<br />
return<br />
}<br />
</code><br />
<br />
Fixeu-vos que ara estem fent servir algunes variables globals que no estaven definides abans, com<br />
ara <code>PCUSER</code> i <code>LOGFILE</code>. Aquestes variables tenen els següents valors:<br />
<br />
<code bash><br />
PCPATH="/opt/pastecat/"<br />
PCPROG="pastecat"<br />
LOGFILE="/dev/null"<br />
PCUSER="nobody<br />
</code><br />
<br />
===== Aturar el servei =====<br />
<br />
En algun moment és possible que vulguem aturar el nostre servei. És per això que crearem un botó per fer-ho. La primera cosa a fer sería crear el botó, però si pensem una mica, veurem que abans de crear-lo necessitem una manera de saber si el nostre servei està corrent o no. A més a més, també necessitem una manera d'aturar el nostre servei. Com que estem corrent sobre Linux, podem aconseguir aturar el servei fàcilment fent servir la comanda <code>kill</code>. El problema és que per fer servir aquesta comanda primer necessitem saber el número d'identificació del procés (PID). Per sort nostra, ja vam quedar-nos amb aquest número quan vam crear el servidor de Pastecat; en concret amb la línia <code>pidpc=$(eval $cmd)</code>.<br />
<br />
Ara que tenim tot el que necessitem per matar el nostre procés, anem a veure com ho fem perquè el PHP pugui saber si el servei està corrent o no. Una manera fàcil i eficient de fer-ho és emmagatzemant algunes dades útils en un fitxer i borrar-lo quan s'aturi el Pastecat. D'aquesta manera ens assegurem que el fitxer només existeix quan el Pastecat està actiu. Aquest fitxer el crearem des del controlador afegint les següents línies just sota la sentència que hem mencionat en el paràgraf enterior:<br />
<br />
<code bash><br />
# Writting server info to file<br />
info="$pidpc http://$ip:$port" # Separator is space character<br />
echo $info > $PCFILE<br />
</code><br />
<br />
On <code>$PCFILE</code> és una variable global que conté <code>/var/run/pc.info</code>. Fixeu-vos que el contingut del fitxer serà el PID del Pastecat i la direcció completa del servidor d'aquest.<br />
<br />
Ara ja tenim una manera de saber si el servei està actiu o no, de manera que tot seguit afegirem el botó 'stop' a la interfície web. Modificarem una mica l'''script'' PHP que teniem abans, afegint un anunci indicant si el Pastecat s'està executant o no i 2 botons més quan aquest estigui corrent. Així doncs, la nostra funció índex contindrà el següent codi dins la condició que comproba si el Pastecat està instal·lat o no:<br />
<br />
<code php><br />
<nowiki>$page .= "<div class='alert alert-success text-center'>".t("Pastecat is installed")."</div>\n";<br />
if ( isRunning() ) {<br />
$page .= "<div class='alert alert-success text-center'>".t("Pastecat is running")."</div>\n";<br />
$page .= addButton(array('label'=>t('Go to server'),'href'=>'http://'. getCommunityIP()['output'][0] .':'. $port));<br />
$page .= addButton(array('label'=>t('Stop server'),'href'=>$staticFile.'/pastecat/stop'));<br />
} else {<br />
$page .= "<div class='alert alert-error text-center'>".t("Pastecat is not running")."</div>\n";<br />
}<br />
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));</nowiki><br />
</code><br />
<br />
En aquest tros de codi podem apreciar dues coses noves en el nostre codi. La primera és una funció de comprovació anomenada <code>isRunning()</code>. Aquesta funció s'assembla molt a la funció que feiem servir per comprovar si el Pastecat estava instal·lat o no:<br />
<br />
<code php><br />
function isRunning() {<br />
// Returns whether pastecat is running or not<br />
global $pcfile;<br />
<br />
return(file_exists($pcfile)); <br />
}<br />
</code><br />
<br />
És tant simple com sembla, només comprova que el fitxer creat quan es llença el server de Pastecat encara existeixi. La segona cosa que podem veure nova en el nostre codi és l'existència d'una nova funció anomenada <code>stop</code>. Aquesta funció invocarà una altra funció en el controlador que aturarà el servidor de Pastecat:<br />
<br />
<code php><br />
function stop() {<br />
// Stops Pastecat server<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;<br />
<br />
$page = "";<br />
$cmd = $pcutils." stop ";<br />
execute_program_detached($cmd);<br />
<br />
return(array('type'=>'redirect','url'=>$staticFile.'/pastecat'));<br />
}<br />
</code><br />
<br />
Per tal de fer que el controlador entengui aquesta ordre, haurem de modificar-ne la sentència <code>case</code> i afegir-hi la noca funció. En el <code>case</code> hi afegirem el següent sota de l'opció <code>install</code>:<br />
<br />
<code bash><br />
"stop")<br />
shift<br />
doStop $@<br />
;;<br />
</code><br />
<br />
Això crida a la funció <code>doStop</code> dins del mateix controlador. Aquesta funció serà semblant a això:<br />
<br />
<code bash><br />
doStop() {<br />
# Stopping pastecat server<br />
pcpid=$(cat $PCFILE | cut -d' ' -f1)<br />
kill $pcpid<br />
<br />
# Removing info file<br />
rm $PCFILE<br />
}<br />
</code><br />
<br />
Aquesta funció agafa el PID de Pastecat del fitxer que hem creat abans, mata el procés i finalment esborra el fitxer de manera que el php pugui detectar que el Pastecat s'ha aturat.<br />
<br />
Ara podem crear un servidor de Pastecat i aturar-lo. Tot i així, encara hi ha quelcom que manca: fer que la resta d'usuaris puguin veure el nostre servei. I és per això que utilitzarem Avahi.<br />
<br />
=== Publicació de serveis Avahi ===<br />
<br />
Una de les millors coses de Cloudy és la característica de publicar els nostres serveis com una publicació d'avahi, permetent als altres usuaris saber què oferim i unir-se al nostre servei. Per fer aixo, primer hem d'afegir algunes línies de codi al controlador php, just sota de la crida al controlador en bash per activar el servidor Pastecat. Afegirem les següents línies:<br />
<br />
<code php><br />
$description = str_replace(' ', '', $description);<br />
$temp = avahi_publish($avahi_type, $description, $port, "");<br />
$page .= ptxt($temp);<br />
</code><br />
<br />
Així que al final la nostra funció quedarà així:<br />
<br />
<code php><br />
function _pcsource($port,$description) {<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type;<br />
<br />
$page = "";<br />
$device = getCommunityDev()['output'][0];<br />
$ipserver = getCommunityIP()['output'][0];<br />
<br />
if ($description == "") $description = $type;<br />
<br />
$cmd = $pcutils." publish '$port' '$description'";<br />
execute_program_detached($cmd);<br />
<br />
$page .= t($ipserver);<br />
$page .= par(t('Published this server.'));<br />
$description = str_replace(' ', '', $description);<br />
$temp = avahi_publish($avahi_type, $description, $port, "");<br />
$page .= ptxt($temp);<br />
<br />
$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));<br />
<br />
return($page)<br />
}<br />
</code><br />
<br />
Amb aquest simple pas hem anunciat el nostre servei a la xarxa d'avahi. Tot i això la feina no acaba aquí, encara queda una cosa més a fer: crear un botó i programar-lo de manera que quan es cliqui, ens redirigeixi directament al nostre servidor de Pastecat.<br />
<br />
Per fer això hi ha una carpeta anomenada <code>avahi</code> dins del directori <code>plug</code>. Els ''scripts'' que defineixen l'acció a dur a terme quan es cliquen els botons d'avahi estan en diferents fitxers dins d'aquest directori. D'aquesta manera crearem un fitxer anomenat <code>pastecat.avahi.php</code> que contindrà:<br />
<br />
<code php><br />
<?php<br />
// plug/avahi/pastecat.avahi.php<br />
<br />
addAvahi('pastecat','fpcserver');<br />
<br />
function fpcserver($dates){<br />
global $staticFile;<br />
<br />
return ("<a class='btn' href='http://" .$dates['ip'] .":". $dates['port']."'>Go to server</a> ");<br />
}<br />
</code><br />
<br />
Això crearà un botó al costat de l'anunci d'avahi que apuntarà al nostre servidor.<br />
<br />
Ara que ja tenim el nostre servei anunciat, volem que aquest desaparegui un cop aturem el servidor Pastecat. Aquest últim pas és molt simple però important. Consisteix en unes poques línies de codi en la funció 'stop' de l'''script'' PHP. Fins ara, aquesta funció només cridava el controlador Bash i aturava el Pastecat, però ara també aturarà la publicació Avahi i mostrarà un breu comentari donant a conèixer que la crida ha funcionat:<br />
<br />
<code php><br />
$temp = avahi_unpublish($avahi_type, $port);<br />
$flash = ptxt($temp);<br />
setFlash($flash);<br />
</code><br />
<br />
Aquestes línies han de ser afegides just després de la sentència <code>execute_program_detached($cmd)</code> a la funció stop del php.<br />
<br />
=== Final ===<br />
<br />
Finalment afegir que tots els fitxers implementats durant aquest tutorial es poden trobar en un repositori GitHub que apareix a l'apartat d'Enllaços Externs, juntament amb aquest mateix tutorial en format Markdown (md).<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
https://github.com/Clommunity/Doc/tree/master/plugins/pastecat<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]<br />
[[en:Cloudy_plug-ins]]<br />
[[es:Cloudy_plug-ins]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_plug-insCloudy plug-ins2015-04-22T16:56:14Z<p>Conxuro: </p>
<hr />
<div>== Què és un plug-in? ==<br />
<br />
Cloudy és una distribució de Linux basada en Debian que dona als usuaris una interfície simple i còmoda per gestionar diferents serveis que poden ser fets servir a través d'una xarxa comunitària; en el nostre cas, Guifi.<br />
<br />
Al mateix temps, Cloudy ofereix una sèrie d'eines que permeten a un usuari afegir un servei del seu gust sense haver de tenir grans coneixements sobre xarxes i informàtica en general. Automàticament, aquests serveis es publiquen mitjançant Avahi, de manera que tothom que disposi de Cloudy pot fer ús d'aquests servei.<br />
<br />
Una altra manera d'anomenar aquests serveis que es poden posar i treure de forma senzilla és plug-in. Així doncs, entenem per plug-in a un programa o software que un usuari vol afegir a la distribució i que pot ser gestionat de forma simple des de la interfície web que proveeix Cloudy.<br />
<br />
<br />
== Afegir serveis a Cloudy ==<br />
<br />
=== Una petita introducció ===<br />
<br />
Aquesta guia t'ensenyarà el procés per afegir un nou servei a la distribució Cloudy.<br />
<br />
Per tal de ser clar i donar alguns exemples al mateix temps, integrarem un servei bastant simple mostrant alguns troços de codi pel camí. Per seguir el tutorial amb més claredat, o bé per integrar serveis més complexes, fora bò que sapiguéssiu alguna cosa de Bash<ref name="Bash">(http://www.tldp.org/LDP/Bash-Beginners-Guide/Bash-Beginners-Guide.pdf)</ref> i de PHP<ref name="PHP">(https://php.net/manual/es/index.php)</ref>.<br />
<br />
Per simplicitat farem servir Pastecat<ref name="Pastecat">(https://github.com/mvdan/pastecat)</ref>. És un bon candidat ja que:<br />
<br />
* És independent i no es ''federa'' ni es comunica amb altres nodes.<br />
* Està fet en Go, és fàcil de distribuïr i instal·lar.<br />
* No necessita fitxers de configuració.<br />
* No necessita gaires recursos.<br />
<br />
=== Obtenir el binari ===<br />
<br />
El primer que hem d'investigar és com descarregar i instal·lar el binari a Cloudy. La majoria del software que podem trobat està per defecte en els paquets de Debian, però el Pastecat no hi és. Si es donés el cas que hi fós, tan sols hauriem d'executar la comanda <code>apt-get install pastecat</code> des de PHP.<br />
<br />
Però com que aquest no és el cas, haurem de treure el binari d'algun altre lloc. Una opció és agafar el codi font i compilarl-lo nosaltres mateixos, però el problema d'això és que Cloudy necessitaría incloure moltes eines i llibreries per compil·lar, i aquest no és l'objectiu.<br />
<br />
La millor opció si un paquet de Debian no està disponible en els repositoris, és descarregar els binaris des d'algun lloc segur. Podem fer servir el servei de ''"releases"'' de Github per això. Les dues opcions ens deixen amb un fitxer executable que hauriem de ser capaços de córrer directe sobre Cloudy.<br />
<br />
En aquest cas en particular descarregarem els binaris des del repositori git amb la següent línia de comandes:<br />
<br />
<code><br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
</code><br />
<br />
Noteu que en aquest cas en concret estem descarregant una versió específica per un Linux amb arquitectura i386.<br />
<br />
Fixeu-vos però, que tenir el servei en els paquets de Debian té moltes avantatges:<br />
<br />
* Les actualitzacions són simples i no necessiten feina extra des de Cloudy.<br />
* El paquet està compilat per Debian d'una manera segura.<br />
* Els fitxer de l'''init.d'' ja venen per defecte.<br />
* Els paquets de Debian solen contenir correccions.<br />
<br />
=== Provar-lo ===<br />
<br />
Abans d'afegir un servei hauriem de configurar-lo i provar-lo directament nosaltres mateixos per veure com funciona i que realment funciona. També hem entendre quines opcions de configuració o línies de comandes necessitarem per fer ús d'aquest servei en particular i com el gestionarem un cop estigui funcionant.<br />
<br />
=== Afegir el controlador ===<br />
<br />
En <code>web/plug/controllers</code> tenim un fitxer PHP per cada servei, anomenat controlador (o 'controller' en anglès). Aquest fitxer conté el codi que s'executarà quan es visiti la pàgina del nostre servei des de la interfície web de Cloudy.<br />
<br />
==== Afegint la funció índex ====<br />
<br />
El que volem fer és que el nostre servei estigui integrat en l'estructura web de Cloudy. Per fer això, necessitem crear uns quants ''scripts'' en PHP i afegir-los al nostre dispositiu. De moment necessitarem crear dos ''scripts'': <code>pastecat.php</code> i <code>pastecat.menu.php</code>. El primer fitxer és el controlador, és a dir, l'''script'' que renderitza la pàgina i té tota la informació tal com botons o redireccionaments. L'altre és el que permet que el nostre servei es mostri en els menus superiors desplegables de Cloudy.<br />
<br />
El codi del menú serà quelcom semblant a això:<br />
<br />
<code php> <br />
<?php<br />
//peerstreamer.menu.php<br />
addMenu('Pastecat','pastecat','Clommunity');<br />
</code><br />
<br />
Per ara, farem servir un ''script'' molt simple en PHP com a controlador:<br />
<br />
<code php> <br />
<?php<br />
//pastecat<br />
$title="Pastecat";<br />
<br />
function index(){<br />
global $paspath,$title;<br />
global $staticFile;<br />
<br />
$page=hlc(t($title));<br />
$page .= hl(t("Minimalist pastebin engine written in Go"),4);<br />
$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."));<br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
</code><br />
<br />
En el nostre sistema Cloudy aquests fitxers han de posar-se als directoris dins de <code>/var/local/cDistro/plug/</code>. El primer ha d'anar dins de <code>menus</code> i el segon al directori <code>controllers</code>. Un cop haguem fet això, podem anar al web del nostre dispositiu amb Cloudy i accedir al nou menú Pastecat.<br />
<br />
==== Fer que el controlador instal·li el nostre servei ====<br />
<br />
Com s'ha mencionat anteriorment, aquest pas és molt més senzill de realitzar si el servei està en els paquets de Debian. Com que no és el cas del Pastecat, ho haurem de fer manualment. Normalment, fer aquest procés manualment inclou una combinació de les comandes <code>wget</code>, <code>mv</code> i <code>chmod</code>. En general, és bona idea mantenir els fitxers d'aquest tipus de serveis a <code>/opt/SERVICENAME</code>.<br />
<br />
En el nostre cas en particular, la primera cosa que necessitem fer és descarregar el binari de la ''release'' de Github. per tal de fer això farem ús de la comanda mencionada abans: <code>wget</code>. Donada una URL a un fitxer, aquesta comanda en permet descarregar aquest fitxer al nostre sistema, i això és el que farem tot seguit amb:<br />
<br />
<code bash><br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
</code><br />
<br />
Una cop tinguem el binari en la nostra màquina el mourem al directori /opt/pastecat/. Per tal de moure els fitxers pel nostre sistema farem servir la comanda <code>mv</code>. Tot i així, primer haurem de crear el directori on posarem el fitxer. Per fer això, utilitzarem <code>mkdir</code> de la següent manera:<br />
<br />
<code bash><br />
mkdir -p /opt/pastecat/<br />
</code><br />
<br />
Una vegada haguem creat el directori, és hora de moure-hi el binari:<br />
<br />
<code bash><br />
mv current_directory/pastecat_linux_386 /opt/pastecat/<br />
</code><br />
<br />
On "current_directory" és el directori on prèviament hem descarregat el binari. Com que el nom del binari depèn de l'arquitectura, per tal de simplificar el codi del controlador, canviarem el nom del fitxer executable a quelcom més genèric i simple:<br />
<br />
<code bash><br />
mv /opt/pastecat/pastecat_linux_386 /opt/pastecat/pastecat<br />
</code><br />
<br />
Ara el nostre binari es diu <code>pastecat</code> en comptes de <code>pastecat_linux_386</code><br />
<br />
Aquests passos són els mínim requerits per instal·lar un servei que no s'ofereix directament en els repositoris oficials de Debian. Nogensmenys, de cara a un usuari final, seria un malson haver de fet totes aquestes comandes en una consola connectat a través de <code>ssh</code> al seu dispositiu, així que el que farem tot seguit és crear un script en bash que serà cridat més endavant a través de la interfície web clicant un botó.<br />
<br />
Aquest ''script'' és la primera versió del controlador del Pastecat. Per ara només inclourem una funció per instal·lar el Pastecat en el nostre dispositiu. Més endavant inclourem algunes altres funcions per proveïr al nostre ''script'' amb més serveis:<br />
<br />
<code bash><br />
#!/bin/bash<br />
PCPATH="/opt/pastecat/"<br />
<br />
doInstall() {<br />
if isInstall<br />
then<br />
echo "Pastecat is already installed."<br />
return<br />
fi<br />
<br />
# Creating directory and switching<br />
mkdir -p $pcpath && cd $pcpath<br />
<br />
# Getting file<br />
wget https://github.com/mvdan/pastecat/releases/download/v0.3.0/pastecat_linux_386<br />
<br />
# Changing name so controller can invoke it generically<br />
mv pastecat_linux_386 pastecat<br />
chmod +x pastecat<br />
<br />
cd -<br />
}<br />
<br />
isInstalled() {<br />
[ -d $pcpath ] && return 0<br />
return 1<br />
}<br />
<br />
<br />
case $1 in<br />
"install")<br />
shift<br />
doInstall $@<br />
;;<br />
esac<br />
</code><br />
<br />
Podem veure com els últims passos s'han concentrat dins d'una mateixa funció, permetent-nos instal·lar el software en el dispositiu d'una forma més senzilla.<br />
<br />
==== Fent que el controlador utilitzi Pastecat ====<br />
<br />
===== Executar el servei =====<br />
<br />
El següent que volem fer és que el nostre software es pugui fer servir des de la interfície web.<br />
És per això que inclourem una nova opció a la nostra pàgina principal de Pastecat i inclourem<br />
una nova funció en el nostre controlador per gestionar el binari. Afegirem un botó en el PHP<br />
de la següent manera:<br />
<br />
<code bash><br />
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));<br />
</code><br />
<br />
just després del missatge <code>Pastecat is installed</code>. El proper que cal fer és implementar<br />
la funció <code>publish</code> en el mateix PHP. Aquesta funció és la responsable de cridar la funció<br />
corresponent en el controlador i anunciar el nostre servei fent servir Avahi. La diferència amb<br />
aquesta funció és que requereix un formulari per introduïr-hi dades, així que al final acabarem<br />
tenint dues funcions: una get i una post:<br />
<br />
<code php><br />
function publish_get() {<br />
global $pcpath,$title;<br />
global $staticFile;<br />
<br />
$page = hlc(t($title));<br />
$page .= hlc(t('Publish a pastecat server'),2);<br />
$page .= par(t("Write the port to publish your Pastecat service"));<br />
$page .= createForm(array('class'=>'form-horizontal'));<br />
$page .= addInput('description',t('Describe this server'));<br />
$page .= addSubmit(array('label'=>t('Publish'),'class'=>'btn btn-primary'));<br />
$page .= addButton(array('label'=>t('Cancel'),'href'=>$staticFile.'/peerstreamer'));<br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
<br />
function publish_post() {<br />
$port = $_POST['port'];<br />
$description = $_POST['description'];<br />
$ip = "";<br />
<br />
<nowiki>$page = "<pre>";<br />
$page .= _pcsource($description);<br />
$page .= "</pre>";</nowiki><br />
<br />
return(array('type' => 'render','page' => $page));<br />
}<br />
</code><br />
<br />
Com podem veure en la funció <code>post</code> estem invocant una altra funció. La raó de fer<br />
això és escriure un codi més simple i modular. En aquesta última funció per fi cridem a l'script:<br />
<br />
<code php><br />
function _pcsource($port,$description) {<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;<br />
<br />
$page = "";<br />
$device = getCommunityDev()['output'][0];<br />
$ipserver = getCommunityIP()['output'][0];<br />
<br />
if ($description == "") $description = $type;<br />
<br />
$cmd = $pcutils." publish '$port' '$description';<br />
execute_program_detached($cmd);<br />
<br />
$page .= t($ipserver);<br />
$page .= par(t('Published this server.'));<br />
<br />
$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));<br />
<br />
return($page)<br />
}<br />
</code><br />
<br />
El proper que hem de fer és crear una funció <code>publish</code> en el controlador, així que<br />
afegirem una nova funció al controlador bàsic que teniem a la secció '''3.2'''. Primer afegirem<br />
un nou paràmetre anomenat "publish", així que la primera part a exeutar-se de l'script serà:<br />
<br />
<code bash><br />
if [ $# -lt 1 ]<br />
then<br />
doHelp<br />
fi<br />
<br />
case $1 in<br />
"install")<br />
shift<br />
doInstall $@<br />
;;<br />
"publish")<br />
shift<br />
doServer $@<br />
;;<br />
esac<br />
</code><br />
<br />
Com podem veure, quan el primer argument de l'script és <code>publish</code>, "shiftem" la resta<br />
d'arguments i cridem a la funció <code>doServer</code>. En aquesta funció hem de posar en marxa<br />
el servei amb els arguments corresponents, així que el primer que farem serà posar aquests paràmetres<br />
en variables locals. Una vegada haguem fet això, el més lògic sería llençar l'aplicació directament,<br />
però com que l'script es crida amb permisos de "root" (i això és dolent) hem de llençar Pastecat com<br />
a usuari <code>nobody</code>. El problema és que l'usuari <code>nobody</code> no té quasi permisos...<br />
i el Pastecat necessita alguns permisos per crear directoris i fitxers de text. Per permetre que <code>nobody</code><br />
pugui fer aquestes coses, primer crearem un directori garantint permisos a casibé tothom. Per aconseguir<br />
això, farem servir la comanda <code>chmod</code> altre vegada. Ara, l'usuari pot crear fitxers i directoris<br />
dins d'aquest mateix directori, i en conseqüència, podem córrer Pastecat. Finalment, mantindre el<br />
PID en una variable en cas que el necessitem més endavant (que ja us dic que sí que el necessitarem):<br />
<br />
<code bash><br />
doServer() {<br />
# Turning machine into a server<br />
<br />
local port=${1:-""}<br />
local description=${2:-""}<br />
local ip=${3:-"0.0.0.0"}<br />
<br />
# Creating directory with nobody permissions<br />
mkdir -p "/var/local/pastecat"<br />
chmod 777 "/var/local/pastecat" && cd "/var/local/pastecat"<br />
<br />
# Running pastecat <br />
cmd='su '$PCUSER' -c "{ '$PCPATH$PCPROG' -l :'$port' > '$LOGFILE' 2>&1 & }; echo \$!"'<br />
pidpc=$(eval $cmd) # keeping PID for future needs...<br />
<br />
cd -<br />
<br />
# Using the PID, we could carry on process control so if the pastecat process die, we can also<br />
# stop the avahi process to avoid "false connections"<br />
<br />
return<br />
}<br />
</code><br />
<br />
Fixeu-vos que ara estem fent servir algunes variables globals que no estaven definides abans, com<br />
ara <code>PCUSER</code> i <code>LOGFILE</code>. Aquestes variables tenen els següents valors:<br />
<br />
<code bash><br />
PCPATH="/opt/pastecat/"<br />
PCPROG="pastecat"<br />
LOGFILE="/dev/null"<br />
PCUSER="nobody<br />
</code><br />
<br />
===== Aturar el servei =====<br />
<br />
En algun moment, és possible que vulguem aturar el nostre servei. És per això que crearem<br />
un botó per fer això. La primera cosa a fer sería crear el botó, però si pensem una mica, veurem<br />
que abans de crear-lo, necessitem una manera de saber si el nostre servei està corrent o no.<br />
A més a més, també necessitem una manera d'aturar el nostre servei. Com que estem corrent sobre<br />
Linux, podem aconseguir aturar el servei fàcilment fent servir la comanda <code>kill</code>.<br />
El problema és que, per fer servir aquesta comanda, primer necessitem saber el número d'identificació<br />
del procés (PID). Per sort nostra, ja vam quedar-nos amb aquest número quan vam crear el servidor<br />
de Pastecat. En concret amb la línia <code>pidpc=$(eval $cmd)</code>.<br />
<br />
Ara que tenim tot el que necessitem per matar el nostre procés, anem a veure com ho fem perquè<br />
el PHP pugui saber si el servei està corrent o no. Una manera fàcil i eficient de fer-ho és<br />
emmagatzemant algunes dades útils en un fitxer i borrar-lo quan s'aturi el Pastecat. D'aquesta<br />
manera ens assegurem que el fitxer només existeix quan el Pastecat està actiu. Aquest fitxer<br />
el crearem des del controlador afegint les següents línies just sota la sentència que hem<br />
mencionat en el paràgraf enterior:<br />
<br />
<code bash><br />
# Writting server info to file<br />
info="$pidpc http://$ip:$port" # Separator is space character<br />
echo $info > $PCFILE<br />
</code><br />
<br />
On <code>$PCFILE</code> és una variable global que conté <code>/var/run/pc.info</code>. Fixeu-vos<br />
que el contingut del fitxer serà el PID del Pastecat i la direcció completa del servidor d'aquest.<br />
<br />
Ara ja tenim una manera de saber si el servei està actiu o no, de manera que tot seguit afegirem<br />
el botó 'stop' a la interfície web. Modificarem una mica l'script php que teniem abans, afegint<br />
un anunci indicant si el Pastecat s'està executant o no i 2 botons més quan aquest estigui corrent.<br />
Així doncs, la nostra funció índex contindrà el següent codi dins la condició que comproba si<br />
el pastecat esa instal·lat o no:<br />
<br />
<code php><br />
<nowiki>$page .= "<div class='alert alert-success text-center'>".t("Pastecat is installed")."</div>\n";<br />
if ( isRunning() ) {<br />
$page .= "<div class='alert alert-success text-center'>".t("Pastecat is running")."</div>\n";<br />
$page .= addButton(array('label'=>t('Go to server'),'href'=>'http://'. getCommunityIP()['output'][0] .':'. $port));<br />
$page .= addButton(array('label'=>t('Stop server'),'href'=>$staticFile.'/pastecat/stop'));<br />
} else {<br />
$page .= "<div class='alert alert-error text-center'>".t("Pastecat is not running")."</div>\n";<br />
}<br />
$page .= addButton(array('label'=>t('Create a Pastecat server'),'href'=>$staticFile.'/pastecat/publish'));</nowiki><br />
</code><br />
<br />
En aquest tros de codi podem apreciar dues coses noves en el nostre codi. La primera és una funció<br />
de comprovació anomenada <code>isRunning()</code>. Aquesta funció s'assembla molt a la funció que feiem servir per comprovar si<br />
el Pastecat estava instal·lat o no:<br />
<br />
<code php><br />
function isRunning() {<br />
// Returns whether pastecat is running or not<br />
global $pcfile;<br />
<br />
return(file_exists($pcfile)); <br />
}<br />
</code><br />
<br />
És tant simple com sembla, només comprova que el fitxer creat quan es llença el server de Pastecat<br />
encara existeixi. La segona cosa que podem veure nova en el nostre codi és l'existència d'una <br />
nova funció anomenada <code>stop</code>. Aquesta funció invocarà una altra funció en el controlador<br />
que aturarà el servidor de Pastecat:<br />
<br />
<code php><br />
function stop() {<br />
// Stops Pastecat server<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type,$port;<br />
<br />
$page = "";<br />
$cmd = $pcutils." stop ";<br />
execute_program_detached($cmd);<br />
<br />
return(array('type'=>'redirect','url'=>$staticFile.'/pastecat'));<br />
}<br />
</code><br />
<br />
Per tal de fer que el controlador entengui aquesta ordre, haurem de modificar-ne el <code>case</code> i<br />
afegir-hi la noca funció. En la sentència <code>case</code> hi afegirem el següent sota de l'opció<br />
<code>install</code>:<br />
<br />
<code bash><br />
"stop")<br />
shift<br />
doStop $@<br />
;;<br />
</code><br />
<br />
Això crida la funció <code>doStop</code> dins del mateix controlador. Aquesta funció serà semblant a això:<br />
<br />
<code bash><br />
doStop() {<br />
# Stopping pastecat server<br />
pcpid=$(cat $PCFILE | cut -d' ' -f1)<br />
kill $pcpid<br />
<br />
# Removing info file<br />
rm $PCFILE<br />
}<br />
</code><br />
<br />
Aquesta funció agafa el PID de Pastecat del fitxer que hem creat abans, mata el procés i finalment<br />
esborra el fitxer de manera que el php pugui detectar que el Pastecat s'ha aturat.<br />
<br />
Ara podem crear un servidor de Pastecat i aturar-lo. Tot i així, encara hi ha quelcom que manca:<br />
fer que la resta d'usuaris puguin veure el nostre servei. I és per això que utilitzarem Avahi.<br />
<br />
=== Publicació de serveis Avahi ===<br />
<br />
Una de les millors coses de Cloudy és la característica de publicar els nostres serveis com una<br />
publicació d'avahi, permetent als altres usuaris saber què oferim i unir-se al nostre servei.<br />
Per fer aixo, primer hem d'afegir algunes línies de codi al controlador php, just sota de la crida<br />
al controlador en bash per activar el servidor Pastecat. Afegirem les següents línies:<br />
<br />
<code php><br />
$description = str_replace(' ', '', $description);<br />
$temp = avahi_publish($avahi_type, $description, $port, "");<br />
$page .= ptxt($temp);<br />
</code><br />
<br />
Així que al final la nostra funció quedarà així:<br />
<br />
<code php><br />
function _pcsource($port,$description) {<br />
global $pcpath,$pcprogram,$title,$pcutils,$avahi_type;<br />
<br />
$page = "";<br />
$device = getCommunityDev()['output'][0];<br />
$ipserver = getCommunityIP()['output'][0];<br />
<br />
if ($description == "") $description = $type;<br />
<br />
$cmd = $pcutils." publish '$port' '$description'";<br />
execute_program_detached($cmd);<br />
<br />
$page .= t($ipserver);<br />
$page .= par(t('Published this server.'));<br />
$description = str_replace(' ', '', $description);<br />
$temp = avahi_publish($avahi_type, $description, $port, "");<br />
$page .= ptxt($temp);<br />
<br />
$page .= addButton(array('label'=>t('Back'),'href'=>$staticFile.'/pastecat'));<br />
<br />
return($page)<br />
}<br />
</code><br />
<br />
Amb aquest simple pas hem anunciat el nostre servei a la xarxa d'avahi. Tot i això, la feina <br />
no acaba aquí, encara queda una cosa més a fer: crear un botó i programar-lo de manera que quan<br />
es cliqui, ens redirigeixi directament al nostre servidor de Pastecat.<br />
<br />
Per fer això hi ha una carpeta anomenada <code>avahi</code> dins del directori <code>plug</code>.<br />
Els escripts que defineixen l'acció a dur a terme quan es cliquen els botons d'avahi es defineixen<br />
en diferents fitxers dins d'aquest directori. D'aquesta manera, crearem un fitxer anomenat<br />
<code>pastecat.avahi.php</code> que contindrà:<br />
<br />
<code php><br />
<?php<br />
// plug/avahi/pastecat.avahi.php<br />
<br />
addAvahi('pastecat','fpcserver');<br />
<br />
function fpcserver($dates){<br />
global $staticFile;<br />
<br />
return ("<a class='btn' href='http://" .$dates['ip'] .":". $dates['port']."'>Go to server</a> ");<br />
}<br />
</code><br />
<br />
Això crearà un botó al costat de l'anunci d'avahi que apuntarà al nostre servidor.<br />
<br />
Ara que ja tenim el nostre servei anunciat, volem que aquest desaparegui un cop aturem el servidor<br />
Pastecat. Aquest últim pas és molt simple però important. Consisteix en unes poques línies de codi<br />
en la funció 'stop' de l'script php. Fins ara, aquesta funció només cridava el controlador bash<br />
i aturava el Pastecat, però ara també aturarà la publicació avahi i mostrarà un breu comentari<br />
donant a conèixer que la crida ha funcionat:<br />
<br />
<code php><br />
$temp = avahi_unpublish($avahi_type, $port);<br />
$flash = ptxt($temp);<br />
setFlash($flash);<br />
</code><br />
<br />
Aquestes línies han de ser afegides just després de la sentència <code>execute_program_detached($cmd)</code><br />
a la funció stop del php.<br />
<br />
=== Final ===<br />
<br />
Finalment afegir que tots els fitxers implementats durant aquest tutorial es poden trobar en un repositori GitHub que apareix a l'apartat d'Enllaços Externs, juntament amb aquest mateix tutorial en format Markdown (md).<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
https://github.com/Clommunity/Doc/tree/master/plugins/pastecat<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]<br />
[[en:Cloudy_plug-ins]]<br />
[[es:Cloudy_plug-ins]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Annex:subxarxes_meshAnnex:subxarxes mesh2015-04-11T15:07:37Z<p>Conxuro: </p>
<hr />
<div>{| class="wikitable sortable"<br />
|- style="background:#ececec;"<br />
! Abreviació de la comunitat <ref>Segons les [[convencions de noms]] s'hauria de fer servir la minúscula, en aquesta taula surten reflexades dues en alguns casos per reflexar que per motius històrics es poden trobar nodes encara amb la convenció de noms en majúscula (NOTA: S'ha d'acordar bé encara això)</ref><br />
! Nom de la xarxa - comunitat<br />
! Ubicació<br />
! [[ESSID]] comunitari<br />
! [[firmware]]<br />
! [[canal]] <ref name="canals">'''IMPORTANT++: els canals WiFi de 40 MHz han de seguir l'estàndar, pel que el 140- no és vàlid i S'HA DE CANVIAR a totes les zones'''</ref> <ref>Missatge a les llistes sobre els canals incorrectes: https://llistes.guifi.net/sympa/arc/guifi-mesh/2015-01/msg00000.html</ref><br />
! [[BSSID (adhoc)]]<br />
! [[Mesh id (802.11s)]]<br />
! [[vlan]]<br />
! IPv4<br />
! IPv6<br />
! Comentari<br />
|-<br />
| GSF - '''gsf'''<br />
| [[Gràcia Sense Fils]]<br />
| Vila de Gràcia al municipi de Barcelona<br />
|<br />
| [[gsffirm]] i [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.0.0/21<br />
|<br />
|<br />
|-<br />
| GS - '''gs'''<br />
| [[GuifiSants]]<br />
| Sants - Les Corts al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+, 124+ i 140-<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.8.0/21<br />
|<br />
|<br />
|-<br />
| RAV - '''rav'''<br />
| [[Mesh al Raval]]<br />
| Barri del raval al municipi de Barcelona<br />
| Cada node te el seu, la URL al node de guifi.net, exemple guifi.net/bcnsalvadors24<br />
| [[qMp]]<br />
| 136-<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.16.0/21<br />
|<br />
|<br />
|-<br />
| UPC - '''upc'''<br />
| [[Mesh a la UPC]]<br />
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.24.0/21<br />
|<br />
|<br />
|-<br />
| HW<br />
| [[Hospitalet Wireless]]<br />
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat<br />
| <br />
| [[qMp]]<br />
| 124+<br />
| 02:CA:FF:EE:BA:BE<br />
| qMp<br />
|<br />
| 10.1.32.0/21<br />
|<br />
|<br />
|-<br />
| SJD - '''sjd'''<br />
| [[Mesh a Sant Joan Despí]]<br />
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.40.0/21<br />
|<br />
|<br />
|-<br />
| vllc<br />
| [[Mesh a Vallcarca]]<br />
| Barri de Vallcarca i els Penitents al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+ i 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.48.0/21<br />
|<br />
|<br />
|-<br />
| SAND - '''sand'''<br />
| [[Mesh a Sant Andreu]]<br />
| Barri de Sant Andreu al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 132+ i 120-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.56.0/21<br />
|<br />
|<br />
|-<br />
| P9SF - '''p9sf'''<br />
| [[Poblenou Sense Fils]]<br />
| Poblenou al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140- old 132+ base 124+ alt<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.64.0/21<br />
|<br />
|<br />
|-<br />
| HCMT<br />
| [[Horta-Carmel-Montbau-Teixonera]]<br />
| Part nord del districte Horta-Guinardó al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 124-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.72.0/21<br />
|<br />
|<br />
|-<br />
| SCC<br />
| [[ Mesh a Santa Coloma de Cervelló]]<br />
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.80.0/21<br />
|<br />
|<br />
|-<br />
| ?<br />
| [[Mesh al Prat]]<br />
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]]<br />
| ?<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.88.0/21<br />
|<br />
|<br />
|-<br />
| gll<br />
| [[Garraf Lliure]]<br />
| Comarca del Garraf a Barcelona<br />
| garraflliure.guifi.net<br />
| [[libre-mesh]]<br />
| 11 i 36<br />
|<br />
|<br />
|<br />
| 10.1.96.0/21<br />
|<br />
|<br />
|-<br />
| mtj<br />
| [[Montjuïc - Jardí Botànic]]<br />
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona<br />
| jardibotanic.integral.guifi.net<br />
| [[libre-mesh]]<br />
| 48<br />
|<br />
|<br />
| 11<br />
| 10.1.104.0/21<br />
| 2a00:1508:1:f000 o 2a00:1508:1:fe4c::/64<br />
|<br />
|-<br />
| ?<br />
| [[Mesh a Cornellà]]<br />
| Municipi de Cornellà a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]]<br />
| ?<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.112.0/21<br />
|<br />
|<br />
|-<br />
| afrd<br />
| Aiguafreda<br />
| <br />
| <br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.120.0/21<br />
|<br />
|<br />
|-<br />
| Wales<br />
| [http://www.digitalmerthyr.org.uk Digital Merthyr]<br />
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.1.128.0/20<br />
|<br />
|<br />
|-<br />
| CIU<br />
| [[Mesh a Ciutadella]]<br />
| Ciutadella a l'illa de Menorca.<br />
|<br />
| [[qMp]]<br />
| 140- i més ...?<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.2.0.0/21<br />
|<br />
|<br />
|-<br />
| IRU<br />
| [[Mesh a Iruña]]<br />
| Iruña a Navarra<br />
| <br />
| [[qMp]]<br />
| 140-<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi ha nodes amb IPs del rang antic que entra en conflicte amb el rang de Wales.'''</ref><br />
|<br />
|<br />
|-<br />
| ?<br />
| [[Xarxa híbrida de Castelldefels]]<br />
| Municipi de Castelldefels a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]] i [[RouterOS]]<br />
| ?<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.10.8.0/22<br />
|<br />
| Al mateix rang s'estan fent servir modes en [[infraestructura]] amb RouterOS i nodes [[mesh]] amb qMp. La IP inicial que s'està fent servir és la [https://guifi.net/ca/node/61866 10.10.10.1/22].<br />
|-<br />
| ?<br />
| [[Mesh de Castelló]]<br />
| Ciutat de Castelló al País Valencià<br />
|<br />
| [[qMp]]<br />
| -<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.4.0.0/21<br />
|<br />
|<br />
|-<br />
| ?<br />
| [[Mesh de Benicàssim]]<br />
| Ciutat de Benicàssim a la província de Castelló, País Valencià<br />
|<br />
| [[qMp]]<br />
| -<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
|<br />
| 10.4.8.0/21<br />
|<br />
|<br />
|-<br />
| sn<br />
| [[Sierra Libre]]<br />
| Región de la Sierra Norte, en el Estado de Oaxaca, México<br />
| sierralibre.guifi.net<br />
| [[libre-mesh]]<br />
| <br />
|<br />
|<br />
|<br />
| 10.72.8.0/21<br />
|<br />
|<br />
|-<br />
|SFCM<br />
| Mesh a Sant Feliu de Codines<br />
| Sant Feliu de Codines, Valles Oriental, BCN<br />
| <br />
|[[qMp]]<br />
|<br />
| 02:CA:FF:EE:BA:BE<br />
|<br />
| <br />
| 10.91.176.0/22<br />
|<br />
|<br />
|-<br />
| eixD<br />
| [[Eixample Dret]]<br />
| Barri de l'Eixample Dret a Barcelona<br />
| <br />
| [[libre-mesh]]<br />
| 9 i 140<br />
|<br />
|<br />
| 11<br />
| 10.1.152.0/21<br />
| 2a00:1508:1:f017::/64<br />
|<br />
|}<br />
<references /><br />
<br />
[[categoria:MANET]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_web_UICloudy web UI2015-03-26T15:39:55Z<p>Conxuro: Es crea la pàgina amb « == Introducció == La inferfície d'usuari web (web User Interface (UI)) de Cloudy utilitza una aplicació anomenada cDistro <ref name="cdistro">cDistro git reposito...».</p>
<hr />
<div><br />
== Introducció ==<br />
<br />
La inferfície d'usuari web (web User Interface (UI)) de Cloudy utilitza una aplicació anomenada cDistro <ref name="cdistro">cDistro git repository: http://dev.cloudy.community/Guifi.net/web-interface</ref>.<br />
<br />
''(Cal afegir què és)''<br />
<br />
<br />
<br />
== Configuració ==<br />
<br />
La configuració de cDistro es troba a /etc/cdistro.conf<br />
<br />
Per defecte té el següent format:<br />
<br />
#cdistro config<br />
SERVER="/usr/bin/php"<br />
OPTS=""<br />
BINDIP="0.0.0.0"<br />
PORT="7000"<br />
DOCROOT="/var/local/cDistro"<br />
# SSHAUTH=1 <- check user with ssh2 connection http://www.php.net/manual/en/function.ssh2-auth-password.php (Require: libssh2-php)<br />
SSHAUTH=1<br />
# LOGIN="root"<br />
## PASSWORD = md5(md5('secret')) => php -r 'echo md5(md5("secret"))."\n";'<br />
#PASSWORD="7022cd14c42ff272619d6beacdc9ffde"<br />
<br />
<br />
<br />
=== SERVER ===<br />
<br />
La ruta de l'executable PHP.<br />
<br />
'''Exemple:'''<br />
<br />
* "/usr/bin/php" - en el cas de Cloudy (Debian).<br />
<br />
<br />
=== OPTS ===<br />
<br />
Opcions de PHP.<br />
<br />
''(Cal afegir referències o més info i exemple)''<br />
<br />
<br />
=== BINDIP ===<br />
<br />
L'adreça IP on el servei estarà escoltant.<br />
<br />
'''Exemple:'''<br />
<br />
* "127.0.0.1" - acceptarà només peticions des de localhost<br />
* "0.0.0.0" - acceptarà peticions des de qualsevol adreça<br />
<br />
<br />
=== PORT ===<br />
<br />
El port que obrirà el servei per escoltar peticions.<br />
<br />
'''Exemple:'''<br />
<br />
* "7000" - obre el port 7000<br />
<br />
<br />
=== DOCROOT ===<br />
<br />
La ruta de l'executable de l'aplicació cDistro.<br />
<br />
'''Exemple:'''<br />
<br />
* "/var/local/cDistro" - en el cas de Cloudy.<br />
<br />
<br />
=== SSLAUTH ===<br />
<br />
Paràmetre que permet autenticació via SSH2 a l'aplicació, és a dir, per utilitzar les credencials que permeti el servidor SSH del sistema.<br />
<br />
Pot ser 0 o 1.<br />
<br />
'''Exemple:'''<br />
<br />
* "1" - activa aquesta opció<br />
* "0" - desactiva aquesta opció (requerirà definir usuari i contrasenya)<br />
<br />
<br />
=== LOGIN ===<br />
<br />
El nom d'usuari per autenticar-se en l'aplicació.<br />
<br />
Ha de ser una cadena sense espais.<br />
<br />
'''Exemple:'''<br />
<br />
* "cloudy" - aquest usuari podrà fer log-in amb la contrasenya definida a PASSWORD<br />
<br />
<br />
=== PASSWORD ===<br />
<br />
La contrasenya de l'usuari definit a LOGIN.<br />
<br />
Ha de ser un ''hash'' sobre ''hash'' MD5 (hexadecimal), és a dir, un ''hash'' del ''hash'' de la contrasenya: md5(md5("PASSWORD")).<br />
<br />
<br />
'''Exemple:'''<br />
<br />
* "46d934e0f59ff1e2272f9f5f7950e5d9" - ''hash'' corresponent a la cadena de caràcters "PASSWORD"<br />
<br />
'''Exemples de com generar aquest ''hash'' en un terminal:'''<br />
<br />
$ php -r 'echo md5(md5("PASSWORD"))."\n";'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
$ printf "PASSWORD" | md5sum | awk '{printf $1}' | md5sum | awk '{print $1}'<br />
46d934e0f59ff1e2272f9f5f7950e5d9<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Cloudy_plug-insCloudy plug-ins2015-03-17T15:58:25Z<p>Conxuro: Es crea la pàgina amb «== Què és un plug-in == Explicar què és un plug-in o com funciona el sistema de plug-ins de Cloudy. == Com crear i afegir un plug-in == Explicar l'esctuctura ...».</p>
<hr />
<div>== Què és un plug-in ==<br />
<br />
Explicar què és un plug-in o com funciona el sistema de plug-ins de Cloudy.<br />
<br />
<br />
<br />
== Com crear i afegir un plug-in ==<br />
<br />
Explicar l'esctuctura d'un plug-in i els passos a seguir per tal d'afegir un plug-in a Cloudy.<br />
<br />
Des de crear els fitxers php<ref name="php">Exemple de referència: http://php.net</ref>, fins a descarregar el codi (mirar o enllaçar a get started > get cloudy > compile) i pujar els canvis.<br />
<br />
<br />
<br />
<br />
=== Subapartat 1 ===<br />
<br />
S1.<br />
<br />
<br />
<br />
=== Subapartat 2 ===<br />
<br />
S2.<br />
<br />
<br />
<br />
== Més informació ==<br />
<br />
Més info si cal<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
https://github.com/Clommunity/Doc/tree/master/plugins/pastecat<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Qu%C3%A8_%C3%A9s_CloudyQuè és Cloudy2015-03-17T15:45:40Z<p>Conxuro: </p>
<hr />
<div>[[File:clommunity-logo.png|right|100px]]<br />
[[File:Logo_guifi.svg|right|100px]]<br />
<br />
Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> és una distribució basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desenvolupada en el marc del projecte CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref><br />
<br />
Aquesta distribució, inspirada en la idea de l'antiga [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el desplegament i la gestió de serveis de xarxa en el núvol ''(cloud services)''<ref name="cloud-services">Cloud computing: http://ca.wikipedia.org/wiki/Inform%C3%A0tica_en_n%C3%BAvol</ref>, així com la compartició d'aquests. Pensada en particular pels usuaris de les xarxes comunitàries.<ref name="CN">Xarxes comunitàries: http://ca.wikipedia.org/wiki/Xarxa_oberta</ref><br />
<br />
<br />
<br />
----<br />
<br />
<br />
<br />
== Introducció ==<br />
<br />
Abans de l'adopció general de serveis en el núvol ''(cloud services)''<ref name="cloud-services"/> els usuaris de Xarxes Comunitàries <ref name="CN"/> ja compartien o proveïen serveis i recursos a la comunitat; no obstant, aquest usuaris eren una minoria. Una de les principals raons és la barrera tecnològica. Abans de proveir continguts, els usuaris que volen compartir informació amb la comunitat tenen primer que preocupar-se dels aspectes tècnics com el desplegament/muntatge d'un servidor amb un conjunt de serveis.<br />
<br />
En el passat, els usuaris de Guifi.net, intentaren superar aquest problema publicant una distribució GNU/Linux anomenada [[Guinux]] <ref name="guinux"/>, que donava als usuaris finals una solució fàcil per oferir serveis a la comunitat (com ara [[Servidor_Proxy/ca|proxy web]], [[Servidor_DNS/ca|sistemes DNS]], [[Monitor/ca|monitoratge i gràfiques]]).<br />
<br />
La clau principal de [[Guinux]] era un conjunt de ''scripts''<ref>http://ca.wikipedia.org/wiki/Script_%28inform%C3%A0tica%29</ref> que automatitzaven el procés de configuració. Els usuaris només havien d'introduir uns pocs paràmetres com l'adreça de correu electrònic i l'identificador del node. Aviat, després d'estar disponible la distribució, el nombre d'usuaris compartint recursos va proliferar.<br />
<br />
D'acord amb això, va quedar clar que reduint (o eliminant) la barrera d'entrada tecnològica animava als usuaris a proveir de més serveis i compartir els seus recursos amb la comunitat. Per a tal fi, un dels objectius principals del projecte CLOMMUNITY <ref name="clommunity"/> és publicar una distribució GNU/Linux, anomenada Cloudy, dirigida als usuaris, per a fomentar la transició i adopció de l'entorn Cloud a xarxes comunitàries ''(Community Network Cloud)''.<br />
<br />
<br />
=== Motivació === <br />
<br />
La distribució Cloudy s'ha pensat per satisfer els següents requisits:<br />
<br />
# '''Distribució''': per a potenciar la distribució de serveis a les xarxes comunitàries (XC); és necessària una plataforma per a publicar i descobrir aquests serveis. D'aquesta manera, l'accés als serveis no depèn de desplegaments estàtics de xarxes i és conscient de les condicions dinàmicament canviants de les XC. El programari escollit per a la publicació i descobriment de serveis és Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.<br />
# '''Descentralització''': una capa de xarxa comuna és necessària per permetre a tots els nodes del núvol comunicar-se entre ells directament. Una bona manera de construir això es crear una "capa 2 virtual" basada en un servei VPN<ref>Xarxa Privada Virtual: http://ca.wikipedia.org/wiki/Xarxa_privada_virtual</ref>. Entre les opcions disponibles, ha estat escollit Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ja que compleix tots els requisits i és senzill de configurar i administrar. Per a coordinar els dispositius amb Tinc VPN, s'ha desenvolupat una eina per automatitzar el desplegament del sistema. Aquest software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, s'encarrega del procés de configuració de Tinc VPN i de l'intercanvi de claus amb la resta de nodes del núvol.<br />
# '''Facilitat d'ús i experiència d'usuari''': per a aquest fi, s'ha desenvolupat una plataforma web d'administració destinada a integrar la instal·lació i configuració dels serveis al núvol habilitats en la distribució Cloudy. Una interfície web simple i agradable<ref>Interfície web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> està disponible pels usuaris com a solució fàcil de configuració, administració i monitoratge dels serveis ''cloud'' actius al node.<br />
# '''Programari lliure''': la distribució està basada en Debian GNU/Linux<ref name="debian"/>. Apart de ser una de les distribucions més populars i complir tots els requisits tècnics, ha estat escollida degut a que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda i garanteix que el programari serà sempre obert i lliure.<br />
<br />
[[File:Cloudy-home.png]]<br />
<br />
<br />
<br />
== Començar ==<br />
<br />
Entra a l'apartat "Començar" ''(Get started)'' de la web de Cloudy <ref name="start">http://cloudy.community/get_started/</ref> per saber tot el que necessites per iniciar-te.<br />
<br />
Allà trobaràs:<br />
* Requsits<br />
* Aconseguir/compilar<br />
* Instal·lar<br />
* Actualitzar<br />
* Primers pasos<br />
<br />
<br />
<br />
== Continguts ==<br />
<br />
A la secció "Característiques" ''(Features)'' <ref name="features">http://cloudy.community/features/</ref> podrás veure tots els continguts/programari de la distribució. En concret hi ha detallat el programari que pot ser gestionat fàcilment a través de la interfície web.<br />
<br />
Aquest programari està integrat mitjançant un sistema de ''plugins''. Pots llegir més en la pàgina de la wiki de [[Cloudy_plug-ins|plug-ins de Cloudy]].<br />
<br />
<br />
<br />
== Contribuir ==<br />
<br />
Per tal d'estar al dia o saber com col·laborar i involucrar-se amb Cloudy, entra a l'apartat "Contribuir" ''(Contribute)'' de la web.<ref name="contribuir">http://cloudy.community/contribute/</ref><br />
<br />
<br />
Recordeu que les llistes de correu són en anglès ja que hi ha participants de diverses nacionalitats.<br />
<br />
Si voleu escriure en català o castellà haureu de possar [CAT] o [ES] respectivament al asumpte del missatge de correu.<br />
<br />
<br />
<br />
== Més informació ==<br />
<br />
Pots llegir més entrant en la pàgina de la [[Cloudy|categoria Cloudy]]<br />
<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
* http://cloudy.community<br />
* http://wiki.clommunity-project.eu/soft:cloudservices<br />
* http://clommunity-project.eu<br />
* http://guifi.net<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Qu%C3%A8_%C3%A9s_CloudyQuè és Cloudy2015-02-19T14:46:44Z<p>Conxuro: </p>
<hr />
<div>[[File:clommunity-logo.png|right|100px]]<br />
[[File:Logo_guifi.svg|right|100px]]<br />
<br />
Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> és una distribució basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desenvolupada en el marc del projecte CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref><br />
<br />
Aquesta distribució, inspirada en la idea de l'antiga [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el desplegament i la gestió de serveis de xarxa en el núvol ''(cloud services)''<ref name="cloud-services">Cloud computing: http://ca.wikipedia.org/wiki/Inform%C3%A0tica_en_n%C3%BAvol</ref>, així com la compartició d'aquests. Pensada en particular pels usuaris de les xarxes comunitàries.<ref name="CN">Xarxes comunitàries: http://ca.wikipedia.org/wiki/Xarxa_oberta</ref><br />
<br />
<br />
<br />
----<br />
<br />
<br />
<br />
== Introducció ==<br />
<br />
Abans de l'adopció general de serveis en el núvol ''(cloud services)''<ref name="cloud-services"/> els usuaris de Xarxes Comunitàries <ref name="CN"/> ja compartien o proveïen serveis i recursos a la comunitat; no obstant, aquest usuaris eren una minoria. Una de les principals raons és la barrera tecnològica. Abans de proveir continguts, els usuaris que volen compartir informació amb la comunitat tenen primer que preocupar-se dels aspectes tècnics com el desplegament/muntatge d'un servidor amb un conjunt de serveis.<br />
<br />
En el passat, els usuaris de Guifi.net, intentaren superar aquest problema publicant una distribució GNU/Linux anomenada [[Guinux]] <ref name="guinux"/>, que donava als usuaris finals una solució fàcil per oferir serveis a la comunitat (com ara [[Servidor_Proxy/ca|proxy web]], [[Servidor_DNS/ca|sistemes DNS]], [[Monitor/ca|monitoratge i gràfiques]]).<br />
<br />
La clau principal de [[Guinux]] era un conjunt de ''scripts''<ref>http://ca.wikipedia.org/wiki/Script_%28inform%C3%A0tica%29</ref> que automatitzaven el procés de configuració. Els usuaris només havien d'introduir uns pocs paràmetres com l'adreça de correu electrònic i l'identificador del node. Aviat, després d'estar disponible la distribució, el nombre d'usuaris compartint recursos va proliferar.<br />
<br />
D'acord amb això, va quedar clar que reduint (o eliminant) la barrera d'entrada tecnològica animava als usuaris a proveir de més serveis i compartir els seus recursos amb la comunitat. Per a tal fi, un dels objectius principals del projecte CLOMMUNITY <ref name="clommunity"/> és publicar una distribució GNU/Linux, anomenada Cloudy, dirigida als usuaris, per a fomentar la transició i adopció de l'entorn Cloud a xarxes comunitàries ''(Community Network Cloud)''.<br />
<br />
<br />
=== Motivació === <br />
<br />
La distribució Cloudy s'ha pensat per satisfer els següents requisits:<br />
<br />
# '''Distribució''': per a potenciar la distribució de serveis a les xarxes comunitàries (XC); és necessària una plataforma per a publicar i descobrir aquests serveis. D'aquesta manera, l'accés als serveis no depèn de desplegaments estàtics de xarxes i és conscient de les condicions dinàmicament canviants de les XC. El programari escollit per a la publicació i descobriment de serveis és Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.<br />
# '''Descentralització''': una capa de xarxa comuna és necessària per permetre a tots els nodes del núvol comunicar-se entre ells directament. Una bona manera de construir això es crear una "capa 2 virtual" basada en un servei VPN<ref>Xarxa Privada Virtual: http://ca.wikipedia.org/wiki/Xarxa_privada_virtual</ref>. Entre les opcions disponibles, ha estat escollit Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ja que compleix tots els requisits i és senzill de configurar i administrar. Per a coordinar els dispositius amb Tinc VPN, s'ha desenvolupat una eina per automatitzar el desplegament del sistema. Aquest software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, s'encarrega del procés de configuració de Tinc VPN i de l'intercanvi de claus amb la resta de nodes del núvol.<br />
# '''Facilitat d'ús i experiència d'usuari''': per a aquest fi, s'ha desenvolupat una plataforma web d'administració destinada a integrar la instal·lació i configuració dels serveis al núvol habilitats en la distribució Cloudy. Una interfície web simple i agradable<ref>Interfície web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> està disponible pels usuaris com a solució fàcil de configuració, administració i monitoratge dels serveis ''cloud'' actius al node.<br />
# '''Programari lliure''': la distribució està basada en Debian GNU/Linux<ref name="debian"/>. Apart de ser una de les distribucions més populars i complir tots els requisits tècnics, ha estat escollida degut a que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda i garanteix que el programari serà sempre obert i lliure.<br />
<br />
<br />
<br />
== Requisits mínims ==<br />
<br />
Al ser una sistema basat en Debian, té el mateixos requisits de hardware.<ref>Requisits mínims: https://www.debian.org/releases/stable/i386/ch03s04.html.ca</ref><br />
<br />
La imatge del sistema Cloudy porta una sèrie de configuracions i paquets addicionals; per la qual cosa fa que siguin necessaris al voltant de '''450 MiB de espai d'emmagatzematge'''.<br />
<br />
Tot i això, és '''recomenable''' comptar amb '''al menys 1 GiB'''.<br />
<br />
<br />
Si és volen fer servir alguns serveis com PeerStreamer (llegir més avall) els requisits mínims augmentaran, tant d'espai com de memòria i processament.<br />
<br />
<br />
<br />
== Aconseguir Cloudy ==<br />
<br />
Actualment pots obtenir la distribució Cloudy mitjançant la descarrega d'una imatge ISO per gravar en un CD o memòria USB, o d'un ''template'' per executar directament a una màquina virtual (contenidor LXC<ref>Linux containers (LXC): https://linuxcontainers.org/</ref> o OpenVZ<ref>http://openvz.org</ref>).<br />
<br />
Alternativament pots baixar-te el codi i compilar-ho tu mateix.<br />
<br />
<br />
=== Descarrega la imatge ===<br />
<br />
Ves a la pàgina de Cloudy on estan les imatges emmagatzemades:<br />
<br />
http://repo.clommunity-project.eu/images/<br />
<br />
Actualment encara està en desenvolupament i '''disponible només a la branca ''unstable'''''.<br />
<br />
Allà trobaràs:<br />
<br />
* cloudy.README - Relació de paquets addicionals inclosos a la imatge del sistema.<br />
* cloudy.container.tar.gz - ''Template'' per a crear una VM.<br />
* cloudy.iso - Imatge ISO<br />
<br />
==== Grabar la imatge ISO (Linux) ====<br />
<br />
Els fitxers ISO són ''live install CD images'', és a dir, tenen un sistema d'instal·lació que s'executa just al iniciar la màquina des del dispositiu (CD/DVD/USB).<br />
<br />
Pots gravar-ho:<br />
<br />
* En un CD o DVD:<br />
<br />
$ apt-get install xorriso<br />
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso<br />
<br />
* En una memòria USB:<br />
<br />
$ dd if=cloudy.iso of=${USBSTICK}<br />
<br />
<br />
=== Compilar ===<br />
<br />
Per a construir o compilar Cloudy es necessiten alguns programes a la màquina per tal de poder descarregar les fonts, generar els binaris, manipular les images ISO, etc.<br />
<br />
1. Descarregar els paquets necessaris (exemple amb el apt dels sistemes basats en Debian):<br />
sudo apt-get install build-essential live-build imagemagick curl debootstrap git unzip <br />
<br />
2. Descarregar el "constructor" ''LBmake'' (Live-Build Make) per crear la imatge:<br />
git clone https://github.com/Clommunity/lbmake<br />
<br />
3. Compilar i generar la imatge ISO (i el Linux Container):<br />
<br />
* Anar al directori on s'ha baixat el codi del ''LBmake'' i compilar utilitzant l'eina de Linux ''make'':<br />
cd lbmake<br />
sudo make<br />
<br />
4. Un cop generada la imatge pots provar-la virtualitzant el sistema amb QEMU.<ref>QEMU processor emulator: http://wiki.qemu.org/Main_Page</ref><br />
<br />
* Generar una imatge de disc i utilitzar la imatge ISO com a Live CD per a la instal·lació:<br />
qemu-img create -f qcow2 disk.qcow2 4G<br />
qemu-system-i386 -enable-kvm -cdrom devel/binary.hybrid.iso -hda disk.qcow2<br />
<br />
''NOTA: si tens una màquina relativament recent, afegint l'opció '-enable-kvm' aprofita la virtualització per hardware fent-ho més ràpid.''<br />
<br />
==== Linux container ====<br />
<br />
Opcionalment, apart de la imatge ISO es pot crear un ''Linux Container'' amb la següent comanda:<br />
sudo make container<br />
<br />
''NOTA: abans de generar el contenidor primer s'ha d'haver creat la imatge ISO. En cas que no fos així, la comanda anterior generarà primer la ISO i després el contenidor.''<br />
<br />
== Instal·lació ==<br />
<br />
Com s'explica a la introducció, la distribució Cloudy està basada en Debian GNU/Linux i continguda en una imatge ISO ''live''.<br />
<br />
Pots provar a arrencar el sistema des del dispositiu extern (CD/DVD/USB) o bé iniciar el procés d'instal·lació, seleccionant la opció corresponent al menú.<br />
<br />
[[File:cloudy-boot-install.png|center]]<br />
<br />
La instal·lació és igual que amb un Debian estàndard <ref>Debian installation procedure: http://www.debian.org/releases/stable/i386/</ref>, i els passos es poden resumir en: <br />
<br />
# Escollir la opció ''Install'' en el menú d'inici. (min 0:06)<br />
# Seleccionar l'idioma per defecte de la instal·lacció i del sistema. (min 0:12)<br />
# Seleccionar la teva ubicació. (min 0:16)<br />
# Seleccionar el mapa de teclat. (min 0:19)<br />
# Canviar/assignar el nom del sistema. (min 1:21)<br />
# Afegir la contrasenya de ''root''. (min 1:37)<br />
# Crear un nou compte d'usuari amb contrasenya. (min 1:45)<br />
# Particionar el disc. En el exemple s'ha utilitzat tot el disc amb una sola partició. (min 2:02)<br />
# Configurar el gestor de paquets, afegint una rèplica de l'arxiu (repositori) de Debian més proper. (min 3:10)<br />
# Instal·lar carregador (''boot loader'') GRUB al registre mestre d'arrencada del disc (''master boot record''). (min 4:34)<br />
# Finalitzar la instal·lació per reiniciar la màquina i iniciar el nou sistema. (min 4:43)<br />
<br />
''NOTA: les referències en parèntesi corresponen al moment aproximat en el exemple en vídeo <ref>Cloudy installation: http://videos.guifi.net/guifimedia/@cloudy/Cloudy%20installation.mp4</ref> del procés d'instal·lació.''<br />
<br />
<br />
<br />
== Com actualitzar ==<br />
<br />
El sistema d'actualització permet comprovar i actualitzar els paquets propis de Cloudy per tal de no haver de reinstal·lar el sistema ni perdre cap dada.<br />
<br />
En la versió actual, anant al menú '''''System > Update''''', es pot comprovar si hi ha una versió nova dels paquets de Cloudy i actualitzar-los un a un. També permet fer un ''upgrade'' general del sistema (paquets de Debian).<br />
<br />
[[File:cloudy-update.png|center|1024px]]<br />
<br />
<br />
<br />
== Primers passos ==<br />
<br />
Per accedir al sistema de configuració es fa mitjançant un navegador web a l''''adreça''' de la màquina servidor i '''port 7000'''.<br />
http://ADREÇA_IP:7000<br />
<br />
Credencials:<br />
* '''Usuari:''' root<br />
* '''Contrasenya:''' root ''(per defecte al container, seleccionada a l'instal·lació)''<br />
<br />
[[File:cloudy-home.png|center|1024px]]<br />
<br />
<br />
Un cop dins podem veure la pàgina inicial amb informació general del sistema i un menú superior amb diferents seccions, dividit en dues parts.<br />
<br />
1. A l''''esquerra''' tenim les opcions de configuració i monitoratge del '''sistema'''.<br />
<br />
* '''Cloudy:''' pàgina d'inici.<br />
* '''System:''' configuració de l'usuari, actualitzacions, desconnexió.<br />
* '''Languages:''' selecció de l'idioma.<br />
<br />
<br />
2. A la '''dreta''' tenim les opcions de configuració i gestió dels '''serveis'''.<br />
* '''Search:''' eines per anunciar i cercar serveis en la xarxa. Permet utilitzar diferents programes per a aquest propòsit.<br />
* '''Clommunity:''' serveis introduïts al projecte CLOMMUNITY.<br />
* '''Guifi.net:''' serveis habituals utilitzats a la xarxa de Guifi.net.<br />
<br />
<br />
=== Serveis ===<br />
<br />
A continuació podeu veure quins serveis hi ha actualment disponibles a Cloudy per ser configurats fàcilment a través de l'interfície web.<br />
<br />
''"Per fer: explicació de cadascun dels serveis (es pot veure en anglès a la pàgina web de Cloudy <ref>Cloudy contents: http://cloudy.community/features/</ref>)"''<br />
<br />
<br />
==== Clommunity ====<br />
* Getinconf (gestió del client TincVPN)<br />
* OpenVZ Web Panel (gestió de màquines virtuals)<br />
* Peer Streamer (streaming distribuït)<br />
* Syncthing (sincronització de fitxers en xarxa)<br />
* Tahofe-LAFS (sistema de fitxers distribuït)<br />
* Webdav server<br />
<br />
==== Guifi ====<br />
* Proxy3 (web proxy)<br />
[[File:cloudy-guifi-proxy.png|center]]<br />
<br />
* SNPServices (monitoratge/gràfiques)<br />
[[File:cloudy-guifi-snpservices.png|center]]<br />
<br />
* DNSServices (DNS)<br />
[[File:cloudy-guifi-dnsservices.png|center]]<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
* http://cloudy.community<br />
* http://wiki.clommunity-project.eu/soft:cloudservices<br />
* http://clommunity-project.eu<br />
* http://guifi.net<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Categoria:CloudyCategoria:Cloudy2015-01-26T17:26:56Z<p>Conxuro: </p>
<hr />
<div>Més informació (en anglès):<br />
* http://cloudy.community<br />
* http://wiki.clommunity-project.eu/soft:cloudservices</div>Conxurohttp://ca.wiki.guifi.net/wiki/Qu%C3%A8_%C3%A9s_CloudyQuè és Cloudy2015-01-26T16:48:21Z<p>Conxuro: </p>
<hr />
<div>[[File:clommunity-logo.png|right|100px]]<br />
[[File:Logo_guifi.svg|right|100px]]<br />
<br />
Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> és una distribució basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desenvolupada en el marc del projecte CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref><br />
<br />
Aquesta distribució, inspirada en la idea de l'antiga [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el desplegament i la gestió de serveis de xarxa en el núvol ''(cloud services)''<ref name="cloud-services">Cloud computing: http://ca.wikipedia.org/wiki/Inform%C3%A0tica_en_n%C3%BAvol</ref>, així com la compartició d'aquests. Pensada en particular pels usuaris de les xarxes comunitàries.<ref name="CN">Xarxes comunitàries: http://ca.wikipedia.org/wiki/Xarxa_oberta</ref><br />
<br />
<br />
<br />
----<br />
<br />
<br />
<br />
== Introducció ==<br />
<br />
Abans de l'adopció general de serveis en el núvol ''(cloud services)''<ref name="cloud-services"/> els usuaris de Xarxes Comunitàries <ref name="CN"/> ja compartien o proveïen serveis i recursos a la comunitat; no obstant, aquest usuaris eren una minoria. Una de les principals raons és la barrera tecnològica. Abans de proveir continguts, els usuaris que volen compartir informació amb la comunitat tenen primer que preocupar-se dels aspectes tècnics com el desplegament/muntatge d'un servidor amb un conjunt de serveis.<br />
<br />
En el passat, els usuaris de Guifi.net, intentaren superar aquest problema publicant una distribució GNU/Linux anomenada [[Guinux]] <ref name="guinux"/>, que donava als usuaris finals una solució fàcil per oferir serveis a la comunitat (com ara [[Servidor_Proxy/ca|proxy web]], [[Servidor_DNS/ca|sistemes DNS]], [[Monitor/ca|monitoratge i gràfiques]]).<br />
<br />
La clau principal de [[Guinux]] era un conjunt de ''scripts''<ref>http://ca.wikipedia.org/wiki/Script_%28inform%C3%A0tica%29</ref> que automatitzaven el procés de configuració. Els usuaris només havien d'introduir uns pocs paràmetres com l'adreça de correu electrònic i l'identificador del node. Aviat, després d'estar disponible la distribució, el nombre d'usuaris compartint recursos va proliferar.<br />
<br />
D'acord amb això, va quedar clar que reduint (o eliminant) la barrera d'entrada tecnològica animava als usuaris a proveir de més serveis i compartir els seus recursos amb la comunitat. Per a tal fi, un dels objectius principals del projecte CLOMMUNITY <ref name="clommunity"/> és publicar una distribució GNU/Linux, anomenada Cloudy, dirigida als usuaris, per a fomentar la transició i adopció de l'entorn Cloud a xarxes comunitàries ''(Community Network Cloud)''.<br />
<br />
<br />
=== Motivació === <br />
<br />
La distribució Cloudy s'ha pensat per satisfer els següents requisits:<br />
<br />
# '''Distribució''': per a potenciar la distribució de serveis a les xarxes comunitàries (XC); és necessària una plataforma per a publicar i descobrir aquests serveis. D'aquesta manera, l'accés als serveis no depèn de desplegaments estàtics de xarxes i és conscient de les condicions dinàmicament canviants de les XC. El programari escollit per a la publicació i descobriment de serveis és Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.<br />
# '''Descentralització''': una capa de xarxa comuna és necessària per permetre a tots els nodes del núvol comunicar-se entre ells directament. Una bona manera de construir això es crear una "capa 2 virtual" basada en un servei VPN<ref>Xarxa Privada Virtual: http://ca.wikipedia.org/wiki/Xarxa_privada_virtual</ref>. Entre les opcions disponibles, ha estat escollit Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ja que compleix tots els requisits i és senzill de configurar i administrar. Per a coordinar els dispositius amb Tinc VPN, s'ha desenvolupat una eina per automatitzar el desplegament del sistema. Aquest software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, s'encarrega del procés de configuració de Tinc VPN i de l'intercanvi de claus amb la resta de nodes del núvol.<br />
# '''Facilitat d'ús i experiència d'usuari''': per a aquest fi, s'ha desenvolupat una plataforma web d'administració destinada a integrar la instal·lació i configuració dels serveis al núvol habilitats en la distribució Cloudy. Una interfície web simple i agradable<ref>Interfície web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> està disponible pels usuaris com a solució fàcil de configuració, administració i monitoratge dels serveis ''cloud'' actius al node.<br />
# '''Programari lliure''': la distribució està basada en Debian GNU/Linux<ref name="debian"/>. Apart de ser una de les distribucions més populars i complir tots els requisits tècnics, ha estat escollida degut a que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda i garanteix que el programari serà sempre obert i lliure.<br />
<br />
<br />
<br />
== Requisits mínims ==<br />
<br />
Al ser una sistema basat en Debian, té el mateixos requisits de hardware.<ref>Requisits mínims: https://www.debian.org/releases/stable/i386/ch03s04.html.ca</ref><br />
<br />
La imatge del sistema Cloudy porta una sèrie de configuracions i paquets addicionals; per la qual cosa fa que siguin necessaris al voltant de '''450 MiB de espai d'emmagatzematge'''.<br />
<br />
Tot i això, és '''recomenable''' comptar amb '''al menys 1 GiB'''.<br />
<br />
<br />
Si és volen fer servir alguns serveis com PeerStreamer (llegir més avall) els requisits mínims augmentaran, tant d'espai com de memòria i processament.<br />
<br />
<br />
<br />
== Aconseguir Cloudy ==<br />
<br />
Actualment pots obtenir la distribució Cloudy mitjançant la descarrega d'una imatge ISO per gravar en un CD o memòria USB, o d'un ''template'' per executar directament a una màquina virtual (contenidor LXC<ref>Linux containers (LXC): https://linuxcontainers.org/</ref> o OpenVZ<ref>http://openvz.org</ref>).<br />
<br />
Alternativament pots baixar-te el codi i compilar-ho tu mateix.<br />
<br />
<br />
=== Descarrega la imatge ===<br />
<br />
Ves a la pàgina de Cloudy on estan les imatges emmagatzemades:<br />
<br />
http://repo.clommunity-project.eu/images/<br />
<br />
Actualment encara està en desenvolupament i '''disponible només a la branca ''unstable'''''.<br />
<br />
Allà trobaràs:<br />
<br />
* cloudy.README - Relació de paquets addicionals inclosos a la imatge del sistema.<br />
* cloudy.container.tar.gz - ''Template'' per a crear una VM.<br />
* cloudy.iso - Imatge ISO<br />
<br />
==== Grabar la imatge ISO (Linux) ====<br />
<br />
Els fitxers ISO són ''live install CD images'', és a dir, tenen un sistema d'instal·lació que s'executa just al iniciar la màquina des del dispositiu (CD/DVD/USB).<br />
<br />
Pots gravar-ho:<br />
<br />
* En un CD o DVD:<br />
<br />
$ apt-get install xorriso<br />
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso<br />
<br />
* En una memòria USB:<br />
<br />
$ dd if=cloudy.iso of=${USBSTICK}<br />
<br />
<br />
=== Compilar ===<br />
<br />
Per a construir o compilar Cloudy es necessiten alguns programes a la màquina per tal de poder descarregar les fonts, generar els binaris, manipular les images ISO, etc.<br />
<br />
1. Descarregar els paquets necessaris (exemple amb el apt dels sistemes basats en Debian):<br />
sudo apt-get install build-essential live-build imagemagick curl debootstrap git unzip <br />
<br />
2. Descarregar el "constructor" ''LBmake'' (Live-Build Make) per crear la imatge:<br />
git clone https://github.com/Clommunity/lbmake<br />
<br />
3. Compilar i generar la imatge ISO (i el Linux Container):<br />
<br />
* Anar al directori on s'ha baixat el codi del ''LBmake'' i compilar utilitzant l'eina de Linux ''make'':<br />
cd lbmake<br />
sudo make<br />
<br />
4. Un cop generada la imatge pots provar-la virtualitzant el sistema amb QEMU.<ref>QEMU processor emulator: http://wiki.qemu.org/Main_Page</ref><br />
<br />
* Generar una imatge de disc i utilitzar la imatge ISO com a Live CD per a la instal·lació:<br />
qemu-img create -f qcow2 disk.qcow2 4G<br />
qemu-system-i386 -enable-kvm -cdrom devel/binary.hybrid.iso -hda disk.qcow2<br />
<br />
''NOTA: si tens una màquina relativament recent, afegint l'opció '-enable-kvm' aprofita la virtualització per hardware fent-ho més ràpid.''<br />
<br />
==== Linux container ====<br />
<br />
Opcionalment, apart de la imatge ISO es pot crear un ''Linux Container'' amb la següent comanda:<br />
sudo make container<br />
<br />
''NOTA: abans de generar el contenidor primer s'ha d'haver creat la imatge ISO. En cas que no fos així, la comanda anterior generarà primer la ISO i després el contenidor.''<br />
<br />
== Instal·lació ==<br />
<br />
Com s'explica a la introducció, la distribució Cloudy està basada en Debian GNU/Linux i continguda en una imatge ISO ''live''.<br />
<br />
Pots provar a arrencar el sistema des del dispositiu extern (CD/DVD/USB) o bé iniciar el procés d'instal·lació, seleccionant la opció corresponent al menú.<br />
<br />
[[File:cloudy-boot-install.png|center]]<br />
<br />
La instal·lació és igual que amb un Debian estàndard <ref>Debian installation procedure: http://www.debian.org/releases/stable/i386/</ref>, i els passos es poden resumir en: <br />
<br />
# Escollir la opció ''Install'' en el menú d'inici. (min 0:06)<br />
# Seleccionar l'idioma per defecte de la instal·lacció i del sistema. (min 0:12)<br />
# Seleccionar la teva ubicació. (min 0:16)<br />
# Seleccionar el mapa de teclat. (min 0:19)<br />
# Canviar/assignar el nom del sistema. (min 1:21)<br />
# Afegir la contrasenya de ''root''. (min 1:37)<br />
# Crear un nou compte d'usuari amb contrasenya. (min 1:45)<br />
# Particionar el disc. En el exemple s'ha utilitzat tot el disc amb una sola partició. (min 2:02)<br />
# Configurar el gestor de paquets, afegint una rèplica de l'arxiu (repositori) de Debian més proper. (min 3:10)<br />
# Instal·lar carregador (''boot loader'') GRUB al registre mestre d'arrencada del disc (''master boot record''). (min 4:34)<br />
# Finalitzar la instal·lació per reiniciar la màquina i iniciar el nou sistema. (min 4:43)<br />
<br />
''NOTA: les referències en parèntesi corresponen al moment aproximat en el exemple en vídeo <ref>Cloudy installation: http://videos.guifi.net/guifimedia/2014-05%20Cloudy,%20the%20community%20distro/cloudy-installation.mp4</ref> del procés d'instal·lació.''<br />
<br />
<br />
<br />
== Com actualitzar ==<br />
<br />
El sistema d'actualització permet comprovar i actualitzar els paquets propis de Cloudy per tal de no haver de reinstal·lar el sistema ni perdre cap dada.<br />
<br />
En la versió actual, anant al menú '''''System > Update''''', es pot comprovar si hi ha una versió nova dels paquets de Cloudy i actualitzar-los un a un. També permet fer un ''upgrade'' general del sistema (paquets de Debian).<br />
<br />
[[File:cloudy-update.png|center|1024px]]<br />
<br />
<br />
<br />
== Primers passos ==<br />
<br />
Per accedir al sistema de configuració es fa mitjançant un navegador web a l''''adreça''' de la màquina servidor i '''port 7000'''.<br />
http://ADREÇA_IP:7000<br />
<br />
Credencials:<br />
* '''Usuari:''' root<br />
* '''Contrasenya:''' root ''(per defecte al container, seleccionada a l'instal·lació)''<br />
<br />
[[File:cloudy-home.png|center|1024px]]<br />
<br />
<br />
Un cop dins podem veure la pàgina inicial amb informació general del sistema i un menú superior amb diferents seccions, dividit en dues parts.<br />
<br />
1. A l''''esquerra''' tenim les opcions de configuració i monitoratge del '''sistema'''.<br />
<br />
* '''Cloudy:''' pàgina d'inici.<br />
* '''System:''' configuració de l'usuari, actualitzacions, desconnexió.<br />
* '''Languages:''' selecció de l'idioma.<br />
<br />
<br />
2. A la '''dreta''' tenim les opcions de configuració i gestió dels '''serveis'''.<br />
* '''Search:''' eines per anunciar i cercar serveis en la xarxa. Permet utilitzar diferents programes per a aquest propòsit.<br />
* '''Clommunity:''' serveis introduïts al projecte CLOMMUNITY.<br />
* '''Guifi.net:''' serveis habituals utilitzats a la xarxa de Guifi.net.<br />
<br />
<br />
=== Serveis ===<br />
<br />
A continuació podeu veure quins serveis hi ha actualment disponibles a Cloudy per ser configurats fàcilment a través de l'interfície web.<br />
<br />
''"Per fer: explicació de cadascun dels serveis (es pot veure en anglès a la pàgina web de Cloudy <ref>Cloudy contents: http://cloudy.community/features/</ref>)"''<br />
<br />
<br />
==== Clommunity ====<br />
* Getinconf (gestió del client TincVPN)<br />
* OpenVZ Web Panel (gestió de màquines virtuals)<br />
* Peer Streamer (streaming distribuït)<br />
* Syncthing (sincronització de fitxers en xarxa)<br />
* Tahofe-LAFS (sistema de fitxers distribuït)<br />
* Webdav server<br />
<br />
==== Guifi ====<br />
* Proxy3 (web proxy)<br />
[[File:cloudy-guifi-proxy.png|center]]<br />
<br />
* SNPServices (monitoratge/gràfiques)<br />
[[File:cloudy-guifi-snpservices.png|center]]<br />
<br />
* DNSServices (DNS)<br />
[[File:cloudy-guifi-dnsservices.png|center]]<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
* http://cloudy.community<br />
* http://wiki.clommunity-project.eu/soft:cloudservices<br />
* http://clommunity-project.eu<br />
* http://guifi.net<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/PortadaPortada2014-10-22T15:24:39Z<p>Conxuro: /* Sistemes */</p>
<hr />
<div>__NOTITLE__<br />
{| style="background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em; width:100%;"<br />
| valign="top" style="padding:12px 17px 5px 17px" |<br />
'''Guifi.net''' és de tothom, participa-hi [[connectar|connectant]] el teu [[tram de xarxa]] amb el dels altres.<br />
<br />
És un projecte col·laboratiu [[organització horitzontal|organitzat horitzontalment]] que agrupa tan a persones individuals, col·lectius, empreses i administracions.<br />
<br />
És obert i per tant tothom hi pot participar en igualtat de condicions en el marc del [http://guifi.net/ComunsXOLN Comuns de la Xarxa Oberta, Lliure i Neutral]<br />
<div style=" text-align: right">[[Guifi.net|Més sobre Guifi.net]]</div><br />
{| style="width:100%; background:#f6f6f6"<br />
| 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;">Benvinguda al wiki de '''Guifi.net'''</div><br />
<div style="font-size: 95%;">Documentació sobre la xarxa oberta, lliure i neutral.</div><br />
<div style="font-size: 85%;">En aquests moments tenim [[Especial:Estadístiques|{{NUMBEROFARTICLES}}]] [[Especial:Llista_de_pàgines|articles]] en català.</div><br />
<div style="font-size: 85%;">Ajuda [[Què és un wiki#Categories|categoritzant]] un dels [[Especial:Pàgines_sense_categoria|articles sense categoritzar]], pots fer servir les [[Especial:Categories|categories ja existents]].</div><br />
</div><br />
|}<br />
{| style="background:#f6f6f6; width:100%;"<br />
|''A la documentació de guifi.net hi ha els documents de referència per a usuaris novells, experimentats i desenvolupadors. Sigues lliure [[Què és un wiki|d'editar aquest wiki]] per millorar-ne el seu contingut.''<br />
<div style=" text-align: center">Contacta: [http://guifi.net/forum Fòrums] '''|''' [http://llistes.guifi.net Llistes de correu] '''|''' [http://guifi.net/xat Xat]</div><br />
|}<br />
|}<br />
<br />
<br />
{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"<br />
| 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;" | <br />
<br />
<div id="mp-tfa"><!--Selector per a [[meta:Mobile]]--><br />
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"<br />
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Com unir-se a Guifi.net<br />
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" | <br />
|-<br />
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;"><br />
<br />
* [[tres passos|Com donar d'alta i enllaçar un node]]<br />
* [[Escull el material]]<br />
* [[Configura el teu ordinador]]<br />
* [http://guifi.net/ca/BonesPractiques Bones pràctiques]<br />
<br />
|}</div><br />
<br />
| style="border:1px solid transparent;" |<br />
| 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; " | <br />
<div id="mp-itn"><br />
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"<br />
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodes i illes<br />
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" | <br />
|-<br />
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;"><br />
* [[Començar una illa des de 0]]<br />
* [[Crear un supernode]]<br />
* [http://guifi.net/ca/BonesPractiques Bones pràctiques]</div></div><br />
|}</div><br />
|}<br />
<br />
{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"<br />
| 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; " | <br />
<div id="mp-dyk"><br />
<br />
<div style="float:right;">__TOC__</div><br />
== [[Legal]] ==<br />
* [[Particulars]]<br />
* [[Institucions]]<br />
* [[Empreses]]<br />
* [[Serveis_General]]<br />
* [[Associació|Constitució d'una associació]]<br />
<br />
== Finançament ==<br />
* [[Models de finançament]]<br />
<br />
== Xarxa ==<br />
=== Els bàsics a la web ===<br />
* [[Zona|Crear i modificar una zona]]<br />
* [[Afegir_un_node_de_guifi.net|Afegir un node de guifi.net]]<br />
* [[Serveis|Crear serveis i vincular-los als servidors]]<br />
* [[Usuaris dels Proxys Federats]]<br />
* [[Eines|Eines (localització de IPs i MACs, estadístiques, mapes d'enrutament, etc.)]]<br />
<br />
=== Infraestructura ===<br />
{{div col|cols=2}}<br />
* [[Crear_un_supernode|Muntatge de supernodes]]<br />
* [[Filtres de xarxes]]<br />
* [[Enllaços virtuals]]<br />
* [[Node frontera amb qMp]]<br />
* [[Hotspot]]<br />
* [[Eina per buscar rangs de IPs lliures]]<br />
* [[Creació de túnels PPTP (Debian/dd-wrt/Mikrotik)]]<br />
* [[PPTP_airos|Tunel PPTP desde antena AirOS]]<br />
* [[Script per detectar problemes de latència]]<br />
* [[Tweaks antenes]]<br />
* [[Fibra_òptica|Fibra Òptica]]<br />
* [[Gestio_vlans_ubnt_supernode|Vlan de gestió ubnt en supernode híbrid]]<br />
* [[Toughswitch_supernode_hibrid|Gestió supernode híbrid amb vlan i toughswitch]]<br />
* [[Fer_bonding_de_dues_ADSL_amb_Routerboard|Fer bonding de dues ADSL amb una Routerboard]]<br />
* [[Calcul_RF|Càlculs RF]]<br />
{{div end}}<br />
<br />
=== Mesh ===<br />
* [[Obrir_xarxes_tipus_mesh_a_trav%C3%A9s_de_Guifi.net|Crear una xarxa Mesh en Guifi.net]]<br />
* [[Connectar-se_a_una_xarxa_mesh|Connectar-se a una xarxa Mesh de Guifi.net]]<br />
* [[Annex:subxarxes_mesh|Llistat de les xarxes Mesh]]<br />
* [[Quick Mesh Project (qMp)]] ([[:es:Quick Mesh Project|es]])<br />
* [[Alix+GSF|Configurar Àlix per connectar-se al núvol Mesh de gràcia amb gsffirm]] (antic) ([[:es:Alix|es]])<br />
* [[Altermesh]] (roaming mesh en Capa 2 amb BATMAN-adv) ([[:es:Altermesh|es]])<br />
* [[Mesh|Altres articles sobre Mesh]]<br />
<br />
=== Enrutaments i conceptes de xarxes ===<br />
{{div col|cols=2}}<br />
* [[Enrutament]] --General--<br />
* [[Peerings]]<br />
* [[Tunejant salts-BGP PREPEND ]]<br />
* [[Redundància BGP-OSPF-BGP ]] <br />
* [[Agregacions BGP ]]<br />
* [[Pesos BGP]]<br />
* [[BGP 2 AS en 1 AS]] (útil per a supernodes amb 2 mikrotiks)<br />
* [[IPv4]]<br />
* [[IPv6]]<br />
* [[Criteris d'assignació d'adreces IPv4]]<br />
* [[ARP]]<br />
* [[Cables_UTP|Cables UTP]]<br />
* [http://packetlife.net/library/cheat-sheets/ Resum de conceptes de xarxa]<br />
{{div end}}<br />
<br />
=== General ===<br />
{{div col|cols=2}}<br />
* [[Com es vertebra la xarxa: Troncal, punts d'accés i connexions simples]]<br />
* [[La seguretat a la xarxa oberta]]<br />
* [[Aplicacions | Aplicacions de Guifi.net]]<br />
* [[Recursos externs]]<br />
* [[Instal·lar firmware Ubiquiti Rocket M5]]<br />
{{div end}}<br />
<br />
== Sistemes ==<br />
=== Serveis bàsics ===<br />
{{div col|cols=2}}<br />
* [[Configurar Repositori apt guifi]]<br />
* [[Servidor Proxy]]<br />
* [[Servidor de gràfiques]]<br />
* [[Servidor DNS]]<br />
* [[Servidor Rellotge|Servidor de Rellotge (NTP)]]<br />
* [[Servidor logs remots rsyslogd ]]<br />
* [[Configurar xarxa]]<br />
{{div end}}<br />
<br />
=== Serveis de compartició de fitxers ===<br />
* [[Servidor FTP]]<br />
* [[Servidor Peer 2 Peer]]<br />
* [[Servidor DCC]]<br />
<br />
=== Serveis de missatgeria ===<br />
* [[Servidor de Correu]]<br />
* [[Webmail]]<br />
* [[Servidor Jabber]]<br />
* [[Servidor IRC]]<br />
* [[Mailman]]<br />
* [[Whatsapp]]<br />
<br />
=== Serveis de Veu i Vídeo ===<br />
* [[VoIP|Servidor de VeuIP (VoIP)]]<br />
* [[Servidor Radio Streaming]]<br />
<br />
=== Altres Serveis ===<br />
{{div col|cols=2}}<br />
* [[LDAP|Servidor LDAP]]<br />
* [[Apache|Servidor web Apache]]<br />
* [[Servidor Repositori Linux]]<br />
* [[Servidor Repositori Linux (Cache)]]<br />
* [[Servidor Iperf]]<br />
* [[Servidor repositori subversion]]<br />
* [[DHCP|Servidor DHCP]]<br />
* [[MySQL]] (Bases de Dades)<br />
* [[Proxmox]] (virtualització)<br />
* [[Cacti]] (monitoratge)<br />
* [[Servei de notificació d'incidencies]] (Servei de notificació d'incidencies)<br />
* [[Monitoratge_Cacti_UBNT|Cacti per a trastos UBNT]]<br />
* [[Clamav]] (antivirus amb GNU/Linux)<br />
* [[Trac]] (sistema de gestió de tiquets)<br />
* [[Squid]] (configuracions avançades squid)<br />
* [[PXE]] (Instal·lació per xarxa)<br />
* [http://www.example.com Observium] (Monitoratge molt gràfic, GPL)<br />
{{div end}}<br />
<br />
=== Sistema ===<br />
* [[ACPI]]<br />
* [[Bridges_amb_Linux|Bridges amb GNU/Linux]]<br />
* [[Chroot]]<br />
* [[Corkscrew]]<br />
* [[Túnel Proxy SOCKS]]<br />
* [[Manteniment_de_discs_durs|Manteniment de discs durs]]<br />
<br />
=== Cloudy ===<br />
* [[Què és Cloudy]]<br />
* [[Cloudy|Altres articles sobre Cloudy]]<br />
<br />
== Instal·ladors ==<br />
* [[Parallamps]]<br />
* [[Reaprofitar el cable d'antena de televisió]]<br />
* [[Pressupostos]]<br />
* [[Utilitzar RB Mikrotik com a tunel PPPoE Movistar-Jazztel-altres]]<br />
* [http://guifi.net/ca/node/12486 Comunitat de veïns, cas d'exemple]<br />
* [[Configuració de l'antena per a les gràfiques (SNMP)]]<br />
* [[Campanars]]<br />
<br />
== Desenvolupadors ==<br />
* [[Manual editor wiki]]<br />
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]<br />
* [[Actualitzacions mòduls drupal]]<br />
* [http://gitorious.org/guifi Repositoris de codi del projecte guifi.net]<br />
* [[Mapa del codi]]<br />
* [[API de Guifi]]<br />
* [[CNML]]<br />
* [[Empotrar el mapa de Guifi-Google Maps a una web]]<br />
* [[Unsolclic]]<br />
* [[Preparant l'entorn de desenvolupament]]<br />
* [[:Categoria:router|Routers]]<br />
* [[:Categoria:Telefonia mòbil|Telefonia mòbil]]<br />
* [[Eficiència energètica]]<br />
<br />
== Dissenyadors ==<br />
* [[Logos]]<br />
* [[Maquetació de les diverses pàgines web]]<br />
* [[Usabilitat]]<br />
* [[Presentacions de guifi.net]]<br />
<br />
== Desenvolupament col·lectiu de la xarxa ==<br />
* [[Cursos]]<br />
* [[Necessitats]]<br />
<br />
== Camp de treball ==<br />
* [http://camp2012.guifi.net Bloc del camp de treball 'Internet per a tothom! Vic 2012]<br />
<br />
== Glossari ==<br />
* [[Recull de termes emprats habitualment]]<br />
* [[Guia Ràpida de Guifi.net]]<br />
* [[Preguntes Freqüents]]<br />
* [http://guifi.net/ca/CADocs Documents ubicats a la web de guifi.net] antiga "ComEsFa"<br />
|}<br />
<br />
= Accessos Ràpids =<br />
* [http://planet.guifi.net Planet]<br />
* [http://guifi.net/cxoln Comuns (Llicència de la xarxa)]<br />
* [http://guifi.net/maps Mapa guifi]<br />
* [[Webs Regionals]]<br />
* [http://trac.guifi.net Reporta Errors de la web]<br />
* [http://fundacio.guifi.net Fundació]<br />
* [http://guifi.net/ca/info Recull de guies i manuals]<br />
* [http://etherpad.guifi.net/serveris-de-guifi Llistat de serveis variats entorn al projecte]<br />
[[es:Portada]]<br />
[[en:Main Page]]<br />
[[eu:Azala]]<br />
[[fr:Accueil]]<br />
[[gl:Portada]]<br />
[[pt:Página principal]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/CloudyCloudy2014-10-22T15:22:55Z<p>Conxuro: Redirecció a Categoria:Cloudy</p>
<hr />
<div>#REDIRECT [[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Qu%C3%A8_%C3%A9s_CloudyQuè és Cloudy2014-10-22T15:19:18Z<p>Conxuro: </p>
<hr />
<div>[[File:clommunity-logo.png|right|100px]]<br />
[[File:Logo_guifi.svg|right|100px]]<br />
<br />
Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> és una distribució basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desenvolupada en el marc del projecte CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref><br />
<br />
Aquesta distribució, inspirada en la idea de l'antiga [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el desplegament i la gestió de serveis de xarxa en el núvol ''(cloud services)''<ref name="cloud-services">Cloud computing: http://ca.wikipedia.org/wiki/Inform%C3%A0tica_en_n%C3%BAvol</ref>, així com la compartició d'aquests. Pensada en particular pels usuaris de les xarxes comunitàries.<ref name="CN">Xarxes comunitàries: http://ca.wikipedia.org/wiki/Xarxa_oberta</ref><br />
<br />
<br />
<br />
----<br />
<br />
<br />
<br />
== Introducció ==<br />
<br />
Abans de l'adopció general de serveis en el núvol ''(cloud services)''<ref name="cloud-services"/> els usuaris de Xarxes Comunitàries <ref name="CN"/> ja compartien o proveïen serveis i recursos a la comunitat; no obstant, aquest usuaris eren una minoria. Una de les principals raons és la barrera tecnològica. Abans de proveir continguts, els usuaris que volen compartir informació amb la comunitat tenen primer que preocupar-se dels aspectes tècnics com el desplegament/muntatge d'un servidor amb un conjunt de serveis.<br />
<br />
En el passat, els usuaris de Guifi.net, intentaren superar aquest problema publicant una distribució GNU/Linux anomenada [[Guinux]] <ref name="guinux"/>, que donava als usuaris finals una solució fàcil per oferir serveis a la comunitat (com ara [[Servidor_Proxy/ca|proxy web]], [[Servidor_DNS/ca|sistemes DNS]], [[Monitor/ca|monitoratge i gràfiques]]).<br />
<br />
La clau principal de [[Guinux]] era un conjunt de ''scripts''<ref>http://ca.wikipedia.org/wiki/Script_%28inform%C3%A0tica%29</ref> que automatitzaven el procés de configuració. Els usuaris només havien d'introduir uns pocs paràmetres com l'adreça de correu electrònic i l'identificador del node. Aviat, després d'estar disponible la distribució, el nombre d'usuaris compartint recursos va proliferar.<br />
<br />
D'acord amb això, va quedar clar que reduint (o eliminant) la barrera d'entrada tecnològica animava als usuaris a proveir de més serveis i compartir els seus recursos amb la comunitat. Per a tal fi, un dels objectius principals del projecte CLOMMUNITY <ref name="clommunity"/> és publicar una distribució GNU/Linux, anomenada Cloudy, dirigida als usuaris, per a fomentar la transició i adopció de l'entorn Cloud a xarxes comunitàries ''(Community Network Cloud)''.<br />
<br />
<br />
=== Motivació === <br />
<br />
La distribució Cloudy s'ha pensat per satisfer els següents requisits:<br />
<br />
# '''Distribució''': per a potenciar la distribució de serveis a les xarxes comunitàries (XC); és necessària una plataforma per a publicar i descobrir aquests serveis. D'aquesta manera, l'accés als serveis no depèn de desplegaments estàtics de xarxes i és conscient de les condicions dinàmicament canviants de les XC. El programari escollit per a la publicació i descobriment de serveis és Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.<br />
# '''Descentralització''': una capa de xarxa comuna és necessària per permetre a tots els nodes del núvol comunicar-se entre ells directament. Una bona manera de construir això es crear una "capa 2 virtual" basada en un servei VPN<ref>Xarxa Privada Virtual: http://ca.wikipedia.org/wiki/Xarxa_privada_virtual</ref>. Entre les opcions disponibles, ha estat escollit Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ja que compleix tots els requisits i és senzill de configurar i administrar. Per a coordinar els dispositius amb Tinc VPN, s'ha desenvolupat una eina per automatitzar el desplegament del sistema. Aquest software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, s'encarrega del procés de configuració de Tinc VPN i de l'intercanvi de claus amb la resta de nodes del núvol.<br />
# '''Facilitat d'ús i experiència d'usuari''': per a aquest fi, s'ha desenvolupat una plataforma web d'administració destinada a integrar la instal·lació i configuració dels serveis al núvol habilitats en la distribució Cloudy. Una interfície web simple i agradable<ref>Interfície web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> està disponible pels usuaris com a solució fàcil de configuració, administració i monitoratge dels serveis ''cloud'' actius al node.<br />
# '''Programari lliure''': la distribució està basada en Debian GNU/Linux<ref name="debian"/>. Apart de ser una de les distribucions més populars i complir tots els requisits tècnics, ha estat escollida degut a que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda i garanteix que el programari serà sempre obert i lliure.<br />
<br />
<br />
<br />
== Requisits mínims ==<br />
<br />
Al ser una sistema basat en Debian, té el mateixos requisits de hardware.<ref>Requisits mínims: https://www.debian.org/releases/stable/i386/ch03s04.html.ca</ref><br />
<br />
La imatge del sistema Cloudy porta una sèrie de configuracions i paquets addicionals; per la qual cosa fa que siguin necessaris al voltant de '''450 MiB de espai d'emmagatzematge'''.<br />
<br />
Tot i això, és '''recomenable''' comptar amb '''al menys 1 GiB'''.<br />
<br />
<br />
Si és volen fer servir alguns serveis com PeerStreamer (llegir més avall) els requisits mínims augmentaran, tant d'espai com de memòria i processament.<br />
<br />
<br />
<br />
== Aconseguir Cloudy ==<br />
<br />
Actualment pots obtenir la distribució Cloudy mitjançant la descarrega d'una imatge ISO per gravar en un CD o memòria USB, o d'un ''template'' per executar directament a una màquina virtual (contenidor LXC<ref>Linux containers (LXC): https://linuxcontainers.org/</ref> o OpenVZ<ref>http://openvz.org</ref>).<br />
<br />
Alternativament pots baixar-te el codi i compilar-ho tu mateix.<br />
<br />
<br />
=== Descarrega la imatge ===<br />
<br />
Ves a la pàgina de Cloudy on estan les imatges emmagatzemades:<br />
<br />
http://repo.clommunity-project.eu/images/<br />
<br />
Actualment encara està en desenvolupament i '''disponible només a la branca ''unstable'''''.<br />
<br />
Allà trobaràs:<br />
<br />
* cloudy.README - Relació de paquets addicionals inclosos a la imatge del sistema.<br />
* cloudy.container.tar.gz - ''Template'' per a crear una VM.<br />
* cloudy.iso - Imatge ISO<br />
<br />
==== Grabar la imatge ISO (Linux) ====<br />
<br />
Els fitxers ISO són ''live install CD images'', és a dir, tenen un sistema d'instal·lació que s'executa just al iniciar la màquina des del dispositiu (CD/DVD/USB).<br />
<br />
Pots gravar-ho:<br />
<br />
* En un CD o DVD:<br />
<br />
$ apt-get install xorriso<br />
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso<br />
<br />
* En una memòria USB:<br />
<br />
$ dd if=cloudy.iso of=${USBSTICK}<br />
<br />
<br />
=== Compilar ===<br />
<br />
Per a construir o compilar Cloudy es necessiten alguns programes a la màquina per tal de poder descarregar les fonts, generar els binaris, manipular les images ISO, etc.<br />
<br />
1. Descarregar els paquets necessaris (exemple amb el apt dels sistemes basats en Debian):<br />
sudo apt-get install build-essential live-build imagemagick curl debootstrap git unzip <br />
<br />
2. Descarregar el "constructor" ''LBmake'' (Live-Build Make) per crear la imatge:<br />
git clone https://github.com/Clommunity/lbmake<br />
<br />
3. Compilar i generar la imatge ISO (i el Linux Container):<br />
<br />
* Anar al directori on s'ha baixat el codi del ''LBmake'' i compilar utilitzant l'eina de Linux ''make'':<br />
cd lbmake<br />
sudo make<br />
<br />
4. Un cop generada la imatge pots provar-la virtualitzant el sistema amb QEMU.<ref>QEMU processor emulator: http://wiki.qemu.org/Main_Page</ref><br />
<br />
* Generar una imatge de disc i utilitzar la imatge ISO com a Live CD per a la instal·lació:<br />
qemu-img create -f qcow2 disk.qcow2 4G<br />
qemu-system-i386 -enable-kvm -cdrom devel/binary.hybrid.iso -hda disk.qcow2<br />
<br />
''NOTA: si tens una màquina relativament recent, afegint l'opció '-enable-kvm' aprofita la virtualització per hardware fent-ho més ràpid.''<br />
<br />
==== Linux container ====<br />
<br />
Opcionalment, apart de la imatge ISO es pot crear un ''Linux Container'' amb la següent comanda:<br />
sudo make container<br />
<br />
''NOTA: abans de generar el contenidor primer s'ha d'haver creat la imatge ISO. En cas que no fos així, la comanda anterior generarà primer la ISO i després el contenidor.''<br />
<br />
== Instal·lació ==<br />
<br />
Com s'explica a la introducció, la distribució Cloudy està basada en Debian GNU/Linux i continguda en una imatge ISO ''live''.<br />
<br />
Pots provar a arrencar el sistema des del dispositiu extern (CD/DVD/USB) o bé iniciar el procés d'instal·lació, seleccionant la opció corresponent al menú.<br />
<br />
[[File:cloudy-boot-install.png|center]]<br />
<br />
La instal·lació és igual que amb un Debian estàndard <ref>Debian installation procedure: http://www.debian.org/releases/stable/i386/</ref>, i els passos es poden resumir en: <br />
<br />
# Escollir la opció ''Install'' en el menú d'inici. (min 0:06)<br />
# Seleccionar l'idioma per defecte de la instal·lacció i del sistema. (min 0:12)<br />
# Seleccionar la teva ubivació. (min 0:16)<br />
# Seleccionar el mapa de teclat. (min 0:19)<br />
# Canviar/assignar el nom del sistema. (min 1:21)<br />
# Afegir la contrasenya de ''root''. (min 1:37)<br />
# Crear un nou compte d'usuari amb contrasenya. (min 1:45)<br />
# Particionar el disc. En el exemple s'ha utilitzat tot el disc amb una sola partició. (min 2:02)<br />
# Configurar el gestor de paquets, afegint una rèplica de l'arxiu (repositori) de Debian més proper. (min 3:10)<br />
# Instal·lar carregador (''boot loader'') GRUB al registre mestre d'arrencada del disc (''master boot record''). (min 4:34)<br />
# Finalitzar la instal·lació per reiniciar la màquina i iniciar el nou sistema. (min 4:43)<br />
<br />
''NOTA: les referències en parèntesi corresponen al moment aproximat en el exemple en vídeo <ref>Cloudy installation: http://videos.guifi.net/guifimedia/2014-05%20Cloudy,%20the%20community%20distro/cloudy-installation.mp4</ref> del procés d'instal·lació.''<br />
<br />
<br />
<br />
== Com actualitzar ==<br />
<br />
El sistema d'actualització permet comprovar i actualitzar els paquets propis de Cloudy per tal de no haver de reinstal·lar el sistema ni perdre cap dada.<br />
<br />
En la versió actual, anant al menú '''''System > Update''''', es pot comprovar si hi ha una versió nova dels paquets de Cloudy i actualitzar-los un a un. També permet fer un ''upgrade'' general del sistema (paquets de Debian).<br />
<br />
[[File:cloudy-update.png|center|1024px]]<br />
<br />
<br />
<br />
== Primers passos ==<br />
<br />
Per accedir al sistema de configuració es fa mitjançant un navegador web a l''''adreça''' de la màquina servidor i '''port 7000'''.<br />
http://ADREÇA_IP:7000<br />
<br />
Credencials:<br />
* '''Usuari:''' root<br />
* '''Contrasenya:''' root ''(per defecte al container, seleccionada a l'instal·lació)''<br />
<br />
[[File:cloudy-home.png|center|1024px]]<br />
<br />
<br />
Un cop dins podem veure la pàgina inicial amb informació general del sistema i un menú superior amb diferents seccions, dividit en dues parts.<br />
<br />
1. A l''''esquerra''' tenim les opcions de configuració i monitoratge del '''sistema'''.<br />
<br />
* '''Cloudy:''' pàgina d'inici.<br />
* '''System:''' configuració de l'usuari, actualitzacions, desconnexió.<br />
* '''Languages:''' selecció de l'idioma.<br />
<br />
<br />
2. A la '''dreta''' tenim les opcions de configuració i gestió dels '''serveis'''.<br />
* '''Avahi:''' eina per anunciar i cercar serveis en la xarxa.<br />
* '''Clommunity:''' serveis introduïts al projecte CLOMMUNITY.<br />
* '''Guifi.net:''' serveis habituals utilitzats a la xarxa de Guifi.net.<br />
<br />
<br />
=== Serveis ===<br />
<br />
A continuació podeu veure quins serveis hi ha actualment disponibles a Cloudy per ser configurats fàcilment a través de l'interfície web.<br />
<br />
''"Per fer: explicació de cadascun dels serveis"''<br />
<br />
<br />
==== Clommunity ====<br />
* getinconf<br />
* Peer Streamer (streaming distribuït)<br />
* Tahofe-LAFS (sistema de fitxers distribuït)<br />
* Webdav server<br />
<br />
==== Guifi ====<br />
* Proxy3 (web proxy)<br />
[[File:cloudy-guifi-proxy.png|center]]<br />
<br />
* SNPServices (monitoratge/gràfiques)<br />
[[File:cloudy-guifi-snpservices.png|center]]<br />
<br />
* DNSServices<br />
[[File:cloudy-guifi-dnsservices.png|center]]<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
* http://cloudy.community<br />
* http://wiki.clommunity-project.eu/soft:cloudservices<br />
* http://clommunity-project.eu<br />
* http://guifi.net<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Categoria:CloudyCategoria:Cloudy2014-10-22T15:15:49Z<p>Conxuro: Es crea la pàgina amb «Més informació (en anglès): http://cloudy.community http://wiki.clommunity-project.eu/soft:cloudservices».</p>
<hr />
<div>Més informació (en anglès):<br />
http://cloudy.community<br />
http://wiki.clommunity-project.eu/soft:cloudservices</div>Conxurohttp://ca.wiki.guifi.net/wiki/Qu%C3%A8_%C3%A9s_CloudyQuè és Cloudy2014-07-30T14:41:51Z<p>Conxuro: /* Compilar */</p>
<hr />
<div>[[File:clommunity-logo.png|right|100px]]<br />
[[File:Logo_guifi.svg|right|100px]]<br />
<br />
[[Cloudy]] <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> és una distribució basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desenvolupada en el marc del projecte CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref><br />
<br />
Aquesta distribució, inspirada en la idea de l'antiga [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el desplegament i la gestió de serveis de xarxa en el núvol ''(cloud services)''<ref name="cloud-services">Cloud computing: http://ca.wikipedia.org/wiki/Inform%C3%A0tica_en_n%C3%BAvol</ref>, així com la compartició d'aquests. Pensada en particular pels usuaris de les xarxes comunitàries.<ref name="CN">Xarxes comunitàries: http://ca.wikipedia.org/wiki/Xarxa_oberta</ref><br />
<br />
<br />
<br />
----<br />
<br />
<br />
<br />
== Introducció ==<br />
<br />
Abans de l'adopció general de serveis en el núvol ''(cloud services)''<ref name="cloud-services"/> els usuaris de Xarxes Comunitàries <ref name="CN"/> ja compartien o proveïen serveis i recursos a la comunitat; no obstant, aquest usuaris eren una minoria. Una de les principals raons és la barrera tecnològica. Abans de proveir continguts, els usuaris que volen compartir informació amb la comunitat tenen primer que preocupar-se dels aspectes tècnics com el desplegament/muntatge d'un servidor amb un conjunt de serveis.<br />
<br />
En el passat, els usuaris de Guifi.net, intentaren superar aquest problema publicant una distribució GNU/Linux anomenada [[Guinux]] <ref name="guinux"/>, que donava als usuaris finals una solució fàcil per oferir serveis a la comunitat (com ara [[Servidor_Proxy/ca|proxy web]], [[Servidor_DNS/ca|sistemes DNS]], [[Monitor/ca|monitoratge i gràfiques]]).<br />
<br />
La clau principal de [[Guinux]] era un conjunt de ''scripts''<ref>http://ca.wikipedia.org/wiki/Script_%28inform%C3%A0tica%29</ref> que automatitzaven el procés de configuració. Els usuaris només havien d'introduir uns pocs paràmetres com l'adreça de correu electrònic i l'identificador del node. Aviat, després d'estar disponible la distribució, el nombre d'usuaris compartint recursos va proliferar.<br />
<br />
D'acord amb això, va quedar clar que reduint (o eliminant) la barrera d'entrada tecnològica animava als usuaris a proveir de més serveis i compartir els seus recursos amb la comunitat. Per a tal fi, un dels objectius principals del projecte CLOMMUNITY <ref name="clommunity"/> és publicar una distribució GNU/Linux, anomenada Cloudy, dirigida als usuaris, per a fomentar la transició i adopció de l'entorn Cloud a xarxes comunitàries ''(Community Network Cloud)''.<br />
<br />
<br />
=== Motivació === <br />
<br />
La distribució Cloudy s'ha pensat per satisfer els següents requisits:<br />
<br />
# '''Distribució''': per a potenciar la distribució de serveis a les xarxes comunitàries (XC); és necessària una plataforma per a publicar i descobrir aquests serveis. D'aquesta manera, l'accés als serveis no depèn de desplegaments estàtics de xarxes i és conscient de les condicions dinàmicament canviants de les XC. El programari escollit per a la publicació i descobriment de serveis és Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.<br />
# '''Descentralització''': una capa de xarxa comuna és necessària per permetre a tots els nodes del núvol comunicar-se entre ells directament. Una bona manera de construir això es crear una "capa 2 virtual" basada en un servei VPN<ref>Xarxa Privada Virtual: http://ca.wikipedia.org/wiki/Xarxa_privada_virtual</ref>. Entre les opcions disponibles, ha estat escollit Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ja que compleix tots els requisits i és senzill de configurar i administrar. Per a coordinar els dispositius amb Tinc VPN, s'ha desenvolupat una eina per automatitzar el desplegament del sistema. Aquest software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, s'encarrega del procés de configuració de Tinc VPN i de l'intercanvi de claus amb la resta de nodes del núvol.<br />
# '''Facilitat d'ús i experiència d'usuari''': per a aquest fi, s'ha desenvolupat una plataforma web d'administració destinada a integrar la instal·lació i configuració dels serveis al núvol habilitats en la distribució Cloudy. Una interfície web simple i agradable<ref>Interfície web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> està disponible pels usuaris com a solució fàcil de configuració, administració i monitoratge dels serveis ''cloud'' actius al node.<br />
# '''Programari lliure''': la distribució està basada en Debian GNU/Linux<ref name="debian"/>. Apart de ser una de les distribucions més populars i complir tots els requisits tècnics, ha estat escollida degut a que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda i garanteix que el programari serà sempre obert i lliure.<br />
<br />
<br />
<br />
== Requisits mínims ==<br />
<br />
Al ser una sistema basat en Debian, té el mateixos requisits de hardware.<ref>Requisits mínims: https://www.debian.org/releases/stable/i386/ch03s04.html.ca</ref><br />
<br />
La imatge del sistema Cloudy porta una sèrie de configuracions i paquets addicionals; per la qual cosa fa que siguin necessaris al voltant de '''450 MiB de espai d'emmagatzematge'''.<br />
<br />
Tot i això, és '''recomenable''' comptar amb '''al menys 1 GiB'''.<br />
<br />
<br />
Si és volen fer servir alguns serveis com PeerStreamer (llegir més avall) els requisits mínims augmentaran, tant d'espai com de memòria i processament.<br />
<br />
<br />
<br />
== Aconseguir Cloudy ==<br />
<br />
Actualment pots obtenir la distribució Cloudy mitjançant la descarrega d'una imatge ISO per gravar en un CD o memòria USB, o d'un ''template'' per executar directament a una màquina virtual (contenidor LXC<ref>Linux containers (LXC): https://linuxcontainers.org/</ref> o OpenVZ<ref>http://openvz.org</ref>).<br />
<br />
Alternativament pots baixar-te el codi i compilar-ho tu mateix.<br />
<br />
<br />
=== Descarrega la imatge ===<br />
<br />
Ves a la pàgina de Cloudy on estan les imatges emmagatzemades:<br />
<br />
http://repo.clommunity-project.eu/images/<br />
<br />
Actualment encara està en desenvolupament i '''disponible només a la branca ''unstable'''''.<br />
<br />
Allà trobaràs:<br />
<br />
* cloudy.README - Relació de paquets addicionals inclosos a la imatge del sistema.<br />
* cloudy.container.tar.gz - ''Template'' per a crear una VM.<br />
* cloudy.iso - Imatge ISO<br />
<br />
==== Grabar la imatge ISO (Linux) ====<br />
<br />
Els fitxers ISO són ''live install CD images'', és a dir, tenen un sistema d'instal·lació que s'executa just al iniciar la màquina des del dispositiu (CD/DVD/USB).<br />
<br />
Pots gravar-ho:<br />
<br />
* En un CD o DVD:<br />
<br />
$ apt-get install xorriso<br />
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso<br />
<br />
* En una memòria USB:<br />
<br />
$ dd if=cloudy.iso of=${USBSTICK}<br />
<br />
<br />
=== Compilar ===<br />
<br />
Per a construir o compilar Cloudy es necessiten alguns programes a la màquina per tal de poder descarregar les fonts, generar els binaris, manipular les images ISO, etc.<br />
<br />
1. Descarregar els paquets necessaris (exemple amb el apt dels sistemes basats en Debian):<br />
sudo apt-get install build-essential live-build imagemagick curl debootstrap git unzip <br />
<br />
2. Descarregar el "constructor" ''LBmake'' (Live-Build Make) per crear la imatge:<br />
git clone https://github.com/Clommunity/lbmake<br />
<br />
3. Compilar i generar la imatge ISO (i el Linux Container):<br />
<br />
* Anar al directori on s'ha baixat el codi del ''LBmake'' i compilar utilitzant l'eina de Linux ''make'':<br />
cd lbmake<br />
sudo make<br />
<br />
4. Un cop generada la imatge pots provar-la virtualitzant el sistema amb QEMU.<ref>QEMU processor emulator: http://wiki.qemu.org/Main_Page</ref><br />
<br />
* Generar una imatge de disc i utilitzar la imatge ISO com a Live CD per a la instal·lació:<br />
qemu-img create -f qcow2 disk.qcow2 4G<br />
qemu-system-i386 -enable-kvm -cdrom devel/binary.hybrid.iso -hda disk.qcow2<br />
<br />
''NOTA: si tens una màquina relativament recent, afegint l'opció '-enable-kvm' aprofita la virtualització per hardware fent-ho més ràpid.''<br />
<br />
==== Linux container ====<br />
<br />
Opcionalment, apart de la imatge ISO es pot crear un ''Linux Container'' amb la següent comanda:<br />
sudo make container<br />
<br />
''NOTA: abans de generar el contenidor primer s'ha d'haver creat la imatge ISO. En cas que no fos així, la comanda anterior generarà primer la ISO i després el contenidor.''<br />
<br />
== Instal·lació ==<br />
<br />
Com s'explica a la introducció, la distribució Cloudy està basada en Debian GNU/Linux i continguda en una imatge ISO ''live''.<br />
<br />
Pots provar a arrencar el sistema des del dispositiu extern (CD/DVD/USB) o bé iniciar el procés d'instal·lació, seleccionant la opció corresponent al menú.<br />
<br />
[[File:cloudy-boot-install.png|center]]<br />
<br />
La instal·lació és igual que amb un Debian estàndard <ref>Debian installation procedure: http://www.debian.org/releases/stable/i386/</ref>, i els passos es poden resumir en: <br />
<br />
# Escollir la opció ''Install'' en el menú d'inici. (min 0:06)<br />
# Seleccionar l'idioma per defecte de la instal·lacció i del sistema. (min 0:12)<br />
# Seleccionar la teva ubivació. (min 0:16)<br />
# Seleccionar el mapa de teclat. (min 0:19)<br />
# Canviar/assignar el nom del sistema. (min 1:21)<br />
# Afegir la contrasenya de ''root''. (min 1:37)<br />
# Crear un nou compte d'usuari amb contrasenya. (min 1:45)<br />
# Particionar el disc. En el exemple s'ha utilitzat tot el disc amb una sola partició. (min 2:02)<br />
# Configurar el gestor de paquets, afegint una rèplica de l'arxiu (repositori) de Debian més proper. (min 3:10)<br />
# Instal·lar carregador (''boot loader'') GRUB al registre mestre d'arrencada del disc (''master boot record''). (min 4:34)<br />
# Finalitzar la instal·lació per reiniciar la màquina i iniciar el nou sistema. (min 4:43)<br />
<br />
''NOTA: les referències en parèntesi corresponen al moment aproximat en el exemple en vídeo <ref>Cloudy installation: http://videos.guifi.net/guifimedia/2014-05%20Cloudy,%20the%20community%20distro/cloudy-installation.mp4</ref> del procés d'instal·lació.''<br />
<br />
<br />
<br />
== Com actualitzar ==<br />
<br />
El sistema d'actualització permet comprovar i actualitzar els paquets propis de Cloudy per tal de no haver de reinstal·lar el sistema ni perdre cap dada.<br />
<br />
En la versió actual, anant al menú '''''System > Update''''', es pot comprovar si hi ha una versió nova dels paquets de Cloudy i actualitzar-los un a un. També permet fer un ''upgrade'' general del sistema (paquets de Debian).<br />
<br />
[[File:cloudy-update.png|center|1024px]]<br />
<br />
<br />
<br />
== Primers passos ==<br />
<br />
Per accedir al sistema de configuració es fa mitjançant un navegador web a l''''adreça''' de la màquina servidor i '''port 7000'''.<br />
http://ADREÇA_IP:7000<br />
<br />
Credencials:<br />
* '''Usuari:''' root<br />
* '''Contrasenya:''' root ''(per defecte al container, seleccionada a l'instal·lació)''<br />
<br />
[[File:cloudy-home.png|center|1024px]]<br />
<br />
<br />
Un cop dins podem veure la pàgina inicial amb informació general del sistema i un menú superior amb diferents seccions, dividit en dues parts.<br />
<br />
1. A l''''esquerra''' tenim les opcions de configuració i monitoratge del '''sistema'''.<br />
<br />
* '''Cloudy:''' pàgina d'inici.<br />
* '''System:''' configuració de l'usuari, actualitzacions, desconnexió.<br />
* '''Languages:''' selecció de l'idioma.<br />
<br />
<br />
2. A la '''dreta''' tenim les opcions de configuració i gestió dels '''serveis'''.<br />
* '''Avahi:''' eina per anunciar i cercar serveis en la xarxa.<br />
* '''Clommunity:''' serveis introduïts al projecte CLOMMUNITY.<br />
* '''Guifi.net:''' serveis habituals utilitzats a la xarxa de Guifi.net.<br />
<br />
<br />
=== Serveis ===<br />
<br />
A continuació podeu veure quins serveis hi ha actualment disponibles a Cloudy per ser configurats fàcilment a través de l'interfície web.<br />
<br />
''"Per fer: explicació de cadascun dels serveis"''<br />
<br />
<br />
==== Clommunity ====<br />
* getinconf<br />
* Peer Streamer (streaming distribuït)<br />
* Tahofe-LAFS (sistema de fitxers distribuït)<br />
* Webdav server<br />
<br />
==== Guifi ====<br />
* Proxy3 (web proxy)<br />
[[File:cloudy-guifi-proxy.png|center]]<br />
<br />
* SNPServices (monitoratge/gràfiques)<br />
[[File:cloudy-guifi-snpservices.png|center]]<br />
<br />
* DNSServices<br />
[[File:cloudy-guifi-dnsservices.png|center]]<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
* http://guifi.net<br />
* http://clommunity-project.eu<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Qu%C3%A8_%C3%A9s_CloudyQuè és Cloudy2014-07-17T17:18:57Z<p>Conxuro: Es crea la pàgina amb «100px 100px Cloudy <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservice...».</p>
<hr />
<div>[[File:clommunity-logo.png|right|100px]]<br />
[[File:Logo_guifi.svg|right|100px]]<br />
<br />
[[Cloudy]] <ref name="cloudy">Cloudy: http://wiki.clommunity-project.eu/soft:cloudservices</ref> és una distribució basada en Debian GNU/Linux <ref name="debian">Debian GNU/Linux: http://debian.org</ref> desenvolupada en el marc del projecte CLOMMUNITY.<ref name="clommunity">CLOMMUNITY project: http://clommunity-project.eu</ref><br />
<br />
Aquesta distribució, inspirada en la idea de l'antiga [[Guinux]] <ref name="guinux">Guinux: http://guifi.net/node/29320</ref>, facilita el desplegament i la gestió de serveis de xarxa en el núvol ''(cloud services)''<ref name="cloud-services">Cloud computing: http://ca.wikipedia.org/wiki/Inform%C3%A0tica_en_n%C3%BAvol</ref>, així com la compartició d'aquests. Pensada en particular pels usuaris de les xarxes comunitàries.<ref name="CN">Xarxes comunitàries: http://ca.wikipedia.org/wiki/Xarxa_oberta</ref><br />
<br />
<br />
<br />
----<br />
<br />
<br />
<br />
== Introducció ==<br />
<br />
Abans de l'adopció general de serveis en el núvol ''(cloud services)''<ref name="cloud-services"/> els usuaris de Xarxes Comunitàries <ref name="CN"/> ja compartien o proveïen serveis i recursos a la comunitat; no obstant, aquest usuaris eren una minoria. Una de les principals raons és la barrera tecnològica. Abans de proveir continguts, els usuaris que volen compartir informació amb la comunitat tenen primer que preocupar-se dels aspectes tècnics com el desplegament/muntatge d'un servidor amb un conjunt de serveis.<br />
<br />
En el passat, els usuaris de Guifi.net, intentaren superar aquest problema publicant una distribució GNU/Linux anomenada [[Guinux]] <ref name="guinux"/>, que donava als usuaris finals una solució fàcil per oferir serveis a la comunitat (com ara [[Servidor_Proxy/ca|proxy web]], [[Servidor_DNS/ca|sistemes DNS]], [[Monitor/ca|monitoratge i gràfiques]]).<br />
<br />
La clau principal de [[Guinux]] era un conjunt de ''scripts''<ref>http://ca.wikipedia.org/wiki/Script_%28inform%C3%A0tica%29</ref> que automatitzaven el procés de configuració. Els usuaris només havien d'introduir uns pocs paràmetres com l'adreça de correu electrònic i l'identificador del node. Aviat, després d'estar disponible la distribució, el nombre d'usuaris compartint recursos va proliferar.<br />
<br />
D'acord amb això, va quedar clar que reduint (o eliminant) la barrera d'entrada tecnològica animava als usuaris a proveir de més serveis i compartir els seus recursos amb la comunitat. Per a tal fi, un dels objectius principals del projecte CLOMMUNITY <ref name="clommunity"/> és publicar una distribució GNU/Linux, anomenada Cloudy, dirigida als usuaris, per a fomentar la transició i adopció de l'entorn Cloud a xarxes comunitàries ''(Community Network Cloud)''.<br />
<br />
<br />
=== Motivació === <br />
<br />
La distribució Cloudy s'ha pensat per satisfer els següents requisits:<br />
<br />
# '''Distribució''': per a potenciar la distribució de serveis a les xarxes comunitàries (XC); és necessària una plataforma per a publicar i descobrir aquests serveis. D'aquesta manera, l'accés als serveis no depèn de desplegaments estàtics de xarxes i és conscient de les condicions dinàmicament canviants de les XC. El programari escollit per a la publicació i descobriment de serveis és Avahi<ref name="avahi">Avahi: http://avahi.org</ref>.<br />
# '''Descentralització''': una capa de xarxa comuna és necessària per permetre a tots els nodes del núvol comunicar-se entre ells directament. Una bona manera de construir això es crear una "capa 2 virtual" basada en un servei VPN<ref>Xarxa Privada Virtual: http://ca.wikipedia.org/wiki/Xarxa_privada_virtual</ref>. Entre les opcions disponibles, ha estat escollit Tinc VPN<ref>Tinc VPN: http://tinc-vpn.org</ref>, ja que compleix tots els requisits i és senzill de configurar i administrar. Per a coordinar els dispositius amb Tinc VPN, s'ha desenvolupat una eina per automatitzar el desplegament del sistema. Aquest software, Getinconf<ref>Getinconf: https://github.com/Clommunity/getinconf/blob/master/README.md</ref>, s'encarrega del procés de configuració de Tinc VPN i de l'intercanvi de claus amb la resta de nodes del núvol.<br />
# '''Facilitat d'ús i experiència d'usuari''': per a aquest fi, s'ha desenvolupat una plataforma web d'administració destinada a integrar la instal·lació i configuració dels serveis al núvol habilitats en la distribució Cloudy. Una interfície web simple i agradable<ref>Interfície web de Cloudy: http://redmine.confine-project.eu/projects/getinconf</ref> està disponible pels usuaris com a solució fàcil de configuració, administració i monitoratge dels serveis ''cloud'' actius al node.<br />
# '''Programari lliure''': la distribució està basada en Debian GNU/Linux<ref name="debian"/>. Apart de ser una de les distribucions més populars i complir tots els requisits tècnics, ha estat escollida degut a que el ''Debian Social Contract''<ref>Debian social contract: https://www.debian.org/social_contract</ref> salvaguarda i garanteix que el programari serà sempre obert i lliure.<br />
<br />
<br />
<br />
== Requisits mínims ==<br />
<br />
Al ser una sistema basat en Debian, té el mateixos requisits de hardware.<ref>Requisits mínims: https://www.debian.org/releases/stable/i386/ch03s04.html.ca</ref><br />
<br />
La imatge del sistema Cloudy porta una sèrie de configuracions i paquets addicionals; per la qual cosa fa que siguin necessaris al voltant de '''450 MiB de espai d'emmagatzematge'''.<br />
<br />
Tot i això, és '''recomenable''' comptar amb '''al menys 1 GiB'''.<br />
<br />
<br />
Si és volen fer servir alguns serveis com PeerStreamer (llegir més avall) els requisits mínims augmentaran, tant d'espai com de memòria i processament.<br />
<br />
<br />
<br />
== Aconseguir Cloudy ==<br />
<br />
Actualment pots obtenir la distribució Cloudy mitjançant la descarrega d'una imatge ISO per gravar en un CD o memòria USB, o d'un ''template'' per executar directament a una màquina virtual (contenidor LXC<ref>Linux containers (LXC): https://linuxcontainers.org/</ref> o OpenVZ<ref>http://openvz.org</ref>).<br />
<br />
Alternativament pots baixar-te el codi i compilar-ho tu mateix.<br />
<br />
<br />
=== Descarrega la imatge ===<br />
<br />
Ves a la pàgina de Cloudy on estan les imatges emmagatzemades:<br />
<br />
http://repo.clommunity-project.eu/images/<br />
<br />
Actualment encara està en desenvolupament i '''disponible només a la branca ''unstable'''''.<br />
<br />
Allà trobaràs:<br />
<br />
* cloudy.README - Relació de paquets addicionals inclosos a la imatge del sistema.<br />
* cloudy.container.tar.gz - ''Template'' per a crear una VM.<br />
* cloudy.iso - Imatge ISO<br />
<br />
==== Grabar la imatge ISO (Linux) ====<br />
<br />
Els fitxers ISO són ''live install CD images'', és a dir, tenen un sistema d'instal·lació que s'executa just al iniciar la màquina des del dispositiu (CD/DVD/USB).<br />
<br />
Pots gravar-ho:<br />
<br />
* En un CD o DVD:<br />
<br />
$ apt-get install xorriso<br />
$ xorriso -as cdrecord -v dev=/dev/sr0 blank=as_needed cloudy.iso<br />
<br />
* En una memòria USB:<br />
<br />
$ dd if=cloudy.iso of=${USBSTICK}<br />
<br />
<br />
=== Compilar ===<br />
<br />
Per a construir o compilar Cloudy es necessiten alguns programes a la màquina per tal de poder descarregar les fonts, generar els binaris, manipular les images ISO, etc.<br />
<br />
1. Descarregar els paquets necessaris (exemple amb el apt dels sistemes basats en Debian):<br />
sudo apt-get install build-essential live-build image-magick curl debootstrap git unzip <br />
<br />
2. Descarregar el "constructor" ''LBmake'' (Live-Build Make) per crear la imatge:<br />
git clone https://github.com/Clommunity/lbmake<br />
<br />
3. Compilar i generar la imatge ISO (i el Linux Container):<br />
<br />
* Anar al directori on s'ha baixat el codi del ''LBmake'' i compilar utilitzant l'eina de Linux ''make'':<br />
cd lbmake<br />
sudo make<br />
<br />
4. Un cop generada la imatge pots provar-la virtualitzant el sistema amb QEMU.<ref>QEMU processor emulator: http://wiki.qemu.org/Main_Page</ref><br />
<br />
* Generar una imatge de disc i utilitzar la imatge ISO com a Live CD per a la instal·lació:<br />
qemu-img create -f qcow2 disk.qcow2 4G<br />
qemu-system-i386 -enable-kvm -cdrom devel/binary.hybrid.iso -hda disk.qcow2<br />
<br />
''NOTA: si tens una màquina relativament recent, afegint l'opció '-enable-kvm' aprofita la virtualització per hardware fent-ho més ràpid.''<br />
<br />
==== Linux container ====<br />
<br />
Opcionalment, apart de la imatge ISO es pot crear un ''Linux Container'' amb la següent comanda:<br />
sudo make container<br />
<br />
''NOTA: abans de generar el contenidor primer s'ha d'haver creat la imatge ISO. En cas que no fos així, la comanda anterior generarà primer la ISO i després el contenidor.''<br />
<br />
<br />
<br />
== Instal·lació ==<br />
<br />
Com s'explica a la introducció, la distribució Cloudy està basada en Debian GNU/Linux i continguda en una imatge ISO ''live''.<br />
<br />
Pots provar a arrencar el sistema des del dispositiu extern (CD/DVD/USB) o bé iniciar el procés d'instal·lació, seleccionant la opció corresponent al menú.<br />
<br />
[[File:cloudy-boot-install.png|center]]<br />
<br />
La instal·lació és igual que amb un Debian estàndard <ref>Debian installation procedure: http://www.debian.org/releases/stable/i386/</ref>, i els passos es poden resumir en: <br />
<br />
# Escollir la opció ''Install'' en el menú d'inici. (min 0:06)<br />
# Seleccionar l'idioma per defecte de la instal·lacció i del sistema. (min 0:12)<br />
# Seleccionar la teva ubivació. (min 0:16)<br />
# Seleccionar el mapa de teclat. (min 0:19)<br />
# Canviar/assignar el nom del sistema. (min 1:21)<br />
# Afegir la contrasenya de ''root''. (min 1:37)<br />
# Crear un nou compte d'usuari amb contrasenya. (min 1:45)<br />
# Particionar el disc. En el exemple s'ha utilitzat tot el disc amb una sola partició. (min 2:02)<br />
# Configurar el gestor de paquets, afegint una rèplica de l'arxiu (repositori) de Debian més proper. (min 3:10)<br />
# Instal·lar carregador (''boot loader'') GRUB al registre mestre d'arrencada del disc (''master boot record''). (min 4:34)<br />
# Finalitzar la instal·lació per reiniciar la màquina i iniciar el nou sistema. (min 4:43)<br />
<br />
''NOTA: les referències en parèntesi corresponen al moment aproximat en el exemple en vídeo <ref>Cloudy installation: http://videos.guifi.net/guifimedia/2014-05%20Cloudy,%20the%20community%20distro/cloudy-installation.mp4</ref> del procés d'instal·lació.''<br />
<br />
<br />
<br />
== Com actualitzar ==<br />
<br />
El sistema d'actualització permet comprovar i actualitzar els paquets propis de Cloudy per tal de no haver de reinstal·lar el sistema ni perdre cap dada.<br />
<br />
En la versió actual, anant al menú '''''System > Update''''', es pot comprovar si hi ha una versió nova dels paquets de Cloudy i actualitzar-los un a un. També permet fer un ''upgrade'' general del sistema (paquets de Debian).<br />
<br />
[[File:cloudy-update.png|center|1024px]]<br />
<br />
<br />
<br />
== Primers passos ==<br />
<br />
Per accedir al sistema de configuració es fa mitjançant un navegador web a l''''adreça''' de la màquina servidor i '''port 7000'''.<br />
http://ADREÇA_IP:7000<br />
<br />
Credencials:<br />
* '''Usuari:''' root<br />
* '''Contrasenya:''' root ''(per defecte al container, seleccionada a l'instal·lació)''<br />
<br />
[[File:cloudy-home.png|center|1024px]]<br />
<br />
<br />
Un cop dins podem veure la pàgina inicial amb informació general del sistema i un menú superior amb diferents seccions, dividit en dues parts.<br />
<br />
1. A l''''esquerra''' tenim les opcions de configuració i monitoratge del '''sistema'''.<br />
<br />
* '''Cloudy:''' pàgina d'inici.<br />
* '''System:''' configuració de l'usuari, actualitzacions, desconnexió.<br />
* '''Languages:''' selecció de l'idioma.<br />
<br />
<br />
2. A la '''dreta''' tenim les opcions de configuració i gestió dels '''serveis'''.<br />
* '''Avahi:''' eina per anunciar i cercar serveis en la xarxa.<br />
* '''Clommunity:''' serveis introduïts al projecte CLOMMUNITY.<br />
* '''Guifi.net:''' serveis habituals utilitzats a la xarxa de Guifi.net.<br />
<br />
<br />
=== Serveis ===<br />
<br />
A continuació podeu veure quins serveis hi ha actualment disponibles a Cloudy per ser configurats fàcilment a través de l'interfície web.<br />
<br />
''"Per fer: explicació de cadascun dels serveis"''<br />
<br />
<br />
==== Clommunity ====<br />
* getinconf<br />
* Peer Streamer (streaming distribuït)<br />
* Tahofe-LAFS (sistema de fitxers distribuït)<br />
* Webdav server<br />
<br />
==== Guifi ====<br />
* Proxy3 (web proxy)<br />
[[File:cloudy-guifi-proxy.png|center]]<br />
<br />
* SNPServices (monitoratge/gràfiques)<br />
[[File:cloudy-guifi-snpservices.png|center]]<br />
<br />
* DNSServices<br />
[[File:cloudy-guifi-dnsservices.png|center]]<br />
<br />
<br />
<br />
== Referències ==<br />
<br />
<references/><br />
<br />
<br />
<br />
== Enllaços externs ==<br />
<br />
* http://guifi.net<br />
* http://clommunity-project.eu<br />
<br />
<br />
<br />
[[Categoria:Cloudy]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/PortadaPortada2014-06-25T14:10:20Z<p>Conxuro: /* Mesh */</p>
<hr />
<div>__NOTITLE__<br />
{| style="background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em; width:100%;"<br />
| valign="top" style="padding:12px 17px 5px 17px" |<br />
'''Guifi.net''' és de tothom, participa-hi [[connectar|connectant]] el teu [[tram de xarxa]] amb el dels altres.<br />
<br />
És un projecte col·laboratiu [[organització horitzontal|organitzat horitzontalment]] que agrupa tan a persones individuals, col·lectius, empreses i administracions.<br />
<br />
És obert i per tant tothom hi pot participar en igualtat de condicions en el marc del [http://guifi.net/ComunsXOLN Comuns de la Xarxa Oberta, Lliure i Neutral]<br />
<div style=" text-align: right">[[Guifi.net|Més sobre Guifi.net]]</div><br />
{| style="width:100%; background:#f6f6f6"<br />
| 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;">Benvinguda al wiki de '''Guifi.net'''</div><br />
<div style="font-size: 95%;">Documentació sobre la xarxa oberta, lliure i neutral.</div><br />
<div style="font-size: 85%;">En aquests moments tenim [[Especial:Estadístiques|{{NUMBEROFARTICLES}}]] [[Especial:Llista_de_pàgines|articles]] en català.</div><br />
<div style="font-size: 85%;">Ajuda [[Què és un wiki#Categories|categoritzant]] un dels [[Especial:Pàgines_sense_categoria|articles sense categoritzar]], pots fer servir les [[Especial:Categories|categories ja existents]].</div><br />
</div><br />
|}<br />
{| style="background:#f6f6f6; width:100%;"<br />
|''A la documentació de guifi.net hi ha els documents de referència per a usuaris novells, experimentats i desenvolupadors. Sigues lliure [[Què és un wiki|d'editar aquest wiki]] per millorar-ne el seu contingut.''<br />
<div style=" text-align: center">Contacta: [http://guifi.net/forum Fòrums] '''|''' [http://llistes.guifi.net Llistes de correu] '''|''' [http://guifi.net/xat Xat]</div><br />
|}<br />
|}<br />
<br />
<br />
{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"<br />
| 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;" | <br />
<br />
<div id="mp-tfa"><!--Selector per a [[meta:Mobile]]--><br />
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"<br />
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Com unir-se a Guifi.net<br />
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" | <br />
|-<br />
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;"><br />
<br />
* [[tres passos|Com donar d'alta i enllaçar un node]]<br />
* [[Escull el material]]<br />
* [[Configura el teu ordinador]]<br />
* [http://guifi.net/ca/BonesPractiques Bones pràctiques]<br />
<br />
|}</div><br />
<br />
| style="border:1px solid transparent;" |<br />
| 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; " | <br />
<div id="mp-itn"><br />
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"<br />
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodes i illes<br />
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" | <br />
|-<br />
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;"><br />
* [[Començar una illa des de 0]]<br />
* [[Crear un supernode]]<br />
* [http://guifi.net/ca/BonesPractiques Bones pràctiques]</div></div><br />
|}</div><br />
|}<br />
<br />
{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"<br />
| 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; " | <br />
<div id="mp-dyk"><br />
<br />
<div style="float:right;">__TOC__</div><br />
== [[Legal]] ==<br />
* [[Particulars]]<br />
* [[Institucions]]<br />
* [[Empreses]]<br />
* [[Serveis_General]]<br />
* [[Associació|Constitució d'una associació]]<br />
<br />
== Finançament ==<br />
* [[Models de finançament]]<br />
<br />
== Xarxa ==<br />
=== Els bàsics a la web ===<br />
* [[Zona|Crear i modificar una zona]]<br />
* [[Afegir_un_node_de_guifi.net|Afegir un node de guifi.net]]<br />
* [[Serveis|Crear serveis i vincular-los als servidors]]<br />
* [[Usuaris dels Proxys Federats]]<br />
* [[Eines|Eines (localització de IPs i MACs, estadístiques, mapes d'enrutament, etc.)]]<br />
<br />
=== Infraestructura ===<br />
{{div col|cols=2}}<br />
* [[Crear_un_supernode|Muntatge de supernodes]]<br />
* [[Filtres de xarxes]]<br />
* [[Enllaços virtuals]]<br />
* [[Node frontera amb qMp]]<br />
* [[Hotspot]]<br />
* [[Eina per buscar rangs de IPs lliures]]<br />
* [[Creació de túnels PPTP (Debian/dd-wrt/Mikrotik)]]<br />
* [[PPTP_airos|Tunel PPTP desde antena AirOS]]<br />
* [[Script per detectar problemes de latència]]<br />
* [[Tweaks antenes]]<br />
* [[Fibra_òptica|Fibra Òptica]]<br />
* [[Gestio_vlans_ubnt_supernode|Vlan de gestió ubnt en supernode híbrid]]<br />
* [[Toughswitch_supernode_hibrid|Gestió supernode híbrid amb vlan i toughswitch]]<br />
* [[Fer_bonding_de_dues_ADSL_amb_Routerboard|Fer bonding de dues ADSL amb una Routerboard]]<br />
* [[Calcul_RF|Càlculs RF]]<br />
{{div end}}<br />
<br />
=== Mesh ===<br />
* [[Obrir_xarxes_tipus_mesh_a_trav%C3%A9s_de_Guifi.net|Crear una xarxa Mesh en Guifi.net]]<br />
* [[Connectar-se_a_una_xarxa_mesh|Connectar-se a una xarxa Mesh de Guifi.net]]<br />
* [[Annex:subxarxes_mesh|Llistat de les xarxes Mesh]]<br />
* [[Quick Mesh Project (qMp)]] ([[:es:Quick Mesh Project|es]])<br />
* [[Alix+GSF|Configurar Àlix per connectar-se al núvol Mesh de gràcia amb gsffirm]] (antic) ([[:es:Alix|es]])<br />
* [[Altermesh]] (roaming mesh en Capa 2 amb BATMAN-adv) ([[:es:Altermesh|es]])<br />
* [[Mesh|Altres articles sobre Mesh]]<br />
<br />
=== Enrutaments i conceptes de xarxes ===<br />
{{div col|cols=2}}<br />
* [[Enrutament]] --General--<br />
* [[Peerings]]<br />
* [[Tunejant salts-BGP PREPEND ]]<br />
* [[Redundància BGP-OSPF-BGP ]] <br />
* [[Agregacions BGP ]]<br />
* [[Pesos BGP]]<br />
* [[BGP 2 AS en 1 AS]] (útil per a supernodes amb 2 mikrotiks)<br />
* [[IPv4]]<br />
* [[IPv6]]<br />
* [[Criteris d'assignació d'adreces IPv4]]<br />
* [[ARP]]<br />
* [[Cables_UTP|Cables UTP]]<br />
* [http://packetlife.net/library/cheat-sheets/ Resum de conceptes de xarxa]<br />
{{div end}}<br />
<br />
=== General ===<br />
{{div col|cols=2}}<br />
* [[Com es vertebra la xarxa: Troncal, punts d'accés i connexions simples]]<br />
* [[La seguretat a la xarxa oberta]]<br />
* [[Aplicacions | Aplicacions de Guifi.net]]<br />
* [[Recursos externs]]<br />
* [[Instal·lar firmware Ubiquiti Rocket M5]]<br />
{{div end}}<br />
<br />
== Sistemes ==<br />
=== Serveis bàsics ===<br />
{{div col|cols=2}}<br />
* [[Configurar Repositori apt guifi]]<br />
* [[Servidor Proxy]]<br />
* [[Servidor de gràfiques]]<br />
* [[Servidor DNS]]<br />
* [[Servidor Rellotge|Servidor de Rellotge (NTP)]]<br />
* [[Servidor logs remots rsyslogd ]]<br />
* [[Configurar xarxa]]<br />
{{div end}}<br />
<br />
=== Serveis de compartició de fitxers ===<br />
* [[Servidor FTP]]<br />
* [[Servidor Peer 2 Peer]]<br />
* [[Servidor DCC]]<br />
<br />
=== Serveis de missatgeria ===<br />
* [[Servidor de Correu]]<br />
* [[Webmail]]<br />
* [[Servidor Jabber]]<br />
* [[Servidor IRC]]<br />
* [[Mailman]]<br />
* [[Whatsapp]]<br />
<br />
=== Serveis de Veu i Vídeo ===<br />
* [[VoIP|Servidor de VeuIP (VoIP)]]<br />
* [[Servidor Radio Streaming]]<br />
<br />
=== Altres Serveis ===<br />
{{div col|cols=2}}<br />
* [[LDAP|Servidor LDAP]]<br />
* [[Apache|Servidor web Apache]]<br />
* [[Servidor Repositori Linux]]<br />
* [[Servidor Repositori Linux (Cache)]]<br />
* [[Servidor Iperf]]<br />
* [[Servidor repositori subversion]]<br />
* [[DHCP|Servidor DHCP]]<br />
* [[MySQL]] (Bases de Dades)<br />
* [[Proxmox]] (virtualització)<br />
* [[Cacti]] (monitoratge)<br />
* [[Servei de notificació d'incidencies]] (Servei de notificació d'incidencies)<br />
* [[Monitoratge_Cacti_UBNT|Cacti per a trastos UBNT]]<br />
* [[Clamav]] (antivirus amb GNU/Linux)<br />
* [[Trac]] (sistema de gestió de tiquets)<br />
* [[Squid]] (configuracions avançades squid)<br />
* [[PXE]] (Instal·lació per xarxa)<br />
* [http://www.example.com Observium] (Monitoratge molt gràfic, GPL)<br />
{{div end}}<br />
<br />
=== Sistema ===<br />
* [[ACPI]]<br />
* [[Bridges_amb_Linux|Bridges amb GNU/Linux]]<br />
* [[Chroot]]<br />
* [[Corkscrew]]<br />
* [[Túnel Proxy SOCKS]]<br />
* [[Manteniment_de_discs_durs|Manteniment de discs durs]]<br />
<br />
== Instal·ladors ==<br />
* [[Parallamps]]<br />
* [[Reaprofitar el cable d'antena de televisió]]<br />
* [[Pressupostos]]<br />
* [[Utilitzar RB Mikrotik com a tunel PPPoE Movistar-Jazztel-altres]]<br />
* [http://guifi.net/ca/node/12486 Comunitat de veïns, cas d'exemple]<br />
* [[Configuració de l'antena per a les gràfiques (SNMP)]]<br />
* [[Campanars]]<br />
<br />
== Desenvolupadors ==<br />
* [[Manual editor wiki]]<br />
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]<br />
* [[Actualitzacions mòduls drupal]]<br />
* [http://gitorious.org/guifi Repositoris de codi del projecte guifi.net]<br />
* [[Mapa del codi]]<br />
* [[API de Guifi]]<br />
* [[CNML]]<br />
* [[Empotrar el mapa de Guifi-Google Maps a una web]]<br />
* [[Unsolclic]]<br />
* [[Preparant l'entorn de desenvolupament]]<br />
* [[:Categoria:router|Routers]]<br />
* [[:Categoria:Telefonia mòbil|Telefonia mòbil]]<br />
* [[Eficiència energètica]]<br />
<br />
== Dissenyadors ==<br />
* [[Logos]]<br />
* [[Maquetació de les diverses pàgines web]]<br />
* [[Usabilitat]]<br />
* [[Presentacions de guifi.net]]<br />
<br />
== Desenvolupament col·lectiu de la xarxa ==<br />
* [[Cursos]]<br />
* [[Necessitats]]<br />
<br />
== Camp de treball ==<br />
* [http://camp2012.guifi.net Bloc del camp de treball 'Internet per a tothom! Vic 2012]<br />
<br />
== Glossari ==<br />
* [[Recull de termes emprats habitualment]]<br />
* [[Guia Ràpida de Guifi.net]]<br />
* [[Preguntes Freqüents]]<br />
* [http://guifi.net/ca/CADocs Documents ubicats a la web de guifi.net] antiga "ComEsFa"<br />
|}<br />
<br />
= Accessos Ràpids =<br />
* [http://planet.guifi.net Planet]<br />
* [http://guifi.net/cxoln Comuns (Llicència de la xarxa)]<br />
* [http://guifi.net/maps Mapa guifi]<br />
* [[Webs Regionals]]<br />
* [http://trac.guifi.net Reporta Errors de la web]<br />
* [http://fundacio.guifi.net Fundació]<br />
* [http://guifi.net/ca/info Recull de guies i manuals]<br />
* [http://etherpad.guifi.net/serveris-de-guifi Llistat de serveis variats entorn al projecte]<br />
[[es:Portada]]<br />
[[en:Main Page]]<br />
[[eu:Azala]]<br />
[[fr:Accueil]]<br />
[[gl:Portada]]<br />
[[pt:Página principal]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Annex:subxarxes_meshAnnex:subxarxes mesh2014-05-07T08:12:54Z<p>Conxuro: </p>
<hr />
<div>{| class="wikitable sortable"<br />
|- style="background:#ececec;"<br />
! Abreviació de la comunitat <ref>Segons les [[convencions de noms]] s'hauria de fer servir la minúscula, en aquesta taula surten reflexades dues en alguns casos per reflexar que per motius històrics es poden trobar nodes encara amb la convenció de noms en majúscula (NOTA: S'ha d'acordar bé encara això)</ref><br />
! Nom de la xarxa - comunitat<br />
! Ubicació<br />
! [[ESSID]] comunitari<br />
! [[firmware]]<br />
! [[canal]]<br />
! [[vlan]]<br />
! IP<br />
! Comentari<br />
|-<br />
| GSF - '''gsf'''<br />
| [[Gràcia Sense Fils]]<br />
| Vila de Gràcia al municipi de Barcelona<br />
|<br />
| [[gsffirm]] i [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.0.0/21<br />
|<br />
|-<br />
| GS - '''gs'''<br />
| [[GuifiSants]]<br />
| Sants - Les Corts al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+, 124+ i 140-<br />
|<br />
| 10.1.8.0/21<br />
|<br />
|-<br />
| RAV - '''rav'''<br />
| [[Mesh al Raval]]<br />
| Barri del raval al municipi de Barcelona<br />
| Cada node te el seu, la URL al node de guifi.net, exemple guifi.net/bcnsalvadors24<br />
| [[qMp]]<br />
| 136-<br />
|<br />
| 10.1.16.0/21<br />
|<br />
|-<br />
| UPC - '''upc'''<br />
| [[Mesh a la UPC]]<br />
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.24.0/21<br />
|<br />
|-<br />
| HW<br />
| [[Hospitalet Wireless]]<br />
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat<br />
| <br />
| [[qMp]]<br />
| 124-<br />
|<br />
| 10.1.32.0/21<br />
|<br />
|-<br />
| SJD - '''sjd'''<br />
| [[Mesh a Sant Joan Despí]]<br />
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.40.0/21<br />
|<br />
|-<br />
| vllc<br />
| [[Mesh a Vallcarca]]<br />
| Barri de Vallcarca i els Penitents al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+ i 140-<br />
|<br />
| 10.1.48.0/21<br />
|<br />
|-<br />
| SAND - '''sand'''<br />
| [[Mesh a Sant Andreu]]<br />
| Barri de Sant Andreu al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.56.0/21<br />
|<br />
|-<br />
| P9SF - '''p9sf'''<br />
| [[Poblenou Sense Fils]]<br />
| Poblenou al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.64.0/21<br />
|<br />
|-<br />
| HRT<br />
| [[Horta-Carmel]]<br />
| Part nord del districte Horta-Guinardó al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.72.0/21<br />
|<br />
|-<br />
| SCC<br />
| [[ Mesh a Santa Coloma de Cervelló]]<br />
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.80.0/21<br />
|<br />
|-<br />
| ?<br />
| [[Mesh al Prat]]<br />
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]]<br />
| ?<br />
|<br />
| 10.1.88.0/21<br />
|<br />
|-<br />
| gll<br />
| [[Garraf Lliure]]<br />
| Comarca del Garraf a Barcelona<br />
| garraflliure.guifi.net<br />
| [[libre-mesh]]<br />
| 11 i 36<br />
|<br />
| 10.1.96.0/21<br />
|<br />
|-<br />
| mtj<br />
| [[Montjuïc - Jardí Botànic]]<br />
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona<br />
| jardibotanic.guifi.net<br />
| [[libre-mesh]]<br />
| 48<br />
|<br />
| 10.1.104.0/21<br />
|<br />
|-<br />
| ?<br />
| [[Mesh a Cornellà]]<br />
| Municipi de Cornellà a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]]<br />
| ?<br />
|<br />
| 10.1.112.0/21<br />
|<br />
|-<br />
| afrd<br />
| Aiguafreda<br />
| <br />
| <br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.120.0/21<br />
|<br />
|-<br />
| Wales<br />
| Mesh a Gal·les<br />
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.128.0/17<br />
|<br />
|-<br />
| CIU<br />
| [[Mesh a Ciutadella]]<br />
| Ciutadella a l'illa de Menorca.<br />
|<br />
| [[qMp]]<br />
| 140- i més ...?<br />
|<br />
| 10.2.0.0/21<br />
|<br />
|-<br />
| IRU<br />
| [[Mesh a Iruña]]<br />
| Núvol Mesh a Iruña a Navarra<br />
| <br />
| [[qMp]]<br />
| 140-<br />
|<br />
|style="background-color: orange;"| 10.3.0.0/21 <ref name="conflict"> '''IMPORTANT: encara hi han nodes amb IPs del rang antic que entra en conflicte amb el rang de Wales.'''</ref><br />
|<br />
|-<br />
| ?<br />
| [[Xarxa híbrida de Castelldefels]]<br />
| Municipi de Castelldefels a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]] i [[RouterOS]]<br />
| ?<br />
|<br />
| 10.10.8.0/22<br />
| Al mateix rang s'estan fent servir modes en [[infraestructura]] amb RouterOS i nodes [[mesh]] amb qMp. La IP inicial que s'està fent servir és la [https://guifi.net/ca/node/61866 10.10.10.1/22].<br />
|}<br />
<br />
<references /><br />
<br />
[[categoria:MANET]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Annex:subxarxes_meshAnnex:subxarxes mesh2014-05-07T08:08:50Z<p>Conxuro: </p>
<hr />
<div>{| class="wikitable sortable"<br />
|- style="background:#ececec;"<br />
! Abreviació de la comunitat <ref>Segons les [[convencions de noms]] s'hauria de fer servir la minúscula, en aquesta taula surten reflexades dues en alguns casos per reflexar que per motius històrics es poden trobar nodes encara amb la convenció de noms en majúscula (NOTA: S'ha d'acordar bé encara això)</ref><br />
! Nom de la xarxa - comunitat<br />
! Ubicació<br />
! [[ESSID]] comunitari<br />
! [[firmware]]<br />
! [[canal]]<br />
! [[vlan]]<br />
! IP<br />
! Comentari<br />
|-<br />
| GSF - '''gsf'''<br />
| [[Gràcia Sense Fils]]<br />
| Vila de Gràcia al municipi de Barcelona<br />
|<br />
| [[gsffirm]] i [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.0.0/21<br />
|<br />
|-<br />
| GS - '''gs'''<br />
| [[GuifiSants]]<br />
| Sants - Les Corts al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+, 124+ i 140-<br />
|<br />
| 10.1.8.0/21<br />
|<br />
|-<br />
| RAV - '''rav'''<br />
| [[Mesh al Raval]]<br />
| Barri del raval al municipi de Barcelona<br />
| Cada node te el seu, la URL al node de guifi.net, exemple guifi.net/bcnsalvadors24<br />
| [[qMp]]<br />
| 136-<br />
|<br />
| 10.1.16.0/21<br />
|<br />
|-<br />
| UPC - '''upc'''<br />
| [[Mesh a la UPC]]<br />
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.24.0/21<br />
|<br />
|-<br />
| HW<br />
| [[Hospitalet Wireless]]<br />
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat<br />
| <br />
| [[qMp]]<br />
| 124-<br />
|<br />
| 10.1.32.0/21<br />
|<br />
|-<br />
| SJD - '''sjd'''<br />
| [[Mesh a Sant Joan Despí]]<br />
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.40.0/21<br />
|<br />
|-<br />
| vllc<br />
| [[Mesh a Vallcarca]]<br />
| Barri de Vallcarca i els Penitents al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+ i 140-<br />
|<br />
| 10.1.48.0/21<br />
|<br />
|-<br />
| SAND - '''sand'''<br />
| [[Mesh a Sant Andreu]]<br />
| Barri de Sant Andreu al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.56.0/21<br />
|<br />
|-<br />
| P9SF - '''p9sf'''<br />
| [[Poblenou Sense Fils]]<br />
| Poblenou al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.64.0/21<br />
|<br />
|-<br />
| HRT<br />
| [[Horta-Carmel]]<br />
| Part nord del districte Horta-Guinardó al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.72.0/21<br />
|<br />
|-<br />
| SCC<br />
| [[ Mesh a Santa Coloma de Cervelló]]<br />
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.80.0/21<br />
|<br />
|-<br />
| ?<br />
| [[Mesh al Prat]]<br />
| Municipi de El Prat de Llobregat a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]]<br />
| ?<br />
|<br />
| 10.1.88.0/21<br />
|<br />
|-<br />
| gll<br />
| [[Garraf Lliure]]<br />
| Comarca del Garraf a Barcelona<br />
| garraflliure.guifi.net<br />
| [[libre-mesh]]<br />
| 11 i 36<br />
|<br />
| 10.1.96.0/21<br />
|<br />
|-<br />
| mtj<br />
| [[Montjuïc - Jardí Botànic]]<br />
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona<br />
| jardibotanic.guifi.net<br />
| [[libre-mesh]]<br />
| 48<br />
|<br />
| 10.1.104.0/21<br />
|<br />
|-<br />
| ?<br />
| [[Mesh a Cornellà]]<br />
| Municipi de Cornellà a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]]<br />
| ?<br />
|<br />
| 10.1.112.0/21<br />
|<br />
|-<br />
| afrd<br />
| Aiguafreda<br />
| <br />
| <br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.120.0/21<br />
|<br />
|-<br />
| Wales<br />
| Mesh a Gal·les<br />
| Nodes desplegats a Merthyr Tydfil (més info: Routek.net)<br />
|<br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.1.128.0/17<br />
|<br />
|-<br />
| CIU<br />
| [[Mesh a Ciutadella]]<br />
| Ciutadella a l'illa de Menorca.<br />
|<br />
| [[qMp]]<br />
| 140- i més ...?<br />
|<br />
| 10.2.0.0/21<br />
|<br />
|-<br />
| IRU<br />
| [[Mesh a Iruña]]<br />
| Núvol Mesh a Iruña a Navarra<br />
| <br />
| [[qMp]]<br />
| 140-<br />
|<br />
| 10.3.0.0/21<br />
|<br />
|-<br />
| ?<br />
| [[Xarxa híbrida de Castelldefels]]<br />
| Municipi de Castelldefels a la comarca de Baix Llobregat<br />
| ?<br />
| [[qMp]] i [[RouterOS]]<br />
| ?<br />
|<br />
| 10.10.8.0/22<br />
| Al mateix rang s'estan fent servir modes en [[infraestructura]] amb RouterOS i nodes [[mesh]] amb qMp. La IP inicial que s'està fent servir és la [https://guifi.net/ca/node/61866 10.10.10.1/22].<br />
|}<br />
<br />
<references /><br />
<br />
[[categoria:MANET]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Connectar-se_a_una_xarxa_meshConnectar-se a una xarxa mesh2014-05-06T16:07:46Z<p>Conxuro: </p>
<hr />
<div>'''''Nota: Si la xarxa mesh no està creada, primer s'ha d'[[Obrir xarxes tipus mesh a través de Guifi.net|Obrir]]'''''<br />
<br />
Per a connectar-se a una de les xarxes Mesh amb qMp existents a Guifi.net cal primer fer els [[Tres_passos|"tres passos per unir-se a Guifi.net"]]; es a dir:<br />
# Enregistrar-se a la web<br />
# Crear un node <br />
# Afegir un dispositiu<br />
<br />
<br />
== Afegir un dispositiu ==<br />
<br />
* Primer cal seleccionar el model de dispositiu, i concretament un dels [http://qmp.cat/Supported_devices suportats (en)] per qMp.<br />
* A diferència d'altres xarxes de Guifi.net, per enllaçar i connectar a una xarxa Mesh, al crear un dispositiu nou s'ha d'afegir '''una ràdio de tipus "Mesh"'''.<br />
<br />
[[File:MeshRadio1.png|Afegir una ràdio per enllaçar en Mesh]]<br />
<br />
* Un cop afegida la ràdio s'han de configurar els següents paràmetres:<br />
** '''MAC''': aquí cal afegir el [http://es.wikipedia.org/wiki/BSSID BSSID] que s'utilitzi a la zona Mesh on es vol connectar. Normalment amb qMp s'utilitza ''''02:CA:FF:EE:BA:BE''''.<br />
** '''SSID''': identificador Wifi del teu dispositiu. Es prega si us plau <code>guifi.net/[Ciutat][Barri][Carrer][numero]/BMX6[ubicacio]</code><div style="font-size:85%;">'''''Atenció: en molts casos aquesta convenció supera els 32 caràcters que està permès a un ESSID, s'ha de corregir'''''</div> on:<br />
***<code>guifi.net/</code> és una constant que dóna a entendre que el ESSID equival a una URL on es pot trobar informació sobre el node<br />
***<code>[Ciutat][Barri][Carrer][numero]</code> és exactament igual al [[Convencions de noms#Node|nom del node]] a la web de Guifi per a ser reconegut fàcilment al fer un scan.<br />
***<code>BMX6</code> és una constant que identifica pel protocol d'enrutament que es tracta d'un node mesh de [[qMp]]<br />
***<code>[ubicacio]</code> és un parámetre opcional que esdevé obligatori en cas que o bé hi hagin varis nodes mesh a un edifici o aquest estigui en un lloc diferent de la teulada.<br />
****<div style="font-size:85%;">[[Convencions de noms|Més info sobre les convencions de noms]].</div><br />
** '''Protocol''': normalment es fan servir enllaços a 5GHz, ja sigui '''802.11a''' o '''més habitualment 802.11n''' en dispositius nous.<br />
** '''Canal''': el nombre de canal Wifi en que enllacen les antenes a una zona Mesh. ''Cal possar-ho bé ja que cada zona utilitza un (o diversos) de diferent''.<br />
<br />
* S'assignarà automàticament un rang d'adreces IP /27 que seran les que el router/antenna tindrà disponibles per communicar-se i per assignar als dispositius finals (ordinadors, mòbils, etc.).<br />
<br />
[[File:MeshRadio2.png|Paràmetres de la ràdio per enllaçar en Mesh]]<br />
<br />
<br />
== Configurar el dispositiu ==<br />
<br />
Un cop afegits el node i el dispositiu a la web de Guifi.net s'ha d'instal·lar i configurar el software qMp al dispositiu amb els paràmetres que s'han configurat a la web (BSSID, SSID, Canal, IP, etc.).<br />
<br />
* Per instal·lar qMp podeu seguir els passos de: http://es.wiki.guifi.net/wiki/QMP .<br />
<br />
* Per configurar-ho podeu fer servir un dels següents mètodes:<br />
<br />
<br />
=== Unsolclic ===<br />
<br />
Aquesta es l'opció recomenada sinó hi ha una configuració complexa al node.<br />
<br />
Des de gener de 2014, s'ha implementat i afegit l'opció d'[[unsolclic]] pel firmware qMp.<br />
<br />
Apart dels canvis a la web de Guifi s'ha creat un '''nou paquet per qMp ''(qmp-guifi)''''' per donar suport a aquestes funcionalitats relacionades amb Guifi.net.<br />
<br />
* Per tal de configurar el dispositiu amb aquest mètode podeu [[QMP-Guifi|llegir aquí]] com instal·lar-ho i com funciona.<br />
<br />
<br />
=== qMp easy setup ===<br />
<br />
Per defecte el software qMp porta un sistema d'autoconfiguració que deixa apunt el dispositiu per funcionar, i a més, porta un assistent de configuració per canviar fàcilment la configuració més bàsica (Nom, IP, mode, interficies, etc.); abans conegut com "wizard".<br />
<br />
Bàsicament per configurar el dispositiu per Guifi.net amb aquest mètode, cal executar el "qMp easy setup" amb les dades pertinents i canviar les de Wifi, en cas que el dispositiu en porti o en hagi de fer us d'aquesta interfície per Mesh (enlloc o a més d'AP per clients).<br />
<br />
:1. Anar al menú "Node configuration > qMp easy setup"<br />
<br />
:* Canviar el ''network mode'' a '''Community'''.<br />
:* Posar el '''nom''' tal i com s'ha especificat a la web. ''Recomanable afegir un guió darrera, perquè qMp afegeix automàticament un identificador de 4 digits hexadecimals després del nom.''<br />
:* Substituir la '''IP''' i '''màscara''' per la que ha generat i assignat la web de Guifi al dispositiu.<br />
:* Canviar el comportament/us de les interfícies en cas que no es vulgui la configuració per defecte.<br />
<br />
: ''[Afegir imatge qMp easy setup]''<br />
<br />
:2. Anar al menú "Wireless settings"<br />
<br />
:* Canviar l'SSID o ESSID (principalment de l'interfície que farà Mesh) pel que s'ha descrit a l'apartat anterior.<br />
:* Configurar el canal amb el de la zona on es vol connectar<br />
<br />
: ''[Afegir imatge WIFI]''<br />
<br />
<br />
<br />
== Nodes frontera ==<br />
<br />
Un node frontera és un node que interconnecta una xarxa Mesh amb la resta de Guifi.net.<br />
<br />
Com a mínim són necessaris dos dispositius, o bé, un amb dues antennes/ràdios.<br />
<br />
Hi ha dues maneres de muntar un node frontera:<br />
<br />
:1. Nodes frontera només amb qMp.<br />
: Utilitzant el paquet de [[Quagga]] per [[OpenWRT]].<br />
<br />
''[Cal completar]''<br />
<br />
:2. Nodes frontera amb diferents dispositius.<br />
: Podeu veure un tipus de configuració "híbrida" amb [[Node_frontera_amb_qMp|qMp i una RB Mikrotik]] amb [[Router OS]].<br />
<br />
''[Cal completar]''<br />
<br />
<br />
<br />
== Limitacions actuals ==<br />
<br />
Actualment la web de Guifi.net presenta algunes limitacions per crear i representar les xarxes Mesh.<br />
<br />
* No es pot fer un dispositiu amb una ràdio per Mesh i altra per infraestructura, i alhora '''reservar un rang d'IP diferent (Mesh,public)''' per cadascuna, ja que la interfície wlan/lan es crea associada només a la primera ràdio afegida i llavors només es poden afegir nous rangs d'IP a aquesta interfície.<br />
** Per permetre assignar una (o diverses) IP a cada ràdio/cable farien falta canvis més grans a la web i adaptar la BD. Com que això no està previst a curt termini, de moment, es aconsellable en dispositius "Mixtes" crear primer la ràdio Mesh i després la ràdio AP per a que la primera sigui l'associada a la interfície wlan/lan, i després, si cal, afegir manualment una IP del rang "public".<br />
<br />
<br />
* Si hi ha '''algun node que té visió cap a dues xarxes Mesh''' (p.ex. GSF-Vallcarca, UPC-Sants), automàticament no es podrà assignar una IP de cada rang, ja que el node hauria d'estar alhora a dues subzones.<br />
** Per solventar això, es podria fer, o bé deixar el node a la zona superior (p.ex. Barcelona) i afegir les IP de les Mesh manualment per un administrador als diferents dispositius; o bé deixar-ho en una zona/núvol que tingui rang IP Mesh i afegir manualment el rang de l'altra Mesh a un altre dispositiu.<br />
<br />
<br />
* De moment, '''no es poden representar/pintar al mapa els enllaços Mesh''', ja que al ser dinàmics no està implementada la opció a la web.<br />
** Per veure els nodes a un mapa, podeu mirar el que hi ha integrat al software qMp dins del dispositiu. <br />
** O bé al mapa d'[[Altermesh]] seleccionant qMp.cat al desplegable (combo box): http://map.qmp.cat/<br />
<br />
<br />
* La funcionalitat d'unsolclic no permet dispositius híbrids/mixtes, es a dir, de moment només està implementat per configurar la primera interfície wifi en mode ad-hoc (per Mesh), deixant la resta tal i com estiguin.<br />
<br />
<br />
<br />
== Vegeu també ==<br />
<br />
* [[Quick_Mesh_Project_(qMp)|Quick Mesh Project (qMp)]]<br />
* [http://es.wiki.guifi.net/wiki/Altermesh Altermesh (wiki (es))]<br />
* [http://es.wiki.guifi.net/wiki/Instalaci%C3%B3n_de_qMp_en_RouterStation_Pro Instalación de qMp en RouterStation Pro(wiki (es))]<br />
* [http://es.wiki.guifi.net/wiki/MonsterBox MonsterBox (wiki (es))]<br />
* [http://es.wiki.guifi.net/wiki/MANET MANET (wiki (es))]<br />
* [http://es.wiki.guifi.net/wiki/QMp_al_Jard%C3%AD_Bot%C3%A0nic_de_Barcelona qMp al Jardí Botànic de Barcelona (wiki (es))]<br />
<br />
<br />
<br />
== Enllaços externs ==<br />
* [http://qmp.cat/ Web del projecte qMp]<br />
* [http://graciasensefils.net/ Gracia Sense Fils]<br />
* [http://guifisants.net/ Guifi Sants]<br />
* [http://poblenousensefils.net/ Poble Nou Sense Fils]<br />
<br />
<br />
; Llistes de correu<br />
* [https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-users qmp-users ''(anglès)'']<br />
* [https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-dev qmp-dev ''(anglès)'']<br />
* [https://llistes.guifi.net/sympa/info/guifi-mesh guifi-mesh]<br />
* [https://llistes.graciasensefils.net/pipermail/graciasensefils/ gsf usuaris]<br />
* [https://llistes.graciasensefils.net/pipermail/gsf-dev/ <strike>gsf-dev</strike> ''(tancada)'']<br />
* [https://mail.guifisants.net/cgi-bin/mailman/listinfo/llista guifi sants]<br />
<br />
<br />
<br />
[[Categoria:MANET]]<br />
<br />
[[es:Abrir redes tipo mesh a través de Guifi.net]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/QMP-GuifiQMP-Guifi2014-02-11T16:13:21Z<p>Conxuro: Es crea la pàgina amb «Des de gener de 2014, s'ha implementat i afegit l'opció d'unsolclic pel firmware qMp. Apart dels canvis a la web de Guifi s'ha creat un nou paquet per qMp (qMp-Guifi...».</p>
<hr />
<div>Des de gener de 2014, s'ha implementat i afegit l'opció d'unsolclic pel firmware qMp.<br />
<br />
Apart dels canvis a la web de Guifi s'ha creat un nou paquet per qMp (qMp-Guifi) per donar suport a aquestes funcionalitats relacionades amb Guifi.net. <br />
<br />
<br />
<br />
De moment es pot llegir en anglès com instal·lar el paquet qMp-Guifi i com es fa servir la funcionalitat d'unsolclic:<br />
<br />
http://dev.qmp.cat/projects/qmp/wiki/Guifi_oneclick<br />
<br />
<br />
''[Pendent de traduir i completar]''.<br />
<br />
<br />
<br />
[[Categoria:MANET]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Connectar-se_a_una_xarxa_meshConnectar-se a una xarxa mesh2014-02-11T16:02:52Z<p>Conxuro: Afegit apartat configuració</p>
<hr />
<div>'''''Nota: Si la xarxa mesh no està creada, primer s'ha d'[[Obrir xarxes tipus mesh a través de Guifi.net|Obrir]]'''''<br />
<br />
Per a connectar-se a una de les xarxes Mesh amb qMp existents a Guifi.net cal primer fer els [[Tres_passos|"tres passos per unir-se a Guifi.net"]]; es a dir:<br />
# Enregistrar-se a la web<br />
# Crear un node <br />
# Afegir un dispositiu<br />
<br />
<br />
== Afegir un dispositiu ==<br />
<br />
* Primer cal seleccionar el model de dispositiu, i concretament un dels [http://qmp.cat/Supported_devices suportats (en)] per qMp.<br />
* A diferència d'altres xarxes de Guifi.net, per enllaçar i connectar a una xarxa Mesh, al crear un dispositiu nou s'ha d'afegir '''una ràdio de tipus "Mesh"'''.<br />
<br />
[[File:MeshRadio1.png|Afegir una ràdio per enllaçar en Mesh]]<br />
<br />
* Un cop afegida la ràdio s'han de configurar els següents paràmetres:<br />
** '''MAC''': aquí cal afegir el [http://es.wikipedia.org/wiki/BSSID BSSID] que s'utilitzi a la zona Mesh on es vol connectar. Normalment amb qMp s'utilitza ''''02:CA:FF:EE:BA:BE''''.<br />
** '''SSID''': identificador Wifi del teu dispositiu. Es prega si us plau <code>guifi.net/[Ciutat][Barri][Carrer][numero]/BMX6[ubicacio]</code><div style="font-size:85%;">'''''Atenció: en molts casos aquesta convenció supera els 32 caràcters que està permès a un ESSID, s'ha de corregir'''''</div> on:<br />
***<code>guifi.net/</code> és una constant que dóna a entendre que el ESSID equival a una URL on es pot trobar informació sobre el node<br />
***<code>[Ciutat][Barri][Carrer][numero]</code> és exactament igual al [[Convencions de noms#Node|nom del node]] a la web de Guifi per a ser reconegut fàcilment al fer un scan.<br />
***<code>BMX6</code> és una constant que identifica pel protocol d'enrutament que es tracta d'un node mesh de [[qMp]]<br />
***<code>[ubicacio]</code> és un parámetre opcional que esdevé obligatori en cas que o bé hi hagin varis nodes mesh a un edifici o aquest estigui en un lloc diferent de la teulada.<br />
****<div style="font-size:85%;">[[Convencions de noms|Més info sobre les convencions de noms]].</div><br />
** '''Protocol''': normalment es fan servir enllaços a 5GHz, ja sigui '''802.11a''' o '''més habitualment 802.11n''' en dispositius nous.<br />
** '''Canal''': el nombre de canal Wifi en que enllacen les antenes a una zona Mesh. ''Cal possar-ho bé ja que cada zona utilitza un (o diversos) de diferent''.<br />
<br />
* S'assignarà automàticament un rang d'adreces IP /27 que seran les que el router/antenna tindrà disponibles per communicar-se i per assignar als dispositius finals (ordinadors, mòbils, etc.).<br />
<br />
[[File:MeshRadio2.png|Paràmetres de la ràdio per enllaçar en Mesh]]<br />
<br />
<br />
== Configurar el dispositiu ==<br />
<br />
Un cop afegits el node i el dispositiu a la web de Guifi.net s'ha d'instal·lar i configurar el software qMp al dispositiu amb els paràmetres que s'han configurat a la web (BSSID, SSID, Canal, IP, etc.).<br />
<br />
* Per instal·lar qMp podeu seguir els passos de: http://es.wiki.guifi.net/wiki/QMP .<br />
<br />
* Per configurar-ho podeu fer servir dels següents mètodes:<br />
<br />
=== Wizard ===<br />
<br />
Per defecte el software qMp porta un sistema d'autoconfiguració que deixa apunt el dispositiu per funcionar, i a més, porta un assistent de configuració per canviar fàcilment la configuració més bàsica (Nom, IP, mode, interficies, etc.).<br />
<br />
Bàsicament per configurar el dispositiu per Guifi.net amb aquest mètode, cal executar el Wizard amb les dades pertinents i canviar les de Wifi, en cas que el dispositiu en porti o en hagi de fer us d'aquesta interfície per Mesh (enlloc o a més d'AP per clients).<br />
<br />
:1. Anar al menú Configuration > Wizard <br />
<br />
:* Canviar el ''network mode'' a '''Community'''.<br />
:* Posar el '''nom''' tal i com s'ha especificat a la web. ''Recomanable afegir un guió darrera, perquè qMp afegeix automàticament un identificador de 4 digits hexadecimals després del nom.''<br />
:* Substituir la '''IP''' i '''màscara''' per la que ha generat i assignat la web de Guifi al dispositiu.<br />
:* Canviar el comportament/us de les interfícies en cas que no es vulgui la configuració per defecte.<br />
<br />
: ''[Afegir imatge WIZARD]''<br />
<br />
:2. Anar al menú Wifi<br />
<br />
:* Canviar l'SSID o ESSID (principalment de l'interfície que farà Mesh) pel que s'ha descrit a l'apartat anterior.<br />
:* Configurar el canal amb el de la zona on es vol connectar<br />
<br />
: ''[Afegir imatge WIFI]''<br />
<br />
=== Unsolclic ===<br />
<br />
Des de gener de 2014, s'ha implementat i afegit l'opció d'[[unsolclic]] pel firmware qMp.<br />
<br />
Apart dels canvis a la web de Guifi s'ha creat un '''nou paquet per qMp ''(qmp-guifi)''''' per donar suport a aquestes funcionalitats relacionades amb Guifi.net.<br />
<br />
* Per tal de configurar el dispositiu amb aquest mètode podeu [[TO ADD link|llegir aquí]] com instal·lar-ho i com funciona.<br />
<br />
<br />
<br />
== Nodes frontera ==<br />
<br />
Un node frontera és un node que interconnecta una xarxa Mesh amb la resta de Guifi.net.<br />
<br />
Com a mínim són necessaris dos dispositius, o bé, un amb dues antennes/ràdios.<br />
<br />
Hi ha dues maneres de muntar un node frontera:<br />
<br />
:1. Nodes frontera només amb qMp.<br />
: Utilitzant el paquet de [[Quagga]] per [[OpenWRT]].<br />
<br />
''[Cal completar]''<br />
<br />
:2. Nodes frontera amb diferents dispositius.<br />
: Podeu veure un tipus de configuració "híbrida" amb [[Node_frontera_amb_qMp|qMp i una RB Mikrotik]] amb [[Router OS]].<br />
<br />
''[Cal completar]''<br />
<br />
<br />
== Limitacions actuals ==<br />
<br />
Actualment la web de Guifi.net presenta algunes limitacions per crear i representar les xarxes Mesh.<br />
<br />
* No es pot fer un dispositiu amb una ràdio per Mesh i altra per infraestructura, i alhora '''reservar un rang d'IP diferent (Mesh,public)''' per cadascuna, ja que la interfície wlan/lan es crea associada només a la primera ràdio afegida i llavors només es poden afegir nous rangs d'IP a aquesta interfície.<br />
** Per permetre assignar una (o diverses) IP a cada ràdio/cable farien falta canvis més grans a la web i adaptar la BD. Com que això no està previst a curt termini, de moment, es aconsellable en dispositius "Mixtes" crear primer la ràdio Mesh i després la ràdio AP per a que la primera sigui l'associada a la interfície wlan/lan, i després, si cal, afegir manualment una IP del rang "public".<br />
<br />
<br />
* Si hi ha '''algun node que té visió cap a dues xarxes Mesh''' (p.ex. GSF-Vallcarca, UPC-Sants), automàticament no es podrà assignar una IP de cada rang, ja que el node hauria d'estar alhora a dues subzones.<br />
** Per solventar això, es podria fer, o bé deixar el node a la zona superior (p.ex. Barcelona) i afegir les IP de les Mesh manualment per un administrador als diferents dispositius; o bé deixar-ho en una zona/núvol que tingui rang IP Mesh i afegir manualment el rang de l'altra Mesh a un altre dispositiu.<br />
<br />
<br />
* De moment, '''no es poden representar/pintar al mapa els enllaços Mesh''', ja que al ser dinàmics no està implementada la opció a la web.<br />
** Per veure els nodes a un mapa, podeu mirar el que hi ha integrat al software qMp dins del dispositiu. <br />
** O bé al mapa d'[[Altermesh]] seleccionant qMp.cat al desplegable (combo box): http://map.qmp.cat/<br />
<br />
<br />
* La funcionalitat d'unsolclic no permet dispositius híbrids/mixtes, es a dir, de moment només està implementat per configurar la primera interfície wifi en mode ad-hoc (per Mesh), deixant la resta tal i com estiguin.<br />
<br />
<br />
== Vegeu també ==<br />
<br />
* [[Quick_Mesh_Project_(qMp)|Quick Mesh Project (qMp)]]<br />
* [http://es.wiki.guifi.net/wiki/Altermesh Altermesh (wiki (es))]<br />
* [http://es.wiki.guifi.net/wiki/Instalaci%C3%B3n_de_qMp_en_RouterStation_Pro Instalación de qMp en RouterStation Pro(wiki (es))]<br />
* [http://es.wiki.guifi.net/wiki/MonsterBox MonsterBox (wiki (es))]<br />
* [http://es.wiki.guifi.net/wiki/MANET MANET (wiki (es))]<br />
* [http://es.wiki.guifi.net/wiki/QMp_al_Jard%C3%AD_Bot%C3%A0nic_de_Barcelona qMp al Jardí Botànic de Barcelona (wiki (es))]<br />
<br />
<br />
== Enllaços externs ==<br />
* [http://qmp.cat/ Web del projecte qMp]<br />
* [http://graciasensefils.net/ Gracia Sense Fils]<br />
* [http://guifisants.net/ Guifi Sants]<br />
* [http://poblenousensefils.net/ Poble Nou Sense Fils]<br />
<br />
<br />
; Llistes de correu<br />
* [https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-users qmp-users ''(anglès)'']<br />
* [https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-dev qmp-dev ''(anglès)'']<br />
* [https://llistes.guifi.net/sympa/info/guifi-mesh guifi-mesh]<br />
* [https://llistes.graciasensefils.net/pipermail/graciasensefils/ gsf usuaris]<br />
* [https://llistes.graciasensefils.net/pipermail/gsf-dev/ <strike>gsf-dev</strike> ''(tancada)'']<br />
* [https://mail.guifisants.net/cgi-bin/mailman/listinfo/llista guifi sants]<br />
<br />
<br />
<br />
[[Categoria:MANET]]<br />
<br />
[[es:Abrir redes tipo mesh a través de Guifi.net]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Obrir_xarxes_tipus_mesh_a_trav%C3%A9s_de_Guifi.netObrir xarxes tipus mesh a través de Guifi.net2014-01-28T19:40:35Z<p>Conxuro: /* Recomanacions */</p>
<hr />
<div>[[File:GSF-logo.png|right]]<br />
[[File:Qmp_small.png|right|200px]]<br />
Aquest manual explica com integrar amb Guifi.net les xarxes mesh (també conegudes com [[MANET]] i enteses com xarxes que funcionen amb protocols d'enrutament dinàmic com [[B.A.T.M.A.N.-adv]], [[BMX6]] o d'[[protocols d'enrutament dinàmic|altres]]) de forma que s'intercanviin dades amb la resta de la xarxa lliure a través d'[[IPv4]].<br />
<br />
El manual es basa en la manera de donar d'alta els nodes mesh a la web de Guifi.net.<br />
<br />
Originàriament a [[Guifi.net]] per fer aquest tipus de xarxes es feia servir un software desenvolupat per la comunitat del barri de Gràcia de Barcelona, [[GSF|Gràcia Sense Fils (GSF)]].<br />
<br />
Actualment es fa servir habitualment el software desenvolupat al projecte [[Quick Mesh Project (qMp)]], encara que hi han altres tipus de software aquest manual es basa en qMp.<br />
<br />
Des de juny de 2013 s'han aplicat uns petits canvis per adaptar la web millor a les xarxes Mesh, més concretament amb [[Quick_Mesh_Project_(qMp)|qMp]].<br />
<br />
Ara, ja no hi ha tipus de zones (ad-hoc, infraestructura) i el que hi ha és un nou tipus de ràdio "Mesh".<br />
<br />
A més, per poder fer una millor agregació IP a les zones, es defineix un nou tipus d'adreces IP "Mesh" que és el que s'assigna als dispositius amb aquestes ràdios.<br />
<br />
<br />
== Crear un núvol Mesh ==<br />
<br />
La finalitat de crear un núvol Mesh és permetre agrupar els nodes que és connectaran a aquest tipus de xarxes, i reservar i assignar adreces IP a la web només per aquests nodes.<br />
<br />
<br />
=== Crear una nova zona === <br />
<br />
Es pot crear una zona nova a la web seguint aquests [[Zona|passos per configurar-la]], o bé utilitzar una existent.<br />
<br />
<br />
=== Afegir un rang IP ===<br />
<br />
El més important de tot és afegir un nou adreçament IP de tipus Mesh a la zona (sigui nova o no), per a que es pugui assignar IP als dispositius que es connectin en Mesh.<br />
<br />
[[File:MeshNetwork1.png|Afegir un rang nou]]<br />
<br />
<br />
<br />
== Recomanacions ==<br />
<br />
* Reservar rangs IP de tipus Mesh per les zones amb una màscara d'almenys /21 (255.255.248.0).<br />
<br />
* Pel que fa a l'adreçament IP, es recomanable fer servir rangs consecutius als núvols que estiguin a prop, per afavorir una possible agregació IP. Per exemple:<br />
** Xarxes mesh a Barcelona: 10.1.0.0/21, 10.1.8.0/21, 10.1.16.0/21, etc.<br />
** Xarxes mesh a Menorca: 10.2.0.0/21, 10.2.8.0/21, etc.<br />
<br />
* Afegir les dades de la nova zona a [[Annex:subxarxes_mesh|l'annex de la wiki]] per a una millor organització.<br />
<br />
* Utilitzar l'eina de cerca d'IP de Guifi.net, per tal d'evitar el [[Obrir_xarxes_tipus_mesh_a_través_de_Guifi.net#Limitacions_actuals|bug de la web]].<br />
<br />
<br />
''REVISAR: [[Criteris d'assignació d'adreces IPv4]]<br />
<br />
== Limitacions actuals ==<br />
<br />
* La web '''no cerca per a rangs IP de tipus Mesh'''.<br />
** S'ha de utilitzar l'eina de [http://guifi.net/ca/guifi/menu/ip/ipsearch/10.1.%2525 cerca d'adreces IP] per veure els rangs disponibles.<br />
** S'ha d'afegir manualment la IP base de xarxa i la màscara.<br />
* La web '''no distingueix si un rang o IP està en ús''' si no s'afegeix exactament la mateixa adreça i màscara.<br />
:''P.ex. Si s'afegeix una xarxa 10.1.4.0/24, ho permet, tot i que el rang 10.1.0.0/21 estigui assignat prèviament (només ho evitaria si intentèssim afegir 10.1.0.0/21 de nou).''<br />
<br />
<br />
Segueix a "[[Connectar-se a una xarxa mesh]]"<br />
<br />
[[Categoria:MANET]]<br />
<br />
[[es:Abrir redes tipo mesh a través de Guifi.net]]</div>Conxurohttp://ca.wiki.guifi.net/wiki/Thread:Categoria_Discussi%C3%B3:MANET/Nom_de_la_categoriaThread:Categoria Discussió:MANET/Nom de la categoria2014-01-28T19:04:37Z<p>Conxuro: Nou fil: Nom de la categoria</p>
<hr />
<div>El nom de la categoria s'hauria de reanomenar a '''Mesh''', ja que quan fem servir la paraula Mesh estem parlant de xarxes mallades amb protocols dinàmics d'encaminament.<br />
<br />
Aquestes xarxes Mesh, a part de la topologia mallada (mesh) i els protocols que les caracterizten, no es fan utilitzant només enllaços sense fils. És a dir, no són només xarxes MANET o amb connexions wifi en mode ad-hoc, sinó també es fan servir connexions per cable (p.ex. ethernet).<br />
<br />
En el cas concret de Guifi.net, actualment es fa servir qMp, que utilitza principalment el protocol d'encaminament BMX6. Aquest protocol és de capa 3, és a dir, treballa a nivell de xarxa indistintament del tipus d'enllaç (capa 2) o mitjà (capa 1).</div>Conxurohttp://ca.wiki.guifi.net/wiki/Categoria_Discussi%C3%B3:MANETCategoria Discussió:MANET2014-01-28T19:04:37Z<p>Conxuro: Pàgina de discussió creada automàticament quan es va crear el primer fil.</p>
<hr />
<div></div>Conxurohttp://ca.wiki.guifi.net/wiki/Annex:subxarxes_meshAnnex:subxarxes mesh2014-01-28T18:52:19Z<p>Conxuro: </p>
<hr />
<div>{{en desenvolupament}}<br />
<br />
{| class="wikitable sortable"<br />
|- style="background:#ececec;"<br />
! Abreviació de la comunitat <ref>Segons les [[convencions de noms]] s'hauria de fer servir la minúscula, en aquesta taula surten reflexades dues en alguns casos per reflexar que per motius històrics es poden trobar nodes encara amb la convenció de noms en majúscula (NOTA: S'ha d'acordar bé encara això)</ref><br />
! Nom de la xarxa - comunitat<br />
! Ubicació<br />
! [[ESSID]] comunitari<br />
! [[firmware]]<br />
! [[canal]]<br />
! IP<br />
|-<br />
| CIU<br />
| [[Mesh a Ciutadella]]<br />
| Ciutadella a l'illa de Menorca.<br />
|<br />
| [[qMp]]<br />
| 140- i més ...?<br />
| 10.2.0.0/21<br />
|-<br />
| ENG<br />
| Mesh a Anglaterra<br />
| Nodes desplegats a Anglaterra (més info: Routek.net)<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 10.1.128.0/17<br />
|-<br />
| gll<br />
| [[Garraf Lliure]]<br />
| Comarca del Garraf a Barcelona<br />
| garraflliure.guifi.net<br />
| [[libre-mesh]]<br />
| 11 i 36<br />
| ?<br />
|-<br />
| GS - '''gs'''<br />
| [[GuifiSants]]<br />
| Sants - Les Corts al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+, 124+ i 140-<br />
| 10.1.8.0/21<br />
|-<br />
| GSF - '''gsf'''<br />
| [[Gràcia Sense Fils]]<br />
| Vila de Gràcia al municipi de Barcelona<br />
|<br />
| [[gsffirm]] i [[qMp]]<br />
| 140-<br />
| 10.1.0.0/21<br />
|-<br />
| HRT<br />
| [[Horta-Carmel]]<br />
| Part nord del districte Horta-Guinardó al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 10.1.72.0/21<br />
|-<br />
| HW<br />
| [[Hospitalet Wireless]]<br />
| Núvol de Bellvitge a la ciutat de l'Hospitalet del Llobregat<br />
| <br />
| [[qMp]]<br />
| 140-<br />
| 10.1.32.0/21<br />
|-<br />
| IRU<br />
| [[Mesh a Iruña]]<br />
| Núvol Mesh a Iruña a Navarra<br />
| <br />
| [[qMp]]<br />
| 140-<br />
| 10.1.248.0/21<br />
|-<br />
| mtj<br />
| [[Montjuïc - Jardí Botànic]]<br />
| Cara alta nord de Montjuïc al districte de Sants - Montjuïc a Barcelona<br />
| jardibotanic.guifi.net<br />
| [[qMp]], [[altermesh]] i [[libre-mesh]]<br />
| 48<br />
| ?<br />
|-<br />
| P9SF - '''p9sf'''<br />
| [[Poblenou Sense Fils]]<br />
| Poblenou al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 10.1.64.0/21<br />
|-<br />
| RAV - '''rav'''<br />
| [[Mesh al Raval]]<br />
| Barri del raval al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 10.1.16.0/21<br />
|-<br />
| SCC<br />
| [[ Mesh a Santa Coloma de Cervelló]]<br />
| Municipi de Santa Coloma de Cervelló a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 10.1.80.0/21<br />
|-<br />
| SJD - '''sjd'''<br />
| [[Mesh a Sant Joan Despí]]<br />
| Municipi de Sant Joan Despí a la comarca del Baix Llobregat<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 10.1.40.0/21<br />
|-<br />
| SAND - '''sand'''<br />
| [[Mesh a Sant Andreu]]<br />
| Barri de Sant Andreu al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 10.1.56.0/21<br />
|-<br />
| UPC - '''upc'''<br />
| [[Mesh a la UPC]]<br />
| Campus Nord de la Universitat Politècnica de Catalunya a Barcelona<br />
|<br />
| [[qMp]]<br />
| 140-<br />
| 10.1.24.0/21<br />
|-<br />
| vllc<br />
| [[Mesh a Vallcarca]]<br />
| Barri de Vallcarca i els Penitents al municipi de Barcelona<br />
|<br />
| [[qMp]]<br />
| 108+ i 140-<br />
| 10.1.48.0/21<br />
|}<br />
<br />
<references /><br />
<br />
'''IMPORTANT: Actualment hi ha un conflicte amb els adreçaments IP de les zones d'''Anglaterra'' i ''Iruña''. S'hauria de corregir abans de que aquestes illes connectin amb la resta de Guifi, per tal d'evitar problemes.'''<br />
<br />
[[categoria:MANET]]</div>Conxuro