Instalación de Totara
  • 25 Oct 2022
  • 7 Minutos para leer

Instalación de Totara


Article Summary

Elección de un entorno

La información sobre el entorno compatible siempre se puede encontrar en el código en el archivo readme.md. También se puede encontrar en la documentación de requisitos del servidor del sistema.

Recomendamos encarecidamente que todos los sitios de producción sigan nuestros entornos recomendados cuando sea posible.

Los sitios de producción deben instalarse desde cero en lugar de clonarse desde una copia de seguridad de base de datos de otro sitio.
Puedes leer más en nuestros documentos de la póliza.

Preparación de su entorno

Sistema Operativo

Si pretendes usar Totara en varios idiomas de usuario, debes asegurarte de que el servidor se haya configurado correctamente con las configuraciones regionales correctas. Esto es importante para garantizar que las fechas, los números y los datos de moneda se muestren correctamente para el idioma seleccionado por el usuario. Consulte la documentación del desarrollador para obtener más información sobre las configuraciones regionales del servidor.

Asegúrate de que tu servidor haya sido debidamente asegurado para un entorno de producción. Consulta al proveedor de tu sistema operativo para obtener información sobre cómo lograr esto de la mejor manera.

Base de datos

Totara admite una serie de bases de datos diferentes. Seleccionar una base de datos es un paso de vital importancia para configurar tu instalación de Totara. No podemos decirte qué elegir, ni cuál es mejor que el resto. La forma en que pretendes usar y escalar tu base de datos, y tu conocimiento de ella tendrán un mayor impacto que la mayoría de los otros factores.

Si no estás seguro de cuál elegir, recomendamos PostgreSQL, ya que ofrece un buen rendimiento sin necesidad de ajustes.

MiSQL

Si deseas usar MySQL, te recomendamos que uses MySQL 8 o superior, debido a su soporte mejorado para contenido multilingüe en Totara. 

Te recomendamos encarecidamente que utilices una intercalación sensible a mayúsculas y minúsculas (que MySQL 5.7 no admite). También recomendamos un conjunto de caracteres compatible con 4 bytes (utf8mb4) para garantizar el soporte total de caracteres como emojis.

MySQL debe estar usando el formato de archivo Barracuda. Para crear tu base de datos:

CREATE DATABASE {dbname} DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_as_cs;

Por motivos de seguridad, te recomendamos que utilices un usuario de base de datos dedicado que tenga acceso solo a la base de datos de Totara.

MaríaDB

No hay una recopilación sensible a mayúsculas y minúsculas disponible para MariaDB. Si es probable que esto sea un problema para usted, le recomendamos que considere MySQL 8 o superior en su lugar.

MySQL debe estar usando el formato de archivo Barracuda. Para crear tu base de datos:

CREATE DATABASE {dbname} DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

Por motivos de seguridad, te recomendamos que utilices un usuario de base de datos dedicado que tenga acceso solo a la base de datos de Totara.

PostgreSQL

Para crear tu base de datos:

creadob -E utf8 {dbname}

Por motivos de seguridad, te recomendamos que utilices un usuario de base de datos dedicado que tenga acceso solo a la base de datos de Totara.

Si está ejecutando PostgreSQL 14 o superior, el ajuste enable_memoize debe estar desactivado.

MSSQL

Si estás instalando Totara como sysadmin, el usuario de tu base de datos debe tener permiso para modificar la configuración del servidor:

ALTERAR AJUSTES(SERVIDOR)

La búsqueda de texto completo debe estar habilitada; consulte Búsqueda de texto completo en el servidor MSSQL [ENLACE]. 

Por motivos de seguridad, te recomendamos que uses una base de datos dedicada que tenga acceso solo a la base de datos de Totara. Como alternativa, puedes instalar Totara como un usuario que no sea administrador del sistema utilizando el siguiente SQL:

-- Primero crea un nuevo usuario, cambia el nombre de usuario y la contraseña para que coincidan con tus requisitos

CREATE LOGIN testuser (Crear usuario de prueba de inicio de sesión)

    CON CONTRASEÑA = 'TestUser1';

GO

 

-- Ahora, asegúrate de que este usuario pueda instalar el sitio. Para esto, se necesitan permisos de CONFIGURACIÓN DE ALTERES

USE el maestro;

 

CONFIGURACIÓN DE ALTERES DE GRANT ALTER AL usuario de prueba;

 

-- Para la base de datos (sustituir con el nombre de la base de datos de su elección)

-- crear un inicio de sesión para el usuario y asegurarse de que tenga los permisos necesarios

USE totara_13;

 

CREAR USUARIO testuser PARA INICIAR SESIÓN testuser;

 

-- Asegurarse de que el usuario pueda crear tablas, leer y escribir datos

ALTER ROLE db_ddladmin ADD MEMBER testuser;

ALTER ROLE db_datareader ADD MEMBER testuser;

ALTER ROLE db_datawriter ADD MEMBER testuser;

 

-- Crear un rol personalizado

CREAR ROL db_totara;

 

-- Esto es necesario para ver cualquier definición creada por Totara

DEFINICIÓN DE GRANT VIEW A db_totara;

 

ALTER ROLE db_totara ADD MEMBER testuser;

 

GO

Después de instalar Totara, el siguiente SQL garantizará que Totara sea completamente utilizable sin privilegios de sysadmin:

-- Quitar el permiso de CONFIGURACIÓN DE ALTER, ya no es necesario

USE el maestro;

 

CONFIGURACIÓN DE ALTERES DE REVOKE AL usuario de prueba;

 

USE totara_13;

 

-- Asegúrate de que el rol de usuario tenga acceso a los procedimientos personalizados almacenados de Totara

EJECUCIÓN DE GRANT EN dbo.GROUP_CONCAT_D TO db_totara;

EJECUCIÓN DE GRANT EN dbo.GROUP_CONCAT_S TO db_totara;

EJECUCIÓN DE GRANT EN dbo.GROUP_CONCAT_DS A db_totara;

EJECUCIÓN DE GRANT EN dbo.GROUP_CONCAT TO db_totara;

 

GO

Servidor web

Totara es una aplicación basada en la web y depende de un servidor web para operar. Totara está oficialmente respaldado cuando se ejecuta a través de Apache, IIS y Nginx.

El código fuente de Totara contiene un directorio de servidor. El servidor web debe estar configurado para servir a este directorio y a sus elementos secundarios solamente.

La estructura de la base del código cambió entre Totara 12 y Totara 13. Es importante que su servidor web solo sirva al directorio del servidor. Es una preocupación de seguridad si tu servidor web está configurado para servir al directorio de código fuente de nivel superior ya que expone más información de la prevista.

Al configurar el servidor web, te recomendamos que lo fortalezcas siguiendo las mejores prácticas para el servidor web elegido. Los siguientes puntos pueden servir como guía para las mejores prácticas de Totara para los sitios de producción:

  • Deshabilitar listados de directorios
  • Deshabilitar el servicio de los siguientes directorios:
    • /servidor/**/pruebas/
    • /servidor/**/amd/
    • /servidor/**/yui/
    • /servidor/**/plantillas/
    • /servidor/**/clases/
  • Deshabilitar el servicio de los siguientes tipos de archivos:
    • /servidor/*/.txt
    • /servidor/*/.md
    • /servidor/*/.xml
    • Todos los archivos que comienzan con "."
  • Asegúrate de que los errores se escriban en una ubicación conocida del archivo de registro. Si experimentas algún problema y buscas soporte, a menudo te pedirán que revises los registros de errores del servidor web.

Si estás usando Apache + mod_php, CGI o PHP-FPM, y tienes la intención de usar la aplicación Totara Mobile, deberás añadir además la siguiente directiva a tu entrada de VirtualHost para el sitio a fin de que Apache pase correctamente los encabezados de autenticación requeridos por la aplicación móvil:

EstablecerEnvSi Autorización "(.*)" HTTP_AUTORIZACIÓN=$1
Si estás usando Apache + mod_php, CGI o PHP-FPM, te recomendamos que añadas las siguientes directivas a tu entrada Apache VirtualHost para asegurarte de que estos encabezados estén preservados:
SetEnvIf Content-Type "(.*)" HTTP_CONTENT_TYPE=$1
EstablecerEnvSi Acepta "(.*)" HTTP_ACCEPT=$1
La información sobre el entorno PHP requerido se puede encontrar en la página de requisitos del sistema del servidor.

Directorio de datos

Totara requiere acceso a un directorio de datos para almacenar datos de usuarios, archivos de caché, archivos temporales, etc. Este directorio debe ser legible y escrito por el usuario del servidor web.

En un entorno de escala horizontal, todos los servidores web deben tener acceso al directorio de datos. Debe ser compartida por ellos.

Instalación de Totara

Obteniendo el código

El código de Totara está disponible para los Alliance Partners y se puede descargar usando los comandos a continuación.

Para acceder al código, necesitarás que tu clave pública ssh se agregue a nuestro servidor git. Para cualquier ayuda con esto, por favor, presenta un ticket al servicio de asistencia.

Para el código principal de Totara:

clon git ssh://git@code.totaralms.com/totara-txp.git

Para el código de la aplicación Totara Mobile:

clon git ssh://git@code.totaralms.com/totara-mobile.git

Instalación de CLI

Recomendamos encarecidamente que la instalación y la actualización se completen a través de la interfaz de la línea de comandos.

Este comando debe ejecutarse como usuario web (en este caso www-data):

sudo -u www-data php server/admin/cli/install_database.php --agree-license --adminpass=mypassword123

Hay una serie de otros argumentos opcionales que se pueden proporcionar para minimizar la configuración posterior a la instalación:

--lang=CODE Installation and default site language. El valor predeterminado es en.

--adminuser=USERNAME Nombre de usuario para la cuenta de administrador. El valor por defecto es admin.

--adminemail=STRING Dirección de correo electrónico para la cuenta de administrador de totara.

--fullname=STRING Nombre del sitio

--shortname=STRING Nombre del sitio

Una vez finalizada la instalación de la CLI, puedes ir a la página de inicio del sitio e iniciar sesión con las credenciales de administrador para una mayor configuración.

Instalación web

La instalación web se puede realizar navegando al wwwroot que se estableció en el archivo config.php y siguiendo las instrucciones en pantalla. 

Configuración esencial

A continuación se muestra un ejemplo de un archivo config.php mínimo que debe estar presente en la carpeta de nivel superior. Hay mucha configuración opcional que se puede agregar. Consulte el archivo config.example.php en la carpeta de nivel superior.

<?php

$CFG = nueva stdClass();

$CFG->wwwroot = 'http://mytotara.com';

$CFG->dirroot = '/var/www/totara/htdocs/server';

$CFG->dataroot = '/var/sitedata/totara';

$CFG->directorypermissions = 00777; // prueba 02777 en un servidor en modo seguro

 

$CFG->dbhost = 'hostlocal';

$CFG->dbtype = 'pgsql';

$CFG->dbuser = 'dbuser';

$CFG->dbpass = 'dbpass';

$CFG->dbname = 'totaradb';

 

$CFG->prefijo = 'ttr_';

 

$CFG->forceflavour = 'learn_engage';

Las siguientes opciones están disponibles para la configuración de Forceflavour, según la combinación de productos que utilizará el sitio:

  • aprender
  • enganchar
  • realizar
  • Aprender_Realizar
  • aprender_engage
  • Perform_Engage
  • aprender_realizar_compromiso

Además, si deseas usar sabores, puedes encontrar más información sobre esto en nuestra Guía para socios sobre cómo usar sabores.

Próximos pasos

© Copyright 2024 Totara Learning Solutions. All rights reserved.


¿Te ha sido útil este artículo?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.