[[TOC(heading=Índice)]]
= Instalación de OpenGNSys Server =

== Notas iniciales ==

Se presupone que el servidor de [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] va a ser instalado en una distribución de GNU/Linux, Ubuntu 9.04 Server de 32 bits.

Los scripts y ficheros de instalación de los componentes de [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] se encuentran disponibles en el paquete [browser:trunk/installer OpenGNSys Installer].

== Formas de instalación ==

Hay tres formas básicas de instalación del [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys]:
 * Con un script de instalación. El cual hace uso de Subversion para bajarse la aplicación.
 * A partir de un tar.gz. En este ya está la aplicación completa.
 * Instalación manual a paso a paso. Se obvia el script de instalación y se instala componente a componente.

Tras la instalación es conveniente repasar la [wiki:ConfigInicial configuración inicial]. Especialmente importante si cambiamos de IP la máquina.

=== Script de instalación ===

La instalación de [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] se realiza ejecutando el script de instalación [browser:trunk/installer/opengnsys_installer.sh opengnsys_installer.sh], el cual puede descargarse directamente de la dirección: [http://www.informatica.us.es:8080/opengnsys/browser/trunk/installer/opengnsys_installer.sh?format=txt]

 1. Descarga del script
 Ejemplos de descarga con varias herramientas:
   a. Descargar con wget.
   {{{
wget http://www.informatica.us.es:8080/opengnsys/browser/trunk/installer/opengnsys_installer.sh?format=txt -O opengnsys_installer.sh
}}}
   a. Descargar con curl.
   {{{
curl http://www.informatica.us.es:8080/opengnsys/browser/trunk/installer/opengnsys_installer.sh?format=txt > opengnsys_installer.sh
}}}
   a. Descargar con un navegador web: pulsar en el enlace anterior y guardar el archivo con el nombre {{{opengnsys_installer.sh}}}
 1. Proceso de instalación
El script debe ser ejecutado como usuario {{{root}}}:
{{{
sudo bash opengnsys_installer.sh
}}}

=== Instalación desde un tar.gz ===
 1. En el caso de que no tengamos acceso al Subversion, p.ej., estemos detrás de un proxy, tendremos que descargar el paquete tgz desde la web.
   a. Accemos a http://www.informatica.us.es:8080/opengnsys/browser/tags desde un equipo con acceso a internet y elegimos el paquete deseado.
   a. Nos abrirá ventana, informando que no se puede visualizar dicho paquete, dando la opción de desacargarlo.
 1. Cargarlo en el servidor donde vayamos a instalarlo.
 1. Configurarle el proxy al servidor. p.ej.: `export http_proxy="http://proxy.us.es:3128"`
 1. Dicho tar.gz debemos descomprimirlo (`tar zxvf nombre_del_fichero.tar.gz`).
 1. Cambia el nombre del subdirectorio descomprimido a `opengnsys`.
 1. Crea el subdirectorio `opengnsys_installer` en `/tmp`.
 1. Mover el subdirectorio `opengnsys` en `/tmp/opengnsys_installer`.
 1. Ejecutamos como root el script /tmp/opengnsys_installer/opengnsys/installer/opengnsys_installer.sh
{{{
sudo bash /tmp/opengnsys_installer/opengnsys/installer/opengnsys_installer.sh
}}}

=== Instalación manual paso a paso ===

Para conocer en detalle todos los procesos que realizan los scripts para la instalación manual del sistema [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] ver en [wiki:InstalacionManual Instalación Manual]

== Actualizando [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] ==

 1. Con acceso al servicio de Subversion
   1. Descargar el fichero de opengnsys_update.
 1. Sin acceso al servicio Subversion
   1. Descargar  actualización con una máquina que si lo tenga el subdirectorio trunk completo. `svn co svn://www.informatica.us.es/opengnsys/trunk`
   1. Copiarlo en la máquina donde se vaya a actualizar.
   1. Moverse hasta el subdirectorio `installer`.
 1. Ejecutar `sudo ./opengnsys_update.sh`.

== Desinstalando [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] ==
 1. Hacemos copia de datos sql de la base de datos ogBDAdmin opengnsys.
 1. Eliminamos la base de datos ogBDAdmin
 1. Eliminar mysql: `sudo aptitude --purge remove mysql-server`
 1. Parar los servicios og:  `/etc/init.d/opengnsys stop`

= Configuración de  OpenGNSys para usar servicios externos =
== Servicio dhcp externo ==
 1. Sólo debemos añadir al fichero /var/lib/tftpboot/pxelinux.cfg/default la identificación del servidor OpenGnsys(ip adress), desde el parámetro repo=xxx.xxx.xxx.xxx
 1. En el servidor dhcp externo asignamos el servicio pxe con next-server ip_opengnsys

== Servicio pxe externo ==
 1. Copiamos el initrd y linux del /var/lib/tftpboot al servicio pxe externo.
 1. Copiamos o integramos el contenido de los parámetros del initrd linux (/var/lib/tftpboot/pxelinux.cfg/default), integrando además el parámetro repo=xxx.xxx.xxx.xxx. al servicio pxe externo. (donde xxx.xxx.xxx.xxx es la ip del servidor OpenGnSys)