Canvas LMS La instalación es fácil si lo hiciste antes. Pero por primera vez podría resultar complicado. Si es la primera vez que intentas instalar Canvas LMS entonces definitivamente necesitas leer esto Canvas LMS guía de instalación. En su interior encontrará muchos consejos útiles que le ayudarán a configurar Canvas LMS servidor de producción.
Para esta guía usaremos un VPS con Ubuntu 22.04 LTS de 64 bits. El servidor tiene 8 GB de RAM y 4 núcleos de CPU. Cumple con los requisitos mínimos de hardware para el código abierto. Canvas LMS. No recomendamos instalar Canvas en hardware con especificaciones inferiores ya que la instalación puede fallar. Tampoco recomendamos utilizar ningún sistema operativo que no sea Ubuntu. Canvas LMS No se admite la instalación en Windows.
Antes de comenzar la instalación, consulte nuestro Canvas LMS servicio de alojamiento. El servicio ofrece servidores en la nube administrados con código abierto. Canvas LMS pre instalado. Puede comenzar a utilizar el LMS sin la molestia de configurar y administrar sus propios servidores.
Canvas LMS Pasos de la instalación
Actualiza el sistema
En primer lugar debemos actualizar el servidor y los paquetes a la última versión.
# sudo actualización apt && actualización apt -y
Instalar el servidor de base de datos PostgreSQL
A continuación instalamos y configuramos el servidor de base de datos PostgreSQL. Cuando escribo este artículo, postgresql-14 está disponible.
# sudo apt-get install postgresql-14
Agregue la base de datos postgresql y un usuario de base de datos para Canvas. Se le pedirá que establezca una contraseña para el usuario de la base de datos de Canvas.
# sudo -u postgres createuser canvas --no-createdb \ --no-superuser --no-createrole --pwprompt # sudo -u postgres createb canvas_production --owner=canvas
Descargar el código de Canvas al servidor
Usaremos Git para obtener el código Canvas. Instala Git si aún no lo tienes.
# sudo apt instalar git-core
En este paso crearemos un usuario de sistema separado para Canvas LMS solicitud. Descargaremos el código de Canvas y lo instalaremos en esta cuenta.
# useradd --create-home -s /bin/bash canvas # chmod 711 /home/canvas # su - lienzo
Clonar archivos del repositorio de Canvas Github en la carpeta public_html.
$ git clone https://github.com/instructure/canvas-lms.git /home/canvas/public_html $ cd /home/canvas/public_html $ git checkout prod
Instalar Canvas LMS dependencias
Vuelva del usuario "lienzo" a un usuario sudo e instale Ruby, Node.js, Bundler, Yarn y otros Canvas LMS dependencias.
$ sudo apt-get install software-properties-common $ sudo add-apt-repository ppa:instructure/ruby $ sudo apt-get update
Instalar Rubí 3.1
$ sudo apt-get install ruby3.1 ruby3.1-dev zlib1g-dev libxml2-dev \ libsqlite3-dev postgresql libpq-dev \ libxmlsec1-dev libidn11-dev curl make g++
Instalar Node.js
$ curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash - $ sudo apt-get install nodejs $ sudo npm install -g npm@latest
Instalar Bundler y Ruby Gems
# paquete de instalación de sudo gem --versión 2.3.26 # su - canvas $ cd /home/canvas/public_html $ conjunto de configuración del paquete --proveedor/paquete de ruta local $ instalación del paquete
Instalar hilo
# sudo npm -g instalar hilo
Instalar dependencias de NodeJS
# su - lienzo $ cd /home/canvas/public_html $ instalación de hilo
Configurar Canvas LMS
Copie los archivos de configuración predeterminados de Canvas:
$ cd /home/canvas/public_html $ para configuración en la base de datos amazon_s3 \ dominio_delay_jobs almacén_archivo correo_saliente seguridad migración_externa; \ do cp config/$config.yml.example config/$config.yml; hecho
Edite los archivos de configuración e ingrese las configuraciones relevantes de la base de datos, la configuración del dominio, la configuración del servidor de correo saliente, etc.
$ cp config/dynamic_settings.yml.example config/dynamic_settings.yml
$ vim config/dynamic_settings.yml$ cp config/database.yml.example config/database.yml
$ vim config/database.yml$ cp config/outgoing_mail.yml.example config/outgoing_mail.yml
$ vim config/outgoing_mail.yml$ cp config/domain.yml.example config/domain.yml
$ vim config/domain.yml$ cp config/security.yml.example config/security.yml
$ vim config/security.ymlLlenar la base de datos de Canvas
Ejecute db:initial_setup para crear tablas de base de datos y completar la base de datos con datos iniciales. En este paso se le pedirá que cree un usuario administrador de Canvas.
$ mv db/migrate/20210823222355_change_immersive_reader_allowed_on_to_on.rb. $ mv db/migrate/20210812210129_add_singleton_column.rb db/migrate/20111111214311_add_singleton_column.rb $ hilado gulp rev $ RAILS_ENV=paquete de producción exec rake db:initial_setup $ mv 20210823222355_change_immers ive_reader_allowed_on_to_on.rb db/migrate/. $ RAILS_ENV=paquete de producción ejecutivo rake db:migrar
Generar activos
Ejecute canvas:compile_assets para generar archivos de plantilla.
$ mkdir -p log tmp/pids public/assets app/stylesheets/brandable_css_brands $ touch app/stylesheets/_brandable_variables_defaults_autogenerated.scss $ touch Gemfile.lock $ touch log/production.log
$ RAILS_ENV=production bundle exec rake canvas:compile_assetsInstalar el servidor web Apache y Passenger
A continuación necesitamos un servidor web para servir Canvas. Nginx y Apache son las opciones más populares. Vamos a instalar Apache + Passenger para esta guía.
$ sudo apt-get install apache2
# Instale nuestra clave PGP y agregue soporte HTTPS para APT sudo apt-get install -y dirmngr gnupg apt-transport-https ca-certificates curl curl https://oss-binaries.phusionpassenger.com/auto-software-signing-gpg- clave.txt | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/phusion.gpg >/dev/null # Agregue nuestro repositorio APT sudo sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger jammy main > /etc/apt/sources.list.d/passenger.list' sudo apt-get update # Instalar módulo Passenger + Apache sudo apt-get install -y libapache2-mod-passenger
Habilite el módulo Passenger Apache y reinicie Apache.
sudo a2enmod pasajero sudo apache2ctl reiniciar
Valide libapache2-mod-passenger la instalación. Ejecute los siguientes comandos para asegurarse de que el módulo pasajero y libapache2-mod-passenger estén instalados correctamente.
sudo /usr/bin/passenger-config validar-instalar sudo /usr/sbin/passenger-memory-stats
Además, habilite mod_rewrite y mod_ssl para Apache.
$ sudo a2enmod reescritura $ sudo a2enmod ssl
Configurar Canvas VirtualHost en Apache
Deshabilite el archivo de configuración de host virtual de Apache predeterminado y cree un archivo de configuración de host virtual para la aplicación de lienzo.
$ sudo unlink /etc/apache2/sites-enabled/000-default.conf $ sudo vim /etc/apache2/sites-available/canvas.conf
Copie la configuración a continuación en el archivo de configuración de Canvas virtualhost. Reemplazar Nombre del servidor, Alias del servidor, Administrador del servidor, raíz del documento y otras configuraciones para que coincidan con su nombre de dominio y ubicación de la aplicación.
Nombre del servidor canvas-test.webhostingzone.org Alias del servidor canvasfiles-test.webhostingzone.org ServerAdmin youremail@example.com DocumentRoot /home/canvas/public_html/public RewriteEngine On RewriteCond %{HTTP:X-Forwarded-Proto} !=https RewriteCond %{ REQUEST_URI} !^/health_check RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [L] ErrorLog /var/log/apache80/canvas_errors.log LogLevel warn CustomLog /var/log/apache2/canvas_access.log PassengerPreloadBundler combinado en la producción de SetEnv RAILS_ENV Opciones Todas Permitir Anular todas Requerir que se concedan todas # Si solo está sirviendo HTTP detrás de un balanceador de carga que termina en HTTPS, omita el siguiente VirtualHost Nombre del servidor canvas-test.webhostingzone.org Alias del servidor canvasfiles-test.webhostingzone.org ServerAdmin youremail@example.com DocumentRoot /home/canvas/public_html/public ErrorLog /var/log/apache2/canvas_errors.log LogLevel warn CustomLog /var/log/ apache443/canvas_ssl_access.log SSLEngine combinado en BrowserMatch "MSIE [2-2]" ssl-unclean-shutdown # los siguientes archivos de certificado ssl se generan a partir del paquete ssl-cert. SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key PassengerPreloadBundler en producción SetEnv RAILS_ENV Opciones Todas Permitir Anular todas Requerir que se concedan todas
Habilitar el host virtual de Canvas
$ sudo a2ensite canvas
$ systemctl reload apache2 En este punto debería poder acceder a Canvas a través del navegador. Abra su navegador y escriba el nombre de dominio especificado en Nombre del servidor. Debería aparecer la página de inicio de sesión predeterminada de Canvas.
Otros pasos de configuración de Canvas
Si la página de inicio de sesión de Canvas está cargada en el navegador, es una buena señal. Pero necesitamos completar algunos ajustes más para que el sistema de gestión de aprendizaje Canvas de código abierto esté listo para producción.
Instalar certificado SSL para Canvas
Cuando el nombre de dominio o subdominio de Canvas apunta a la dirección IP del servidor, podemos continuar e instalar el certificado SSL para Canvas LMS aplicación. Para esta guía instalaremos un certificado SSL LetsEncrypt gratuito.
Ejecute las siguientes instrucciones en la línea de comando de la máquina para asegurarse de tener la última versión de snapd.
núcleo de instalación sudo snap; núcleo de actualización sudo snap
Elimine certbot-auto y cualquier paquete de Certbot OS
sudo apt-get eliminar certbot
Instalar Certbot
sudo snap install --classic certbot sudo ln -s /snap/bin/certbot /usr/bin/certbot
Instale el certificado SSL para Canvas usando certbot
sudo certbot --apache
Cuando el certificado SSL está instalado correctamente, debería ver un icono de candado y el texto "Conexión segura" en un navegador al acceder a Canvas URI.
Instalar el servidor de caché Redis
Es una buena idea instalar el servidor de caché Redis para optimizar el rendimiento de Canvas. Se requiere Redis versión 2.6.x o superior. Agregue el repositorio de PPA e instale Redis.
sysadmin@appserver:/var/canvas$ sudo add-apt-repository ppa:chris-lea/redis-server sysadmin@appserver:/var/canvas$ sudo apt-get update sysadmin@appserver:/var/canvas$ sudo apt- obtener la instalación del servidor redis
Luego regrese al directorio de códigos de Canvas y edite los archivos de configuración de Redis.
configuración vim/cache_store.yml
Agregue las siguientes líneas al archivo:
test: almacén_caché: redis_cache_store Desarrollo: almacén_caché: redis_cache_store Production: almacén_caché: redis_cache_store
Ahora edite el archivo redis.yml y establezca la ruta al servidor redis allí.
configuración vim/redis.yml
Si Redis está instalado en el mismo servidor que Canvas, entonces su configuración debería ser algo como esto. Reemplace localhost con la IP del servidor redis si instaló redis en un servidor externo.
Production: servidores: - redis://localhost
Guarde el archivo de configuración y reinicie Canvas para aplicar los cambios.
Instalar QTIMigrationTool para Canvas
Empleos de Configurar Canvas Automatizado
Los trabajos automatizados de Canvas deben estar ejecutándose para generar informes, enviar correos electrónicos, etc. Los siguientes comandos configurarán e iniciarán los trabajos retrasados de Canvas.
canvas$ sudo ln -s /home/canvas/public_html/script/canvas_init /etc/init.d/canvas_init canvas$ sudo update-rc.d canvas_init valores predeterminados canvas$ sudo /etc/init.d/canvas_init start
Instale la API RCE para el editor de contenido enriquecido
Solución de problemas de errores de instalación de Canvas
1. La aplicación encontró el siguiente error: Ya activó strscan 3.0.1, pero su Gemfile requiere strscan 3.0.6. Dado que strscan es una gema predeterminada, puede eliminar su dependencia de ella o intentar actualizar a una versión más nueva del paquete que admita strscan como gema predeterminada. (Gema::LoadError)
Solución: precargue Bundler con la opción de configuración de Apache "PassengerPreloadBundler on"
2. Errores comunes durante la compilación de recursos: FrozenError: no se puede modificar la matriz congelada
Solución: elimine la carpeta del proyecto Canvas, descargue los archivos de Github nuevamente y repita los pasos de instalación.
Créditos
- Inicio de la producción del lienzo – https://github.com/instructure/canvas-lms/wiki/Production-Start
- Instalación del pasajero – https://www.phusionpassenger.com/docs/advanced_guides/install_and_upgrade/apache/install/oss/jammy.html
- Canvas LMS Servicio de instalación – https://www.webhostingzone.org/solutions/canvas-lms-installation.html