wiki:ManualInstalacion

Version 60 (modified by ramon, 13 years ago) (diff)

Actualizar la sección de Instalación

TOC(heading=Índice)?

Instalación de OpenGnSys Server

Notas iniciales

Actualmente, 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).

Los scripts y ficheros de instalación de los componentes de OpenGnSys se encuentran disponibles en el paquete OpenGnSys Installer.

Formas de instalación

Hay tres 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.
  • 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 configuración inicial?, especialmente si se modifica la IP el servidor OpenGnSys.

Script de instalación

La instalación de OpenGnSys se realiza ejecutando el script de instalación opengnsys_installer.sh, el cual puede descargarse directamente de la dirección: http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt

  1. Descarga del script Ejemplos de descarga con varias herramientas:
    1. Descargar con wget.
      wget http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt -O opengnsys_installer.sh
      
    2. Descargar con curl.
      curl http://www.opengnsys.es/browser/trunk/installer/opengnsys_installer.sh?format=txt > opengnsys_installer.sh
      
    3. Descargar con un navegador web: pulsar en el enlace anterior y guardar el archivo con el nombre opengnsys_installer.sh

  1. Configuración básica
    1. 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.
  1. Proceso de instalación
    1. Ejecutar el script como usuario root:
      sudo bash opengnsys_installer.sh
      

Instalación desde un tar.gz

  1. En el caso de que no tengamos acceso al Subversion, p.ej., estemos detrás de un proxy, tendremos que descargar el paquete tgz desde la web.
    1. Accedemos a http://www.opengnsys.es/browser/tags desde un equipo con acceso a Internet y elegimos el paquete deseado.
    2. Nos abrirá ventana, informando que no se puede visualizar dicho paquete, dando la opción de descargarlo.
  2. Cargarlo en el servidor donde vayamos a instalarlo.
  3. Descomprimir el fichero, ejecutando: tar xvzf nombre_del_fichero.tar.gz
  4. Cambiar al subdirectorio del instalador, ejecutando: cd opengnsys/installer
  5. 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.
  6. 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

Instalación manual paso a paso

Para conocer en detalle todos los procesos que realizan los scripts para la instalación manual del sistema OpenGnSys ver en Instalación Manual

Actualizando OpenGnSys

  1. Con acceso al servicio de Subversion
    1. Descargar el fichero de opengnsys_update.
  2. Sin acceso al servicio Subversion
    1. Descargar actualización con una máquina que si lo tenga el subdirectorio trunk completo. svn co http://www.opengnsys.es/svn/trunk
    2. Copiarlo en la máquina donde se vaya a actualizar.
    3. Moverse hasta el subdirectorio installer.
  3. Ejecutar sudo ./opengnsys_update.sh.

Desinstalando OpenGnSys

  1. Hacemos copia de datos sql de la base de datos ogBDAdmin opengnsys.
  2. Eliminamos la base de datos ogBDAdmin
  3. Eliminar mysql: sudo aptitude --purge remove mysql-server
  4. Parar los servicios og: /etc/init.d/opengnsys stop

Configuración de OpenGnSys para usar servicios externos

Servicio dhcp externo

  1. 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
    
  2. En el fichero de configuración del servidor dhcp externo:
    # habilitamos la transferencia del nombre por dhcp.
    use-host-decl-names on;
    # asignamos el servicio pxe con:
    next-server ip_opengnsys;
    

Servicio pxe externo

  1. Copiamos el initrd y linux del /var/lib/tftpboot al servicio pxe externo.
  2. 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).