Instalar Open edX Ginkgo 2 en Debian 9

Este articulo explica como instalar la plataforma Open edX Ginkgo 2 Rev.1 usando el instalador de Bitnami en Debian 9 Stretch en modo de pruebas local en su PC.

Las metas específicas a lograr con este articulo es la siguiente:

  • Descripción general del proyecto.
  • Instalar y configurar Open edX Ginkgo 2.
  • Instalar un curso demostrativo de ejemplo.
  • Conocer los detalles de la instalación de Open edX.
  • Gestionar la plataforma Open edX.
  • Ajustar las configuraciones de la plataforma Open edX.
  • Acceder a la plataforma Open edX vía Web.
  • Auditar el registro de eventos de la plataforma Open edX.

Introducción

Figura 1 - Logotipo de Open edX

Figura 1 – Logotipo de Open edX

Acerca de Open edX

edX es un proveedor masivo de cursos en línea abiertos (MOOC) y plataforma de aprendizaje en línea. Este hospeda cursos en línea de nivel universitario en una amplia gama de disciplinas para una audiencia mundial. Open edX se ha desarrollado como software de código abierto y puesto a disposición de otras instituciones de aprendizaje superior que quieren hacer ofertas similares.

Puede obtener más información sobre Open edX en http://open.edx.org/

Stack de Bitnami para Open edX

Figura 2 - Open edX con Bitnami

Figura 2 – Open edX con Bitnami

El Stack de Bitnami para Open edX, es un instalador que simplifica enormemente instalación de Open edX y dependencias de tiempo de ejecución. Incluye listo para funcionar versiones de Apache, Elasticsearch, Erlang, Java, Memcached, Mysql, MongoDB, Node, RabbitMQ, Erlang, Python y Ruby on Rails. Este stack es distribuido de forma gratuita bajo la licencia Affero GPL.

Componentes del Stack

El Stack de Bitnami para Open edX incluye las siguientes versiones de software:

  • Open edX Ginkgo 2
  • Apache 2.4.29
  • Elasticsearch 0.90.11
  • Erlang 20.1
  • Java 1.8.0_151
  • Memcached 1.5.4
  • MongoDB 2.6.12
  • Mysql 5.6.38
  • Node.js 6.12.2
  • Python 2.7.14
  • RabbitMQ 3.7.2
  • Rails 4.2.8
  • Ruby 2.3.6
  • RubyGems 2.6.14

¿Qué componentes están incluidos en el Stack de Bitnami para Open edX?

Hay tres componentes principales incluidos en el Open edX con tecnología de Bitnami:

  • edX Platform: pieza central de la arquitectura Open edX. Contiene el Learning Management System (LMS) y el Course Management System (CMS), llamado Studio.
  • XQueue: el cual es una aplicación desplegada de forma independiente, que define una interfaz para que el LMS se comunique con los servicios de gradadores externos.
  • Forum: el cual es una aplicación desplegada de forma independiente, utilizado por el LMS a través de API para integrar las discusiones en la experiencia del curso de los alumnos.

Hay otros componentes incluidos en el Stack, los cuales requieren los servicios de Open edX como RabbitMQ, MongoDB, MySQL, Memcached, Apache o Elasticsearch.

Más detalles de la arquitectura de componentes consulte el articulo Open edX Developer’s Guide documentation de la Wiki del proyecto Open edX Architecture.

Instalación del Stack

Figura 3 - Open edX Ginkgo

Figura 3 – Open edX Ginkgo

Se instalará Open edX Ginkgo 2 usando el instalador para Linux del Stack de Bitnami en Debian 9 Stretch.

Requerimientos del Stack

Para instalar el Stack de Bitnami para Open edX usted necesita cumplir con los siguientes requerimientos:

  • Intel x86 o procesador compatible.
  • Mínimo de 6144 MB RAM.
  • Mínimo de 25 GB espacio en disco duro.
  • Soporte al protocolo TCP/IP.
  • Sistema operativo Linux compatible con arquitecturas x86 o x64.

Instalando

Luego de descargar el programa de instalación aquí, usted debe otorgar permisos de ejecución del instalador vía consola, con el siguiente comando:

$ chmod +x bitnami-edx-ginkgo.2-1-linux-x64-installer.run

Luego puede iniciar el proceso de instalación, ejecutando el siguiente comando:

$ ./bitnami-edx-ginkgo.2-1-linux-x64-installer.run

Este mostrará una ventana como la siguiente:

Figura 4 - Iniciar el instalador del Stack de Bitnami para Open edX

Figura 4 – Iniciar el instalador del Stack de Bitnami para Open edX

 

Figura 5 - Seleccionar que componentes va instalar

Figura 5 – Seleccionar que componentes va instalar

 

Figura 6 - Indicar en que ruta instalar el Open edX

Figura 6 – Indicar en que ruta instalar el Open edX

 

Figura 7 - Crear cuenta de usuario administrador

Figura 7 – Crear cuenta de usuario administrador

ADVERTENCIA: Este usuario y contraseña debe anotarlo por que serán utilizado para labores administrativas vía consola o Web.

Figura 8 - Configurar el puerto del servidor RabbitMQ

Figura 8 – Configurar el puerto del servidor RabbitMQ

 

Figura 9 - Definir el nombre del host

Figura 9 – Definir el nombre del host

 

Figura 10 - Configurar ajustes de SMTP

Figura 10 – Configurar ajustes de SMTP

 

Figura 11 - Deshabilitar despliegue en la nube

Figura 11 – Deshabilitar despliegue en la nube

 

Figura 12 - Listo para iniciar la instalación

Figura 12 – Listo para iniciar la instalación

NOTA: Al iniciar el proceso puede tardar mucho, en mi caso duro un total de 7 horas todo el proceso de instalación, claro esta, esto puede variar de la cantidad de memoria y velocidad del procesador de su PC.

Figura 13 - Instalando - Preparando para instalar

Figura 13 – Instalando – Preparando para instalar

 

Figura 14 - Instalando - Desempacando archivos

Figura 14 – Instalando – Desempacando archivos

 

Figura 15 - Instalando base de datos MySQL

Figura 15 – Instalando base de datos MySQL

 

Figura 16 - Instalando - iniciando los servicios

Figura 16 – Instalando – iniciando los servicios

 

Figura 17 - Instalando - Failed to load module

Figura 17 – Instalando – Failed to load module “canberra-gtk-module”

ADVERTENCIA: Si el proceso de instalación muestre un mensaje como Failed to load module “canberra-gtk-module”, es debido a que debe instalar una dependencias necesarias para el correcto funcionamiento luego de culminar la instalación, ejecutando el siguiente comando:

$ sudo apt install libcanberra-gtk-module libcanberra-gtk3-module

 

Figura 18 - Instalando - ejecutando scripts de migración XQueue

Figura 18 – Instalando – ejecutando scripts de migración XQueue

 

Figura 19 - Instalando - generando archivos assets de la plataforma edX

Figura 19 – Instalando – generando archivos assets de la plataforma edX

 

Figura 20 - Ejecutando scripts de plataforma edX

Figura 20 – Ejecutando scripts de plataforma edX

 

Figura 21 - Completado instalación e inicie el servicio Open edX

Figura 21 – Completado instalación e inicie el servicio Open edX

Luego de finalizar la instalación, iniciará el panel de control del Stack de Bitnami, como se presente a continuación:

Figura 22 - Panel de control de Bitnami para edX versión Ginkgo 2

Figura 22 – Panel de control de Bitnami para edX versión Ginkgo 2

Detalles de instalación

A continuación se describe algunos detalles de los directorios de instalación realizada previamente:

Directorio principal de instalación

~/edx-ginkgo.2-1/

Script del panel de control de Bitnami

~/edx-ginkgo.2-1/manager-linux-x64.run

Directorio del servicio Apache 2 HTTP server

~/edx-ginkgo.2-1/apache2/

Directorio del servicio ElasticSearch

~/edx-ginkgo.2-1/elasticsearch/

Ejecutable de Erlang

~/edx-ginkgo.2-1/erlang/bin/erl

Ejecutable de Git

~/edx-ginkgo.2-1/git/bin/git

Directorio principal de Java

~/edx-ginkgo.2-1/java/

Ejecutable de Java

~/edx-ginkgo.2-1/java/bin/java

Ejecutable de memcached

~/edx-ginkgo.2-1/memcached/bin/memcached

Directorio principal de MongoDB

~/edx-ginkgo.2-1/mongodb/

Ejecutable de MongoDB

~/edx-ginkgo.2-1/mongodb/bin/mongod

Directorio principal de MySQL

~/edx-ginkgo.2-1/mysql/

Ejecutable del servidor MySQL

~/edx-ginkgo.2-1/mysql/bin/mysql

Directorio principal de NodeJS

~/edx-ginkgo.2-1/nodejs/

Ejecutable de NodeJS

~/edx-ginkgo.2-1/nodejs/bin/node

Ejecutable de NPM

~/edx-ginkgo.2-1/nodejs/bin/npm

Directorio principal de Perl

~/edx-ginkgo.2-1/perl/

Ejecutable de Perl

~/edx-ginkgo.2-1/perl/bin/perl

Directorio principal de Python

~/edx-ginkgo.2-1/python/bin/python

Ejecutable de Python

~/edx-ginkgo.2-1/python/bin/python

Entorno virtual Python “edxapp”

~/edx-ginkgo.2-1/apps/edx/venvs/edxapp/

Directorio principal de RabbitMQ

~/edx-ginkgo.2-1/rabbitmq/

Directorio principal de Postgresql

~/edx-ginkgo.2-1/postgresql/

Ejecutable de Postgresql

~/edx-ginkgo.2-1/postgresql/bin/pg_config

Directorio principal de Ruby

~/edx-ginkgo.2-1/ruby/

Ejecutable del script Gem

~/edx-ginkgo.2-1/ruby/bin/gem

Ejecutable de Ruby

~/edx-ginkgo.2-1/ruby/bin/ruby

Ejecutable de Sqlite3

~/edx-ginkgo.2-1/sqlite/bin/sqlite3

Gestión de la plataforma Open edX

Para gestionar la plataforma Open edX, disponen un panel de configuración disponible del Stack de Bitnami, ejecute el siguiente comando:

$ ~/edx-ginkgo.2-1/manager-linux-x64.run &

Al ejecutar el comando debe mostrar en panel de control del Stack de Bitnami como la siguiente pantalla:

Figura 23 - Panel de control de Bitnami edX versión Ginkgo 2

Figura 23 – Panel de control de Bitnami edX versión Ginkgo 2

Pestaña Welcome, esta muestra la bienvenida al panel de control del Stack Bitnami.

Figura 24 - Pestaña Manage Servers del Panel de control Bitnami

Figura 24 – Pestaña Manage Servers del Panel de control Bitnami

Pestaña Manage Servers, esta muestra el listado de servicios del lado izquierdo, del lado derecho están los botones Start, Stop, Restart  y Configure; los cuales sirven para gestionar cada servicio por separado. En la parte interior están los botones Start All, Stop All y Restart All; los cuales sirven para gestionar todos servicios por completo al mismo tiempo.

Figura 25 - Pestaña Servers Events del Panel de control Bitnami

Figura 25 – Pestaña Servers Events del Panel de control Bitnami

Pestaña Servers Events, esta muestra los detalles de eventos de errores o notificaciones de cada servicio al Iniciar, Detener o Reiniciar cada servicio.

Acceder a la plataforma Open edX

Luego de culminar la instalación tiene disponibles varios recursos Web disponibles los cuales se describen a continuación:

Homepage de Bitnami

Abra el navegador en la siguiente dirección URL http://127.0.0.1:8080/bitnami/index.html, en esta dirección Web lucirá como la siguiente captura de pantalla:

Figura 26 - Homepage de Bitnami

Figura 26 – Homepage de Bitnami

Este recurso Web es para ofrecerle información de la instalación disponible.

Open edX LMS

Abra el navegador en la siguiente dirección URL  http://localhost:8080/courses/, en esta dirección Web lucirá como la siguiente captura de pantalla:

Figura 27 - Plataforma LMS Open edX

Figura 27 – Plataforma LMS Open edX

Este recurso Web es una aplicación Web LMS, el cual es usada por los usuarios potenciales de cursos o usuarios participantes de cursos actualmente.

Consejo: Para acceder a esta aplicación puede usar el usuario y la contraseña definido en el proceso de instalación ilustrado anteriormente en la Figura 7.

edX Demostration Course

Abra el navegador en la siguiente dirección URL: http://localhost:8080/courses/course-v1:edX+DemoX+Demo_Course/, en esta dirección Web lucirá como la siguiente captura de pantalla:

Figura 28 - Curso de demostración edX

Figura 28 – Curso de demostración edX

Este recurso Web es el curso de demostración edX, el cual se indico que se creara durante el proceso de instalación, este se usa con la aplicación Web LMS.

Nota: Usted puede acceder al curso de demostración edX debido a que indico su creación en el proceso de instalación ilustrado anteriormente en la Figura 5.

Open edX Studio (CMS)

Abra el navegador en la siguiente dirección URL: http://127.0.1.1:18010/, en esta dirección Web lucirá como la siguiente captura de pantalla:

Figura 29 - Open edX Studio (CMS)

Figura 29 – Open edX Studio (CMS)

Este recurso Web es una aplicación Web CMS destinada para la creación de contenidos MOOC, el cual es usada por los usuarios instructores de cursos o creadores de los mismos.

Consejo: Para acceder a esta aplicación puede usar el usuario y la contraseña definido en el proceso de instalación ilustrado anteriormente en la Figura 7.

Open edX Django Admin

Abra el navegador en la siguiente dirección URL: http://127.0.0.1:8080/admin/, en esta dirección Web lucirá como la siguiente captura de pantalla:

Figura 30 - Open edX Django Admin

Figura 30 – Open edX Django Admin

Este recurso Web es para administrar la plataforma Open Edx, como esta en gran medida esta desarrollada con el Framework Django entonces muchas de las configuraciones de Open Edx se pueden realizar a través de esta interfaz administrativa Web de Django.

Consejo: Para acceder a esta aplicación puede usar el usuario y la contraseña definido en el proceso de instalación ilustrado anteriormente en la Figura 7.

Configuración

Para ajustar las configuraciones de cada uno de los diversos servicios de la plataforma Open edX, usted debe modificar sus archivos de configuraciones y vuelva a iniciar de nuevo los servicios, a continuación se listan cada archivo y su ubicación por servicios:

Configuración principal para el servidor HTTP

~/edx-ginkgo.2-1/apache2/conf/httpd.conf

Configuración Virtual Host general del servidor HTTP

~/edx-ginkgo.2-1/apps/edx/conf/httpd-vhosts.conf

Configuración Virtual Host de aplicación Open edX Studio (CMS)

~/edx-ginkgo.2-1/apps/edx/conf/httpd-cms.conf

Configuración Virtual Host de aplicación Open edX LMS

~/edx-ginkgo.2-1/apps/edx/conf/httpd-lms.conf

Configuración principal para el servidor ElasticSearch

~/edx-ginkgo.2-1/elasticsearch/config/elasticsearch.yml

Configuración principal para el servidor MongoDB

~/edx-ginkgo.2-1/mongodb/mongodb.conf

Configuración principal para el servidor MySQL

~/edx-ginkgo.2-1/mysql/my.cnf

Configuración principal para el servidor RabbitMQ

~/edx-ginkgo.2-1/rabbitmq/etc/rabbitmq/rabbitmq.config

Configuración principal de variables para RabbitMQ

~/edx-ginkgo.2-1/rabbitmq/etc/rabbitmq/rabbitmq-env.conf

Configuración de autenticación de Open edX Studio (CMS)

~/edx-ginkgo.2-1/apps/edx/conf/cms.auth.json

Configuración para la aplicación Open edX Studio (CMS)

~/edx-ginkgo.2-1/apps/edx/conf/cms.env.json

Configuración de autenticación de la aplicación Open edX LMS

~/edx-ginkgo.2-1/apps/edx/conf/lms.auth.json

Configuración para la aplicación Open edX LMS

~/edx-ginkgo.2-1/apps/edx/conf/lms.env.json

Registro de eventos (archivo log)

Para depurar posibles errores o auditar notificaciones de la plataforma Open edX, la cual incluye varios servicios en Stack de instalación, a continuación se describen cada registro de evento por servicios:

Archivo de registro acceso en el servidor HTTP

Para auditar los accesos al servidor HTTP, puede consultar el archivo log, con el siguiente comando:

$ tail -f ~/edx-ginkgo.2-1/apache2/logs/access_log

Archivo de registro de errores en el servidor HTTP

Para depurar posibles errores o notificaciones del servidor HTTP, puede consultar el archivo log, con el siguiente comando:

$ tail -f ~/edx-ginkgo.2-1/apache2/logs/error_log

Archivo de registro en el servidor RabbitMQ

Para depurar posibles errores o notificaciones del servidor RabbitMQ, puede consultar el archivo log, con el siguiente comando:

$ tail -f ~/edx-ginkgo.2-1/rabbitmq/var/log/rabbitmq/rabbitmq@localhost.log

Archivo de registro en el servidor MongoDB

Para depurar posibles errores del servidor MongoDB, puede consultar el archivo log, con el siguiente comando:

$ tail -f ~/edx-ginkgo.2-1/mongodb/log/mongodb.log

Archivo de registro en el servidor MySQL

Para depurar posibles errores o notificaciones del servidor MySQL, puede consultar el archivo log, con el siguiente comando:

$ tail -f ~/edx-ginkgo.2-1/mysql/data/mysqld.log

Archivo de registro de la aplicación Open edX Studio (CMS)

Para depurar posibles errores o notificaciones de la aplicación Open edX Studio (CMS), puede consultar el archivo log, con el siguiente comando:

$ tail -f ~/edx-ginkgo.2-1/apps/edx/var/log/cms/edx.log

Archivo de registro de la aplicación Open edX LMS

Para depurar posibles errores o notificaciones de la aplicación Open edX LMS, puede consultar el archivo log, con el siguiente comando:

$ tail -f ~/edx-ginkgo.2-1/apps/edx/var/log/lms/edx.log

Conclusiones

De esta forma usted ha aprendido a:

  • Instalar la plataforma Open edX.
  • Conocer los detalles de la instalación de Open edX desde el sistema de archivo.
  • Gestionar la plataforma Open edX desde el panel de control Bitnami.
  • Ajustar las configuraciones de la plataforma Open edX.
  • Acceder a la plataforma Open edX vía Web.
  • Auditar el registro de eventos de la plataforma Open edX.

Espero en próximas entradas sobre Open edX tocar sobre temas como múltiples sitios para diversos clientes y como personalizar la apariencia de esos sitios a las marcas de cada cliente usuario de la plataforma Open edX.

Referencias

¡Haz tu donativo!

Si te gusto este articulo, por favor, ayúdame a seguir escribiendo este tipo de articulo, haciendo donativos en Dólares vía el servicio Paypal haciendo clic aquí o en la siguiente imagen.


PayPal - The safer, easier way to pay online!


También puede realizar su donativo con Bitcoin (BTC) en escaneando el siguiente código QR:

¡Ayúdame a continuar Blog de lcaballero.wordpress.com!

O usando en la siguiente dirección:

bitcoin:13uZUXXqLP3Ct3ksWHXnDqSrbMbhDV9hGz

Anuncios

Responder

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión /  Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión /  Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión /  Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión /  Cambiar )

Conectando a %s