Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
client:bwlehrpool-suite [2018/11/21 16:43 CET]
chr [Menüleiste]
client:bwlehrpool-suite [2021/07/06 17:01 CEST] (aktuell)
chr [Veranstaltungen bearbeiten]
Zeile 10: Zeile 10:
 ===== Software: Die bwLehrpool-Suite ===== ===== 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.+Die bwLehrpool-Suite (gern 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.
  
  
Zeile 33: Zeile 33:
 ==== Systemvoraussetzungen ==== ==== 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“.+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://adoptopenjdk.net/|openJDK-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“.
  
  
Zeile 42: Zeile 42:
 ==== Anmeldung ==== ==== 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“. +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?450 |bwLehrpool-Suite: Loginfenster}}]
-[{{ bwSuite:bwlehrpool_dozmod_login.png?500 |bwLehrpool-Suite: Loginfenster}}]+
  
 <note tip> <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). +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.php#Zugeh%C3%B6rigkeit). 
-Alternativ kann das bwLehrpool-Entitlement gesetzt werden (https://www.bwidm.de/dienste/#bwlehrpool), um beispielsweise einzelnen Studierenden oder Externen den Zugriff zu ermöglichen.+Alternativ kann das bwLehrpool-Entitlement gesetzt werden (Informationen dazu unter: https://www.bwidm.de/dienste.php Abschnitt bwLehrpool), um beispielsweise einzelnen Studierenden oder Externen den Zugriff zu ermöglichen.
 </note> </note>
  
 <note tip> <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]].+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 [[support@bwlehrpool.de]].
 </note> </note>
  
-Falls Ihre Institution mehrere Satellitenserver betreibt, erscheint nach erfolgter Anmeldung ggf. ein Auswahlfenster.+[{{bwSuite:bwlehrpool_dozmod_startbildschirm.png?400 |bwLehrpool-Suite: Auswahlbildschirm (Virtuelle Maschinen und Veranstaltungen)}}]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. 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> <note tip>
Zeile 64: Zeile 63:
   * Halten Sie die Shift/Umschalttaste gedrückt, wenn Sie einen Mausklick auf „Login“ ausführen. Auch dann erscheint eine Liste inkl. Eingabemöglichkeit.   * Halten Sie die Shift/Umschalttaste gedrückt, wenn Sie einen Mausklick auf „Login“ ausführen. Auch dann erscheint eine Liste inkl. Eingabemöglichkeit.
 </note> </note>
 +
 ==== Menüleiste ==== ==== Menüleiste ====
  
 [{{ bwSuite:bwlehrpool_dozmod_menuezeile.png |bwLehrpool-Suite: Menuzeile}}] [{{ bwSuite:bwlehrpool_dozmod_menuezeile.png |bwLehrpool-Suite: Menuzeile}}]
-<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> 
  
 +  * In der Titelleiste des Fensters sehen Sie nach dem Programmnamen (bwLehrpool-Suite) Ihren Loginnamen gefolgt von der IP-Adresse des verbundenen Satellitenservers.
   * Ü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 [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.   * Ü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.
Zeile 75: Zeile 74:
   * 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.   * 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 ==== ==== Einstellungen ====
  
-[{{ bwSuite:bwlehrpool_dozmod_einstellungen.png?300|bwLehrpool-Suite: Usereinstellungen}}]+[{{ bwSuite:bwlehrpool_dozmod_einstellungen.png?350|bwLehrpool-Suite: Usereinstellungen}}]
 Hier können einige Einstellungen der bwLehrpool-Suite, wie z.B. die E-Mail-Benachrichtigung, konfiguriert werden. Hier können einige Einstellungen der bwLehrpool-Suite, wie z.B. die E-Mail-Benachrichtigung, konfiguriert werden.
  
Zeile 91: Zeile 92:
   * 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.   * 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.
  
 +  * Sprache: Derzeit unterstützt werden Deutsch, Englisch und Türkisch.
 {clear} {clear}
 +
 ===== Virtuelle Maschinen ===== ===== 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]]. 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 ==== ==== Bestehende Virtuelle Maschinen herunterladen ====
  
-[{{ bwSuite:bwlehrpool_dozmod_uebersicht_virt_maschinen.png?500|bwLehrpool-Suite: Übersicht Virtuelle Meschinen}}]+[{{ bwSuite:bwlehrpool_dozmod_uebersicht_virt_maschinen.png?600|bwLehrpool-Suite: Übersicht Virtuelle Maschinen}}][{{ bwSuite:dozmod_vm_menuband_aktiv_inaktiv.png?600|bwLehrpool-Suite: Direktbefehle im Menuband. Oben: Ohne markierte VM, unten: VM aus Auswahl markiert.}}]Möchten Sie eine bereits bestehende VM (z.B. eine Vorlage) herunterladen, wechseln Sie bitte zur „Übersicht Virtueller Maschinen“.
  
-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.+Sie können die Liste durch Eingabe eines Begriffs unter „Suchen“ frei durchsuchen und per Auswahlmenu rechts daneben auch zusätzlich nach vordefinierten Kriterien filtern. Aktivierung des Häkchens „Suche in Beschreibung“ erweitert die Suche von reiner Suche im Namensfeld auf [[#virtuelle_maschinen_bearbeiten|eben das]]. Als vordefinierte Kriterien stehen bereit:
  
-Haben Sie sich für eine VM entschiedenklicken sie auf den „Download“-Button im Menüband untenoder rechtsklicken Sie auf die gewünscht VM und wählen „Download“. Wenn der Download startetöffnet sich im unteren Anzeigebereich ein Ladebalkenin dem Sie den Fortschritt nachverfolgen können. Nach Abschluss des Downloads können Sie den Ablageort direkt öffnen oder den Fortschrittsbalken schließen.+  * Alle anzeigen, 
 +  * Nur eigene / zugewiesene anzeigen, 
 +  * Nur verwendbare / linkbare anzeigen, 
 +  * Nur editierbare anzeigen, 
 +  * Nur Vorlagen anzeigen.
  
-Sie können die heruntergeladene VM nun mit Hilfe des VMWare Players öffnenstarten und nach Belieben verändern.+Weiterhin wird Name/Art des Betriebssystems angezeigt, Besitzer/in, letztes Änderungsdatum, Ablaufdatum und Größe der VM. Beachten Sie auch die Spalten am rechten Rand des Fensters (ggf. per Laufbalken scrollen)die einen direkten Überblick zur Verwendbarkeit (VM als aktiv geschaltet), Vorlagenstatus und verwendeten Virtualisierern (meistens VMPlayer{{bwSuite:dozmod_symbol_vmware.png}}, alternativ auch VirtualBox{{bwSuite:dozmod_symbol_virtualbox.png}}, Docker{{bwSuite:dozmod_symbol_docker.png}}) gestatten. Die Spalte „Versionen“ gibt an, wieviele Versionen (siehe [[#eine_neue_version_einer_virtuellen_maschine_erstellen|Aktualisierung]] einer VM) der betreffenden Virtuellen Maschine existieren. „Gesamtgröße“ zeigt den belegten Platz aller Versionen einer VM zusammengenommen an.
  
 +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 bzw. VirtualBox öffnen, starten und nach Belieben verändern.
  
 ==== Neue Virtuelle Maschinen hochladen ==== ==== 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:dozmod_neue_vm_anlegen.png?340|bwLehrpool-Suite: Anlage einer neuen VM}}] 
 +[{{ bwSuite:dozmod_neue_vm_metadaten.png?340|bwLehrpool-Suite: Eingabe Metadaten}}] 
 +[{{ bwSuite:bwlehrpool_dozmod_neues_abbild_rechte_festlegen.png?340|bwLehrpool-Suite: Rechte anderer Nutzer}}]Wenn Sie Ihre VM soweit bearbeitet haben, dass Sie sie hochladen möchten, wechseln Sie zur „Übersicht Virtueller Maschinen“ und klicken auf „Neue VM“.
  
-[{{ bwSuite:bwlehrpool_dozmod_neues_abbild_rechte_festlegen.png?400|bwLehrpool-Suite: Rechte anderer Nutzer}}] +Ein Assistent hilft Ihnen durch die nun erforderlichen SchritteÖffnen Sie per „Durchsuchen“ das Verzeichnis, in dem Sie Ihre Virtuelle Maschine speichertenund wählen die jeweilige Leitdatei aus (beispielsweise bei VMware die Endung .vmx). Es sollte im Normalfall nur eine Datei angezeigt werden; sollte dies nicht der Fall sein, können Sie, um sicherzugehen, bei „Dateityp“ anstatt „all supported“ den Typ Ihrer VM erzwingenDer Name der VM wird gewöhnlich vorausgefüllt, es steht Ihnen frei, ihn zu verändern. Vergeben Sie bitte einen sinnvollen Namen((Tipp: Der Name einer VM oder einer Veranstaltung muss nicht zwingend eindeutig seinsollte es aber.)) und klicken auf „Weiter“.
-^ 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 ändernNicht jedoch Ändern der Berechtigungen! |  +
-^ Admin | Zusätzlich zu LinkDownload und Bearbeiten können die Berechtigungen der anderen Nutzer geändert werdenAdmins 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.+<note tip>Falls Sie keine komplett neue VM hochladen wollen, sondern eine bereits existierende aktualisiert haben, empfiehlt es sich, den Mechanismus zur [[#eine_neue_version_einer_virtuellen_maschine_erstellen|Aktualisierung einer VM]] zu verwenden. Das erspart viel Arbeit, u.a. die Erstellung einer neuen Veranstaltung.</note> 
 + 
 +Kontrollieren Sie im nächsten Dialogfenster, ob die Art des Betriebssystems innerhalb der VM korrekt eingetragen wurde, und korrigieren diese, wenn nötig. Bitte fügen Sie eine aussagekräftige Beschreibung, gern auch mit Auflistung wichtiger installierter Software hinzu, damit andere Nutzende((und natürlich die Betreiber des bwLehrpool-Dienstes…)) den Verwendungszweck der VM erkennen können. Damit sind die wesentlichen Schritte getan; wenn Sie keine besonderen Rechte anderer Nutzer bestimmen wollen, können Sie direkt auf „Fertigstellen“ klicken, ansonsten gehen Sie auf „Weiter“. 
 + 
 +In diesem Fall haben Sie die Möglichkeit, Berechtigungen für Ihre VM zu setzen: 
 + 
 +^ Verlinken | Eine Veranstaltung auf diese Virtuelle Maschine / dieses Abbild verlinken. |  
 +^ Download | Dieses Abbild darf heruntergeladen werden. | 
 +^ Bearbeiten | Die VM darf gelöscht, eine neue Version der VM hochgeladen und Metadaten wie Name oder Beschreibung geändert werden. Berechtigungen dürfen jedoch nicht geändert werden! |  
 +^ Admin | Zusätzlich zu Link, Download und Bearbeiten können die Berechtigungen anderer Nutzer geändert werden. Admins können zudem Löschaktionen ausführen. | 
 + 
 +Die Schaltfläche „Benutzer hinzufügen“ öffnet eine Liste der dem Satellitenserver bekannten User. Zur Aufnahme markieren Sie die betr. Zeile und klicken auf „Hinzufügen“; sie können auch einfach einen Doppelklick ausführen. In Beispiel rechts besitzt der Nutzer „Steffen Ritter“ 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 in einer Veranstaltung verlinken oder herunterladen, jedoch nicht verändern. Haben Sie einen Benutzer versehentlich hinzugefügt, markieren Sie die betreffende Zeile und wählen „Benutzer entfernen“. 
 + 
 +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. 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> <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>
  
 +{clear}
  
-=== Eine neue Version einer Virtuellen Maschine erstellen ===+==== Virtuelle Maschinen bearbeiten ====
  
-Falls Sie eine aktualisierte Version einer bereits in bwLehrpool vorhandenen VM hochladen möchtenmüssen Sie sie nicht als komplett neue VM behandeln. Sie haben auch die Möglichkeit, die aktualisierte VM als neue Version bereitzustellen.+[{{ :bwsuite:dozmod_vm_uebersicht_allg.png?300|Virtuelle Maschine bearbeiten: Übersicht}}]Möchten Sie die Metadaten einer bestehenden VM bearbeitenklicken Sie doppelt auf einen Eintrag der Liste oder wählen Sie „Bearbeiten“ im unteren MenübandJe 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.
  
-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.+=== Übersicht ===
  
 +Im Reiter „Übersicht“  finden Sie die grundlegenden Informationen zur VM. Name und Beschreibung können beliebig editiert werden - wie immer gilt: Vergeben Sie möglichst aussagekäftige Namen und Beschreibungen. Per Linksklick auf den Namen des Besitzers und, so vorhanden, dem Namen bei „geändert durch“((Hierbei muss es sich aufgrund evtl. Berechtigungen durchaus nicht um dieselbe Person handeln!)) können Sie mit der betreffenden Person per Email in Kontakt treten. Beiden Einträgen (Erstellung und Änderung) ist jeweils ein Datum zugeordnet. Der Eintrag zum in der VM enthaltenen Betriebssystem kann verändert werden; seien Sie damit jedoch vorsichtig, dies kann sich beispielsweise auf vordefinierte Startskripte auswirken. 
  
-==== Virtuelle Maschinen bearbeiten ====+Freigabemodus, Versions-ID und VM-ID werden zur Information angezeigt, dienen aber im wesentlichen nur internen Zwecken und sind daher nicht editierbar. Bei genügender Berechtigung können VMs als sogenannte „Vorlagen-VMs“ deklariert werden, indem das Häkchen bei „Vorlage“ gesetzt wird. Dieses ist jedoch im Normallfall unerwünscht.
  
-Möchten Sie die Metadaten einer bestehenden VM bearbeitenklicken 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.+Letztendlich ist noch die für diese VM zuständige Virtualisierungssoftware benannt und die Anzahl der Veranstaltungendie auf diese VM verlinken. Ein Klick auf die Fläche Anzeigen“ listet diese auf.
  
-Klicken Sie einfach auf den angezeigten Nutzernamen, um mit dem Besitzer der VM in Kontakt zu treten.+== 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.
  
-==== Virtuelle Maschinen löschen ====+[{{ bwSuite:dozmod_vm_aktualisieren_button.png|bwLehrpool-Suite: VM aktualisieren}}]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“ (siehe Abb. rechts). 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.
  
-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.+=== VM-Versionen ===
  
-==== Beschreibungsdatei der Virtuellen Maschine bearbeiten ====+Hier erhalten Sie eine Auflistung der Versionen der vorher ausgewählten Virtuellen Maschinen. Markieren Sie zum weiteren Vorgehen mit Linksklick die gewünschte Version; ein Rechtsklick öffnet das dazugehörige Untermenü:
  
 +  * Neue Veranstaltung: Öffnet direkt den Wizards zur Erstellung einer Veranstaltung mit vorgewählter VM-Version. Dieser Menüpunkt ist ausgegraut, wenn die betreffende VM-Version bereits ablief.
 +  * Download: Lädt die jeweile Version herunter.
 +  * VM-Konfiguration: Öffnet Dialog zur [[#beschreibungsdatei_der_virtuellen_maschine_bearbeiten|Konfiguration per Beschreibungsdatei]] der gewählten Version der Virtuellen Maschine. Dieser Menüpunkt ist ausgegraut, wenn die VM-Version bereits ablief.
 +  * Löschen: Löscht die betreffende Version.
 +  * Ablaufzeitpunkt verlängern: Bietet die Möglichkeit zur Verlängerung des Ablaufzeitpunkts der Version, hauptsächlich nützlich, wenn Version bereits abgelaufen ist. Dieser Menupunkt ist nur bei [[:satellite:bwlehrpoolsuite_einstellungen#benutzer_und_berechtigungen|entsprechender Berechtigung]] anspringbar.
 +
 +== Beschreibungsdatei der Virtuellen Maschine bearbeiten ==
 +
 +[{{ :bwsuite:dozmod_vmx_bearbeiten.png?direct&300|bwLehrpool-Suite: VMX 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 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.
  
Zeile 152: Zeile 183:
 <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> <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>
  
 +=== Berechtigungen ===
 +
 +Berechtigungen können analog zur Beschreibung unter [[#neue_virtuelle_maschinen_hochladen|neue VM erstellen]] editiert und gespeichert werden.
 +
 +==== 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.
 +
 +==== Neue Veranstaltung ====
 +
 +Öffnet direkt den Dialog zur Erstellung einer neuen Veranstaltung. Weitere Informationen dazu [[#eine_neue_veranstaltung_erstellen|hier]].
 +
 +==== Öffentliche VMs ====
 +
 +Zeigt eine Liste mit vorhandenen „Öffentlichen VMs“, d.h. Virtuellen Maschinen, die landesweit veröffentlicht wurden. Sie können diese per „Herunterladen“ direkt, also lokal auf Ihren Rechner speichern, oder mit „Auf Satellit herunterladen“ auf den für Sie zuständigen Satellitenserver transferieren. Mehr dazu finden Sie unter „[[:client:oeffentliche_vms|Öffentliche VMs]]“.
  
 ===== Veranstaltungen ===== ===== Veranstaltungen =====
Zeile 237: Zeile 283:
  
 **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 250: Zeile 308:
 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 266: Zeile 342:
   * 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 302: Zeile 378:
  
 {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. 
 + 
 +Bitte beachten Sie jedoch, daß Einschränkungen per Raumauswahl dadurch nicht aufgehoben werden! 
 + 
 +{clear}
 ==== Veranstaltungen löschen ==== ==== Veranstaltungen löschen ====
  
Zeile 320: Zeile 399:
  
 <note tip> <note tip>
-**Bitte melden Sie Probleme an die bwLehrpool-Service-Adresse** [[bwlehrpool@hs-offenburg.de]].+**Bitte melden Sie Probleme an die bwLehrpool-Service-Adresse** [[support@bwlehrpool.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. 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.
Zeile 326: Zeile 405:
  
 | 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}}] | | 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