Guifi.net - Wiki Català - Contribucions de l'usuari [ca]

LDAP/ca

2013-04-30T15:04:12Z

Rotobator: /* Ús de ldap.guifi.net */

{{en desenvolupament}}
{|align=left
|__TOC__
|}
== LDAP ==
=== Introducció ===
Les intencions: disposar d'una infraestructura que permeta autenticar una base única d'usuaris (drupal, wiki, trac, proxy federat...). Es tria LDAP per ser el backend més comú en el sentit que moltes eines (web i no web com ara radius) disposen de complements per autenticar/autoritzar els usuaris. En qualsevol cas,l'autenticació més segura passa per usar ssl a l'hora d'accedir a ldap, o mecanismes de desafiament resposta (només usables si al backend tenim la contrasenya en clar).

=== Càrrega d'usuaris ===
S'han desenvolupat uns scripts que poden exportar els usuaris d'un '''drupal 6''' o els '''usuaris dels proxys federats''' i importar-los cap a un openldap. Són scripts pensats per crear una rama de l'estil: <code>dc=guifi,dc=net</code>, encara que es pot configurar per qualsevol altre domini, i també afegir més ''domain components'' de forma que poguem crear rames de la principal i d'esta forma, obtindre una jerarquía d'ldaps, tal volta per oferir un punt únic d'autenticació i delegar-la cap al ldap que finalment puga autenticar-nos, a l'estil [http://www.google.es/url?sa=t&source=web&cd=1&sqi=2&ved=0CBwQFjAA&url=http%3A%2F%2Fwww.eduroam.es%2F&ei=rVDZTaDRAZDG8QPP9-iDBQ&usg=AFQjCNHHrBdRg0rHL7dx6lQvRJf0_EIpRQ d'EDUROAM].

Els scripts es troben al gitorius: <code>git clone https://git.gitorious.org/ldapusers/ldapusers.git</code>. Hi ha un ''Readme'' que explica com posar en marxa un directori a partir dels usuaris d'un drupal. Bàsicament, hem d'instal.lar: <code>apt-get install slapd ldap-utils db4.6-util # ó db4.7-util</code> i configurar <code>config.sh</code> amb les dades del directori i les dades d'accés a mySQL. Hi ha també uns exemples de configuració per al openLdap, pensats per a Fedora/Redhat, però l'adaptació a debian/ubuntu, és tan fàcil com canviar <code>/etc/openldap/</code> per <code>/etc/ldap</code> a totes les referències que hi hagin a <code>config.sh</code>.

Una vegada instal.lats, la càrrega es pot fer periòdicament, executant: <code>./ldif_from_hdb.sh drupal6</code>. Exemples de recerca:
* <code>ldapsearch -x -w PASSWORD -D "uid=webldap2011,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "uid=rotobator"</code>
* per comprovar que l'autenticació funciona podem fer bind amb un usuari: <code>ldapsearch -x -W -D "uid=rotobator,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(cn=rotobator)"</code>.

* recerca d'usuaris federats a la rama del proxy: <code>ldapsearch -x -w PASSWORD -D "uid=proxyldap2011,o=proxyusers,dc=guifi,dc=net" -b "o=proxyusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(&(uid=miquel.martos)(ou=2624))"</code>

=== Ús de ldap.guifi.net ===
En un principi, qualsevol màquina/servei, pot usar aquest directori per autenticar usuaris de guifi.net, però hi ha una sèrie de mesures de seguretat que cal tindre en compte:
* El directori no permet recuperar cap data personal ni d'altres persones, només permet autenticar usuaris.
* Només l'usuari ''cn=webldap2011,o=webusers, dc=guifi,dc=net'' (per als usuaris importats des del drupal) o l'usuari ''cn=proxyldap2011,o=proxyusers, dc=guifi,dc=net'' (per als usuaris dels proxys federats) poden obtindre les dades emmagatzemades, encara que este usuari està reservat per a ús intern i manteniment del directori.
* L'accés al directori només és posible mijançant ''LDAPS'', és a dir, usant TLS/SSL.

=== Configuració de clients ===
Exemples de configuracions. En general hem de configurar les llibreries client del sistema, per això hem de modificar l'arxiu '''/etc/ldap/ldap.conf''' a ubuntu o '''/etc/openldap/ldap.conf''' a fedora:
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
BASE dc=guifi,dc=net
URI ldaps://ldap.guifi.net/ ldaps://ldap2.guifi.net/
TLS_REQCERT never

</pre>
==== Proxy federat ====

Abans de començar haurem de tindre clar quin és el node ID del nostre proxy (http://guifi.net/node/NODEID) per que ens el demana en la instal.lació:

* Afegir els repositoris a ''/etc/apt/sources.list''
deb http://repo.vic.guifi.net/debian guifi/
deb http://repo.vic.guifi.net/debian guifi-testing/

* executar:
sudo apt-get update
sudo apt-get install guifi-proxy3

Amb això ja tenim un squid en marxa, un cron que actualitza els ACLs i autenticació automàctica contra '''ldap.guifi.net'''. Per la configuració personalitzada hem d'usar ''/etc/squid3/custom.conf''.

==== LDAP al Mediawiki ====
*Instal.lació de la extensió d'LDAP per a mediawiki:
**Ubuntu:
sudo apt-get install mediawiki-extensions-ldapauth
sudo mwenext LdapAuthentication.php
**Altres vore http://www.mediawiki.org/wiki/Special:ExtensionDistributor/LdapAuthentication.

*Es passen les dades per omplir aquesta configuració. Simplement nom de domini i LDAPBaseDN. Per a <code>$wgLDAPEncryptionType</code> pot ser <code>"clear"</code> o <code>"ssl"</code>.
<pre>
## LDAP_Authentication
## http://www.mediawiki.org/wiki/Extension:LDAP_Authentication
## svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/LdapAuthentication/
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

//Nombres de los dominios que utilizarás.
$wgLDAPDomainNames = array("LDAP");

//Asociación entre nombre de dominio y nombre DNS de la máquina donde se va a validar.
$wgLDAPServerNames = array("LDAP"=>"ldap.guifi.net");

//Podemos permitir la convivencia de autenticación local del wiki con LDAP.
$wgLDAPUseLocal = true;

//Encriptación en las solicitudes LDAP.
$wgLDAPEncryptionType = array("LDAP"=>"ssl");

//Le decimos cual es la base de la consulta
$wgLDAPBaseDNs = array("LDAP"=>"o=webusers,dc=guifi,dc=net");
$wgLDAPSearchAttributes = array("LDAP"=>"uid");

//no usem les directives de grup de moment
$wgLDAPGroupsPrevail = array("LDAP"=>false);
$wgLDAPGroupNameAttribute = array("LDAP"=>"cn");

//facilitem el user DN
$wgLDAPSearchStrings = array(
"LDAP"=>"uid=USER-NAME,o=webusers,dc=guifi,dc=net"
);

</pre>

==== LDAP al WP amb el plugin simple LDAP login ====

Per integrar els inicis de sessió Wordpress d'una delegació de guifi amb ldap.guifi.net, podem fer servir per exemple el plugin "[https://wordpress.org/extend/plugins/simple-ldap-login/ Simple LDAP Login]".

[[Fitxer:Ldap_working.PNG]]

Requeriments:
Es necessari tenir suport LDAP a PHP (en sistemes debian/ubuntu, paquet php5-ldap)
També, si el servidor on s'esta instal·lant Wordpress, no te un certificat SSL (per exemple, un autogenerat), s'ha d'afegir el següent a l'arxiu /etc/ldap/ldap.conf (o /etc/ldap.conf):

TLS_REQCERT never

==== LDAP al WP amb el plugin wpDirAuth ====
Aquest plugin és el més adequat per a la integració, donat que és el més actualitzat (funciona correctament la v1.7.6 amb el WordPress v 3.5.1). Una vegada hem instal.lat el plugin (http://wordpress.org/extend/plugins/wpdirauth/installation/), els prerequisits són els mateixos que amb el "simple LDAP login" (secció d'abans), i la configuració bàsica és la següent:
<pre>
Enable Directory Authentication?: Yes
Enable SSL Connectivity?: Use SSL (ldaps)
Directory Servers (Domain Controllers): ldap.guifi.net, ldap2.guifi.net
Account Filter: uid
Base DN: o=webusers,dc=guifi,dc=net
Bind DN: uid=webldap2011,o=webusers,dc=guifi,dc=net
Bind Passwor: XXXXXXXX
</pre>
[[Fitxer:Ldap_WP_wpDirAuth.PNG]]

Este plugin necessita un usuari administrador que tinga permís al ldap per poder buscar usuaris de forma anònima, el dit usuari és "uid=webldap2011,o=webusers,dc=guifi,dc=net" i la contrasenya "XXXXXXX" l'heu de demanar a rotobator AT gmail.com (Antonio Garcia), de moment, fins que disposem d'un mètode més seriós. D'esta forma tenim constància des usuaris que usen esta contrasenya per tal d'avisar-los quant es canvíe, etc.

== Proves de balanceig/distribució ==
''Ben mirat potser més el segon que no pas el primer per tal d'implementar-ho en un futur pròxim/necessari''

# segona instancia d'ldap, pot ser remota o a la mateixa maquina virtual amb diferents ports.
# haproxy i configuració.
# configuració ldap-drupal per que apunte a haproxy.
# proves de replicació.
## Qué passa si una instancia te problemes?
## s'acumulen transaccions no realitzades?
# avaluar despres de les proves si ens interessa replicació en línia o simplement es sincronitzen les bdd del directori ppal cap a les instancies secundaries.

== Altres ==
Es pot demanar la sincronització del directori principal cap a d'altres instàncies remotes per millorar el temps de resposta. Al repositori esmentat es troben els scripts de sincronització.

Fitxer:Ldap WP wpDirAuth.PNG

2013-03-17T11:33:43Z

Rotobator: Configuració del plugin wpDirAuth per a WordPress

Configuració del plugin wpDirAuth per a WordPress

LDAP/ca

2013-03-17T11:32:12Z

Rotobator:

{{en desenvolupament}}
{|align=left
|__TOC__
|}
== LDAP ==
=== Introducció ===
Les intencions: disposar d'una infraestructura que permeta autenticar una base única d'usuaris (drupal, wiki, trac, proxy federat...). Es tria LDAP per ser el backend més comú en el sentit que moltes eines (web i no web com ara radius) disposen de complements per autenticar/autoritzar els usuaris. En qualsevol cas,l'autenticació més segura passa per usar ssl a l'hora d'accedir a ldap, o mecanismes de desafiament resposta (només usables si al backend tenim la contrasenya en clar).

=== Càrrega d'usuaris ===
S'han desenvolupat uns scripts que poden exportar els usuaris d'un '''drupal 6''' o els '''usuaris dels proxys federats''' i importar-los cap a un openldap. Són scripts pensats per crear una rama de l'estil: <code>dc=guifi,dc=net</code>, encara que es pot configurar per qualsevol altre domini, i també afegir més ''domain components'' de forma que poguem crear rames de la principal i d'esta forma, obtindre una jerarquía d'ldaps, tal volta per oferir un punt únic d'autenticació i delegar-la cap al ldap que finalment puga autenticar-nos, a l'estil [http://www.google.es/url?sa=t&source=web&cd=1&sqi=2&ved=0CBwQFjAA&url=http%3A%2F%2Fwww.eduroam.es%2F&ei=rVDZTaDRAZDG8QPP9-iDBQ&usg=AFQjCNHHrBdRg0rHL7dx6lQvRJf0_EIpRQ d'EDUROAM].

Els scripts es troben al gitorius: <code>git clone https://git.gitorious.org/ldapusers/ldapusers.git</code>. Hi ha un ''Readme'' que explica com posar en marxa un directori a partir dels usuaris d'un drupal. Bàsicament, hem d'instal.lar: <code>apt-get install slapd ldap-utils db4.6-util # ó db4.7-util</code> i configurar <code>config.sh</code> amb les dades del directori i les dades d'accés a mySQL. Hi ha també uns exemples de configuració per al openLdap, pensats per a Fedora/Redhat, però l'adaptació a debian/ubuntu, és tan fàcil com canviar <code>/etc/openldap/</code> per <code>/etc/ldap</code> a totes les referències que hi hagin a <code>config.sh</code>.

Una vegada instal.lats, la càrrega es pot fer periòdicament, executant: <code>./ldif_from_hdb.sh drupal6</code>. Exemples de recerca:
* <code>ldapsearch -x -w PASSWORD -D "uid=webldap2011,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "uid=rotobator"</code>
* per comprovar que l'autenticació funciona podem fer bind amb un usuari: <code>ldapsearch -x -W -D "uid=rotobator,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(cn=rotobator)"</code>.

* recerca d'usuaris federats a la rama del proxy: <code>ldapsearch -x -w PASSWORD -D "uid=proxyldap2011,o=proxyusers,dc=guifi,dc=net" -b "o=proxyusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(&(uid=miquel.martos)(ou=2624))"</code>

=== Ús de ldap.guifi.net ===
En un principi, qualsevol màquina/servei, pot usar aquest directori per autenticar usuaris de guifi.net, però hi ha una sèrie de mesures de seguretat que cal tindre en compte:
* El directori no permet recuperar cap data personal ni d'altres persones, només permet autenticar usuaris.
* Només l'usuari ''cn=admin,o=webusers, dc=guifi,dc=net'' (per als usuaris importats des del drupal) o l'usuari ''cn=admin,o=proxyusers, dc=guifi,dc=net'' (per als usuaris dels proxys federats) poden obtindre les dades emmagatzemades, encara que este usuari està reservat per a ús intern i manteniment del directori.
* L'accés al directori només és posible mijançant ''LDAPS'', és a dir, usant TLS/SSL.

=== Configuració de clients ===
Exemples de configuracions. En general hem de configurar les llibreries client del sistema, per això hem de modificar l'arxiu '''/etc/ldap/ldap.conf''' a ubuntu o '''/etc/openldap/ldap.conf''' a fedora:
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
BASE dc=guifi,dc=net
URI ldaps://ldap.guifi.net/ ldaps://ldap2.guifi.net/
TLS_REQCERT never

</pre>
==== Proxy federat ====

Abans de començar haurem de tindre clar quin és el node ID del nostre proxy (http://guifi.net/node/NODEID) per que ens el demana en la instal.lació:

* Afegir els repositoris a ''/etc/apt/sources.list''
deb http://repo.vic.guifi.net/debian guifi/
deb http://repo.vic.guifi.net/debian guifi-testing/

* executar:
sudo apt-get update
sudo apt-get install guifi-proxy3

Amb això ja tenim un squid en marxa, un cron que actualitza els ACLs i autenticació automàctica contra '''ldap.guifi.net'''. Per la configuració personalitzada hem d'usar ''/etc/squid3/custom.conf''.

==== LDAP al Mediawiki ====
*Instal.lació de la extensió d'LDAP per a mediawiki:
**Ubuntu:
sudo apt-get install mediawiki-extensions-ldapauth
sudo mwenext LdapAuthentication.php
**Altres vore http://www.mediawiki.org/wiki/Special:ExtensionDistributor/LdapAuthentication.

*Es passen les dades per omplir aquesta configuració. Simplement nom de domini i LDAPBaseDN. Per a <code>$wgLDAPEncryptionType</code> pot ser <code>"clear"</code> o <code>"ssl"</code>.
<pre>
## LDAP_Authentication
## http://www.mediawiki.org/wiki/Extension:LDAP_Authentication
## svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/LdapAuthentication/
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

//Nombres de los dominios que utilizarás.
$wgLDAPDomainNames = array("LDAP");

//Asociación entre nombre de dominio y nombre DNS de la máquina donde se va a validar.
$wgLDAPServerNames = array("LDAP"=>"ldap.guifi.net");

//Podemos permitir la convivencia de autenticación local del wiki con LDAP.
$wgLDAPUseLocal = true;

//Encriptación en las solicitudes LDAP.
$wgLDAPEncryptionType = array("LDAP"=>"ssl");

//Le decimos cual es la base de la consulta
$wgLDAPBaseDNs = array("LDAP"=>"o=webusers,dc=guifi,dc=net");
$wgLDAPSearchAttributes = array("LDAP"=>"uid");

//no usem les directives de grup de moment
$wgLDAPGroupsPrevail = array("LDAP"=>false);
$wgLDAPGroupNameAttribute = array("LDAP"=>"cn");

//facilitem el user DN
$wgLDAPSearchStrings = array(
"LDAP"=>"uid=USER-NAME,o=webusers,dc=guifi,dc=net"
);

</pre>

==== LDAP al WP amb el plugin simple LDAP login ====

Per integrar els inicis de sessió Wordpress d'una delegació de guifi amb ldap.guifi.net, podem fer servir per exemple el plugin "[https://wordpress.org/extend/plugins/simple-ldap-login/ Simple LDAP Login]".

[[Fitxer:Ldap_working.PNG]]

Requeriments:
Es necessari tenir suport LDAP a PHP (en sistemes debian/ubuntu, paquet php5-ldap)
També, si el servidor on s'esta instal·lant Wordpress, no te un certificat SSL (per exemple, un autogenerat), s'ha d'afegir el següent a l'arxiu /etc/ldap/ldap.conf (o /etc/ldap.conf):

TLS_REQCERT never

==== LDAP al WP amb el plugin wpDirAuth ====
Aquest plugin és el més adequat per a la integració, donat que és el més actualitzat (funciona correctament la v1.7.6 amb el WordPress v 3.5.1). Una vegada hem instal.lat el plugin (http://wordpress.org/extend/plugins/wpdirauth/installation/), els prerequisits són els mateixos que amb el "simple LDAP login" (secció d'abans), i la configuració bàsica és la següent:
<pre>
Enable Directory Authentication?: Yes
Enable SSL Connectivity?: Use SSL (ldaps)
Directory Servers (Domain Controllers): ldap.guifi.net, ldap2.guifi.net
Account Filter: uid
Base DN: o=webusers,dc=guifi,dc=net
Bind DN: uid=webldap2011,o=webusers,dc=guifi,dc=net
Bind Passwor: XXXXXXXX
</pre>
[[Fitxer:Ldap_WP_wpDirAuth.PNG]]

Este plugin necessita un usuari administrador que tinga permís al ldap per poder buscar usuaris de forma anònima, el dit usuari és "uid=webldap2011,o=webusers,dc=guifi,dc=net" i la contrasenya "XXXXXXX" l'heu de demanar a rotobator AT gmail.com (Antonio Garcia), de moment, fins que disposem d'un mètode més seriós. D'esta forma tenim constància des usuaris que usen esta contrasenya per tal d'avisar-los quant es canvíe, etc.

== Proves de balanceig/distribució ==
''Ben mirat potser més el segon que no pas el primer per tal d'implementar-ho en un futur pròxim/necessari''

# segona instancia d'ldap, pot ser remota o a la mateixa maquina virtual amb diferents ports.
# haproxy i configuració.
# configuració ldap-drupal per que apunte a haproxy.
# proves de replicació.
## Qué passa si una instancia te problemes?
## s'acumulen transaccions no realitzades?
# avaluar despres de les proves si ens interessa replicació en línia o simplement es sincronitzen les bdd del directori ppal cap a les instancies secundaries.

== Altres ==
Es pot demanar la sincronització del directori principal cap a d'altres instàncies remotes per millorar el temps de resposta. Al repositori esmentat es troben els scripts de sincronització.

LDAP/ca

2011-10-23T10:58:39Z

Rotobator: /* Altres */

{{en desenvolupament}}
{|align=left
|__TOC__
|}
== LDAP ==
=== Introducció ===
Les intencions: disposar d'una infraestructura que permeta autenticar una base única d'usuaris (drupal, wiki, trac, proxy federat...). Es tria LDAP per ser el backend més comú en el sentit que moltes eines (web i no web com ara radius) disposen de complements per autenticar/autoritzar els usuaris. En qualsevol cas,l'autenticació més segura passa per usar ssl a l'hora d'accedir a ldap, o mecanismes de desafiament resposta (només usables si al backend tenim la contrasenya en clar).

=== Càrrega d'usuaris ===
S'han desenvolupat uns scripts que poden exportar els usuaris d'un '''drupal 6''' o els '''usuaris dels proxys federats''' i importar-los cap a un openldap. Són scripts pensats per crear una rama de l'estil: <code>dc=guifi,dc=net</code>, encara que es pot configurar per qualsevol altre domini, i també afegir més ''domain components'' de forma que poguem crear rames de la principal i d'esta forma, obtindre una jerarquía d'ldaps, tal volta per oferir un punt únic d'autenticació i delegar-la cap al ldap que finalment puga autenticar-nos, a l'estil [http://www.google.es/url?sa=t&source=web&cd=1&sqi=2&ved=0CBwQFjAA&url=http%3A%2F%2Fwww.eduroam.es%2F&ei=rVDZTaDRAZDG8QPP9-iDBQ&usg=AFQjCNHHrBdRg0rHL7dx6lQvRJf0_EIpRQ d'EDUROAM].

Els scripts es troben al gitorius: <code>git clone https://git.gitorious.org/ldapusers/ldapusers.git</code>. Hi ha un ''Readme'' que explica com posar en marxa un directori a partir dels usuaris d'un drupal. Bàsicament, hem d'instal.lar: <code>apt-get install slapd ldap-utils db4.6-util # ó db4.7-util</code> i configurar <code>config.sh</code> amb les dades del directori i les dades d'accés a mySQL. Hi ha també uns exemples de configuració per al openLdap, pensats per a Fedora/Redhat, però l'adaptació a debian/ubuntu, és tan fàcil com canviar <code>/etc/openldap/</code> per <code>/etc/ldap</code> a totes les referències que hi hagin a <code>config.sh</code>.

Una vegada instal.lats, la càrrega es pot fer periòdicament, executant: <code>./ldif_from_hdb.sh drupal6</code>. Exemples de recerca:
* <code>ldapsearch -x -w PASSWORD -D "uid=webldap2011,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "uid=rotobator"</code>
* per comprovar que l'autenticació funciona podem fer bind amb un usuari: <code>ldapsearch -x -W -D "uid=rotobator,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(cn=rotobator)"</code>.

* recerca d'usuaris federats a la rama del proxy: <code>ldapsearch -x -w PASSWORD -D "uid=proxyldap2011,o=proxyusers,dc=guifi,dc=net" -b "o=proxyusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(&(uid=miquel.martos)(ou=2624))"</code>

=== Ús de ldap.guifi.net ===
En un principi, qualsevol màquina/servei, pot usar aquest directori per autenticar usuaris de guifi.net, però hi ha una sèrie de mesures de seguretat que cal tindre en compte:
* El directori no permet recuperar cap data personal ni d'altres persones, només permet autenticar usuaris.
* Només l'usuari ''cn=admin,o=webusers, dc=guifi,dc=net'' (per als usuaris importats des del drupal) o l'usuari ''cn=admin,o=proxyusers, dc=guifi,dc=net'' (per als usuaris dels proxys federats) poden obtindre les dades emmagatzemades, encara que este usuari està reservat per a ús intern i manteniment del directori.
* L'accés al directori només és posible mijançant ''LDAPS'', és a dir, usant TLS/SSL.

=== Configuració de clients ===
Exemples de configuracions. En general hem de configurar les llibreries client del sistema, per això hem de modificar l'arxiu '''/etc/ldap/ldap.conf''' a ubuntu o '''/etc/openldap/ldap.conf''' a fedora:
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
BASE dc=guifi,dc=net
URI ldaps://ldap.guifi.net/ ldaps://ldap2.guifi.net/
TLS_REQCERT never

</pre>
==== Proxy federat ====

==== LDAP al Mediawiki ====
*Instal.lació de la extensió d'LDAP per a mediawiki:
**Ubuntu:
sudo apt-get install mediawiki-extensions-ldapauth
sudo mwenext LdapAuthentication.php
**Altres vore http://www.mediawiki.org/wiki/Special:ExtensionDistributor/LdapAuthentication.

*Es passen les dades per omplir aquesta configuració. Simplement nom de domini i LDAPBaseDN. Per a <code>$wgLDAPEncryptionType</code> pot ser <code>"clear"</code> o <code>"ssl"</code>.
<pre>
## LDAP_Authentication
## http://www.mediawiki.org/wiki/Extension:LDAP_Authentication
## svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/LdapAuthentication/
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

//Nombres de los dominios que utilizarás.
$wgLDAPDomainNames = array("LDAP");

//Asociación entre nombre de dominio y nombre DNS de la máquina donde se va a validar.
$wgLDAPServerNames = array("LDAP"=>"ldap.guifi.net");

//Podemos permitir la convivencia de autenticación local del wiki con LDAP.
$wgLDAPUseLocal = true;

//Encriptación en las solicitudes LDAP.
$wgLDAPEncryptionType = array("LDAP"=>"ssl");

//Le decimos cual es la base de la consulta
$wgLDAPBaseDNs = array("LDAP"=>"o=webusers,dc=guifi,dc=net");
$wgLDAPSearchAttributes = array("LDAP"=>"uid");

//no usem les directives de grup de moment
$wgLDAPGroupsPrevail = array("LDAP"=>false);
$wgLDAPGroupNameAttribute = array("LDAP"=>"cn");

//facilitem el user DN
$wgLDAPSearchStrings = array(
"LDAP"=>"uid=USER-NAME,o=webusers,dc=guifi,dc=net"
);

</pre>

== Proves de balanceig/distribució ==
''Ben mirat potser més el segon que no pas el primer per tal d'implementar-ho en un futur pròxim/necessari''

# segona instancia d'ldap, pot ser remota o a la mateixa maquina virtual amb diferents ports.
# haproxy i configuració.
# configuració ldap-drupal per que apunte a haproxy.
# proves de replicació.
## Qué passa si una instancia te problemes?
## s'acumulen transaccions no realitzades?
# avaluar despres de les proves si ens interessa replicació en línia o simplement es sincronitzen les bdd del directori ppal cap a les instancies secundaries.

== Altres ==
Es pot demanar la sincronització del directori principal cap a d'altres instàncies remotes per millorar el temps de resposta. Al repositori esmentat es troben els scripts de sincronització.

LDAP/ca

2011-10-23T10:56:56Z

Rotobator: /* LDAP al Mediawiki */

{{en desenvolupament}}
{|align=left
|__TOC__
|}
== LDAP ==
=== Introducció ===
Les intencions: disposar d'una infraestructura que permeta autenticar una base única d'usuaris (drupal, wiki, trac, proxy federat...). Es tria LDAP per ser el backend més comú en el sentit que moltes eines (web i no web com ara radius) disposen de complements per autenticar/autoritzar els usuaris. En qualsevol cas,l'autenticació més segura passa per usar ssl a l'hora d'accedir a ldap, o mecanismes de desafiament resposta (només usables si al backend tenim la contrasenya en clar).

=== Càrrega d'usuaris ===
S'han desenvolupat uns scripts que poden exportar els usuaris d'un '''drupal 6''' o els '''usuaris dels proxys federats''' i importar-los cap a un openldap. Són scripts pensats per crear una rama de l'estil: <code>dc=guifi,dc=net</code>, encara que es pot configurar per qualsevol altre domini, i també afegir més ''domain components'' de forma que poguem crear rames de la principal i d'esta forma, obtindre una jerarquía d'ldaps, tal volta per oferir un punt únic d'autenticació i delegar-la cap al ldap que finalment puga autenticar-nos, a l'estil [http://www.google.es/url?sa=t&source=web&cd=1&sqi=2&ved=0CBwQFjAA&url=http%3A%2F%2Fwww.eduroam.es%2F&ei=rVDZTaDRAZDG8QPP9-iDBQ&usg=AFQjCNHHrBdRg0rHL7dx6lQvRJf0_EIpRQ d'EDUROAM].

Els scripts es troben al gitorius: <code>git clone https://git.gitorious.org/ldapusers/ldapusers.git</code>. Hi ha un ''Readme'' que explica com posar en marxa un directori a partir dels usuaris d'un drupal. Bàsicament, hem d'instal.lar: <code>apt-get install slapd ldap-utils db4.6-util # ó db4.7-util</code> i configurar <code>config.sh</code> amb les dades del directori i les dades d'accés a mySQL. Hi ha també uns exemples de configuració per al openLdap, pensats per a Fedora/Redhat, però l'adaptació a debian/ubuntu, és tan fàcil com canviar <code>/etc/openldap/</code> per <code>/etc/ldap</code> a totes les referències que hi hagin a <code>config.sh</code>.

Una vegada instal.lats, la càrrega es pot fer periòdicament, executant: <code>./ldif_from_hdb.sh drupal6</code>. Exemples de recerca:
* <code>ldapsearch -x -w PASSWORD -D "uid=webldap2011,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "uid=rotobator"</code>
* per comprovar que l'autenticació funciona podem fer bind amb un usuari: <code>ldapsearch -x -W -D "uid=rotobator,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(cn=rotobator)"</code>.

* recerca d'usuaris federats a la rama del proxy: <code>ldapsearch -x -w PASSWORD -D "uid=proxyldap2011,o=proxyusers,dc=guifi,dc=net" -b "o=proxyusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(&(uid=miquel.martos)(ou=2624))"</code>

=== Ús de ldap.guifi.net ===
En un principi, qualsevol màquina/servei, pot usar aquest directori per autenticar usuaris de guifi.net, però hi ha una sèrie de mesures de seguretat que cal tindre en compte:
* El directori no permet recuperar cap data personal ni d'altres persones, només permet autenticar usuaris.
* Només l'usuari ''cn=admin,o=webusers, dc=guifi,dc=net'' (per als usuaris importats des del drupal) o l'usuari ''cn=admin,o=proxyusers, dc=guifi,dc=net'' (per als usuaris dels proxys federats) poden obtindre les dades emmagatzemades, encara que este usuari està reservat per a ús intern i manteniment del directori.
* L'accés al directori només és posible mijançant ''LDAPS'', és a dir, usant TLS/SSL.

=== Configuració de clients ===
Exemples de configuracions. En general hem de configurar les llibreries client del sistema, per això hem de modificar l'arxiu '''/etc/ldap/ldap.conf''' a ubuntu o '''/etc/openldap/ldap.conf''' a fedora:
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
BASE dc=guifi,dc=net
URI ldaps://ldap.guifi.net/ ldaps://ldap2.guifi.net/
TLS_REQCERT never

</pre>
==== Proxy federat ====

==== LDAP al Mediawiki ====
*Instal.lació de la extensió d'LDAP per a mediawiki:
**Ubuntu:
sudo apt-get install mediawiki-extensions-ldapauth
sudo mwenext LdapAuthentication.php
**Altres vore http://www.mediawiki.org/wiki/Special:ExtensionDistributor/LdapAuthentication.

*Es passen les dades per omplir aquesta configuració. Simplement nom de domini i LDAPBaseDN. Per a <code>$wgLDAPEncryptionType</code> pot ser <code>"clear"</code> o <code>"ssl"</code>.
<pre>
## LDAP_Authentication
## http://www.mediawiki.org/wiki/Extension:LDAP_Authentication
## svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/LdapAuthentication/
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

//Nombres de los dominios que utilizarás.
$wgLDAPDomainNames = array("LDAP");

//Asociación entre nombre de dominio y nombre DNS de la máquina donde se va a validar.
$wgLDAPServerNames = array("LDAP"=>"ldap.guifi.net");

//Podemos permitir la convivencia de autenticación local del wiki con LDAP.
$wgLDAPUseLocal = true;

//Encriptación en las solicitudes LDAP.
$wgLDAPEncryptionType = array("LDAP"=>"ssl");

//Le decimos cual es la base de la consulta
$wgLDAPBaseDNs = array("LDAP"=>"o=webusers,dc=guifi,dc=net");
$wgLDAPSearchAttributes = array("LDAP"=>"uid");

//no usem les directives de grup de moment
$wgLDAPGroupsPrevail = array("LDAP"=>false);
$wgLDAPGroupNameAttribute = array("LDAP"=>"cn");

//facilitem el user DN
$wgLDAPSearchStrings = array(
"LDAP"=>"uid=USER-NAME,o=webusers,dc=guifi,dc=net"
);

</pre>

== Proves de balanceig/distribució ==
''Ben mirat potser més el segon que no pas el primer per tal d'implementar-ho en un futur pròxim/necessari''

# segona instancia d'ldap, pot ser remota o a la mateixa maquina virtual amb diferents ports.
# haproxy i configuració.
# configuració ldap-drupal per que apunte a haproxy.
# proves de replicació.
## Qué passa si una instancia te problemes?
## s'acumulen transaccions no realitzades?
# avaluar despres de les proves si ens interessa replicació en línia o simplement es sincronitzen les bdd del directori ppal cap a les instancies secundaries.

== Altres ==
Ldap per validar els usuaris dels proxys federats. Pròximament.

LDAP/ca

2011-10-23T10:55:30Z

Rotobator: /* Configuració de clients */

{{en desenvolupament}}
{|align=left
|__TOC__
|}
== LDAP ==
=== Introducció ===
Les intencions: disposar d'una infraestructura que permeta autenticar una base única d'usuaris (drupal, wiki, trac, proxy federat...). Es tria LDAP per ser el backend més comú en el sentit que moltes eines (web i no web com ara radius) disposen de complements per autenticar/autoritzar els usuaris. En qualsevol cas,l'autenticació més segura passa per usar ssl a l'hora d'accedir a ldap, o mecanismes de desafiament resposta (només usables si al backend tenim la contrasenya en clar).

=== Càrrega d'usuaris ===
S'han desenvolupat uns scripts que poden exportar els usuaris d'un '''drupal 6''' o els '''usuaris dels proxys federats''' i importar-los cap a un openldap. Són scripts pensats per crear una rama de l'estil: <code>dc=guifi,dc=net</code>, encara que es pot configurar per qualsevol altre domini, i també afegir més ''domain components'' de forma que poguem crear rames de la principal i d'esta forma, obtindre una jerarquía d'ldaps, tal volta per oferir un punt únic d'autenticació i delegar-la cap al ldap que finalment puga autenticar-nos, a l'estil [http://www.google.es/url?sa=t&source=web&cd=1&sqi=2&ved=0CBwQFjAA&url=http%3A%2F%2Fwww.eduroam.es%2F&ei=rVDZTaDRAZDG8QPP9-iDBQ&usg=AFQjCNHHrBdRg0rHL7dx6lQvRJf0_EIpRQ d'EDUROAM].

Els scripts es troben al gitorius: <code>git clone https://git.gitorious.org/ldapusers/ldapusers.git</code>. Hi ha un ''Readme'' que explica com posar en marxa un directori a partir dels usuaris d'un drupal. Bàsicament, hem d'instal.lar: <code>apt-get install slapd ldap-utils db4.6-util # ó db4.7-util</code> i configurar <code>config.sh</code> amb les dades del directori i les dades d'accés a mySQL. Hi ha també uns exemples de configuració per al openLdap, pensats per a Fedora/Redhat, però l'adaptació a debian/ubuntu, és tan fàcil com canviar <code>/etc/openldap/</code> per <code>/etc/ldap</code> a totes les referències que hi hagin a <code>config.sh</code>.

Una vegada instal.lats, la càrrega es pot fer periòdicament, executant: <code>./ldif_from_hdb.sh drupal6</code>. Exemples de recerca:
* <code>ldapsearch -x -w PASSWORD -D "uid=webldap2011,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "uid=rotobator"</code>
* per comprovar que l'autenticació funciona podem fer bind amb un usuari: <code>ldapsearch -x -W -D "uid=rotobator,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(cn=rotobator)"</code>.

* recerca d'usuaris federats a la rama del proxy: <code>ldapsearch -x -w PASSWORD -D "uid=proxyldap2011,o=proxyusers,dc=guifi,dc=net" -b "o=proxyusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(&(uid=miquel.martos)(ou=2624))"</code>

=== Ús de ldap.guifi.net ===
En un principi, qualsevol màquina/servei, pot usar aquest directori per autenticar usuaris de guifi.net, però hi ha una sèrie de mesures de seguretat que cal tindre en compte:
* El directori no permet recuperar cap data personal ni d'altres persones, només permet autenticar usuaris.
* Només l'usuari ''cn=admin,o=webusers, dc=guifi,dc=net'' (per als usuaris importats des del drupal) o l'usuari ''cn=admin,o=proxyusers, dc=guifi,dc=net'' (per als usuaris dels proxys federats) poden obtindre les dades emmagatzemades, encara que este usuari està reservat per a ús intern i manteniment del directori.
* L'accés al directori només és posible mijançant ''LDAPS'', és a dir, usant TLS/SSL.

=== Configuració de clients ===
Exemples de configuracions. En general hem de configurar les llibreries client del sistema, per això hem de modificar l'arxiu '''/etc/ldap/ldap.conf''' a ubuntu o '''/etc/openldap/ldap.conf''' a fedora:
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
BASE dc=guifi,dc=net
URI ldaps://ldap.guifi.net/ ldaps://ldap2.guifi.net/
TLS_REQCERT never

</pre>
==== Proxy federat ====

==== LDAP al Mediawiki ====
*Instal.lació de la extensió d'LDAP per a mediawiki:
**Ubuntu:
sudo apt-get install mediawiki-extensions-ldapauth
sudo mwenext LdapAuthentication.php
**Altres vore http://www.mediawiki.org/wiki/Special:ExtensionDistributor/LdapAuthentication.

*Es passen les dades per omplir aquesta configuració. Simplement nom de domini i LDAPBaseDN. Per a <code>$wgLDAPEncryptionType</code> pot ser <code>"clear"</code> o <code>"ssl"</code>.
<pre>
## LDAP_Authentication
## http://www.mediawiki.org/wiki/Extension:LDAP_Authentication
## svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/LdapAuthentication/
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

//Nombres de los dominios que utilizarás.
$wgLDAPDomainNames = array("LDAP");

//Asociación entre nombre de dominio y nombre DNS de la máquina donde se va a validar.
$wgLDAPServerNames = array("LDAP"=>"ldap.guifi.net");

//Podemos permitir la convivencia de autenticación local del wiki con LDAP.
$wgLDAPUseLocal = true;

//Encriptación en las solicitudes LDAP.
$wgLDAPEncryptionType = array("LDAP"=>"ssl");

//Le decimos cual es la base de la consulta
$wgLDAPBaseDNs = array("LDAP"=>"dc=guifi,dc=net");
$wgLDAPSearchAttributes = array("LDAP"=>"uid");

//no usem les directives de grup de moment
$wgLDAPGroupsPrevail = array("LDAP"=>false);
$wgLDAPGroupNameAttribute = array("LDAP"=>"cn");

//facilitem el user DN
$wgLDAPSearchStrings = array(
"LDAP"=>"uid=USER-NAME,dc=guifi,dc=net"
);

</pre>

== Proves de balanceig/distribució ==
''Ben mirat potser més el segon que no pas el primer per tal d'implementar-ho en un futur pròxim/necessari''

# segona instancia d'ldap, pot ser remota o a la mateixa maquina virtual amb diferents ports.
# haproxy i configuració.
# configuració ldap-drupal per que apunte a haproxy.
# proves de replicació.
## Qué passa si una instancia te problemes?
## s'acumulen transaccions no realitzades?
# avaluar despres de les proves si ens interessa replicació en línia o simplement es sincronitzen les bdd del directori ppal cap a les instancies secundaries.

== Altres ==
Ldap per validar els usuaris dels proxys federats. Pròximament.

LDAP/ca

2011-10-23T10:55:16Z

Rotobator: /* Configuració de clients */

{{en desenvolupament}}
{|align=left
|__TOC__
|}
== LDAP ==
=== Introducció ===
Les intencions: disposar d'una infraestructura que permeta autenticar una base única d'usuaris (drupal, wiki, trac, proxy federat...). Es tria LDAP per ser el backend més comú en el sentit que moltes eines (web i no web com ara radius) disposen de complements per autenticar/autoritzar els usuaris. En qualsevol cas,l'autenticació més segura passa per usar ssl a l'hora d'accedir a ldap, o mecanismes de desafiament resposta (només usables si al backend tenim la contrasenya en clar).

=== Càrrega d'usuaris ===
S'han desenvolupat uns scripts que poden exportar els usuaris d'un '''drupal 6''' o els '''usuaris dels proxys federats''' i importar-los cap a un openldap. Són scripts pensats per crear una rama de l'estil: <code>dc=guifi,dc=net</code>, encara que es pot configurar per qualsevol altre domini, i també afegir més ''domain components'' de forma que poguem crear rames de la principal i d'esta forma, obtindre una jerarquía d'ldaps, tal volta per oferir un punt únic d'autenticació i delegar-la cap al ldap que finalment puga autenticar-nos, a l'estil [http://www.google.es/url?sa=t&source=web&cd=1&sqi=2&ved=0CBwQFjAA&url=http%3A%2F%2Fwww.eduroam.es%2F&ei=rVDZTaDRAZDG8QPP9-iDBQ&usg=AFQjCNHHrBdRg0rHL7dx6lQvRJf0_EIpRQ d'EDUROAM].

Els scripts es troben al gitorius: <code>git clone https://git.gitorious.org/ldapusers/ldapusers.git</code>. Hi ha un ''Readme'' que explica com posar en marxa un directori a partir dels usuaris d'un drupal. Bàsicament, hem d'instal.lar: <code>apt-get install slapd ldap-utils db4.6-util # ó db4.7-util</code> i configurar <code>config.sh</code> amb les dades del directori i les dades d'accés a mySQL. Hi ha també uns exemples de configuració per al openLdap, pensats per a Fedora/Redhat, però l'adaptació a debian/ubuntu, és tan fàcil com canviar <code>/etc/openldap/</code> per <code>/etc/ldap</code> a totes les referències que hi hagin a <code>config.sh</code>.

Una vegada instal.lats, la càrrega es pot fer periòdicament, executant: <code>./ldif_from_hdb.sh drupal6</code>. Exemples de recerca:
* <code>ldapsearch -x -w PASSWORD -D "uid=webldap2011,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "uid=rotobator"</code>
* per comprovar que l'autenticació funciona podem fer bind amb un usuari: <code>ldapsearch -x -W -D "uid=rotobator,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(cn=rotobator)"</code>.

* recerca d'usuaris federats a la rama del proxy: <code>ldapsearch -x -w PASSWORD -D "uid=proxyldap2011,o=proxyusers,dc=guifi,dc=net" -b "o=proxyusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(&(uid=miquel.martos)(ou=2624))"</code>

=== Ús de ldap.guifi.net ===
En un principi, qualsevol màquina/servei, pot usar aquest directori per autenticar usuaris de guifi.net, però hi ha una sèrie de mesures de seguretat que cal tindre en compte:
* El directori no permet recuperar cap data personal ni d'altres persones, només permet autenticar usuaris.
* Només l'usuari ''cn=admin,o=webusers, dc=guifi,dc=net'' (per als usuaris importats des del drupal) o l'usuari ''cn=admin,o=proxyusers, dc=guifi,dc=net'' (per als usuaris dels proxys federats) poden obtindre les dades emmagatzemades, encara que este usuari està reservat per a ús intern i manteniment del directori.
* L'accés al directori només és posible mijançant ''LDAPS'', és a dir, usant TLS/SSL.

=== Configuració de clients ===
Exemples de configuracions. En general hem de configurar les llibreries client del sistema, per això hem de modificar l'arxiu '''/etc/ldap/ldap.conf''' a ubuntu o '''/etc/openldap/ldap.conf''' a fedora:
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
BASE dc=guifi,dc=net
URI ldaps://ldap.guifi.net/ ldaps://ldap2.guifi.net/
TLS_REQCERT never

</pre>
==== Proxy federat =====

==== LDAP al Mediawiki ====
*Instal.lació de la extensió d'LDAP per a mediawiki:
**Ubuntu:
sudo apt-get install mediawiki-extensions-ldapauth
sudo mwenext LdapAuthentication.php
**Altres vore http://www.mediawiki.org/wiki/Special:ExtensionDistributor/LdapAuthentication.

*Es passen les dades per omplir aquesta configuració. Simplement nom de domini i LDAPBaseDN. Per a <code>$wgLDAPEncryptionType</code> pot ser <code>"clear"</code> o <code>"ssl"</code>.
<pre>
## LDAP_Authentication
## http://www.mediawiki.org/wiki/Extension:LDAP_Authentication
## svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/LdapAuthentication/
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

//Nombres de los dominios que utilizarás.
$wgLDAPDomainNames = array("LDAP");

//Asociación entre nombre de dominio y nombre DNS de la máquina donde se va a validar.
$wgLDAPServerNames = array("LDAP"=>"ldap.guifi.net");

//Podemos permitir la convivencia de autenticación local del wiki con LDAP.
$wgLDAPUseLocal = true;

//Encriptación en las solicitudes LDAP.
$wgLDAPEncryptionType = array("LDAP"=>"ssl");

//Le decimos cual es la base de la consulta
$wgLDAPBaseDNs = array("LDAP"=>"dc=guifi,dc=net");
$wgLDAPSearchAttributes = array("LDAP"=>"uid");

//no usem les directives de grup de moment
$wgLDAPGroupsPrevail = array("LDAP"=>false);
$wgLDAPGroupNameAttribute = array("LDAP"=>"cn");

//facilitem el user DN
$wgLDAPSearchStrings = array(
"LDAP"=>"uid=USER-NAME,dc=guifi,dc=net"
);

</pre>

== Proves de balanceig/distribució ==
''Ben mirat potser més el segon que no pas el primer per tal d'implementar-ho en un futur pròxim/necessari''

# segona instancia d'ldap, pot ser remota o a la mateixa maquina virtual amb diferents ports.
# haproxy i configuració.
# configuració ldap-drupal per que apunte a haproxy.
# proves de replicació.
## Qué passa si una instancia te problemes?
## s'acumulen transaccions no realitzades?
# avaluar despres de les proves si ens interessa replicació en línia o simplement es sincronitzen les bdd del directori ppal cap a les instancies secundaries.

== Altres ==
Ldap per validar els usuaris dels proxys federats. Pròximament.

LDAP/ca

2011-10-23T10:54:26Z

Rotobator: /* Ús de ldap.guifi.net */

{{en desenvolupament}}
{|align=left
|__TOC__
|}
== LDAP ==
=== Introducció ===
Les intencions: disposar d'una infraestructura que permeta autenticar una base única d'usuaris (drupal, wiki, trac, proxy federat...). Es tria LDAP per ser el backend més comú en el sentit que moltes eines (web i no web com ara radius) disposen de complements per autenticar/autoritzar els usuaris. En qualsevol cas,l'autenticació més segura passa per usar ssl a l'hora d'accedir a ldap, o mecanismes de desafiament resposta (només usables si al backend tenim la contrasenya en clar).

=== Càrrega d'usuaris ===
S'han desenvolupat uns scripts que poden exportar els usuaris d'un '''drupal 6''' o els '''usuaris dels proxys federats''' i importar-los cap a un openldap. Són scripts pensats per crear una rama de l'estil: <code>dc=guifi,dc=net</code>, encara que es pot configurar per qualsevol altre domini, i també afegir més ''domain components'' de forma que poguem crear rames de la principal i d'esta forma, obtindre una jerarquía d'ldaps, tal volta per oferir un punt únic d'autenticació i delegar-la cap al ldap que finalment puga autenticar-nos, a l'estil [http://www.google.es/url?sa=t&source=web&cd=1&sqi=2&ved=0CBwQFjAA&url=http%3A%2F%2Fwww.eduroam.es%2F&ei=rVDZTaDRAZDG8QPP9-iDBQ&usg=AFQjCNHHrBdRg0rHL7dx6lQvRJf0_EIpRQ d'EDUROAM].

Els scripts es troben al gitorius: <code>git clone https://git.gitorious.org/ldapusers/ldapusers.git</code>. Hi ha un ''Readme'' que explica com posar en marxa un directori a partir dels usuaris d'un drupal. Bàsicament, hem d'instal.lar: <code>apt-get install slapd ldap-utils db4.6-util # ó db4.7-util</code> i configurar <code>config.sh</code> amb les dades del directori i les dades d'accés a mySQL. Hi ha també uns exemples de configuració per al openLdap, pensats per a Fedora/Redhat, però l'adaptació a debian/ubuntu, és tan fàcil com canviar <code>/etc/openldap/</code> per <code>/etc/ldap</code> a totes les referències que hi hagin a <code>config.sh</code>.

Una vegada instal.lats, la càrrega es pot fer periòdicament, executant: <code>./ldif_from_hdb.sh drupal6</code>. Exemples de recerca:
* <code>ldapsearch -x -w PASSWORD -D "uid=webldap2011,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "uid=rotobator"</code>
* per comprovar que l'autenticació funciona podem fer bind amb un usuari: <code>ldapsearch -x -W -D "uid=rotobator,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(cn=rotobator)"</code>.

* recerca d'usuaris federats a la rama del proxy: <code>ldapsearch -x -w PASSWORD -D "uid=proxyldap2011,o=proxyusers,dc=guifi,dc=net" -b "o=proxyusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(&(uid=miquel.martos)(ou=2624))"</code>

=== Ús de ldap.guifi.net ===
En un principi, qualsevol màquina/servei, pot usar aquest directori per autenticar usuaris de guifi.net, però hi ha una sèrie de mesures de seguretat que cal tindre en compte:
* El directori no permet recuperar cap data personal ni d'altres persones, només permet autenticar usuaris.
* Només l'usuari ''cn=admin,o=webusers, dc=guifi,dc=net'' (per als usuaris importats des del drupal) o l'usuari ''cn=admin,o=proxyusers, dc=guifi,dc=net'' (per als usuaris dels proxys federats) poden obtindre les dades emmagatzemades, encara que este usuari està reservat per a ús intern i manteniment del directori.
* L'accés al directori només és posible mijançant ''LDAPS'', és a dir, usant TLS/SSL.

=== Configuració de clients ===
Exemples de configuracions. En general hem de configurar les llibreries client del sistema, per això hem de modificar l'arxiu '''/etc/ldap/ldap.conf''' a ubuntu o '''/etc/openldap/ldap.conf''' a fedora:
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
BASE dc=guifi,dc=net
URI ldaps://ldap.guifi.net/
TLS_REQCERT never

</pre>

==== LDAP al Mediawiki ====
*Instal.lació de la extensió d'LDAP per a mediawiki:
**Ubuntu:
sudo apt-get install mediawiki-extensions-ldapauth
sudo mwenext LdapAuthentication.php
**Altres vore http://www.mediawiki.org/wiki/Special:ExtensionDistributor/LdapAuthentication.

*Es passen les dades per omplir aquesta configuració. Simplement nom de domini i LDAPBaseDN. Per a <code>$wgLDAPEncryptionType</code> pot ser <code>"clear"</code> o <code>"ssl"</code>.
<pre>
## LDAP_Authentication
## http://www.mediawiki.org/wiki/Extension:LDAP_Authentication
## svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/LdapAuthentication/
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

//Nombres de los dominios que utilizarás.
$wgLDAPDomainNames = array("LDAP");

//Asociación entre nombre de dominio y nombre DNS de la máquina donde se va a validar.
$wgLDAPServerNames = array("LDAP"=>"ldap.guifi.net");

//Podemos permitir la convivencia de autenticación local del wiki con LDAP.
$wgLDAPUseLocal = true;

//Encriptación en las solicitudes LDAP.
$wgLDAPEncryptionType = array("LDAP"=>"ssl");

//Le decimos cual es la base de la consulta
$wgLDAPBaseDNs = array("LDAP"=>"dc=guifi,dc=net");
$wgLDAPSearchAttributes = array("LDAP"=>"uid");

//no usem les directives de grup de moment
$wgLDAPGroupsPrevail = array("LDAP"=>false);
$wgLDAPGroupNameAttribute = array("LDAP"=>"cn");

//facilitem el user DN
$wgLDAPSearchStrings = array(
"LDAP"=>"uid=USER-NAME,dc=guifi,dc=net"
);

</pre>

== Proves de balanceig/distribució ==
''Ben mirat potser més el segon que no pas el primer per tal d'implementar-ho en un futur pròxim/necessari''

# segona instancia d'ldap, pot ser remota o a la mateixa maquina virtual amb diferents ports.
# haproxy i configuració.
# configuració ldap-drupal per que apunte a haproxy.
# proves de replicació.
## Qué passa si una instancia te problemes?
## s'acumulen transaccions no realitzades?
# avaluar despres de les proves si ens interessa replicació en línia o simplement es sincronitzen les bdd del directori ppal cap a les instancies secundaries.

== Altres ==
Ldap per validar els usuaris dels proxys federats. Pròximament.

LDAP/ca

2011-10-23T10:49:38Z

Rotobator: /* Càrrega d'usuaris */

{{en desenvolupament}}
{|align=left
|__TOC__
|}
== LDAP ==
=== Introducció ===
Les intencions: disposar d'una infraestructura que permeta autenticar una base única d'usuaris (drupal, wiki, trac, proxy federat...). Es tria LDAP per ser el backend més comú en el sentit que moltes eines (web i no web com ara radius) disposen de complements per autenticar/autoritzar els usuaris. En qualsevol cas,l'autenticació més segura passa per usar ssl a l'hora d'accedir a ldap, o mecanismes de desafiament resposta (només usables si al backend tenim la contrasenya en clar).

=== Càrrega d'usuaris ===
S'han desenvolupat uns scripts que poden exportar els usuaris d'un '''drupal 6''' o els '''usuaris dels proxys federats''' i importar-los cap a un openldap. Són scripts pensats per crear una rama de l'estil: <code>dc=guifi,dc=net</code>, encara que es pot configurar per qualsevol altre domini, i també afegir més ''domain components'' de forma que poguem crear rames de la principal i d'esta forma, obtindre una jerarquía d'ldaps, tal volta per oferir un punt únic d'autenticació i delegar-la cap al ldap que finalment puga autenticar-nos, a l'estil [http://www.google.es/url?sa=t&source=web&cd=1&sqi=2&ved=0CBwQFjAA&url=http%3A%2F%2Fwww.eduroam.es%2F&ei=rVDZTaDRAZDG8QPP9-iDBQ&usg=AFQjCNHHrBdRg0rHL7dx6lQvRJf0_EIpRQ d'EDUROAM].

Els scripts es troben al gitorius: <code>git clone https://git.gitorious.org/ldapusers/ldapusers.git</code>. Hi ha un ''Readme'' que explica com posar en marxa un directori a partir dels usuaris d'un drupal. Bàsicament, hem d'instal.lar: <code>apt-get install slapd ldap-utils db4.6-util # ó db4.7-util</code> i configurar <code>config.sh</code> amb les dades del directori i les dades d'accés a mySQL. Hi ha també uns exemples de configuració per al openLdap, pensats per a Fedora/Redhat, però l'adaptació a debian/ubuntu, és tan fàcil com canviar <code>/etc/openldap/</code> per <code>/etc/ldap</code> a totes les referències que hi hagin a <code>config.sh</code>.

Una vegada instal.lats, la càrrega es pot fer periòdicament, executant: <code>./ldif_from_hdb.sh drupal6</code>. Exemples de recerca:
* <code>ldapsearch -x -w PASSWORD -D "uid=webldap2011,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "uid=rotobator"</code>
* per comprovar que l'autenticació funciona podem fer bind amb un usuari: <code>ldapsearch -x -W -D "uid=rotobator,o=webusers,dc=guifi,dc=net" -b "o=webusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(cn=rotobator)"</code>.

* recerca d'usuaris federats a la rama del proxy: <code>ldapsearch -x -w PASSWORD -D "uid=proxyldap2011,o=proxyusers,dc=guifi,dc=net" -b "o=proxyusers,dc=guifi,dc=net" -H ldaps://ldap.guifi.net/ "(&(uid=miquel.martos)(ou=2624))"</code>

=== Ús de ldap.guifi.net ===
En un principi, qualsevol màquina/servei, pot usar aquest directori per autenticar usuaris de guifi.net, però hi ha una sèrie de mesures de seguretat que cal tindre en compte:
* El directori no permet recuperar cap data personal ni d'altres persones, només permet autenticar usuaris.
* Només l'usuari ''cn=admin,dc=guifi,dc=net'' pot obtindre les dades emmagatzemades, encara que este usuari està reservat per a ús intern i manteniment del directori.
* Cada màquina/servei que necessite autenticar usuaris contra aquest directori, haurà de disposar d'un certificat de servidor x509, vàlid i acceptat explícitament pels administradors del directori. Hi ha empresses que oferixen gratuitament aquests certificats.
* L'accés al directori només és posible mijançant ''LDAPS'', és a dir, usant TLS/SSL.

=== Configuració de clients ===
Exemples de configuracions. En general hem de configurar les llibreries client del sistema, per això hem de modificar l'arxiu '''/etc/ldap/ldap.conf''' a ubuntu o '''/etc/openldap/ldap.conf''' a fedora:
<pre>
#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#SIZELIMIT 12
#TIMELIMIT 15
#DEREF never
BASE dc=guifi,dc=net
URI ldaps://ldap.guifi.net/
TLS_REQCERT never

</pre>

==== LDAP al Mediawiki ====
*Instal.lació de la extensió d'LDAP per a mediawiki:
**Ubuntu:
sudo apt-get install mediawiki-extensions-ldapauth
sudo mwenext LdapAuthentication.php
**Altres vore http://www.mediawiki.org/wiki/Special:ExtensionDistributor/LdapAuthentication.

*Es passen les dades per omplir aquesta configuració. Simplement nom de domini i LDAPBaseDN. Per a <code>$wgLDAPEncryptionType</code> pot ser <code>"clear"</code> o <code>"ssl"</code>.
<pre>
## LDAP_Authentication
## http://www.mediawiki.org/wiki/Extension:LDAP_Authentication
## svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/LdapAuthentication/
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

//Nombres de los dominios que utilizarás.
$wgLDAPDomainNames = array("LDAP");

//Asociación entre nombre de dominio y nombre DNS de la máquina donde se va a validar.
$wgLDAPServerNames = array("LDAP"=>"ldap.guifi.net");

//Podemos permitir la convivencia de autenticación local del wiki con LDAP.
$wgLDAPUseLocal = true;

//Encriptación en las solicitudes LDAP.
$wgLDAPEncryptionType = array("LDAP"=>"ssl");

//Le decimos cual es la base de la consulta
$wgLDAPBaseDNs = array("LDAP"=>"dc=guifi,dc=net");
$wgLDAPSearchAttributes = array("LDAP"=>"uid");

//no usem les directives de grup de moment
$wgLDAPGroupsPrevail = array("LDAP"=>false);
$wgLDAPGroupNameAttribute = array("LDAP"=>"cn");

//facilitem el user DN
$wgLDAPSearchStrings = array(
"LDAP"=>"uid=USER-NAME,dc=guifi,dc=net"
);

</pre>

== Proves de balanceig/distribució ==
''Ben mirat potser més el segon que no pas el primer per tal d'implementar-ho en un futur pròxim/necessari''

# segona instancia d'ldap, pot ser remota o a la mateixa maquina virtual amb diferents ports.
# haproxy i configuració.
# configuració ldap-drupal per que apunte a haproxy.
# proves de replicació.
## Qué passa si una instancia te problemes?
## s'acumulen transaccions no realitzades?
# avaluar despres de les proves si ens interessa replicació en línia o simplement es sincronitzen les bdd del directori ppal cap a les instancies secundaries.

== Altres ==
Ldap per validar els usuaris dels proxys federats. Pròximament.

LDAP/ca

2011-10-23T10:43:32Z

Rotobator: /* Càrrega d'usuaris */

Ubiquity Nanostation

2011-07-21T19:05:06Z

Rotobator: /* Imatges amb modificacions */

=Nanostation 2=

*Freqüència: 2.4Ghz
*Guany: 10dBi
*Distàncies: Fins a 15Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Nanostation loco 2==

Pensada per a distàncies menors, és més barata i petita:

*Freqüència: 2.4Ghz
*Guany: 8dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Documentació oficial==

*[http://www.ubnt.com/downloads/ns2_datasheet.pdf NS2 Datasheet]
*[http://www.ubnt.com/support/ns2.php NS2 Pàgina de suport]
*[http://www.ubnt.com/downloads/loco2_datasheet.pdf NSloco2 Datasheet]
*[http://www.ubnt.com/products/loco.php NSloco Pàgina de suport]

==Paràmetres de fabrica==

Tal i com posa a la caixa:

*'''IP''': 192.168.1.20
*'''Màscara''': 255.255.255.0
*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

==Com connectar-s'hi?==

Amb Linux, podeu utilitzar [[IP Aliasing]] per a connectar-vos a la nanostation sense perdre la vostra connexió a Internet. A una terminal, escriviu:

$ sudo ifconfig eth0:1 192.168.1.25 netmask 255.255.255.0 up

'''NOTA''': Si la vostra xarxa ja és la 192.168.1.x no cal que feu cap d'aquests passos i us hi podeu connectar directament. Vigileu que no tingueu la
mala sort de ja tenir una màquina amb la IP 192.168.1.20 a la vostra xarxa

Hem escollir la IP 192.168.1.25 perquè és una de les IP lliures de la xarxa lògica on està connectada la nanostation. Amb:

$ ipcalc 192.168.1.20/255.255.255.0
Address: 192.168.1.20 11000000.10101000.00000001. 00010100
Netmask: 255.255.255.0 = 24 11111111.11111111.11111111. 00000000
Wildcard: 0.0.0.255 00000000.00000000.00000000. 11111111
=>
Network: 192.168.1.0/24 11000000.10101000.00000001. 00000000
'''HostMin''': 192.168.1.1 11000000.10101000.00000001. 00000001
'''HostMax''': 192.168.1.254 11000000.10101000.00000001. 11111110
Broadcast: 192.168.1.255 11000000.10101000.00000001. 11111111
Hosts/Net: 254 Class C, Private Internet

Podeu obtenir la informació de la xarxa. Qualsevol valor entre HostMin i HostMax que no estigui sent utilitzat (per exemple no podeu utilitzar la IP de la nanostation 192.168.1.20) és un valor vàlid.

Comproveu que la interfície s'ha creat correctament:

$ ifconfig eth0:1
eth0:1 Link encap:Ethernet HWaddr 00:30:05:eb:a3:8d
inet addr:192.168.1.25 Bcast:192.168.1.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
Interrupt:20 Base address:0xa000

I feu un ping a la nanostation per veure si contesta:

$ ping 192.168.1.20
PING 192.168.1.20 (192.168.1.20) 56(84) bytes of data.
64 bytes from 192.168.1.20: icmp_seq=1 ttl=64 time=2.41 ms
...

Ara ja podeu connectar-vos amb el vostre navegador posant a la URL:

http://192.168.1.20

[[Imatge:Nanostation1.jpg|center]]

La paraula de pas i l'usuari són:

*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

===Resolució de problemes en la connexió===

Comproveu que s'ha creat la interfície virtual amb

$ ifconfig eth0:1

Potser la vostra interfície de xarxa no és la eth0?

Comproveu que s'ha creat una ruta que us permeti connectar al dispositiu:

$ route -n
Kernel IP routing table
Destination Gateway Genmask Flags Metric Ref Use Iface
'''192.168.1.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0'''
192.168.12.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0
169.254.0.0 0.0.0.0 255.255.0.0 U 1000 0 0 eth0
0.0.0.0 192.168.12.1 0.0.0.0 UG 100 0 0 eth0

També podeu provar si la URL funciona correctament amb:

$ wget http://192.168.1.20

O fer un escànner de ports amb:

$ sudo nmap 192.168.1.20

Starting Nmap 4.53 ( http://insecure.org ) at 2009-02-25 16:56 CET
Interesting ports on 192.168.1.20:
Not shown: 1712 closed ports
PORT STATE SERVICE
23/tcp open telnet
80/tcp open http
MAC Address: 00:15:6D:AD:70:EE (Ubiquiti Networks)

Com podeu veure també es possible accedir al dispositiu amb Telnet (només si ho heu activat des de la web de nanostation)

'''NOTA''': Qualsevol comanda que no tingueu (com nmap o ipcalc) la podeu instal·lar amb:

$ sudo apt-get install comanda_que_teniu

=Nanostation 5=

*Freqüència: 5Ghz
*Guany: 8dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Nanostation loco 5==

Pensada per a distàncies menors, és més barata i petita:

*Freqüència: 5Ghz
*Guany: 13dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 6Mbps a 54mbps segons la distància

==Documentació oficial==

*http://www.ubnt.com/products/nano.php
*[http://www.ubnt.com/downloads/ns5_datasheet.pdf NS5 datasheet]
*[http://www.ubnt.com/downloads/loco5_datasheet.pdf NSloco5 datasheet]
*[http://www.ubnt.com/products/loco.php NSloco Pàgina de suport]

= Nanostation Mimo (M)=

<blockquote>
Les Mimo son Airmax, es a dir porten el firmware Airos 5.2, molt mes
avançat, suporten WDS (ho he provat), tenen mes potencia d'emissio, i son
mes mones....

A mes pensem que el suport a noves versions es per Airos 5.2, mentres que
les versions antigues es deixara de donar suport segurament.

A mes les Airmax tenen suport per protocol N, es a dir millor velocitat
(ample de banda), basicament crec que aquestes son les diferencies mes
significatives.

</blockquote>

:*http://www.mail-archive.com/guifi-usuaris@llistes.projectes.lafarga.org/msg10719.html

=Configuració per a guifi.net=

Primer cal afegir un node a la web de [http://www.guifi.net guifi.net]. Consulteu l'article [[Exemple_pas_a_pas_de_muntatge_d'un_node_a_l'IES_Nicolau_Copèrnic]] per conèixer els detalls.

== Configuració de la nanostation amb unsolclic ==

Un cop tenim el node, els trastos i la radio i els enllaços creats, podem obtenir la configuració d'unsolclic. Trobareu una opció de menú al vostre node

Per exemple:

http://guifi.net/guifi/device/13636/view/unsolclic

Ha de ser quelcom similar a:

# Generat per a:
# AirOsv30

Click here to download configuration file for: TRSCEIPMariaGaliRd1
Put the mouse cursor over the link. Right click the link and select "Save Link/Target As..." to save to your Desktop.

# Configuration for AirOs> Unsolclic version:1.0.2 !! WARNING: Beta version !!
# Device: TRSCEIPMariaGaliRd1
#
# Methods to upload/execute the file:
# 1.- As a file. Upload this through web managment:
# a.System->Configuratuion Managment->Locate file
# b.Upload
# 2.- Telnet: Open a terminal session, create new /tmp/system.cfg file and cut&paste
# the contents of the file. Save it an execute the command:
#
# /usr/etc/rc.d/rc.softrestart save
#
# Notes:
# -Web access method is recommended
# (the script reconfigures some IP addresses, so communication can be lost.
# 192.168.1.1 will be the new one)
# -Changes are done in user passwords on the device, default user and password are
# changed to root/guifi.
# -The ACK is set to 45 for 802.11b mode, and to 25 for 802.11a (600 meters aprox,)
#
## Link to AP info
Ap SSID = guifi.net-TRSACprncRd1AP0
WAN Ip address = 10.139.60.34
WAN Netmask = 255.255.255.224
WAN Gateway = 10.139.60.33
Primary DNS Server = 10.139.7.162
Secondary DNS Server =
Device HostName = TRSCEIPMariaGaliRd1
IEEE 802.11 Mode: = B Only (2,4Ghz 11MB)

Tal i com es comenta teniu dos opcions per aplicar aquesta configuració. Per la web de la nanostation o per Telnet.

'''Configuració per la web'''

Primer de tot us heu de connectar al dispositiu. Els valors per defecte o de fàbrica de la nanostation són:

*'''IP''': 192.168.1.20
*'''Màscara''': 255.255.255.0
*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

Podeu utilitzar [[IP Aliasing]] per connectar-vos al dispositiu. Per exemple:

$ sudo ifconfig eth0:1 192.168.1.19 netmask 255.255.255.0 up

'''NOTA''': En aquest exemple suposem que la vostra interfície de xarxa és la eth0. Si no és així modifiqueu aquest valor per adaptar-lo al vostre cas.

Aneu a l'apartat:

System->Configuration Management

[[Imatge:NanostationGuifi.png|center]]
...
[[Imatge:NanostationGuifi1.png|center]]

I utilitzeu el boto '''Navega''' per localitzar el fitxer de configuració que voleu aplicar. El fitxer de configuració el trobareu a l'enllaç on posa:

'''Click here to download configuration file for''':

El podeu descarregar amb [[wget]]:

$ wget http://guifi.net/files/nanostation/TRSCEIPMariaGaliRd1.cfg

'''IMPORTANT''': En el cas de les nanostation el fitxer que cal aplicar és el '''.cfg'''!!!

Un cop heu indicat el fitxer feu clic a '''Upload'''. Per aplicar els canvis heu d'estar atents al missatge que sortira a la part superior de la pàgina web. Feu clic a '''Apply''' i espereu una estona a que s'apliquin els canvis:

[[Imatge:Nanostation4.jpg|center]]

'''NOTA IMPORTANT''': Tingueu en compte que aquesta IP és una IP molt comuna i que és molt possible que el vostre gateway tingui
la mateixa IP. Si voleu evitar problemes, canvieu aquesta adreça abans d'aplicar unsolclic al dispositiu.

Al aplicar un solclic, l'usuari i la paraula de pas passen a ser:

*'''Usuari''': root
*'''Paraula de pas''': guifi

També pot ser que la IP hagi canviat a '''192.168.1.1'''.

Consulteu també el document:

http://guifi.net/files/Manual_unsoclick_Nanostation.pdf

Per veure un pas a pas amb exemples de com pujar la configuració de guifi.net a una nanostation.

'''Configuració per Telnet'''

Connecteu-vos via Telnet:

$ telnet 192.168.1.20

Poseu l'usuari i paraula de pas de fàbrica del dispositiu (ubnt, ubnt). Un cop dins del dispositiu creeu el fitxer:

$ vi /tmp/system.cfg

I enganxeu el text d'un solclic. Un cop salveu el fitxer executeu:

$ /usr/etc/rc.d/rc.softrestart save

'''Recursos''':
*http://guifi.net/files/Manual_unsoclick_Nanostation.pdf

=Manual=

*http://wiki.ubnt.com/wiki/index.php/AirOS

= Protocol CDP =

[http://es.wikipedia.org/wiki/CDP Cisco Discovery Protocol].

$ sudo tcpdump
10:41:58.132091 CDPv1, ttl: 120s, Device-ID 'TRSCEIPMariaGaliRd1'[|cdp]
10:41:58.135969 CDPv1, ttl: 120s, Device-ID 'TRSCEIPMariaGaliRd1'[|cdp]
10:42:06.618809 IP 10.139.60.33 > 224.0.0.5: OSPFv2, Hello, length: 44

= Recuperació del firmware original =

Aquesta secció us explica com recuperar el [[firmware]] original de la Nanostation, per exemple després d'haver posat un firware especific com [[DD-WRT]] o [[openwrt]].

El primer que us caldrà és una copia del firmware. Podeu saber quina versió del firmware teniu (o consultar en un altre nanostation si la vostra no té firmware) a l'apartat sistema de la nanostation (per exemple per una nano amb IP 192.168.1.101):

https://192.168.1.101/system.cgi

Veureu quelcom similar a:

XS2.ar2316.v3.5.4476.091013.1749

{{nota| En aquesta mateixa secció podríeu fer un upgrade/actualització de l'antena}}

Per obtenir una còpia del firmware original aneu a:

http://www.ubnt.com/support/downloads

Escolliu:

IEEE/802.11a/b/gSolutions, Nanostation 2 (o el model que busqueu)

I us baixeu l'última versió, actualment (--[[Usuari:Sergi|acacha]] 16:07, 12 oct 2010 (UTC)) la 3.5.1:

$ [[wget]] http://www.ubnt.com/downloads/NanoStation2-v3.5.1.build4631.bin

A més podeu comprovar la suma md5 ([[md5]]) amb:

$ [[md5sum]] NanoStation2-v3.5.1.build4631.bin
7e42fc6338356ec488f92c5d9b3d065c NanoStation2-v3.5.1.build4631.bin

Ha de coincidir amb la que posi a la web.

Ara connecteu la nanostation al POE per tal d'encendre-la i també a la vostra LAN. Un cop la tingueu preparada trèieu l'alimentació i premeu el botó de reset, manteniu-lo premut mentrestant torneu a connectar l'alimentació, si manteniu premut més de 8 segons la Nanostation començarà a parpadejar de forma intermitent els LEDS de cobertura (primers els 2 i el 4 i després el 1 i el 3).

Si ja teniu l'ordinador des de el que us volue connectar a la xarxa 192.168.1.0/24 només us cal comprovar que podeu fer un ping a la nano:

$ [[ping]] 192.168.1.20

Sinó podeu utilitzar [[IP Aliasing]]:

$ [[sudo]] [[ifconfig]] eth0:1 192.168.1.254

Ara necessiteu un client de [[FTP]] com [[tftp]] (Trivial FTP):

$ sudo [[apt-get]] install tftp

I pugeu el firmware:

$tftp 192.168.1.20
tftp> bin
tftp> trace
tftp> put XS2.ar2316.v3.4-rc.4351.090504.2146.bin
...
...
Sent 1965199 bytes in 35.2 seconds
tftp> quit

Durant el upload del firware s'aturaran de parpallejar els LEDS, anirant fent canvis. Cal deixar que els LEDS vagin canviant de un a un cada color durant uns 7-10 minuts depenent del dispositiu.

{{important|No atureu la corrent durant el procés d'actualització}}

Quan acabi només quedaran encesos els LEDS PWR i LAN i podeu accedir a la nanostation amb la [[Nanostation#Par.C3.A0metres_de_fabrica|configuració de fabrica]].

:*http://www.ubnt.com/wiki/Firmware_Recovery
:*http://www.ubnt.com/wiki/Recuperar_firmware

= Construcció de firmware =
Ubiquity posa a disposició pública l'SDK per tal que pugam reconstruir una imatge després d'haver fet canvis, com ara afegir serveis, eliminar mòduls que no s'usen per tal de que el catxarro siga més eficient o simplement modificar el programari per defecte.

A la web oficial es pot baixar l'SDK corresponent a la versió del nostre catxarro: http://ubnt.com/support/downloads.

{{nota| a la secció [[Firmware recovery]] trobareu com restaurar un catxarro que no arranca amb una firmware customitzat}}

== Exemple de reconstrucció del firmware ==

=== AirMax ISP Solutions ===
Es correspon amb la sèrie més moderna dels productes de Ubiquity. Veurem com podem afegir ''openvpn'' a la nostra antena, el mateix o molt paregut procediment seguirem per afegir ''quagga'' o d'altres.

Hi ha dos mètodes per generar una imatge:
<ol>
<li> Seguir les instruccions del fabricant, que diu, una vegada descomprimit el paquet a ''readme.txt'':
<pre>
Step by step instructions
-------------------------

1. Extract files

$ tar xjvf SDK.UBNT.v5.3.tar.bz2

2. Build

$ cd SDK.UBNT.v5.3/openwrt
$ make

3. Look for firmware file (with prefix XM) in openwrt/bin/.

Good luck!
</pre>
Amb la versió 5.3 no hem pogut generar una imatge vàlida, donat que li falta el ''bootloader u-boot'', tal com veurem al desmuntar una imatge de fàbrica al següent mètode. Per este motiu ens dessitgen ''Good luck''.</li>
<li>
A partir d'una imatge oficial. En este cas, haurem de seguir els pasos anteriors amb la intenció d'obtindre les eines que ens ajudaran a modificar una imatge, i que són: ''fwsplit'', ''unsquashfs'', ''mksquashfs'' i ''mkfwimage''. És important usar estes eines enlloc de les que podrem trobar en les nostres distros de linux donat que, per exemple, el ''mksquashfs'' disposa d'una opció per escollir l'endiannicitat (Big Endian en el cas d'ubiquity, a banda d'altres característiques) del sistema d'arxius, i que no es troba en altres versions.
<ul>
<li>Una vegada compilat un firmware amb el SDK disposem de les eines bàsiques:
<pre>
SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/fwsplit
SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/mksquashfs
SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/unsquashfs
SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/ubnt-mkfwimage
</pre>
</li>
<li>Sobre el firmware original, desmuntem l'imatge:
<pre>$ SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/fwsplit XM-v5.3.2.build8909.bin
Firmware file: 'XM-v5.3.2.build8909.bin'
Firmware version: 'XM.ar7240.v5.3.2.8909.110429.1745'
Creating descriptor file:
XM.ar7240.v5.3.2.8909.110429.1745.txt
Creating partition data files:
XM.ar7240.v5.3.2.8909.110429.1745.u-boot
XM.ar7240.v5.3.2.8909.110429.1745.kernel
XM.ar7240.v5.3.2.8909.110429.1745.rootfs
</pre>
Tenim 4 arxius addicionals: la descripció (XM.ar7240.v5.3.2.8909.110429.1745.txt), el bootloader (XM.ar7240.v5.3.2.8909.110429.1745.u-boot), el nucli (XM.ar7240.v5.3.2.8909.110429.1745.kernel) i el sistema d'arxius (XM.ar7240.v5.3.2.8909.110429.1745.rootfs) comprimit amb format squashfs i ordenació big endian.
És justament el bootloader el que no es troba a l'imatge generada al seguir els passos del fabricant.
</li>
<li>Descomprimim el sistema d'arxius:
<pre>
$ SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/unsquashfs XM.ar7240.v5.3.2.8909.110429.1745.rootfs
Reading a different endian SQUASHFS filesystem on XM.ar7240.v5.3.2.8909.110429.1745.rootfs

created 838 files
created 59 directories
created 222 symlinks
created 0 devices
created 0 fifos
</pre>
Al directori ''squashfs-root'' ja tenim tot el sistema d'arxius de manera que ja podem furgar-lo un poc. En este cas volem afegir suport per a ''openvpn''. Aquest paquet te dependències de la llibreria de compressió en temps real ''lzo''. En este cas ens resultarà fàcil afegir aquest client/dimoni, donat que ja esta inclós a l'SDK, en altres casos haurem d'adaptar el programari a aquesta distribució d'openwrt en què es basa el firmware d'ubiquity (a la sèrie M5).
</li>
<li> Compilem el suport per a ''openvpn'' a l'SDK. Per això hem d'incloure les següents línees a l'arxiu ''SDK.UBNT.v5.3/openwrt/.config'' cap al final:
<pre>
CONFIG_PACKAGE_openvpn=y
CONFIG_PACKAGE_liblzo=y
</pre>
Seguidament copiem els fonts a la rama del SDK on es compilen els paquets:
<pre>
cp -a SDK.UBNT.v5.3/openwrt/feeds/packages/libs/lzo/ SDK.UBNT.v5.3/openwrt/package/
cp -a SDK.UBNT.v5.3/openwrt/feeds/packages/net/openvpn/ SDK.UBNT.v5.3/openwrt/package/
</pre>
I tornem a compil.lar la imatge:
<pre>
$ cd SDK.UBNT.v5.3/openwrt
$ make
</pre>
</li>
<li> Disposem de les noves utilitats. Ja les podem copiar al sistema d'arxius descomprimit anteriorment:
<pre>
cd ./build_dir/mips/root-ar71xx
find -name openvpn -o -name *lzo* | while read l; do cp -va $l ../../../../../squashfs-root/$l;done
</pre>
{{nota| És molt important no passar-se'n en la grandària de la imatge, segons la descripció (arxiu .txt) no pot passar de 0x00660000 bytes (6528 Bytes). En el present exemple no cal esborrar cap binari/llibreria del sistema d'arxius per tal que càpiga la nova utilitat.}}
</li>
<li> Seguidament reconstruïm el sistema d'arxius modificats:
<pre>
$ SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/mksquashfs squashfs-root nou-root.fs -nopad -noappend -root-owned -be
Creating big endian 3.0 filesystem on nou-root.fs, block size 65536.

Big endian filesystem, data block size 65536, compressed data, compressed metadata, compressed fragments
Filesystem size 5744.86 Kbytes (5.61 Mbytes)
41.47% of uncompressed filesystem size (13853.86 Kbytes)
Inode table size 11231 bytes (10.97 Kbytes)
31.81% of uncompressed inode table size (35311 bytes)
Directory table size 10990 bytes (10.73 Kbytes)
61.67% of uncompressed directory table size (17821 bytes)
Number of duplicate files found 3
Number of inodes 1124
Number of files 842
Number of fragments 76
Number of symbolic links 223
Number of device nodes 0
Number of fifo nodes 0
Number of socket nodes 0
Number of directories 59
Number of uids 1
root (0)
Number of gids 0
</pre>
</li>
<li> Modifiquem la descripció de la imatge ''XM.ar7240.v5.3.2.8909.110429.1745.txt'' i subsituïm el sistema d'arxius:
<pre>
$ cat XM.ar7240.v5.3.2.8909.110429.1745.txt
u-boot 0x00 0x9F000000 0x00040000 0x00000000 0x00000000 XM.ar7240.v5.3.2.8909.110429.1745.u-boot
kernel 0x01 0x9F050000 0x00100000 0x80002000 0x80002000 XM.ar7240.v5.3.2.8909.110429.1745.kernel
rootfs 0x02 0x9F150000 0x00660000 0x00000000 0x00000000 nou-root.fs
</pre>
</li>
<li> I finalment reconstruïm el firmware:
<pre>
$ SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/ubnt-mkfwimage -v XM.ar7240.v5.3.2.NOU -o XM.ar7240.v5.3.2.NOU.bin -i XM.ar7240.v5.3.2.8909.110429.1745.txt
Firmware version: 'XM.ar7240.v5.3.2.NOU'
Output file: 'XM.ar7240.v5.3.2.NOU.bin'
Part count: 3
u-boot: 164328 bytes (free: 97816)
kernel: 779210 bytes (free: 269366)
rootfs: 5882735 bytes (free: 801937)
</pre>
</li>
<li> L'arxiu '''XM.ar7240.v5.3.2.NOU.bin''' ja el podem actualitzar a la nostra NanoM5 o compatibles.</li>
</ul>
</li>
</ol>

=== IEEE802.11a/b/g Solutions ===
[http://rotobator.es/2009/03/26/de-nanos-picos-y-air-os-parte-i/ Aquí] trobareu info sobre aquests aparells un poc més antics.

== Imatges amb modificacions ==
Seguint el procediment descrit:
* [http://assix.org/wiki/Firmwares|diversos firmwares]

=Resolució de problemes i preguntes freqüents=

== Polarització horitzontal a nanostation Loco ==

Sembla que és habitual que unsolclic deixi les antenes Loco configurades amb polarització horizontal. Si el supernode al que connectem està en polarització vertical (lo habitual en sectorials) cal canviar-ho i millorarà molt la senyal.

== Com canviar la IP 192.168.1.1 per una altre que no xoqui amb les IPs tradicionals dels routers ADSL? ==

Dos opcions:

1) Ho podeu fer al propi unsolclic abans d'aplicar el fitxer, busqueu la línia '''netconf.1.ip=192.168.1.1''' i canvieu la IP a, p. ex., 192.168.1.100

2) Desconnecteu el router ADSL i connecteu només la nanostation. Tingueu en compte els problemes que podeu tenir amb la [[#Problemes_amb_la_cache_ARP_de_Windows_i_la_IP_192.168.1.1 | cache ARP de Windows]]. Utilitzant Firefox, connecteu-vos a l'adreça:

http://192.168.1.1

Poseu la paraula de pas i usuauri (per defecte usuari:root i password:guifi) i aneu a la secció '''Network'''. Més avall a '''LAN Network Settings''' podeu canviar la IP adress, Guardeu i apliqueu els canvis.

Potser també us interessarà saber com:

:*[[#Desactivar DHCP|Desactivar DHCP]]
:*[[#Afegir ruta estàtica permanent a Windows|Afegir ruta estàtica a Windows]]

Consulteu també:

http://www.iesebre.com/manteniment/index.php/Guifi.net/Com_Connectar-se_a_la_xarxa_en_3_passos#Que_cal_tindr.C3.A9_en_compte_per_compartir_la_connexi.C3.B3_d.27un_operadora_i_la_de_guifi_al_mateix_temps

== Desactivar DHCP ==

[[Nanostation#Com_connectar-s.27hi.3F|Connecteu-vos via web a la nanostation]] i dirigiu-vos a la pestanya '''Network''' i després a la secció. desmarque l'opció:

Enable DHCP Server:

Ara feu clic a '''Change''' (botó que apareix a la part inferior de la pàgina) i apliqueu els canvis (botó que apareixerà a la part superior).

== Afegir ruta estàtica permanent a Linux o Windows ==

Consulteu:

http://www.iesebre.com/manteniment/index.php/Guifi.net/Com_Connectar-se_a_la_xarxa_en_3_passos#Afegir_ruta_est.C3.A0tica_per_compartir_guifi.net_i_l.C3.ADnia_ADSL

Aquesta configuració us permet poder accedir al mateix temps a la xarxa guifi i a la connexió a Internet de casa vostra.

== Problemes amb la cache ARP de Windows i la IP 192.168.1.1 ==

La cache ARP del sistema operatiu Windows, es guarda en local les MAC de les adreces IP amb les qual ha contactat fa poc. Podeu consultar la taula amb l'ordre (obriu una línia de comandes de 2):

C:\ arp -a

Veureu que per a la IP 192.168.1.1 teniu la MAC del vostre router ADSL si fa poc que hi estàveu connectats. Si ara desconnecteu el router ADSL i poseu la nanostation, els sistema operatiu no es podrà connectar amb la nanostation fins que aquesta cache s'esborri i s'actualitzi (poden passar diversos minuts, segons els [http://www.windowsreference.com/windows-2000/how-to-clear-arp-cache-in-windows-vistaxp20032000/ tipus de sistema operatiu Windows que tingueu]). Podeu forçar aquest canvi anant a propietats de la connexió i '''Reparant la connexió''' o amb l'ordre:

C:\ netsh interface ip delete arpcache

Vegeu també:
:*http://www.tech-faq.com/clear-arp-cache.html
:*[[ARP]]

== Afegir una ruta estàtica ==

/etc/persistent/rc.poststart

# cfgmtd -w -p /etc/

Try editing cfg file http://ubnt.com/forum/viewtopic.php?t=3939
or adding your static routes to /etc/persistent/rc.poststart
and run command "cfgmtd -w -p /etc/" to write into flash...

==Com fer un reset de la nanostation?==

A les nanostation, desconnecteu el cable de xarxa que proporciona l'alimentació per [[PoE]], premeu durant uns quants segons el boto de '''Reset''' mentrestant torneu a connectar el cable . Això torna la Nanostation a la [[Nanostation#Par.C3.A0metres_de_fabrica| configuració per defecte de fàbrica]].

{{important|No premeu el reset durant molta estona (8 o més segons) que si no d'aquesta manera iniciaríeu el procés de [[#Firmware recovery |firmware recovery]]}}

==Com saber les MAC de la nanostation?==

A l'apartat '''Main''', podeu consultar les MAC:

[[Imatge:Nanostation2.jpg|center]]

Hi ha una MAC de la connexió amb fil (LAN) i una de la WAN.

'''NOTA''': La MAC de la WLAN també apareix a la etiqueta que hi ha sota el connector RJ-45

==Quina és la MAC que apareix a l'etiqueta sota el connector LAN RJ-45? ==

És la MAC de la WLAN.

==Com activar l'accés Telnet==

A l'apartat '''Services'''

http://192.168.1.20/services.cgi

Activeu el Telnet a la secció '''Telnet Server''':

[[Imatge:Nanostation3.jpg|center]]

Per aplicar els canvis heu d'estar atents al missatge que sortira a la part superior de la pàgina web. Feu clic a '''Apply''' i espereu una estona a que s'apliquin els canvis:

[[Imatge:Nanostation4.jpg|center]]

==No em puc connectar a la nanostation després d'aplicar la configuració d'unsolclic==

Després d'aplicar la configuració d'unsolclic no em puc connectar al router. La nanostation existeix però estan tots els ports filtrats tal i com es pot veure amb nmap:

$ sudo nmap 192.168.1.1-255

Starting Nmap 4.53 ( http://insecure.org ) at 2009-02-25 18:15 CET
'''All 1714 scanned ports on 192.168.1.1 are filtered'''
MAC Address: 00:15:6D:AE:70:EE (Ubiquiti Networks)

==Com buscar xarxes WIFI amb nanostation==

Consulteu el document:

http://guifi.net/files/buscar_senyal_nanostation.pdf

Aneu a l'apartat '''Link setup''' i marqueu com a país '''Espanya'''. Feu clic al '''Select''' que hi ha al costat del '''ESSID'''.

[[Imatge:Nanostation5.jpg|center]]

==Consultar la versió del firmware==

Aneu a l'apartat '''System''' i consulteu la secció '''Firmware'''

[[Imatge:Nanostation6.jpg|center]]

Per exemple:

NS2.ar2316.v2.2.1.2476.080208.1627

Correspon a una versió 2.x d'AirOs.

==Com fer un upgrade del firmware==

Aneu a l'apartat '''System''' i a la secció '''Firmware''' feu clic al boto '''upgrade'''

El firmware el podeu obtenir de la pàgina de suport de ubiquiti:

http://www.ubnt.com/support/ns2.php

Si no funciona:

http://www.ubnt.com/support/downloads

Per exemple per descarregar l'última versió (--[[Usuari:Sergi|acacha]] 16:54, 24 maig 2010 (UTC)):

http://www.ubnt.com/downloads/NanoStation2-v3.5.build4494.bin

Nanostation comprades durant el maig de 2010 venen amb:

NS2.ar2316.v3.5.4494.091109.1451

----

Exemple àntic, guardat només com a referència.

Per exemple per descarregar l'última versió (--[[Usuari:Sergi|acacha]] 19:57, 25 febr 2009 (CET)):

$ wget http://www.ubnt.com/downloads/XS-fw/v3.3.1/NS2.ar2316.v3.3.1.4227.090128.1828.bin

==OpenWRT==

:*http://intoverflow.wordpress.com/2008/11/14/openwrt-and-ubiquiti-nanostation-2/
:*http://www.ubnt.com/downloads/PS2.ar2316.OpenWRT-kamikaze.v7.09.bin

==Recuperar el firmware==

:*http://www.ubnt.com/wiki/index.php?title=Firmware_Recovery

=Recursos=

*http://www.ubnt.com/products/ns2.php
*http://wiki.ubnt.com/wiki/index.php/AirOS

[[categoria:router]]

Ubiquity Nanostation

2011-07-21T19:03:00Z

Rotobator: /* Construcció de firmware */

=Nanostation 2=

*Freqüència: 2.4Ghz
*Guany: 10dBi
*Distàncies: Fins a 15Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Nanostation loco 2==

Pensada per a distàncies menors, és més barata i petita:

*Freqüència: 2.4Ghz
*Guany: 8dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Documentació oficial==

*[http://www.ubnt.com/downloads/ns2_datasheet.pdf NS2 Datasheet]
*[http://www.ubnt.com/support/ns2.php NS2 Pàgina de suport]
*[http://www.ubnt.com/downloads/loco2_datasheet.pdf NSloco2 Datasheet]
*[http://www.ubnt.com/products/loco.php NSloco Pàgina de suport]

==Paràmetres de fabrica==

Tal i com posa a la caixa:

*'''IP''': 192.168.1.20
*'''Màscara''': 255.255.255.0
*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

==Com connectar-s'hi?==

Amb Linux, podeu utilitzar [[IP Aliasing]] per a connectar-vos a la nanostation sense perdre la vostra connexió a Internet. A una terminal, escriviu:

$ sudo ifconfig eth0:1 192.168.1.25 netmask 255.255.255.0 up

'''NOTA''': Si la vostra xarxa ja és la 192.168.1.x no cal que feu cap d'aquests passos i us hi podeu connectar directament. Vigileu que no tingueu la
mala sort de ja tenir una màquina amb la IP 192.168.1.20 a la vostra xarxa

Hem escollir la IP 192.168.1.25 perquè és una de les IP lliures de la xarxa lògica on està connectada la nanostation. Amb:

$ ipcalc 192.168.1.20/255.255.255.0
Address: 192.168.1.20 11000000.10101000.00000001. 00010100
Netmask: 255.255.255.0 = 24 11111111.11111111.11111111. 00000000
Wildcard: 0.0.0.255 00000000.00000000.00000000. 11111111
=>
Network: 192.168.1.0/24 11000000.10101000.00000001. 00000000
'''HostMin''': 192.168.1.1 11000000.10101000.00000001. 00000001
'''HostMax''': 192.168.1.254 11000000.10101000.00000001. 11111110
Broadcast: 192.168.1.255 11000000.10101000.00000001. 11111111
Hosts/Net: 254 Class C, Private Internet

Podeu obtenir la informació de la xarxa. Qualsevol valor entre HostMin i HostMax que no estigui sent utilitzat (per exemple no podeu utilitzar la IP de la nanostation 192.168.1.20) és un valor vàlid.

Comproveu que la interfície s'ha creat correctament:

$ ifconfig eth0:1
eth0:1 Link encap:Ethernet HWaddr 00:30:05:eb:a3:8d
inet addr:192.168.1.25 Bcast:192.168.1.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
Interrupt:20 Base address:0xa000

I feu un ping a la nanostation per veure si contesta:

$ ping 192.168.1.20
PING 192.168.1.20 (192.168.1.20) 56(84) bytes of data.
64 bytes from 192.168.1.20: icmp_seq=1 ttl=64 time=2.41 ms
...

Ara ja podeu connectar-vos amb el vostre navegador posant a la URL:

http://192.168.1.20

[[Imatge:Nanostation1.jpg|center]]

La paraula de pas i l'usuari són:

*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

===Resolució de problemes en la connexió===

Comproveu que s'ha creat la interfície virtual amb

$ ifconfig eth0:1

Potser la vostra interfície de xarxa no és la eth0?

Comproveu que s'ha creat una ruta que us permeti connectar al dispositiu:

$ route -n
Kernel IP routing table
Destination Gateway Genmask Flags Metric Ref Use Iface
'''192.168.1.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0'''
192.168.12.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0
169.254.0.0 0.0.0.0 255.255.0.0 U 1000 0 0 eth0
0.0.0.0 192.168.12.1 0.0.0.0 UG 100 0 0 eth0

També podeu provar si la URL funciona correctament amb:

$ wget http://192.168.1.20

O fer un escànner de ports amb:

$ sudo nmap 192.168.1.20

Starting Nmap 4.53 ( http://insecure.org ) at 2009-02-25 16:56 CET
Interesting ports on 192.168.1.20:
Not shown: 1712 closed ports
PORT STATE SERVICE
23/tcp open telnet
80/tcp open http
MAC Address: 00:15:6D:AD:70:EE (Ubiquiti Networks)

Com podeu veure també es possible accedir al dispositiu amb Telnet (només si ho heu activat des de la web de nanostation)

'''NOTA''': Qualsevol comanda que no tingueu (com nmap o ipcalc) la podeu instal·lar amb:

$ sudo apt-get install comanda_que_teniu

=Nanostation 5=

*Freqüència: 5Ghz
*Guany: 8dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Nanostation loco 5==

Pensada per a distàncies menors, és més barata i petita:

*Freqüència: 5Ghz
*Guany: 13dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 6Mbps a 54mbps segons la distància

==Documentació oficial==

*http://www.ubnt.com/products/nano.php
*[http://www.ubnt.com/downloads/ns5_datasheet.pdf NS5 datasheet]
*[http://www.ubnt.com/downloads/loco5_datasheet.pdf NSloco5 datasheet]
*[http://www.ubnt.com/products/loco.php NSloco Pàgina de suport]

= Nanostation Mimo (M)=

<blockquote>
Les Mimo son Airmax, es a dir porten el firmware Airos 5.2, molt mes
avançat, suporten WDS (ho he provat), tenen mes potencia d'emissio, i son
mes mones....

A mes pensem que el suport a noves versions es per Airos 5.2, mentres que
les versions antigues es deixara de donar suport segurament.

A mes les Airmax tenen suport per protocol N, es a dir millor velocitat
(ample de banda), basicament crec que aquestes son les diferencies mes
significatives.

</blockquote>

:*http://www.mail-archive.com/guifi-usuaris@llistes.projectes.lafarga.org/msg10719.html

=Configuració per a guifi.net=

Primer cal afegir un node a la web de [http://www.guifi.net guifi.net]. Consulteu l'article [[Exemple_pas_a_pas_de_muntatge_d'un_node_a_l'IES_Nicolau_Copèrnic]] per conèixer els detalls.

== Configuració de la nanostation amb unsolclic ==

Un cop tenim el node, els trastos i la radio i els enllaços creats, podem obtenir la configuració d'unsolclic. Trobareu una opció de menú al vostre node

Per exemple:

http://guifi.net/guifi/device/13636/view/unsolclic

Ha de ser quelcom similar a:

# Generat per a:
# AirOsv30

Click here to download configuration file for: TRSCEIPMariaGaliRd1
Put the mouse cursor over the link. Right click the link and select "Save Link/Target As..." to save to your Desktop.

# Configuration for AirOs> Unsolclic version:1.0.2 !! WARNING: Beta version !!
# Device: TRSCEIPMariaGaliRd1
#
# Methods to upload/execute the file:
# 1.- As a file. Upload this through web managment:
# a.System->Configuratuion Managment->Locate file
# b.Upload
# 2.- Telnet: Open a terminal session, create new /tmp/system.cfg file and cut&paste
# the contents of the file. Save it an execute the command:
#
# /usr/etc/rc.d/rc.softrestart save
#
# Notes:
# -Web access method is recommended
# (the script reconfigures some IP addresses, so communication can be lost.
# 192.168.1.1 will be the new one)
# -Changes are done in user passwords on the device, default user and password are
# changed to root/guifi.
# -The ACK is set to 45 for 802.11b mode, and to 25 for 802.11a (600 meters aprox,)
#
## Link to AP info
Ap SSID = guifi.net-TRSACprncRd1AP0
WAN Ip address = 10.139.60.34
WAN Netmask = 255.255.255.224
WAN Gateway = 10.139.60.33
Primary DNS Server = 10.139.7.162
Secondary DNS Server =
Device HostName = TRSCEIPMariaGaliRd1
IEEE 802.11 Mode: = B Only (2,4Ghz 11MB)

Tal i com es comenta teniu dos opcions per aplicar aquesta configuració. Per la web de la nanostation o per Telnet.

'''Configuració per la web'''

Primer de tot us heu de connectar al dispositiu. Els valors per defecte o de fàbrica de la nanostation són:

*'''IP''': 192.168.1.20
*'''Màscara''': 255.255.255.0
*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

Podeu utilitzar [[IP Aliasing]] per connectar-vos al dispositiu. Per exemple:

$ sudo ifconfig eth0:1 192.168.1.19 netmask 255.255.255.0 up

'''NOTA''': En aquest exemple suposem que la vostra interfície de xarxa és la eth0. Si no és així modifiqueu aquest valor per adaptar-lo al vostre cas.

Aneu a l'apartat:

System->Configuration Management

[[Imatge:NanostationGuifi.png|center]]
...
[[Imatge:NanostationGuifi1.png|center]]

I utilitzeu el boto '''Navega''' per localitzar el fitxer de configuració que voleu aplicar. El fitxer de configuració el trobareu a l'enllaç on posa:

'''Click here to download configuration file for''':

El podeu descarregar amb [[wget]]:

$ wget http://guifi.net/files/nanostation/TRSCEIPMariaGaliRd1.cfg

'''IMPORTANT''': En el cas de les nanostation el fitxer que cal aplicar és el '''.cfg'''!!!

Un cop heu indicat el fitxer feu clic a '''Upload'''. Per aplicar els canvis heu d'estar atents al missatge que sortira a la part superior de la pàgina web. Feu clic a '''Apply''' i espereu una estona a que s'apliquin els canvis:

[[Imatge:Nanostation4.jpg|center]]

'''NOTA IMPORTANT''': Tingueu en compte que aquesta IP és una IP molt comuna i que és molt possible que el vostre gateway tingui
la mateixa IP. Si voleu evitar problemes, canvieu aquesta adreça abans d'aplicar unsolclic al dispositiu.

Al aplicar un solclic, l'usuari i la paraula de pas passen a ser:

*'''Usuari''': root
*'''Paraula de pas''': guifi

També pot ser que la IP hagi canviat a '''192.168.1.1'''.

Consulteu també el document:

http://guifi.net/files/Manual_unsoclick_Nanostation.pdf

Per veure un pas a pas amb exemples de com pujar la configuració de guifi.net a una nanostation.

'''Configuració per Telnet'''

Connecteu-vos via Telnet:

$ telnet 192.168.1.20

Poseu l'usuari i paraula de pas de fàbrica del dispositiu (ubnt, ubnt). Un cop dins del dispositiu creeu el fitxer:

$ vi /tmp/system.cfg

I enganxeu el text d'un solclic. Un cop salveu el fitxer executeu:

$ /usr/etc/rc.d/rc.softrestart save

'''Recursos''':
*http://guifi.net/files/Manual_unsoclick_Nanostation.pdf

=Manual=

*http://wiki.ubnt.com/wiki/index.php/AirOS

= Protocol CDP =

[http://es.wikipedia.org/wiki/CDP Cisco Discovery Protocol].

$ sudo tcpdump
10:41:58.132091 CDPv1, ttl: 120s, Device-ID 'TRSCEIPMariaGaliRd1'[|cdp]
10:41:58.135969 CDPv1, ttl: 120s, Device-ID 'TRSCEIPMariaGaliRd1'[|cdp]
10:42:06.618809 IP 10.139.60.33 > 224.0.0.5: OSPFv2, Hello, length: 44

= Firmware recovery =

Aquesta secció us explica com recuperar el [[firmware]] original de la Nanostation, per exemple després d'haver posat un firware especific com [[DD-WRT]] o [[openwrt]].

El primer que us caldrà és una copia del firmware. Podeu saber quina versió del firmware teniu (o consultar en un altre nanostation si la vostra no té firmware) a l'apartat sistema de la nanostation (per exemple per una nano amb IP 192.168.1.101):

https://192.168.1.101/system.cgi

Veureu quelcom similar a:

XS2.ar2316.v3.5.4476.091013.1749

{{nota| En aquesta mateixa secció podríeu fer un upgrade/actualització de l'antena}}

Per obtenir una còpia del firmware original aneu a:

http://www.ubnt.com/support/downloads

Escolliu:

IEEE/802.11a/b/gSolutions, Nanostation 2 (o el model que busqueu)

I us baixeu l'última versió, actualment (--[[Usuari:Sergi|acacha]] 16:07, 12 oct 2010 (UTC)) la 3.5.1:

$ [[wget]] http://www.ubnt.com/downloads/NanoStation2-v3.5.1.build4631.bin

A més podeu comprovar la suma md5 ([[md5]]) amb:

$ [[md5sum]] NanoStation2-v3.5.1.build4631.bin
7e42fc6338356ec488f92c5d9b3d065c NanoStation2-v3.5.1.build4631.bin

Ha de coincidir amb la que posi a la web.

Ara connecteu la nanostation al POE per tal d'encendre-la i també a la vostra LAN. Un cop la tingueu preparada trèieu l'alimentació i premeu el botó de reset, manteniu-lo premut mentrestant torneu a connectar l'alimentació, si manteniu premut més de 8 segons la Nanostation començarà a parpadejar de forma intermitent els LEDS de cobertura (primers els 2 i el 4 i després el 1 i el 3).

Si ja teniu l'ordinador des de el que us volue connectar a la xarxa 192.168.1.0/24 només us cal comprovar que podeu fer un ping a la nano:

$ [[ping]] 192.168.1.20

Sinó podeu utilitzar [[IP Aliasing]]:

$ [[sudo]] [[ifconfig]] eth0:1 192.168.1.254

Ara necessiteu un client de [[FTP]] com [[tftp]] (Trivial FTP):

$ sudo [[apt-get]] install tftp

I pugeu el firmware:

$tftp 192.168.1.20
tftp> bin
tftp> trace
tftp> put XS2.ar2316.v3.4-rc.4351.090504.2146.bin
...
...
Sent 1965199 bytes in 35.2 seconds
tftp> quit

Durant el upload del firware s'aturaran de parpallejar els LEDS, anirant fent canvis. Cal deixar que els LEDS vagin canviant de un a un cada color durant uns 7-10 minuts depenent del dispositiu.

{{important|No atureu la corrent durant el procés d'actualització}}

Quan acabi només quedaran encesos els LEDS PWR i LAN i podeu accedir a la nanostation amb la [[Nanostation#Par.C3.A0metres_de_fabrica|configuració de fabrica]].

:*http://www.ubnt.com/wiki/Firmware_Recovery
:*http://www.ubnt.com/wiki/Recuperar_firmware

= Construcció de firmware =
Ubiquity posa a disposició pública l'SDK per tal que pugam reconstruir una imatge després d'haver fet canvis, com ara afegir serveis, eliminar mòduls que no s'usen per tal de que el catxarro siga més eficient o simplement modificar el programari per defecte.

A la web oficial es pot baixar l'SDK corresponent a la versió del nostre catxarro: http://ubnt.com/support/downloads.

{{nota| a la secció [[Firmware recovery]] trobareu com restaurar un catxarro que no arranca amb una firmware customitzat}}

== Exemple de reconstrucció del firmware ==

=== AirMax ISP Solutions ===
Es correspon amb la sèrie més moderna dels productes de Ubiquity. Veurem com podem afegir ''openvpn'' a la nostra antena, el mateix o molt paregut procediment seguirem per afegir ''quagga'' o d'altres.

Hi ha dos mètodes per generar una imatge:
<ol>
<li> Seguir les instruccions del fabricant, que diu, una vegada descomprimit el paquet a ''readme.txt'':
<pre>
Step by step instructions
-------------------------

1. Extract files

$ tar xjvf SDK.UBNT.v5.3.tar.bz2

2. Build

$ cd SDK.UBNT.v5.3/openwrt
$ make

3. Look for firmware file (with prefix XM) in openwrt/bin/.

Good luck!
</pre>
Amb la versió 5.3 no hem pogut generar una imatge vàlida, donat que li falta el ''bootloader u-boot'', tal com veurem al desmuntar una imatge de fàbrica al següent mètode. Per este motiu ens dessitgen ''Good luck''.</li>
<li>
A partir d'una imatge oficial. En este cas, haurem de seguir els pasos anteriors amb la intenció d'obtindre les eines que ens ajudaran a modificar una imatge, i que són: ''fwsplit'', ''unsquashfs'', ''mksquashfs'' i ''mkfwimage''. És important usar estes eines enlloc de les que podrem trobar en les nostres distros de linux donat que, per exemple, el ''mksquashfs'' disposa d'una opció per escollir l'endiannicitat (Big Endian en el cas d'ubiquity, a banda d'altres característiques) del sistema d'arxius, i que no es troba en altres versions.
<ul>
<li>Una vegada compilat un firmware amb el SDK disposem de les eines bàsiques:
<pre>
SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/fwsplit
SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/mksquashfs
SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/unsquashfs
SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/ubnt-mkfwimage
</pre>
</li>
<li>Sobre el firmware original, desmuntem l'imatge:
<pre>$ SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/fwsplit XM-v5.3.2.build8909.bin
Firmware file: 'XM-v5.3.2.build8909.bin'
Firmware version: 'XM.ar7240.v5.3.2.8909.110429.1745'
Creating descriptor file:
XM.ar7240.v5.3.2.8909.110429.1745.txt
Creating partition data files:
XM.ar7240.v5.3.2.8909.110429.1745.u-boot
XM.ar7240.v5.3.2.8909.110429.1745.kernel
XM.ar7240.v5.3.2.8909.110429.1745.rootfs
</pre>
Tenim 4 arxius addicionals: la descripció (XM.ar7240.v5.3.2.8909.110429.1745.txt), el bootloader (XM.ar7240.v5.3.2.8909.110429.1745.u-boot), el nucli (XM.ar7240.v5.3.2.8909.110429.1745.kernel) i el sistema d'arxius (XM.ar7240.v5.3.2.8909.110429.1745.rootfs) comprimit amb format squashfs i ordenació big endian.
És justament el bootloader el que no es troba a l'imatge generada al seguir els passos del fabricant.
</li>
<li>Descomprimim el sistema d'arxius:
<pre>
$ SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/unsquashfs XM.ar7240.v5.3.2.8909.110429.1745.rootfs
Reading a different endian SQUASHFS filesystem on XM.ar7240.v5.3.2.8909.110429.1745.rootfs

created 838 files
created 59 directories
created 222 symlinks
created 0 devices
created 0 fifos
</pre>
Al directori ''squashfs-root'' ja tenim tot el sistema d'arxius de manera que ja podem furgar-lo un poc. En este cas volem afegir suport per a ''openvpn''. Aquest paquet te dependències de la llibreria de compressió en temps real ''lzo''. En este cas ens resultarà fàcil afegir aquest client/dimoni, donat que ja esta inclós a l'SDK, en altres casos haurem d'adaptar el programari a aquesta distribució d'openwrt en què es basa el firmware d'ubiquity (a la sèrie M5).
</li>
<li> Compilem el suport per a ''openvpn'' a l'SDK. Per això hem d'incloure les següents línees a l'arxiu ''SDK.UBNT.v5.3/openwrt/.config'' cap al final:
<pre>
CONFIG_PACKAGE_openvpn=y
CONFIG_PACKAGE_liblzo=y
</pre>
Seguidament copiem els fonts a la rama del SDK on es compilen els paquets:
<pre>
cp -a SDK.UBNT.v5.3/openwrt/feeds/packages/libs/lzo/ SDK.UBNT.v5.3/openwrt/package/
cp -a SDK.UBNT.v5.3/openwrt/feeds/packages/net/openvpn/ SDK.UBNT.v5.3/openwrt/package/
</pre>
I tornem a compil.lar la imatge:
<pre>
$ cd SDK.UBNT.v5.3/openwrt
$ make
</pre>
</li>
<li> Disposem de les noves utilitats. Ja les podem copiar al sistema d'arxius descomprimit anteriorment:
<pre>
cd ./build_dir/mips/root-ar71xx
find -name openvpn -o -name *lzo* | while read l; do cp -va $l ../../../../../squashfs-root/$l;done
</pre>
{{nota| És molt important no passar-se'n en la grandària de la imatge, segons la descripció (arxiu .txt) no pot passar de 0x00660000 bytes (6528 Bytes). En el present exemple no cal esborrar cap binari/llibreria del sistema d'arxius per tal que càpiga la nova utilitat.}}
</li>
<li> Seguidament reconstruïm el sistema d'arxius modificats:
<pre>
$ SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/mksquashfs squashfs-root nou-root.fs -nopad -noappend -root-owned -be
Creating big endian 3.0 filesystem on nou-root.fs, block size 65536.

Big endian filesystem, data block size 65536, compressed data, compressed metadata, compressed fragments
Filesystem size 5744.86 Kbytes (5.61 Mbytes)
41.47% of uncompressed filesystem size (13853.86 Kbytes)
Inode table size 11231 bytes (10.97 Kbytes)
31.81% of uncompressed inode table size (35311 bytes)
Directory table size 10990 bytes (10.73 Kbytes)
61.67% of uncompressed directory table size (17821 bytes)
Number of duplicate files found 3
Number of inodes 1124
Number of files 842
Number of fragments 76
Number of symbolic links 223
Number of device nodes 0
Number of fifo nodes 0
Number of socket nodes 0
Number of directories 59
Number of uids 1
root (0)
Number of gids 0
</pre>
</li>
<li> Modifiquem la descripció de la imatge ''XM.ar7240.v5.3.2.8909.110429.1745.txt'' i subsituïm el sistema d'arxius:
<pre>
$ cat XM.ar7240.v5.3.2.8909.110429.1745.txt
u-boot 0x00 0x9F000000 0x00040000 0x00000000 0x00000000 XM.ar7240.v5.3.2.8909.110429.1745.u-boot
kernel 0x01 0x9F050000 0x00100000 0x80002000 0x80002000 XM.ar7240.v5.3.2.8909.110429.1745.kernel
rootfs 0x02 0x9F150000 0x00660000 0x00000000 0x00000000 nou-root.fs
</pre>
</li>
<li> I finalment reconstruïm el firmware:
<pre>
$ SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/ubnt-mkfwimage -v XM.ar7240.v5.3.2.NOU -o XM.ar7240.v5.3.2.NOU.bin -i XM.ar7240.v5.3.2.8909.110429.1745.txt
Firmware version: 'XM.ar7240.v5.3.2.NOU'
Output file: 'XM.ar7240.v5.3.2.NOU.bin'
Part count: 3
u-boot: 164328 bytes (free: 97816)
kernel: 779210 bytes (free: 269366)
rootfs: 5882735 bytes (free: 801937)
</pre>
</li>
<li> L'arxiu '''XM.ar7240.v5.3.2.NOU.bin''' ja el podem actualitzar a la nostra NanoM5 o compatibles.</li>
</ul>
</li>
</ol>

=== IEEE802.11a/b/g Solutions ===
[http://rotobator.es/2009/03/26/de-nanos-picos-y-air-os-parte-i/ Aquí] trobareu info sobre aquests aparells un poc més antics.

== Imatges amb modificacions ==
* http://assix.org/wiki/Firmwares

=Resolució de problemes i preguntes freqüents=

== Polarització horitzontal a nanostation Loco ==

Sembla que és habitual que unsolclic deixi les antenes Loco configurades amb polarització horizontal. Si el supernode al que connectem està en polarització vertical (lo habitual en sectorials) cal canviar-ho i millorarà molt la senyal.

== Com canviar la IP 192.168.1.1 per una altre que no xoqui amb les IPs tradicionals dels routers ADSL? ==

Dos opcions:

1) Ho podeu fer al propi unsolclic abans d'aplicar el fitxer, busqueu la línia '''netconf.1.ip=192.168.1.1''' i canvieu la IP a, p. ex., 192.168.1.100

2) Desconnecteu el router ADSL i connecteu només la nanostation. Tingueu en compte els problemes que podeu tenir amb la [[#Problemes_amb_la_cache_ARP_de_Windows_i_la_IP_192.168.1.1 | cache ARP de Windows]]. Utilitzant Firefox, connecteu-vos a l'adreça:

http://192.168.1.1

Poseu la paraula de pas i usuauri (per defecte usuari:root i password:guifi) i aneu a la secció '''Network'''. Més avall a '''LAN Network Settings''' podeu canviar la IP adress, Guardeu i apliqueu els canvis.

Potser també us interessarà saber com:

:*[[#Desactivar DHCP|Desactivar DHCP]]
:*[[#Afegir ruta estàtica permanent a Windows|Afegir ruta estàtica a Windows]]

Consulteu també:

http://www.iesebre.com/manteniment/index.php/Guifi.net/Com_Connectar-se_a_la_xarxa_en_3_passos#Que_cal_tindr.C3.A9_en_compte_per_compartir_la_connexi.C3.B3_d.27un_operadora_i_la_de_guifi_al_mateix_temps

== Desactivar DHCP ==

[[Nanostation#Com_connectar-s.27hi.3F|Connecteu-vos via web a la nanostation]] i dirigiu-vos a la pestanya '''Network''' i després a la secció. desmarque l'opció:

Enable DHCP Server:

Ara feu clic a '''Change''' (botó que apareix a la part inferior de la pàgina) i apliqueu els canvis (botó que apareixerà a la part superior).

== Afegir ruta estàtica permanent a Linux o Windows ==

Consulteu:

http://www.iesebre.com/manteniment/index.php/Guifi.net/Com_Connectar-se_a_la_xarxa_en_3_passos#Afegir_ruta_est.C3.A0tica_per_compartir_guifi.net_i_l.C3.ADnia_ADSL

Aquesta configuració us permet poder accedir al mateix temps a la xarxa guifi i a la connexió a Internet de casa vostra.

== Problemes amb la cache ARP de Windows i la IP 192.168.1.1 ==

La cache ARP del sistema operatiu Windows, es guarda en local les MAC de les adreces IP amb les qual ha contactat fa poc. Podeu consultar la taula amb l'ordre (obriu una línia de comandes de 2):

C:\ arp -a

Veureu que per a la IP 192.168.1.1 teniu la MAC del vostre router ADSL si fa poc que hi estàveu connectats. Si ara desconnecteu el router ADSL i poseu la nanostation, els sistema operatiu no es podrà connectar amb la nanostation fins que aquesta cache s'esborri i s'actualitzi (poden passar diversos minuts, segons els [http://www.windowsreference.com/windows-2000/how-to-clear-arp-cache-in-windows-vistaxp20032000/ tipus de sistema operatiu Windows que tingueu]). Podeu forçar aquest canvi anant a propietats de la connexió i '''Reparant la connexió''' o amb l'ordre:

C:\ netsh interface ip delete arpcache

Vegeu també:
:*http://www.tech-faq.com/clear-arp-cache.html
:*[[ARP]]

== Afegir una ruta estàtica ==

/etc/persistent/rc.poststart

# cfgmtd -w -p /etc/

Try editing cfg file http://ubnt.com/forum/viewtopic.php?t=3939
or adding your static routes to /etc/persistent/rc.poststart
and run command "cfgmtd -w -p /etc/" to write into flash...

==Com fer un reset de la nanostation?==

A les nanostation, desconnecteu el cable de xarxa que proporciona l'alimentació per [[PoE]], premeu durant uns quants segons el boto de '''Reset''' mentrestant torneu a connectar el cable . Això torna la Nanostation a la [[Nanostation#Par.C3.A0metres_de_fabrica| configuració per defecte de fàbrica]].

{{important|No premeu el reset durant molta estona (8 o més segons) que si no d'aquesta manera iniciaríeu el procés de [[#Firmware recovery |firmware recovery]]}}

==Com saber les MAC de la nanostation?==

A l'apartat '''Main''', podeu consultar les MAC:

[[Imatge:Nanostation2.jpg|center]]

Hi ha una MAC de la connexió amb fil (LAN) i una de la WAN.

'''NOTA''': La MAC de la WLAN també apareix a la etiqueta que hi ha sota el connector RJ-45

==Quina és la MAC que apareix a l'etiqueta sota el connector LAN RJ-45? ==

És la MAC de la WLAN.

==Com activar l'accés Telnet==

A l'apartat '''Services'''

http://192.168.1.20/services.cgi

Activeu el Telnet a la secció '''Telnet Server''':

[[Imatge:Nanostation3.jpg|center]]

Per aplicar els canvis heu d'estar atents al missatge que sortira a la part superior de la pàgina web. Feu clic a '''Apply''' i espereu una estona a que s'apliquin els canvis:

[[Imatge:Nanostation4.jpg|center]]

==No em puc connectar a la nanostation després d'aplicar la configuració d'unsolclic==

Després d'aplicar la configuració d'unsolclic no em puc connectar al router. La nanostation existeix però estan tots els ports filtrats tal i com es pot veure amb nmap:

$ sudo nmap 192.168.1.1-255

Starting Nmap 4.53 ( http://insecure.org ) at 2009-02-25 18:15 CET
'''All 1714 scanned ports on 192.168.1.1 are filtered'''
MAC Address: 00:15:6D:AE:70:EE (Ubiquiti Networks)

==Com buscar xarxes WIFI amb nanostation==

Consulteu el document:

http://guifi.net/files/buscar_senyal_nanostation.pdf

Aneu a l'apartat '''Link setup''' i marqueu com a país '''Espanya'''. Feu clic al '''Select''' que hi ha al costat del '''ESSID'''.

[[Imatge:Nanostation5.jpg|center]]

==Consultar la versió del firmware==

Aneu a l'apartat '''System''' i consulteu la secció '''Firmware'''

[[Imatge:Nanostation6.jpg|center]]

Per exemple:

NS2.ar2316.v2.2.1.2476.080208.1627

Correspon a una versió 2.x d'AirOs.

==Com fer un upgrade del firmware==

Aneu a l'apartat '''System''' i a la secció '''Firmware''' feu clic al boto '''upgrade'''

El firmware el podeu obtenir de la pàgina de suport de ubiquiti:

http://www.ubnt.com/support/ns2.php

Si no funciona:

http://www.ubnt.com/support/downloads

Per exemple per descarregar l'última versió (--[[Usuari:Sergi|acacha]] 16:54, 24 maig 2010 (UTC)):

http://www.ubnt.com/downloads/NanoStation2-v3.5.build4494.bin

Nanostation comprades durant el maig de 2010 venen amb:

NS2.ar2316.v3.5.4494.091109.1451

----

Exemple àntic, guardat només com a referència.

Per exemple per descarregar l'última versió (--[[Usuari:Sergi|acacha]] 19:57, 25 febr 2009 (CET)):

$ wget http://www.ubnt.com/downloads/XS-fw/v3.3.1/NS2.ar2316.v3.3.1.4227.090128.1828.bin

==OpenWRT==

:*http://intoverflow.wordpress.com/2008/11/14/openwrt-and-ubiquiti-nanostation-2/
:*http://www.ubnt.com/downloads/PS2.ar2316.OpenWRT-kamikaze.v7.09.bin

==Recuperar el firmware==

:*http://www.ubnt.com/wiki/index.php?title=Firmware_Recovery

=Recursos=

*http://www.ubnt.com/products/ns2.php
*http://wiki.ubnt.com/wiki/index.php/AirOS

[[categoria:router]]

Ubiquity Nanostation

2011-07-21T18:01:50Z

Rotobator: /* AirMax ISP Solutions */

=Nanostation 2=

*Freqüència: 2.4Ghz
*Guany: 10dBi
*Distàncies: Fins a 15Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Nanostation loco 2==

Pensada per a distàncies menors, és més barata i petita:

*Freqüència: 2.4Ghz
*Guany: 8dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Documentació oficial==

*[http://www.ubnt.com/downloads/ns2_datasheet.pdf NS2 Datasheet]
*[http://www.ubnt.com/support/ns2.php NS2 Pàgina de suport]
*[http://www.ubnt.com/downloads/loco2_datasheet.pdf NSloco2 Datasheet]
*[http://www.ubnt.com/products/loco.php NSloco Pàgina de suport]

==Paràmetres de fabrica==

Tal i com posa a la caixa:

*'''IP''': 192.168.1.20
*'''Màscara''': 255.255.255.0
*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

==Com connectar-s'hi?==

Amb Linux, podeu utilitzar [[IP Aliasing]] per a connectar-vos a la nanostation sense perdre la vostra connexió a Internet. A una terminal, escriviu:

$ sudo ifconfig eth0:1 192.168.1.25 netmask 255.255.255.0 up

'''NOTA''': Si la vostra xarxa ja és la 192.168.1.x no cal que feu cap d'aquests passos i us hi podeu connectar directament. Vigileu que no tingueu la
mala sort de ja tenir una màquina amb la IP 192.168.1.20 a la vostra xarxa

Hem escollir la IP 192.168.1.25 perquè és una de les IP lliures de la xarxa lògica on està connectada la nanostation. Amb:

$ ipcalc 192.168.1.20/255.255.255.0
Address: 192.168.1.20 11000000.10101000.00000001. 00010100
Netmask: 255.255.255.0 = 24 11111111.11111111.11111111. 00000000
Wildcard: 0.0.0.255 00000000.00000000.00000000. 11111111
=>
Network: 192.168.1.0/24 11000000.10101000.00000001. 00000000
'''HostMin''': 192.168.1.1 11000000.10101000.00000001. 00000001
'''HostMax''': 192.168.1.254 11000000.10101000.00000001. 11111110
Broadcast: 192.168.1.255 11000000.10101000.00000001. 11111111
Hosts/Net: 254 Class C, Private Internet

Podeu obtenir la informació de la xarxa. Qualsevol valor entre HostMin i HostMax que no estigui sent utilitzat (per exemple no podeu utilitzar la IP de la nanostation 192.168.1.20) és un valor vàlid.

Comproveu que la interfície s'ha creat correctament:

$ ifconfig eth0:1
eth0:1 Link encap:Ethernet HWaddr 00:30:05:eb:a3:8d
inet addr:192.168.1.25 Bcast:192.168.1.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
Interrupt:20 Base address:0xa000

I feu un ping a la nanostation per veure si contesta:

$ ping 192.168.1.20
PING 192.168.1.20 (192.168.1.20) 56(84) bytes of data.
64 bytes from 192.168.1.20: icmp_seq=1 ttl=64 time=2.41 ms
...

Ara ja podeu connectar-vos amb el vostre navegador posant a la URL:

http://192.168.1.20

[[Imatge:Nanostation1.jpg|center]]

La paraula de pas i l'usuari són:

*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

===Resolució de problemes en la connexió===

Comproveu que s'ha creat la interfície virtual amb

$ ifconfig eth0:1

Potser la vostra interfície de xarxa no és la eth0?

Comproveu que s'ha creat una ruta que us permeti connectar al dispositiu:

$ route -n
Kernel IP routing table
Destination Gateway Genmask Flags Metric Ref Use Iface
'''192.168.1.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0'''
192.168.12.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0
169.254.0.0 0.0.0.0 255.255.0.0 U 1000 0 0 eth0
0.0.0.0 192.168.12.1 0.0.0.0 UG 100 0 0 eth0

També podeu provar si la URL funciona correctament amb:

$ wget http://192.168.1.20

O fer un escànner de ports amb:

$ sudo nmap 192.168.1.20

Starting Nmap 4.53 ( http://insecure.org ) at 2009-02-25 16:56 CET
Interesting ports on 192.168.1.20:
Not shown: 1712 closed ports
PORT STATE SERVICE
23/tcp open telnet
80/tcp open http
MAC Address: 00:15:6D:AD:70:EE (Ubiquiti Networks)

Com podeu veure també es possible accedir al dispositiu amb Telnet (només si ho heu activat des de la web de nanostation)

'''NOTA''': Qualsevol comanda que no tingueu (com nmap o ipcalc) la podeu instal·lar amb:

$ sudo apt-get install comanda_que_teniu

=Nanostation 5=

*Freqüència: 5Ghz
*Guany: 8dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Nanostation loco 5==

Pensada per a distàncies menors, és més barata i petita:

*Freqüència: 5Ghz
*Guany: 13dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 6Mbps a 54mbps segons la distància

==Documentació oficial==

*http://www.ubnt.com/products/nano.php
*[http://www.ubnt.com/downloads/ns5_datasheet.pdf NS5 datasheet]
*[http://www.ubnt.com/downloads/loco5_datasheet.pdf NSloco5 datasheet]
*[http://www.ubnt.com/products/loco.php NSloco Pàgina de suport]

= Nanostation Mimo (M)=

<blockquote>
Les Mimo son Airmax, es a dir porten el firmware Airos 5.2, molt mes
avançat, suporten WDS (ho he provat), tenen mes potencia d'emissio, i son
mes mones....

A mes pensem que el suport a noves versions es per Airos 5.2, mentres que
les versions antigues es deixara de donar suport segurament.

A mes les Airmax tenen suport per protocol N, es a dir millor velocitat
(ample de banda), basicament crec que aquestes son les diferencies mes
significatives.

</blockquote>

:*http://www.mail-archive.com/guifi-usuaris@llistes.projectes.lafarga.org/msg10719.html

=Configuració per a guifi.net=

Primer cal afegir un node a la web de [http://www.guifi.net guifi.net]. Consulteu l'article [[Exemple_pas_a_pas_de_muntatge_d'un_node_a_l'IES_Nicolau_Copèrnic]] per conèixer els detalls.

== Configuració de la nanostation amb unsolclic ==

Un cop tenim el node, els trastos i la radio i els enllaços creats, podem obtenir la configuració d'unsolclic. Trobareu una opció de menú al vostre node

Per exemple:

http://guifi.net/guifi/device/13636/view/unsolclic

Ha de ser quelcom similar a:

# Generat per a:
# AirOsv30

Click here to download configuration file for: TRSCEIPMariaGaliRd1
Put the mouse cursor over the link. Right click the link and select "Save Link/Target As..." to save to your Desktop.

# Configuration for AirOs> Unsolclic version:1.0.2 !! WARNING: Beta version !!
# Device: TRSCEIPMariaGaliRd1
#
# Methods to upload/execute the file:
# 1.- As a file. Upload this through web managment:
# a.System->Configuratuion Managment->Locate file
# b.Upload
# 2.- Telnet: Open a terminal session, create new /tmp/system.cfg file and cut&paste
# the contents of the file. Save it an execute the command:
#
# /usr/etc/rc.d/rc.softrestart save
#
# Notes:
# -Web access method is recommended
# (the script reconfigures some IP addresses, so communication can be lost.
# 192.168.1.1 will be the new one)
# -Changes are done in user passwords on the device, default user and password are
# changed to root/guifi.
# -The ACK is set to 45 for 802.11b mode, and to 25 for 802.11a (600 meters aprox,)
#
## Link to AP info
Ap SSID = guifi.net-TRSACprncRd1AP0
WAN Ip address = 10.139.60.34
WAN Netmask = 255.255.255.224
WAN Gateway = 10.139.60.33
Primary DNS Server = 10.139.7.162
Secondary DNS Server =
Device HostName = TRSCEIPMariaGaliRd1
IEEE 802.11 Mode: = B Only (2,4Ghz 11MB)

Tal i com es comenta teniu dos opcions per aplicar aquesta configuració. Per la web de la nanostation o per Telnet.

'''Configuració per la web'''

Primer de tot us heu de connectar al dispositiu. Els valors per defecte o de fàbrica de la nanostation són:

*'''IP''': 192.168.1.20
*'''Màscara''': 255.255.255.0
*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

Podeu utilitzar [[IP Aliasing]] per connectar-vos al dispositiu. Per exemple:

$ sudo ifconfig eth0:1 192.168.1.19 netmask 255.255.255.0 up

'''NOTA''': En aquest exemple suposem que la vostra interfície de xarxa és la eth0. Si no és així modifiqueu aquest valor per adaptar-lo al vostre cas.

Aneu a l'apartat:

System->Configuration Management

[[Imatge:NanostationGuifi.png|center]]
...
[[Imatge:NanostationGuifi1.png|center]]

I utilitzeu el boto '''Navega''' per localitzar el fitxer de configuració que voleu aplicar. El fitxer de configuració el trobareu a l'enllaç on posa:

'''Click here to download configuration file for''':

El podeu descarregar amb [[wget]]:

$ wget http://guifi.net/files/nanostation/TRSCEIPMariaGaliRd1.cfg

'''IMPORTANT''': En el cas de les nanostation el fitxer que cal aplicar és el '''.cfg'''!!!

Un cop heu indicat el fitxer feu clic a '''Upload'''. Per aplicar els canvis heu d'estar atents al missatge que sortira a la part superior de la pàgina web. Feu clic a '''Apply''' i espereu una estona a que s'apliquin els canvis:

[[Imatge:Nanostation4.jpg|center]]

'''NOTA IMPORTANT''': Tingueu en compte que aquesta IP és una IP molt comuna i que és molt possible que el vostre gateway tingui
la mateixa IP. Si voleu evitar problemes, canvieu aquesta adreça abans d'aplicar unsolclic al dispositiu.

Al aplicar un solclic, l'usuari i la paraula de pas passen a ser:

*'''Usuari''': root
*'''Paraula de pas''': guifi

També pot ser que la IP hagi canviat a '''192.168.1.1'''.

Consulteu també el document:

http://guifi.net/files/Manual_unsoclick_Nanostation.pdf

Per veure un pas a pas amb exemples de com pujar la configuració de guifi.net a una nanostation.

'''Configuració per Telnet'''

Connecteu-vos via Telnet:

$ telnet 192.168.1.20

Poseu l'usuari i paraula de pas de fàbrica del dispositiu (ubnt, ubnt). Un cop dins del dispositiu creeu el fitxer:

$ vi /tmp/system.cfg

I enganxeu el text d'un solclic. Un cop salveu el fitxer executeu:

$ /usr/etc/rc.d/rc.softrestart save

'''Recursos''':
*http://guifi.net/files/Manual_unsoclick_Nanostation.pdf

=Manual=

*http://wiki.ubnt.com/wiki/index.php/AirOS

= Protocol CDP =

[http://es.wikipedia.org/wiki/CDP Cisco Discovery Protocol].

$ sudo tcpdump
10:41:58.132091 CDPv1, ttl: 120s, Device-ID 'TRSCEIPMariaGaliRd1'[|cdp]
10:41:58.135969 CDPv1, ttl: 120s, Device-ID 'TRSCEIPMariaGaliRd1'[|cdp]
10:42:06.618809 IP 10.139.60.33 > 224.0.0.5: OSPFv2, Hello, length: 44

= Firmware recovery =

Aquesta secció us explica com recuperar el [[firmware]] original de la Nanostation, per exemple després d'haver posat un firware especific com [[DD-WRT]] o [[openwrt]].

El primer que us caldrà és una copia del firmware. Podeu saber quina versió del firmware teniu (o consultar en un altre nanostation si la vostra no té firmware) a l'apartat sistema de la nanostation (per exemple per una nano amb IP 192.168.1.101):

https://192.168.1.101/system.cgi

Veureu quelcom similar a:

XS2.ar2316.v3.5.4476.091013.1749

{{nota| En aquesta mateixa secció podríeu fer un upgrade/actualització de l'antena}}

Per obtenir una còpia del firmware original aneu a:

http://www.ubnt.com/support/downloads

Escolliu:

IEEE/802.11a/b/gSolutions, Nanostation 2 (o el model que busqueu)

I us baixeu l'última versió, actualment (--[[Usuari:Sergi|acacha]] 16:07, 12 oct 2010 (UTC)) la 3.5.1:

$ [[wget]] http://www.ubnt.com/downloads/NanoStation2-v3.5.1.build4631.bin

A més podeu comprovar la suma md5 ([[md5]]) amb:

$ [[md5sum]] NanoStation2-v3.5.1.build4631.bin
7e42fc6338356ec488f92c5d9b3d065c NanoStation2-v3.5.1.build4631.bin

Ha de coincidir amb la que posi a la web.

Ara connecteu la nanostation al POE per tal d'encendre-la i també a la vostra LAN. Un cop la tingueu preparada trèieu l'alimentació i premeu el botó de reset, manteniu-lo premut mentrestant torneu a connectar l'alimentació, si manteniu premut més de 8 segons la Nanostation començarà a parpadejar de forma intermitent els LEDS de cobertura (primers els 2 i el 4 i després el 1 i el 3).

Si ja teniu l'ordinador des de el que us volue connectar a la xarxa 192.168.1.0/24 només us cal comprovar que podeu fer un ping a la nano:

$ [[ping]] 192.168.1.20

Sinó podeu utilitzar [[IP Aliasing]]:

$ [[sudo]] [[ifconfig]] eth0:1 192.168.1.254

Ara necessiteu un client de [[FTP]] com [[tftp]] (Trivial FTP):

$ sudo [[apt-get]] install tftp

I pugeu el firmware:

$tftp 192.168.1.20
tftp> bin
tftp> trace
tftp> put XS2.ar2316.v3.4-rc.4351.090504.2146.bin
...
...
Sent 1965199 bytes in 35.2 seconds
tftp> quit

Durant el upload del firware s'aturaran de parpallejar els LEDS, anirant fent canvis. Cal deixar que els LEDS vagin canviant de un a un cada color durant uns 7-10 minuts depenent del dispositiu.

{{important|No atureu la corrent durant el procés d'actualització}}

Quan acabi només quedaran encesos els LEDS PWR i LAN i podeu accedir a la nanostation amb la [[Nanostation#Par.C3.A0metres_de_fabrica|configuració de fabrica]].

:*http://www.ubnt.com/wiki/Firmware_Recovery
:*http://www.ubnt.com/wiki/Recuperar_firmware

= Construcció de firmware =
Ubiquity posa a disposició pública l'SDK per tal que pugam reconstruir una imatge després d'haver fet canvis, com ara afegir serveis, eliminar mòduls que no s'usen per tal de que el catxarro siga més eficient o simplement modificar el programari per defecte.

A la web oficial es pot baixar l'SDK corresponent a la versió del nostre catxarro: http://ubnt.com/support/downloads.

{{nota| a la secció [[Firmware recovery]] trobareu com restaurar un catxarro que no arranca amb una firmware customitzat}}

== Exemple de reconstrucció del firmware ==

=== AirMax ISP Solutions ===
Es correspon amb la sèrie més moderna dels productes de Ubiquity. Veurem com podem afegir ''openvpn'' a la nostra antena, el mateix o molt paregut procediment seguirem per afegir ''quagga'' o d'altres.

Hi ha dos mètodes per generar una imatge:
<ol>
<li> Seguir les instruccions del fabricant, que diu, una vegada descomprimit el paquet a ''readme.txt'':
<pre>
Step by step instructions
-------------------------

1. Extract files

$ tar xjvf SDK.UBNT.v5.3.tar.bz2

2. Build

$ cd SDK.UBNT.v5.3/openwrt
$ make

3. Look for firmware file (with prefix XM) in openwrt/bin/.

Good luck!
</pre>
Amb la versió 5.3 no hem pogut generar una imatge vàlida, donat que li falta el ''bootloader u-boot'', tal com veurem al desmuntar una imatge de fàbrica al següent mètode. Per este motiu ens dessitgen ''Good luck''.</li>
<li>
A partir d'una imatge oficial. En este cas, haurem de seguir els pasos anteriors amb la intenció d'obtindre les eines que ens ajudaran a modificar una imatge, i que són: ''fwsplit'', ''unsquashfs'', ''mksquashfs'' i ''mkfwimage''. És important usar estes eines enlloc de les que podrem trobar en les nostres distros de linux donat que, per exemple, el ''mksquashfs'' disposa d'una opció per escollir l'endiannicitat (Big Endian en el cas d'ubiquity, a banda d'altres característiques) del sistema d'arxius, i que no es troba en altres versions.
<ul>
<li>Una vegada compilat un firmware amb el SDK disposem de les eines bàsiques:
<pre>
SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/fwsplit
SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/mksquashfs
SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/unsquashfs
SDK.UBNT.v5.3/openwrt/build_dir/host/firmware-utils/bin/mkfwimage
</pre>
</li>
<li>Sobre el firmware original, desmuntem l'imatge:
<pre>$ SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/fwsplit XM-v5.3.2.build8909.bin
Firmware file: 'XM-v5.3.2.build8909.bin'
Firmware version: 'XM.ar7240.v5.3.2.8909.110429.1745'
Creating descriptor file:
XM.ar7240.v5.3.2.8909.110429.1745.txt
Creating partition data files:
XM.ar7240.v5.3.2.8909.110429.1745.u-boot
XM.ar7240.v5.3.2.8909.110429.1745.kernel
XM.ar7240.v5.3.2.8909.110429.1745.rootfs
</pre>
Tenim 4 arxius addicionals: la descripció (XM.ar7240.v5.3.2.8909.110429.1745.txt), el bootloader (XM.ar7240.v5.3.2.8909.110429.1745.u-boot), el nucli (XM.ar7240.v5.3.2.8909.110429.1745.kernel) i el sistema d'arxius (XM.ar7240.v5.3.2.8909.110429.1745.rootfs) comprimit amb format squashfs i ordenació big endian.
És justament el bootloader el que no es troba a l'imatge generada al seguir els passos del fabricant.
</li>
<li>Descomprimim el sistema d'arxius:
<pre>
$ SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/unsquashfs XM.ar7240.v5.3.2.8909.110429.1745.rootfs
Reading a different endian SQUASHFS filesystem on XM.ar7240.v5.3.2.8909.110429.1745.rootfs

created 838 files
created 59 directories
created 222 symlinks
created 0 devices
created 0 fifos
</pre>
Al directori ''squashfs-root'' ja tenim tot el sistema d'arxius de manera que ja podem furgar-lo un poc. En este cas volem afegir suport per a ''openvpn''. Aquest paquet te dependències de la llibreria de compressió en temps real ''lzo''. En este cas ens resultarà fàcil afegir aquest client/dimoni, donat que ja esta inclós a l'SDK, en altres casos haurem d'adaptar el programari a aquesta distribució d'openwrt en què es basa el firmware d'ubiquity (a la sèrie M5).
</li>
<li> Compilem el suport per a ''openvpn'' a l'SDK. Per això hem d'incloure les següents línees a l'arxiu ''SDK.UBNT.v5.3/openwrt/.config'':
<pre>
# A la mateixa secció que tcpdump:
CONFIG_PACKAGE_openvpn=y

# A la mateixa secció que libfuse:
CONFIG_PACKAGE_liblzo=y
</pre>
Seguidament copiem els fonts a la rama del SDK on es compilen els paquets:
<pre>
cp -a SDK.UBNT.v5.3/openwrt/feeds/packages/libs/lzo/ SDK.UBNT.v5.3/openwrt/package/
cp -a SDK.UBNT.v5.3/openwrt/feeds/packages/net/openvpn/ SDK.UBNT.v5.3/openwrt/package/
</pre>
I tornem a compil.lar la imatge, però abans reconfigurem per tal que s'incloguen els nous paquets:
<pre>
$ cd SDK.UBNT.v5.3/openwrt
$ make
</pre>
</li>
</ul>
</li>
</ol>

=== IEEE802.11a/b/g Solutions ===
[http://rotobator.es/2009/03/26/de-nanos-picos-y-air-os-parte-i/ Aquí] trobareu info sobre aquests aparells un poc més antics.

=Resolució de problemes i preguntes freqüents=

== Polarització horitzontal a nanostation Loco ==

Sembla que és habitual que unsolclic deixi les antenes Loco configurades amb polarització horizontal. Si el supernode al que connectem està en polarització vertical (lo habitual en sectorials) cal canviar-ho i millorarà molt la senyal.

== Com canviar la IP 192.168.1.1 per una altre que no xoqui amb les IPs tradicionals dels routers ADSL? ==

Dos opcions:

1) Ho podeu fer al propi unsolclic abans d'aplicar el fitxer, busqueu la línia '''netconf.1.ip=192.168.1.1''' i canvieu la IP a, p. ex., 192.168.1.100

2) Desconnecteu el router ADSL i connecteu només la nanostation. Tingueu en compte els problemes que podeu tenir amb la [[#Problemes_amb_la_cache_ARP_de_Windows_i_la_IP_192.168.1.1 | cache ARP de Windows]]. Utilitzant Firefox, connecteu-vos a l'adreça:

http://192.168.1.1

Poseu la paraula de pas i usuauri (per defecte usuari:root i password:guifi) i aneu a la secció '''Network'''. Més avall a '''LAN Network Settings''' podeu canviar la IP adress, Guardeu i apliqueu els canvis.

Potser també us interessarà saber com:

:*[[#Desactivar DHCP|Desactivar DHCP]]
:*[[#Afegir ruta estàtica permanent a Windows|Afegir ruta estàtica a Windows]]

Consulteu també:

http://www.iesebre.com/manteniment/index.php/Guifi.net/Com_Connectar-se_a_la_xarxa_en_3_passos#Que_cal_tindr.C3.A9_en_compte_per_compartir_la_connexi.C3.B3_d.27un_operadora_i_la_de_guifi_al_mateix_temps

== Desactivar DHCP ==

[[Nanostation#Com_connectar-s.27hi.3F|Connecteu-vos via web a la nanostation]] i dirigiu-vos a la pestanya '''Network''' i després a la secció. desmarque l'opció:

Enable DHCP Server:

Ara feu clic a '''Change''' (botó que apareix a la part inferior de la pàgina) i apliqueu els canvis (botó que apareixerà a la part superior).

== Afegir ruta estàtica permanent a Linux o Windows ==

Consulteu:

http://www.iesebre.com/manteniment/index.php/Guifi.net/Com_Connectar-se_a_la_xarxa_en_3_passos#Afegir_ruta_est.C3.A0tica_per_compartir_guifi.net_i_l.C3.ADnia_ADSL

Aquesta configuració us permet poder accedir al mateix temps a la xarxa guifi i a la connexió a Internet de casa vostra.

== Problemes amb la cache ARP de Windows i la IP 192.168.1.1 ==

La cache ARP del sistema operatiu Windows, es guarda en local les MAC de les adreces IP amb les qual ha contactat fa poc. Podeu consultar la taula amb l'ordre (obriu una línia de comandes de 2):

C:\ arp -a

Veureu que per a la IP 192.168.1.1 teniu la MAC del vostre router ADSL si fa poc que hi estàveu connectats. Si ara desconnecteu el router ADSL i poseu la nanostation, els sistema operatiu no es podrà connectar amb la nanostation fins que aquesta cache s'esborri i s'actualitzi (poden passar diversos minuts, segons els [http://www.windowsreference.com/windows-2000/how-to-clear-arp-cache-in-windows-vistaxp20032000/ tipus de sistema operatiu Windows que tingueu]). Podeu forçar aquest canvi anant a propietats de la connexió i '''Reparant la connexió''' o amb l'ordre:

C:\ netsh interface ip delete arpcache

Vegeu també:
:*http://www.tech-faq.com/clear-arp-cache.html
:*[[ARP]]

== Afegir una ruta estàtica ==

/etc/persistent/rc.poststart

# cfgmtd -w -p /etc/

Try editing cfg file http://ubnt.com/forum/viewtopic.php?t=3939
or adding your static routes to /etc/persistent/rc.poststart
and run command "cfgmtd -w -p /etc/" to write into flash...

==Com fer un reset de la nanostation?==

A les nanostation, desconnecteu el cable de xarxa que proporciona l'alimentació per [[PoE]], premeu durant uns quants segons el boto de '''Reset''' mentrestant torneu a connectar el cable . Això torna la Nanostation a la [[Nanostation#Par.C3.A0metres_de_fabrica| configuració per defecte de fàbrica]].

{{important|No premeu el reset durant molta estona (8 o més segons) que si no d'aquesta manera iniciaríeu el procés de [[#Firmware recovery |firmware recovery]]}}

==Com saber les MAC de la nanostation?==

A l'apartat '''Main''', podeu consultar les MAC:

[[Imatge:Nanostation2.jpg|center]]

Hi ha una MAC de la connexió amb fil (LAN) i una de la WAN.

'''NOTA''': La MAC de la WLAN també apareix a la etiqueta que hi ha sota el connector RJ-45

==Quina és la MAC que apareix a l'etiqueta sota el connector LAN RJ-45? ==

És la MAC de la WLAN.

==Com activar l'accés Telnet==

A l'apartat '''Services'''

http://192.168.1.20/services.cgi

Activeu el Telnet a la secció '''Telnet Server''':

[[Imatge:Nanostation3.jpg|center]]

Per aplicar els canvis heu d'estar atents al missatge que sortira a la part superior de la pàgina web. Feu clic a '''Apply''' i espereu una estona a que s'apliquin els canvis:

[[Imatge:Nanostation4.jpg|center]]

==No em puc connectar a la nanostation després d'aplicar la configuració d'unsolclic==

Després d'aplicar la configuració d'unsolclic no em puc connectar al router. La nanostation existeix però estan tots els ports filtrats tal i com es pot veure amb nmap:

$ sudo nmap 192.168.1.1-255

Starting Nmap 4.53 ( http://insecure.org ) at 2009-02-25 18:15 CET
'''All 1714 scanned ports on 192.168.1.1 are filtered'''
MAC Address: 00:15:6D:AE:70:EE (Ubiquiti Networks)

==Com buscar xarxes WIFI amb nanostation==

Consulteu el document:

http://guifi.net/files/buscar_senyal_nanostation.pdf

Aneu a l'apartat '''Link setup''' i marqueu com a país '''Espanya'''. Feu clic al '''Select''' que hi ha al costat del '''ESSID'''.

[[Imatge:Nanostation5.jpg|center]]

==Consultar la versió del firmware==

Aneu a l'apartat '''System''' i consulteu la secció '''Firmware'''

[[Imatge:Nanostation6.jpg|center]]

Per exemple:

NS2.ar2316.v2.2.1.2476.080208.1627

Correspon a una versió 2.x d'AirOs.

==Com fer un upgrade del firmware==

Aneu a l'apartat '''System''' i a la secció '''Firmware''' feu clic al boto '''upgrade'''

El firmware el podeu obtenir de la pàgina de suport de ubiquiti:

http://www.ubnt.com/support/ns2.php

Si no funciona:

http://www.ubnt.com/support/downloads

Per exemple per descarregar l'última versió (--[[Usuari:Sergi|acacha]] 16:54, 24 maig 2010 (UTC)):

http://www.ubnt.com/downloads/NanoStation2-v3.5.build4494.bin

Nanostation comprades durant el maig de 2010 venen amb:

NS2.ar2316.v3.5.4494.091109.1451

----

Exemple àntic, guardat només com a referència.

Per exemple per descarregar l'última versió (--[[Usuari:Sergi|acacha]] 19:57, 25 febr 2009 (CET)):

$ wget http://www.ubnt.com/downloads/XS-fw/v3.3.1/NS2.ar2316.v3.3.1.4227.090128.1828.bin

==OpenWRT==

:*http://intoverflow.wordpress.com/2008/11/14/openwrt-and-ubiquiti-nanostation-2/
:*http://www.ubnt.com/downloads/PS2.ar2316.OpenWRT-kamikaze.v7.09.bin

==Recuperar el firmware==

:*http://www.ubnt.com/wiki/index.php?title=Firmware_Recovery

=Recursos=

*http://www.ubnt.com/products/ns2.php
*http://wiki.ubnt.com/wiki/index.php/AirOS

[[categoria:router]]

Ubiquity Nanostation

2011-07-21T17:36:18Z

Rotobator: /* Firmware recovery */

=Nanostation 2=

*Freqüència: 2.4Ghz
*Guany: 10dBi
*Distàncies: Fins a 15Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Nanostation loco 2==

Pensada per a distàncies menors, és més barata i petita:

*Freqüència: 2.4Ghz
*Guany: 8dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Documentació oficial==

*[http://www.ubnt.com/downloads/ns2_datasheet.pdf NS2 Datasheet]
*[http://www.ubnt.com/support/ns2.php NS2 Pàgina de suport]
*[http://www.ubnt.com/downloads/loco2_datasheet.pdf NSloco2 Datasheet]
*[http://www.ubnt.com/products/loco.php NSloco Pàgina de suport]

==Paràmetres de fabrica==

Tal i com posa a la caixa:

*'''IP''': 192.168.1.20
*'''Màscara''': 255.255.255.0
*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

==Com connectar-s'hi?==

Amb Linux, podeu utilitzar [[IP Aliasing]] per a connectar-vos a la nanostation sense perdre la vostra connexió a Internet. A una terminal, escriviu:

$ sudo ifconfig eth0:1 192.168.1.25 netmask 255.255.255.0 up

'''NOTA''': Si la vostra xarxa ja és la 192.168.1.x no cal que feu cap d'aquests passos i us hi podeu connectar directament. Vigileu que no tingueu la
mala sort de ja tenir una màquina amb la IP 192.168.1.20 a la vostra xarxa

Hem escollir la IP 192.168.1.25 perquè és una de les IP lliures de la xarxa lògica on està connectada la nanostation. Amb:

$ ipcalc 192.168.1.20/255.255.255.0
Address: 192.168.1.20 11000000.10101000.00000001. 00010100
Netmask: 255.255.255.0 = 24 11111111.11111111.11111111. 00000000
Wildcard: 0.0.0.255 00000000.00000000.00000000. 11111111
=>
Network: 192.168.1.0/24 11000000.10101000.00000001. 00000000
'''HostMin''': 192.168.1.1 11000000.10101000.00000001. 00000001
'''HostMax''': 192.168.1.254 11000000.10101000.00000001. 11111110
Broadcast: 192.168.1.255 11000000.10101000.00000001. 11111111
Hosts/Net: 254 Class C, Private Internet

Podeu obtenir la informació de la xarxa. Qualsevol valor entre HostMin i HostMax que no estigui sent utilitzat (per exemple no podeu utilitzar la IP de la nanostation 192.168.1.20) és un valor vàlid.

Comproveu que la interfície s'ha creat correctament:

$ ifconfig eth0:1
eth0:1 Link encap:Ethernet HWaddr 00:30:05:eb:a3:8d
inet addr:192.168.1.25 Bcast:192.168.1.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
Interrupt:20 Base address:0xa000

I feu un ping a la nanostation per veure si contesta:

$ ping 192.168.1.20
PING 192.168.1.20 (192.168.1.20) 56(84) bytes of data.
64 bytes from 192.168.1.20: icmp_seq=1 ttl=64 time=2.41 ms
...

Ara ja podeu connectar-vos amb el vostre navegador posant a la URL:

http://192.168.1.20

[[Imatge:Nanostation1.jpg|center]]

La paraula de pas i l'usuari són:

*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

===Resolució de problemes en la connexió===

Comproveu que s'ha creat la interfície virtual amb

$ ifconfig eth0:1

Potser la vostra interfície de xarxa no és la eth0?

Comproveu que s'ha creat una ruta que us permeti connectar al dispositiu:

$ route -n
Kernel IP routing table
Destination Gateway Genmask Flags Metric Ref Use Iface
'''192.168.1.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0'''
192.168.12.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0
169.254.0.0 0.0.0.0 255.255.0.0 U 1000 0 0 eth0
0.0.0.0 192.168.12.1 0.0.0.0 UG 100 0 0 eth0

També podeu provar si la URL funciona correctament amb:

$ wget http://192.168.1.20

O fer un escànner de ports amb:

$ sudo nmap 192.168.1.20

Starting Nmap 4.53 ( http://insecure.org ) at 2009-02-25 16:56 CET
Interesting ports on 192.168.1.20:
Not shown: 1712 closed ports
PORT STATE SERVICE
23/tcp open telnet
80/tcp open http
MAC Address: 00:15:6D:AD:70:EE (Ubiquiti Networks)

Com podeu veure també es possible accedir al dispositiu amb Telnet (només si ho heu activat des de la web de nanostation)

'''NOTA''': Qualsevol comanda que no tingueu (com nmap o ipcalc) la podeu instal·lar amb:

$ sudo apt-get install comanda_que_teniu

=Nanostation 5=

*Freqüència: 5Ghz
*Guany: 8dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 1Mbps a 54mbps segons la distància

==Nanostation loco 5==

Pensada per a distàncies menors, és més barata i petita:

*Freqüència: 5Ghz
*Guany: 13dBi
*Distàncies: Fins a 5Km (segons fabricant)
*Velocitats de transmissió: De 6Mbps a 54mbps segons la distància

==Documentació oficial==

*http://www.ubnt.com/products/nano.php
*[http://www.ubnt.com/downloads/ns5_datasheet.pdf NS5 datasheet]
*[http://www.ubnt.com/downloads/loco5_datasheet.pdf NSloco5 datasheet]
*[http://www.ubnt.com/products/loco.php NSloco Pàgina de suport]

= Nanostation Mimo (M)=

<blockquote>
Les Mimo son Airmax, es a dir porten el firmware Airos 5.2, molt mes
avançat, suporten WDS (ho he provat), tenen mes potencia d'emissio, i son
mes mones....

A mes pensem que el suport a noves versions es per Airos 5.2, mentres que
les versions antigues es deixara de donar suport segurament.

A mes les Airmax tenen suport per protocol N, es a dir millor velocitat
(ample de banda), basicament crec que aquestes son les diferencies mes
significatives.

</blockquote>

:*http://www.mail-archive.com/guifi-usuaris@llistes.projectes.lafarga.org/msg10719.html

=Configuració per a guifi.net=

Primer cal afegir un node a la web de [http://www.guifi.net guifi.net]. Consulteu l'article [[Exemple_pas_a_pas_de_muntatge_d'un_node_a_l'IES_Nicolau_Copèrnic]] per conèixer els detalls.

== Configuració de la nanostation amb unsolclic ==

Un cop tenim el node, els trastos i la radio i els enllaços creats, podem obtenir la configuració d'unsolclic. Trobareu una opció de menú al vostre node

Per exemple:

http://guifi.net/guifi/device/13636/view/unsolclic

Ha de ser quelcom similar a:

# Generat per a:
# AirOsv30

Click here to download configuration file for: TRSCEIPMariaGaliRd1
Put the mouse cursor over the link. Right click the link and select "Save Link/Target As..." to save to your Desktop.

# Configuration for AirOs> Unsolclic version:1.0.2 !! WARNING: Beta version !!
# Device: TRSCEIPMariaGaliRd1
#
# Methods to upload/execute the file:
# 1.- As a file. Upload this through web managment:
# a.System->Configuratuion Managment->Locate file
# b.Upload
# 2.- Telnet: Open a terminal session, create new /tmp/system.cfg file and cut&paste
# the contents of the file. Save it an execute the command:
#
# /usr/etc/rc.d/rc.softrestart save
#
# Notes:
# -Web access method is recommended
# (the script reconfigures some IP addresses, so communication can be lost.
# 192.168.1.1 will be the new one)
# -Changes are done in user passwords on the device, default user and password are
# changed to root/guifi.
# -The ACK is set to 45 for 802.11b mode, and to 25 for 802.11a (600 meters aprox,)
#
## Link to AP info
Ap SSID = guifi.net-TRSACprncRd1AP0
WAN Ip address = 10.139.60.34
WAN Netmask = 255.255.255.224
WAN Gateway = 10.139.60.33
Primary DNS Server = 10.139.7.162
Secondary DNS Server =
Device HostName = TRSCEIPMariaGaliRd1
IEEE 802.11 Mode: = B Only (2,4Ghz 11MB)

Tal i com es comenta teniu dos opcions per aplicar aquesta configuració. Per la web de la nanostation o per Telnet.

'''Configuració per la web'''

Primer de tot us heu de connectar al dispositiu. Els valors per defecte o de fàbrica de la nanostation són:

*'''IP''': 192.168.1.20
*'''Màscara''': 255.255.255.0
*'''Usuari''': ubnt
*'''Paraula de pas''': ubnt

Podeu utilitzar [[IP Aliasing]] per connectar-vos al dispositiu. Per exemple:

$ sudo ifconfig eth0:1 192.168.1.19 netmask 255.255.255.0 up

'''NOTA''': En aquest exemple suposem que la vostra interfície de xarxa és la eth0. Si no és així modifiqueu aquest valor per adaptar-lo al vostre cas.

Aneu a l'apartat:

System->Configuration Management

[[Imatge:NanostationGuifi.png|center]]
...
[[Imatge:NanostationGuifi1.png|center]]

I utilitzeu el boto '''Navega''' per localitzar el fitxer de configuració que voleu aplicar. El fitxer de configuració el trobareu a l'enllaç on posa:

'''Click here to download configuration file for''':

El podeu descarregar amb [[wget]]:

$ wget http://guifi.net/files/nanostation/TRSCEIPMariaGaliRd1.cfg

'''IMPORTANT''': En el cas de les nanostation el fitxer que cal aplicar és el '''.cfg'''!!!

Un cop heu indicat el fitxer feu clic a '''Upload'''. Per aplicar els canvis heu d'estar atents al missatge que sortira a la part superior de la pàgina web. Feu clic a '''Apply''' i espereu una estona a que s'apliquin els canvis:

[[Imatge:Nanostation4.jpg|center]]

'''NOTA IMPORTANT''': Tingueu en compte que aquesta IP és una IP molt comuna i que és molt possible que el vostre gateway tingui
la mateixa IP. Si voleu evitar problemes, canvieu aquesta adreça abans d'aplicar unsolclic al dispositiu.

Al aplicar un solclic, l'usuari i la paraula de pas passen a ser:

*'''Usuari''': root
*'''Paraula de pas''': guifi

També pot ser que la IP hagi canviat a '''192.168.1.1'''.

Consulteu també el document:

http://guifi.net/files/Manual_unsoclick_Nanostation.pdf

Per veure un pas a pas amb exemples de com pujar la configuració de guifi.net a una nanostation.

'''Configuració per Telnet'''

Connecteu-vos via Telnet:

$ telnet 192.168.1.20

Poseu l'usuari i paraula de pas de fàbrica del dispositiu (ubnt, ubnt). Un cop dins del dispositiu creeu el fitxer:

$ vi /tmp/system.cfg

I enganxeu el text d'un solclic. Un cop salveu el fitxer executeu:

$ /usr/etc/rc.d/rc.softrestart save

'''Recursos''':
*http://guifi.net/files/Manual_unsoclick_Nanostation.pdf

=Manual=

*http://wiki.ubnt.com/wiki/index.php/AirOS

= Protocol CDP =

[http://es.wikipedia.org/wiki/CDP Cisco Discovery Protocol].

$ sudo tcpdump
10:41:58.132091 CDPv1, ttl: 120s, Device-ID 'TRSCEIPMariaGaliRd1'[|cdp]
10:41:58.135969 CDPv1, ttl: 120s, Device-ID 'TRSCEIPMariaGaliRd1'[|cdp]
10:42:06.618809 IP 10.139.60.33 > 224.0.0.5: OSPFv2, Hello, length: 44

= Firmware recovery =

Aquesta secció us explica com recuperar el [[firmware]] original de la Nanostation, per exemple després d'haver posat un firware especific com [[DD-WRT]] o [[openwrt]].

El primer que us caldrà és una copia del firmware. Podeu saber quina versió del firmware teniu (o consultar en un altre nanostation si la vostra no té firmware) a l'apartat sistema de la nanostation (per exemple per una nano amb IP 192.168.1.101):

https://192.168.1.101/system.cgi

Veureu quelcom similar a:

XS2.ar2316.v3.5.4476.091013.1749

{{nota| En aquesta mateixa secció podríeu fer un upgrade/actualització de l'antena}}

Per obtenir una còpia del firmware original aneu a:

http://www.ubnt.com/support/downloads

Escolliu:

IEEE/802.11a/b/gSolutions, Nanostation 2 (o el model que busqueu)

I us baixeu l'última versió, actualment (--[[Usuari:Sergi|acacha]] 16:07, 12 oct 2010 (UTC)) la 3.5.1:

$ [[wget]] http://www.ubnt.com/downloads/NanoStation2-v3.5.1.build4631.bin

A més podeu comprovar la suma md5 ([[md5]]) amb:

$ [[md5sum]] NanoStation2-v3.5.1.build4631.bin
7e42fc6338356ec488f92c5d9b3d065c NanoStation2-v3.5.1.build4631.bin

Ha de coincidir amb la que posi a la web.

Ara connecteu la nanostation al POE per tal d'encendre-la i també a la vostra LAN. Un cop la tingueu preparada trèieu l'alimentació i premeu el botó de reset, manteniu-lo premut mentrestant torneu a connectar l'alimentació, si manteniu premut més de 8 segons la Nanostation començarà a parpadejar de forma intermitent els LEDS de cobertura (primers els 2 i el 4 i després el 1 i el 3).

Si ja teniu l'ordinador des de el que us volue connectar a la xarxa 192.168.1.0/24 només us cal comprovar que podeu fer un ping a la nano:

$ [[ping]] 192.168.1.20

Sinó podeu utilitzar [[IP Aliasing]]:

$ [[sudo]] [[ifconfig]] eth0:1 192.168.1.254

Ara necessiteu un client de [[FTP]] com [[tftp]] (Trivial FTP):

$ sudo [[apt-get]] install tftp

I pugeu el firmware:

$tftp 192.168.1.20
tftp> bin
tftp> trace
tftp> put XS2.ar2316.v3.4-rc.4351.090504.2146.bin
...
...
Sent 1965199 bytes in 35.2 seconds
tftp> quit

Durant el upload del firware s'aturaran de parpallejar els LEDS, anirant fent canvis. Cal deixar que els LEDS vagin canviant de un a un cada color durant uns 7-10 minuts depenent del dispositiu.

{{important|No atureu la corrent durant el procés d'actualització}}

Quan acabi només quedaran encesos els LEDS PWR i LAN i podeu accedir a la nanostation amb la [[Nanostation#Par.C3.A0metres_de_fabrica|configuració de fabrica]].

:*http://www.ubnt.com/wiki/Firmware_Recovery
:*http://www.ubnt.com/wiki/Recuperar_firmware

= Construcció de firmware =
Ubiquity posa a disposició pública l'SDK per tal que pugam reconstruir una imatge després d'haver fet canvis, com ara afegir serveis, eliminar mòduls que no s'usen per tal de que el catxarro siga més eficient o simplement modificar el programari per defecte.

A la web oficial es pot baixar l'SDK corresponent a la versió del nostre catxarro: http://ubnt.com/support/downloads.

{{nota| a la secció [[Firmware recovery]] trobareu com restaurar un catxarro que no arranca amb una firmware customitzat}}

== Exemple de reconstrucció del firmware ==

=== AirMax ISP Solutions ===
Es correspon amb la sèrie més moderna dels productes de Ubiquity. Veurem com podem afegir ''openvpn'' a la nostra antena, el mateix o molt paregut procediment seguirem per afegir ''quagga'' o d'altres.

Hi ha dos mètodes per generar una imatge:
<ol>
<li> Seguir les instruccions del fabricat, que diu, una vegada descomprimit el paquet a ''readme.txt'':
<pre>
Step by step instructions
-------------------------

1. Extract files

$ tar xjvf SDK.UBNT.v5.3.tar.bz2

2. Build

$ cd SDK.UBNT.v5.3/openwrt
$ make

3. Look for firmware file (with prefix XM) in openwrt/bin/.

Good luck!
</pre>
Amb la versió 5.3 no hem pogut generar una imatge vàlida, donat que li falta el ''bootloader u-boot'', tal com veurem al desmuntar una imatge de fàbrica al següent mètode.</li>
<li>
A partir d'una imatge oficial. En este cas, haurem de seguir els pasos anteriors amb la intenció d'obtindre les eines que ens ajudaran a modificar una imatge, i que són: ''fwsplit'', ''unsquashfs'', ''mksquashfs'' i ''mkfwimage''. És important usar estes eines enlloc de les que podrem trobar en les nostres distros de linux donat que, per exemple, el ''mksquashfs'' disposa d'una opció per escollir l'endiannicitat (Big Endian en el cas d'ubiquity, a banda d'altres característiques) del sistema d'arxius, i que no es troba en altres versions.
<ul>
<li>Una vegada compilat un firmware amb el SDK disposem de les eines bàsiques:
<pre>
SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/fwsplit
SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/mksquashfs
SDK.UBNT.v5.3/openwrt/build_dir/host/squashfs3.0/squashfs-tools/unsquashfs
SDK.UBNT.v5.3/openwrt/build_dir/host/firmware-utils/bin/mkfwimage
</pre>
</li>
<li>Sobre el firmware original, desmuntem l'imatge:
<pre>$ SDK.UBNT.v5.3/openwrt/build_dir/host/ubnt-mkfwimage/fwsplit XM-v5.3.2.build8909.bin
Firmware file: 'XM-v5.3.2.build8909.bin'
Firmware version: 'XM.ar7240.v5.3.2.8909.110429.1745'
Creating descriptor file:
XM.ar7240.v5.3.2.8909.110429.1745.txt
Creating partition data files:
XM.ar7240.v5.3.2.8909.110429.1745.u-boot
XM.ar7240.v5.3.2.8909.110429.1745.kernel
XM.ar7240.v5.3.2.8909.110429.1745.rootfs
</pre>
Tenim 4 arxius addicionals: la descripció (XM.ar7240.v5.3.2.8909.110429.1745.txt), el bootloader (XM.ar7240.v5.3.2.8909.110429.1745.u-boot), el nucli (XM.ar7240.v5.3.2.8909.110429.1745.kernel) i el sistema d'arxius (XM.ar7240.v5.3.2.8909.110429.1745.rootfs) comprimit amb format squashfs i ordenació big endian.
</li>
</ul>
</li>
</ol>

=== IEEE802.11a/b/g Solutions ===
[http://rotobator.es/2009/03/26/de-nanos-picos-y-air-os-parte-i/ Aquí] trobareu info sobre aquests aparells un poc més antics.

=Resolució de problemes i preguntes freqüents=

== Polarització horitzontal a nanostation Loco ==

Sembla que és habitual que unsolclic deixi les antenes Loco configurades amb polarització horizontal. Si el supernode al que connectem està en polarització vertical (lo habitual en sectorials) cal canviar-ho i millorarà molt la senyal.

== Com canviar la IP 192.168.1.1 per una altre que no xoqui amb les IPs tradicionals dels routers ADSL? ==

Dos opcions:

1) Ho podeu fer al propi unsolclic abans d'aplicar el fitxer, busqueu la línia '''netconf.1.ip=192.168.1.1''' i canvieu la IP a, p. ex., 192.168.1.100

2) Desconnecteu el router ADSL i connecteu només la nanostation. Tingueu en compte els problemes que podeu tenir amb la [[#Problemes_amb_la_cache_ARP_de_Windows_i_la_IP_192.168.1.1 | cache ARP de Windows]]. Utilitzant Firefox, connecteu-vos a l'adreça:

http://192.168.1.1

Poseu la paraula de pas i usuauri (per defecte usuari:root i password:guifi) i aneu a la secció '''Network'''. Més avall a '''LAN Network Settings''' podeu canviar la IP adress, Guardeu i apliqueu els canvis.

Potser també us interessarà saber com:

:*[[#Desactivar DHCP|Desactivar DHCP]]
:*[[#Afegir ruta estàtica permanent a Windows|Afegir ruta estàtica a Windows]]

Consulteu també:

http://www.iesebre.com/manteniment/index.php/Guifi.net/Com_Connectar-se_a_la_xarxa_en_3_passos#Que_cal_tindr.C3.A9_en_compte_per_compartir_la_connexi.C3.B3_d.27un_operadora_i_la_de_guifi_al_mateix_temps

== Desactivar DHCP ==

[[Nanostation#Com_connectar-s.27hi.3F|Connecteu-vos via web a la nanostation]] i dirigiu-vos a la pestanya '''Network''' i després a la secció. desmarque l'opció:

Enable DHCP Server:

Ara feu clic a '''Change''' (botó que apareix a la part inferior de la pàgina) i apliqueu els canvis (botó que apareixerà a la part superior).

== Afegir ruta estàtica permanent a Linux o Windows ==

Consulteu:

http://www.iesebre.com/manteniment/index.php/Guifi.net/Com_Connectar-se_a_la_xarxa_en_3_passos#Afegir_ruta_est.C3.A0tica_per_compartir_guifi.net_i_l.C3.ADnia_ADSL

Aquesta configuració us permet poder accedir al mateix temps a la xarxa guifi i a la connexió a Internet de casa vostra.

== Problemes amb la cache ARP de Windows i la IP 192.168.1.1 ==

La cache ARP del sistema operatiu Windows, es guarda en local les MAC de les adreces IP amb les qual ha contactat fa poc. Podeu consultar la taula amb l'ordre (obriu una línia de comandes de 2):

C:\ arp -a

Veureu que per a la IP 192.168.1.1 teniu la MAC del vostre router ADSL si fa poc que hi estàveu connectats. Si ara desconnecteu el router ADSL i poseu la nanostation, els sistema operatiu no es podrà connectar amb la nanostation fins que aquesta cache s'esborri i s'actualitzi (poden passar diversos minuts, segons els [http://www.windowsreference.com/windows-2000/how-to-clear-arp-cache-in-windows-vistaxp20032000/ tipus de sistema operatiu Windows que tingueu]). Podeu forçar aquest canvi anant a propietats de la connexió i '''Reparant la connexió''' o amb l'ordre:

C:\ netsh interface ip delete arpcache

Vegeu també:
:*http://www.tech-faq.com/clear-arp-cache.html
:*[[ARP]]

== Afegir una ruta estàtica ==

/etc/persistent/rc.poststart

# cfgmtd -w -p /etc/

Try editing cfg file http://ubnt.com/forum/viewtopic.php?t=3939
or adding your static routes to /etc/persistent/rc.poststart
and run command "cfgmtd -w -p /etc/" to write into flash...

==Com fer un reset de la nanostation?==

A les nanostation, desconnecteu el cable de xarxa que proporciona l'alimentació per [[PoE]], premeu durant uns quants segons el boto de '''Reset''' mentrestant torneu a connectar el cable . Això torna la Nanostation a la [[Nanostation#Par.C3.A0metres_de_fabrica| configuració per defecte de fàbrica]].

{{important|No premeu el reset durant molta estona (8 o més segons) que si no d'aquesta manera iniciaríeu el procés de [[#Firmware recovery |firmware recovery]]}}

==Com saber les MAC de la nanostation?==

A l'apartat '''Main''', podeu consultar les MAC:

[[Imatge:Nanostation2.jpg|center]]

Hi ha una MAC de la connexió amb fil (LAN) i una de la WAN.

'''NOTA''': La MAC de la WLAN també apareix a la etiqueta que hi ha sota el connector RJ-45

==Quina és la MAC que apareix a l'etiqueta sota el connector LAN RJ-45? ==

És la MAC de la WLAN.

==Com activar l'accés Telnet==

A l'apartat '''Services'''

http://192.168.1.20/services.cgi

Activeu el Telnet a la secció '''Telnet Server''':

[[Imatge:Nanostation3.jpg|center]]

Per aplicar els canvis heu d'estar atents al missatge que sortira a la part superior de la pàgina web. Feu clic a '''Apply''' i espereu una estona a que s'apliquin els canvis:

[[Imatge:Nanostation4.jpg|center]]

==No em puc connectar a la nanostation després d'aplicar la configuració d'unsolclic==

Després d'aplicar la configuració d'unsolclic no em puc connectar al router. La nanostation existeix però estan tots els ports filtrats tal i com es pot veure amb nmap:

$ sudo nmap 192.168.1.1-255

Starting Nmap 4.53 ( http://insecure.org ) at 2009-02-25 18:15 CET
'''All 1714 scanned ports on 192.168.1.1 are filtered'''
MAC Address: 00:15:6D:AE:70:EE (Ubiquiti Networks)

==Com buscar xarxes WIFI amb nanostation==

Consulteu el document:

http://guifi.net/files/buscar_senyal_nanostation.pdf

Aneu a l'apartat '''Link setup''' i marqueu com a país '''Espanya'''. Feu clic al '''Select''' que hi ha al costat del '''ESSID'''.

[[Imatge:Nanostation5.jpg|center]]

==Consultar la versió del firmware==

Aneu a l'apartat '''System''' i consulteu la secció '''Firmware'''

[[Imatge:Nanostation6.jpg|center]]

Per exemple:

NS2.ar2316.v2.2.1.2476.080208.1627

Correspon a una versió 2.x d'AirOs.

==Com fer un upgrade del firmware==

Aneu a l'apartat '''System''' i a la secció '''Firmware''' feu clic al boto '''upgrade'''

El firmware el podeu obtenir de la pàgina de suport de ubiquiti:

http://www.ubnt.com/support/ns2.php

Si no funciona:

http://www.ubnt.com/support/downloads

Per exemple per descarregar l'última versió (--[[Usuari:Sergi|acacha]] 16:54, 24 maig 2010 (UTC)):

http://www.ubnt.com/downloads/NanoStation2-v3.5.build4494.bin

Nanostation comprades durant el maig de 2010 venen amb:

NS2.ar2316.v3.5.4494.091109.1451

----

Exemple àntic, guardat només com a referència.

Per exemple per descarregar l'última versió (--[[Usuari:Sergi|acacha]] 19:57, 25 febr 2009 (CET)):

$ wget http://www.ubnt.com/downloads/XS-fw/v3.3.1/NS2.ar2316.v3.3.1.4227.090128.1828.bin

==OpenWRT==

:*http://intoverflow.wordpress.com/2008/11/14/openwrt-and-ubiquiti-nanostation-2/
:*http://www.ubnt.com/downloads/PS2.ar2316.OpenWRT-kamikaze.v7.09.bin

==Recuperar el firmware==

:*http://www.ubnt.com/wiki/index.php?title=Firmware_Recovery

=Recursos=

*http://www.ubnt.com/products/ns2.php
*http://wiki.ubnt.com/wiki/index.php/AirOS

[[categoria:router]]