Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
Nächste ÜberarbeitungBeide Seiten der Revision
client:bwlehrpool-suite [2018/11/21 16:44 CET] – [Menüleiste] chrclient:bwlehrpool-suite [2021/12/14 15:13 CET] – [Veranstaltungen bearbeiten] sritter
Zeile 1: Zeile 1:
-<html><br></html> 
- 
-**Hinweis:** Zur Nutzung der bwLehrpool-Suite müssen Sie sich zuerst **einmalig für den bwLehrpool-Dienst [[https://bwlp-masterserver.ruf.uni-freiburg.de/webif/|registrieren]] (über bwIDM vermittelt)**. Wir freuen uns, wenn Sie am landesweiten Austausch Virtueller Maschinen teilnehmen. 
- 
-====== Verwaltung Virtueller Maschinen und Veranstaltungen ====== 
- 
-Zur erleichterten Verwaltung der Virtuellen Maschinen und Veranstaltungen innerhalb bwLehrpools wurde eine javabasierte Software, die bwLehrpool-Suite, entwickelt. Diese Software ermöglicht das Hoch- und Herunterladen Virtueller Maschinen, die Erstellung von Veranstaltungen, sorgt für die Rechtevergabe an Virtuellen Maschinen und Veranstaltungen und bietet erweiterte Optionen. 
- 
- 
-===== Software: Die bwLehrpool-Suite ===== 
- 
-Die bwLehrpool-Suite (gerne auch einfach Suite oder Dozentenmodul genannt) ist eine Client-Anwendung zur Bereitstellung Virtueller Maschinen für Lehre und Unterricht innerhalb von bwLehrpool. Mit Hilfe der Suite können fertige Vorlagen-Abbilder heruntergeladen werden, die anschließend lokal an spezielle Bedürfnisse angepasst werden können. Mit ihr können angepasste Virtuelle Maschine auf bwLehrpool-Server hochgeladen, neue Veranstaltungen angelegt und mit Virtuellen Maschinen verknüpft werden. Es können zudem Berechtigungen an einzelne oder auch an alle Nutzer vergeben werden. 
- 
- 
-==== Grundlagen und Begriffsklärung ==== 
- 
-Im Gegensatz zu anderen Systemen dreht sich die Nutzung in bwLehrpool-Poolräumen nicht um einzelne Virtuelle Maschinen, sondern um Veranstaltungen. Daher mag ein Vorwort zur Begriffsklärung angebracht erscheinen. 
-Nach erfolgter Anmeldung befinden Sie sich im Startfenster der bwLehrpool-Suite. Von hier können Sie direkt zur Liste der verfügbaren Virtuellen Maschinen bzw. Veranstaltungen wechseln. Über den Menüpunkt [Ansicht] können Sie jederzeit hierher zurückkehren. 
- 
- 
-=== Virtuelle Maschine === 
- 
-Innerhalb von bwLehrpool werden die Begriffe Virtuelle Maschine (VM), Image und Abbild synonym verwendet. 
-Ein Abbild ist die virtuelle Festplatte der Lehrumgebung. Hierbei handelt es sich in der Regel um eine Datei mit der Endung „vmdk“. Diese Datei enthält das installierte Betriebssystem sowie die von Ihnen zusätzlich installierte Software. Zusätzlich können noch weitere Dateien mit Metadaten vorhanden sein (z.B. mit der Endung „vmx“, „vmxf“, „nvram“), die für die Ausführung der Virtuellen Maschine mit dem VMWare Player benötigt werden. Eine Virtuelle Maschine besteht somit aus dem Image und den zugehörigen Metadaten. 
- 
- 
-=== Veranstaltung  === 
- 
-Bei Veranstaltungen handelt es sich lediglich um Metadaten (beschreibende Informationen). Diese beinhalten z.B. den Anzeigenamen und die Gültigkeitsdauer Ihrer Lehrumgebung. Veranstaltungen sind Einträge, die Studierende im PC-Pool im sogenannten vmChooser, dem Auswahlprogramm,  auswählen können, um Lehrumgebungen zu starten. Nur innerhalb der eingestellten Zeiträume sind Veranstaltungen innerhalb der Poolräume sichtbar. Mehrere Veranstaltungen können auf die gleiche Virtuelle Maschine zeigen. Eine Veranstaltung ist im bwLehrpool-Kontext somit am ehesten mit einer Vorlesung oder Klausur vergleichbar. 
- 
-[{{ bwSuite:bwlehrpool_dozmod_abbilder_und_veranstaltungen.png |bwLehrpool-Suite: Arbeitsflußdiagramm (grundsätzlich gilt: Zuerst eine Virtuelle Maschine erstellen, dann eine Veranstaltung darauf verlinken).}}] 
- 
-==== Systemvoraussetzungen ==== 
- 
-Die bwLehrpool-Suite wurde unter den Betriebssystemen Linux (div. Distributionen), Windows (7, 8, 8.1, 10) und Apple OS/X getestet. Zum Einsatz der bwLehrpool-Suite wird das [[https://www.java.com/de/download/|Java Runtime Environment]] benötigt. Falls heruntergeladene Virtuelle Maschinen lokal ausgeführt und bearbeitet werden sollen, wird zusätzlich der VMWare Player oder die VMWare Workstation benötigt. Einen Link zur empfohlenen Version des VMWare Players finden Sie innerhalb der bwLehrpool-Suite unter dem Menüpunkt „Über“. 
- 
- 
-==== Herunterladen der bwLehrpool-Suite ==== 
- 
-Die aktuelle Version der bwLehrpool-Suite können Sie [[https://bwlp-masterserver.ruf.uni-freiburg.de/dozmod/|hier herunterladen]]. 
- 
-==== Anmeldung ==== 
- 
-Starten Sie die bwLehrpool-Suite. Bei der Authentifizierungsart wählen Sie „Authentifizierung über bwIDM“. Wählen Sie bei „Identity Provider“ Ihre Institution aus und verwenden Sie Ihre regulären Hochschulzugangsdaten. Klicken Sie anschließend auf „Login“. 
-[{{ bwSuite:bwlehrpool_dozmod_login.png?500 |bwLehrpool-Suite: Loginfenster}}] 
- 
-<note tip> 
-Damit die Anmeldung funktioniert, muss der IDP für das Attribut 'eduPersonScopedAffiliation' den Wert 'staff', 'faculty' oder 'employee' für die Benutzer zurückliefern (https://www.bwidm.de/attribute/#eduPersonScopedAffiliation). 
-Alternativ kann das bwLehrpool-Entitlement gesetzt werden (https://www.bwidm.de/dienste/#bwlehrpool), um beispielsweise einzelnen Studierenden oder Externen den Zugriff zu ermöglichen. 
-</note> 
- 
-<note tip> 
-In Ausnahmefällen (wenn Ihre Institution kein bwIDM unterstützt) können Sie einen „Zugang mit festem Benutzer“ beim bwLehrpool-Team beantragen. Dies erfordert einen manuellen Eingriff und ist somit nur für einzelne Benutzerkonten möglich. Bitte wenden Sie sich in diesem Fall an [[bwlehrpool@hs-offenburg.de]]. 
-</note> 
- 
-Falls Ihre Institution mehrere Satellitenserver betreibt, erscheint nach erfolgter Anmeldung ggf. ein Auswahlfenster. 
-Anschließend befinden Sie sich im Startfenster der bwLehrpool-Suite. Von hier können Sie direkt zur Liste der verfügbaren Virtuellen Maschinen bzw. Veranstaltungen wechseln. Über den Menüpunkt [Ansicht] können Sie jederzeit hierher zurückkehren. 
- 
-[{{ bwSuite:bwlehrpool_dozmod_startbildschirm.png?400 |bwLehrpool-Suite: Auswahlbildschirm (Virtuelle Maschinen und Veranstaltungen)}}] 
- 
-<note tip> 
-Sollten Sie bei Gelegenheit einen anderen Satellitenserver nutzen wollen, können Sie dies auf zweierlei Arten erreichen: 
-  * Melden Sie sich per „Sitzung“, „Abmelden und beenden“ ab. Beim nächsten Login sollte eine Liste vorgegebener Satellitenserver gefolgt von einer Möglichkeit zur IP-Adresseingabe erscheinen. 
-  * Halten Sie die Shift/Umschalttaste gedrückt, wenn Sie einen Mausklick auf „Login“ ausführen. Auch dann erscheint eine Liste inkl. Eingabemöglichkeit. 
-</note> 
-==== Menüleiste ==== 
- 
-[{{ bwSuite:bwlehrpool_dozmod_menuezeile.png |bwLehrpool-Suite: Menuzeile}}] 
- 
-  * Über den Menüpunkt [Sitzung] können Sie unter [Einstellungen] Ihre Programmeinstellungen konfigurieren, das Logverzeichnis öffnen, sich von der Suite abmelden oder die Suite schließen. 
-  * Über den Menüpunkt [Ansicht] gelangen Sie zurück auf die Startseite und können direkt zwischen den Übersichten der Virtuellen Maschinen und Veranstaltungen wechseln. 
-  * Unter dem Menüpunkt [Über] finden Sie unter [Virtualisierer] ein Direktlink zum Download des benötigten VMWare-Player und Informationen zur [Nutzervereinbarung]. [Software-Aktualisierung] prüft, ob eine neue Programmversion verfügbar ist. Am unteren Fensterrand erscheint nach dem Starten der bwLehrpool-Suite gegebenenfalls zusätzlich ein Hinweis zur Verfügbarkeit neuer Versionen. 
-  * Im rechten oberen Teil des Programmfensters sehen Sie den aktuellen Arbeitsspeicherverbrauch der bwLehrpool-Suite (JVM: derzeit genutzer Speicher der JVM/alloziiert für JVM, maximal für JVM verfügbares RAM, Store: verbleibender Speicher des Satellitenservers). Ist der Speicher des Satellitenservers erschöpft, können keine weiteren Virtuelle Maschinen hochgeladen werden. 
- 
-<note tip>Ihre Sitzung bleibt gespeichert, wenn Sie die Suite schließen und im Anmeldefenster [Benutzername speichern] gewählt haben. Das heißt, Sie werden automatisch eingeloggt, wenn Sie die Suite erneut starten. Haben Sie die Suite an einem öffentlichen oder fremden Computer eingesetzt, ist es empfehlenswert, sich über den Menüpunkt [Sitzung] -> [Abmelden und beenden] korrekt auszuloggen und die Suite zu beenden. 
-</note> 
-==== Einstellungen ==== 
- 
-[{{ bwSuite:bwlehrpool_dozmod_einstellungen.png?300|bwLehrpool-Suite: Usereinstellungen}}] 
-Hier können einige Einstellungen der bwLehrpool-Suite, wie z.B. die E-Mail-Benachrichtigung, konfiguriert werden. 
- 
-  * E-Mail-Benachrichtigungen: Standardmäßig ist die E-Mail-Benachrichtigung aktiviert. Sie werden informiert, falls wichtige Ereignisse bezüglich Ihrer Virtuellen Maschinen und Veranstaltungen anstehen. Dies könnte etwa die anstehende automatische Löschung einer VM sein, oder das baldige Erreichen des Enddatums Ihrer Veranstaltung. Wenn Sie nicht benachrichtigt werden möchten, können Sie diese Option deaktivieren. Bitte beachten Sie aber, dass Sie in diesem Fall nicht vorgewarnt werden, wenn sich Änderungen an Ihren Virtuellen Maschinen bzw. Veranstaltungen ergeben! 
- 
-  * Proxyserver: Unter gewissen Umständen kann die automatische Suche der Proxyeinstellungen des Systems den Programmstart der bwLehrpool-Suite verzögern. Ist in Ihrem Netzwerk kein Proxy notwendig, können Sie diese Option auf „Keinen Proxy verwenden“ setzen. 
- 
-  * Schriftgröße: Falls Ihr Rechner die Schrift der bwLehrpool-Suite zu klein oder zu groß anzeigt, können Sie hier variieren. 
- 
-  * Look and feel: Innerhalb gewisser, vom verwendeten Betriebssystem und Oberfläche abhängigen Grenzen läßt sich hier das Aussehen der bwLehrpool-Suite verändern. 
- 
-  * Verbindungen pro Transfer: Wenn der Upload einer VM auf den Satellitenserver deutlich langsamer stattfindet als Ihr Netzwerk eigentlich zulässt, können Sie die Verbindungen pro Transfer erhöhen. Beachten Sie aber: Zu hohe Werte können einen gegenteiligen, negativen Effekt haben. 
- 
-{clear} 
-===== Virtuelle Maschinen ===== 
- 
-Verwenden Sie, wenn irgend möglich, eine bereits bestehende Vorlage aus dem bwLehrpool-System als Grundlage, wenn Sie eine neue Lehrumgebung erstellen. Dies erspart Ihnen nicht nur die Erstinstallation eines Betriebssystems, sondern auch die Anpassung an die bwLehrpool-Umgebung (automatische Anpassung der Bildschirmauflösung, Deaktivierung nicht benötigter Dienste usw.). Die Erstellung einer komplett neuen Virtuellen Maschine sowie die Anpassung an bwLehrpool ist derzeit nicht Teil dieser Anleitung. Bitte vergleichen Sie hierzu den Artikel [[client:neue_vm_anlegen|Erstellen neuer Virtueller Maschinen]]. 
- 
- 
-==== Bestehende Virtuelle Maschinen herunterladen ==== 
- 
-[{{ bwSuite:bwlehrpool_dozmod_uebersicht_virt_maschinen.png?500|bwLehrpool-Suite: Übersicht Virtuelle Meschinen}}] 
- 
-Möchten Sie eine bereits bestehende VM (z.B. eine Vorlage) herunterladen, wechseln Sie bitte zur „Übersicht Virtueller Maschinen“. Sie können die Liste frei durchsuchen oder nach ausgewählten Kriterien filtern. 
- 
-Haben Sie sich für eine VM entschieden, klicken sie auf den „Download“-Button im Menüband unten, oder rechtsklicken Sie auf die gewünscht VM und wählen „Download“. Wenn der Download startet, öffnet sich im unteren Anzeigebereich ein Ladebalken, in dem Sie den Fortschritt nachverfolgen können. Nach Abschluss des Downloads können Sie den Ablageort direkt öffnen oder den Fortschrittsbalken schließen. 
- 
-Sie können die heruntergeladene VM nun mit Hilfe des VMWare Players öffnen, starten und nach Belieben verändern. 
- 
- 
-==== Neue Virtuelle Maschinen hochladen ==== 
- 
-Wenn Sie Ihre VM soweit bearbeitet haben, dass Sie sie hochladen möchten, wechseln Sie wieder zur „Übersicht Virtueller Maschinen“ und klicken auf „Neue VM“. Ein Assistent hilft Ihnen durch die nun erforderlichen Schritte. Vergeben Sie bitte einen sinnvollen Namen((Tipp: Der Name einer VM oder einer Veranstaltung muss nicht zwingend eindeutig sein, sollte es aber.)) für Ihre VM und fügen Sie eine Beschreibung hinzu, damit andere Nutzer, insbesondere aber die Betreiber des bwLehrpool-Dienstes, den Verwendungszweck der VM erkennen können. Anschließend haben Sie die Möglichkeit, Berechtigungen für Ihre VM zu setzen. 
- 
-[{{ bwSuite:bwlehrpool_dozmod_neues_abbild_rechte_festlegen.png?400|bwLehrpool-Suite: Rechte anderer Nutzer}}] 
-^ Verlinken | Eine Veranstaltung auf diese Virtuelle Maschine / dieses Abbild verlinken |  
-^ Download | Dieses Abbild darf heruntergeladen werden | 
-^ Bearbeiten | Die VM löschen, eine neue Version der VM hochladen oder Metadaten wie Name oder Beschreibung ändern. Nicht jedoch Ändern der Berechtigungen! |  
-^ Admin | Zusätzlich zu Link, Download und Bearbeiten können die Berechtigungen der anderen Nutzer geändert werden. Admins können zudem Löschaktionen ausführen. | 
- 
-In Beispiel rechts besitzt der Nutzer „Christian Rößler“ die gleichen Berechtigungen wie der Ersteller der VM. Er kann eine Veranstaltung auf Basis dieser VM erstellen, die VM herunterladen, Name und Beschreibung ändern oder aufgrund des Adminrechtes löschen. Außerdem kann er, ebenfalls aufgrund des Adminrechts, im Gegensatz zu „Jonathan Bauer“ zusätzlich die Berechtigungen der anderen Nutzer verändern. Der Nutzer „Simon Rettberg“ kann die VM nur verlinken oder herunterladen, jedoch nicht verändern. Alle anderen Benutzer des Systems können die VM lediglich herunterladen. 
- 
-Klicken Sie auf „Fertigstellen“, um den Upload zu starten. Sie können das Fenster schließen und mit der Suite weiterarbeiten. Ihr Upload wird dann im Hintergrund fortgesetzt. 
-{clear} 
- 
-<note warning>Bitte beachten Sie, daß hochzuladende Virtuelle Maschinen monolithisch („single file“) vorliegen müssen. Sollten Sie mit Snapshots gearbeitet haben, so müssen diese vor dem Hochladen mit der Basis-VM zusammengeführt bzw. reintegriert werden!</note> 
- 
- 
-=== Eine neue Version einer Virtuellen Maschine erstellen === 
- 
-Falls Sie eine aktualisierte Version einer bereits in bwLehrpool vorhandenen VM hochladen möchten, müssen Sie sie nicht als komplett neue VM behandeln. Sie haben auch die Möglichkeit, die aktualisierte VM als neue Version bereitzustellen. 
- 
-Um eine neue Version der existierenden VM hochzuladen, öffnen Sie per Doppelklick oder „Bearbeiten“ die Detailansicht der bestehenden VM und wählen „Neue VM-Version hochladen“. Der Vorteil einer so hochgeladenen neuen Version besteht darin, dass auf diese VM zeigende Veranstaltungen automatisch die aktuellste Version referenzieren((Achtung: Trifft nur zu, wenn die Veranstaltung die Option „Immer aktuellste Version verwenden“ aktiviert hat.)). Ältere Versionen bleiben nur für eine Zeitdauer einiger Tage auf dem Satellitenserver gespeichert, bevor sie zum Speicherplatzsparen automatisch gelöscht werden. Sie können eine Version auch direkt löschen, indem Sie auf dem Eintrag in der Detailansicht rechtsklicken und „Löschen“ wählen. 
- 
- 
-==== Virtuelle Maschinen bearbeiten ==== 
- 
-Möchten Sie die Metadaten einer bestehenden VM bearbeiten, klicken Sie doppelt auf einen Eintrag der Liste oder wählen Sie „Detailansicht“ im unteren Menüband. Je nach Berechtigung an der gewählten VM können Sie nun den Namen, die Beschreibung oder den Typ des Betriebssystems ändern. Gegebenenfalls können Sie auch Berechtigungen der VM vergeben oder den Besitzer ändern. 
- 
-Klicken Sie einfach auf den angezeigten Nutzernamen, um mit dem Besitzer der VM in Kontakt zu treten. 
- 
- 
-==== Virtuelle Maschinen löschen ==== 
- 
-Wählen Sie in der Liste der Virtuellen Maschinen den gewünschten Eintrag aus und klicken Sie im unteren Menüband auf „Löschen“. Damit werden alle bestehenden Versionen der gewählten VM gelöscht. Sollte noch eine Veranstaltung auf diese VM verlinken, wird diese deaktiviert. Sie können die bestehende Veranstaltung später mit einer neuen VM verknüpfen und wieder aktivieren. 
- 
-==== Beschreibungsdatei der Virtuellen Maschine bearbeiten ==== 
- 
-Wenn Sie eine VM hochladen, wird zusätzlich zur virtuellen Festplatte ('vmdk') immer auch die zugehörige Beschreibungsdatei ('vmx') in Teilen gespeichert. Die serverseitig gespeicherten Metadaten enthalten nicht alle Werte wie die Datei auf Ihrem lokalen Rechner. Beispielsweise kann die Größe des Arbeitsspeichers oder die Anzahl an Prozessoren erst auf dem jeweiligen bwLehrpool-Client erkannt und entsprechend sinnvolle Werte in die vmx eingetragen werden. Dies erledigt bwLehrpool automatisch, wenn Sie die VM im Poolraum starten. Es macht daher keinen Sinn, diese und einige andere Werte auf dem Server zu speichern. 
- 
-Wenn Sie wissen wollen, welche Teile der vmx auf dem Satellitenserver gespeichert wurden oder diese selbst noch ändern möchten, können Sie das Detailfenster Ihrer VM öffnen. Führen Sie einen Rechtsklick auf die aktuelle VM-Version und wählen 'VM-Konfiguration' aus. Über die angezeigte Oberfläche können Sie einige der Werte, wie z.B. die verwendete Hardwareversion einfach per Dropdown-Menü anpassen. Falls Sie weitere Werte editieren möchten, klicken Sie auf 'Expertenmodus' 
- 
-<note warning>Bitte beachten Sie die angezeigte Warnung im VM-Konfigurations Editior. Sie können dort die Ausführung der VM innerhalb der Poolräume u.U. maßgeblich beeinträchtigen! Außerdem können hier gespeicherte Werte von bwLehrpool je nach vorhandener Hardware in den Poolräumen auch noch zur Laufzeit verändert werden.</note> 
- 
- 
-===== Veranstaltungen ===== 
- 
-==== Eine neue Veranstaltung erstellen ==== 
- 
-[{{ bwSuite:dozmod_veranstaltung_erzeugen_angaben_gueltigkeitsdauer.png?300|bwLehrpool-Suite: Allgemeine Angaben zur Veranstaltung}}] 
- 
-Damit Ihre Virtuelle Maschine im PC-Pool gestartet werden kann, müssen Sie eine Veranstaltung dazu erstellen. Wechseln Sie zur Liste der Veranstaltungen und wählen im unteren Menüband „Neue Veranstaltung“((Tipp: Sie können auch direkt aus der Liste der VMs eine neue Veranstaltung anlegen, indem Sie die VM auswählen und „Neue Veranstaltung“ im Menüband unten klicken.)). Ein Assistent wird Sie durch die folgenden Schritte begleiten. 
- 
-Vergeben Sie bitte auch hier einen sinnvollen Namen und eine Beschreibung. Der gewählte Veranstaltungsname wird später im vmChooser in den PC-Pools sichtbar sein, Veranstaltungsname sowie -beschreibung werden zudem von der Suchfunktion des vmChoosers erfaßt. 
- 
-Eine Veranstaltung ist zeitlich begrenzt. Sie müssen daher Start- und Endzeitpunkt vorgeben. Der Startzeitpunkt darf durchaus in der Zukunft liegen, falls Ihre Veranstaltung erst zu einem späteren Zeitpunkt auftauchen soll. 
- 
-Anschließend können Sie die gewünschte VM auswählen, die durch Auswählen Ihrer Veranstaltung gestartet werden soll. Wenn Sie mit den Standardvorgaben bezüglich zusätzlicher Optionen, Rechtevergabe und Raumauswahl zufrieden sind, können Sie direkt auf „Fertigstellen“ klicken, fahren Sie ansonsten jeweils mit „Weiter“ fort. 
- 
-{clear} 
- 
-[{{ bwSuite:dozmod_veranstaltung_erzeugen_allgemeines_beschraenkungen.png?300|bwLehrpool-Suite: Beschränkungen (Netz, ext. Laufwerke, e-Prüfung}}] 
- 
-  * Die Option „Immer auf aktuellste Imageversion updaten“ bedeutet, dass diese Veranstaltung immer auf die neueste Version Ihrer gewählten VM verlinkt. Wenn Sie diese Option deaktivieren, zeigt Ihre Veranstaltung auf die derzeitig aktuelle Version der VM. Wird eine neue Version hochgeladen, referenziert Ihre Veranstaltung dann weiterhin die alte Version. Beachten Sie bitte, dass ältere Versionen nach einigen Tagen automatisch gelöscht werden. Sie müssen daher Ihre Veranstaltung in diesem Fall auf eine andere VM oder die aktuellste Version verlinken((Wenn Sie die alte Version zwingend weiterhin verwenden wollen, können Sie diese auch herunterladen und als neue VM wieder hochladen.)) oder sie wird automatisch deaktiviert. 
-  * Sie können Ihre Vorlesung temporär deaktivieren. Entfernen Sie dafür den Haken bei „Vorlesung ist aktiv“. Ihre Veranstaltung wird im vmChooser nun nicht mehr angezeigt. 
-  * Falls Ihre Veranstaltung im Rahmen einer E-Prüfung eingesetzt werden soll, setzen Sie bitte das Häkchen bei „Veranstaltung ist eine Prüfung“. Dies wird dafür sorgen, dass diese Veranstaltung **nicht** im Normalbetrieb auftaucht, sondern ausschließlich in Räumen, die von einem bwLehrpool-Admin in den speziellen Prüfungsmodus versetzt wurden. 
-  * „Netzwerk-/Internetzugriff zulassen“: Setzen Sie ein Häkchen, falls Ihre Veranstaltung Internetzugriff haben soll bzw. entfernen Sie es, wenn nicht. 
-    * „Ausnahmen“: Falls Sie Netzwerk-/Internetzugriff zugelassen haben, definieren Eintragungen hier Verbote; falls Sie den Zugriff verboten haben, definieren Einträge erlaubte Sockets (Host und Port). Bitte beachten Sie unbedingt die Hinweise im sich bei Druck auf „Ausnahmen“ öffnenden Fenster. 
-  * „Speichermedien zulassen“: Stellen Sie hier ein, ob aus Ihrer Veranstaltung heraus Zugriff auf CDROMs, DVDs und USB-Speichermedien erlaubt sein soll oder nicht. 
- 
-<note important>Wie gesagt: Wenn Sie eine Veranstaltung in den Prüfungsmodus setzen, können Sie diese nicht in einem Poolraum im Normalbetrieb starten! Sie können den Prüfungsmodus auch nachträglich noch setzen bzw. entfernen.</note> 
- 
-Bitte vergleichen Sie zu den folgenden Optionen „Berechtigungen festlegen“ und „Raumauswahl“ die Beschreibungen bei den Unterpunkten [[client:bwlehrpool-suite#Berechtigungen|Berechtigungen]] und [[client:bwlehrpool-suite#Raumauswahl|Raumauswahl]]. 
- 
-{clear} 
- 
 ==== Veranstaltungen bearbeiten ==== ==== Veranstaltungen bearbeiten ====
  
Zeile 236: Zeile 52:
  
 **Achtung**: Wenn Sie eine Veranstaltung in den Prüfungsmodus setzen, sollten Sie darauf achten, daß der Prüfungspoolraum nicht per Raumauswahl ausgeschlossen wurde (siehe [[allgemein/faq#poolrechner_wurden_im_pruefung|FAQ/bwEKlausuren]]). **Achtung**: Wenn Sie eine Veranstaltung in den Prüfungsmodus setzen, sollten Sie darauf achten, daß der Prüfungspoolraum nicht per Raumauswahl ausgeschlossen wurde (siehe [[allgemein/faq#poolrechner_wurden_im_pruefung|FAQ/bwEKlausuren]]).
 +
 +{clear}
 +
 +=== Firewall ===
 +
 +[{{ bwSuite:dozmod_veranstaltung_bearbeiten_firewall.png?300|bwLehrpool-Suite: Firewall}}]An erster Stelle kann über „Netzwerk-/Internetzugriff“ festgelegt werden, ob die in der Veranstaltung enthaltene Virtuelle Maschine auf Netzwerke inklusive dem Internet zugreifen kann. Ist dies aktiviert, gelten eingegebene Firewall-Regeln und vordefinierte Regelsätze als verboten (‚blacklisted‘; wenn nicht aktiviert, gelten eingegebene Regeln als erlaubt (‚whitelisted‘).
 +
 +Eingegebene Regeln werden im Format <host> <in/out> <port> erwartet (siehe Abb. rechts). Die Portangabe „0“ bedeutet alle Ports, tcp und udp. Hosts können sowohl mit dem Domainnamen als auch mit IP-Adresse beschrieben werden. Eine Host-Angabe mit Netzmaske der Form 1.2.3./24 wird ebenfalls akzeptiert. Mit einem Klick auf die Schaltfläche „Regeln überprüfen“ kann eine Syntaxkontrolle ausgelöst werden.
 +
 +Ein Klick auf „Vordefinierte Regelsets“ zeigt, so vorhanden, eine Liste vordefinierter Regelsätze. Diese können per Markierung aktiviert und deaktiviert werden.
 +
 +<note tip>DNS-Abfragen bleiben auch bei blockiertem Netzwerkzugriff erlaubt, um notwendige Namensauflösungen zu gewährleisten.</note>
  
 {clear} {clear}
Zeile 249: Zeile 77:
 Beispiel: In der Abbildung rechts wurde ein Häkchen bei „Rechenzentrum“ gesetzt; die in der Hierarchie darunterstehenden Poolräume von „Lehrstuhl/1.OG“ bis „Poolraum -114“ wurden automatisch markiert. Zusätzlich wurden in der UB Stadtmitte einzeln die Poolräume „Pool OG2“ und „Pool OG4“ markiert und die Option „Veranstaltung mit höherer Priorität in den ausgewählten Räumen anzeigen“ gewählt. Die Veranstaltung wird also in allen Poolräumen des Rechenzentrums bevorzugt in eigener Rubrik angezeigt, und in allen nichtmarkierten Räumen in normaler, nicht hervorgehobener Abfolge. Beispiel: In der Abbildung rechts wurde ein Häkchen bei „Rechenzentrum“ gesetzt; die in der Hierarchie darunterstehenden Poolräume von „Lehrstuhl/1.OG“ bis „Poolraum -114“ wurden automatisch markiert. Zusätzlich wurden in der UB Stadtmitte einzeln die Poolräume „Pool OG2“ und „Pool OG4“ markiert und die Option „Veranstaltung mit höherer Priorität in den ausgewählten Räumen anzeigen“ gewählt. Die Veranstaltung wird also in allen Poolräumen des Rechenzentrums bevorzugt in eigener Rubrik angezeigt, und in allen nichtmarkierten Räumen in normaler, nicht hervorgehobener Abfolge.
  
 +Sollten Sie beim Speichern einer Veranstaltung die Fehlermeldung „Too many locations for lecture“ erhalten, haben Sie mehr Räume explizit markiert, als Ihre Admin per Satellitenserver [[:satellite:bwlehrpoolsuite_einstellungen#limits_und_standardwerte|zuließ]].
  
 {clear} {clear}
  
-=== Startskript ===+=== VM-Start ===
  
 [{{ bwSuite:dozmod_veranstaltung_bearbeiten_startskript.png?300|bwLehrpool-Suite: Startskript}}] [{{ bwSuite:dozmod_veranstaltung_bearbeiten_startskript.png?300|bwLehrpool-Suite: Startskript}}]
  
-Diese Option ermöglicht die Ablage kleiner Skripte, die beim Start einer Virtuellen Maschine (genaugenommen: der VM, die in dieser Veranstaltung gestartet wird) automatisch gestartet werden. Zur Dateiendungsauswahl stehen .sh (für linux- bzw. unixbasierte Maschinen) sowie .bat (für Windows). Die Dateiendung ist speziell für Windows wichtig.+== Audiovorgaben == 
 + 
 +Hier kann eingestellt werden, wie Audio beim Start der Veranstaltung behandelt wird: 
 +  * nach Vorgabe des Pools, also entsprechend der Vorgabewerte des Satellitenservers, 
 +  * stummgeschaltet wird, oder 
 +  * aktiviert ist. 
 + 
 +Anmerkung: „stummschalten“ sperrt Audio nicht, sondern deaktiviert lediglich die Ausgabe (a la „durchgestrichener Lautsprecher“) und kann userseitig aktiviert werden. 
 + 
 +== Skript == 
 + 
 +Diese Option ermöglicht die Ablage kleiner Skripte, die beim Start einer Virtuellen Maschine (genaugenommen: der VM, die in dieser Veranstaltung gestartet wird) automatisch gestartet werden. Zur Dateiendungsauswahl stehen .sh (für linux- bzw. unixbasierte Maschinen) sowie .bat (für Windows). Die Dateiendung ist speziell für Windows wichtig. Ein Klick auf die Schaltfläche „Vordefinierte Skripte“ zeigt - wenn vorhanden - eine Auswahl [[:satellite:bwlehrpoolsuite_einstellungen#startskripte|per Satellitenserver vorgegebener]] Skripte an. Ausgegraute Vorgabeskripte sind nicht zu dem in Ihrer Veranstaltung genutzten Betriebssystem kompatibel. 
 + 
 +Bezüglich der Sichtbarkeit kann eingestellt werden:  
 +  * Normal: Das Skript wird in einem ganz normal geöffneten Fenster auf dem jeweiligen Desktop geöffnet und gestartet. 
 +  * Versteckt: Das Skript wird im Hintergrund gestartet. 
 +  * Minimiert: Das Skript wird in einem minimierten, also weggeklappten Fenster auf dem jeweiligen Desktop geöffnet und gestartet. 
  
 Bitte beachten Sie bei Verwendung eines Startskriptes: Bitte beachten Sie bei Verwendung eines Startskriptes:
Zeile 265: Zeile 111:
   * Da diese Startskripte in Ihrer Regie entstehen, kann von Seiten des bwLehrpool-Teams nur in Ausnahmefällen Support geleistet werden.   * Da diese Startskripte in Ihrer Regie entstehen, kann von Seiten des bwLehrpool-Teams nur in Ausnahmefällen Support geleistet werden.
  
-Anmerkung: Diese Mechanismen bedingen eine Minilinux-Version >=13. Erfragen Sie diese vor Einsatz eines Startskriptes ggf. bei Ihrer lokalen bwLehrpool-Administratorin (oder probieren Sie es einfach aus).+Anmerkung: Wenn Ihr Satellitenserver die [[satellite:ad_wizard#startskript-credentials|Weitergabe der Benutzer-Credentials]] zulässt, können Sie im Startskript mit den Variablen %1 (Benutzername) und %2 (Passwort) arbeiten. Erfragen Sie die Funktion vor Einsatz eines Startskriptes ggf. bei Ihrer lokalen bwLehrpool-Administratorin (Admins: [[satellite:ldap-wizard|LDAP]]/[[satellite:ad_wizard#startskript-credentials|AD]]), oder probieren Sie es einfach aus.
  
 {clear} {clear}
Zeile 301: Zeile 147:
  
 {clear} {clear}
- 
  
 === LDAP-Filter === === LDAP-Filter ===
  
-[{{ bwsuite:bwlehrpool_dozmod_veranstaltung_ldap_02.png?300|bwLehrpool-Suite: LDAP-Veranstaltungsfilter}}]+[{{ :bwsuite:suite_ldap_filter.png?300|bwLehrpool-Suite: LDAP-Veranstaltungsfilter, Beispiel „externe Gäste“}}]
  
-(folgt) +Die Sichtbarkeit einer Veranstaltung kann mittels der Option „LDAP-Filter“ auf bestimmte Personenkreise eingeschränkt werden, sofern hierfür ein beliebiger, von Ihrer Infrastruktur angebotener ldap-Wert ausgewertet werden kann. Es können mehrere Filter angegeben werden; eine Veranstaltung wird dann angezeigt, wenn einer der angegebenen Filter zutrifft. Zudem können hier eventuell vom Satellitenserver übertragene vorgefertigte ldap-Filter aktiviert werden.
-==== Veranstaltungen löschen ====+
  
-Wenn Sie eine Veranstaltung löschen möchten, wählen Sie diese in der Liste der Veranstaltungen aus und klicken auf im unteren Menüband auf „Löschen“.+Filter können z.B. folgendermaßen aussehen((https://doc.qt.io/qt-5/qregularexpression.html#wildcardToRegularExpression)): 
 +  * uid=max.mustermann 
 +  * uid=max* 
 +  * group=informatik-20?? 
 +  * ...
  
-===== FAQ =====+Bitte beachten Sie jedoch, daß Einschränkungen per Raumauswahl dadurch nicht aufgehoben werden!
  
-Bitte vergleichen Sie die [[allgemein:faq#bwLehrpool-Suite|FAQ]]. +{clear}
- +
-===== Support ===== +
- +
-<note tip> +
-**Bitte melden Sie Probleme an die bwLehrpool-Service-Adresse** [[bwlehrpool@hs-offenburg.de]]. +
- +
-Bitte melden Sie das Problem möglichst sofort und fügen eine genaue Fehlerbeschreibung hinzu, da sonst eine sinnvolle Bearbeitung nur schwer möglich ist. +
-</note> +
- +
-| Die Fehlersuche wird sehr vereinfacht, wenn Sie in jedem Fall die bwLehrpool-Suite-Logdatei bwSuite.log mitsenden. Sie finden die Logdatei unter ~/.config/bwSuite (Linux), C:\User\<IhrUserName>\AppData\Roaming\bwSuite (Windows) bzw. ~/bwSuite (OS X).\\ \\ Sie können das Verzeichnis, das die Logdatei enthält, bequem öffnen, wenn Sie:\\ \\ - vor dem Login, den in direkt nebenstehendem Bild grün umrandeten Knopf anklicken (hilfreich bei Loginproblemen), oder\\ \\ - nach erfolgreichem Login auf „Sitzung“, „Logverzeichnis öffnen“ gehen (siehe Bild rechts außen). | [{{ bwSuite:bwlehrpool_dozmod_login_log_markiert.png?300 | bwLehrpool-Suite: Verzeichnis mit Logdatei vor Login}}] | [{{ bwSuite:bwlehrpool_dozmod_logdateiverzeichnis_nach_login.png?300|bwLehrpool-Suite: Verzeichnis mit Logdatei nach Login}}] |+
Drucken/exportieren