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/).
Vagrantfile.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 OpenGnsys-Git/installer/vagrant, si se ha obtenido una copia local del código de OpenGnsys.
| Fichero | Entorno | Recomendado para |
|---|---|---|
Vagrantfile-1.1.1a-vbox |
Vagrantfile para la versión oficial de OpenGnsys (1.1.1a). | Pruebas en general |
Vagrantfile-prod-vbox |
Vagrantfile para la última versión oficial de OpenGnsys. | Pruebas en general |
Vagrantfile-master-vbox |
Vagrantfile para la versión de desarrollo de OpenGnsys. | Pruebas y desarrollo general |
Vagrantfile-devel-vbox |
Vagrantfile para la versión de desarrollo de OpenGnsys (alias de Vagrantfile-master-vbox). | Pruebas y desarrollo general |
Vagrantfile-boottools-vbox |
Vagrantfile para preparar el entorno de generación del cliente ogLive | Desarrolladores experimentados |
Vagrantfile-browser-vbox |
Vagrantfile para preparar el entorno de compilación del Browser del cliente | Miembros del grupo de desarrollo |
Vagrantfile-ogagent-vbox |
Vagrantfile para preparar el entorno de desarrollo del agente OGAgent | Miembros del grupo de desarrollo |
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 16.04 para la versión 1.1.0a y en Ubuntu 18.04 para la versión 1.1.1a) con 2º disco para repositorio |
| pc11 | Cliente modelo (con Ubuntu 16.04 para la versión 1.1.0a y Ubuntu 18.04 para la versión 1.1.1a) instalado en una única partición |
| pc12 - pc_N_ | Clientes para restaurar con disco vacío y arranque PXE |
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 |
Aviso: el ordenador que ejecute este entorno deberá disponer de una cantidad de memoria superior al valor de SERVERMEM+NCLIENTS*CLIENTMEM (en MB).
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.
Las máquinas virtuales deben iniciarse por primera vez en el siguiente orden, esperando a la finalización de cada operación.
vagrant up
https://localhost:8443/opengnsys/, o el puerto especificado en la variable LOCALWEBPORT). vagrant up pc11
vagrant up pc1X
Nota:
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.
vagrant/vagrant.LOCALWEBPORT del fichero de despliegue).El fichero Vagrantfile-boottools-vbox define un entorno virtual para generar distribuciones ISO de clientes ogLive, generando una única máquina virtual (ogBootTools) basada en Ubuntu 16.04 Server de 64 bits. Dicho fichero puede editarse para modificar los variables de configuración.
| Variable | Descripción | Por omisión |
|---|---|---|
LANGUAGE |
Idioma | es_ES |
VMMEM |
Memoria virtual (en MB) | 1024 |
Iniciar y desplegar la MV con los requisitos necesarios:
vagrant up
Una vez finalizado el despliegue, utilizar !VirtualBox para acceder a la máquina virtual con usuario vagrant y clave vagrant y ejecutar el script boottoolsgenerator.sh según las instrucciones de generación de la distribución del cliente ogLive.
Nota: puede ser necesario pulsar [Intro] para continuar la instalación de los paquetes davfs2 y kexec-tools.
El fichero Vagrant-browser-vbox define un entorno de desarrollo y programación para crear el Browser web que utiliza el cliente OpenGnsys para presentar los menús de usuario, generando una única máquina virtual (ogBrowser) basada en Ubuntu 14.04 Server de 32 bits que compilar e instala el entorno Qt Embedded 4.8. Este fichero puede editarse para modificar los variables de configuración.
| Variable | Descripción | Por omisión |
|---|---|---|
LANGUAGE |
Idioma | es_ES |
VMMEM |
Memoria virtual (en MB) | 4096 |
VMCPUS |
Procesadores virtuales | 4 |
Iniciar y desplegar la MV con los requisitos necesarios:
vagrant up
Notas:
/vagrant.Para acceder a la máquina virtual, ejecutar:
vagrant ssh
El código fuente del Browser se encuentra en el directorio /home/vagrant/browser y para obtener una nueva compilación, ejecutar sudo make. Una vez compilado el Browser, deberán copiarse al servidor OpenGnsys los siguientes ficheros:
browser al directorio /opt/opengnsys/client/bin del servidor.ldd browser|grep libQt) al directorio /opt/opengnsys/client/lib/qtlibs del servidor.El fichero Vagrant-ogagent-vbox define un entorno de desarrollo y programación del agente para sistemas operativos OGAgent, generando una única máquina virtual (ogAgent) basada en Fedora 25 Cloud que incluye: escritorio ligero XFCE 4, navegador web Firefox, Wine para ejecutar programas Windows, entorno de programación Atom (o descomentar las líneas correspondientes para instalar Eclipse). para ejecutar programas Windows y utilidades varias. Este fichero puede editarse para modificar los variables de configuración.
| Variable | Descripción | Por omisión |
|---|---|---|
LANGUAGE |
Idioma | es_ES |
VMMEM |
Memoria virtual (en MB) | 4096 |
VMCPUS |
Procesadores virtuales | 4 |
Iniciar y desplegar la MV con los requisitos necesarios:
vagrant up
Aunque durante el despliegue se iniciará una ventana para acceder a la MV, el usuario debe esperar a que finalice el proceso de despliegue, el cual puede tardar varios minutos porque tiene que descargar e instalar un número importante de paquetes.
Una vez finalizado este proceso, utilizar !VirtualBox para acceder a la máquina virtual con usuario vagrant y clave vagrant y reiniciarla (o entrar directamente en el entorno gráfico, ejecutando "startxfce4 &").
Para generar los paquetes del cliente OGAgent, debe abrirse una terminal de comandos y ejecutar:
bash ogagent-devel-installer.sh
Puede utilizar cualquier entorno de programación para realizar modificaciones del código en el agente OGAgent. Si se ha elegido Eclipse, debe configurarse siguiendo estos pasos:
/home/vagrant/ogagent/src