Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
client:bwlehrpool-suite [2020/11/10 08:38 CET] – [Anmeldung] sritterclient:bwlehrpool-suite [2023/07/21 15:53 CEST] (aktuell) – [Neue Virtuelle Maschinen hochladen] chr
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 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 (Informationen dazu unter: https://www.bwidm.de/dienste.php Abschnitt 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 61:
   * 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 ====
  
Zeile 76: Zeile 74:
 <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 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> </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 90:
   * 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. Beachten Sie auch die Spalten am rechten Rand des Fensters, die einen direkten Überblick zur Verwendbarkeit (VM als aktiv geschaltet), Vorlagenstatus (ja oder nein) und verwendeten Virtualisierern (meistens VMPlayer, alternativ auch VirtualBox) gestatten.+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 bzwzukünftig VirtualBox ö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 (ggfper 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 habendass 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 seinsollte 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.+<note warning>Bitte beachten Sie, daß hochzuladende Virtuelle Maschinen monolithisch (single file) vorliegen müssenSollten Sie mit Snapshots gearbeitet habenso müssen diese vor dem Hochladen mit der Basis-VM zusammengeführt bzwreintegriert werden!</note>
  
-[{{ bwSuite:bwlehrpool_dozmod_neues_abbild_rechte_festlegen.png?400|bwLehrpool-Suite: Rechte anderer Nutzer}}] +[{{ bwSuite:dozmod_neue_vm_anlegen.png?300|bwLehrpool-Suite: Anlage einer neuen VM}}]Wenn Sie Ihre VM soweit bearbeitet habendass Sie sie hochladen möchtenwechseln Sie zur „Übersicht Virtueller Maschinen“ und klicken auf „Neue VM“.
-^ Verlinken | Eine Veranstaltung auf diese Virtuelle Maschine / dieses Abbild verlinken |  +
-^ Download | Dieses Abbild darf heruntergeladen werden | +
-^ Bearbeiten | Die VM löscheneine neue Version der VM hochladen oder Metadaten wie Name oder Beschreibung ändern. Nicht 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 Steffen Ritter“ die gleichen Berechtigungen wie der Ersteller der VM. Er kann eine Veranstaltung auf Basis dieser VM erstellendie VM herunterladenName und Beschreibung ändern oder aufgrund des Adminrechtes löschenAußerdem kann erebenfalls aufgrund des Adminrechtsim 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ändernAlle anderen Benutzer des Systems können die VM lediglich herunterladen.+Ein Assistent hilft Ihnen durch die nun erforderlichen Schritte: Öffnen Sie per Durchsuchen“ das Verzeichnisin dem Sie Ihre Virtuelle Maschine speicherten, und 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 seinkönnen Sieum sicherzugehen, bei Dateityp“ anstatt „all supported“ den Typ Ihrer VM erzwingen. Der 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 sein, sollte es aber.)) und klicken auf „Weiter“.
  
-Klicken Sie auf „Fertigstellen“um den Upload zu startenSie können das Fenster schließen und mit der Suite weiterarbeitenIhr Upload wird dann im Hintergrund fortgesetzt. +<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 verwendenDas erspart viel Arbeit, u.adie Erstellung einer neuen Veranstaltung.</note>
-{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>+=== Metadaten ===
  
 +[{{ bwSuite:dozmod_neue_vm_metadaten.png?300|bwLehrpool-Suite: Eingabe Metadaten}}]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 und diese später im VMChooser-Suchdialog auch finden können.
  
-=== Eine neue Version einer Virtuellen Maschine erstellen ===+  * „VM enthält lizenzpflichtige Software“: Bitte de-markieren Sie hier, wenn es sich um frei weitergebbare Software inkl. Betriebssystem handelt. Es ist empfehlenswert, nach Möglichkeit open source-Software einzusetzen. 
 +  * „Vorlage erstellen“: Bei ausreichender Berechtigung können Sie hier die hochzuladende VM als sog. „Vorlage“ definieren. Dies empfiehlt sich jedoch nur in wenigen Fällen, etwa wenn Sie institutionsweit Basis-VMs zur Verfügung stellen, und sollte im Nornmalfall nicht aktiviert werden.
  
-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.+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“. 
 + 
 +=== Berechtigungen === 
 + 
 +[{{ bwSuite:bwlehrpool_dozmod_neues_abbild_rechte_festlegen.png?300|bwLehrpool-Suite: Nutzerrechte, VM-Erstellungsdialog}}][{{ bwSuite:bwlehrpool_dozmod_vm_detailansicht_rechte.png?300|bwLehrpool-Suite: NutzerrechteVM-Detailansicht}}]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 werdenBerechtigungen 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. Im rechtsstehenden Beispiel 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 und - aufgrund des Adminrechtes - löschen, außerdem - ebenfalls aufgrund des Adminrechts - im Gegensatz zu „Jonathan Bauer“ zusätzlich die Berechtigungen anderer Nutzer verändern. Der Nutzer „Simon Rettberg“ kann die VM nur über eine 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, aber nicht direkt aus einer Veranstaltung heraus verlinken. 
 + 
 +Klicken Sie abschließend 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.
  
-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 zuwenn die Veranstaltung die Option Immer aktuellste Version verwenden“ aktiviert hat.)). Ältere Versionen bleiben nur für eine Zeitdauer einiger Tage auf dem Satellitenserver gespeichertbevor 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.+Die Berechtigungen können natürlich auch später noch aus dem Detailansicht-Dialog der VM gesetzt oder verändert werden siehe Beispiel rechts, „NutzerrechteVM-Detailansicht“.
  
 +Anmerkung: Eingetragene User erhalten Status-Emails, wenn die eingetragenen Berechtigungen nicht leer („alles verboten“) sind.
  
 ==== Virtuelle Maschinen bearbeiten ==== ==== 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.+[{{ :bwsuite:dozmod_vm_uebersicht_allg.png?300|Virtuelle Maschine bearbeiten: Übersicht}}]Möchten Sie die Metadaten einer bestehenden VM bearbeiten, klicken Sie doppelt auf einen Eintrag der Liste oder wählen Sie „Bearbeiten“ 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.+=== Ü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 löschen ====+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.
  
-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 deaktiviertSie können die bestehende Veranstaltung später mit einer neuen VM verknüpfen und wieder aktivieren.+Letztendlich ist noch die für diese VM zuständige Virtualisierungssoftware benannt und die Anzahl der Veranstaltungen, die auf diese VM verlinken. Ein Klick auf die Fläche „Anzeigen“ listet diese auf.
  
-==== Beschreibungsdatei der Virtuellen Maschine bearbeiten ====+== 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. 
 + 
 +[{{ 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. 
 + 
 +=== VM-Versionen === 
 + 
 +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}}] [{{ :bwsuite:dozmod_vmx_bearbeiten.png?direct&300|bwLehrpool-Suite: VMX bearbeiten}}]
Zeile 153: Zeile 190:
 <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 238: Zeile 290:
  
 **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. Beachten Sie bei Angabe von Domainnamen jedoch, dass diese vor Anwendung einmalig zu IP-Adressen aufgelöst werden; eine Domain kann auf mehrere IPS auflösen (Lastverteilung u.a.). 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 251: Zeile 315:
 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 267: Zeile 349:
   * 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: Wenn Ihr Satellitenserver die 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 (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 284: Zeile 366:
  
 Beispiel: Im nebenstehenden Beispiel wurde Herrn Bauer das Recht „Admin“ (das Häkchen für das niedrigere Recht „Bearbeiten“ wird beim Speichern automatisch gesetzt) erteilt und den Herren Rettberg und Rößler jeweils das Recht „Bearbeiten“. Rechte für andere Nutzer wurden nicht erteilt. Beispiel: Im nebenstehenden Beispiel wurde Herrn Bauer das Recht „Admin“ (das Häkchen für das niedrigere Recht „Bearbeiten“ wird beim Speichern automatisch gesetzt) erteilt und den Herren Rettberg und Rößler jeweils das Recht „Bearbeiten“. Rechte für andere Nutzer wurden nicht erteilt.
 +
 +Anmerkung: Eingetragene User erhalten Status-Emails, wenn die eingetragenen Berechtigungen nicht leer („alles verboten“) sind.
  
 {clear} {clear}
Zeile 306: Zeile 390:
 === LDAP-Filter === === LDAP-Filter ===
  
-[{{ bwsuite:bwlehrpool_dozmod_veranstaltung_ldap_02.png?300|bwLehrpool-Suite: LDAP-Veranstaltungsfilter, Beispiel „externe Gäste“}}]+[{{ :bwsuite:suite_ldap_filter.png?300|bwLehrpool-Suite: LDAP-Veranstaltungsfilter, Beispiel „externe Gäste“}}]
  
-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.+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. 
 + 
 +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?? 
 +  * ...
  
 Bitte beachten Sie jedoch, daß Einschränkungen per Raumauswahl dadurch nicht aufgehoben werden! Bitte beachten Sie jedoch, daß Einschränkungen per Raumauswahl dadurch nicht aufgehoben werden!
Zeile 324: Zeile 414:
  
 <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 330: Zeile 420:
  
 | 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