Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
de:services:application_services:stack_maxima:start [2023/08/16 10:08] delkele1de:services:application_services:stack_maxima:start [2024/05/24 12:07] (aktuell) – [Moodle] delkele1
Zeile 1: Zeile 1:
 ====== STACK Maxima ====== ====== STACK Maxima ======
 ===== Nutzungsvoraussetzungen ===== ===== Nutzungsvoraussetzungen =====
-Die Systeme und Instanzen, über die eine Anbindung an den Cluster erfolgen soll, müssen spezifiziert angegeben und freigeschaltet werden. Hierfür bitten wir um Kontaktaufnahme über ''stack-support@gwdg.de''. Der Dienst wird betrieben als Bronze-Cluster (SLA). +Die Systeme und Instanzen, über die eine Anbindung an den Cluster erfolgen soll, müssen spezifiziert angegeben und freigeschaltet werden. Hierfür bitten wir um Kontaktaufnahme über ''stack-support@gwdg.de''. Der Dienst wird betrieben als Bronze-Cluster (SLA). Übertragen werden bei einer Anfrage die reinen Matematica-Befehle ohne personenbezogene Daten, die Kommunikation ist per SSL verschlüsselt.
 ===== Installationsanleitung/Einrichtung ===== ===== Installationsanleitung/Einrichtung =====
 Für die Installation muss jeweils zunächst das STACK-Plugin installiert werden. Hierbei sollen die Schritte zur Einrichtung von Maxima übersprungen werden, nach der Einrichtung lässt sich die Option “Server” nutzen, wo dann nur noch der entsprechende URL zu wählen ist. Vor der Installation muss weiterhin MathJax installiert sein, damit Formeln auf den Webseiten überhaupt dargestellt werden können Für die Installation muss jeweils zunächst das STACK-Plugin installiert werden. Hierbei sollen die Schritte zur Einrichtung von Maxima übersprungen werden, nach der Einrichtung lässt sich die Option “Server” nutzen, wo dann nur noch der entsprechende URL zu wählen ist. Vor der Installation muss weiterhin MathJax installiert sein, damit Formeln auf den Webseiten überhaupt dargestellt werden können
Zeile 12: Zeile 11:
   - Das Plugin sollte unter Administration > Plugins bereits erscheinen. Dieses aktualisieren, installieren, Sprachen aktualisieren und daraufhin konfigurieren.   - Das Plugin sollte unter Administration > Plugins bereits erscheinen. Dieses aktualisieren, installieren, Sprachen aktualisieren und daraufhin konfigurieren.
   - Als Plattformtyp „Server” auswählen und die zu verwendende Maxima-Version auswählen.   - Als Plattformtyp „Server” auswählen und die zu verwendende Maxima-Version auswählen.
-  - Aus der Tabelle der [[https://projects.academiccloud.de/projects/netzwerk-mathe-digital/wiki/maxima-stack-server#matching-table-iliasmoodle-version---goemaxima-url|goemaxima-Dokumentation]] den entsprechenden STACK-Maxima-URL auswählen und im Reiter „Server Konfiguration” eintragen und als Verwendung „Beliebig” auswählen.+  - Aus der Tabelle der [[https://github.com/mathinstitut/goemaxima?tab=readme-ov-file#what-stackmaxima-version-do-i-need|goemaxima-Dokumentation]] den entsprechenden STACK-Maxima-URL auswählen und im Reiter „Server Konfiguration” eintragen und als Verwendung „Beliebig” auswählen.
   - Um zu überprüfen, ob die Installation erfolgreich war, gibt es einen Reiter „Health Check”. Hier lassen sich verschiedene Funktionen des Plugins prüfen.   - Um zu überprüfen, ob die Installation erfolgreich war, gibt es einen Reiter „Health Check”. Hier lassen sich verschiedene Funktionen des Plugins prüfen.
  
 ==== Moodle ==== ==== Moodle ====
-Um STACK als Plugin für Moodle zu nutzen, müssen hingegen folgende vier Schritte absolviert werden. Die Beispiele nutzen die Methode per Git und ''$MOODLE_DIR'' ist das Verzeichnis der Moodle-Installation (siehe hierzu auch die entsprechende Dokumentation von [[https://docs.stack-assessment.org/en/Installation/#3-add-some-additional-question-behaviours|STACK]]:+Um STACK als Plugin für Moodle zu nutzen, müssen folgende vier Schritte absolviert werden. Die Beispiele nutzen die Methode per Git und ''$MOODLE_DIR'' ist das Verzeichnis der Moodle-Installation (siehe hierzu auch die entsprechende Dokumentation von [[https://docs.stack-assessment.org/en/Installation/#3-add-some-additional-question-behaviours|STACK]]:
   - Nötige Module:     - Nötige Module:  
     * ''git clone https://github.com/maths/moodle-qbehaviour_dfexplicitvaildate.git $MOODLE_DIR/question/behaviour/dfexplicitvaildate''     * ''git clone https://github.com/maths/moodle-qbehaviour_dfexplicitvaildate.git $MOODLE_DIR/question/behaviour/dfexplicitvaildate''
Zeile 23: Zeile 22:
   - Für den Moodle-Fragentyp muss weiterhin noch installiert werden:   - Für den Moodle-Fragentyp muss weiterhin noch installiert werden:
     * ''git clone https://github.com/maths/moodle-qtype_stack.git $MOODLE_DIR/question/type/stack''     * ''git clone https://github.com/maths/moodle-qtype_stack.git $MOODLE_DIR/question/type/stack''
-  - Im Admin-Bereich im Reiter „Plugins“ erscheint nun der Fragentyp „STACK“. Hier muss als Plattformtyp „Server” ausgewählt werden, die Maxima-Version gewählt werden und (wie bei Ilias) aus der Tabelle der [[https://projects.academiccloud.de/projects/netzwerk-mathe-digital/wiki/maxima-stack-server#matching-table-iliasmoodle-version---goemaxima-url|goemaxima-Dokumentation]] der nötige URL gewählt werden und als URL des Maxima-Pools eingegeben werden.+  - Im Admin-Bereich im Reiter „Plugins“ erscheint nun der Fragentyp „STACK“. Hier muss als Plattformtyp „Server” ausgewählt werden, die Maxima-Version gewählt werden und (wie bei Ilias) aus der Tabelle der [[https://github.com/mathinstitut/goemaxima?tab=readme-ov-file#what-stackmaxima-version-do-i-need|goemaxima-Dokumentation]] der nötige URL gewählt werden und als URL des Maxima-Pools eingegeben werden.
   - Auch in Moodle lässt sich die Installation per Health-Check-Skript testen, ein Link sollte am Anfang der Konfigurationsseite zum Plugin oben erscheinen.   - Auch in Moodle lässt sich die Installation per Health-Check-Skript testen, ein Link sollte am Anfang der Konfigurationsseite zum Plugin oben erscheinen.
  
Zeile 31: Zeile 30:
  
 ===== Versionierung ===== ===== Versionierung =====
-Welche Version genutzt werden soll, kann zunächst verwirrend sein, da es sowohl eine Ilias/Moodle Version, eine STACK-Version und eine Goemaxima-Version gibt. Diese passen nicht immer zusammen und müssen entsprechend gewählt werden. Auf der [[https://projects.academiccloud.de/projects/netzwerk-mathe-digital/wiki/maxima-stack-server|Projektseite]] kann das abgeglichen werden. Entsprechend der gewählten Version gibt es eine entsprechende Server-URL, die dann gewählt werden muss. Sollte es dennoch eine falsche Version sein, gibt die "Health-Check-Seite", die es sowohl für Moodle als auch Ilias auf der Plugin-Seite gibt, eine entsprechende Fehler- oder Warnmeldung heraus.+Die Wahl der zu verwendenden Version kann zunächst verwirrend sein, da es eine Ilias/Moodle-Version, eine Version des STACK-Plugins und eine Version von Stackmaxima gibt. Diese passen nicht immer zusammen und müssen entsprechend ausgewählt werden. Auf der [[https://github.com/mathinstitut/goemaxima?tab=readme-ov-file#what-stackmaxima-version-do-i-need|Projektseite]] kann das überprüft werden. Abhängig von der gewählten Version gibt es eine entsprechende Server-URL, die dann gewählt werden muss und die folgende Struktur haben sollte:  
 + 
 +''<nowiki>https://goemaxima.gwdg.de/VERSION/goemaxima</nowiki>'' 
 + 
 +Hier muss lediglich "VERSION" durch die zehnstellige Nummer der benötigten Stackmaxima-Version ersetzt werden, z.B. ''<nowiki>https://goemaxima.gwdg.de/2023072101/goemaxima</nowiki>''. Sollte es sich dennoch um eine falsche Version handeln, gibt die Health-Check-Seite, die es sowohl für Moodle als auch für Ilias auf der Plugin-Seite gibt, eine entsprechende Fehler- oder Warnmeldung aus.
  
  
 ===== Referenzen/Links ===== ===== Referenzen/Links =====
 +  * goemaxima-Projekt: https://github.com/mathinstitut/goemaxima 
   * STACK-Webste: https://stack-assessment.org/   * STACK-Webste: https://stack-assessment.org/
   * Maxima-Website: https://maxima.sourceforge.io/   * Maxima-Website: https://maxima.sourceforge.io/
-  * goemaxima-Dokumentation des mathematischen Instituts Göttingen: https://projects.academiccloud.de/projects/netzwerk-mathe-digital/wiki/maxima-stack-server +  * GitHub-Seite - STACK Plugin: https://github.com/ilifau/assStackQuestion#first-installation-of-the-plugin
-  * Gitlab-Seite - STACK Plugin: https://github.com/ilifau/assStackQuestion#first-installation-of-the-plugin+
   * Offizielle Ilias-Website: https://www.ilias.de/en/   * Offizielle Ilias-Website: https://www.ilias.de/en/
   * Offizielle Moodle-Website: https://moodle.org/   * Offizielle Moodle-Website: https://moodle.org/
   * GWDG Nachrichten: [[https://gwdg.de/about-us/gwdg-news/2023/GN_6-2023_www.pdf|Artikel in den GWDG-Nachrichten 6/2023]]   * GWDG Nachrichten: [[https://gwdg.de/about-us/gwdg-news/2023/GN_6-2023_www.pdf|Artikel in den GWDG-Nachrichten 6/2023]]