| 1 | |
|---|
| 2 | Preparar entorno virtual de desarrollo para OpenGnsys |
|---|
| 3 | ===================================================== |
|---|
| 4 | |
|---|
| 5 | |
|---|
| 6 | Ficheros de configuración disponibles: |
|---|
| 7 | |
|---|
| 8 | - Vagrantfile-prod-vbox Vagrantfile para OpenGnsys última versión estable con proveedor VirtualBox. |
|---|
| 9 | - Vagrantfile-devel-vbox Vagrantfile para OpenGnsys en desarrollo con proveedor VirtualBox. |
|---|
| 10 | - Vagrantfile-boottools-vbox Vagrantfile para preparar el entorno de generación del cliente ogLive (recomendado solo para desarrolladores experimentados). |
|---|
| 11 | - Vagrantfile-browser-vbox Vagrantfile para preparar el entorno de desarrollo del Browser del cliente (recomendado solo para miembros del grupo de desarrollo). |
|---|
| 12 | - Vagrantfile-ogagent-vbox Vagrantfile para preparar el entorno de desarrollo del agente OGAgent (recomendado solo para miembros del grupo de desarrollo). |
|---|
| 13 | |
|---|
| 14 | |
|---|
| 15 | Requisitos previos. |
|---|
| 16 | |
|---|
| 17 | - Instalar Oracle VM VirtualBox con su Extension Pack. |
|---|
| 18 | - Instalar la última versión oficial de Vagrant. |
|---|
| 19 | |
|---|
| 20 | |
|---|
| 21 | El entorno de trabajo de OpenGnsys. |
|---|
| 22 | |
|---|
| 23 | - ogAdministrator: MV para servidor OpenGnsys basada en Ubuntu Server y 2º disco para repositorio. |
|---|
| 24 | - pc11: MV cliente mlodelo con Ubuntu Server instalado. |
|---|
| 25 | - pc12 - pcX: MV clientes para restaurar con disco vacío. |
|---|
| 26 | |
|---|
| 27 | |
|---|
| 28 | Ejecutar el entorno virtual (Vagrantfile-prod-vbox y Vagrantfile-devel-vbox). |
|---|
| 29 | |
|---|
| 30 | - Crear un directorio de trabajo. |
|---|
| 31 | - Copiar el fichero Vagrantfile-...-vbox correspondiente en dicho directorio como Vagrantfile. |
|---|
| 32 | - Opcional: editar las variables de configuración del fichero Vagrantfile para el entorno personal. |
|---|
| 33 | - LANGUAGE: idioma (se aceptan es_ES, ca_ES y en_GB). |
|---|
| 34 | - NCLIENTS: nº de clientes a generar (de 2 a 9). |
|---|
| 35 | - REPODISK, REPOSIZE: fichero y tamaño (en GB) del disco virtual para el repositorio de imágenes. |
|---|
| 36 | - SERVERMEM, CLIENTMEM: memoria virtual (en MB) para servidor y clientes (mínimo 512 MB). |
|---|
| 37 | - NETPREFIX: prefijo para las direcciones IP de la red virtual. |
|---|
| 38 | - MACPREFIX: prefijo para las direcciones MAC de los clientes. |
|---|
| 39 | - SERVERIP: dirección IP del servidor OpenGnsys |
|---|
| 40 | - LOCALWEBPORT: puerto local para acceder a la web de administración del servidor. |
|---|
| 41 | - 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. |
|---|
| 42 | - 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. |
|---|
| 43 | |
|---|
| 44 | - Iniciar la MV del servidor: |
|---|
| 45 | vagrant up |
|---|
| 46 | - Iniciar las MV de los clientes (tras iniciar el servidor): |
|---|
| 47 | - Cliente modelo: |
|---|
| 48 | vagrant up pc11 |
|---|
| 49 | - Clientes vacíos para restaurar: |
|---|
| 50 | vagrant up pcX (siendo X de 12 al nº máximo definido + 10) |
|---|
| 51 | |
|---|
| 52 | Notas: |
|---|
| 53 | - Los procesos de inicio pueden tardar varios minutos en la primera ejecución porque descargan y configuran las máquinas virtuales. |
|---|
| 54 | - 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). |
|---|
| 55 | - 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). |
|---|
| 56 | - Ignorar los errores de conexión de Vagrant con los clientes vacíos. |
|---|
| 57 | |
|---|
| 58 | |
|---|
| 59 | Descripción de las MV. |
|---|
| 60 | |
|---|
| 61 | - Máquina virtual para servidor OpenGnsys. |
|---|
| 62 | - Debe estar iniciada en primer lugar y activa para gestionar los clientes. |
|---|
| 63 | - Usuario de acceso SSH: vagrant, clave: vagrant. |
|---|
| 64 | - La interfaz 2 de VirtualBox está definida en la red privada para las MV del entorno. |
|---|
| 65 | - Instalación de OpenGnsys Server con datos por defecto. |
|---|
| 66 | - Acceder desde un navegador del host local a la web de OpenGnsys en la URL: |
|---|
| 67 | https://localhost:8443/opengnsys/ |
|---|
| 68 | - 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. |
|---|
| 69 | |
|---|
| 70 | - Máquinas virtuales para cliente modelo y clientes para clonar. |
|---|
| 71 | - La interfaz 2 de cada MV VirtualBox está definida en la red privada del entorno. |
|---|
| 72 | - Ignorar los posibles errores de conexión de Vagrant. |
|---|
| 73 | - Usar VirtualBox para deshabilitar la interfaz 1 de la MV del cliente modelo. |
|---|
| 74 | - Una vez desplegadas las MV deberán ser controladas directamente con VirtaulBox. |
|---|
| 75 | |
|---|
