Jan Ulrich Hasecke
2019-12-13 e050b737b4c6cde95282e61d13e79114ca9031cd
Ergänzende Sätze für Beispiele
7 files modified
94 ■■■■■ changed files
source/referenz/domain/domain-optionen.rst 4 ●●● patch | view | raw | blame | history
source/referenz/hsadmin/domain.rst 14 ●●●●● patch | view | raw | blame | history
source/referenz/hsadmin/mysqldb.rst 14 ●●●●● patch | view | raw | blame | history
source/referenz/hsadmin/mysqluser.rst 14 ●●●●● patch | view | raw | blame | history
source/referenz/hsadmin/postgresqldb.rst 11 ●●●●● patch | view | raw | blame | history
source/referenz/hsadmin/postgresqluser.rst 20 ●●●●● patch | view | raw | blame | history
source/referenz/hsadmin/user.rst 17 ●●●●● patch | view | raw | blame | history
source/referenz/domain/domain-optionen.rst
@@ -15,9 +15,7 @@
Multiviews
   Wenn diese Option eingeschaltet ist, berücksichtigt der Webserver Browsereinstellungen und kann je nachdem unterschiedliche Dateien ausliefern.
   Die Möglichkeiten sind in der Dokumentation zu mod_mime_ und mod_negotiation_ beschrieben.
.. _mod_mime: http://httpd.apache.org/docs/current/mod/mod_autoindex.html
   Die Möglichkeiten sind in der Dokumentation zu `mod_mime <http://httpd.apache.org/docs/current/mod/mod_autoindex.html>`_ und mod_negotiation_ beschrieben.
.. _mod_negotiation: http://httpd.apache.org/docs/current/mod/mod_negotiation.html
source/referenz/hsadmin/domain.rst
@@ -62,16 +62,28 @@
Beispiele
=========
Mit dem folgenden Befehl schalten wir die Domain ``hs-example.de`` auf und ordnen Sie dem Domain-Admin ``xyz00-hsexample`` zu.
.. code-block:: console
    xyz00@hsadmin> domain.add({set:{name:'hs-example.de',user:'xyz00-hsexample'}})
Mit dem Befehl :option:`domain.search` werden alle Informationen zu einer Domain angezeigt.
Die gesuchte Domain wird mit dem Befehlsausdruck ``where`` ausgewählt.
.. code-block:: console
    xyz00@hsadmin> domain.search({where:{name:'hs-example.de'}})
Und mit dem Befehl :option:`domain.remove` können wir eine Domain entfernen.
.. code-block:: console
    xyz00@hsadmin> domain.remove({where:{name:'hs-example.de'}})
Achtung: bei einer Änderung der Domain-Optionen müssen immer alle Optionen angegeben werden, die gesetzt sein sollen!
Mit dem Befehl :option:`domain.update` lassen sich die Einstellungen für eine Domain verändern.
Bei einer Änderung der Domain-Optionen, wie im folgenden Beispiel, müssen immer alle Optionen angegeben werden, die gesetzt sein sollen, da der Befehl die bereits gesetzten Domain-Optionen komplett überschreibt.
.. code-block:: console
source/referenz/hsadmin/mysqldb.rst
@@ -42,9 +42,23 @@
Beispiele
=========
Im ersten Beispiel erzeugen wir eine Datenbank mit dem Namen ``xyz00_abc`` und legen als Besitzer den Datenbanknutzer ``xyz00_owner`` fest.
.. code-block:: console
    xyz00@hsadmin> mysqldb.add ({set:{name:'xyz00_abc',owner:'xyz00_owner'}})
Bevor man Änderungen an einem Datensatz vornimmt, kann man sich alle Eigenschaften einer Datenbank mit dem Befehl :option:`mysqldb.search` anzeigen lassen.
Die gewünschte Datenbank wird mit dem Befehlsausdruck ``where`` ausgewählt.
.. code-block:: console
    xyz00@hsadmin> mysqldb.search ({where:{name:'xyz00_abc'}})
Und mit dem Befehl :option:`mysqldb.remove` können Datenbanken gelöscht werden.
Die gewünschte Datenbank wird erneut mit dem Befehlsausdruck ``where`` ausgewählt.
.. code-block:: console
    xyz00@hsadmin> mysqldb.remove ({where:{name:'xyz00_abc'}})
source/referenz/hsadmin/mysqluser.rst
@@ -43,10 +43,24 @@
Beispiele
=========
Im ersten Beispiel fügen wir dem System den Datenbank-Benutzer ``xyz00_owner`` hinzu und geben ihm ein Passwort.
.. code-block:: console
    xyz00@hsadmin> mysqluser.add({set:{name:'xyz00_owner',password:'!1?2-3aBc'}})
In den folgenden beiden Beispielen lassen wir uns zunächst mit dem Befehl :option:`mysqluser.search` die Informationen zu einem Benutzer anzeigen, den wir mit dem Befehlsausdruck ``where`` auswählen.
Anschließend entfernen wir diesen Nutzer mit dem Befehl :option:`mysqluser.remove`.
.. code-block:: console
    xyz00@hsadmin> mysqluser.search({where:{name:'xyz00_owner'}})
    xyz00@hsadmin> mysqluser.remove({where:{name:'xyz00_owner'}})
Im letzten Beispiel aktualieren wir einen Benutzereintrag mit dem Befehl :option:`mysqluser.update`.
Der Benutzer wird mit ``where`` ausgesucht, anschließend bekommt er mit ``set`` ein neues Passwort.
.. code-block:: console
    xyz00@hsadmin> mysqluser.update({where:{name:'xyz00_owner'},set:{password:'neues-passwort'}})
 
source/referenz/hsadmin/postgresqldb.rst
@@ -40,10 +40,19 @@
   Zeichensatz der Datenbank (Standard ist UTF-8)
Beispiel:
Beispiele
=========
Im ersten Beispiel erzeugen wir die Datenbank ``xyz00_abc`` und übergeben ihr als Besitzer den Datenbanknutzer ``xyz00_owner``.
.. code-block:: console
    xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_abc',owner:'xyz00_owner'}})
Die den beiden folgenden Beispielen lassen wir uns zunächst mit :option:`postgresqldb.search` Informationen zur Datenbank ``xyz00_abc`` anzeigen.
Anschließend löschen wir sie mit :option:`postgresqldb.remove`.
.. code-block:: console
    xyz00@hsadmin> postgresqldb.search({where:{name:'xyz00_abc'}})
    xyz00@hsadmin> postgresqldb.remove({where:{name:'xyz00_abc'}})
source/referenz/hsadmin/postgresqluser.rst
@@ -43,14 +43,32 @@
Beispiele
=========
Im ersten Beispiel fügen wir dem System den Datenbank-Benutzer ``xyz00_owner`` hinzu und geben ihm ein Passwort.
.. code-block:: console
    xyz00@hsadmin> postgresqluser.add ({set:{name:'xyz00_owner',password:'!1?2-3aBc'}})
 
weitere Beispiele:
Mit :option:`postgresqluser.search` können wir die Eigenschaften eines Benutzers anzeigen.
Der gewünschte Benutzer wird mit ``where`` ausgewählt.
 
.. code-block:: console
    xyz00@hsadmin> postgresqluser.search ({where:{name:'xyz00_owner'}})
Mit :option:`postgresqluser.update` können Eigenschaften eines Benutzers verändert werden.
Der gewünschte Benutzer wird mit ``where`` ausgewählt.
Anschliend wird in unserem Beispiel mit ``set`` ein neues Passwort gesetzt.
.. code-block:: console
    xyz00@hsadmin> postgresqluser.update ({where:{name:'xyz00_owner'},set:{password:'neues-passwort'}})
Und zuletzt können Datenbank-Benutzer auch wieder gelöscht werden.
Dazu benutzen wir den Befehl :option:`postgresqluser.remove`.
Der zu löschende Benutzer wird mit ``where`` ausgewählt.
.. code-block:: console
    xyz00@hsadmin> postgresqluser.remove ({where:{name:'xyz00_owner'}})
source/referenz/hsadmin/user.rst
@@ -61,11 +61,28 @@
    xyz00@hsadmin> user.add ({set:{name:'xyz00-mustermann',comment:'Max Mustermann',password:'!1?2-3aBc',shell:'/bin/bash'}})
Man kann alle Informationen zu einem Nutzer abfragen:
.. code-block:: console
    xyz00@hsadmin> user.search ({where:{name:'xyz00-mustermann'}})
Einstellungen können nachträglich verändert werden.
Dafür wird der Befehl :option:`user.update` benutzt.
Im Befehlsausdruck wird zunächst mit ``where`` nach einem Datensatz gesucht, auf den mit ``set`` die Veränderung angewendet wird.
Im ersten Beispiel wird für den Benutzer ``xyz00-mustermann`` ein neues Passwort gesetzt.
Im zweiten Beispiel bekommt der Benutzer eine andere Shell zugewiesen und im dritten wird ein Quota gesetzt.
.. code-block:: console
    xyz00@hsadmin> user.update ({where:{name:'xyz00-mustermann'},set:{password:'neues-passwort'}})
    xyz00@hsadmin> user.update ({where:{name:'xyz00-mustermann'},set:{shell:'/bin/zsh'}})
    xyz00@hsadmin> user.update ({where:{name:'xyz00-mustermann'},set:{quota_softlimit:'50',quota_hardlimit:'75'}})
Natürlich können wir Benutzer mit Hilfe des Kommandozeilen-Tools auch wieder entfernen.
Im folgenden Beispiel wird der Benutzer ``xyz00-mustermann`` mit dem Befehl :option:`user.remove` gelöscht.
.. code-block:: console
    xyz00@hsadmin> user.remove ({where:{name:'xyz00-mustermann'}})