Después de un apagado forzoso, Redis no pudo iniciarse correctamente. Los registros (logs) muestran el siguiente error:

{"log":"1:M 10 May 2025 07:25:48.404 * DB loaded from base file appendonly.aof.782.base.rdb: 3.577 seconds\n","stream":"stdout","time":"2025-05-10T07:25:48.404514303Z"}
{"log":"1:M 10 May 2025 07:25:49.182 # Bad file format reading the append only file appendonly.aof.782.incr.aof: make a backup of your AOF file, then use ./redis-check-aof --fix \u003cfilename.manifest\u003e\n","stream":"stdout","time":"2025-05-10T07:25:49.182706082Z"}

Este error indica que el archivo appendonly.aof está corrupto. Para corregirlo, es necesario usar el comando docker, ya que el contenedor no inicia y, por lo tanto, no es posible acceder con tutor local exec redis bash.

Atención
Se recomienda realizar una copia de seguridad del archivo AOF antes de ejecutar el comando de reparación.

Pasos para corregir el problema:

1. Accede al directorio donde se encuentran los datos de Redis:

cd .local/share/tutor/data/redis

2. Inicia un contenedor de Redis montando el directorio actual:

docker run --rm -it -v ./:/data redis   sh

Nota
También puedes usar bash si la imagen de Redis lo permite.

3. Dentro del contenedor, ejecuta el siguiente comando para intentar reparar el archivo AOF:

redis-check-aof --fix /path/archivo.manifest

Este comando te preguntará si deseas truncar el archivo para corregirlo. Acepta y espera a que finalice el proceso.

4. Una vez finalizada la reparación, puedes salir del contenedor.

5. Finalmente, inicia Redis nuevamente:

tutor local start -d redis

Cada vez es mas comun que los servidores sean suceptibles a ataques via ssh, generalmente se usan herramientas como fail2ban la cual permite el bloquear IPs por tiempo determinado, pero aun asi se siguen recibiendo ataques. Pero si queremos detener por completo los ataques es mejor aplicar un filtro por geolocalización.

En este caso vamos a usar la base de datos de GeoIP para bloquear los acceso que no sean provenientes los paises en la lista permitida.

Instalación de GeoIP

Para esto vamos a instalar el paquete de GeoIP y su base de datos.

sudo apt-get install geoip-bin geoip-database 

Creación de Script

Creamos el script /usr/local/bin/ipfilter.sh con nuestro editor favorito y agregamos el siguiente codigo

#!/bin/bash
# License: WTFPL

# UPPERCASE space-separated country codes to ACCEPT
ALLOW_COUNTRIES="MX"
LOGDENY_FACILITY="authpriv.notice"

if [ $# -ne 1 ]; then
  echo "Usage:  `basename $0` " 1>&2
  exit 0 # return true in case of config issue
fi

if [[ "`echo $1 | grep ':'`" != "" ]] ; then
  COUNTRY=`/usr/bin/geoiplookup6 "$1" | awk -F ": " '{ print $2 }' | awk -F "," '{ print $1 }' | head -n 1`
else
  COUNTRY=`/usr/bin/geoiplookup "$1" | awk -F ": " '{ print $2 }' | awk -F "," '{ print $1 }' | head -n 1`
fi
[[ $COUNTRY = "IP Address not found" || $ALLOW_COUNTRIES =~ $COUNTRY ]] && RESPONSE="ALLOW" || RESPONSE="DENY"

if [[ "$RESPONSE" == "ALLOW" ]] ; then
  logger -p $LOGDENY_FACILITY "$RESPONSE sshd connection from $1 ($COUNTRY)"
  exit 0
else
  logger -p $LOGDENY_FACILITY "$RESPONSE sshd connection from $1 ($COUNTRY)"
  exit 1
fi

Script de hecho por jokey2k

Para definir que paises son permitidos para el acceso ssh, basta con cambiar la variable ALLOW_COUNTRIES, para mas información checar el comentario del script.

Damos permisos de ejecución al script

chmod +x /usr/local/bin/ipfilter.sh 

Restringir conexiones

Editamos el archivo /etc/hosts.deny y agregamos la restricción

sshd: ALL
vsftpd: ALL

Ahora agregamos la regla de permitir acceso al archivo /etc/hosts.allow

sshd: ALL: aclexec /usr/local/bin/ipfilter.sh %a
vsftp: ALL: aclexec /usr/local/bin/ipfilter.sh %a

Prueba

Ahora toca probar que se haya aplicado correctamente las restricciones, para eso podemos checar el log de autentificacion con un tail -f al archivo de log y debemos ver algo como:

Sep 15 14:19:05 own root: DENY sshd connection from 139.155.40.215 (CN)
Sep 15 14:19:12 own sshd[45414]: Received disconnect from 139.155.40.215 port 47786:11: Bye Bye [preauth]
Sep 15 14:19:12 own sshd[45414]: Disconnected from authenticating user root 139.155.40.215 port 47786 [preauth]
Sep 15 14:19:52 own root: DENY sshd connection from 183.107.195.8 (KR)
Sep 15 14:19:52 own sshd[45427]: Unable to negotiate with 183.107.195.8 port 40753: no matching host key type found. Their offer: ssh-rsa,ssh-dss [preauth]
Sep 15 14:19:58 own root: DENY sshd connection from 198.235.24.59 (CA)
Sep 15 14:20:05 own root: DENY sshd connection from 139.155.40.215 (CN)
Sep 15 14:20:09 own sshd[45440]: Connection reset by 198.235.24.59 port 42739 [preauth]
Sep 15 14:20:10 own sshd[45453]: Received disconnect from 139.155.40.215 port 52726:11: Bye Bye [preauth]
Sep 15 14:20:10 own sshd[45453]: Disconnected from authenticating user root 139.155.40.215 port 52726 [preauth]
Sep 15 14:21:04 own root: DENY sshd connection from 139.155.40.215 (CN)
Sep 15 14:21:09 own sshd[45469]: Received disconnect from 139.155.40.215 port 57662:11: Bye Bye [preauth]
Sep 15 14:21:09 own sshd[45469]: Disconnected from authenticating user root 139.155.40.215 port 57662 [preauth]

Donde se puede observar como la politica niega la conexión a las ip y el país de donde son.

Cambiar el numero de workers en los foros en Tutor

• Instalar los foros normalmente
• Editar el archivo ubicado en el directorio de trabajo de tutor como por ejemplo: tutor/env/plugins/forum/build/forum
• Editar el archivo Dockerfile
• Agregar el siguiente comando RUN sed -i 's/4)/6)/g' ./config/unicorn_tcp.rb de bajo de la linea de instalación del foro RUN bundle install --deployment
• En caso de querer agregar o disminuir los trabajadores se debe de editar el numero 6 por el numero de workers deseados, recordar que el 4 son los trabajadores por default que vienen en el repositorio oficial.
• Después rehacemos la imagen con el comando tutor images build forum
• Reiniciamos los foros con el comando tutor local restart forum
• Verificamos los workers activos por ejemplo con ps ax

El borrado de archivos es similar a como se hacia en la instalación nativa, para hacerlo basta ejecutar la siguiente comando:

tutor local run cms ./manage.py cms delete_course <your_course_id>

Con el cambio de instalación nativa a contenedores de tutor la forma de poner un tema es mucho mas fácil, para esto debemos de tener ya el tema terminado y aplicarlo a la plataforma, con los siguientes pasos:

• Copiar el tema en la siguiente ruta:

cp theme_dir "$(tutor config printroot)/env/build/openedx/themes/"

• Compilar la imagen con el nuevo tema

tutor images build openedx

• Agregar a la configuración el nuevo tema instalado

tutor local settheme

• Guardamos los cambios en el archivo de configuración

tutor config save

• Como paso opcional, activo este plugin para que tome el path de las imagenes del tema:

name: theme_default
version: 0.1.0
patches:
 lms-env: |
         "DEFAULT_SITE_THEME": "lilactheme"

• Por ultimo reiniciamos plataforma para ver los cambios aplicados

tutor local reboot -d

A partir de la versión Maple de Open EDx, tutor se convierte como la única forma de instalación para producción dejando de lado la instalación nativa.

Por lo que la instalación de la plataforma y puesta en producción  se hace en cuestión de minutos dependiendo de la conexión de internet. Lo único a considerar que para realizar configuraciones personalizadas se realiza de plugins que los veremos en otra entrada.

Antes de instalar debemos hacer los registros dns, por lo que debemos hacer un A del dns al lms_host.

Configuración de dns

demo.openedx 1800 IN A XXX.XXX.XXX.XXX

Ademas de un registo CNAME que cubra a todos servicios como studio, ecommerce, discover, etc.

*.demo.openedx 1800 IN CNAME demo.openedx.domain.demo.

Instalación de tutor

Para instalar tutor basta con bajar el script de instalación y cambiar los permisos mediante los siguientes comandos:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v12.1.6/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor

sudo chmod 0755 /usr/local/bin/tutor

Autocompletado

Ahora agregamos a los archivos de configuración de la terminal para que funcione el autocompletado.

Para bash:

_TUTOR_COMPLETE=bash_source tutor >> ~/.bashrc

Para zsh:

_TUTOR_COMPLETE=zsh_source tutor >> ~/.zshrc

Instalación

Y ahora podemos instalar tutor con el comando:

tutor quickstart

Y seguir los pasos del instalador.

A partir de la próxima versión de Open EdX Maple la única forma de instalación será mediante Tutor.

Este nuevo post cubriremos los requisitos previos a la instalación de Tutor, a continuación dejo los pasos para la instalación de docker y docker compose para ubuntu 20.04 lts.

Comenzamos actualizando el servidor hasta la ultima actualización.

Ejecutamos los comandos para actualizar el SO.

sudo apt update

sudo apt upgrade

sudo apt dist-upgrade

Agregamos la cadena GPG para poder instalar docker de los repositorios oficiales, con los siguientes comandos:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"

Nuevamente actualizamos los paquetes con sudo apt update

Y por ultimo instalamos docker

sudo apt install docker-ce -y

Para verificar que tenemos instalado y corriento docker en el servidor lo hacemos con el siguiente comando:

sudo systemctl status docker

Por seguridad solo root puede ejecutar comando de docker, pero podemos agregar a un usuario sin privilegios, para poder hacer uso de docker con los siguientes comandos:

sudo usermod -aG docker ${USER}

Para ver aplicados los cambios debemos cerrar y volver a iniciar sesión o ejecutar el comando

su - ${USER}

Instalación de docker-compose

Ahora toca el turno de instalar docker-compose, para instalar basta con ejecutar los siguientes comandos:

sudo curl -L "https://github.com/docker/compose/releases/download/1.26.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

Comprobamos que ya lo podamos ejecutar con el comando docker-compose --version y nos debe de arrojar algo como esto en consola

docker-compose version 1.26.0, build d4451659

Hace unos días me empezó a aparecer un error al hacer login en las plataforma con la ultima versión de Open Edx. como se muestra a continuación:  

Buscando el error en el log del lms, me encuentro un error de cookie, ademas de no registrar el id del usuario que esta haciendo el login.

Probé cambiar todas la variable del archivo lms.yml referentes a la cookies del CSFR, pero ninguna resolvía el problema.

Por lo que procedí a buscar en la consola de navegador en este caso Chrome y este me enviar que esta bloqueando el sitio como muestro a continuación:

Por lo que procedí a buscar en foros de como resolver el problema y hasta que encontré en el chat e Slack del proyecto una solución tentativa, así que la probé y funciono.

Asi que para solucionar el problema basta con modificar el archvivo /edx/app/edxapp/edx-platform/lms/envs/common.py.

Buscar y modificar la variable DCS_SESSION_COOKIE_SAMESITE de None a Lax y reniciar el servicio del lms.

Con eso resolvemos el problema.

Una de las cosas que me han comentado clientes que no les gusta al crear los usuarios, es hacer el paso de activación de cuenta una vez que concluye el registro.

Entonces veremos como desactivar esta opción.

Basta con editar el archivo lms.env.json e irnos a la seccion de FEATURES y agregamos la siguiente linea.

"SKIP_EMAIL_VALIDATION": true,

Guardamos y reiniciamos los servicios con el comando

/edx/bin/supervisorctl restart lms

Listo, con esto ya no pedira y enviara la activación de cuenta ni verificación vía correo electrónico.

Así de sencillo se puede deshabilitar, con esto terminamos el post de esta semana.

En esta parte veremos como configurar el certificado en un curso. Así que empecemos.

Una vez que tenemos seleccionado el curso donde vamos a otorgar el certificado debemos hacer lo siguiente entrar a studio y checar en el menú opciones que tengamos habilitada la opción de certificado.

Y al entrar veremos que no tenemos habilitada la opción de generar el certificado

Para habilitarlo debemos ir al django del lms domain.com/admin y ahi buscamos el menu de Course Mode

Entramos a este y seleccionamos añadir course mode

Una vez dentro seleccionamos el curso por su ID, nombre a visualizar y el modo ponemos la opción de honor y guardamos el cambio.

Una vez realizada esta tarea, regresamos a studio y refrescamos la pagina, la cual ya nos desplegara la opción para crear el certificado en el curso.

Damos clic en Configurar certificado y seguido nos abrira un nuevo formulario donde tendremos que llenarlo con los datos correspondiente al nombre del curso, quienes firman, por ultimo damos click al botón crear.

Una vez creado tenemos las opciones de pre-visualizar y activar certificado, por lo que si todo es correcto damos clic a la opción de activar. De igual manera lo podemos desactivar cuando lo deseamos.

Ahora mi recomendación es habilitar la opción que el propio estudiante genere su diploma cuando termine el curso, para hacerlo debemos modificar en opciones avanzadas la opción Opciones de publicación de los certificados con la variable early_with_info, ya que por default esta la opción end, la cual genera el certificado hasta que termine el curso.

Guardamos los cambios y ahora vamos a las opciones de instructor en el apartado de certificados del lms.

Y damos clic al botón de habilitar la generación de certificados por estudiantes.

Con esto ya los alumnos podrán generar su certificado al finalizar el curso.

Con esto terminamos este post, en la próxima parte veremos como cambiar los usuarios que no sean honor y como forzar la creación de certificados, que por alguna extraña razón llegue a fallar el método.

La plataforma en su opción de notificaciones por curso, tiene un error, ya que al estar preparando el correo, genera un from_mail extraño, por ejemplo si el correo que usas para notificaciones es notificar@example.com, la función agrega parte del nombre del curso, algo como DemoX-notificar@example.com, esta opción no es raro que se haga cuando enmascaras el correo, pero por una extraña razón la función manda el correo modificado a los parámetros de autentificación de correo electrónico, mandando error en la plataforma.

Adjunto un fragmento del log para que puedan ubicarlo:

May 30 00:44:44 edu [service_variant=lms][edx.celery.task][env:sandbox] ERROR [edu  1380] [tasks.py:686] - Task 3434e424-b73e-45e8-8834-6712c3e1036f: email with id 4 caused send_course_email task to fail with "fatal" exception.  6 emails unsent.
Traceback (most recent call last):
  File "/edx/app/edxapp/edx-platform/lms/djangoapps/bulk_email/tasks.py", line 567, in _send_course_email
    connection.send_messages([email_msg])
  File "/edx/app/edxapp/venvs/edxapp/local/lib/python2.7/site-packages/django/core/mail/backends/smtp.py", line 111, in send_messages
    sent = self._send(message)
  File "/edx/app/edxapp/venvs/edxapp/local/lib/python2.7/site-packages/django/core/mail/backends/smtp.py", line 127, in _send
    self.connection.sendmail(from_email, recipients, message.as_bytes(linesep='\r\n'))
  File "/usr/lib/python2.7/smtplib.py", line 747, in sendmail
    raise SMTPRecipientsRefused(senderrs)
SMTPRecipientsRefused: {u'sbernesto@gmail.com': (550, 'Verification failed for <DemoX-edu@bunited.mx>\nNo Such User Here"\nSender verify failed')}
May 30 00:44:44 edu [service_variant=lms][edx.celery.task][env:sandbox] ERROR [edu  1380] [tasks.py:326] - Send-email task 3434e424-b73e-45e8-8834-6712c3e1036f for email 4: failed: {u'sbernesto@gmail.com': (550, 'Verification failed for <DemoX-edu@example.com>\nNo Such User Here"\nSender verify failed')}

Como pueden ver la ultima línea, se puede leer la modificación del correo, les menciono que este error lo pude identificar con un correo debido a que este no pertenece a gsuite o office365, ya que estos solo hacen referencia a un error de autentificación.

Bueno para resolverlo debemos de seguir los siguientes pasos:

1. Abrir archivo con su editor favorito:
   /edx/app/edxapp/edx-platform/lms/djangoapps/bulk_email/tasks.py
2. Ubicar la funcion format_address o ir la linea 407 aprox o ubicar la linea:
   from_addr = format_address(course_title_no_quotes)
3. Sustituir el valor:
   from_addr = settings.BULK_EMAIL_DEFAULT_FROM_EMAIL
4. Compilar el archivo modificado:
   python -m compileall task.py
5. Cambiar el dueño del archivo compilado:
   chown edxa:edxapp task.pyc
6. Reiniciar todos los servicios:
   /edx/bin/supervisorctl restart all
7. Probar que envie el correo

Hice una grabación con asciinema para que puedan ver la modificación, es la primera que hago y espero mejorar en los próximos post estos videos.

Por fin después de varios meses o casi un año, les comparto la ultima parte de los certificados en Open Edx.

Después de hacer todas la configuraciones al fin tenemos activada la opción de certificado en studio, pero cualquier curso que accedamos, nos mostrará la siguiente pantalla:

Esta leyenda significa que que el curso no tiene ningun modo asignado para el certificado, por lo que aun tenemos que configurarlo con tipo de modalidad para emitir certificados, por lo que tendremos que ir a la pagina de /admin, ir a la sección de course mode

Damos clic al botón add, nos deplegara la pantalla donde tendremos que llenarlo con el id del curso, modo, nombre a visualizar (se recomienda usar el mismo que el curso) y le damos clic al botón guardar ubicado al final del formulario.

Es importante seleccionar el modo honor, ya que este es el modo mas facil de otorgar certificados a los estudiantes.

Una vez agregado que a un curso lo agregamos, ya podremos crear el certificado en studio.

Damos clic al botón de configurar su certificado, y nos aparece todas la opciones para agregar los títulos del certificado, nombre de las personas que firman el certificado.

Después de configurar el certificado es importante hacer una vista previa, para ver si el certificado esta bien formado, recuerda que las firmas deben de ser en png fondo transparente y con un ancho máximo de 150 px, el alto no importa.

Por ultimo, debemos de activar el certificado.

En el siguiente post de la serie de certificados, veremos como configurar un curso para que genere los certificados de manera manual y automática, así la administración de certificados y usuarios para la emisión de certificados.

Hace un par de meses tuvimos problemas eléctricos en nuestro site, debido a estas fallas nuestra plataforma empezó a generar errores en el foro, revisando el log de los foros, encontré lo siguiente:  

[2019-06-28T17:33:40.968589 #119141] DEBUG -- : source=rack-timeout id=f4476c0a3671ff99d3046531299ffeb4 timeout=20000ms service=0ms state=active
2019-06-28 17:33:42 - Elasticsearch::Transport::Transport::Errors::BadRequest - [400] {"error":"ElasticsearchIllegalArgumentException[Alias [content] 
has more than one indices associated with it [[content_20170715164129932, content_20170906153352575, content_20171115140946118, content_20190322162154611, c
ontent_20171215165152686, content_20180814150309861]], can't execute a single index op]","status":400}:

Como vemos en el log podemos ver multiples indices content_20170715164129932, content_20170906153352575, content_20171115140946118, content_20190322162154611, c ontent_20171215165152686, content_20180814150309861

Por lo que hay que eliminarlos, para checar los indices que tenemos user el comando:

curl 'localhost:9200/_cat/indices?v'

El cual nos da como resultado los indices que tenemos usando en Elasticsearch.

Mi criterio para eliminar los indices repetido fue eliminar los mas viejos y quedarme con el indice mas reciente, para eliminar los indice use el comando:

curl -X DELETE "localhost:9200/indice_a_eliminar

Y con este procedimiento volvio a funcionar el foro.

Uno de los dolores de cabeza que generalmente se tiene al administrar la plataforma es las cuentas bloqueadas por el exceso de intento de ingresar con los datos erróneos, ya sea por que se les olvida su password o capturan mal sus datos al iniciar la sesión.
Por lo que podemos desactivar este bloqueo mediante el cambio de una flag dentro del sistema, basta con editar el archivo /edx/app/edxapp/lms.env.json.

Basta con ubicar la sección de FEATURES y agregamos la linea

'ENABLE_MAX_FAILED_LOGIN_ATTEMPTS': false,

NOTA: No se recomienda por seguridad desactivar esta característica.

Lo recomendado es cambiar el tiempo de bloqueo de cuenta, a un tiempo menor, debido a que el tiempo de espera por default esta en 15 minutos y el bloqueo de cuenta se da a los 5 intentos.

Para cambiar estos datos es necesario editar el archivo /edx/app/edxapp/edx-platform/lms/envs/common.py y buscar las opciones de:

MAX_FAILED_LOGIN_ATTEMPTS_ALLOWED = 5  
MAX_FAILED_LOGIN_ATTEMPTS_LOCKOUT_PERIOD_SECS = 15 * 60

La primera opción nos permite cambiar el numero de intentos, la segunda opción es el tiempo expresado en segundos.

NOTA: Para estas opciones no he encontrado mejores practias sobre que valor poner, por lo que es importante modificarlos deacuerdo a las necesidades de cada sistema.

Una vez que terminemos de modificar los archivos es necesario reiniciar el LMS, mediante el comando:

/edx/bin/supervisorctl restart lms

Para poder tener cursos a tu propio ritmo en edx, solo debemos activar la bandera ubicada en el menú de django, bajo la opción de self paced e ir la configuración.

Por último procedemos a guardar el cambio y ahora en studio podremos configurar el curso en este modo.

Por último es importante considerar que para cambiar un curso a Self paced es necesario que el curso aún no haya empezado para que este se pueda seleccionar para esta modalidad.

Guardamos los cambio y el curso esta listo para arrancar con la modalidad self paced.