[[TOC(heading=Índice)]] = Instalación de OpenGNSys Server = == Notas iniciales == Se presupone que el servidor de [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] va a ser instalado en una distribución de GNU/Linux, Ubuntu 9.04 Server de 32 bits. Actualmente el instalador no funciona con 64bits. Los scripts y ficheros de instalación de los componentes de [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] se encuentran disponibles en el paquete [browser:trunk/installer OpenGNSys Installer]. '''NOTA''': En el proceso de instalación se crean usuarios por defecto por lo que se recomienda que se editen para crear los propios. == Formas de instalación == Hay tres formas básicas de instalación del [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys]: * Con un script de instalación. El cual hace uso de Subversion para bajarse la aplicación. * A partir de un tar.gz. En este ya está la aplicación completa. * Instalación manual a paso a paso. Se obvia el script de instalación y se instala componente a componente. Tras la instalación es conveniente repasar la [wiki:ConfigInicial configuración inicial]. Especialmente importante si cambiamos de IP el servidor OpenGnSys. === Script de instalación === La instalación de [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] se realiza ejecutando el script de instalación [browser:trunk/installer/opengnsys_installer.sh opengnsys_installer.sh], el cual puede descargarse directamente de la dirección: [http://www.informatica.us.es:8080/opengnsys/browser/trunk/installer/opengnsys_installer.sh?format=txt] 1. Descarga del script Ejemplos de descarga con varias herramientas: a. Descargar con wget. {{{ wget http://www.informatica.us.es:8080/opengnsys/browser/trunk/installer/opengnsys_installer.sh?format=txt -O opengnsys_installer.sh }}} a. Descargar con curl. {{{ curl http://www.informatica.us.es:8080/opengnsys/browser/trunk/installer/opengnsys_installer.sh?format=txt > opengnsys_installer.sh }}} a. Descargar con un navegador web: pulsar en el enlace anterior y guardar el archivo con el nombre {{{opengnsys_installer.sh}}} 1. Proceso de instalación a. Recomendado cambiar los usuarios y passwords por defecto de los usuarios que se crean editando el instalador `opengnsys_installer.sh`. Busca las variables OPENGNSYS_DB_USER, OPENGNSYS_DB_PASSWD, OPENGNSYS_DB_DEFAULTUSER y OPENGNSYS_DB_DEFAULTPASSWD. Cambia por los valores que desees. a. El script debe ser ejecutado 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. a. Accemos a http://www.informatica.us.es:8080/opengnsys/browser/tags desde un equipo con acceso a internet y elegimos el paquete deseado. a. Nos abrirá ventana, informando que no se puede visualizar dicho paquete, dando la opción de desacargarlo. 1. Cargarlo en el servidor donde vayamos a instalarlo. 1. Dicho tar.gz debemos descomprimirlo (`tar zxvf nombre_del_fichero.tar.gz`). 1. Cambia el nombre del subdirectorio descomprimido a `opengnsys`. 1. Crea el subdirectorio `opengnsys_installer` en `/tmp`. 1. Mover el subdirectorio `opengnsys` en `/tmp/opengnsys_installer`. 1. Cambiamos al usuario root `sudo su` 1. Configurarle el proxy al servidor. p.ej.: `export http_proxy="http://proxy.us.es:3128"` 1. Recomendado cambiar los usuarios y passwords por defecto de los usuarios que se crean editando el instalador `opengnsys_installer.sh`. Busca las variables OPENGNSYS_DB_USER, OPENGNSYS_DB_PASSWD, OPENGNSYS_DB_DEFAULTUSER y OPENGNSYS_DB_DEFAULTPASSWD. Cambia por los valores que desees. 1. Ejecutamos script `/tmp/opengnsys_installer/opengnsys/installer/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 [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] ver en [wiki:InstalacionManual Instalación Manual] == Actualizando [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] == 1. Con acceso al servicio de Subversion 1. Descargar el fichero de opengnsys_update. 1. Sin acceso al servicio Subversion 1. Descargar actualización con una máquina que si lo tenga el subdirectorio trunk completo. `svn co svn://www.informatica.us.es/opengnsys/trunk` 1. Copiarlo en la máquina donde se vaya a actualizar. 1. Moverse hasta el subdirectorio `installer`. 1. Ejecutar `sudo ./opengnsys_update.sh`. == Desinstalando [http://www.informatica.us.es:8080/opengnsys/wiki OpenGnSys] == 1. Hacemos copia de datos sql de la base de datos ogBDAdmin opengnsys. 1. Eliminamos la base de datos ogBDAdmin 1. Eliminar mysql: `sudo aptitude --purge remove mysql-server` 1. 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 }}} 1. 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. 1. 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).