Totara wird installiert

Auswahl einer Umgebung

Informationen zur unterstützten Umgebung finden Sie immer im Code in der Datei readme.md. Sie finden sie auch in der Dokumentation der Systemserveranforderungen.

Wir empfehlen dringend, dass alle Produktionsstandorte nach Möglichkeit unsere empfohlenen Umgebungen befolgen.

Vorbereitung Ihrer Umgebung

Betriebssystem

Wenn Sie Totara in mehreren Benutzersprachen verwenden möchten, sollten Sie sicherstellen, dass der Server ordnungsgemäß mit den richtigen Gebietsschemata konfiguriert wurde. Dies ist wichtig, um sicherzustellen, dass Daten, Zahlen und Währungsdaten für die ausgewählte Sprache des Nutzers korrekt angezeigt werden. Weitere Informationen zu Serverstandorten finden Sie in der Entwicklerdokumentation.

Stellen Sie sicher, dass Ihr Server ordnungsgemäß für eine Produktionsumgebung gesichert ist. Wenden Sie sich an den Anbieter Ihres Betriebssystems, um zu erfahren, wie Sie dies am besten erreichen können.

Datenbank

Totara unterstützt eine Reihe verschiedener Datenbanken. Die Auswahl einer Datenbank ist ein wichtiger Schritt bei der Einrichtung Ihrer Totara-Installation. Wir können Ihnen nicht sagen, welche Wahl Sie treffen oder welche besser ist als die anderen. Wie Sie Ihre Datenbank nutzen und skalieren möchten und wie Ihr Wissen darüber eine größere Wirkung haben wird als die meisten anderen Faktoren.

Wenn Sie sich nicht sicher sind, welche Wahl Sie treffen sollten, empfehlen wir PostgreSQL, da es sofort eine gute Leistung bietet, ohne dass eine Abstimmung erforderlich ist.

MySQL

Wenn Sie MySQL verwenden möchten, empfehlen wir Ihnen, MySQL 8 oder höher zu verwenden, da mehrsprachige Inhalte in Totara besser unterstützt werden. 

MySQL muss das Barracuda-Dateiformat verwenden. So erstellen Sie Ihre Datenbank:

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

Aus Sicherheitsgründen empfehlen wir Ihnen, einen dedizierten Datenbankbenutzer zu verwenden, der nur Zugriff auf die Totara-Datenbank hat.

MariaDB

MySQL muss das Barracuda-Dateiformat verwenden. So erstellen Sie Ihre Datenbank:

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

Aus Sicherheitsgründen empfehlen wir Ihnen, einen dedizierten Datenbankbenutzer zu verwenden, der nur Zugriff auf die Totara-Datenbank hat.

PostgreSQL

So erstellen Sie Ihre Datenbank:

createdb -E utf8 {dbname}

Aus Sicherheitsgründen empfehlen wir Ihnen, einen dedizierten Datenbankbenutzer zu verwenden, der nur Zugriff auf die Totara-Datenbank hat.

Wenn Sie PostgreSQL 14 oder höher ausführen, muss die enable_memoize Einstellung deaktiviert sein.

MSSQL

Wenn Sie Totara als sysadmin installieren, muss Ihr Datenbankbenutzer die Berechtigung haben, die Servereinstellungen zu ändern:

ALTER SETTINGS(SERVER)

Die Volltextsuche muss aktiviert sein; siehe Volltextsuche in MSSQL Server [LINK]. 

Aus Sicherheitsgründen empfehlen wir Ihnen, einen dedizierten Datenbankbenutzer zu verwenden, der nur Zugriff auf die Totara-Datenbank hat. Alternativ können Sie Totara auch als Nicht-Sysadmin-Benutzer mit der folgenden SQL-Anweisung installieren:

-- First create a new user, change username and password to match your requirements

CREATE LOGIN testuser

    WITH PASSWORD = 'TestUser1';

GO

 

-- Now make sure this user can install the site, ALTER SETTINGS permissions is needed for this

USE master;

 

GRANT ALTER SETTINGS TO testuser;

 

-- For the database (substitute with the database name of your choice)

-- create a login for the user and make sure he has the permissions needed

USE totara_13;

 

CREATE USER testuser FOR LOGIN testuser;

 

-- Make sure the user can create tables, read and write data

ALTER ROLE db_ddladmin ADD MEMBER testuser;

ALTER ROLE db_datareader ADD MEMBER testuser;

ALTER ROLE db_datawriter ADD MEMBER testuser;

 

-- Create a custom role

CREATE ROLE db_totara;

 

-- This is needed to view any definition created by Totara

GRANT VIEW DEFINITION TO db_totara;

 

ALTER ROLE db_totara ADD MEMBER testuser;

 

GO

Nach der Installation von Totara stellt der folgende SQL-Code sicher, dass Totara vollständig ohne sysadmin-Privilegien verwendbar ist:

-- Take away the ALTER SETTINGS permission, it's not needed anymore

USE master;

 

REVOKE ALTER SETTINGS TO testuser;

 

USE totara_13;

 

-- Make sure the user role has access to Totara's custom stored procedures

GRANT EXECUTE ON dbo.GROUP_CONCAT_D TO db_totara;

GRANT EXECUTE ON dbo.GROUP_CONCAT_S TO db_totara;

GRANT EXECUTE ON dbo.GROUP_CONCAT_DS TO db_totara;

GRANT EXECUTE ON dbo.GROUP_CONCAT TO db_totara;

 

GO

Webserver

Totara ist eine webbasierte Anwendung, die auf einen Webserver angewiesen ist. Totara wird offiziell unterstützt, wenn es über Apache, IIS und Nginx ausgeführt wird.

Der Totara-Quellcode enthält ein Serververzeichnis. Der Webserver muss so konfiguriert sein, dass er nur dieses Verzeichnis und seine untergeordneten Elemente bedient.

Bei der Konfiguration des Webservers empfehlen wir Ihnen, ihn gemäß den Best Practices für den von Ihnen gewählten Webserver zu härten. Die folgenden Punkte können als Leitfaden für Totara Best Practices für Produktionsstandorte dienen:

• Verzeichnislisten deaktivieren
• Zustellung der folgenden Verzeichnisse deaktivieren:
  • /server/**/tests/
  • /server/**/amd/
  • /server/**/templates/
  • /server/**/classes/
• Die Bereitstellung der folgenden Dateitypen deaktivieren:
  • /server/*/.txt
  • /server/*/.md
  • /server/*/.xml
  • Alle Dateien beginnen mit "."
• Stellen Sie sicher, dass Fehler an einen bekannten Speicherort der Protokolldatei geschrieben werden. Wenn Sie Probleme haben und Unterstützung suchen, werden Sie oft gebeten, die Fehlerprotokolle des Webservers zu überprüfen.

SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

SetEnvIf Content-Type "(.*)" HTTP_CONTENT_TYPE=$1
SetEnvIf Accept "(.*)" HTTP_ACCEPT=$1

Datenverzeichnis

Totara benötigt Zugriff auf ein Datenverzeichnis, in dem Nutzerdaten, Cache-Dateien, temporäre Dateien usw. gespeichert werden können. Dieses Verzeichnis muss für den Webserver-Benutzer lesbar und beschreibbar sein.

In einer horizontal skalierten Umgebung müssen alle Webserver Zugriff auf das Datenverzeichnis haben. Sie muss von ihnen geteilt werden.

Totara wird installiert

Code abrufen

Der Totara-Code ist für Allianzpartner verfügbar und kann mit den folgenden Befehlen heruntergeladen werden.

Für den Totara-Hauptcode:

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

Für den Code der Totara Mobile App:

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

CLI-Installation

Wir empfehlen dringend, die Installation und das Upgrade über die Befehlszeilenschnittstelle abzuschließen.

Dieser Befehl muss als Webnutzer ausgeführt werden (in diesem Fall www-data):

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

Es gibt eine Reihe weiterer optionaler Argumente, die bereitgestellt werden können, um die Einrichtung nach der Installation zu minimieren:

--lang=CODE           Installation and default site language. Default is en.

--adminuser=USERNAME  Username for the admin account. Default is admin.

--adminemail=STRING   Email address for the totara admin account.

--fullname=STRING     Name of the site

--shortname=STRING    Name of the site

Sobald die CLI-Installation abgeschlossen ist, können Sie zur Website-Homepage gehen und sich mit den Admin-Anmeldeinformationen für die weitere Einrichtung anmelden.

Web-Installation

Die Webinstallation kann durch Navigieren zu wwwroot, das in der Datei config.php festgelegt wurde, und Befolgen der Anweisungen auf dem Bildschirm durchgeführt werden. 

Wesentliche Konfiguration

Nachfolgend finden Sie ein Beispiel für eine minimale config.php-Datei, die im obersten Ordner vorhanden sein sollte. Es gibt viele optionale Konfigurationen, die hinzugefügt werden können – siehe Datei config.example.php im Ordner der obersten Ebene.

<?php

$CFG = new stdClass();

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

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

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

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

 

$CFG->dbhost = 'localhost';

$CFG->dbtype = 'pgsql';

$CFG->dbuser = 'dbuser';

$CFG->dbpass = 'dbpass';

$CFG->dbname = 'totaradb';

 

$CFG->prefix = 'ttr_';

 

$CFG->forceflavour = 'learn_engage';

Die folgenden Optionen sind für die Konfiguration des erzwungenenGeschmacks verfügbar, je nachdem, welche Kombination von Produkten die Website verwenden wird:

• lernen
• einbinden
• durchführen
• learn_perform
• learn_engage
• perform_engage
• learn_perform_engage

Wenn Sie Geschmacksrichtungen verwenden möchten, finden Sie weitere Informationen dazu in unserem Partnerleitfaden zur Verwendung von Geschmacksrichtungen.

Nächste Schritte

• Registrieren Sie Ihre Website
• Erste Schritte mit der Anpassung der Website
• Ändern Sie Ihren Totara Geschmack