Instalar Kolibri

Ver el historial de cambios de Kolibri. Documentación de otras versiones está disponible aquí.

Requerimientos de hardware

Para instalar Kolibri, es recomendable primero comprobar los requisitos del sistema y luego seguir con el procedimiento para el sistema operativo de tu dispositivo.

Truco

Abajo encontrarás las recomendaciones generales respecto los requerimientos de hardware. Para saber más detalles y encontrar ejemplos de configuraciones de hardware implementado por otros usuarios y colaboradores, descarga la completa Guia de Hardware de Kolibri y los ejemplos de Configuraciones de Hardware de Kolibri (documentos PDF).

Servidores

Minimum hardware requirements to run Kolibri as a server:

  • 500 MB RAM (1 GB recomendado)
  • 500 MHz CPU (1 GHz recomendado)
  • Hard drive space depends on the size of the content channels you intend to import from Kolibri Studio or a local storage device.

Si el aula tiene menos de 30 computadoras, un dispositivo tan simple como Raspberry Pi se puede usar como el servidor.

Clientes

Ordenadores de sobremesa antiguos o de muy bajas prestaciones pueden utilizarse como clientes de Kolibri. Por ejemplo, algunas implementaciones utilizan dispositivos Raspberry Pi de primera generación como ordenadores de sobremesa.

Siempre es una buena idea hacer una prueba práctica, pero para implementar Kolibri, generalmente no es necesario actualizar el hardware. La principal preocupación es que el sistema tenga una tarjeta de vídeo y controladores que pueden reproducir los vídeos.

Windows

Compatibilidad

Instalar

  1. Descargar el instalador de Kolibri para Windows.
  2. Hacer doble clic al archivo .exe descargado.
  3. Seleccionar el idioma a utilizar durante la instalación.
  4. El instalador de Python 3 está incluido, acepta la instalación o la actualización para continuar.
  5. Seguir el resto de las instrucciones en el asistente de instalación de Kolibri.
  6. Una vez que la instalación finalice, Kolibri se iniciará automáticamente y se abrirá en el navegador predeterminado en http://127.0.0.1:8080. Esto puede tardar un momento, por favor seas paciente.
  7. Proceder con la Configuración inicial de la instalación.

Advertencia

Es probable que se abra el Firewall de Windows para pedir permisos del proceso de Python necesario para ejecutar Kolibri. Clicar Permitir acceso para aceptar y continuar.

Allow the Python process needed to run Kolibri.

Permitir el proceso de Python necesario para ejecutar Kolibri.

Desinstalar

  1. Abrir el Panel de Control de Windows.
  2. Seleccionar la opción Programas y características.
  3. Seleccionar Kolibri en la lista de programas.
  4. Clicar el botón Desinstalar y seguir las instrucciones.

Actualizar

Para actualizar Kolibri, seguir estos pasos.

  1. Descargar la nueva versión del instalador de Kolibri para Windows.
  2. Hacer doble clic al archivo .exe descargado.
  3. Seguir las instrucciones en la ventana del asistente de instalación.
  4. Una vez terminada la instalación de la actualización, Kolibri se Iniciará automáticamente y se abrirá en el navegador predeterminado de tu ordenador.
  5. ¡Ve y explora las nuevas y mejoradas características de Kolibri!

Debian/Ubuntu

Compatibilidad

Debian/Ubuntu: 14.04, 16.04 y más recientes - cualquiera que no esté discontinuado

Instalar desde el repositorio PPA

Usar los siguientes comandos en el Terminal para agregar el PPA e instalar Kolibri:

sudo apt-get install software-properties-common python-software-properties
sudo add-apt-repository ppa:learningequality/kolibri
sudo apt-get update
sudo apt-get install kolibri

Instalar desde archivo .deb

Las ventajas de descargar un archivo .deb es la portabilidad: puede copiar el archivo de un dispositivo a otro e instalar Kolibri sin acceso a Internet.

  1. Descargar el instalador Kolibri .deb <https://learningequality.org/r/kolibri-deb-latest> _ más reciente, u obtén una copia en el disco local.

  2. Ejecutar este comando desde la ubicación del archivo DEB:

    sudo dpkg -i kolibri-installer-filename.deb

  3. Esperar para que la instalación termine y ejecutar este comando para iniciar Kolibri:

    kolibri start

    Nota

    Si escoges instalar Kolibri como un servicio del sistema, no necesitarás iniciarlo manualmente.

  4. Cuando termina de comando, abrir el navegador por defecto en http://127.0.0.1:8080 y continuar con la Configuración inicial de la instalación.

Desinstalar

  • Abrir Software en Ubuntu y buscar Kolibri. Pulsar el botón Desinstalar.
  • O desde la línea de comando: sudo apt-get remove kolibri.

Actualizar

Cuando utilizas el método de instalación de PPA, las actualizaciones a las versiones más recientes serán automáticas, siempre que haya acceso a Internet disponible.

Para actualizar Kolibri en un dispositivo Debian sin acceso a Internet, obtén el archivo .deb actualizado y sigue los mismos pasos que en Instalar desde archivo .deb.

Cambiar el propietario del servicio del sistema Kolibri

El servicio del sistema es el script que ejecuta Kolibri en segundo plano al arranque del sistema en las distribuciones basadas en Debian.

Es posible que necesites cambiar el servicio del sistema para ejecutarlo con los permisos de una cuenta de usuario diferente. Antes de la v0.10, la cuenta de usuario kolibri era propietaria del servicio del sistema, mientras que a partir de la v0.10 y posterior, se prefiere la cuenta del usuario de escritorio habitual, para que Kolibri pueda acceder al almacenamiento USB local.

Para cambiar el propietario del servicio del sistema, tienes que cambiar la configuración del servicio del sistema: mueve la carpeta de datos .kolibri (que contiene canales, bases de datos, etc.) y asigna los permisos de propietario al nuevo usuario. Sigue estos pasos.

# Stop Kolibri
sudo systemctl stop kolibri
# Move data to your desktop user:
sudo mv /var/kolibri/.kolibri /home/$USER/.kolibri
# Change ownership
sudo chown -R $USER /home/$USER/.kolibri
# Change the username configuration
sudo sh -c 'sudo echo -n $USER > /etc/kolibri/username'
# Start Kolibri again
sudo systemctl start kolibri

Nota

Reemplazar el $USER en los comandos anteriores con el nombre del usuario que deseas que sea el nuevo propietario del servicio del sistema Kolibri.

Raspbian

Compatibilidad

Kolibri funciona bien en las distribuciones basadas en Debian para Raspberry Pi, como Raspbian, y se ha probado en modelos RPi 3.

Instalar

  1. Puede que ejecutar add-apt-repository como se muestra en las instrucciones PPA no va a funcionar. Para corregirlo, ejecuta:

    sudo apt install dirmngr
sudo su -c 'echo "deb http://ppa.launchpad.net/learningequality/kolibri/ubuntu xenial main" > /etc/apt/sources.list.d/learningequality-ubuntu-kolibri-xenial.list'
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys DC5BAA93F9E4AE4F0411F97C74F88ADB3194DD81
sudo apt update
sudo apt install kolibri

  2. Kolibri no se inicia después de la instalación. Esto es porque python3-cffi está desactualizado en Raspbian. Actualizarlo así:

    sudo apt install libffi-dev
sudo pip3 install pip --upgrade
sudo pip3 install cffi --upgrade
sudo systemctl start kolibri

  3. Cuando termina de comando, abrir el navegador por defecto en http://127.0.0.1:8080 y continuar con la Configuración inicial de la instalación.

Nota

Los siguientes problemas son bastante comunes en Raspberry Pi:

  • La hora no está configurada correctamente y tendrá errores al descargar el software. Por ejemplo, los certificados SSL para fuentes en línea no se podrán validar. Asegurarse tener la zona horaria correcta en /etc/timezone y que el reloj esté configurado correctamente ejecutando sudo ntpd -gq.

  • Te quedas sin espacio de almacenamiento. Si tienes una fuente USB para almacenamiento adicional, puedes hacer esto:

    # Stop kolibri
sudo systemctl kolibri stop
# Move its data
sudo mv /var/kolibri/.kolibri /your/external/media/kolibri_data
# Ensure that the kolibri system service user owns the folder
sudo chown -R `cat /etc/kolibri/username` /your/external/media/kolibri_data
# Restore the original location with a symbolic link
sudo ln -s /your/external/media/kolibri_data /var/kolibri/.kolibri
# Start kolibri
sudo systemctl kolibri start

  • La carga de canales puede demorar mucho tiempo en una Raspberry Pi. Al generar contenido de canales para Khan Academy, el paso indicado como «Generando la lista de canales. Esto podría tomar unos minutos…» podría significar ~ 30 minutos. La potencia de cálculo del dispositivo es el cuello de botella. Es posible que te desconectes mientras esperas, pero esto el proceso continuará. ¡Ten paciencia!

Desinstalar

Desde la línea de comando: sudo apt-get remove kolibri.

Actualizar

Cuando utilizas el método de instalación de PPA, las actualizaciones a las versiones más recientes serán automáticas, siempre que haya acceso a Internet disponible.

Otros Linux y MacOS

Compatibilidad

  • MacOS: 10.6+, todos los navegadores
  • Linux: cualquier sistema con Python 2.7, todos los navegadores compatibles

Instalar

Para instalar Kolibri en distribuciones de Linux que no sean Debian, así como en MacOS, puedes usar la instalación genérica con el comando pip install, o sigue estos pasos para ejecutar Kolibri con el paquete PEX.

  1. Descargar el instalador PEX de Kolibri.

  2. Asegúrate de abrir el Terminal allí donde está descargado el archivo PEX. Por ejemplo, si está guardado en la carpeta Descargas, escribe el siguiente en el Terminal y pulsa Intro:

    cd Downloads

  3. Escribe los siguientes comandos y pulsa Intro después de cada uno.

    chmod +x kolibri-installer-filename.pex
./kolibri-installer-filename.pex start

    Advertencia

    Asegúrate de sustituir el kolibri-instalador-filename.pex con el nombre exacto del archivo que descargaste en ambos comandos. Por ejemplo, si el nombre del archivo descargado es kolibri-v0.10.0.pex, escribelo en lugar de kolibri-instalador-filename.pex.

  4. Cuando termina de comando, abrir el navegador por defecto en http://127.0.0.1:8080 y continuar con la Configuración inicial de la instalación.

Desinstalar

  1. Eliminar el archivo PEX.
  2. Delete the ./kolibri folder in your user’s Home directory if you want to completely remove all the Kolibri files and content channels you imported.

Actualizar

Para actualizar Kolibri, seguir estos pasos.

  1. Descargar la nueva versión del instalador PEX de Kolibri.
  2. Iniciar Kolibri como durante la primera instalación.
  3. ¡Ve y explora las nuevas y mejoradas características de Kolibri!

Paquete Python pip

Puedes instalar Kolibri como un paquete estándar desde PyPi (funciona en Mac, Windows y Linux) utilizando este comando:

pip install kolibri

Configuración inicial

Para hacer la configuración inicial de después de la instalación, seguir estos pasos.

Nota

Hay que hacer la configuración inicial sólo una vez, es decir la primera vez que inicias Kolibri después de la instalación.

  1. Selecciona el idioma predeterminado para Kolibri.

    Select the default Kolibri language.

    Selecciona el idioma predeterminado de Kolibri.

    Advertencia

    El idioma predeterminado configurado en las preferencias de su navegador puede interferir con el idioma configurado en Kolibri. Para asegurarse que Kolibri se muestra en el idioma deseado, asegúrate de configurarlo de manera predeterminada en los navegadores de todos los dispositivos que se usarán para ver el contenido de Kolibri.

  2. Selecciona el nombre de tu Centro educativo. Centro educativo es la ubicación donde se instalará Kolibri - puede ser una escuela, centro de formación o sencillamente el nombre de tu familia.

    Select the name for the facility where Kolibri is running.

    Selecciona el nombre de tu instalación de Kolibri.

  3. Elegir una configuración del centro educativo. Haz clic en el enlace Más información sobre estas opciones para obtener más detalles sobre los permisos de usuario para cada tipo de configuración.

Tipo del Centro educativo Usuarios
Auto-gestionado
Entre aprendizaje informal en familia, escolarización doméstica
o aprendizaje individual complementario.
  • Invitados pueden crear sus propias cuentas.
  • Los usuarios pueden editar la información de sus cuentas.
Gestionado por Administrador
Para las escuelas y otros contextos de aprendizaje formal.
  • Administradores tienen que crear todas las cuentas de usuario.
  • Los usuarios pueden iniciar sesión sin contraseña.
  • Los usuarios no pueden editar la información de sus cuentas.
Uso personal o informal
Para bibliotecas, orfanatos, correccionales,
centros juveniles, aulas de ordenadores
y otros contextos de aprendizaje no formal.
  • Invitados pueden crear sus propias cuentas.
  • Los usuarios pueden editar la información de sus cuentas.
Choose a Facility setup.

Elegir una configuración del centro educativo.

View the Facility setup details.

Detalles de configuración del centro.

  1. Crear la cuenta de administración. Este administrador será un Superusuario capaz de administrar todo el contenido en el dispositivo, los usuarios de la instalación y sus permisos.

    Select the username and password for the facility Superuser.

    Selecciona el nombre de usuario y contraseña para Superusuario.

    Truco

    ¡Asegúrate de guardar estas credenciales de superusuario en un lugar seguro!

Una vez termine la configuración inicial, proceder a importar contenido y crear usuarios (si has elegido la configuración de instalación administrada por el administrador). Asegúrate de configurar otros equipos en la red a conectarse a Kolibri.