wiki:ManualInstalacion

Instalación de OpenGnsys Server

Requisitos

En primer lugar se debe revisar la lista de compatibilidad para instalación de OpenGnsys Server para comprobar las distribuciones GNU/Linux compatibles con la versión de OpenGnsys que se desea instalar.

Versión a Instalar

La versión actual aconsejada es OpenGnsys 1.1.0 y está disponible para descarga el fichero comprimido opengnsys-1.1.0-last.tar.gz

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, sin contar el espacio para el registro de incidencias.
  • 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).

Formas de instalación

Hay dos maneras básicas de instalación de 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.

Tras la instalación es conveniente repasar la configuración inicial, especialmente si se modifica la IP el servidor OpenGnsys.

Script de instalación

NOTA: Si se usa un servidor proxy para el acceso a Internet, antes de ejecutar el script debe revisarse la información al final de este documento para activar el uso de Subversión con proxy.

  1. Descargar el script de instalación
    • Ejemplos de descarga del script.
      1. Descargar con Wget:
        wget https://opengnsys.es/svn/trunk/installer/opengnsys_installer.sh
        
      2. Descargar con curl:
        curl https://opengnsys.es/svn/trunk/installer/opengnsys_installer.sh > opengnsys_installer.sh
        
      3. Descargar con un navegador web: pulsar en el enlace https://opengnsys.es/svn/trunk/installer/opengnsys_installer.sh y guardar el archivo con el nombre opengnsys_installer.sh
  1. Proceso de instalación
    1. Ejecutar el script como usuario root:
      sudo bash opengnsys_installer.sh
      
    2. El script de instalación pedirá que el usuario introduzca los siguientes valores de configuración (se recomienda rellenar adecuadamente esta información, si no se indica un parámetro toma el valor por defecto):
      • Clave del usuario root del servidor de bases de datos MySQL/MariaDB.
      • 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 (64 bits, 32 bits o ambos).
  1. 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 https://opengnsys.es/trac/downloads y descargar el fichero opengnsys-Versión.tar.gz de la revisión deseada.
  2. Descomprimir el fichero, ejecutando: sudo tar xpvzf opengnsys-Versión.tar.gz

Nota: Si ha olvidado ejecutar esta orden como usuario root (o no ha utilizado la orden sudo), deberá ejecutar el script de comprobación de permisos justo después de la instalación.

  1. Cambiar al subdirectorio del instalador, ejecutando: cd opengnsys/installer
  2. 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. Al final del documento se explica como configurar el proxy en http, https, svn y wget.
  3. El script de instalación pedirá que el usuario introduzca los parámetros de configuración como se indica en el apartado anterior (se recomienda rellenar adecuadamente esta información, ya que si no se indica un parámetro toma el valor por defecto).
  4. Si no ha descomprimido los ficheros como root, deberá ejecutar el script de comprobación de permisos:
    sudo /opt/opengnsys/bin/checkperms
    
  5. Revisar los ficheros de configuración.

Configuración Inicial

  1. Revise los ficheros de configuraciones.
    1. /opt/opengnsys/etc/ogAdmServer.cfg - configuración de OpenGnsys Server
    2. /opt/opengnsys/etc/ogAdmRepo.cfg - configuración de OpenGnsys Repository
    3. /opt/opengnsys/etc/ogAdmAgent.cfg - configuración de OpenGnsys Agent
    4. /opt/opengnsys/client/etc/ogAdmClient.cfg - configuración de OpenGnsys Client
    5. /opt/opengnsys/www/controlacceso.php - configuración de OpenGnsys Web Admin Console
    6. /etc/default/opengnsys - configuración de los servicios iniciados automáticamente
  2. El script de instalación reduce la seguridad del servidor para preparar todos los servicios necesarios, por lo que se recomienda revisar la configuración de seguridad (SELinux, IPTables, Firewalld, etc.). Previa supervisión, puede utilizar el script disponible para la configuración básica de seguridad, ejecutando:
    sudo /opt/opengnsys/lib/security-config
    
  3. Configure y reinicie el servicio de DHCP.
  4. Opcionalmente, revise la configuración de Samba en el directorio /etc/samba
  5. Entre como Administrador en la consola web del servidor.
    1. Utilice el usuario y clave establecidos en el instalador para acceso a la base de datos.
    2. Revise la organización que está configurada por defecto y el usuario por defecto.
  6. Entre como un usuario en la consola web del servidor.
    1. Utilice el usuario y la clave que haya configurado como administrador de la Unidad Organizativa correspondiente.
    2. Revise que el dato de IP del servidor es correcto en la sección "Servidores->Servidor OpenGnsys (Default)".
    3. Si cambia la configuración, reinicie el servidor: sudo service opengnsys restart (está disponible un script para cambiar automáticamente la dirección IP del servidor, ver sección Cambio de dirección IP de OpenGnsys Server).

Actualizar OpenGnsys

Desde la versión 1.0.1 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.

Para realizar la actualización, el script debe ser ejecutado como usuario root:

sudo /opt/opengnsys/lib/opengnsys_update.sh

Si el script se actualiza a sí mismo, pedirá automáticamente que vuelva a ser ejecutado para terminar de actualizar todo el sistema.

Tras el proceso de actualización se mostrará una serie de mensajes con las modificaciones que puedan haber afectado a la configuración del servidor y con las acciones manuales pendientes que deba realizar el administrador.

Aviso importante: tras actualizar OpenGnsys, debe vaciar la caché del navegador antes de volver a acceder a la nueva consola web.

Desinstalar OpenGnsys

Asimismo, desde la versión 1.0.1 también existe un script de desinstalación de los componentes de OpenGnsys, con las siguientes características:

  • 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 /opt/opengnsys/images, ni su contenido.

Para realizar la desinstalación, ejecutar el script como usuario root:

sudo /opt/opengnsys/lib/opengnsys_uninstall.sh

Nota: para poder recuperar los datos, se recomienda realizar copia de seguridad de los ficheros del sistema y de la base de datos antes de ejecutar la desinstalación.

Exportar e importar datos de OpenGnsys

(en preparación)

Configuración de OpenGnsys para usar servicios externos

Servicio DHCP externo

Desde la versión 1.0.2 de OpenGnsys utiliza por defecto Grub4Dos en vez PXELinux para realizar el proceso de arranque de los clientes. Incluir las siguientes líneas para configurar el servicio DHCP con Grub4Dos.

# habilitamos la transferencia del nombre por dhcp.
use-host-decl-names on;
# asignamos el servicio pxe con:
next-server ip_opengnsys;
filename  "grldr";

Si nuestro servidor DHCP es proporcionado desde Windows, hay que configurar las siguientes opciones al ámbito donde están los equipos que serán gestionado por OpenGnsys. Se ofrecen dos alternativas válidas proporcionadas en entornos en producción. La diferencia está en la opción 66. Esta opción permite poner el nombre o la dirección IP del servidor OpenGnsys, si elegimos poner el nombre requiere también la opción 60.

Alternativa 1 con la opción 66 con el nombre del servidor OpenGnsys (requiere opción 60)

60 PXEClient (IP del servidor OpenGnsys)
66 Nombre del host del servidor de arranque (Nombre del servidor OpenGnsys)
67 Nombre del archivo de arranque (grldr)

Alternativa 2 con la opción 66 con la dirección IP del servidor OpenGnsys

66 Nombre del host del servidor de arranque (IP del servidor OpenGnsys)
67 Nombre del archivo de arranque (grldr)

Si deseamos que convivan dos o más servidores, por ejemplo uno en producción y otro en pruebas o incluso OpenGnsys con "otro" podemos indicarlo con diferentes líneas next-server en diferentes grupos respectivamente. Cambiar el servidor de un cliente es tan fácil como hacer copiar y pegar los datos del cliente de un grupo a otro.

group {
   next-server [ip_servidor_1];
   host pc1 {
      option host-name "xxx.es";
      hardware ethernet xx:xx:xx:xx:xx:xx;
      fixed-address xxx.xxx.xxx.xxx;
      filename "grldr";
   }
   host pc2 ....
 }
group {
   next-server [ip_servidor_2];
   host pc3 {
      option host-name "xxx.es";
      hardware ethernet xx:xx:xx:xx:xx:xx;
      fixed-address xxx.xxx.xxx.xxx;
      filename "grldr";
   }
   host pc4 ...
 }

Cambio de dirección IP de OpenGnsys Server

A partir de la versión OpenGnsys 1.0.3, se dispone de un script de administración para automatizar el proceso de cambio de dirección IP del módulo OpenGnsys Server en máquinas con varias interfaces de red.

Para realizar el cambio de IP de OpenGnsys Server, ejecutar el script setserveraddr desde una terminal del servidor:

sudo /opt/opengnsys/bin/setserveraddr InterfazRed

Siendo el parámetro InterfazRed el nombre de la interfaz de red que tiene asignada la IP deseada (por ejemplo: eth0, eth1). Para obtener los datos de interfaces de red activas y sus direcciones IP asociadas, ejecutar la orden:

sudo ifconfig

En caso de que sea necesario modificar la dirección IP del repositorio por defecto, se debe acceder a la consola de administración web de OpenGnSys para modificar algunos parámetros de configuración.

  1. Modificar dirección IP del repositorio. Pulsar en el botón Servidores, botón derecho sobre el nombre del repositorio, elegir Propiedades, modificar el campo Dirección IP y pulsar el botón Aceptar.
  2. Forzar la configuración de arranque remoto en los laboratorios afectados por el cambio de repositorio. Pulsar el botón Aulas, botón derecho sobre el nombre de aula, elegir la opción Netboot Avanzado y pulsar sobre el botón Guardar.

Configurando la conectividad HTTPS y SVN en entornos que lo necesiten

  • Exportamos la variable que identifica al proxy a usar.
    export http_proxy="http://proxy.xxx.es:puerto"
    export https_proxy="http://proxy.xxx.es:puerto"
    export ftp_proxy="http://proxy.xxx.es:puerto"
    export ftps_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
    

Opcional: Eliminando el servicio php cron del ubuntu server

Eliminar el fichero /etc/cron.d/php5

Last modified 2 months ago Last modified on Mar 19, 2018, 7:25:57 PM