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
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
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, PythonyRuby 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
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 5 – Seleccionar que componentes va instalar
Figura 6 – Indicar en que ruta instalar el Open edX
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 9 – Definir el nombre del host
Figura 10 – Configurar ajustes de SMTP
Figura 11 – Deshabilitar despliegue en la nube
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 14 – Instalando – Desempacando archivos
Figura 15 – Instalando base de datos MySQL
Figura 16 – Instalando – iniciando los servicios
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 19 – Instalando – generando archivos assets de la plataforma edX
Figura 20 – Ejecutando scripts de plataforma 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
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
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
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
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
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
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
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)
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
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.
También puede realizar su donativo con Bitcoin (BTC) en escaneando el siguiente código QR:
O usando en la siguiente dirección:
bitcoin:13uZUXXqLP3Ct3ksWHXnDqSrbMbhDV9hGz