Dateiverwaltung für die WebBox
ulrich@undisclosed
2020-05-04 d61a61bfa06aaa5c62cc137e059e17f921689e05
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
<h1>Betrieb</h1>
<p>In den folgenden Abschnitten ist der Betrieb der <a href="http://uhilger.de/dev/Software/WebBox/WebBox">WebBox</a>&nbsp;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>&nbsp;</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&uuml;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&nbsp;ist die WebBox bereit zur <a href="Bedienung.htmi">Verwendung</a>.</p>
<p>Die im Aufruf oben angegebenen Ports f&uuml;r die WebBox k&ouml;nnen beliebig gew&auml;hlt werden. Das selbe gilt f&uuml;r den Port des Datenbank-Containers. F&uuml;r eine &Auml;nderung des Ports des Datenbank-Containers&nbsp;muss der ge&auml;nderte Port zus&auml;tzlich&nbsp;zum obigen Aufruf auch in der Datei <code>META-INF/context.xml</code> der Nutzerverwaltung und der Datenbankverwaltung angepasst werden.</p>
<h2><a name="stopp"></a>WebBox stoppen</h2>
<p>Zum Stoppen der WebBox werden die folgenden Schritte ausgef&uuml;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&auml;nderlichen Nutzerdaten in den Volumes&nbsp;<code>/derby-daten</code>&nbsp;und <code>/tc-daten</code>&nbsp;im Arbeitsverzeichnis ab, aus dem heraus die Docker-Container gestartet werden. Eine regelm&auml;&szlig;ige Kopie von <code>/derby-daten</code>&nbsp;und <code>/tc-daten</code> v<span style="font-size: 1em;">ermeidet Datenverlust im Falle von St&ouml;rungen oder Fehlern.</span></p>
<h3><a name="sec"></a>Datensicherheit</h3>
<p>Die WebBox bewirkt keine Zugriffsbeschr&auml;nkungen auf der Ebene des Betriebssystems, auf dem Docker l&auml;uft. Jeder Benutzer der WebBox kann so auf Inhalte des Rechners zugreifen, auf dem Docker l&auml;uft, wie es der Systemadministrator des Rechners festgelegt hat.</p>
<p>&Uuml;ber die Benutzerverwaltung der WebBox erteilte Berechtigungen bewirken lediglich Beschr&auml;nkungen des Zugriffs innerhalb der WebBox und regeln beispielsweise, welcher Benutzer die Benutzerverwaltung der WebBox oder die Dateiverwaltung der WebBox verwenden darf.</p>
<p>Mit welchen Rechten zum Beispiel aus der Dateiverwaltung der WebBox heraus auf Dateien zugegriffen werden darf, muss je nach gew&uuml;nschter Berechtigung n&ouml;tigenfalls vom Systemadministrator des Rechners, auf dem Docker l&auml;uft, konfiguriert werden.&nbsp;&nbsp;</p>
<h3>Programme</h3>
<p>Die WebBox erm&ouml;glicht die Ausf&uuml;hrung von Programmen auf dem WebBox-Container. Benutzer der WebBox k&ouml;nnen mit der WebBox Programme ausf&uuml;hren, mit denen es m&ouml;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&uuml;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&ouml;nnen die WebBox an ihre Bed&uuml;rfnisse anpassen. Informationen &uuml;ber ihren Aufbau liefert die <a href="http://uhilger.de/gitblit/docs/wbx-shell.git">Dokumentation im Repository</a>.</p>