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 ​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 - ogclient0N	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
   

2. 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.
3. Iniciar las MV del cliente modelo (tras iniciar el servidor):

   vagrant up ogClient01
   

4. Usar VirtualBox para apagar esta máquina virtual y deshabilitar su interfaz de red 1.
5. 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

• Debe estar iniciada en primer lugar y activa para gestionar los clientes.
• Usuario/clave para acceso SSH: vagrant/vagrant.
• La interfaz 2 de VirtualBox está definida en la red privada para las MV del entorno de pruebas.
• Instalación de OpenGnsys Server con datos de acceso por defecto.
• Para acceder a la web de administración de OpenGnsys, utilizar un navegador del host local con la URL ​https://localhost:8443/opengnsys/ (o el puerto indicado en la variable LOCALWEBPORT del fichero de despliegue).
• Si no se han quitado los comentarios para la configuración automática, incluir en el DHCP las direcciones MAC de los clientes según lo indicado en la definición de la interfaz 2 de cada MV en VirtualBox.

Notas sobre las máquinas virtuales de los clientes

• La interfaz 2 de cada MV VirtualBox está definida en la red privada del entorno.
• Ignorar los posibles errores de conexión de Vagrant a las MV vacías.
• Usar VirtualBox para deshabilitar la interfaz 1 de la MV del cliente modelo ogClient01.
• Una vez desplegadas las MV deberán ser controladas directamente con VirtaulBox (no usar Vagrant).

Entorno para desarrollo de cliente ogLive

Entorno para desarrollo de agente OGAgent