Ruralnet 2.

Ruralnet 2.0

Instalacin del sistema Configuracin del sistema Manual del programador

pg.- 2 pg.- 8 pg.- 10

Ruralnet 2.0

Instalacin del sistema

La instalacin del sistema depender de la distribucin Linux ue se use. !xiste un asistente ue facilita la instalacin del sistema " ue instala el sistema en solo unos pasos. #ara poder utili$ar este asistente debemos utili$ar alguna distribucin soportada por dic%o asistente. &ctualmente se soportan 'ebian " deri(ados) *ed+at " deri(ados " ,use " deri(ados. #ara el resto de distribuciones) o para una instalacin manual deberemos reali$ar nosotros todos los pasos.

Instalacin con asistente

#ara instalar nuestro sistema *ural-et 2.0 mediante el asistente slo deberemos reali$ar unos pe ue.os pasos. ,e debe recordar ue slo se soportan las distribuciones 'ebian) *ed+at " ,use) as/ como sus deri(adas. #rimero deberemos descomprimir el pa uete ue %emos obtenido. #odemos utili$ar un programa grfico como ark o utili$ar la consola. ,i escogemos la consola) deberemos e0ecutar en un terminal1

tar xvzf ruralnet_2.0-version_all.tar.gz cd ruralnet_2.0-version_all ./instalador.sh

Luego e0ecutamos el instalador con permisos de administrador desde una consola) como se obser(a en el cdigo anterior. !l asistente ir instalando los programas ue se re uieren) en este punto deberemos interactuar con nuestro sistema de instalacin. !sto uiere decir) t/picamente) aceptar la instalacin de los programas as/ como de sus dependencias. Ms tarde el asistente configurar el sistema para ue pueda ser utili$ado por *ural-et 2.0. -o obstante) se nos re uerir en (arias ocasiones) una de ellas) para instalar la base de datos. #rimero) se nos pedir ue introdu$camos la contrase.a de administrador para el gestor de la base de datos. ,i "a ten/amos el motor de base de datos instalado la conoceremos) si no es as/) deberemos introducir una nue(a. & continuacin se nos reali$arn unas preguntas para su configuracin. La primera pregunta ser si ueremos modificar la contrase.a de administrador) le diremos ue no) pues la acabamos de introducir. La siguiente nos pide si ueremos borrar las bases de datos de e0emplos) a lo ue contestaremos ue s/. 'espu2s nos pregunta ue si ueremos eliminar las conexiones remotas para el administrador. Contestamos ue si) pues de esta forma %acemos nuestro sistema ms seguro. Luego nos pregunta si ueremos actuali$ar la informacin) a lo ue le indicaremos tambi2n ue s/. #or 3ltimo) nos (ol(er a pedir la contrase.a de administrador del motor de la base de datos) a uella ue %ab/amos introducido en la primera pregunta. Ms tarde se nos (ol(er a re uerir) esta (e$) para confeccionar el certificado de seguridad ue usar nuestro portal. 'eberemos indicar el pa/s) la pro(incia) ciudad) nombre del ordenador " de la compa./a. !l siguiente campo) el correo electrnico es opcional. Cuando %a"amos contestado a estas preguntas) se crear el certificado. 4na (e$ reali$ado esto) el asistente intentar configurar el sistema. ,i termina con 2xito nuestro sistema est listo para poder usarse en el momento. ,i por el contrario no %a podido

Ruralnet 2.0

configurarlo de forma automtica) deberemos %acerlo de forma manual desde el portal 5eb accediendo como administrador del mismo.

Instalacin manual
,i no tenemos la suerte de utili$ar un sistema soportado por el asistente) o si por el contrario) ueremos configurar de forma manual nuestro sistema *ural-et 2.0) deberemos seguir los siguientes pasos.

Instalacin de requisitos
#rimero de todo) debemos instalar los programas ue se re uieren para un correcto funcionamiento. ,e necesita un ser(idor 5eb con soporte para php) MySQL) un ser(idor ftp) un ser(idor d%cp " los programas iproute) tc " sudo. 4na (e$ instalados) deberemos configurarlos para adaptarlos a las necesidades de nuestro entorno. Como ser(idor 5eb se %a escogido lighttpd) por su ba0o consumo de recursos " su buen rendimiento. #ara instalarlo) seguiremos los siguientes pasos.

$ $ $ $ $ $

wget http://www.lighttpd.net/download/lighttpd-version.tar.gz gzip -cd lighttpd-version.tar.gz | tar xf cd lighttpd- version ./configure ma e ma e install

#odremos encontrar ms informacin sobre cmo instalar este ser(idor en sus pginas de manuales1. &%ora (amos a instalar p%p para ue traba0e mediante cgi para ue pueda interactuar con nuestro ser(idor. #rimero deberemos ba0ar una (ersin de p%p ue encontraremos en http://www.php.net. Luego seguimos los siguientes pasos para %abilitar el cgi ue ser la interfa$ entre nuestro ser(idor 5eb " p%p.

./configure --ena!le-fastcgi --ena!le-discard-path --ena!leforce-cgi-redirect ma e ma e install

#odemos encontrar ms informacin sobre como instalar p%p con lig%ttpd en las pginas de manuales del ser(idor lighttpd 2. Luego e0ecutamos lighty-enable-mod fastcgi en una consola para notificar a nuestro ser(idor 5eb de la existencia de p%p mediante la interfa$ cgi) o fast-cgi en este caso. & continuacin instalamos un ser(idor de ftp " de d%cp. ,e %a escogido vsftpd por) como su nombre indica) se trata de un ser(idor ftp very secure) es decir) mu" seguro.
1 http://trac.lighttpd.net/trac/wiki/ utorial!nstallation 2 http://trac.lighttpd.net/trac/wiki/ utorialLighttpd"nd#$#

Ruralnet 2.0

Como ser(idor d%cp) se %a escogido dnsmas% por su facilidad de uso " ba0os re uerimientos) adems nos proporciona de un ser(idor de dns de for5ard. #ara instalar vsftp) e0ecutamos lo siguiente)

wget ftp://vsftpd.!easts.org/users/cevans/vsftp-version.tar.gz tar xvzf vsftp-version.tar.gz cd vsftp-version ma e ma e install

#ara instalar dnsmas% procederemos como para la ma"or/a de programas) ba0amos el cdigo fuente de http://ftp.debian.org/debian/pool/main/d/dnsmas%/) lo descomprimimos) configuramos) compilamos " finalmente instalamos. &%ora instalamos M",6L. #ara ello) descargamos el programa de la 5eb del pro"ecto7 " e0ecutamos lo siguiente en una consola como root. !l pro"ecto M",6L est disponible en dos (ersiones) MySQL &omunity Server " MySQL 'nterprise. La segunda ofrece muc%a ms funcionalidades ue la primera) pero es de pago " nuestro sistema *ural-et 2.0 no (a a re uerir de estos ser(icios a(an$ados. Ms informacin sobre como instalar M",6L en las pginas de manuales del sistema8.

groupadd m"s#l useradd -g m"s#l m"s#l gunzip $ m"s#l-%&'()*+.tar.gz | tar -xvf cd m"s#l-%&'()*+ ./configure --prefix,/usr/local/m"s#l ma e ma e install cp support-files/m"-medium.cnf /etc/m".cnf cd /usr/local/m"s#l chown -' m"s#l . chgrp -' m"s#l . !in/m"s#l_install_d! --user,m"s#l chown -' root . chown -' m"s#l var !in/m"s#ld_safe --user,m"s#l -

,lo nos ueda instalar iproute " sudo. !stas %erramientas son mu" dependientes del sistema " comple0as de instalar) pues) por e0emplo) la primera forma parte del 9ernel " su instalacin suele (enir por defecto en la ma"or/a de sistema. !n caso contrario tendremos ue recompilar nuestro 9ernel para a.adir esta funcionalidad. !n cual uier caso) consulte la pgina de la %erramienta) %ttp1::555.linuxfoundation.org:en:-et1Iproute2) o la de su sistema para ma"or informacin sobre como instalarla.

Configuracin de los programas

&%ora podemos instalar los fic%eros propios del sistema *ural-et 2.0. #ara reali$ar esto) descomprimimos el pa uete *ural-et 2.0) copiamos su contenido " lo adaptamos a nuestro sistema. !sto lo podemos reali$ar con las siguientes rdenes.

7 http://dev.mys%l.com/downloads/ 8 http://dev.mys%l.com/doc/refman/(.)/en/installing-cs.html

Ruralnet 2.0
tar xvzf ruralnet_2.0-version_all.tar.gz m dir /etc/ruralnet cp -rf etc/ruralnet/. /etc/ruralnet/ chown -' WEB_USER:WEB_USER /etc/ruralnet/ m dir /var/www/ruralnet2 cp -rf var/www/ruralnet2/. /var/www/ruralnet2/ chown -' WEB_USER:WEB_USER /var/www/ruralnet2/ cp -rf home/icones/ /home/ftp/.icones/ ln -s /home/ftp/ /var/www/ruralnet2/documents m dir /var/log/ruralnet chown -' WEB_USER:WEB_USER /var/log/ruralnet

'onde WEB_USER es el usuario del sistema ue e0ecuta el ser(idor 5eb) t/picamente www-data o nobody. Consulte la informacin de su distribucin para a(eriguarlo.

&%ora (amos a configurar los programas instalados anteriormente. Creamos el certificado para ue el ser(idor 5eb cifre las pginas del portal. !0ecutamos1

openssl re# -new -x/00 - e"out server.pem -out server.pem -da"s 12/ -nodes

,e nos preguntar por el pa/s) la pro(incia) ciudad) nombre del ordenador " de la compa./a. !l siguiente campo) el correo electrnico es opcional. 4na (e$ contestadas estas preguntas) se crear el certificado ue deberemos guardar en alg3n lugar accesible por el ser(idor 5eb. &%ora configuramos el ser(idor 5eb) para ello editamos su fic%ero de configuracin ue se ubica en /etc/lighttpd/lighttpd.conf. Modificamos la (ariable server.error-handler-*)* " ponemos /ruralnet+/error/error.php. Luego a.adimos lo siguiente1

33 ((4 333 $(&'%&'56soc et67 ,, 6829.0.0.8:::16 ; ssl.engine , 6ena!le6 ssl.pemfile , 6RUTA_CERTIFICADO/server.pem6 < $(&'%&'56soc et67 ,, 6IP_LOCAL:::16 ; ssl.engine , 6ena!le6 ssl.pemfile , 6RUTA_CETIFICADO/server.pem6 <

'eberemos cambiar !#,L-&"L por la direccin I# de la interfa$ ue cree la red inalmbrica de nuestro sistema) as/ como ./ ",&'. !0!&"1- por la ruta donde se encuentra el certificado ue acabamos de crear. !sta es la forma de indicarle a nuestro ser(idor ue utilice un certificado " ue cifre todas las conexiones a %ttps) puerto 887) con 2l. & continuacin instalamos las bases de datos ue *ural-et 2.0 necesita. #ara ello editamos el fic%ero :var/www/ruralnet+/include/cone2ion.inc " cambiamos la (ariable

Ruralnet 2.0

3"L-. por la contrase.a ue ueremos ue use el portal 5eb para acceder a la base de datos. Luego e0ecutamos lo siguiente para acceder a la consola de m"s l) donde e0ecutaremos las instrucciones ue le siguen. ;eniendo en cuenta) ue deberemos cambiar 3"L-. por la contrase.a escogida anteriormente.

m"s#l --user,root -p m"s#l= source home/ruralnet_data!ase2.s#l m"s#l= source home/ruralnet_users.s#l m"s#l= create user >ruralnet>?>localhost> identified !" >%@4*'>A m"s#l= B'@+C (&4&DCE)+(&'CEFGH@C&EH&4&C& *+ ruralnet_data!ase2.. C* >ruralnet>?>localhost>A m"s#l= B'@+C (&4&DCE)+(&'CEFGH@C&EH&4&C& *+ ruralnet_users2.. C* >ruralnet>?>localhost>A

&%ora) editamos el fic%ero /etc/sudoers " a.adimos el siguiente contenido para ue el portal 5eb pueda e0ecutar ciertas aplicaciones.

WEB_USER WEB_USER WEB_USER WEB_USER WEB_USER WEB_USER

@44,+*G@((IH: @44,+*G@((IH: @44,+*G@((IH: @44,+*G@((IH: @44,+*G@((IH: @44,+*G@((IH:

/s!in/ipta!les /s!in/tc /s!in/ifdown /!in/ip /s!in/ifup /s!in/dhclient

'e nue(o cambiamos 4'5,/S'. por el usuario ue e0ecute el ser(idor 5eb en nuestro sistema) t/picamente www-data o nobody. Consulte el manual de su distribucin para ms informacin. &.adimos permisos para poder gestionar la m3ltiple interfa$ a internet mediante las siguientes instrucciones. &l igual ue en punto anterior) cambiamos 4'5,/S'. por su correcto (alor para nuestro sistema.

chown root:WEB_USER /etc/iproute2/rt_ta!les chmod gJw /etc/iproute2/rt_ta!les

<amos a configurar a%ora el ser(icio de d%cp) para ello editamos el fic%ero /etc/dnsmas%.conf. =uscamos la (ariable interface " le asignamos el (alor de la interfa$ ue est creando la red local inalmbrica. Modificamos tambi2n el (alor de la (ariable dhcp-range " le asignamos el m/nimo (alor de la direccin I# ue se puede asignar mediante d%cp) seguido de una coma) el (alor mximo de la direccin I# asignable mediante d%cp) seguido de otra coma) el (alor de la mscara de red) otra coma " la cadena 6+h. !stos (alores elegidos) la direccin m/nima " mxima) los deberemos indicar en el apartado de configuracin a(an$ada del portal 5eb. Las (ariables a las ue se corresponde son 1$&#min " 1$&#ma2 respecti(amente. >inalmente) a.adimos nuestro ser(icio *ural-et 2.0 como un ser(icio ms del sistema) para ello e0ecutamos update-rc.d ruralnet defautls o chkconfig ruralnet on seg3n nuestra distribucin. Consulte el manual de configuracin de su sistema operati(o para

Ruralnet 2.0
descubrir cmo %acerlo.

Desinstalacin
!l sistema *ural-et 2.0 tambi2n puede ser desinstalado) de(ol(iendo el sistema a su estado anterior a la instalacin del programa. #ara ello) deberemos in(ocar el asistente con el argumento remove. !l asistente ir des%aciendo los cambios ue reali$ en el momento de la instalacin. 'eberemos indicar) para ello) la contrase.a de administrador del motor de base de datos. &dems) el asistente nos preguntar si deseamos eliminar los programas ue instal para satisfacer las dependencias de *ural-et 2.0 o si por el contrario) deseamos ue se mantengan instalados. &3n contestando ue s/) los programas iproute+) tc " sudo no se desinstalan del sistema pues probablemente sean necesarios para muc%os otros programas. ,i no instalamos el sistema *ural-et 2.0 mediante el asistente) deberemos recurrir al apartado anterior) instalaci7n manual e ir des%aciendo los cambios ue se nos indicaran.

Ruralnet 2.0

Configuracin del sistema

!l sistema *ural-et 2.0 se configura automticamente cuando lo instalamos con el asistente. &dems se puede pasar el asistente ue configura nuestro sistema en cual uier momento entrando en el portal como administrador " accediendo al men3 &onfigurar) "sistente) dentro de Sistema. !sto lan$a en asistente de configuracin automtica ue intenta detectar " configurar nuestro sistema. #ero si por el contrario no lo %iciera correctamente) o uisi2ramos %acer una configuracin ms a0ustada a nuestras necesidades) deber/amos acceder a los apartados "pariencia " .ed de nuestro portal. ,i a3n as/) deseramos un ma"or control sobre nuestro sistema *ural-et 2.0) podr/amos acceder al apartado "van8ado donde se listan todas las (ariables disponibles) as/ como se posibilita su modificacin. & continuacin se muestra una tabla con todas las (ariables existentes en el sistema) su explicacin) el tipo de (alor ue admite " su (alor por defecto. 'e esta forma se puede afinar ms la configuracin del sistema por parte del administrador.

Nombre
I#; ;C I#*?4;! I>'?@I>4# I>C?->IA '+CLI!-;

Explicacin
*uta absoluta al e0ecutable iptables *uta absoluta al e0ecutable tc *uta absoluta al e0ecutable ip *uta absoluta a la %erramienta desconexin de una interfa$

Tipo

alor por defecto

,tring :sbin:iptables ,tring :sbin:tc ,tring :bin:ip de ,tring :sbin:ifdo5n

*uta absoluta a la %erramienta de conexin ,tring :sbin:ifup de una interfa$ *uta absoluta a la %erramienta configuracin de interfaces *uta absoluta al cliente de d%cp de ,tring :sbin:ifconfig ,tring :sbin:d%client se ,tring :etc:net5or9: interfaces

-!;BC?->IAB> *uta absoluta al fic%ero donde IL! configuran las interfaces de red

'+C#BC?->IA *uta absoluta a la carpeta donde el cliente ,tring :(ar:lib:d%cp7: B'I* d%cp guarda la informacin sobre las interfaces configuradas mediante d%cp ;?C;?CB>?L' Carpeta relati(a donde se encuentran los ,tring :ruralnet2: !* fic%eros del portal 5eb des de la ra/$ del ser(idor #&AI-&B#*I-C >ic%ero principal del sistema 5eb I#&L C,, ;I;4L? +o0a de estilo ue usa el portal ;/tulo ue aparece en el nombre del portal ,tring ruralnet.p%p ,tring ruralnet.css ,tring *ural-et 2.0 ,tring ruralnet

;?C;?CB,C*I# ,cript de arran ue " parada del sistema ;

;?C;?CB#&;+B *uta absoluta a la carpeta ue contiene el ,tring :etc:init.d ,C*I#; script de arran ue " parada del sistema

Ruralnet 2.0
Nombre Explicacin Tipo alor por defecto

#&AI-&BI-;!* #agina a la ue se redirecciona por defecto ,tring %ttp1::555. -!; una (e$ se consigue la conexin a internet google.com @L&!;L&@I* !;+ 'ireccin de la interfa$ inalmbrica ue genera la red I# I#

'ireccin de la interfa$ con conexin a internet -ombre de la interfa$ inalmbrica

ue crea la red ,tring

-ombre de la interfa$ con conexin a ,tring internet

M4L;IBI-;!*- !xistencia o no de una conexin m3ltiple a true : false !; internet false M4L;IBI-;!*> Lista con las interfaces ue componen la Lista &C! m3ltiple conexin a internet ,tring M4L;IB64&LI; Lista con las calidades de las conexiones Lista C ue componen la m3ltiple salida a internet num2 rica #@L&'I*B#+# #arte de la direccin I# ue indica la red en la ue est el dispositi(o @ifi I#

*uta absoluta donde se encuentran todos ,tring :(ar:555: los fic%eros p%p del portal ruralnet2

'I*BCLI!-;!, *uta absoluta a la carpeta donde se guarda ,tring :etc:ruralnet: informacin sobre los clientes clients 'I*B,C*I#;, L?A 'I*BL?A ;I!M#?BL?A L?AB=&CE ;I!M#? *uta absoluta a la carpeta guardan los scripts del sistema &rc%i(o sistema donde se ,tring :etc:ruralnet: scripts

ue contiene los logs de acceso al ,tring acceso.log ,tring :(ar:log:ruralnet

*uta absoluta al arc%i(o de logs del sistema

;iempo de actuali$acin del fic%ero de logs ,egun D188000 de acceso al sistema dos &rc%i(o con la copia del log de acceso del ,tring acceso.ba9 sistema ;iempo en el existen clientes ue el ser(idor re(isa si ,egun 20 dos

*!>*!,C?B&C ;iempo de refresco del script ue indica al ,egun 1D C!,?B@!= ser(idor ue esta accediendo a internet. dos 'ebe ser menor ue el (alor ;I!M#?. ;!M#,BI-;!* *4*&L-!; I#BA&;!@&C '+C#min ;iempo ue pasa entre comprobaciones de ,egun F00 la conexin a internet dos 'ireccin I# del e uipo portal *ural-et 2.0 ue contiene el I# I# uiere -3me 100 ro

'ireccin I# de la puerta de enlace M/nimo de los clientes '+C# ue sean capturados ue se

Ruralnet 2.0
Nombre
'+C#max

10
Tipo alor por defecto

Explicacin
Mximo de los clientes '+C# ue sean capturados ue se

uiere -3me 2D0 ro

Manual del programador

!n este apartado se (a a explicar la ar uitectura del sistema *ural-et 2.0 para a uellos ue deseen a.adir nue(as funcionalidades o me0orar las partes "a existentes dentro del sistema.

Estructura del sistema

!n la estructura interna de un sistema *ural-et 2.0 colaboran un gran n3mero de aplicaciones. & continuacin se muestra la interaccin de un cliente con un ser(idor *ural-et 2.0) as/ como todas los componentes ue participan en esta comunicacin. !l cliente pasa a formar parte de la red " se configura automticamente mediante el ser(icio '+C# ue se ubica en el ser(idor. !ste ser(icio le proporciona I#) mscara de red " puerta de enlace. Cuando el cliente es capturado por el sistema) uien lo %ace es el cortafuegos) en nuestro caso) iptables. ,e le redirige a la pgina 5eb del sistema. !ntra en funcionamiento el ser(idor 5eb) uien le pide al mdulo de p%p ue interprete la pgina " genere el contenido %tml. Guntamente con el %tml se en(/a el css al cliente) el na(egador del cual interpretar lo en(iado " mostrar la informacin.

>ig 81.- 'iagrama de funcionamiento interno de *ural-et 2.0

!l uso del protocolo ?L,* es opcional " slo necesario si se crea una una red M&-!;.

Ruralnet 2.0
La internacionali$acin la %ace p%p mediante fic%eros xml para cada pgina ue muestra. &dems) p%p es el encargado de interactuar con ;C) iptables " iproute2. !l primero) se encarga del control de trfico) es decir) de asignar (elocidades a los clientes. Iptables es el cortafuegos ue se encarga de blo uear las conexiones no permitidas " redirigir al portal. #or 3ltimo iproute2 es el encargado de crear la conexin m3ltiple a internet " de su balanceo de carga si se da el caso. : I J J I J J I J J I J J K

11

documents
enlace a la carpeta de documentos

error
gesti7n de errores del servidor

idiomas
ficheros con las traducciones

include
funciones b9sicas

puenteBmando *ural-et 2.0 guarda sus fic%eros K include siguiendo el con(enio de los sistemas funciones de seguridad 4nix. !s por este moti(o) ue todos los p9ginas de gesti7n / configuraci7n fic%eros de la pgina 5eb se guardan p9ginas b9sicas en /var/www. !n /etc/ruralnet se ubican los fic%eros de la aplicacin. !stos fic%eros comprenden) un fic%ero de configuracin del ser(icio) ruralnet.conf) un subdirectori clientes) donde se guarda informacin sobre cada cliente del sistema. #or 3ltimo otro subdirectorio) scripts) para ue residan todos los scripts ue usa el sistema. !n /var/log/ruralnet se empla$an los fic%eros de log del sistema *ural-et 2.0. >inalmente en /etc/init.d/ se ubica el script ue arranca " detiene la aplicacin. Con este 3ltimo fic%ero se a.ade una ma"or integracin con el sistema) puesto ue *ural-et 2.0 pasa a ser un ser(icio ms de nuestro ser(idor) permitiendo) adems) ue se acti(e automticamente en el arran ue del sistema o se detenga cuando 2ste se apaga. #ara la disposicin de las pginas del portal se %a seguido un orden. 'ependiendo de la funcin de cada pgina se ubica en un directorio u otro. Las pginas bsicas " ue no re uieren de permisos especiales) se %an posicionado en la ra/$ del ser(idor. !n la carpeta error) encontramos los fic%eros para la gestin de errores del ser(idor. !n idiomas) se ubican los fic%eros HML con todos los mensa0es traducidos) existe un fic%ero por cada pgina ue muestra contenido en cada idioma. include se usa para guardar todas las funciones escritas en p%p " ue no se encuentran en el cdigo de cada pgina. & u/ encontrar/amos) entre otras) las funciones ue generan la cabecera) el men3) o la conexin con la base de datos. La carpeta puente,mando alberga a uellas pginas ue re uieren de permisos especiales) es decir) a uellas usadas para la gestin) configuracin del sistema. 'entro de 2sta) existe otro directorio) include) donde se ubican las funciones ue son usadas por las pginas anteriores. & u/ encontramos) entre otras) las funciones encargadas de gestionar la seguridad) as/ como las funciones encargadas de gestionar la configuracin del sistema. La carpeta documentos) no es en s/ un directorio) sino un enlace simblico a la carpeta del ser(idor ftp. !sto se %a %ec%o as/ por ue si obser(amos el sistema de fic%eros de un ser(idor Linux) o cual uier 4nix en general) se puede (er ue la ma"or/a) disponen de como m/nimo tres particiones. 4na para :) otra para :%ome " la 3ltima) la de intercambio) s5ap. !n la primera) :) se ubican los e0ecutables) fic%eros de configuracin del sistema " los generales de cada aplicacin. !n :%ome) se ubican los datos de los usuarios " su configuracin personali$ada. Mientras ue la 3ltima particin es usada por el sistema operati(o para la gestin de la memoria dinmica.

Creacin de un nue!o apartado

Ruralnet 2.0

12

#ara a.adir un nue(o apartado a nuestro portal) primero debemos saber uien debe poder acceder. ,i pueden acceder todos los usuarios) no re uiere de proteccin) si por el contrario) slo operadores o administradores pueden acceder) re uiere de proteccin. ,i no re uiere de proteccin) deberemos ubicar nuestra pgina en la carpeta principal de nuestro portal. ,i por el contrario) necesitamos proteccin) deberemos crear nuestro fic%ero dentro de puente,mando " incluir el ni(el de proteccin " llamar a las funciones de proteccin. & continuacin se muestra un e0emplo.

$nivell , 8A includeK6include/proteccion_admin.inc6LA

La (ariable :nivell indica el ni(el de proteccin) si esta (ariable tiene un (alor igual a uno) indica ue la pgina es accesible para operadores " administradores. ,i por el contrario (ale dos) slo pueden acceder administradores. !s recomendable ue para la creacin de la nue(a pgina se utilice la plantilla con la ue se %a creado el resto de pginas) pues esto garanti$a la co%erencia en todo el portal. !sta plantilla la podemos encontrar en la ra/$ donde se encuentran el resto de los fic%eros p%p. 4sar la plantilla nos descarga de tenernos ue preocupar de la creacin de la cabecera) el men3 " el pi2 de la pgina. #uede ue nos interese poder acceder a las (ariables del sistema) o puede ue tambi2n nos (eamos en la necesidad de tenerlas ue modificar. #ara %acer uso de las (ariables del sistema) solo debemos incluir el fic%ero de configuracin ue encontraremos en include/configuracion.inc. 4na (e$ %ec%o esto dispondremos de todas las (ariables) a las ue accederemos escribiendo :conf,;-M5.') donde nombre es el nombre de la (ariable. 'ebido a las peculiaridades de p%p) deberemos indicar u2 (ariables (amos a utili$ar mediante la instruccin global) seguida de la lista de (ariables a la ue ueremos acceder. ,i adems de acceder a las (ariables) ueremos modificar su (alor) deberemos a.adir el fic%ero include/variables.inc. !ste fic%ero contiene la funcin ue permite modificar el (alor de una (ariable) escriu,variables ue pide dos argumentos. !l primero es el nombre de la (ariable ue ueremos modificar) el siguiente es el nue(o (alor. !sta funcin se encarga de modificar el fic%ero de configuracin del sistema) liberando al programador del nue(o mdulo de reali$ar dic%a tarea. #robablemente nuestro nue(o apartado deba mostrar texto. #ara mostrar texto en todos los idiomas disponibles en *ural-et 2.0 se debe %acer mediante la funcin obtiene&ampo<ML) a la ue le pasaremos el idioma en el ue ueramos obtener el texto " la eti ueta descripti(a. !sta eti ueta ser la ue deberemos a.adir en cada fic%ero con su correspondiente traduccin en cada idioma definido en el sistema. !l fic%ero tiene una sintaxis determinada) primero iniciali$amos el fic%ero xml) a continuacin abrimos la eti ueta toctoc donde a.adiremos todas nuestras nue(as cadenas. 'entro de esta) definimos todas las eti uetas) title " welcome en el e0emplo inferior. #or cada eti ueta definimos otra eti ueta con el cdigo del idioma) donde pondremos la traduccin del texto en dic%o idioma) como se puede obser(ar en el siguiente e0emplo.

$Mxml version,68.06 encoding,6)(*-NN/0-86M= $toctoc=

Ruralnet 2.0
$title= $en=Citle$/en= $es=Citulo$/es= $ca=Citol$/ca= $/title= $welcome= $en=Ielcome$/en= $es=Oienvenido$/es= $ca=Oenvingut$/ca= $/welcome= $/toctoc=

13

>inalmente) una (e$ tenemos la nue(a pgina creada) slo ueda ue 2sta apare$ca en el portal) para ello) debemos a.adirla al men3. #ara este propsito) editamos el fic%ero include/menu.inc. !l men3 est creado mediante listas de definicin) eti uetas %tml dl) dt " dd.

$dl= $dt=Fno$/dt= $dt=Hos$/dt= $dd=Hos.uno$/dd= $dd=Hos.dos$/dd= $dt=Cres$/dt= $/dl=

!l e0emplo anterior tendr/a un resultado como este

Fno Hos Hos.uno Hos.dos Cres

&dems) se debe tener en cuenta ue los mensa0es de los men3s tambi2n se deben mostrar a tra(2s de la funcin obtien&ampo<ML para garanti$ar el multilingLismo. ?tra cosa a tener en cuenta es el %ec%o de si nuestra pgina re uer/a permisos. ,i obser(amos el fic%ero menu.inc) obser(amos ue existen tres partes diferenciadas. La primera) donde los elementos del men3 estn colocados tal cual) la segunda) donde los elementos se encuentran dentro de un si condicional if=:admin>)?) cual uier apartado a.adido dentro de este elemento) slo ser mostrado para operadores " administradores. 'entro de 2ste) existe otro si condicional) a u/ se encuentra la tercera parte. !ste blo ue slo se muestra para los administradores del sistema. La incorrecta colocacin de un apartado en el men3 no incurre en ning3n caso en un problema de seguridad) pues un usuario ser expulsado de la pgina si no tiene los permisos oportunos. ,implemente mostrar/amos una opcin ue no estar/a disponible para dic%o usuario.

"dicin de un nue!o idioma

4na de las bondades del sistema es su total adaptacin al cliente mostrando el

Ruralnet 2.0

14

portal /ntegramente en su idioma. #or tanto un tarea importante es la adicin de nue(os idiomas. !sta tarea no es complicada pero si re uiere de tiempo) pues existe gran cantidad de texto ue debe ser traducido " adaptado a la nue(a lengua. 4na (e$ decididos a traducir *ural-et 2.0 a un nue(o idioma) deberemos saber su cdigo internacional. !ste cdigo es el establecido por el I,? F7M-1) ue usa dos letras para identificar los idiomas principales del planeta. -ormalmente este cdigo coincide con las dos primeras letras del nombre del idioma en su propia lengua. #ara obtener todos los cdigos I,? F7M-1 consulte la librer/a del congreso de los !stados 4nidosD. Las cadenas a traducir estn ubicadas en la carpeta idiomas) deber editar todos los fic%eros " a.adir por cada eti ueta) una nue(a eti ueta con el cdigo del nue(o idioma) " dentro de 2sta) la cadena traducida. Como se muestra en el e0emplo de aba0o con l/nea subra"ada.

$Mxml version,68.06 encoding,6)(*-NN/0-86M= $toctoc= $title= $en=Citle$/en= $es=Citulo$/es= $ca=Citol$/ca= $cdigo>Cadena trad cida!"cdigo> $/title= $/toctoc=

,i el idioma al ue (a a traducir los mensa0es re uiere de caracteres no estndares) estos son1 acentos) .) N u otros) as/ como caracteres con significado propio en +;ML) O " P por e0emploQ no podr %acerlo directamente. #ara poder expresar dic%os caracteres) debern ser representados mediante /&S =/niversal &haracter Set? o mediante &haracter entity references@. 4na (e$ tengamos todos los mensa0es traducidos) deberemos dar de alta el lengua0e en el sistema) para ello) accedemos a una consola del ser(idor " entramos en el gestor de base de datos. 4na (e$ all/ a.adimos el nue(o idioma) introduciendo su cdigo " el nombre del idioma ue ueremos ue se muestre. ;eclee las siguientes rdenes para ello. Modifi ue los (alores subra"ados por los su"os propios.

m"s#l -u root -p m"s#l= use ruralnet_data!ase2A m"s#l= insert into idiomas KidEidiomaL values KcdigoEidio#aLA

D F

http://www.loc.gov/standards/iso@AB-+/php/code,list.php http://www.wA.org/ ./.'&-html*)/sgml/entities.html