[[TOC(heading=Índice)]]

= Entornos de desarrollo estandarizados =

Se pretende generar un conjunto de entornos para desarrollo y pruebas de los distintos componentes de OpenGnsys, utilizando herramientas de despliegue automático sobre máquinas virtuales o contenedores.

En una primera instancia, todos los entornos de trabajo se desplegarán utilizando Vagrant (https://www.vagrantup.com/) sobre máquinas virtuales ejecutadas con !VirtualBox (https://www.virtualbox.org/).

== Requisitos previos ==

 - Instalar Oracle VM !VirtualBox 5.0 con su Extension Pack.
 - Instalar la última versión oficial de Vagrant (no usar la incluida en Ubuntu 14.04).
 - Crear un directorio de trabajo para dicho entorno.
 - Descargar en dicho directorio el fichero de configuración del entorno deseado y renombrarlo como {{{Vagrantfile}}}.


== Entornos definidos ==

Los ficheros de configuración de Vagrant para los distintos entornos definidos en OpenGnsys 1.1 pueden descargarse de la [http://opengnsys.es/browser/branches/version1.1/installer/vagrant sección de código fuente] del proyecto o se encuentran en el directorio {{{branches/version1.1/installer/vagrant}}}, si se ha obtenido una copia local del código de OpenGnsys.

||= Fichero =||= Entorno =||= Recomendado para =||
||{{{Vagrantfile-trunk-vbox}}}||Vagrantfile para la versión oficial de OpenGnsys (1.0.x).||Pruebas en general||
||{{{Vagrantfile-devel-vbox}}}||Vagrantfile para la versión de desarrollo de OpenGnsys (1.1.x).||Pruebas y desarrollo general||
||{{{Vagrantfile-boottools-vbox}}}||Vagrantfile para preparar el entorno de generación del cliente ogLive||Desarrolladores experimentados||
||{{{Vagrantfile-ogagent-vbox}}}||Vagrantfile para preparar el entorno de desarrollo del agente OGAgent||Miembros del grupo de desarrollo||




== Entornos de pruebas de OpenGnsys ==

Ambos entornos de pruebas definen el mismo conjunto de máquinas virtuales, por lo que son mutuamente excluyentes.

||= MV =||= Descripción =||
||ogAdministrator||Servidor OpenGnsys, basado en Ubuntu 14.04 y con 2º disco para repositorio||
||ogClient01||Cliente modelo con Ubuntu 14.04 instalado en una única partición||
||ogClient02 - ogclient0''N''||Clientes para restaurar con disco vacío||


=== Configurar entorno de pruebas ===

Una vez elegido el entorno de pruebas deseado, opcionalmente puede editarse el fichero {{{Vagrantfile}}} para personalizar los valores de sus variables de configuración.

||= Variable =||= Descripción =||= Por omisión =||
||{{{LANGUAGE}}}||Idioma (se aceptan {{{es_ES}}}, {{{ca_ES}}} y {{{en_GB}}})||{{{es_ES}}}||
||{{{NCLIENTS}}}||Nº de clientes a generar (de 2 a 9)||{{{4}}}||
||{{{REPODISK}}}||Fichero del disco duro virtual para el repositorio de imágenes||{{{ogRepo.vdi}}}||
||{{{REPOSIZE}}}||Tamaño (en GB) del disco duro virtual para el repositorio de imágenes||{{{50}}}||
||{{{SERVERMEM}}}||Memoria virtual (en MB) para el servidor OpenGnsys||{{{1024}}}||
||{{{CLIENTMEM}}}||Memoria virtual (en MB) para los clientes||{{{512}}}||
||{{{NETPREFIX}}}||Prefijo para las direcciones IP de la red virtual||{{{192.168.2.}}}||
||{{{MACPREFIX}}}||Prefijo para las direcciones MAC de los clientes||{{{08:00:27:0E:65:}}}||
||{{{LOCALWEBPORT}}}||Puerto local para acceder al web de administración de OpenGnsys||{{{8443}}}||

Adicionalmente, los usuarios más experimentados pueden editar el fichero {{{Vagranfile}}} para insertar automáticamente en el servidor OpenGnsys la definición automática de un aula virtual con sus clientes incorporados, descomentando las órdenes relacionadas con los comandos {{{mysql}}} y {{{setclientmode}}}. '''Nota:''' no se recomienda que realicen esta operación los usuarios noveles que están aprendiendo el manejo de OpenGnsys.

=== Iniciar el entorno ===

Las máquinas virtuales deben iniciarse por primera vez en el siguiente orden, esperando a la finalización de cada operación.
 1. Iniciar la MV del servidor OpenGnsys:
 {{{
vagrant up
}}}
 1. Si no se ha preparado la inserción automática de datos, acceder al servidor OpenGnsys para crear un aula e incorporar los ordenadores de los clientes.
 1. Iniciar las MV del cliente modelo (tras iniciar el servidor):
 {{{
vagrant up ogClient01
}}}
 1. Usar !VirtualBox para apagar esta máquina virtual y deshabilitar su interfaz de red 1.
 1. Iniciar las MV  de los clientes vacíos para restaurar (siendo X de 2 al nº máximo definido):
 {{{
vagrant up ogClient0X
}}}

'''Nota:'''
 * Los procesos de inicio pueden tardar varios minutos en la primera ejecución, porque descargan y configuran las máquinas virtuales.
 * Ignorar los errores de conexión de Vagrant con los clientes vacíos.

'''IMPORTANTE:''' una vez que las máquinas virtuales estén definidas correctamente, dejar de usar Vagrant para su manejo y utilizar únicamente las herramientas !VirtualBox.


=== Notas sobre la máquina virtual del servidor OpenGnsys ===

=== Notas sobre las máquinas virtuales de los clientes ===