Instalación de OpenGnsys Server 1.1.1 (Espeto)
==============================================

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

Se presupone que el servidor de OpenGnsys 1.1.1 (Espeto) va a ser instalado en una distribución del sistema operativo Ubuntu Server a partir de la versión 18.04 LTS (se han hecho algunas pruebas en sistemas basados en CentOS 7).

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

Requisitos mínimos de almacenamiento:
- 100 MB en el directorio /tmp (solo durante la instalación)
- 600 MB en el directorio /var/lib/tftpboot (o /srv/tftp en las nuevas versiones) por cada cliente ogLive que se desee instalar.
- 250 MB en el directorio de instalación /opt/opengnsys más 600 MB por cada imagen ISO descargada de clientes ogLive.
- Estimar la capacidad necesaria para el repositorio de imágenes en /opt/opengnsys/images (es recomendable que este directorio se monte sobre un sistema de archivos independiente).


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: https://raw.githubusercontent.com/opengnsys/OpenGnsys/main/installer/opengnsys_installer.sh

Ejemplos de descompresión del programa:

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

Ejemplos de descarga con varias herramientas:

    * Descargar con wget.
	wget https://raw.githubusercontent.com/opengnsys/OpenGnsys/VERSION/installer/opengnsys_installer.sh

    * Descargar con curl.
	curl https://raw.githubusercontent.com/opengnsys/OpenGnsys/VERSION/installer/opengnsys_installer.sh -o opengnsys_installer.sh


El script de instalación debe ser ejecutado como usuario root:
	sudo bash opengnsys_installer.sh


Dicho script solicitará por teclado la siguiente información para configurar el acceso al servicio (si no se indica un parámetro, toma el valor por defecto):
    * Clave del usuario root de MySQL.
    * Usuario de acceso a la consola web y super-administrador de OpenGnsys.
    * Clave del usuario de acceso a la consola web.
    * Clave de acceso del cliente a servicios remotos.
    * Seleccionar cliente(s) ogLive para instalar.

Se realizan los siguientes procesos:
    * Obtener 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 o las imágenes iniciales 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
-------------

Nota importante: si se va a actualizar OpenGnsys desde una versión anterior a la 1.1.1 (Espeto), debe actualizarse antes la distribución de Ubuntu a la versión 18.04 LTS y reiniciar el servidor.

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.
    * Si el script se actualiza a sí mismo, debe ser ejecutado de nuevo.
    * 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:
    * Solicita confirmación para ejecutar sus operaciones.
    * Se eliminan 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.
    * No se eliminan los clientes ogLive ni las plantillas PXE.


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