Technischer Support für E-Prüfungen

Hier geht es vor allem um die für Support relevanten Daten und Informationen für YAPS-Prüfungen an der TUHH. Abschnitte für andere Prüfungssysteme und Institutionen müssen namentlich erwähnt werden.

Allgemeines

Accounts und ihre Ablaufdaten

Der Account c000exam ist der Eigentümer allen YAPS-Repositories (Code und Exams) auf GitLab der TUHH. Zudem wird er verwendet, um die Prüfungsberichte an den Studierenden zu verschicken (Funktion Berichte per E-Mail im Admin-Panel).

Der Account c000yaps wird für die Durchführung von E-Prüfungen mit dem YAPS-Browser in den Windows- und Linux-PC-Pools der TUHH verwendet. Dieser Account ist speziell konfiguriert, um nach der Anmeldung automatisch den YAPS-Browser im Kiosk-Modus zu starten. Alle Studierenden melden sich mit diesem Account an, um auf die YAPS-Prüfungsumgebung zuzugreifen.

c000exam: 19.12.2025
c000yaps: 11.02.2025

Relevante Zugangsdaten

WICHTIG: Die Zugangsdaten für die Administration sind hier im Klartext nicht zu erwähnen. Bei Bedarf soll das Technik-Team nach den Zugangsdaten gefragt werden.

Für Admins

AMH OS:
- Admin-Konto auf den Notebooks: amh (Passwort in Bitwarden oder beim Technik-Team abfragen)
YAPS-Server:
- c000exam (Passwort in Bitwarden oder beim Technik-Team abfragen))
YAPS-Administrator auf GitLab TUHH:
- Funktionsaccount: c000exam (Ablaufdatum: 19.12.2025)

Für Prüflinge

AMH OS auf den AMH-Laptops:
- Benutzerkonto: student (Kein Passwort erforderlich)
Windows- und Linux-PC-Pools der TUHH:
- Benutzerkonto: c000yaps (Ablaufdatum: 11.02.2025)
- Passwort: ExamKing24 (Das Passwort soll zweimal im Jahr aktualisiert werden: 23 steht für die erste Änderung im Jahr 24, die zweite ist 232).

Für Gäste

AMH OS auf den AMH-Laptops:
- Benutzerkonto: guest (Passwort in Bitwarden oder beim Technik-Team abfragen))

AMH OS startet den YAPS-Browser mit dem Benuzerkonto student automatisch. Mit STR + ALT + Backspace kann der YAPS-Browser beendet werden. Auf der Loginseite kann man sich dann mit einem anderen Benutzerkonto (zB. guest) einloggen.

YAPS-Server

Auf dem YAPS-Server läuft Ubuntu, daher ist es empfohlen, mit dem Windows-Subsystem für Linux (WSL) zu arbeiten, falls Sie auf Ihrem Rechner Windows benutzen: Installieren von Linux unter Windows mit WSL.

Zugangsdaten und Zugriff

Zugangsdaten

Nach der Erstellung Ihres Accounts, der in der Regel Ihrer UNI-Kennung entspricht, werden Ihnen die Zugangsdaten (Benutzername und Passwort) vom Technik-Team der AMH bereitgestellt. Sie werden aufgefordert, einen SSH-Schlüssel zu generieren und den Public-Key zur Verfügung zu stellen: Erstellen eines SSH- Schlüsselpaar (für Linux, Mac OSX, Windows)

Zugriff

Der Zugriff auf den YAPS-Server (yaps.amh.tuhh.de) erfolgt über SSH. Der Zugriff kann nur innerhalb des TU-Netzwerks erfolgen. Außerhalb der TU-Räumlichkeiten müssen Sie entweder VPN der TUHH verwenden (Anleitungen zum Einrichten von VPN der TUHH) oder sich über den SSH-Server der TUHH einloggen (Zugang zum ssh-Server der TUHH).

Um auf den YAPS-Server über SSH zuzugreifen, führen Sie die folgenden Schritte aus:

Öffnen Sie ein Terminal.
Geben Sie den Befehl ein:

ssh Benutzername@yaps.amh.tuhh.de (ersetzen Sie "Benutzername" durch Ihren tatsächlichen Benutzernamen).

Geben Sie Ihr SSH-Passwort ein, wenn dazu aufgefordert.
Nach erfolgreicher Authentifizierung haben Sie Zugriff auf den Server.

TIPPS für den Zugriff auf den YAPS-Server

Um den Zugriff auf den YAPS-Server zu erleichtern, können Sie in der Datei .ssh/config folgende Hosts definieren und sie für den Zugriff verwenden:

Host tuhh
  Hostname ssh.rz.tuhh.de
  User ccc1245

Host yaps
  User ms004
  IdentityFile {path to id_rsa e.g: ~/.ssh/id_rsa}
  HostName yaps.amh.tuhh.de
  ProxyJump tuhh

Wobei Sie ccc1245 mit Ihrer TU-Kennung, ms004 mit Ihrem Account auf dem YAPS-Server und {path to id_rsa e.g: ~/.ssh/id_rsa} mit dem Pfad zu ihrem privaten Schlüssel ersetzen müssen.

Der Zugriff auf dem YAPS-Server erfolgt dann einfach mit dem Befehl:

ssh yaps

Admin-Rechte

Sofern Ihnen vom Technik-Team Admin-Rechte zugewiesen worden sind, können Sie mit dem Befehl:

sudo bash

zum Admin(root) wechseln.
Sie werden zur Authentifizierung aufgefordert, Ihr Passwort (Für den YAPS-Server) einzugeben.
Um vom Admin zu Ihrem Account wieder zu gelangen, geben Sie den Befehl:

exit

ein.

Wichtige Befehle für Support

Server-Überlastung

Mit dem Befehl htop kann die Server-Überlastung in Echtzeit beobachtet werden.

htop

Mit der Taste q kann die Ausführung des Befehls beendet werden.

WICHTIG: Wenn die Server-Überlastung dauerhaft über 95% liegt, muss ein Administrator aus dem Technik-Team benachrichtigt werden.

Verfügbarer Speicherplatz

Um den verbrauchten und freien Speicherplatz auf dem Server anzuzeigen, verwenden Sie den Befehl df -h. Dabei ist das Verzeichnis /var besonders relevant.

df -h

WICHTIG: Sollte vor einer YAPS-Prüfung der verfügbare Speicherplatz weniger als 10 GB betragen, muss ein Administrator aus dem Technik-Team benachrichtigt werden.

Nicht erreichbare AMH-Laptops

Um zu prüfen, welche AMH-Laptops nicht erreichbar bzw. offline sind, kann der folgende Befehl verwendet werden:

ansible -m ping -v all | grep UNREACHABLE | sort

Der Befehl muss als root ausgeführt werden, deshlab ist der Wechsel zum Admin notwendig. Sie müssen also folgende Befehle eingeben:

Wechsel zum Admin:
```
sudo bash
```

Befehl ausführen:

ansible -m ping -v all | grep UNREACHABLE | sort

Zurück zu Ihrem normalen Account:
```bash
exit
```

WICHTIG: Hier ist zu beachten, dass Reserve-Laptops 0411-0419 (sofern nicht im Einsatz) im Normalfall offline sind.

![Reserve-Laptops sind im Normalfall offline.](assets/unreachable-laptops.png "AMH-Laptops, die offline sind")

Buttons für Prüfungen anlegen

Buttons für YAPS-Prüfungen

Für eine YAPS-Prüfung kann der Button mit dem Befehl:

```bash
sudo -u c000exam yaps_add_button <docker-context> <git-tag> <button-label>
```

angelegt werden. Wobei:
<ul>
<li>`docker-context` : Die Abkürzung des Projekts auf GitLab. Dies ist für jede Veranstaltung bei der Erstellung definiert und bleibt unverändert.</li>
<li>`git-tag`: der Tag der YAPS-Instanz.</li>
<li>
`button-label`: Die gewünschte Beschriftung des Buttons.
<hr />
Beispiel:
Der folgende Befehl legt einen Button mit der Beschriftung Live Demo für die YAPS-Instanz live-demo des Projekts yaps-ws (YAPS Workshop) an.
```bash
sudo -u c000exam yaps_add_button yaps-ws live-demo "Live Demo"
```
Bei erfolgreicher Ausführung wird eine entsprechende Rückmeldung angezeigt und die Beschriftung des Buttons aus dem Container ausgelesen und ausgegeben.

Button successfully added!
The added button has the following label:
Live Demo

> TIPP:
> Am einfachsten ist es, `docker-context` und `git-tag` der URL der YAPS-Instanz zu entnehmen. Für das oben angegebene Beispiel ist die URL der YAPS-Instanz: `https://yaps.zll.tuhh.de/yaps-ws/live-demo/examserver/admin/instance/`;.

![Optionen für den den Skript](assets/yaps_add_button_parameters.png "Ableitung der Optionen docker-context und git-tag aus der URL der YAPS-Instanz")

> WICHTIG: Falls im `git-tag` Sonderzeichen vorkommen, kopieren Sie den `git-tag` aus der URL der YAPS-Instanz, da einige Sonderzeichen beim Deployment umgewandelt werden (z. B. `_` in `-`).

Buttons für YAPS-Prüfungen löschen

Analog zum Anlegen eines Buttons für eine YAPS-Prüfung, kann der angelegte Button mit dem Befehl:

```bash
sudo -u c000exam yaps_remove_button <docker-context> <git-tag>
```
gelöscht werden.

Buttons für andere Webanwendungen (WebWork, Moodle, Jupyterhub)

Um Buttons für andere Webanwendungen wie WebWorks und Moodle anzulegen, müssen Sie Änderungen in der Datei https://collaborating.tuhh.de/yaps/core/supervisor/-/blob/master/templates/index.html vornehmen. In dieser Datei sind bereits Buttons für alle bisher mit der AMH durchgeführten E-Prüfungen definiert (Evtl. sind sie auskommentiert). Sie müssen den jeweiligen Button aktivieren, indem Sie die entsprechenden Kommentarzeichen entfernen, und dann die Änderungen commiten, um sie zu speichern.

Dies ist z.B. der Button für Mathe II:

Die Links sollen mit den folgenden Parametern `#nonode#newwindownavigat` ergänzt werden, die vom YAPS-Browser behandelt werden:

`#nonode`: Dies deaktiviert die Node-Integration für die Seite im YAPS-Browser.
`#newwindownavigat`: Dies verhindert, dass Links mit dem Attribut `target="_blank"` in einem neuen Tab geöffnet werden.

WICHTIG: Die Änderung kann nur an einem neuen Branch commitet werden und dann mit `Merge Request` an den master-Branch gepusht. Stellen Sie sicher, dass Sie den `Merge Request` mit `Merge` abschließen.

Um den Button wieder zu entfernen, gehen Sie in gleicher Weise vor.

Die angelegten Buttons testen

Um die angelgten Buttons zu testen muss die Prüfungslistenseite `https:yaps.zll.tuhh.de/hub` im YAPS-Browser aufgerufen werden:

./yaps  "yaps:https:yaps.zll.tuhh.de/hub"

WICHTIG: Der Aufruf soll vom TU-Netzwerk aus erfolgen.

Vor den Prüfungen

Prüfung erstellen

Alle Informationen zur Prüfungserstellung sind hier zu finden:

FAQ

Während den Prüfungen

Meeting am Vortag der Prüfung

Ablauf

Termin vereinbaren:
- Eine Woche vor der Prüfung mit der Ansprechperson für die Prüfung Kontakt aufnehmen und das Support-Angebot anbieten. Der Termin sollte spätesten am Vortag der Prüfung stattfinden.
- Allen Teilnehmenden (zB. in CC) den Zoom-Link fürs Meeting zuschicken.
- Falls das Support-Angebot nicht in Anspruch genommen wird, sollten die folgenden Punkte per Mail geklärt werden:
  - Der Tag bzw. der Link für die finale Version der Prüfung mitteilen, sobald die finale Version ausgerollt ist.
  - die Telefonnummer, um bei Bedarf am Prüfungstag eine Aufsichtsperson zu erreichen.
  - Die Präferenz, ob ein Anruf eine halbe Stunde vor Prüfungsbeginn erwünscht ist.
  - Sofern noch nicht erfolgt, die genauen Prüfungszeiten (Uhrzeit, Durchgänge).

Für Prüfer, die zum ersten Mal mit dem mobilen Testcenter und YAPS prüfen, empfiehlt es sich, zu Beginn des Meetings anhand von Bilder und Screenshots einen normalen Prüfungsablauf vorzustellen. Dies kann als Folien vorbereitet werden.

Checkliste im Meeting:
1. Klausureinstellungen in exam-config.json durchgehen: Insbesondere sind die Einstellungen zum Ablauf der Prüfung (process) wichtig. Die Einstellungen für den ausgerollten Tag sind dann im Admin-Panel unter `Ablauf` zu finden. Erklärungen zu den Einstellungsoptionen sind hier in der Standard-Repo zu finden.
2. Aufgaben: Sind alle Aufgaben getestet worden?
3. Aufgaben in YAPS-Browser: Sind alle Aufgaben im YAPS-Browser getestet worden?
4. Tags:
  - ist der finale Tag erstellt worden?
  - evt. Tags löschen, die nicht mehr gebraucht werden
5. Klausur ausrollen:
  - ist die Klausur mit dem finalen Tag ausgerollt worden?
  - evt. alte Umgebungen löschen
6. Admin-Panel (In Details nur für Erstprüfer):
  - Zugriff testen
  - Die Teilnehmerliste hinzufügen. Die Teilnehmerliste muss genau wie in der Anleitung beschrieben aus TUNE exportiert werden. Es können mehrere Listen hinzugefügt werden. Bei Erfolg wird jeweils die Anzahl der Teilnehmer angezeigt.
    - Hier ist zu erwähnen, dass Studierende, die unter Vorbehalt an der Prüfung teilgenommen haben, keinen Bericht bekommen.
  - Bonuspunkte: Die Tabellen sind genau wie in der Anleitung zu erstellen. Eine Vorlage bzw. Beispiel kann vorbereitet und gezeigt werden.
  - Bewertung: Wie die Bewertung erfolgt und wie die Berichte aussehen. Hier kann auch ein Dummy-Beispiel gezeigt werden.
  - Archivierung: Ein Ordner mit dem Inhalt des ZIP-Archives als Beispiel zeigen.
  - Berichte per E-Mail an die Studierende schicken, komplett oder nur das Deckblatt.
    - Nur Studierende, die an der Prüfung tatsächlich teilgenommen haben und für sie einen Bericht erstellt wurde, bekommen einen Bericht.
    - Ist eine Teilnehmerliste hochgeladen worden, bekommen Studierende, die unter Vorbehalt an der Prüfung teilgenommen haben, keinen Bericht.
    - Studierende, die durch das Option "Login umgehen" an der Prüfung teilgenommen haben, bekommen keinen Bericht, da für sie keine E-Mail-Adresse erfasst wurde.
7. Freier Zugriff für den Superuser ermöglichen
  - Da sich nicht mehrere Personen über den Superuser am Admin-Panel anmelden können, sollte dieser für Support-Zwecke freigehalten werden. Die Aufsichtspersonen und Prüfenden sollen stattdessen ihre eigenen Uni-Kennungen verwenden, um die Klausur zu administrieren.
    - Als Alternative kann der `YAPS Administrator (c000exam)` als Admin hinzugefügt werden.
8. Button: Button für den finalen Tag anlegen. Darauf hinweisen, dass der Button automatisch gelöscht wird, sollte der finale Tag gelöscht (und neu erstellt) werden. In dem Fall muss dies dem Support mitgeteilt werden, um das Button wieder anzulegen.
9. Tech-Merkblatt: Hinweis auf das Merkblatt Tech Support_Hinweise-und-FAQ und Cloud-Link zum Herunterladen zuschicken.
10. Mehrere Durchgänge: Darauf hinweisen, dass die Aufsichtpersonen darauf achten müssen, dass nach jedem Durchgang die Studierende sich auslogen bzw. die Sitzung beenden (STRG + ALT + BACKSPACE). Für YAPS-Prüfungen können die Aufsichtpersonnen dies selbt durchführen, indem Sie im Admin-Panel `Klausursystem beenden`anklicken.
11. Hinweis zum Starten der YAPS-Prüfungen (Sehr wichtig): Um Server- und Netzwerküberlastungen zu vermeiden, ist der Prüfungsraum in 5 virtuelle Gruppen à 20 Laptops aufgeteilt worden. Jede 2 Tischreihen bilden eine Gruppe. Diese Gruppen tauchen im YAPS-Admin-Panel als Räume auf (D2.022-1 bis D2.022-5). Die Prüfung muss für jede Gruppe mit einer Verzögerung von 10 Sekunden gestartet werden. Alle anderen Aktionen (Freischalten, Zeit anpassen usw.) können über "Globale Befehle" für alle Studierende durchgeführt werden. Dies gilt nur für YAPS-Prüfungen.
12. Teilnehmende im Ausland/Internet:
  - Falls Studierende aus dem Ausland oder über das Internet an der Prüfung teilnehmen möchten, ist es zu empfehlen, im Vorfeld die Möglichkeit einer reibungslosen Teilnahme zu überprüfen. Hierzu könnte der Studierende zunächst an einer Testinstanz teilnehmen. Durch diese Maßnahme kann festgestellt werden, ob möglicherweise aufgrund der geografischen Lage oder individueller technischer Konfigurationen beim Studierenden Einschränkungen, wie beispielsweise Sperrungen von Ports oder Diensten, auftreten könnten. Sollten solche Hindernisse auftreten, könnte in Erwägung gezogen werden, eine VPN-Verbindung (TU) auf dem Rechner des Studierenden einzurichten.
13. Telefonnummern:
  - Falls noch nicht vorhanden, nach Telefonnummern der Ansprechperson fragen bzw. ob Anrufe an die Büronummer umgeleitet werden.
  - Fragen, ob ein Anruf eine halbe Stunde vor Prüfungsbeginn gewünscht ist.
  - Support während der Prüfung: -4959.
14. Offene Fragen?

Checks vor der Prüfung bzw. vor dem Anruf

Serverüberlastung (`htop`)
Speicherplatz (`df -h`)
Verfügbarkeit der Laptops überprüfen (siehe oben)
Sollten Sie dies noch nicht getan haben, leiten Sie bitte die Hotlinenummer `-4959` auf Ihr eigene Handynummer um. Hierzu nutzen Sie bitte folgenden Link: https://tele.tuhh.de/. Beachten Sie bitte, dass Ihre persönliche Handynummer mit `00` beginnen muss.

Anruf eine halbe Stunde vor der Prüfung

Sind die Aufsichtpersonen schon im Raum? Wenn nein, später anrufen oder zurückrufen lassen.
Sind alle Rechner online?
Ist der Button für die Prüfung wie gewünscht zu sehen?
Sollten Rechner offline sein:
- Ist der Rechner an? Wenn nicht, einschalten
- Ist der Rechner ans Stom angeschlossen?
- Ist der Rechner ans Netz angeschlossen?

FAQ

Nach den Prüfungen

Auswertung und Archivierung

Schriftliche Bewertung für eine hybride YAPS-Prüfung eintragen

Für eine hybride Prüfung, die mit YAPS erstellt wird, kann die Bewertung für die schriftlichen Aufgaben auf zwei verschiedene Arten erfolgen:

Manuelle Bewertung für die schriftlichen Aufgaben im Admin-Panel durchführen. Dafür muss die manuelle Bewertung für diese Aufgaben eigestellt werden. Diese Variante ist zu empfehlen, da die Bewertung dann automatisch erfasst wird und die Aufgaben in den Berichten auch zu finden sind, inklusive möglicher Bemerkungen zur Bewertung.
Die schriftlichen Aufgaben bewerten und die Noten im YAPS-System nachträglich eintragen. Diese Variante wird hier erläutert.

Schritt-für-Schritt-Anleitung

Punktentabelle anpassen

Die Prüfenden schicken dem Technikteam pro schriftliche Aufgabe die Bewertung als Excel-Tabelle.
Die Spalte, in der sich die Noten befinden, soll Points heißen.
Die Spalte, die die Matrikelnummer enthält, soll Matrikelnummer heißen.
Alle anderen Spalten werden ignoriert.
Es muss sichergestellt werden, dass in der Datei vor der Tabelle keine weiteren Inhalte vorhanden sind.

Die Dateien sollen wie die Aufgaben-Hashes heißen

Die Dateien für die jeweiligen Punktentabellen müssen umbenannt werden und zwar genau wie die Aufgaben-Hashes im YAPS-System heißen. Um die Aufgaben-Hashes herauszufinden, geht man wie folgt vor:

Auf dem YAPS-Server zum Benutzer `c000exam` wechseln
m Docker-Context der betreffenden Prüfung (hier `gtop` als Beispiel) wechseln und den Examserver-Container für die Prüfungs-Instanz (hier `wise23` als Beispiel) neu starten und in die Logs reinschauen.
```
docker context use gtop
docker ps
docker restart wise23_examserserver_1
docker logs wise23_examserver_1
```

Dateien auf dem YAPS-Server kopieren

Dateien mit dem eigenen Account auf dem YAPS-Server kopieren.
```
scp -r 4124584.xlsx {user}@yaps.amh.tuhh.de:~
```
Dateien ins Home-Verzeichnis von `c000exam` kopieren.

Datein in den Docker-Container in den Ordner `/tmp/yaps/overload` kopieren

docker cp 4124584.xlsx wise23_examserver_1:/tmp/yaps/overload

Berichte und Übersichtsseiten löschen

Alte Berichte und Übersichtseiten löschen, damit neue erstellt werden können.

docker exec wise23_examserver_1 rm rf /tmp/yaps/reports
docker exec wise23_examserver_1 rm rf /tmp/yaps/single_pages

Examserver neu starten

docker restart wise23_examserver_1

Bewertung neu starten

Im Admin-Panel die automatische Bewertung neu starten.

Kontrolle

Nach Abschluss der Bewertung stichprobenartig überprüfen, ob die Punkte für die schriftlichen Aufgaben korrekt eingetragen worden sind.

Alle Informationen zur Auswertung und Archivierung der Prüfungsergebnisse sind hier zu finden:

Informationen und Anleitungen