source: installer/vagrant/README.es.txt

Preparar entorno virtual de desarrollo para OpenGnsys
=====================================================


Ficheros de configuración disponibles:

 - Vagrantfile-prod-vbox   Vagrantfile para OpenGnsys última versión estable con proveedor VirtualBox.
 - Vagrantfile-devel-vbox  Vagrantfile para OpenGnsys en desarrollo con proveedor VirtualBox.
 - Vagrantfile-boottools-vbox  Vagrantfile para preparar el entorno de generación del cliente ogLive (recomendado solo para desarrolladores experimentados).
 - Vagrantfile-browser-vbox    Vagrantfile para preparar el entorno de desarrollo del Browser del cliente (recomendado solo para miembros del grupo de desarrollo).
 - Vagrantfile-ogagent-vbox    Vagrantfile para preparar el entorno de desarrollo del agente OGAgent (recomendado solo para miembros del grupo de desarrollo).


Requisitos previos.

 - Instalar Oracle VM VirtualBox con su Extension Pack.
 - Instalar la última versión oficial de Vagrant.


El entorno de trabajo de OpenGnsys.

 - ogAdministrator: MV para servidor OpenGnsys basada en Ubuntu Server y 2º disco para repositorio.
 - pc11: MV cliente mlodelo con Ubuntu Server instalado.
 - pc12 - pcX: MV clientes para restaurar con disco vacío.


Ejecutar el entorno virtual (Vagrantfile-prod-vbox y Vagrantfile-devel-vbox).

 - Crear un directorio de trabajo.
 - Copiar el fichero Vagrantfile-...-vbox correspondiente en dicho directorio como Vagrantfile.
 - Opcional: editar las variables de configuración del fichero Vagrantfile para el entorno personal.
   - LANGUAGE: idioma (se aceptan es_ES, ca_ES y en_GB).
   - NCLIENTS: nº de clientes a generar (de 2 a 9).
   - REPODISK, REPOSIZE: fichero y tamaño (en GB) del disco virtual para el repositorio de imágenes.
   - SERVERMEM, CLIENTMEM: memoria virtual (en MB) para servidor y clientes (mínimo 512 MB).
   - NETPREFIX: prefijo para las direcciones IP de la red virtual.
   - MACPREFIX: prefijo para las direcciones MAC de los clientes.
   - SERVERIP: dirección IP del servidor OpenGnsys
   - LOCALWEBPORT: puerto local para acceder a la web de administración del servidor.
 - Opcional: para una definición automática del aula virtual con sus clientes, descomentar las líneas del fichero Vagrantfile de los comandos "mysql", "setclientmode" y relacionados.
 - Opcional: para instalar automáticamente el agente de sistema operativo en la MV modelo (pc11), descomentar las líneas del fichero Vagrantfile de los comandos "apt", y relacionados.

 - Iniciar la MV del servidor:
        vagrant up
 - Iniciar las MV de los clientes (tras iniciar el servidor):
   - Cliente modelo:
        vagrant up pc11
   - Clientes vacíos para restaurar:
        vagrant up pcX     (siendo X de 12 al nº máximo definido + 10)

Notas:
 - Los procesos de inicio pueden tardar varios minutos en la primera ejecución porque descargan y configuran las máquinas virtuales.
 - Si se producen errores al instalar paquetes en el servidor, volver a aprovisionarlo ejecutando "vagrant provision" (o "vagrant up --provision", si la MV está parada).
 - Antes de iniciar las MV de los clientes debe accederse a la web de OpenGnsys para crear el aula e incorporar los equipos (o revisar que los datos son correctos).
 - Ignorar los errores de conexión de Vagrant con los clientes vacíos.


Descripción de las MV.

 - Máquina virtual para servidor OpenGnsys.
   - Debe estar iniciada en primer lugar y activa para gestionar los clientes.
   - Usuario de acceso SSH: vagrant, clave: vagrant.
   - La interfaz 2 de VirtualBox está definida en la red privada para las MV del entorno.
   - Instalación de OpenGnsys Server con datos por defecto.
   - Acceder desde un navegador del host local a la web de OpenGnsys en la URL:
        https://localhost:8443/opengnsys/
   - Configurar el DHCP usando las direcciones MAC de los clientes según lo indicado en la definición de la interfaz 2 de cada MV en Virtual Box.

 - Máquinas virtuales para cliente modelo y clientes para clonar.
   - La interfaz 2 de cada MV VirtualBox está definida en la red privada del entorno.
   - Ignorar los posibles errores de conexión de Vagrant.
   - Usar VirtualBox para deshabilitar la interfaz 1 de la MV del cliente modelo.
   - Una vez desplegadas las MV deberán ser controladas directamente con VirtaulBox.