From 432a197ac33d3837cd056b40a1634198a4585ad1 Mon Sep 17 00:00:00 2001 From: Dirk von Suchodoletz Date: Sat, 13 Nov 2010 10:53:27 +0100 Subject: Änderungen, Umbenennungen in der Dokustruktur. --- doc/LaTeX/user/0000-chapter.tex | 80 ------------------- doc/LaTeX/user/0001-chapter.tex | 160 ------------------------------------- doc/LaTeX/user/0100-pvs-steuer.tex | 144 +++++++++++++++++++++++++++++++++ doc/LaTeX/user/0300-pvs-client.tex | 80 +++++++++++++++++++ 4 files changed, 224 insertions(+), 240 deletions(-) delete mode 100644 doc/LaTeX/user/0001-chapter.tex create mode 100644 doc/LaTeX/user/0100-pvs-steuer.tex create mode 100644 doc/LaTeX/user/0300-pvs-client.tex diff --git a/doc/LaTeX/user/0000-chapter.tex b/doc/LaTeX/user/0000-chapter.tex index bf080d3..e69de29 100644 --- a/doc/LaTeX/user/0000-chapter.tex +++ b/doc/LaTeX/user/0000-chapter.tex @@ -1,80 +0,0 @@ -\chapter{PVS-Client} -Eine der Anforderungen an die Software ist, dass sie den Benutzer nicht an der Arbeit hindert und im Hintergrund laufen soll. Dies wurde mit Hilfe einer Applikation realisiert, die nur aus einer Toolbar besteht und bei Nichtgebrauch automatisch ausgeblendet wird. Falls der aktuelle Windowmanager dies unterstützt, wird zusätzlich ein Symbol (schwarze Kamera) im Systemabschnitt der Taskleiste (System Tray) abgelegt. In diesem Fall, werden dem Benutzer bei diversen Ereignissen Meldungen über sogenannte "`Sprechblasen"' angezeigt. Wenn der Windowmanager keinen Systemabschnitt besitzt, werden diese Meldungen über konventionelle Dialoge präsentiert. Des Weiteren informiert das Symbol über den Verbindungsstatus. Im Falle einer erfolgreichen Verbindung zu einer Steuerkonsole, wechselt die kleine Lampe von rot auf grün.\\ -Eine weitere Anforderung ist der ständige Zugriff auf die Benutzerschnittstelle damit zu jeder Zeit Einstellungen vorgenommen werden können. Dies wird ebenfalls gewährleistet wenn ein Video oder eine virtuelle Maschine im Vollbildmodus dargestellt wird. Des Weiteren kann die Toolbar entweder am oberen oder unteren Bildschirmrand an einer variablen waagerechten Position angeordnet werden. Dies ist deshalb wichtig, da diverse Windowmanager ihre eigenen Toolbars an unterschiedlichen Orten platzieren.\\ -Die Toolbar des PVS-Clients (Abb. \ref{png:toolbar}) besteht aus einer Reihe von Bedienelementen, die nachfolgend erklärt werden: -\begin{enumerate} - \item Die wichtigste Schaltfläche der Toolbar -- ein Klick auf diese öffnet das Hauptmenü. Das Menü bietet Zugang zu allen Funktionen die dem Benutzer zur Verfügung stehen. Zusätzlich ist dieses Menü über einen Rechtsklick auf das Symbol im Systemabschnitt der Taskleiste (System Tray) abrufbar. - \item Die Schaltfläche links neben der Beschriftung "`Host"' erlaubt eine schnelle Wahl der Steuerkonsole. Durch einen Klick auf diese öffnet sich ein Menü mit einer Auswahl der verfügbaren Server. Durch einen weiteren Klick auf einen der angezeigten Namen kann nach der Eingabe eines Passwortes zu der gewählten Steuerkonsole verbunden werden. Falls kein Passwort benötigt wird, kann das Feld leer bleiben.\\ - Die Beschriftung dieser Schaltfläche wird nach einer erfolgreichen Verbindung an den Namen der Steuerkonsole angepasst, wobei ein "`-"' signalisiert, dass keine Verbindung besteht. Die Liste möglicher Server wird zur Laufzeit automatisch aktualisiert. - \item Diese Checkbox erlaubt es dem Benutzer zu bestimmen ob die verbundene Steuerkonsole das Recht hat eine VNC-Verbindung zum Client aufzubauen. Falls aktiviert, kann der Benutzer der die Steuerkonsole gestartet hat das Verhalten des Benutzers am Client beobachten und bei Bedarf dessen Bild im Netzwerk verteilen. -\end{enumerate} -\begin{figure}[h] - \begin{center} - \includegraphics[scale=0.7]{bilder/clientToolbar} - \caption{Toolbar des PVS-Clients} - \label{png:toolbar} - \end{center} -\end{figure} -Das Hauptmenü des PVS-Clients besteht aus folgenden Elementen: -\begin{itemize} - \item Connect: Zu einer Steuerkonsole verbinden. Der Vorgang ist dabei analog zur Schnellwahl in der Toolbar. - \item Disconnect: Eine bestehende Verbindung trennen. - \item Information: Zeigt in einem Dialog den Namen der aktuell verbundenen Steuerkonsole sowie das zugehörige Passwort. Diese Funktion ist für Dozenten nützlich, um beispielsweise über einen angeschlossenen Projektor die Daten für alle Clients bekannt zu geben. - \item Chat: Öffnet den Chat-Dialog. - \item Send File: Ermöglicht das Senden einer Datei an einen oder alle Teilnehmer. - \item Config: Öffnet den Konfigurationsdialog. - \item About: Zeigt Versionsinformationen an. - \item Quit: Beendet die Applikation sowie das zugehörige Backend. -\end{itemize} - -\section{Chat} -Abbildung \ref{png:chat} zeigt das Chatfenster des PVS-Clients. Mit diesem ist es möglich mit anderen Teilnehmern gemeinsam zu kommunizieren oder private Gespräche zwischen zwei Teilnehmern zu führen. -\begin{enumerate} - \item Dies ist eine Liste aller aktuell am Chat teilnehmenden Benutzer. Ein Doppelklick auf einen Namen ermöglicht ein privates Gespräch, mit einem Rechtsklick kann dem gewählten Benutzer eine Datei geschickt werden. - \item Das Hauptfenster des Dialogs zeigt den aktuellen Gesprächsverlauf an. Dabei wird jeder Nachricht die Uhrzeit sowie der Name des Absenders hinzugefügt. Hier erscheinen ebenfalls diverse Ereignisse, wie der Beitritt eines neuen Benutzers oder der Wechsel des Verbindungsstatus. - \item Durch diese Reiter kann das aktuelle Hauptfenster und somit der Gesprächspartner gewechselt werden. Private Unterhaltungen können durch das kleine "`x"' geschlossen werden. Bei neuen, also noch nicht gelesenen Nachrichten, erscheint eine grüne Lampe. - \item Hier wird die eigene Nachricht eingegeben. - \item Ein Klick auf "`Send"' verschickt die eingegebene Nachricht entweder an den öffentlichen Kanal oder bei einer privaten Unterhaltung direkt an den Kommunikationspartner. Der Empfänger ist dabei stets derjenige dessen Gesprächsverlauf im Hauptfenster angezeigt wird. Es ist auch möglich nach der Eingabe einer Nachricht zum Abschicken die Enter-Taste zu betätigen. -\end{enumerate} -Das Chatfenster unterstützt ebenfalls "`Drag \& Drop"'. Das Ablegen einer Datei innerhalb des Fensters bewirkt eine Anfrage beim aktuellen Gesprächspartner zur Dateiübertragung.\\ -Sollte eine Nachricht eingegangen sein obwohl der Chat-Dialog geschlossen ist, so wird dies dem Benutzer über eine "`Sprechblase"' im Systemabschnitt der Taskleiste mitgeteilt. -\begin{figure}[h] - \begin{center} - \includegraphics[scale=0.5]{bilder/clientChatDialog} - \caption{Chat-Dialog des PVS-Clients} - \label{png:chat} - \end{center} -\end{figure} - -\section{Konfiguration} -Der Konfigurationsdialog (Abb. \ref{png:config}) erlaubt es dem Benutzer des PVS-Clients diverse Einstellungen vornehmen: -\begin{enumerate} - \item Mit diesen Reitern kann die Gruppe der zur Verfügung stehenden Optionen gewechselt werden. Unter "`Permissions"' sind Einstellungen zu finden mit denen der Benutzer seine Privatsphäre schützen kann. Unter "`Display"' ist es möglich das Verhalten der Toolbar anzupassen (z.B. die Position selbiger). - \item Hier wird dem Dozenten das Recht erteilt eine VNC-Verbindung aufbauen zu können. - Durch Auswahl der Option ,,View only'' wird das Ansehen des Bildschirminhalts erlaubt. - Die Wahl ,,Full access'' erlaubt die Fernsteuerung von der Steuerkonsole aus. - \item Hier wird allen anderen Benutzern das Recht erteilt eine VNC-Verbindung aufbauen zu können (z.Z ohne Funktion). - \item Durch diese zwei Checkboxen kann die Teilnahme am Chat oder das Akzeptieren von Dateiübertragungen aktiviert werden (z.Z ohne Funktion). -\end{enumerate} -\begin{figure}[h] - \begin{center} - \includegraphics[scale=0.7]{bilder/clientConfigDialog} - \caption{Konfigurationsdialog des PVS-Clients} - \label{png:config} - \end{center} -\end{figure} - -\section{Dateiversand} -Durch anklicken des Menüeintrags ,,Send File'' kann eine Datei versendet werden. -Nach der Auswahl des Menüeintrags erscheint ein Dialogfenster, in dem entweder ein Empfänger -ausgewählt werden (in diesem Fall erhält nur dieser Empfänger die Datei) -oder die Checkbox ,,Send to all'' aktiviert werden kann (dann wird die Datei an alle -angeschlossenen Rechner verschickt). - -Falls die Datei an alle verschickt wird, ist eine kurze Wartezeit vor Beginn des Versands und -nach dem (scheinbaren) Ende des Versands notwendig. -Es ist nicht sinnvoll, den Versand abzubrechen, wenn die Datei bereits vollständig verschickt -wurde und anscheinend nichts mehr passiert, da einzelne Clients eventuell noch verlorengegangene -Stücke der Datei nachfordern müssen. -Das Versandfenster schließt sich automatisch, wenn alle Clients die Datei vollständig -empfangen haben. diff --git a/doc/LaTeX/user/0001-chapter.tex b/doc/LaTeX/user/0001-chapter.tex deleted file mode 100644 index 3e1c42d..0000000 --- a/doc/LaTeX/user/0001-chapter.tex +++ /dev/null @@ -1,160 +0,0 @@ -\chapter{PVS-Steuerkonsole} -Die PVS-Steuerkonsole auch PVS-Manager genannt, wurde so benutzerfreundlich aufgebaut, dass die wichtigsten Funktionen durch einen Mouseklick -entfernt werden. wir wollen in diesem Teil die unterschiedlichen Funktionen, die von der PVS-Steuerkonsole aus angeboten werden, vorstellen. -\section{Allgemein} -Die Abbildung \ref{fig:pvsmgra} zeigt den PVS-Manager in seinem Gesamtbild. Ganz links steht die Liste der verbundenen Clients und -rechts befinden sich die entsprechenden VNC-Frames. - -\begin{figure}[h] - \centering - \includegraphics[width=0.80\textwidth]{bilder/pvsmgrAll.jpg} - \caption{Die PVS-Steuerkonsole} - \label{fig:pvsmgra} -\end{figure} - -\subsection{Die Client-Liste} -\label{clientliste} -Die angezeigten Clients in dieser Liste haben mit dem Server eine erfolgreiche Verbindung aufbauen können. Mit dem entsprechenden -Tastenkürzel wie es im \ref{Taste} aufgelistet wird, kann man die Clients in unterschiedlichen Bezeichnung anzeigen lassen. Beim Rechtsklick -auf die einzelnen Clients sind folgenden Aktionen möglich:\\ -\textbf{Lock Client(s)}: Damit werden die selektierten Clients gesperrt und dabei werden der Superclient und ein möglicher auf den Superclient -projektierten Client ausgeschloßen. \\ -\textbf{Unlock Client(s)}: Die gesperrten Clients werden wieder entsperrt. \\ -\textbf{MsgLock Client(s)}: Idem wie beim \textit{Lock Client(s)} aber hier bekommt der Client vor der Sperrung eine Nachricht vom pvsmgr.\\ -\textbf{MsgLock All Client(s)}: Ein \textit{MsgLock Client(s)} für alle Clients.\\ -\textbf{Message Clients}: Nachricht an den selektierten Clients schicken.\\ -\textbf{Projection}: Es wird benutzt, um den VNC-Frame eines Clients zu einem anderen zu verschicken. Die Ausführung der Projektion verlangt, dass nur -einen einzigen Client selektiert wird. Der selektierte Client ist die Quelle der Projektion. Die Ziele der Projektion werden über ein Popup-Fenster -ausgewählt. Es wird auch möglich einen Client in einem schon existierenden Projektion mit einbeziehen zu lassen. Es ist natürlich nicht möglich -ein Client gleichzeitig als Quelle und Ziel einer Projetion zu haben.\\ -\textbf{Unprojektion}: Wird ausgewählt um eine existierende Projektion zu beenden. Ausgeführt auf eine Quelle (source-projection) -einer Projektion werden alle betroffenen Clients (target-projection) wieder freigegeben. Die Quelle wird dann im Anschluß auch freigegeben.\\ - -\subsection{Die VNC-Frames} -Die VNC-Frames werden im ConnectionWindow angezeigt. Für den jeweiligen verbundenen Client wird ein kleines Fenster mit änderbarer Größe bereitgestellt. -Die verfügbaren Aktionen per Rechtsklick auf die vorhandenen VNC-Frames sind ähnlich wie im \ref{clientliste} beschrieben wurde. Im ConnectionWindow kann man -zwei Arten von Frames unterscheiden. Die Abbildung \ref{fig:pvsdummy} zeigt einen \textit{Dummy-} und einen \textit{Nicht Dummy-Frame}.\\ -\\ -\textbf{Dummy-Frame}: Ein \textit{Dummy-Frame} lässt sich mit einem schwarzen Punkt rechts unten unterscheiden. Ein \textit{Dummy-Frame} ist eine Art Template -oder besser ein Platzhalter für den eigentlichen VNC-Frame. Man kann sie erzeugen oder löschen. Die -Erzeugung erfolgt durch einen Rechtsmouseklick auf dem ConnectionWindow und das Löschen durch den Rechtsklick auf dem -betroffenen Client. Die \textit{dummy-Clients} werden meistens zur Definition von Profilen erzeugt. Sie werden also erzeugt und je nach -Wunsch angeordnet und unter dem Menü \textit{Profile manager} wird ein Dialog gestartet, in dem man das Profil nach dem Klick auf dem Knopf \textit{new} -unter den gewunschten Name speichern kann. Ausserdem unter dem Menü \textit{Load profil} kann man ein existierendes Profil laden.\\ -\begin{figure}[h] - \centering - \includegraphics[width=0.80\textwidth]{bilder/dum.jpg} - \caption{Dummy und Nicht Dummy Frames} - \label{fig:pvsdummy} -\end{figure} \\ -\textbf{Nicht dummy-Frame}: Nach dem ein Client mit dem pvsmgr eine Verbindung erfolgreich aufgebaut hat, wird er im ConnectionWindow als ein -richtiger VNC-Frame angezeigt. Der \textit{Nicht dummy-Frame} hat einen grünen Punkt an seine rechte Ecke. Der Manager kann also diese Frame manipulieren. -Dem Dozent steht dafür mehrere Funktionen zur Verfügung. Wir werden aber hier -nur die wichtigsten erläutern, denn die anderen lassen sich ganz trivial auf dem Gui nachvollziehen. Also auf ein VNC-Frame kann per Rechtsmouseklick die -im \ref{clientliste} definerten Aktionen angewandt werden. Die VNC-Qualität und die Größe der Frames können geändert werden, um den CPU-Last zu minimieren. -Auf dem Bild \ref{fig:pvsdummy} kann man verbundene Clients (\textit{Nicht dummy-Frame}) und nicht verbundene Clients (\textit{Dummy-Frame}) ansehen . Der Titel des Fensters ist der Benutzername des Clients und unter dem Frame -befindet sich die korrespondierte IP-Adresse. Der grüne Punkt ganz rechts im Gegenteil zum dummy-Frame zeigt, dass der Client gerade Online ist.\\ -Für die Verbundene Clients besteht die Möglichkeit die VNC-Quality (HIGH, MEDIUM oder LOW) jeder Zeit einzustellen. Mit \textit{Set Password} kann der Manager ganz bequem -festlegen, ob die Clients zur Verbindung mit dem pvsmgr ein von System generiertes Passwort eingeben müssen oder nicht. Auf dem Toolbar werden weitere Funktionen wie: -Screeshots aufnehmen, Chat mit dem einzelnen Client starten, ferngesteuert auf den markierten Clients Prozesse starten, eine Prozessliste zu öffnen in der die Prozesse sämtlicher verbundenen Clients angezeigt werden oder alle Clients auf einem Klick zu blockieren. Das Blockieren der Clients schließt natürlich der Dozent-Rechner -aus. Der Dozent-Rechner hebt sich von einem anderer verbundenen Machine durch den Rot-Blau Zeichnen neben dem grünen Punkt hervor. -\\ -Befindet sich die Maus über einem VNC-Frame, so ist über dem Bildschirminhalt eine Reihe von -Buttons zu sehen (Siehe Abbildung \ref{png:buttons}). -\begin{figure}[h] - \centering - \includegraphics[scale=1]{bilder/vnc-frame-buttons.png} - \caption{Buttons} - \label{png:buttons} -\end{figure} -Diese erlauben die Ausfürung der folgenden Funktionen: -\begin{enumerate} - \item Anzeige maximieren - \item Bildschirmfoto - \item Bildschirm für den Benutzer sperren - \item Client zum ,,Super-Client'' machen - \item Fernsteuerung aktivieren - \item Fernsteuerung aller Clients -\end{enumerate} -Wird der Button für die Aktivierung der Fernsteuerung gedrückt, werden alle Tastatur- und Mauseingaben, -die getätigt werden, während sich der Mauszeiger über dem Anzeigebereich des VNC-Frames befindet, -an den betreffenden Client gesendet. -So ist es möglich, die Steuerung von Tastatur und Maus eines angeschlossenen Rechners zu übernehmen. -\\ -Davon sind auch Tastenkombinationen wie Alt+Tabulator betroffen. -Um solche Kombinationen am Rechner der Steuerkonsole einzugeben, muss der Mauszeiger von der -Anzeigefläche wegbewegt werden. -\\ -Weiterhin ist auch die Simulation von System-Tastenkombinationen möglich: -Hierzu muss 5 Sekunden lang die Menü-Taste - \includegraphics[height=1.6ex]{bilder/menu-key.png} -gedrückt werden; -es erscheint dann ein Menü, aus dem die gewünschte Aktion ausgewählt werden kann. -{\em Vorsicht:} Die Steuerkonsole fragt vor der Ausführung einer Aktion nicht noch einmal -nach. -\\ \\ -\subsection{Remote Prozesse starten} -\label{Prozesse starten} -Über den Button aus der Abbildung \ref{png:Prozessestarten} kann der Dialog um Prozesse ferngesteuert zu starten geöffnet werden. Es muss mindestens ein Client ausgewählt werden, auf dem der eingegebene Prozess gestartet werden soll. Der Dialog (Abbildung \ref{png:Prozessestarten}) bietet folgende Funktionen:\\ -\begin{enumerate} - \item Diese Liste bietet den Dozenten die Möglichkeit sich bestimmte Prozesse abzuspeichern und bequem aufzurufen. Prozesse werden grundsätzlich nur mit Beschreibung abgespeichert, fehlt entweder die Beschreibung oder der Prozess selbst wird der Eintrag nichtmehr gespeichert.\\ - Ein Klick auf die Liste fügt den ausgewählten Prozess in das Textfeld ein. Mit Doppelklick auf ein Feld der Liste kann dieses Element editiert werden, so sind sowohl die Beschreibung, als auch der Prozess editierbar. Um einen Eintrag zu löschen reicht es dessen Prozess oder Beschreibung zu entfernen und mit einem Klick auf Speichern zu übernehmen. Der Speichern-Button fügt automatisch eine leere Zeile an das Ende der Liste an, um weitere Priozesse abspeichern zu können. - \item Prozesse die in diesem Textfeld eingetragen sind werden mit einem Klick auf Start nach einer erneuten Abfrage auf dem Client gestartet, Änderungen an der Liste werden dabei gespeichert, der Dialog geschlossen. Ein Klick auf Abbrechen schließt den Dialog ohne die Prozessliste erneut zu speichern und ohne den Prozess zu starten. -\end{enumerate} -Schlägt das ferngesteuerte Starten fehl wird dies in den Logdateien angezeigt. -\begin{figure}[h] - \centering - \includegraphics[scale=0.6]{bilder/runprocess.png} - \caption{Dialog um Prozesse ferngesteuert zu starten und zugehöriger Button links} - \label{png:Prozessestarten} -\end{figure} - -\subsection{Remote Prozessliste anzeigen} -\label{Prozessliste} -Hier ein Überblick über die Prozessliste (Siehe Abbildung \ref{png:Prozessliste}). Die Prozessliste kann über die Toolbar in der PVS Steuerkonsole über den Button aus der Abbildung \ref{png:Prozessliste} angezeigt werden. -\begin{enumerate} - \item Anzeige der Tabs - hier wird für jeden verbundenen Client ein neuer Reiter erstellt, ein Klick auf den Reiter aktiviert die Anzeige für diesen Client. Die Prozessliste wird daraufhin aktualisiert. - \item Prozessliste - Hier werden die Prozesse des gewählten Clients angezeigt, in den Spalten stehen die ProzessID, der Name und die Commandline. Die Prozessliste wird alle 5 Sekunden aktualisiert, ausser es ist mindestens eine Zeile markiert. Es können mehrere Zeilen markiert werden, sie müssen nicht zusammenhängen. - \item Buttons Refresh und Stop process - mit Refresh wird die Liste aktualisiert, unabhängig davon, ob Zeilen markiert wurden. Ein Klick auf Stop process beendet die markierten Prozesse nach einer erneuten Abfrage. - \item Start Process - Ein eingegebener Prozess wird auf dem aktuellen Client gestartet. -\end{enumerate} -Mit einem Klick auf Close werden die Prozesslisten geschlossen. -\begin{figure}[h] - \centering - \includegraphics[scale=0.5]{bilder/processlist.png} - \caption{Prozessliste und zugehöriger Button links} - \label{png:Prozessliste} -\end{figure} -\\ - - - - -Im letzten Punkt dieses Abschnitts wollen wir die vorhandenen Tastenkürzel vorstellen. -\subsection{Tastenkürzel für PVS-Server} -\label{Taste} -Einige schlaue Tastenkombinationen sollen die Ausnutzung der PVS-Konsole erleichten. -Wir werden z.B für einige Funktionen, die in der Popup-Menü zur Verfügung gestellten sind, den Aufruf durch -Tastenkombination ermöglichen.\\ - -Wichtig ist, eine Rückkopplung mit den Anwendern vorzunehmen (Rückmeldung, was die Dozenten denken und welche Funktionen sie für sinnvoll erachten, was sie sich wünschen ...)\\ - -Hier folgt eine Liste von den bisherigen eingebauten Tastenkombinationen:\\ -\textit{Alt+F}: Anzeige des Menüs unter "File" \\ -\textit{Alt+C}: Anzeige des Menüs unter "Clients" \\ -\textit{Alt+L}: Anzeige des Menüs unter "Logging" \\ -\textit{Alt+H}: Anzeige des Menüs unter "Help" \\ -\textit{Ctrl+M}: Anzeige des Profilmanager-Dialogs \\ -\textit{Ctrl+Q}: Die Anwendung verlassen (Exit) \\ -\textit{Ctrl+1}: Name in Client-Liste anzeigen lassen \\ -\textit{Ctrl+2}: IP in Client-Liste anzeigen lassen \\ -\textit{Ctrl+3}: Username in Client-Liste anzeigen lassen \\ -\textit{Ctrl+L}: Log anzeigen lassen \\ -\textit{Ctrl+O}: Normal Log anzeigen lassen \\ -\textit{Ctrl+R}: Error Log anzeigen lassen \\ -\textit{Ctrl+N}: Network Log anzeigen lassen \\ -\textit{Ctrl+T}: Terminal Log anzeigen lassen \\ -\textit{Ctrl+D}: Chat Log anzeigen lassen \\ -\textit{Ctrl+F}: Screenshort der ausgewählten Clients machen \\ -\textit{Ctrl+V}: Ausgewählter Client in voller Auflösung anzeigen lassen \\ -\textit{Ctrl+A}: Alle Clients Un- bzw. Lock \\ diff --git a/doc/LaTeX/user/0100-pvs-steuer.tex b/doc/LaTeX/user/0100-pvs-steuer.tex new file mode 100644 index 0000000..ca18a2e --- /dev/null +++ b/doc/LaTeX/user/0100-pvs-steuer.tex @@ -0,0 +1,144 @@ +\chapter{PVS-Steuerkonsole} +Die PVS-Steuerkonsole auch PVS-Manager genannt, wurde so aufgebaut, dass die wichtigsten Funktionen durch einen Mausklick erreichbar sind. Dieses Kapitel stelltdie unterschiedlichen Funktionen vor, die von der PVS-Steuerkonsole aus angeboten werden. + +\section{Allgemein} +Die Abbildung \ref{fig:pvsmgra} zeigt den PVS-Manager in seinem Gesamtbild. Ganz links steht die Liste der verbundenen Clients und +rechts befinden sich die entsprechenden VNC-Frames. + +\begin{figure}[h] + \centering + \includegraphics[width=0.80\textwidth]{bilder/pvsmgrAll.jpg} + \caption{Das Hauptfenster der PVS-Steuerkonsole} + \label{fig:pvsmgra} +\end{figure} + +\subsection{Die Client-Liste} +\label{clientliste} +Die angezeigten Clients in dieser Liste haben mit dem Server eine erfolgreiche Verbindung aufbauen können. Mit dem entsprechenden +Tastenkürzel wie es im \ref{Taste} aufgelistet wird, kann man die Clients in unterschiedlichen Bezeichnung anzeigen lassen. Beim Rechtsklick +auf die einzelnen Clients sind folgenden Aktionen möglich:\\ +\textbf{Lock Client(s)}: Damit werden die selektierten Clients gesperrt und dabei werden der Superclient und ein möglicher auf den Superclient +projektierten Client ausgeschloßen. \\ +\textbf{Unlock Client(s)}: Die gesperrten Clients werden wieder entsperrt. \\ +\textbf{MsgLock Client(s)}: Idem wie beim \textit{Lock Client(s)} aber hier bekommt der Client vor der Sperrung eine Nachricht vom pvsmgr.\\ +\textbf{MsgLock All Client(s)}: Ein \textit{MsgLock Client(s)} für alle Clients.\\ +\textbf{Message Clients}: Nachricht an den selektierten Clients schicken.\\ +\textbf{Projection}: Es wird benutzt, um den VNC-Frame eines Clients zu einem anderen zu verschicken. Die Ausführung der Projektion verlangt, dass nur +einen einzigen Client selektiert wird. Der selektierte Client ist die Quelle der Projektion. Die Ziele der Projektion werden über ein Popup-Fenster +ausgewählt. Es wird auch möglich einen Client in einem schon existierenden Projektion mit einbeziehen zu lassen. Es ist natürlich nicht möglich +ein Client gleichzeitig als Quelle und Ziel einer Projetion zu haben.\\ +\textbf{Unprojektion}: Wird ausgewählt um eine existierende Projektion zu beenden. Ausgeführt auf eine Quelle (source-projection) +einer Projektion werden alle betroffenen Clients (target-projection) wieder freigegeben. Die Quelle wird dann im Anschluß auch freigegeben.\\ + +\subsection{Die VNC-Frames} +Die VNC-Frames werden im ConnectionWindow angezeigt. Für den jeweiligen verbundenen Client wird ein kleines Fenster mit änderbarer Größe bereitgestellt. +Die verfügbaren Aktionen per Rechtsklick auf die vorhandenen VNC-Frames sind ähnlich wie im \ref{clientliste} beschrieben wurde. Im ConnectionWindow kann man +zwei Arten von Frames unterscheiden. Die Abbildung \ref{fig:pvsdummy} zeigt einen \textit{Dummy-} und einen \textit{Nicht Dummy-Frame}.\\ +\\ +\textbf{Dummy-Frame}: Ein \textit{Dummy-Frame} lässt sich mit einem schwarzen Punkt rechts unten unterscheiden. Ein \textit{Dummy-Frame} ist eine Art Template +oder besser ein Platzhalter für den eigentlichen VNC-Frame. Man kann sie erzeugen oder löschen. Die +Erzeugung erfolgt durch einen Rechtsmouseklick auf dem ConnectionWindow und das Löschen durch den Rechtsklick auf dem +betroffenen Client. Die \textit{dummy-Clients} werden meistens zur Definition von Profilen erzeugt. Sie werden also erzeugt und je nach +Wunsch angeordnet und unter dem Menü \textit{Profile manager} wird ein Dialog gestartet, in dem man das Profil nach dem Klick auf dem Knopf \textit{new} +unter den gewunschten Name speichern kann. Ausserdem unter dem Menü \textit{Load profil} kann man ein existierendes Profil laden.\\ +\begin{figure}[h] + \centering + \includegraphics[width=0.80\textwidth]{bilder/dum.jpg} + \caption{Dummy und Nicht Dummy Frames} + \label{fig:pvsdummy} +\end{figure} \\ +\textbf{Nicht dummy-Frame}: Nach dem ein Client mit dem pvsmgr eine Verbindung erfolgreich aufgebaut hat, wird er im ConnectionWindow als ein +richtiger VNC-Frame angezeigt. Der \textit{Nicht dummy-Frame} hat einen grünen Punkt an seine rechte Ecke. Der Manager kann also diese Frame manipulieren. +Dem Dozent steht dafür mehrere Funktionen zur Verfügung. Wir werden aber hier +nur die wichtigsten erläutern, denn die anderen lassen sich ganz trivial auf dem Gui nachvollziehen. Also auf ein VNC-Frame kann per Rechtsmouseklick die +im \ref{clientliste} definerten Aktionen angewandt werden. Die VNC-Qualität und die Größe der Frames können geändert werden, um den CPU-Last zu minimieren. +Auf dem Bild \ref{fig:pvsdummy} kann man verbundene Clients (\textit{Nicht dummy-Frame}) und nicht verbundene Clients (\textit{Dummy-Frame}) ansehen . Der Titel des Fensters ist der Benutzername des Clients und unter dem Frame +befindet sich die korrespondierte IP-Adresse. Der grüne Punkt ganz rechts im Gegenteil zum dummy-Frame zeigt, dass der Client gerade Online ist.\\ +Für die Verbundene Clients besteht die Möglichkeit die VNC-Quality (HIGH, MEDIUM oder LOW) jeder Zeit einzustellen. Mit \textit{Set Password} kann der Manager ganz bequem +festlegen, ob die Clients zur Verbindung mit dem pvsmgr ein von System generiertes Passwort eingeben müssen oder nicht. Auf dem Toolbar werden weitere Funktionen wie: +Screeshots aufnehmen, Chat mit dem einzelnen Client starten, ferngesteuert auf den markierten Clients Prozesse starten, eine Prozessliste zu öffnen in der die Prozesse sämtlicher verbundenen Clients angezeigt werden oder alle Clients auf einem Klick zu blockieren. Das Blockieren der Clients schließt natürlich der Dozent-Rechner +aus. Der Dozent-Rechner hebt sich von einem anderer verbundenen Machine durch den Rot-Blau Zeichnen neben dem grünen Punkt hervor. +\\ +Befindet sich die Maus über einem VNC-Frame, so ist über dem Bildschirminhalt eine Reihe von +Buttons zu sehen (Siehe Abbildung \ref{png:buttons}). +\begin{figure}[h] + \centering + \includegraphics[scale=1]{bilder/vnc-frame-buttons.png} + \caption{Buttons} + \label{png:buttons} +\end{figure} +Diese erlauben die Ausfürung der folgenden Funktionen: +\begin{enumerate} + \item Anzeige maximieren + \item Bildschirmfoto + \item Bildschirm für den Benutzer sperren + \item Client zum ,,Super-Client'' machen + \item Fernsteuerung aktivieren + \item Fernsteuerung aller Clients +\end{enumerate} +Wird der Button für die Aktivierung der Fernsteuerung gedrückt, werden alle Tastatur- und Mauseingaben, +die getätigt werden, während sich der Mauszeiger über dem Anzeigebereich des VNC-Frames befindet, +an den betreffenden Client gesendet. +So ist es möglich, die Steuerung von Tastatur und Maus eines angeschlossenen Rechners zu übernehmen. +\\ +Davon sind auch Tastenkombinationen wie Alt+Tabulator betroffen. +Um solche Kombinationen am Rechner der Steuerkonsole einzugeben, muss der Mauszeiger von der +Anzeigefläche wegbewegt werden. +\\ +Weiterhin ist auch die Simulation von System-Tastenkombinationen möglich: +Hierzu muss 5 Sekunden lang die Menü-Taste + \includegraphics[height=1.6ex]{bilder/menu-key.png} +gedrückt werden; +es erscheint dann ein Menü, aus dem die gewünschte Aktion ausgewählt werden kann. +{\em Vorsicht:} Die Steuerkonsole fragt vor der Ausführung einer Aktion nicht noch einmal +nach. +\\ \\ +\subsection{Prozessliste anzeigen} +\label{Prozessliste} +Hier ein Überblick über die Prozessliste (Siehe Abbildung \ref{png:Prozessliste}).\\ +\begin{enumerate} + \item Anzeige der Tabs - hier wird für jeden Client ein neuer Reiter erstellt, ein Klick auf den Reiter aktiviert die Anzeige für diesen Client. Die Prozessliste wird daraufhin aktualisiert. + \item Prozessliste - Hier werden die Prozesse des gewählten Clients angezeigt, in den Spalten stehen die ProzessID, der Name und die Commandline. Die Prozessliste wird alle 5 Sekunden aktualisiert, ausser es ist mindestens eine Zeile markiert. Es können mehrere Zeilen markiert werden, sie müssen nicht zusammenhängen. + \item Buttons Refresh und Stop process - mit Refresh wird die Liste aktualisiert, unabhängig davon, ob Zeilen markiert wurden. Ein Klick auf Stop process beendet die markierten Prozesse nach einer erneuten Abfrage. + \item Start Process - Ein eingegebener Prozess wird auf dem aktuellen Client gestartet. +\end{enumerate} +Mit einem Klick auf Close werden die Prozesslisten geschlossen. +\begin{figure}[h] + \centering + \includegraphics[scale=0.5]{bilder/processlist.png} + \caption{Prozessliste} + \label{png:Prozessliste} +\end{figure} +\\ + + + + +Im letzten Punkt dieses Abschnitts wollen wir die vorhandenen Tastenkürzel vorstellen. +\subsection{Tastenkürzel für PVS-Server} +\label{Taste} +Einige schlaue Tastenkombinationen sollen die Ausnutzung der PVS-Konsole erleichten. +Wir werden z.B für einige Funktionen, die in der Popup-Menü zur Verfügung gestellten sind, den Aufruf durch +Tastenkombination ermöglichen.\\ + +Wichtig ist, eine Rückkopplung mit den Anwendern vorzunehmen (Rückmeldung, was die Dozenten denken und welche Funktionen sie für sinnvoll erachten, was sie sich wünschen ...)\\ + +Hier folgt eine Liste von den bisherigen eingebauten Tastenkombinationen:\\ +\textit{Alt+F}: Anzeige des Menüs unter "File" \\ +\textit{Alt+C}: Anzeige des Menüs unter "Clients" \\ +\textit{Alt+L}: Anzeige des Menüs unter "Logging" \\ +\textit{Alt+H}: Anzeige des Menüs unter "Help" \\ +\textit{Ctrl+M}: Anzeige des Profilmanager-Dialogs \\ +\textit{Ctrl+Q}: Die Anwendung verlassen (Exit) \\ +\textit{Ctrl+1}: Name in Client-Liste anzeigen lassen \\ +\textit{Ctrl+2}: IP in Client-Liste anzeigen lassen \\ +\textit{Ctrl+3}: Username in Client-Liste anzeigen lassen \\ +\textit{Ctrl+L}: Log anzeigen lassen \\ +\textit{Ctrl+O}: Normal Log anzeigen lassen \\ +\textit{Ctrl+R}: Error Log anzeigen lassen \\ +\textit{Ctrl+N}: Network Log anzeigen lassen \\ +\textit{Ctrl+T}: Terminal Log anzeigen lassen \\ +\textit{Ctrl+D}: Chat Log anzeigen lassen \\ +\textit{Ctrl+F}: Screenshort der ausgewählten Clients machen \\ +\textit{Ctrl+V}: Ausgewählter Client in voller Auflösung anzeigen lassen \\ +\textit{Ctrl+A}: Alle Clients Un- bzw. Lock \\ diff --git a/doc/LaTeX/user/0300-pvs-client.tex b/doc/LaTeX/user/0300-pvs-client.tex new file mode 100644 index 0000000..bf080d3 --- /dev/null +++ b/doc/LaTeX/user/0300-pvs-client.tex @@ -0,0 +1,80 @@ +\chapter{PVS-Client} +Eine der Anforderungen an die Software ist, dass sie den Benutzer nicht an der Arbeit hindert und im Hintergrund laufen soll. Dies wurde mit Hilfe einer Applikation realisiert, die nur aus einer Toolbar besteht und bei Nichtgebrauch automatisch ausgeblendet wird. Falls der aktuelle Windowmanager dies unterstützt, wird zusätzlich ein Symbol (schwarze Kamera) im Systemabschnitt der Taskleiste (System Tray) abgelegt. In diesem Fall, werden dem Benutzer bei diversen Ereignissen Meldungen über sogenannte "`Sprechblasen"' angezeigt. Wenn der Windowmanager keinen Systemabschnitt besitzt, werden diese Meldungen über konventionelle Dialoge präsentiert. Des Weiteren informiert das Symbol über den Verbindungsstatus. Im Falle einer erfolgreichen Verbindung zu einer Steuerkonsole, wechselt die kleine Lampe von rot auf grün.\\ +Eine weitere Anforderung ist der ständige Zugriff auf die Benutzerschnittstelle damit zu jeder Zeit Einstellungen vorgenommen werden können. Dies wird ebenfalls gewährleistet wenn ein Video oder eine virtuelle Maschine im Vollbildmodus dargestellt wird. Des Weiteren kann die Toolbar entweder am oberen oder unteren Bildschirmrand an einer variablen waagerechten Position angeordnet werden. Dies ist deshalb wichtig, da diverse Windowmanager ihre eigenen Toolbars an unterschiedlichen Orten platzieren.\\ +Die Toolbar des PVS-Clients (Abb. \ref{png:toolbar}) besteht aus einer Reihe von Bedienelementen, die nachfolgend erklärt werden: +\begin{enumerate} + \item Die wichtigste Schaltfläche der Toolbar -- ein Klick auf diese öffnet das Hauptmenü. Das Menü bietet Zugang zu allen Funktionen die dem Benutzer zur Verfügung stehen. Zusätzlich ist dieses Menü über einen Rechtsklick auf das Symbol im Systemabschnitt der Taskleiste (System Tray) abrufbar. + \item Die Schaltfläche links neben der Beschriftung "`Host"' erlaubt eine schnelle Wahl der Steuerkonsole. Durch einen Klick auf diese öffnet sich ein Menü mit einer Auswahl der verfügbaren Server. Durch einen weiteren Klick auf einen der angezeigten Namen kann nach der Eingabe eines Passwortes zu der gewählten Steuerkonsole verbunden werden. Falls kein Passwort benötigt wird, kann das Feld leer bleiben.\\ + Die Beschriftung dieser Schaltfläche wird nach einer erfolgreichen Verbindung an den Namen der Steuerkonsole angepasst, wobei ein "`-"' signalisiert, dass keine Verbindung besteht. Die Liste möglicher Server wird zur Laufzeit automatisch aktualisiert. + \item Diese Checkbox erlaubt es dem Benutzer zu bestimmen ob die verbundene Steuerkonsole das Recht hat eine VNC-Verbindung zum Client aufzubauen. Falls aktiviert, kann der Benutzer der die Steuerkonsole gestartet hat das Verhalten des Benutzers am Client beobachten und bei Bedarf dessen Bild im Netzwerk verteilen. +\end{enumerate} +\begin{figure}[h] + \begin{center} + \includegraphics[scale=0.7]{bilder/clientToolbar} + \caption{Toolbar des PVS-Clients} + \label{png:toolbar} + \end{center} +\end{figure} +Das Hauptmenü des PVS-Clients besteht aus folgenden Elementen: +\begin{itemize} + \item Connect: Zu einer Steuerkonsole verbinden. Der Vorgang ist dabei analog zur Schnellwahl in der Toolbar. + \item Disconnect: Eine bestehende Verbindung trennen. + \item Information: Zeigt in einem Dialog den Namen der aktuell verbundenen Steuerkonsole sowie das zugehörige Passwort. Diese Funktion ist für Dozenten nützlich, um beispielsweise über einen angeschlossenen Projektor die Daten für alle Clients bekannt zu geben. + \item Chat: Öffnet den Chat-Dialog. + \item Send File: Ermöglicht das Senden einer Datei an einen oder alle Teilnehmer. + \item Config: Öffnet den Konfigurationsdialog. + \item About: Zeigt Versionsinformationen an. + \item Quit: Beendet die Applikation sowie das zugehörige Backend. +\end{itemize} + +\section{Chat} +Abbildung \ref{png:chat} zeigt das Chatfenster des PVS-Clients. Mit diesem ist es möglich mit anderen Teilnehmern gemeinsam zu kommunizieren oder private Gespräche zwischen zwei Teilnehmern zu führen. +\begin{enumerate} + \item Dies ist eine Liste aller aktuell am Chat teilnehmenden Benutzer. Ein Doppelklick auf einen Namen ermöglicht ein privates Gespräch, mit einem Rechtsklick kann dem gewählten Benutzer eine Datei geschickt werden. + \item Das Hauptfenster des Dialogs zeigt den aktuellen Gesprächsverlauf an. Dabei wird jeder Nachricht die Uhrzeit sowie der Name des Absenders hinzugefügt. Hier erscheinen ebenfalls diverse Ereignisse, wie der Beitritt eines neuen Benutzers oder der Wechsel des Verbindungsstatus. + \item Durch diese Reiter kann das aktuelle Hauptfenster und somit der Gesprächspartner gewechselt werden. Private Unterhaltungen können durch das kleine "`x"' geschlossen werden. Bei neuen, also noch nicht gelesenen Nachrichten, erscheint eine grüne Lampe. + \item Hier wird die eigene Nachricht eingegeben. + \item Ein Klick auf "`Send"' verschickt die eingegebene Nachricht entweder an den öffentlichen Kanal oder bei einer privaten Unterhaltung direkt an den Kommunikationspartner. Der Empfänger ist dabei stets derjenige dessen Gesprächsverlauf im Hauptfenster angezeigt wird. Es ist auch möglich nach der Eingabe einer Nachricht zum Abschicken die Enter-Taste zu betätigen. +\end{enumerate} +Das Chatfenster unterstützt ebenfalls "`Drag \& Drop"'. Das Ablegen einer Datei innerhalb des Fensters bewirkt eine Anfrage beim aktuellen Gesprächspartner zur Dateiübertragung.\\ +Sollte eine Nachricht eingegangen sein obwohl der Chat-Dialog geschlossen ist, so wird dies dem Benutzer über eine "`Sprechblase"' im Systemabschnitt der Taskleiste mitgeteilt. +\begin{figure}[h] + \begin{center} + \includegraphics[scale=0.5]{bilder/clientChatDialog} + \caption{Chat-Dialog des PVS-Clients} + \label{png:chat} + \end{center} +\end{figure} + +\section{Konfiguration} +Der Konfigurationsdialog (Abb. \ref{png:config}) erlaubt es dem Benutzer des PVS-Clients diverse Einstellungen vornehmen: +\begin{enumerate} + \item Mit diesen Reitern kann die Gruppe der zur Verfügung stehenden Optionen gewechselt werden. Unter "`Permissions"' sind Einstellungen zu finden mit denen der Benutzer seine Privatsphäre schützen kann. Unter "`Display"' ist es möglich das Verhalten der Toolbar anzupassen (z.B. die Position selbiger). + \item Hier wird dem Dozenten das Recht erteilt eine VNC-Verbindung aufbauen zu können. + Durch Auswahl der Option ,,View only'' wird das Ansehen des Bildschirminhalts erlaubt. + Die Wahl ,,Full access'' erlaubt die Fernsteuerung von der Steuerkonsole aus. + \item Hier wird allen anderen Benutzern das Recht erteilt eine VNC-Verbindung aufbauen zu können (z.Z ohne Funktion). + \item Durch diese zwei Checkboxen kann die Teilnahme am Chat oder das Akzeptieren von Dateiübertragungen aktiviert werden (z.Z ohne Funktion). +\end{enumerate} +\begin{figure}[h] + \begin{center} + \includegraphics[scale=0.7]{bilder/clientConfigDialog} + \caption{Konfigurationsdialog des PVS-Clients} + \label{png:config} + \end{center} +\end{figure} + +\section{Dateiversand} +Durch anklicken des Menüeintrags ,,Send File'' kann eine Datei versendet werden. +Nach der Auswahl des Menüeintrags erscheint ein Dialogfenster, in dem entweder ein Empfänger +ausgewählt werden (in diesem Fall erhält nur dieser Empfänger die Datei) +oder die Checkbox ,,Send to all'' aktiviert werden kann (dann wird die Datei an alle +angeschlossenen Rechner verschickt). + +Falls die Datei an alle verschickt wird, ist eine kurze Wartezeit vor Beginn des Versands und +nach dem (scheinbaren) Ende des Versands notwendig. +Es ist nicht sinnvoll, den Versand abzubrechen, wenn die Datei bereits vollständig verschickt +wurde und anscheinend nichts mehr passiert, da einzelne Clients eventuell noch verlorengegangene +Stücke der Datei nachfordern müssen. +Das Versandfenster schließt sich automatisch, wenn alle Clients die Datei vollständig +empfangen haben. -- cgit v1.2.3-55-g7522