Installera Totara

Välja en miljö

Information om den miljö som stöds finns alltid i koden i readme.md-filen. Det finns också i dokumentationen för systemserverkrav.

Vi rekommenderar starkt att alla produktionsanläggningar följer våra rekommenderade miljöer där så är möjligt.

Förbered din miljö

Operativsystem

Om du tänker använda Totara på flera användarspråk bör du se till att servern har konfigurerats korrekt med rätt språk. Detta är viktigt för att säkerställa att datum, siffror och valutadata visas korrekt för användarens valda språk. Se utvecklardokumentationen för mer information om serverplatser.

Se till att din server är ordentligt säkrad för en produktionsmiljö. Kontakta ditt operativsystems leverantör för information om hur du bäst uppnår detta.

Databas

Totara stöder ett antal olika databaser. Att välja en databas är ett viktigt steg för att konfigurera din Totara-installation. Vi kan inte berätta för dig vad du ska välja, inte heller vad som är bättre än resten. Hur du tänker använda och skala din databas, och din kunskap om den kommer att ha större inverkan än de flesta andra faktorer.

Om du är osäker på vilket du ska välja rekommenderar vi PostgreSQL eftersom det levererar bra prestanda ur lådan utan att behöva ställa in.

MySQL

Om du vill använda MySQL rekommenderar vi att du använder MySQL 8 eller senare, på grund av dess förbättrade stöd för flerspråkigt innehåll i Totara. 

MySQL måste använda filformatet Barracuda. Så här skapar du din databas:

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

Av säkerhetsskäl rekommenderar vi att du använder en dedikerad databasanvändare som bara har tillgång till Totara-databasen.

MariaDB

MySQL måste använda filformatet Barracuda. Så här skapar du din databas:

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

Av säkerhetsskäl rekommenderar vi att du använder en dedikerad databasanvändare som bara har tillgång till Totara-databasen.

PostgreSQL

Så här skapar du din databas:

createdb -E utf8 {dbname}

Av säkerhetsskäl rekommenderar vi att du använder en dedikerad databasanvändare som bara har tillgång till Totara-databasen.

Om du kör PostgreSQL 14.0 eller 14.1 måste enable_memoize inställningen stängas av.

MSSQL

Om du installerar Totara som sysadmin måste din databasanvändare ha behörighet att ändra serverinställningar:

ALTER SETTINGS(SERVER)

Fulltextsökning måste vara aktiverat; se Fulltextsökning i MSSQL Server [LINK]. 

Av säkerhetsskäl rekommenderar vi att du använder en dedikerad databasanvändare som bara har tillgång till Totara-databasen. Alternativt kan du installera Totara som en icke-sysadmin-användare med följande SQL:

-- 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

Efter att Totara har installerats kommer följande SQL att säkerställa att Totara är fullt användbar utan sysadmin-privilegier:

-- 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

Webbserver

Totara är ett webbaserat program och förlitar sig på en webbserver för att fungera. Totara stöds officiellt när det körs via Apache, IIS och Nginx.

Totara källkod innehåller en serverkatalog. Webbservern måste konfigureras för att endast betjäna denna katalog och dess barn.

När du konfigurerar webbservern rekommenderar vi att du härdar den enligt bästa praxis för din valda webbserver. Följande punkter kan fungera som en guide för Totaras bästa praxis för produktionsanläggningar:

• Inaktivera kataloglistor
• Inaktivera servering av följande kataloger:
  • /server/**/tester/
  • /server/**/amd/
  • /server/**/mallar/
  • /server/**/klasser/
• Inaktivera servering av följande filtyper:
  • /server/*/.txt (åtkomst ska endast tillåtas checknet.txt)
  • /server/*/.md
  • /server/*/.xml
  • Alla filer börjar med ””.
• Inaktivera servering av följande filer:
  • /server/package.json
  • /server/paket-lock.json
• Se till att fel skrivs till en känd loggfilsplats. Om du upplever några problem och söker support kommer de ofta att be dig kontrollera felloggarna för webbservern.

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

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

katalog för data

Totara kräver åtkomst till en datakatalog där användardata, cachefiler, temporära filer etc. kan lagras. Denna katalog måste vara läsbar och skrivbar av webbserveranvändaren.

I en horisontellt skalad miljö måste alla webbservrar ha tillgång till datakatalogen. Det måste delas av dem.

Installera Totara

Hämta koden

Totara-koden är tillgänglig för Alliance Partners och kan laddas ner med hjälp av kommandona nedan.

För Totara-koden:

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

För Totara Mobile-appkoden:

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

Installation av CLI

Vi rekommenderar starkt att installation och uppgradering slutförs via kommandoradsgränssnittet.

Detta kommando måste köras som webbanvändare (i detta fall www-data):

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

Det finns ett antal andra valfria argument som kan tillhandahållas för att minimera installationen efter installationen:

--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

När CLI-installationen är klar kan du gå till webbplatsens hemsida och logga in med administratörsuppgifterna för ytterligare konfiguration.

Webbinstallation

Webbinstallation kan utföras genom att navigera till wwwroot som ställts in i config.php-filen och följa instruktionerna på skärmen. 

Väsentlig konfiguration

Nedan följer ett exempel på en minimal config.php-fil som ska finnas i mappen på toppnivå. Det finns en hel del valfri konfiguration som kan läggas till – se filen config.example.php i den överordnade mappen.

<?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';

Följande alternativ är tillgängliga för konfigurationen av forceflavour, beroende på vilken kombination av produkter webbplatsen kommer att använda:

• lär dig
• engagera
• utföra
• learn_perform
• learn_engage
• perform_engage
• learn_perform_engage

Dessutom, om du vill använda smaker så kan du hitta mer information om detta i vår utvecklardokumentation .

Nästa steg

• Registrera din webbplats
• Komma igång med anpassning av webbplats
• Ändra din Totara-smak