summaryrefslogtreecommitdiffstats
path: root/installer/vagrant/README.es.txt
blob: bc5888fe3575f90458d9dc289bb6f9af0cbb5e3f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

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 16.04 y 2º disco para repositorio.
 - pc11: MV cliente mlodelo con Ubuntu 16.04 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 256 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 al 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" y "setclientmode".

 - 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.