Polaris Learning Infrastructure Setup

Die Polaris Learning Infrastructure ist eine moderne, skalierbare Plattform zur Unterstützung digitaler Lernumgebungen. Sie ermöglicht die nahtlose Integration verschiedener Lernressourcen, Benutzerverwaltung und Analysefunktionen für ein effektives Lernmanagement.

Systemvoraussetzungen

Bevor Sie mit der Installation der Polaris Learning Infrastructure beginnen, stellen Sie sicher, dass Ihr System die folgenden Anforderungen erfüllt:

Empfohlene Systemanforderungen:

• Betriebssystem: Linux (Debian 11+, Ubuntu 20.04+ empfohlen)
• Prozessor: Mindestens 4 CPU-Kerne (8 empfohlen für größere Installationen)
• Arbeitsspeicher: Mindestens 8 GB RAM (16 GB oder mehr für größere Benutzerzahlen empfohlen)
• Festplattenspeicher: Mindestens 50 GB freier Speicherplatz (je nach Datenvolumen erweiterbar)
• Netzwerk: Stabile Internetverbindung für Updates und Container-Downloads

Softwarevoraussetzungen:

• Docker (mindestens Version 20.10)
• Docker Compose (mindestens Version 1.29)
• Git (für das Herunterladen der Konfigurationsdateien)
• cURL oder Wget (für das Abrufen externer Abhängigkeiten)

Installation von Docker und Docker Compose

Falls Docker noch nicht installiert ist, können Sie es auf Debian oder Ubuntu mit folgenden Befehlen einrichten:

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Installieren von Docker und Docker Compose:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Überprüfen, ob Docker installiert ist:

docker --version
docker-compose --version
sudo docker run hello-world

Docker-Login in die Registry von RWTH Aachen

Falls Sie noch nicht eingeloggt sind, müssen Sie sich mit Ihrem GitLab-Benutzernamen und Passwort authentifizieren. Falls Sie die Zwei-Faktor-Authentifizierung (2FA) aktiviert haben, benötigen Sie stattdessen ein Personal Access Token (PAT).

echo "IHR-TOKEN" | docker login registry.git.rwth-aachen.de -u IHR-BENUTZERNAME --password-stdin

Nach erfolgreicher Anmeldung erscheint die Meldung:

Login Succeeded

Create private/public keys and .env

Please change all passwords in the configuration file and leave the passphrase empty.

ssh-keygen -b 4096 -f id_rsa
cp .env.sample .env

Start containers

docker compose up -d

Please check whether all services started successfully.

docker compose ps

After that you should be able to visit http://localhost:8004/ and see the rights engine.

Infrastructure overview

graph TD;
subgraph Polaris
Z[Docker Build]
end
Z[Docker Build] --> A(Ingress);
Z[Docker Build] --> B(Ingress);
subgraph GitLab
B[Container Registry] --> H(Images);
end
subgraph Server
A[Docker Pull] --> D(Traefik);
D[Traefik] --> E(Deployment:Analytics-Engine);
D[Traefik] --> F(Deployment:Rights-Engine);
D[Traefik] --> I(Deployment:Dashboard-SDK);
E(Deployment:Analytics-Engine)---id1[(MongoDB)]
F(Deployment:Rights-Engine)---id1[(MongoDB)]
I(Deployment:Dashboard-SDK)---id1[(MongoDB)]
end

Update Polaris to a newer version

Falls Sie eine neuere Version von Polaris installieren möchten, folgen Sie diesen Schritten. Stellen Sie sicher, dass Sie sich im Verzeichnis befinden, in dem sich Ihre docker-compose.yml-Datei befindet.

docker compose down
docker compose pull
docker compose up -d

Prüfen Sie, ob die neuen Container laufen:

docker compose ps

Falls Polaris nicht wie erwartet startet, können Sie die Logs anzeigen:

docker compose logs -f