Changes between Initial Version and Version 1 of DocumentacionUsuario1.1.0/EntornosVagrant

Timestamp:

Apr 1, 2016, 12:51:25 PM (9 years ago)

Author:

ramon

Comment:

Creación de la página

DocumentacionUsuario1.1.0/EntornosVagrant

@@ +1 @@
+[[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 [http://opengnsys.es/browser/branches/version1.1/installer/vagrant 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 - ogclient0''N''||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
+}}}
+ 1. 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.
+ 1. Iniciar las MV del cliente modelo (tras iniciar el servidor):
+ {{{
+vagrant up ogClient01
+}}}
+ 1. Usar !VirtualBox para apagar esta máquina virtual y deshabilitar su interfaz de red 1.
+ 1. 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 ===
+
+=== Notas sobre las máquinas virtuales de los clientes ===
+
+
+