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 en sistemas Debian) 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/master/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