From fe50f98aae09eaf8c360857f9fc8a024409469d9 Mon Sep 17 00:00:00 2001 From: ulrich <not disclosed> Date: Sat, 17 Feb 2018 19:22:03 +0000 Subject: [PATCH] Auf Nutzung mit Docker umgestellt --- web/META-INF/daten/www/dok/wbx/Bilder/dbcon.png | 0 web/META-INF/daten/www/dok/wbx/Bilder/nutzer-neu.png | 0 web/META-INF/daten/www/dok/wbx/Bilder/benutzerverwaltung.png | 0 web/META-INF/daten/www/dok/wbx/Bilder/apps.png | 0 web/META-INF/daten/www/dok/wbx/js-info.htmi | 5 + web/META-INF/daten/www/dok/wbx/Bilder/speichern-unter.png | 0 web/META-INF/daten/www/dok/wbx/Bilder/rollen.png | 0 web/META-INF/daten/www/dok/wbx/App.htmi | 25 +++++ web/META-INF/daten/www/dok/wbx/Bilder/dateiverwaltung.png | 0 web/META-INF/daten/www/dok/wbx/Bilder/startseite.png | 0 web/WEB-INF/web.xml | 2 web/META-INF/daten/www/dok/wbx/Bilder/texteditor.png | 0 web/META-INF/daten/www/dok/wbx/Bilder/verwaltung.png | 0 web/META-INF/daten/www/dok/wbx/Bedienung.htmi | 172 ++++++++++++++++++++++++++++++++++ web/META-INF/daten/www/dok/wbx/Bilder/db_neu.png | 0 web/META-INF/daten/www/dok/wbx/Bilder/dokeditor.png | 0 web/META-INF/daten/www/dok/wbx/Betrieb-Docker.htmi | 27 +++++ web/META-INF/daten/www/dok/wbx/Betrieb.htmi | 34 ++++++ web/META-INF/daten/www/dok/wbx/Installation.htmi | 25 +++++ 19 files changed, 289 insertions(+), 1 deletions(-) diff --git a/web/META-INF/daten/www/dok/wbx/App.htmi b/web/META-INF/daten/www/dok/wbx/App.htmi new file mode 100644 index 0000000..2f7915e --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/App.htmi @@ -0,0 +1,25 @@ +<h1>Apps</h1> +<p>Dieses Dokument beschreibt Programme, die von der <a href="http://uhilger.de/dev/Software/WebBox/WebBox">WebBox</a> ausgeführt werden können, die Apps. Das ist interessant, wenn man selbst Apps erstellen möchte. Anwender, die fertige Apps auf einer WebBox nutzen möchten, müssen hier nicht weiterlesen.</p> +<p>Apps müssen gemäß der <a href="http://www.oracle.com/technetwork/java/javaee/tech/index.html">Java Servlet Spezifikation</a> aufgebaut sein, damit sie von der WebBox ausgeführt werden können. In diesem Dokument wird nicht der gesamte Standard der Java Servlet Spezifikation beschrieben. Es werden hier nur Teile erwähnt, die als Minimalansatz für eine App dienen können.</p> +<p style="padding-left: 30px;"><a href="#run">Laufzeitumgebung und -voraussetzungen</a><br /><a href="#strukt">Aufbau einer App</a></p> +<p style="padding-left: 60px;"><a href="#app-folder">App-Ordner</a><br /><a href="#web-inf-folder">Der Ordner WEB-INF</a><br /><a href="#webxml">Deployment Descriptor</a></p> +<h2><a name="run"></a>Laufzeitumgebung und -voraussetzungen</h2> +<p>Apps laufen auf der Maschine, auf der die WebBox gestartet wurde. Sie werden von der WebBox als Teil des Prozesses ausgeführt, in dem die WebBox läuft.</p> +<p>Prizipiell kann jede App, die die Java Servlet Spezifikation implementiert, auf der WebBox laufen. Einzelheiten zu besonderen Laufzeitvoraussetzungen müssen der Dokumentation der betreffenden App entnommen werden.</p> +<p>Die nachfolgenden Abschnitte beschreiben Aspekte einer App, die mindestens gegeben sein müssen. Diese werden in aller Regel von Apps erfüllt, die der Java Servlet Spezifikation entsprechen. Die Angaben an dieser Stelle richten sich an Nutzer, die selbst Apps für die WebBox herstellen möchten.</p> +<h2><a name="strukt"></a>Aufbau einer App</h2> +<p>Eine App ist eine Sammlung aus Dateien in einem Ordner des Dateisystems, dem App-Ordner. Apps müssen wie folgt aufgebaut sein:</p> +<p style="padding-left: 30px;"><code>/App-Ordner</code><br /><code> /WEB-INF</code><br /><code> web.xml</code><br /><code> /classes</code><br /><code> /lib</code></p> +<p>Der Hersteller einer App kann frei entscheiden, wie Struktur und Inhalt innerhalb dieses Rahmens beschaffen ist. NAchfolgend sind relevante Teile der obigen Struktur beschrieben.</p> +<h3><a name="app-folder"></a>App-Ordner</h3> +<p>Der App-Ordner enthält alle Bestandteile der App, z.B. Webseiten, Konfigurationsdateien, als Programm ausführbare Teile. Was sich nicht im Ordner <code>WEB-INF</code> befindet liefert die WebBox zur Laufzeit der App als Inhalt aus. Liegt im App-Verzeichnis z.B. eine HTML-Datei, wird diese als Webseite ausgeliefert. Ebenso werden Bilddateien ausgegeben.</p> +<p>Die so im App-Ordner vorgefundenen Inhalte erhalten von der WebBox jeweils ihren eigenen Uniform Resource Locator (URL) unter dem sie zugänglich sind. Den URL bildet die WebBox aus dem Ablageort des Inhalts innerhalb des App-Ordners und seinem Dateinamen. Dabei wird der Name des App-Ordners ebenfalls Teil des URL. Befindet sich beispielsweise eine Datei namens <code>Infos.html</code> im Ordner <code>/App-Ordner/meine</code> wird der Inhalt über die WebBox über folgenden URL zugänglich</p> +<p style="padding-left: 30px;"><code>http://localhost:8098/App-Ordner/meine/Infos.html</code></p> +<p>Aus diesem Schema ergibt sich, dass der Name eines App-Ordners nur einmal verwendet werden kann. Er dient der WebBox als eindeutige Zuordnung.</p> +<h3><a name="web-inf-folder"></a>Der Ordner WEB-INF</h3> +<p>Im Ordner <code>/App-Ordner/WEB-INF</code> werden Java-Klassen, Java-Klassenbibliotheken und Konfigurationsdateien abgelegt. Diese werden von der WebBox dynamisch geladen und ausgeführt wie vom Hersteller der App programmiert.</p> +<h3><a name="webxml"></a>Deployment Descriptor</h3> +<p>Als Deployment Descriptor wird die Datei <code>web.xml</code> bezeichnet. Der Deployment Descriptor beschreibt die App in einer standardisierten Weise und muss im Ordner <code>/App-Ordner/WEB-INF</code> abgelegt sein. Die WebBox zieht den Inhalt des Deployment Descriptors heran, um die ausführbaren Teile einer App zu erkennen und so auszuführen, wie es konfiguriert wurde. Die Beschreibung des Aufbaus eines Deployment Descriptors findet sich in der <a href="http://www.oracle.com/technetwork/java/javaee/tech/index.html">Java Servlet Spezifikation</a>.</p> +<p> </p> +<p> </p> +<p> </p> \ No newline at end of file diff --git a/web/META-INF/daten/www/dok/wbx/Bedienung.htmi b/web/META-INF/daten/www/dok/wbx/Bedienung.htmi new file mode 100644 index 0000000..811cbcd --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bedienung.htmi @@ -0,0 +1,172 @@ +<h1>Bedienung</h1> +<p>Hier ist die Bedienung der <a href="http://uhilger.de/dev/Software/WebBox/WebBox">WebBox</a> beschrieben.</p> +<p style="padding-left: 30px;"><a href="#aufruf">WebBox aufrufen</a><br /><a href="#perspub">Persönliche und öffentliche Inhalte</a><br /><a href="#edittext">Dateien erstellen und ändern</a><br /><a href="#dokedit">Textdokumente erstellen und bearbeiten</a><br /><a href="#bearb">Ordner anlegen, Inhalte verschieben, kopieren, löschen</a><br /><a href="#view">Inhalte ansehen</a><br /><a href="#upload">Inhalte zur WebBox übertragen</a><br /><a href="#bilder">Bilder verwenden</a><br /><a href="#mng-user">Benutzer verwalten</a><br /><a href="#mng-apps">Apps verwalten</a><br /><a href="#mng-db">Datenbanken verwalten</a></p> +<p> </p> +<h2><a name="aufruf"></a>WebBox aufrufen</h2> +<p>Nach <a href="Installation.htmi">Installation</a> und Start ist die WebBox mit einem Browser bedienbar. Wird der Uniform Resource Locator (URL)</p> +<p style="padding-left: 30px;"><code>http://localhost:8098</code> (unverschlüsselt) oder</p> +<p style="padding-left: 30px;"><code>https://localhost:8442</code> (verschlüsselt) </p> +<p>im Browser aufgerufen, erscheint unter diesen Adressen jeweils die Hauptseite der WebBox.</p> +<p style="padding-left: 30px;"><a href="Bilder/startseite.png" data-lightbox="startseite"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/startseite_tn.png" alt="foto" width="120" height="80" /></a></p> +<p style="padding-left: 30px;"><em>Die Hauptseite der WebBox</em> <br /><span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<h2><a name="perspub"></a>Persönliche und öffentliche Inhalte</h2> +<p>Die WebBox unterscheidet für jeden Benutzer einen öffentlichen und einen nicht öffentlichen Bereich. Im öffentlichen Bereich befindliche Inhalte sind ohne Einschränkung sichtbar. Inhalte im persönlichen Bereich sind nur für den angemeldeten Benutzer sichtbar. Jeder angemeldete Benutzer sieht dabei im persönlichen Bereich nur seine eigenen Inhalte. Beide Bereiche sind mit einem eigenen Uniform Resource Locator (URL) zugänglich:</p> +<p style="padding-left: 30px;"><code>https://localhost:8442/home/[benutzername]/</code> (persönliche Inhalte)</p> +<p style="padding-left: 30px;"><code>https://localhost:8442/data/[benutzername]/</code> (öffentliche Inhalte)</p> +<p>Die URLs für persönliche und öffentliche Inhalte wie sie oben beschrieben sind geben dabei Inhalte aus den Ordnern <code>Persoenlich</code> und <code>Oeffentlich</code> wieder. Deren Inhalt wird erstellt und verwaltet wie in den folgenden Kapiteln beschrieben.</p> +<h2><a name="edittext"></a>Dateien erstellen und ändern</h2> +<p>Die WebBox ist mit einer Dateiverwaltung ausgestattet, mit der <a href="https://de.wikipedia.org/wiki/Datei">Dateien</a> erstellt und deren Inhalte bearbeitet werden können. Die Dateiverwaltung der WebBox wird mit der Schaltfläche <code>Dateien</code> auf der Hauptseite aufgerufen. </p> +<p style="padding-left: 30px;"><a href="Bilder/verwaltung.png" data-lightbox="verwaltung"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/verwaltung_tn.png" alt="foto" width="120" height="50" /></a></p> +<p style="padding-left: 30px;"><em>Die Schaltfläche 'Dateien'</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Mit Betätigen der Schaltfläche <code>Dateien</code> erscheint zunächst die Anmeldeseite und mit erfolgreicher <a href="#mng-user">Anmeldung</a> die Dateiverwaltung</p> +<p style="padding-left: 30px;"><a href="Bilder/dateiverwaltung.png" data-lightbox="dateiverwaltung"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/dateiverwaltung_tn.png" alt="foto" width="120" height="70" /> </a></p> +<p style="padding-left: 30px;"><em>Die Dateiverwaltung der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Mit Klick auf den Ordner <code>Persoenlich</code> wird dessen Inhalt angezeigt, anfangs ist dieser leer. Auswahl des Punkts <code>Neuer Text...</code> im Menü <code>Datei</code> öffnet den Texteditor.</p> +<p style="padding-left: 30px;"><a href="Bilder/texteditor.png" data-lightbox="texteditor"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/texteditor_tn.png" alt="foto" width="120" height="80" /> </a></p> +<p style="padding-left: 30px;"><em>Der Texteditor der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Hier kann nun beliebiger Textinhalt eingetragen werden. Auswahl des Punkts <code>Speichern</code> oder <code>Speichern unter..</code> im Menü <code>Datei</code> fragt einen Namen für die neue Datei ab.</p> +<p style="padding-left: 30px;"><a href="Bilder/speichern-unter.png" data-lightbox="speichern-unter"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/speichern-unter_tn.png" alt="foto" width="120" height="60" /> </a></p> +<p style="padding-left: 30px;"><em>Dialog Datei speichern</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Mit Betätigen der Schaltfläche <code>Speichern</code> wird die neue Textdatei unter dem eingetragenen Namen in dem Ordner gespeichert, von dem aus der Texteditor gestartet wurde, in diesem Fall also im Ordner <code>Persoenlich</code>. Die Auswahl <code>Schließen</code> aus dem Menü <code>Datei</code> schließt den Texteditor und es wird wieder der Inhalt des Ordners <code>Persoenlich</code> angezeigt. Dort ist jetzt die neu angelegte Datei dargestellt.</p> +<p>Zum Bearbeiten einer Textdatei wählt man <code>Als Text öffnen</code> aus dem Menü <code>Datei</code>.</p> +<h2><a name="dokedit"></a>Textdokumente erstellen und bearbeiten</h2> +<p>Mit der Dateiverwaltung lassen sich auch Textdokumente schreiben und bearbeiten. Die Vorgehensweise ist genauso wie im vorigen Abschnitt für Textdateien beschrieben. Für Textdokumente wird <code>Neues Dokument</code> aus dem Menü <code>Datei </code>gewählt woraufhin sich der Dokumenteditor der Dateiverwaltung öffnet.</p> +<p style="padding-left: 30px;"><a href="Bilder/dokeditor.png" data-lightbox="dokeditor"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/dokeditor_tn.png" alt="foto" width="120" height="90" /> </a></p> +<p style="padding-left: 30px;"><em>Der Dokumenteditor der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Hier kann ein Textdokument mit Formatierungen direkt im Browser erstellt und bearbeitet werden, wie man es von üblichen Textverarbeitungen gewohnt ist. Das Speichern oder bearbeiten erfolgt wie im vorigen Abschnitt beschrieben. Textdokumente werden dabei als reines HTML gespeichert, der Autor benötigt keine HTML-Kenntnisse für das Schreiben oder Bearbeiten. Die Dokumente sind so bestens für die Verwendung im Netz geeignet.</p> +<h2><a name="bearb"></a>Ordner anlegen, Inhalte verschieben, kopieren, löschen</h2> +<p>Mit den Punkt <code>Neuer Ordner</code> im Menü <code>Datei</code> kann im gerade angezeigten Ordner ein neuer Ordner erstellt werden. Nach Eingabe eines Namens für den neuen Ordner wird der neue Ordner im aktuell geöffneten Ordner angelegt. Ordner und deren Inhalte können mit den Optionen im Menü <code>Bearbeiten</code> verschoben, kopiert oder gelöscht werden. Hierzu werden folgende Schritte ausgeführt</p> +<ol> +<li>Inhalt auswählen, der bearbeitet werden soll,</li> +<li>Menü <code>Bearbeiten</code> -> <code>Kopieren</code> oder <code>Ausschneiden</code> wählen,<code></code></li> +<li>Ordner öffnen, in den die ausgewählten Inhalte verschoben oder kopiert werden sollen und</li> +<li><code>Menü <code>Bearbeiten</code> -> Einfügen</code> wählen.</li> +</ol> +<p>Die gewählten Inhalte werden kopiert bzw. verschoben und befinden sich anschließend am gewählten Ort.</p> +<h2><a name="view"></a>Inhalte ansehen</h2> +<p>Über den Punkt <code>Ansehen</code> im Menü <code>Datei</code> wird der Inhalt der gewählten Datei im Browser angezeigt. Auf diese Weise lässt sich auch der URL bestimmen, unter dem die Datei im Browser aufgerufen werden kann. Freilich werden so nur Inhalte dargestellt, die im Browser angesehen werden können. Dateien mit nicht darstellbaren Formaten werden heruntergeladen.</p> +<h3>Textdokumente und HTML-Seiten</h3> +<p>Ein Textdokument wie es mit der WebBox erstellt werden kann ist einer HTML-Seite ähnlich, insbesondere, da sein Inhalt als HTML gespeichert wird. Es beinhaltet den Teil einer HTML-Seite, der in einer HTML-Seite im Element <code>body</code> untergebracht ist. Zu vollwertigen HTML-Seiten fehlt den Textdokumenten der WebBox allerdings die Gesamtstruktur mit dem Kopf-Teil, dem HTML-Element <code>head</code>.</p> +<p>Werden mit der WebBox erstellte Textdokumente mit der zuvor beschriebenen Funktion <code>Inhalte ansehen</code> dargestellt, also über ihren URL aufgerufen, gibt die WebBox deren HTML-Inhalt aus, was im Webbrowser wie eine HTML-Seite aussieht. Der Webbrowser verwendet zur Anzeige Standardeinstellungen für die Gestaltung des Dokuments, deshalb kann die Darstellung von Browser zu Browser unterschiedlich ausfallen.</p> +<p>Gibt man beim Speichern des Textdokuments einen Namen an der mit <code>.htm i</code> endet bettet die WebBox den Inhalt des Textdokuments in eine komplette HTML-Struktur bestehend aus <code>head</code>- und <code>body</code>-Element ein und fügt Verweise auf Gestaltungsvorlagen hinzu (CSS-Stylesheets). Als Gestaltungsvorlage wird das der WebBox beiliegende Stylesheet von Bootstrap <code>/jslib/bootstrap/css/bootstrap.min.css</code> sowie die Datei <code>stile.css</code> eingebettet. Legt man im Ordner, in dem das betrffende Textdokument abgelegt ist, eine Datei <code>stile.css</code> an, können dem Textdokument auf diese Weise eigene Gestaltungsvorgaben mitgegeben werden.</p> +<h3>Textdokumente als HTML exportieren</h3> +<p>Um ein Textdokument, das mit der WebBox erstellt wurde, auch ohne eine WebBox einfach im Browser ansehen zu können, muss es als HTML-Seite vorliegen. Mit dem Punkt <code>Export HTML</code> im Menü <code>Datei</code> werden zu diesem Zweck alle Textdokumente, also die <code>.htm i</code>-Dateien, des aktuell geöffneten Ordners als HTML-Seiten erzeugt. Die HTML-Seiten werden dazu in einen Ordner gelegt, der genauso heißt wie der aktuell geöffnete Ordner und dessen Name der Zusatz _html angehängt wurde. Dieser neue Ordner liegt nach dem HTML-Export in dem Ordner, in dem der aktuell geöffnete Ordner liegt.</p> +<h2><a name="upload"></a>Inhalte zur WebBox übertragen</h2> +<p>Lokale Inhalte werden zur WebBox übertragen und im aktuellen Verzeichnis abgelegt, wenn sie per Ziehen und Ablegen (Drag and Drop) im gerade geöffneten Ordner der Dateiverwaltung 'fallengelassen' werden.</p> +<h3>WebDAV verwenden</h3> +<p>Die WebBox stellt einen zentralen Ordner zur Verwendung von WebDAV bereit. Über folgenden URL kann per WebDAV auf die WebBox zugegriffen werden.</p> +<p><code>https://localhost:8442/dav</code></p> +<p>Der obige URL verweist auf den Ordner <code>dav</code> im Datenverzeichnis der WebBox, also den Ordner <code>$wbx/daten/dav</code>. Benutzer mit Rolle <code>wbxAdmin</code> können in der Dateiverwaltung der WebBox den Ordner <code>$daten</code> verwenden, um auf Inhalte des dort zugänglichen Ordners <code>dav</code> zuzugreifen. Auf diese Weise können via WebDAV auf die WebBox übertragene Dateien auch über die Dateiverwaltung der WebBox an andere Ablageorte kopiert werden.</p> +<p>Benutzer, die den Zugriff via WebDAV nutzen sollen müssen die Rolle <code>davNutzer</code> besitzen. </p> +<h2><a name="bilder"></a>Bilder verwenden</h2> +<p>Werden Bilder des Typs JPEG, PNG oder GIF auf die WebBox übertragen, erscheint für sie als Dateisymbol eine Minituransicht des Bildinhalts. Das Bild kann angesehen werden wie im Abschnitt Inhalte ansehen beschrieben. Die Miniaturansicht eines Bildes wird zudem von der WebBox dynamisch erzeugt und kann angesehen werden, wenn dem Namen des Bildes im URL der Zusatz <code>_tn</code> hinzugefügt wird.</p> +<p>Ist beispielsweise eine Bilddatei <code>MeinBild.png</code> im Ordner <code>Persoenlich/Bilder</code> des Nutzers <code>fred</code> abgelegt, kann ihre Minituransicht mit folgendem URL angesehen werden:</p> +<p style="padding-left: 30px;"><code>http://localhost:8098/home/fred/Bilder/MeinBild_tn.png</code></p> +<p>Auf diese Weise müssen nicht die unter Umständen großen Datenmengen des Originalbildes für eine Miniatur-Vorschau übertragen werden. <span style="font-size: 1em;">Neben der Miniaturansicht lassen sich die folgenden weiteren Bildgrößen erzeugen:</span></p> +<table> +<tbody> +<tr> +<td><strong>Größe</strong></td> +<td><strong>Endung</strong></td> +</tr> +<tr> +<td>120</td> +<td>_tn</td> +</tr> +<tr> +<td>240</td> +<td>_kl</td> +</tr> +<tr> +<td>500</td> +<td>_dd</td> +</tr> +<tr> +<td>700</td> +<td>_mt</td> +</tr> +<tr> +<td>1200</td> +<td>_gr</td> +</tr> +</tbody> +</table> +<p> </p> +<p>Ohne Endung wird das Bild in Originalgröße ausgegeben.</p> +<p>Bilder können mit Hilfe des Dokumenteditors in Dokumente eingebunden werden. Vom Ablageort des betreffenden Dokuments ausgehend genügt eine relative Pfadangabe. Zum Beispiel könnte ein Dokument im Ordner <code>Persoenlich</code> des Nutzers <code>fred</code> das oben erwähnte Bild mit der relativen Angabe <code>Bilder/MeinBild.png</code> einbinden.</p> +<h3>Bilder betrachten (Diashow)</h3> +<p>Aus der Dateiverwaltung der WebBox heraus können Bilder als Diashow betrachtet werden. Dazu wird die Diashow-Funktion zunächst eingeschaltet, indem der Punkt "Diashow nicht zeigen" gewählt wird. Damit wird die standardmäßig ausgeschaltete Diashow-Funktion aktiviert. Anschließend wird ein Ordner geöffnet, der Bilder enthält. Mit Klick auf eines der Bilder wird die Diashow gestartet.</p> +<p>Sollen Bilder wieder als Dateien in der Dateiverwaltung behandelt werden, beispielweise zum Markieren einzelner Bilddateien, wird die Funktion "Diashow zeigen" im Menü gewählt. Damit wird die Diashow-Funktion ausgeschaltet.</p> +<h2><a name="mng-user"></a>Benutzer verwalten</h2> +<p>Eine WebBox kann von verschiedenen Benutzern zugleich verwendet werden. Jedem Nutzer muss in der Benutzerverwaltung ein Benutzerkonto angelegt werden. </p> +<h3>Rollen und der Benutzer <code>admin</code></h3> +<p>Den Zugang zu Inhalten regelt die WebBox über Rollen, die ein Benutzer besitzen kann. Über die Benutzerverwaltung können Rollen erteilt und entzogen werden. Im Auslieferungszustand der WebBox ist diese mit einem Benutzer namens <code>admin</code> ausgestattet. Der Benutzer <code>admin</code> besitzt die folgenden Rollen:</p> +<p style="padding-left: 30px;"><code>nutzerAdmin</code> - Benutzer verwalten<br /><code>wbxAdmin</code> - Apps verwalten<br /><code>ownFileAdmin</code> - eigene Dateien verwalten<br /><code>sqlKonsole</code> - Datenbanken verwalten<br /><code>nutzerProfil</code> - Angaben zur Person und eigenes Kennort ändern<br /><code>manager-script</code> - interne Rolle zur Verwaltung von Apps</p> +<p>Mit dem Benutzer <code>admin</code> kann die erste Einrichtung der WebBox erfolgen. Das Kennwort des Benutzers <code>admin</code> lautet <code>admin</code>. Bevor die WebBox für andere Zwecke verwendet wird sollte mit Hilfe des Benutzers <code>admin</code> mindestens ein anderer Benutzer angelegt werden, der die obigen Rollen besitzt. Anschließend sollte der Benutzer <code>admin</code> gelöscht werden.</p> +<p>Um die Verwaltung der WebBox von deren Nutzung abzugrenzen empfiehlt es sich, mindestens einen weiteren Benutzer anzulegen, der nur die Rolle <code>ownFileAdmin</code> besitzt. Nur Benutzer, die Teile der WebBox administrieren sollen, benötigen die Rollen <code>nutzerAdmin</code>, <code>wbxAdmin</code> und <code>manager-script</code>.</p> +<h3>Aufruf der Benutzerverwaltung</h3> +<p>Die Benutzerverwaltung der WebBox wird mit der Schaltfläche <code>Benutzer</code> auf der Hauptseite aufgerufen. </p> +<p style="padding-left: 30px;"><a href="Bilder/verwaltung.png" data-lightbox="verwaltung2"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/verwaltung_tn.png" alt="foto" width="120" height="50" /></a></p> +<p style="padding-left: 30px;"><em>Die Schaltfläche 'Benutzer'</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Mit Betätigen der Schaltfläche <code>Benutzer</code> erscheint zunächst die Anmeldeseite und nach erfolgreicher Anmeldung die Benutzerverwaltung.</p> +<p style="padding-left: 30px;"><a href="Bilder/benutzerverwaltung.png" data-lightbox="benutzerverwaltung"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/benutzerverwaltung_tn.png" alt="foto" width="120" height="100" /> </a></p> +<p style="padding-left: 30px;"><em>Die Benutzerverwaltung der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Nur Benutzer mit der Rolle <code>nutzerAdmin</code> können die Benutzerverwaltung aufrufen.</p> +<h3>Benutzer anlegen</h3> +<p>Mit Betätigen der Schaltfläche <code>Neu</code> erscheint das Formular zur Anlage eines Benutzers. </p> +<p style="padding-left: 30px;"><a href="Bilder/nutzer-neu.png" data-lightbox="nutzer-neu"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/nutzer-neu_tn.png" alt="foto" width="120" height="100" /> </a></p> +<p style="padding-left: 30px;"><em>Formular zur Anlage eines Benutzers</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Hier können Angaben zum Benutzer gemacht und ein Kennwort erteilt werden. Der neue Benutzer wird angelegt, wenn die Schaltfläche <code>Speichern</code> betätigt wird.</p> +<p>Die WebBox speichert die Angaben zum Benutzer in einer Datenbank im Ordner <code>$wbx/daten/db</code>. Kennworte werden dabei verschlüsselt in der Datenbank abgelegt und sind auch für Administratoren der Maschine, auf der die WebBox läuft nicht im Klartext lesbar.</p> +<h3>Rollen erteilen und entziehen</h3> +<p>Wird in der Liste der Benutzer einer der Anmeldenamen geklickt erscheint die Rollen-Ansicht.</p> +<p style="padding-left: 30px;"><a href="Bilder/rollen.png" data-lightbox="rollen"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/rollen_tn.png" alt="foto" width="120" height="100" /> </a></p> +<p style="padding-left: 30px;"><em>Die Rollen-Ansicht der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Oben sind die Rollen zu sehen, die der Benutzer besitzt. Unten erscheinen die verfügbaren Rollen. Mit den Schaltflächen <code>Erteilen</code> und <code>Entziehen</code> werden dem Benutzer Rollen erteilt und entzogen. Eine neue Rolle kann mit der Schaltfläche <code>Neu</code> angelegt werden.</p> +<h3>Eigenes Kennwort ändern</h3> +<p>Jeder Benutzer kann sein eigenes Kennwort und die Angaben zur eigenen Person selbst ändern. Die Funktion ist unabhängig von den übrigen Funktionen der Benutzerverwaltung und an die Rolle <code>nutzerProfil</code> geknüpft, die jedem Benutzer erteilt sein muss.</p> +<p>Zur Änderung dieser Angaben wird im Menü der Punkt <code>Profil</code> gewählt.</p> +<h2><a name="mng-apps"></a>Apps verwalten</h2> +<p>Die WebBox kann Programme ausführen, die ein Benutzer zu diesem Zweck auf die WebBox überträgt. Solche Programme werden an dieser Stelle Apps genannt. Ob eine App auf der WebBox läuft ist gewöhnlich an ihrer Dateiendung <code>.war</code> erkennbar und in der Dokumentation zur App erwähnt.</p> +<h3>Aufruf der App-Verwaltung</h3> +<p>Die App-Verwaltung der WebBox wird mit der Schaltfläche <code>Apps</code> auf der Hauptseite aufgerufen. </p> +<p style="padding-left: 30px;"><a href="Bilder/verwaltung.png" data-lightbox="verwaltung3"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/verwaltung_tn.png" alt="foto" width="120" height="50" /></a></p> +<p style="padding-left: 30px;"><em>Die Schaltfläche 'Apps'</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Mit Betätigen der Schaltfläche <code>Apps</code> erscheint zunächst die Anmeldeseite und nach erfolgreicher Anmeldung die App-Verwaltung.</p> +<p style="padding-left: 30px;"><a href="Bilder/apps.png" data-lightbox="apps"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/apps_tn.png" alt="foto" width="120" height="70" /> </a></p> +<p style="padding-left: 30px;"><em>Die App-Verwaltung der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Nur Benutzer mit der Rolle <code>wbxAdmin</code> können die App-Verwaltung aufrufen.</p> +<h3>App an die WebBox übertragen</h3> +<p>Betätige zur Übertragung einer App auf die WebBox zunächst die Schaltfläche <code>Durchsuchen</code>. Navigiere zum Ablageort des Webarchivs, das die App enthält und wähle sie aus. Der Name eines solchen Webarchivs endet üblicherweise mit <code>.war</code> und erscheint neben der Schaltfläche <code>Durchsuchen</code>, sobald er ausgewählt wurde.</p> +<p>Die App wird an die WebBox übertragen, wenn die Schaltfläche <code>Deploy</code> betätigt wird. In aller Regel wird die App von der WebBox ausgeführt, nachdem die Übertragung abgeschlossen ist. Die Kombination aus dem Übertragen der App an die WebBox, deren dortige Vorbereitung zur Ausführung und ggf. das Ausführen wird <em>Deploy</em> genannt.</p> +<p>Die App erscheint in der Liste der Apps, sobald die Übertragung abgeschlossen ist.</p> +<h3>Ausführung einer App stoppen</h3> +<p>Die Ausführung einer App wird gestoppt, indem ihr Eintrag in der Liste der Apps gewählt und die Schaltfläche <code>Stopp</code> betätigt wird. Mit der Schaltfläche <code>Start</code> kann die App wieder ausgeführt werden. Die App bleibt gestoppt bis sie von einem Administrator der App-Verwaltung wieder gestartet wird.</p> +<h3>App löschen</h3> +<p>Auswahl einer App aus der Liste der Apps und Betätigen der Schaltfläche <code>Entfernen</code> stoppt die App und löscht sie von der WebBox.</p> +<h3>Interne Apps entsperren</h3> +<p>Teile der WebBox sind selbst als Apps angelegt. Diese sollen nicht unbeabsichtigt gestoppt oder gelöscht werden und sind in der App-Verwaltung für solche Aktionen gesperrt. Die Sperre gilt für folgende Apps:</p> +<p style="padding-left: 30px;"><code>/wbx</code> - Bedienoberfläche der App-Verwaltung<br /><code>/um</code> - Benutzerverwaltung<br /><code>/file-cms</code> - Dateiverwaltung der WebBox<br /><code>/wbx-dbcon</code> - Datenbank-Konsole der WebBox<br /><code>/home</code> - Persönliche Nutzerdaten<br /><code>/data</code> - Öffentliche Nutzerdaten<br /><code>/</code> - Hauptseite der WebBox, der sogennante ROOT-Kontext<br /><code>/manager</code> - interner Teil der App-Verwaltung<br /><code>/jslib</code> - Javacsript-Ressourcen der WebBox</p> +<p>Mit dem Punkt <code>Interne Apps entsperren</code> im Menü <code>Apps</code> kann die Sperre gelöst werden. <strong>Vorsicht:</strong> Das Stoppen oder Entfernen einer der oben aufgeführten Apps führt dazu, dass die WebBox nicht mehr richtig funktioniert.</p> +<h2><a name="mng-db"></a>Datenbanken verwalten</h2> +<p>Die WebBox stellt Datenbanken und deren Inhalt über einen eigenen Derby Network Server bereit. Die Datenbankfunktion der WebBox ist hauptsächlich für Apps vorgesehen, die sie zur strukturierten Ablage und Verwaltung von Daten verwenden können.</p> +<p>Die Datenbanken der WebBox sind nur auf der Maschine zugänglich, auf der die WebBox läuft. Aufruf und Nutzung des Datenbankservers erfolgt über die Java Database Connectivity (JDBC) mit folgendem URL</p> +<p style="padding-left: 30px;"><code>jdbc:derby://localhost:1528/[Name der Datenbank];create=true</code></p> +<p>Datenbanken verwaltet der Datenbankserver der WebBox im eigenen Datenverzeichnis selbsttätig. Der Zusatz <code>;create=true</code> veranlaßt den Datenbankserver der WebBox, die betreffende Datenbank im Datenverzeichnis zu erstellen, wenn sie noch nicht existiert. Dabei wird keine Datenbankstruktur wie z.B. Tabellen oder Indizes erstellt, diese muss mit entsprechenden SQL-Kommandos von der App oder von Hand in der Datenbank-Konsole erzeugt werden.</p> +<h3>Aufruf der Datenbank-Konsole</h3> +<p>Zum Umgang mit Datenbanken enthält die WebBox eine Datenbank-Konsole. Kommandos der Structured Query Language (SQL) können über die Datenbank-Konsole eingegeben und ausgeführt werden. Sie wird mit der Schaltfläche <code>Datenbank</code> auf der Hauptseite aufgerufen. </p> +<p style="padding-left: 30px;"><a href="Bilder/verwaltung.png" data-lightbox="verwaltung4"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/verwaltung_tn.png" alt="foto" width="120" height="50" /></a></p> +<p style="padding-left: 30px;"><em>Die Schaltfläche 'Datenbank'</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Mit Betätigen der Schaltfläche <code>Datenbank</code> erscheint zunächst die Anmeldeseite und nach erfolgreicher Anmeldung die Datenbank-Konsole.</p> +<p style="padding-left: 30px;"><a href="Bilder/dbcon.png" data-lightbox="dbcon"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/dbcon_tn.png" alt="foto" width="120" height="70" /> </a></p> +<p style="padding-left: 30px;"><em>Die Datenbank-Konsole der WebBox</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Nur Benutzer mit der Rolle <code>sqlKonsole</code> können die Datenbank-Konsole aufrufen.</p> +<h3>Datenbank-Verbindung erstellen</h3> +<p>Die Arbeit mit einer Datenbank aus der Datenbank-Konsole heraus erfordert die Anlage einer Datenbank-Verbindung. Mit Auswahl von <code>Neu..</code> aus dem Mneü <code>Datenbank</code> erscheint der Dialog zur Anlage einer neuen Datenbank-Verbindung.</p> +<p style="padding-left: 30px;"><a href="Bilder/db_neu.png" data-lightbox="dbneu"> <img style="margin: 5px 10px; border: 1px solid black;" src="Bilder/db_neu_tn.png" alt="foto" width="120" height="70" /> </a></p> +<p style="padding-left: 30px;"><em>Der Dialog Neue Datenbankverbindung</em> <br /> <span style="font-size: x-small;">(für eine größere Ansicht das Bild anklicken)</span></p> +<p>Hier wird der Name der Datenbank angegeben und die Schaltfläche <code>Neu</code> betätigt. Die Datenbankverbindung wird erstellt und ihr Name erscheint in der Seitenleiste links.</p> +<h3>SQL-Kommandos anwenden</h3> +<p><a href="https://builds.apache.org/job/Derby-docs/lastSuccessfulBuild/artifact/trunk/out/ref/crefsqlj23296.html">Kommandos der Structured Query Language</a> (SQL) sind ein mächtiges Werkzeug zur Arbeit mit Datenbanken. Mit ihnen lassen sich Datenbankstrukturen ebenso wie Datenbankinhalte erstellen und ändern. Mit der Datenbank-Konsole der WebBox können beliebige einzelne SQL-Kommandos wie auch SQL-Skripte an die Datenbank abgesetzt werden.</p> +<p>Die betreffenden SQL-Kommandos werden dazu in der Textbox rechts oben in der Datenbank-Konsole eingetragen und die Schaltfläche Ausführen betätigt. Ergebnisse der Ausführung wie zum Beispiel die Antwort auf ein SELECT-Kommando werden im unteren Teil der Datenbank-Konsole als Ergebnistabelle dargestellt.</p> +<p><strong>Vorsicht</strong>: Ein falsches SQL-Kommando kann Inhalt oder Struktur einer Datenbank beschädigen und zu Datenverlust führen. Die Datenbank-Konsole darf nur mit größtem Bedacht verwendet werden, ihre Verwendung geschieht auf eigenes Risiko.</p> \ No newline at end of file diff --git a/web/META-INF/daten/www/dok/wbx/Betrieb-Docker.htmi b/web/META-INF/daten/www/dok/wbx/Betrieb-Docker.htmi new file mode 100644 index 0000000..3086139 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Betrieb-Docker.htmi @@ -0,0 +1,27 @@ +<h1>Betrieb</h1> +<p>In den folgenden Abschnitten ist der Betrieb der <a href="http://uhilger.de/dev/Software/WebBox/WebBox">WebBox</a> als Docker-Container beschrieben:</p> +<p style="padding-left: 30px;"><a href="#start">WebBox starten</a><br /><a href="#stopp">WebBox stoppen</a><br /><a href="#bak">Daten sichern</a><br /><a href="#sec">Datensicherheit</a><br /><a href="#anpassen">WebBox an eigene Zwecke anpassen</a></p> +<p> </p> +<h2><a name="start"></a>WebBox starten</h2> +<p>Nach der <a href="Installation.htmi">Installation</a> werden zum Start der WebBox die folgenden Schritte ausgeführt.</p> +<ol> +<li>Datenbank-Container starten<br /><code>docker run -v `pwd`/derby-daten:/dbs --name derby --rm -d -p 1527:1527 az82/docker-derby</code></li> +<li>WebBox starten<br /><code>docker run -it --rm --name tc -d -p 8080:8080 -p 8443:8443 -v `pwd`/tc-daten:/tc-daten --link derby:dbsrv wbx</code></li> +</ol> +<p>Damit ist die WebBox bereit zur <a href="Bedienung.htmi">Verwendung</a>.</p> +<h2><a name="stopp"></a>WebBox stoppen</h2> +<p>Zum Stoppen der WebBox werden die folgenden Schritte ausgeführt.</p> +<ol> +<li>WebBox stoppen<br /><code>docker exec tc "bin/shutdown.sh"</code></li> +<li>Datenbank-Container stoppen<br /><code>docker exec derby java org.apache.derby.drda.NetworkServerControl shutdown</code></li> +</ol> +<h2><a name="bak"></a>Daten sichern</h2> +<p>Die WebBox legt alle veränderlichen Nutzerdaten in den Volumes <code>/derby-daten</code> und <code>/tc-daten</code> im Arbeitsverzeichnis ab, aus dem heraus die Docker-Container gestartet werden. Eine regelmäßige Kopie von <code>/derby-daten</code> und <code>/tc-daten</code> v<span style="font-size: 1em;">ermeidet Datenverlust im Falle von Störungen oder Fehlern.</span></p> +<h3><a name="sec"></a>Datensicherheit</h3> +<p>Die WebBox bewirkt keine Zugriffsbeschränkungen auf der Ebene des Betriebssystems des Docker-Containers, in dem die WebBox läuft, dem WebBox-Container. Jeder Benutzer des WebBox-Containers kann so auf Inhalte des Rechners zugreifen, wie es der Systemadministrator von Docker festgelegt hat.</p> +<p>Über die Benutzerverwaltung der WebBox erteilte Berechtigungen bewirken Beschränkungen des Zugriffs über die WebBox. Solange die WebBox läuft, unterliegen Zugriffe den Regeln, die in der Benutzerverwaltung der WebBox festgelegt sind. Diese Regeln bewirken im Auslieferungszustand der WebBox, dass nur Daten im Verzeichnis <code>/usr/local/wbx/daten </code>des WebBox-Containers über die WebBox zugänglich sind.</p> +<h3>Programme</h3> +<p>Die WebBox ermöglicht die Ausführung von Programmen auf dem WebBox-Container. Benutzer der WebBox können mit der WebBox Programme ausführen, mit denen es möglich ist, auf Daten des WebBox-Containers zuzugreifen.</p> +<p>Um zu verhindern, dass auf diesem Weg der Benutzer einer WebBox auf Daten des WebBox-Containers zugreift, dürfen in der Benutzerverwaltung der WebBox die Rollen <code>manager-script</code>, <code>manager-gui</code>, <code>nutzerAdmin</code> und <code>wbxAdmin</code> nur Nutzern erteilt werden, die berechtigt sind, auf Daten des WebBox-Containers zuzugreifen.</p> +<h2><a name="anpassen"></a>WebBox an eigene Zwecke anpassen</h2> +<p>Kundige Benutzer können die WebBox an ihre Bedürfnisse anpassen. Informationen über ihren Aufbau liefert die <a href="http://uhilger.de/gitblit/docs/wbx-shell.git">Dokumentation im Repository</a>.</p> \ No newline at end of file diff --git a/web/META-INF/daten/www/dok/wbx/Betrieb.htmi b/web/META-INF/daten/www/dok/wbx/Betrieb.htmi new file mode 100644 index 0000000..985c57f --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Betrieb.htmi @@ -0,0 +1,34 @@ +<h1>Betrieb</h1> +<p>In den folgenden Abschnitten ist der Betrieb der <a href="http://uhilger.de/dev/Software/WebBox/WebBox">WebBox</a> beschrieben:</p> +<p style="padding-left: 30px;"><a href="#start">WebBox starten</a><br /><a href="#stopp">WebBox stoppen</a><br /><a href="#bak">Daten sichern</a><br /><a href="#sec">Datensicherheit</a><br /><a href="#anpassen">WebBox an eigene Zwecke anpassen</a></p> +<p> </p> +<h2><a name="start"></a>WebBox starten</h2> +<p>Nach der <a href="Installation.htmi">Installation</a> wird zum Start der WebBox das Skript <code>$wbx/start.sh</code> bzw. sein Windows-Pendant <code>$wbx/start.bat</code> ausgeführt wie nachfolgend im Detail beschrieben. Nach dem Start ist die WebBox bereit zur <a href="Bedienung.htmi">Verwendung</a>.</p> +<h3>Linux und Mac OS</h3> +<p>Wir nehmen an, die WebBox ist im Verzeichnis <code>/home/fred/wbx</code> abgelegt. Zum Start der WebBox wird auf der Kommandozeile eingegeben</p> +<p style="padding-left: 30px;"><code>cd /home/fred/wbx</code><br /><code>./start.sh</code></p> +<p>Stattdessen kann die WebBox auch aus der Dateiverwaltung bzw. dem Finder heraus gestartet werden indem ein Doppelklick auf das Symbol der Datei <code>start.sh</code> ausgeführt wird. Siehe hierzu gegebenenfalls <a href="http://uhilger.de/dev/Tipps/Skript-starten-mit-Ubuntu-Unity">diesen Tipp</a>.</p> +<h3>Windows</h3> +<p>Unter Windows läßt sich die WebBox aus der Dateiverwaltung heraus durch Doppelklick auf das Symbol der Datei <code>start.bat</code> ausführen. Auch unter Windows kann man stattdessen das Skript von der Kommandozeile starten.</p> +<h3>Kein Eingriff ins System</h3> +<p>Start und Betrieb der WebBox machen keine Änderungen am System der Maschine, auf der die WebBox installiert wurde. Alle Aktivitäten der WebBox finden im Ordner <code>$wbx</code> statt, der bei der <a href="Installation.htmi">Installation</a> angelegt wurde.</p> +<h2><a name="stopp"></a>WebBox stoppen</h2> +<p>Zum Stoppen der WebBox wird genauso vorgegangen wie beim Start, allerdings wird zum Stoppen das Skript <code>stopp.sh</code> bzw. <code>stopp.bat</code> verwendet.</p> +<h2><a name="bak"></a>Daten sichern</h2> +<p>Die WebBox legt alle veränderlichen Nutzerdaten im Verzeichnis <code>$wbx/daten</code> ab. Dort finden sich die Unterverzeichnisse</p> +<ul> +<li><code>db</code> (Datenbanken)</li> +<li><code>home</code> (persönliche Daten)</li> +<li><code>www</code> (öffentliche Daten)</li> +</ul> +<p>Eine regelmäßige Kopie von <code>$wbx/daten</code> vermeidet Datenverlust im Falle von Störungen oder Fehlern.</p> +<h3>Protokolle</h3> +<p>Neben den oben erwähnten Ablageorten legt die WebBox im Ordner <code>$wbx/sys/base/logs</code> Protokolle an. Mit den Protokollen können z.B. nachträglich Störungen nachvollzogen werden. Die dort entstehenden Daten sollten regelmäßig gelöscht werden um ein unkontrolliertes Anwachsen des Protokollverzeichnisses zu vermeiden.</p> +<h2><a name="sec"></a>Datensicherheit</h2> +<p>Die WebBox bewirkt keine Zugriffsbeschränkungen auf der Ebene des Betriebssystems des Rechners, auf dem die WebBox läuft, dem WebBox-Rechner. Jeder Benutzer des WebBox-Rechners kann so auf Inhalte des Rechners zugreifen, wie es der Systemadministrator des Rechners festgelegt hat.</p> +<p>Über die Benutzerverwaltung der WebBox erteilte Berechtigungen bewirken Beschränkungen des Zugriffs über die WebBox. Solange die WebBox läuft, unterliegen Zugriffe den Regeln, die in der Benutzerverwaltung der WebBox festgelegt sind. Diese Regeln bewirken im Auslieferungszustand der WeBox, dass nur Daten im Verzeichnis <code>$wbx/daten </code>des WebBox-Rechners über die WebBox zugänglich sind.</p> +<h3>Programme</h3> +<p>Die WebBox ermöglicht die Ausführung von Programmen auf dem WebBox-Rechner. Benutzer der WebBox können mit der WebBox Programme ausführen, mit denen es möglich ist, auf Daten des WebBox-Rechners zuzugreifen.</p> +<p>Um zu verhindern, dass auf diesem Weg der Benutzer einer WebBox auf Daten des WebBox-Rechners zugreift, dürfen in der Benutzerverwaltung der WebBox die Rollen <code>manager-script</code>, <code>manager-gui</code>, <code>nutzerAdmin</code> und <code>wbxAdmin</code> nur Nutzern erteilt werden, die berechtigt sind, auf Daten des WebBox-Rechners zuzugreifen.</p> +<h2><a name="anpassen"></a>WebBox an eigene Zwecke anpassen</h2> +<p>Kundige Benutzer können die WebBox an ihre Bedürfnisse anpassen. Informationen über ihren Aufbau liefert die <a href="http://uhilger.de/gitblit/docs/wbx-shell.git">Dokumentation im Repository</a>.</p> \ No newline at end of file diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/apps.png b/web/META-INF/daten/www/dok/wbx/Bilder/apps.png new file mode 100644 index 0000000..c76b5ba --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/apps.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/benutzerverwaltung.png b/web/META-INF/daten/www/dok/wbx/Bilder/benutzerverwaltung.png new file mode 100644 index 0000000..f1eb879 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/benutzerverwaltung.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/dateiverwaltung.png b/web/META-INF/daten/www/dok/wbx/Bilder/dateiverwaltung.png new file mode 100644 index 0000000..ebd96a2 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/dateiverwaltung.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/db_neu.png b/web/META-INF/daten/www/dok/wbx/Bilder/db_neu.png new file mode 100644 index 0000000..9a684d5 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/db_neu.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/dbcon.png b/web/META-INF/daten/www/dok/wbx/Bilder/dbcon.png new file mode 100644 index 0000000..2f36742 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/dbcon.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/dokeditor.png b/web/META-INF/daten/www/dok/wbx/Bilder/dokeditor.png new file mode 100644 index 0000000..8983746 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/dokeditor.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/nutzer-neu.png b/web/META-INF/daten/www/dok/wbx/Bilder/nutzer-neu.png new file mode 100644 index 0000000..90a6517 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/nutzer-neu.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/rollen.png b/web/META-INF/daten/www/dok/wbx/Bilder/rollen.png new file mode 100644 index 0000000..b388b2e --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/rollen.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/speichern-unter.png b/web/META-INF/daten/www/dok/wbx/Bilder/speichern-unter.png new file mode 100644 index 0000000..30c2c62 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/speichern-unter.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/startseite.png b/web/META-INF/daten/www/dok/wbx/Bilder/startseite.png new file mode 100644 index 0000000..067039e --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/startseite.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/texteditor.png b/web/META-INF/daten/www/dok/wbx/Bilder/texteditor.png new file mode 100644 index 0000000..a826124 --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/texteditor.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Bilder/verwaltung.png b/web/META-INF/daten/www/dok/wbx/Bilder/verwaltung.png new file mode 100644 index 0000000..017699c --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Bilder/verwaltung.png Binary files differ diff --git a/web/META-INF/daten/www/dok/wbx/Installation.htmi b/web/META-INF/daten/www/dok/wbx/Installation.htmi new file mode 100644 index 0000000..f8183ae --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/Installation.htmi @@ -0,0 +1,25 @@ +<h1>Installation</h1> +<p>Die WebBox kann in zwei Arten installiert werden:</p> +<ul> +<li><a href="#docker-inst">Als Docker-Container</a>,</li> +<li><a href="#filesys-inst">auf dem Dateisystem eines Rechners</a>.</li> +</ul> +<p>Nachfolgend ist beschrieben, wie diese Formen der Installation ausgeführt werden.</p> +<h2><a name="docker-inst"></a>Installation als Docker-Container</h2> +<p>Damit die WebBox als Docker-Container installiert werden kann, muss auf der betreffenden Maschine zunächst Docker installiert sein. Docker kann auf viele verschiedene Arten genutzt werden, zum Beispiel auch mit Hilfe von VirtualBox in einer virtuellen Maschine, wie es der Artikel <a href="http://uhilger.de/dev/Artikel/coreos/Docker-CoreOS-VirtualBox">Docker mit CoreOS und VirtualBox</a> beschreibt. Wird die WebBox als Docker-Container aus VirtualBox heraus genutzt, müssen in den Netzwerkeinstellungen der virtuellen Maschine Weiterleitungen für Port 8098 (http) und 8442 (https) eingerichtet werden. </p> +<p>Ist Docker betriebsbereit, werden zur Installation der WebBox als Docker-Container die folgenden Schritte ausgeführt.</p> +<ol> +<li>Das Docker-Image der WebBox erzeugen<br /><code>docker build -t wbx http://uhilger.de/dl/wbx/wbxd.tar.gz</code></li> +</ol> +<p> <span style="font-size: 1em;">Nun ist die WebBox bereit zum</span><span style="font-size: 1em;"> </span><a style="font-size: 1em;" href="Betrieb-Docker.htmi">Start als Docker-Container</a><span style="font-size: 1em;">.</span></p> +<h2><a name="filesys-inst"></a>Installation im Dateisystem</h2> +<p>Zur Installation der <a href="http://uhilger.de/dev/Software/WebBox/WebBox">WebBox</a> im lokalen Dateisystem werden die folgenden Schritte ausgeführt.</p> +<h3>Herunterladen und Entpacken</h3> +<p>Mit der folgenden Verknüpfung kann die WebBox heruntergeladen werden:</p> +<p style="padding-left: 30px;"><a href="http://uhilger.de/dl/wbx/wbx.zip">Herunterladen</a></p> +<p>Die heruntergeladene Datei <code>wbx.zip</code> muss zunächst entpackt werden. Ihr Inhalt kann an einen frei wählbaren Ort abgelegt werden. Dieser Ablageort wird hier <code>$wbx</code> bezeichnet.</p> +<h3>Java hinzufügen</h3> +<p>Vor dem ersten Start der WebBox muss ein aktuelles Java Development Kit (JDK) beschafft werden, wie es z.B. von <a href="http://zulu.org/">Azul</a> erhältlich ist. Auch das JDK muss zunächst entpackt werden. Nach dem Entpacken wird der Inhalt in das Verzeichnis <code></code></p> +<p style="padding-left: 30px;"><code>$wbx/sys/jrs/jvm</code></p> +<p>verschoben.</p> +<p>Nun ist die WebBox bereit zum <a href="Betrieb.htmi">Start aus dem Dateisystem</a>.</p> \ No newline at end of file diff --git a/web/META-INF/daten/www/dok/wbx/js-info.htmi b/web/META-INF/daten/www/dok/wbx/js-info.htmi new file mode 100644 index 0000000..bb3df1a --- /dev/null +++ b/web/META-INF/daten/www/dok/wbx/js-info.htmi @@ -0,0 +1,5 @@ +<h1>Über Javasacript</h1> +<p><a href="https://de.wikipedia.org/wiki/JavaScript">Javascript</a> ist eine Skriptsprache, die von Webbrowsern ausgeführt werden kann. Die WebBox verwendet Javascript zum Beispiel bei der Anzeige von Bildern. Auch die Apps, die der WebBox beiliegen verwenden Javascript.</p> +<p>Javascript wird dabei in einer unschädlichen Weise verwendet und verletzt nicht die Privatsphäre. Jeder kann sich selbst von der Unbedenklichkeit überzeugen, alle Teile des <a href="http://uhilger.de/gitblit/docs/wbx-shell.git">Codes</a> sind frei zugänglich.</p> +<p> </p> +<p><a href="/">zurück zur Hauptseite</a></p> \ No newline at end of file diff --git a/web/WEB-INF/web.xml b/web/WEB-INF/web.xml index eb03881..4ced0d1 100644 --- a/web/WEB-INF/web.xml +++ b/web/WEB-INF/web.xml @@ -7,7 +7,7 @@ Bleibt der Eintrag leer oder wird er ganz weggelassen, wird ein hart kodierter Pfad fuer die WebBox verwendet.</description> <param-name>datenAblage</param-name> - <param-value> </param-value> + <param-value>/tc-daten</param-value> </context-param> <listener> <description>Der Initialiser setzt globale Variable fuer die Dateiverwaltung</description> -- Gitblit v1.9.3