Instalación de OpenGnSys Server v 1.0.3
=======================================

Notas iniciales
---------------

Se presupone que el servidor de OpenGnSys va a ser instalado en una distribución del sistema operativo Ubuntu Linux a partir de la versión 9.04 (también ha sido probado en sistemas Debian 6 y Linux Mint 12).

El serividor debe tener acceso a Internet para descargar los paquetes necesarios, el rpositorio código y el cliente preconfigurado.

Requisitos mínimos de almacenamiento:
- 350 MB en el directorio /tmp (solo durante la instalación)
- 300 MB en el directorio /var/lib/tftpboot (o /srv en sistemas Debian)
- 50 MB en el directorio de instalación /opt/opengnsys
- Estimar la capacidad necesaria para el repositorio de imágenes en /opt/opengnsys/images


Instalación
-----------

La instalación de OpenGnSys se realiza ejecutando el script de instalación opengnsys_installer.sh, el cual puede obtenerse descomprimiendo el fichero de la versión opengnsys-Version.tar.gz o descargándolo directamente de la dirección: http://www.opengnsys.es/browser/branches/version1.0/installer/opengnsys_installer.sh?format=txt

Ejemplos de descompresión del programa:

	tar xvzf opengnsys-1.0.3.tar.gz
	cd opengnsys/installer

Ejemplos de descarga con varias herramientas:

    * Descargar con wget.
	wget http://www.opengnsys.es/svn/branches/version1.0/installer/opengnsys_installer.sh -O opengnsys_installer.sh

    * Descargar con curl.
	curl http://www.opengnsys.es/svn/branches/version1.0/installer/opengnsys_installer.sh > opengnsys_installer.sh

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_DB_USER - usuario de acceso y super-administrador de OpenGnSys.
    OPENGNSYS_DB_PASSWD - clave del usuario.
    OPENGNSYS_CLIENT_PASSWD - clave de acceso del cliente a servicios remotos. 

El script debe ser ejecutado como usuario root:
	sudo bash opengnsys_installer.sh

Se realizan los siguientes procesos:
    * Obtenener los parámetros básicos de la red.
    * Comprobar los paquetes instalados.
    * Descargar e instalar las dependencias que faltan.
    * Crear la estructura básica de directorios de OpenGnSys.
    * Descargar el repositorio de código en un directorio temporal (/tmp/opengnsys_installer). Nota: en versiones futuras este proceso no será necesario.
    * Compilar e instalar los servicios de OpenGnSys.
    * Configuración básica de los serviciios de red DHCP, PXE y NFS/Samba a partir de las plantillas de configuración
    * Copiar ficheros complementarios de gestión del servidor.
    * Crear la base de datos y configurar el servidor web de OpenGnSys Web Admin Console.
    * Copiar los ficheros de las páginas de Web Admin Console.
    * Copiar la estructura de directorios de OpenGnSys Client.
    * Descargar la imagen inicial de OpenGnSys Client.
    * Configuración básica de los serviciios de OpenGnSys a partir de los parámetros de red.

Una vez finalizada la ejecución del instalador, puede empezarse a trabajar con el sistema:
    * Configurar DHCP.
    * Añadir datos en la consola de administración.
    * Personalizar scripts de administración.
    * Definir menús de inicio para los clientes.



Actualización
-------------

Se dispone de un script de auto-actualización del sistema, con las siguientes características:
    * Es necesario conexión a Internet para obtener las últimas actualizaciones.
    * No se actualizan los servicios asociados al sistema operativo.
    * No se modifican los ficheros de configuración.


El script debe ser ejecutado como usuario root:
	sudo /opt/opengnsys/lib/opengnsys_update.sh
 


Desinstalación
--------------

También existe un script de desinstalación de los componentes de OpenGnSys, con las siguientes características:
    * Se iliminan los ficheros de OpenGnSys y su base de datos.
    * No se eliminan ni paquetes del sistema operativo ni sus ficheros de configuración.
    * No se elimina el directorio de las imágenes ni su contenido.


El script debe ser ejecutado como usuario root:
	sudo /opt/opengnsys/lib/opengnsys_uninstall.sh
 
