[[TranslatedPages]]
[[TOC(heading=Índice)]]

= Instalación de OpenGnSys Server =

== Notas iniciales ==

Actualmente, [http://www.opengnsys.es/ OpenGnSys Server] solo debe ser instalado sobre una distribución GNU/Linux Ubuntu (a partir de la versión 9.04), aunque se recomienda utilizar la versión Ubuntu 10.04 LTS Server, tanto de 32 como de 64 bits (también se ha probado la instalación sobre un versión Ubuntu Desktop).


Esta página está estructurada de la siguiente manera:

* Instalación de Opengnsys desde un scripts.
* Instalación de OpenGnsys desde un tar.gz
* Actualización de Opengnsys.
* Desistalación de OpenGnsys.
* Información extra de los servicios de red usados por OpenGnsys.
* Configuración del proxy en entornos en que se requiera.

== Versión a Instalar ==

La '''versión''' actual '''aconsejada'''  es la '''versión 1.0 ''' desde el  scripts de instalación que se indica en el apartado de "Script de instalación"



== Formas de instalación ==

Hay tres maneras básicas de instalación de [http://www.opengnsys.es/ OpenGnSys]:
 * Ejecutar el script de instalación, el cual hace uso de Subversion para descargar la aplicación.
 * A partir de un fichero comprimido tipo {{{tar.gz}}} con la aplicación completa.
 * Instalación manual paso a paso, obbviando el script de instalación e instalando componente a componente.

Tras la instalación es conveniente repasar la [wiki:ConfigInicial configuración inicial], especialmente si se modifica la IP el servidor OpenGnSys.

=== Script de instalación ===

Actualmente existe una versión estabilizada en el branch denominada versión-1.0 que está en fase de pasarlo al trunk.
 
Tanto la versión del trunk 0.10 como la 1.0 se pueden instalar ejecutando el scripts de instalación automática opengnsys_installer.sh que se indican seguidamente.
 1. '''Ejemplos de descarga.'''
   * Ejemplos de descarga del script de la versión 1.0 
     a. Descargar con wget la versión 1.0
   {{{
wget http://www.opengnsys.es/browser/branches/version1.0/installer/opengnsys_installer.sh?format=txt -O opengnsys_installer.sh
}}}
     a. Descargar con curl la version 1.0
   {{{
curl http://www.opengnsys.es/browser/branches/version1.0/installer/opengnsys_installer.sh?format=txt > opengnsys_installer.sh
}}}
     a. Descargar con un navegador web: pulsar en el enlace siguiente y guardar el archivo con el nombre {{{opengnsys_installer.sh}}}
 [http://www.opengnsys.es/browser/branches/version1.0/installer/opengnsys_installer.sh?format=txt]

   * Ejemplos de descarga del script de la versión 0.10 
     a. Descargar con wget la versión 0.10
   {{{
wget http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt -O opengnsys_installer.sh
}}}
     a. Descargar con curl la version 0.10.
   {{{
curl http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt > opengnsys_installer.sh
}}}
     a. Descargar con un navegador web: pulsar en el enlace siguiente y guardar el archivo con el nombre {{{opengnsys_installer.sh}}}
[http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt]
 
 2. '''Configuración básica'''
   a. Como medida de seguridad, resulta '''muy importante''' modificar los usuarios y claves por defecto de acceso al sistema. Para ello, editar el fichero de instalación {{{opengnsys_installer.sh}}} y modificar los valores de las variables de configuración:
     * {{{MYSQL_ROOT_PASSWORD}}} - clave del usuario {{{root}}} de MySQL.
     * {{{OPENGNSYS_DATABASE}}} - nombre de la base de datos.
     * {{{OPENGNSYS_DB_USER}}} - usuario de acceso y super-administrador de OpenGnSys.
     * {{{OPENGNSYS_DB_PASSWD}}} - clave del usuario.

 3. '''Proceso de instalación'''
   a. Ejecutar el script como usuario {{{root}}}:
{{{
sudo bash opengnsys_installer.sh
}}}

 4. '''Revisar los ficheros de configuración.'''

=== Instalación desde un tar.gz ===

Para instalar una determinada revisión de OpenGnSys, debe descargarse el fichero comprimido con el contenido de dicha versión y realizar los siguientes pasos:
 1. Acceder a [http://www.opengnsys.es/browser/tags] y descargar el fichero ''{{{opengnsys-Versión.tar.gz}}}'' de la revisión deseada.
 2. Descomprimir el fichero, ejecutando: {{{tar xvzf }}}''{{{opengnsys-Versión.tar.gz}}}''
 3. Cambiar al subdirectorio del instalador, ejecutando: {{{cd opengnsys/installer}}}
 4. Como medida de seguridad, resulta '''muy importante''' modificar los usuarios y claves por defecto de acceso al sistema. Para ello, editar el fichero de instalación {{{opengnsys_installer.sh}}} y modificar los valores de las variables de configuración:
     * {{{MYSQL_ROOT_PASSWORD}}} - clave del usuario {{{root}}} de MySQL.
     * {{{OPENGNSYS_DATABASE}}} - nombre de la base de datos.
     * {{{OPENGNSYS_DB_USER}}} - usuario de acceso y super-administrador de OpenGnSys.
     * {{{OPENGNSYS_DB_PASSWD}}} - clave del usuario.
 5. Ejecutar el script de instalación como usuario {{{root}}}:
   {{{
sudo bash opengnsys_installer.sh
}}}
   '''Nota:''' En algunos entornos privados es necesario configurar el proxy de conexión para ejecutar el instalador, en tal caso ejecutar:
   {{{
http_proxy="http://IPProxy:PuertoProxy" sudo bash opengnsys_installer.sh
}}}
 6. Revisar los ficheros de configuración.

=== 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.opengnsys.es OpenGnSys] ver en [wiki:InstalacionManual Instalación Manual]

== Actualizar [http://www.opengnsys.es/ OpenGnSys] ==

Puede utilizarse el script [browser:trunk/installer/opengnsys_update.sh opengnsys_update.sh] para realizar la actualización de los ficheros del proyecto a la última revisión en desarrollo. Sin embargo, dicho script no ejecuta modificaciones en la base de datos ni recompila los servicios, debiendo realizar estas operaciones "a mano".

El proceso automático para actualizar es:
 1. Descargar el script de actualización directamente de la dirección: [http://www.opengnsys.es/browser/trunk/installer/opengnsys_update.sh?format=txt]
 1. Ejecutar el script tecleando: {{{sudo ./opengnsys_update.sh}}} (se requiere acceso a Internet).

Para completar la actualización en los casos especiales de que se modifique la estructura de la base de datos o sea necesario recompilar algún servicio, deben seguirse los pasos:
 1. Descargar el repositorio de código ejecutando: {{{svn checkout http://www.opengnsys.es/svn/trunk opengnsys}}}
 2. Revisar y modificar (en su caso) el fichero de creación de la base de datos y aplicar los cambios.
 3. Revisar los directorios de los distintos servicios y (si fuese necesario) recompilar, copiar los ejecutables y reiniciar los servicios.
 
== Desinstalando [http://www.opengnsys.es/ OpenGnSys] ==

Se ha creado el script [browser:trunk/installer/opengnsys_uninstall.sh opengnsys_uninstall.sh] para realizar la desinstalación del Proyecto OpenGnSys. Por lo tanto, para desinstalar realizar los siguientes pasos.
 1. Hacer copia de seguridad de la base de datos SQL.
 1. Descargar el script de desinstalación directamente de la dirección: [http://www.opengnsys.es/browser/trunk/installer/opengnsys_uninstall.sh?format=txt]
 1. Editar el script y modificar los valores de las variables que configuran el acceso a la base de datos.
 1. Ejecutar el script: {{{sudo ./opengnsys_uninstall.sh}}}
 1. Parar los servicios auxiliares que dejen de ser necesarios (DHCP, PXE, NFS, Apache, MyQSL).
 1. El programa de desinstalación no elimina las imágenes creadas, por lo tanto, si se considera necesario, debe borrarse manualmente el directorio {{{/opt/opengnsys/images}}}

== Configuración de OpenGnSys para usar servicios externos ==

=== Servicio dhcp externo ===

 1. Desde nuestro Servidor OpenGnsys: añadir al fichero /var/lib/tftpboot/pxelinux.cfg/default la identificación del servidor OpenGnsys(ip adress), con repo=xxx.xxx.xxx.xxx
{{{
LABEL pxe
KERNEL linux
APPEND initrd=initrd.gz ip=dhcp ro vga=788 irqpoll acpi=on repo=172.17.36.29
}}}
 1. En el servidor DHCP externo:  
{{{
# habilitamos la transferencia del nombre por dhcp.
use-host-decl-names on;
# asignamos el servicio pxe con:
next-server ip_opengnsys;
filename  "pxelinux.0";
}}}

=== 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)


== Propuesta instalación de componentes ==

Se propone modificar el programa de instalación para automatizar el proceso de los 2 componentes principales del Proyecto OpenGnSys. El formato del script de instalación {{{opengnsys-installer.sh }}} puede ser:
   {{{
opengnsys_installer.sh [ all | server | repo IPServidor DistribuciónCliente ]
   }}}

Siendo los parámetros:
 * '''{{{server}}}''' - que incluye los servicios:
   * Servidor OpenGnSys (ogAdmServer, ogAdmAgent)
   * Condola web (Apache, MySQL, páginas web)
   * Arranque (DHCP, TFTP, generador del cliente)
 * '''{{{repo}}}''' - que incluye los servicios:
   * Servidor de repositorio (ogAdmRepo)
   * Servidor de ficheros (NFS)
   * Componentes del Cliente OpenGnSys
   * Necesita conocer la IP del servidor principal y el tipo de distribución de Ubuntu que será usado en los clientes.
 * '''{{{all}}}''' - instalación compacta en la misma máquina (valor opcional y por defecto).



== Configurando la conectividad http y svn en entornos que lo necesiten ==
* Exportamos la variable que identifica al proxy a usar.
{{{
export http_proxy="http://proxy.xxx.es:puerto"
}}}

* Comprobamos el uso del proxy, instalando el paquete subversion y wget, con el comando:   
{{{
apt-get update
apt-get install subversion wget
}}}

* Configuramos el subversion para que utilice también el proxy.
{{{
vi /etc/subversion/servers
#editamos la sección [global], en la linea 142, para que quede como:

[global]

http-proxy-host = proxy.xxx.es

http-proxy-port = 3128

http-timeout = 10

# nota: no debe haber ninguna línea comentada entre [global] y el http-proxy-host 
# nota: no debe haber espacios en blanco ni tabuladores delante de http-proxy-host

}}}