Jan Ulrich Hasecke
2019-11-04 786c9fdad173154b8ad878ae8e3038a33377b5ed
source/einstieg/webspace.rst
@@ -14,19 +14,21 @@
In unserem Beispiel ist das :file:`xyz00.hostsharing.net`.
Nach dem Einloggen finden Sie die im nächsten Abschnitt beschriebene Ordnerstruktur vor.
.. _kap-einstieg-ordnerstruktur:
Ordnerstruktur
==============
Die exemplarische Struktur des Home-Verzeichnisses eines :role:`Domain-Admin` sieht folgendermaßen aus::
    ├── doms
    │   ├── domain1.tld
    │   ├── hs-example.de
    │   │   ├── app
    │   │   ├── app-ssl
    │   │   ├── cgi
    │   │   ├── cgi-ssl
    │   │   ├── etc
    │   │   │   └── pri.domain1.tld
    │   │   │   └── pri.hs-example.de
    │   │   ├── fastcgi
    │   │   │   └── phpstub
    │   │   ├── fastcgi-ssl
@@ -56,48 +58,48 @@
:file:`~/doms`
    Alle dem Domain-Admin zugewiesenen Domains liegen im Verzeichnis :file:`~/doms`.
:file:`~/doms/domain1.tld`
    ``domain1`` steht für eine beliebige Domain und ``tld`` für eine beliebige Top-Level-Domain wie ``com``, ``net``, ``org`` oder ``de``.
:file:`~/doms/hs-example.de`
    ``hs-example.de`` die Beispiel-Domain, für die die Verzeichnisse von HSAdmin automatisch angelegt wurden.
    
:file:`~/doms/domain1.tld/app`
:file:`~/doms/hs-example.de/app`
    Dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls `Phusion Passenger <https://www.phusionpassenger.com/>`_ konfiguriert. 
:file:`~/doms/domain1.tld/app-ssl`
:file:`~/doms/hs-example.de/app-ssl`
    Auch dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls konfiguriert.
    Es wird für https-Zugriffe genutzt.
    
:file:`~/doms/domain1.tld/cgi`
:file:`~/doms/hs-example.de/cgi`
    Dies ist das Basisverzeichnis für CGI-Skripte.
    Ein Alias bildet HTTP-Requests auf ``http://domain1.tld/cgi-bin/`` auf dieses Verzeichnisses ab.
    Ein Alias bildet HTTP-Requests auf ``http://hs-example.de/cgi-bin/`` auf dieses Verzeichnisses ab.
    
:file:`~/doms/domain1.tld/cgi-ssl`
    Analog zu :file:`~/doms/domain1.tld/cgi` ist dies das Basisverzeichnis für CGI-Skripte beim Zugriff via https.
:file:`~/doms/hs-example.de/cgi-ssl`
    Analog zu :file:`~/doms/hs-example.de/cgi` ist dies das Basisverzeichnis für CGI-Skripte beim Zugriff via https.
    
:file:`~/doms/domain1.tld/etc`
:file:`~/doms/hs-example.de/etc`
    Dieses Verzeichnis enthält ggf. das Zonefile, mit dem sich der Nameserver `BIND <http://de.wikipedia.org/wiki/BIND>`_ konfigurieren lässt
:file:`~/doms/domain1.tld/etc/pri.domain1.tld`
:file:`~/doms/hs-example.de/etc/pri.hs-example.de`
   Mit dieser Datei können Sie eine Zonendatei für Ihre Domain selbst verwalten. 
   Damit können z.B. einzelne Subdomains auf andere Server umgeleitet oder eigene Mailserver angesprochen werden.
:file:`~/doms/domain1.tld/fastcgi`
:file:`~/doms/hs-example.de/fastcgi`
    Dies ist das Basisverzeichnis für FastCGI-Skripte.
    Ein Alias bildet HTTP-Requests auf ``http://domain1.tld/fastcgi-bin/`` auf dieses Verzeichnis ab.
    Ein Alias bildet HTTP-Requests auf ``http://hs-example.de/fastcgi-bin/`` auf dieses Verzeichnis ab.
    
:file:`~/doms/domain1.tld/fastcgi-ssl`
   Analog zu :file:`~/doms/domain1.tld/fastcgi` ist dies das Basisverzeichnis für FastCGI-Skripte bei https-Zugriffen.
   Ein Alias bildet HTTP-Requests auf ``https://domain1.tld/fastcgi-bin/`` auf dieses Verzeichnis ab.
:file:`~/doms/hs-example.de/fastcgi-ssl`
   Analog zu :file:`~/doms/hs-example.de/fastcgi` ist dies das Basisverzeichnis für FastCGI-Skripte bei https-Zugriffen.
   Ein Alias bildet HTTP-Requests auf ``https://hs-example.de/fastcgi-bin/`` auf dieses Verzeichnis ab.
:file:`~/doms/domain1.tld/htdocs`
:file:`~/doms/hs-example.de/htdocs`
   Dieses Verzeichnis ist als ``DocumentRoot`` des Apache Webserver konfiguriert. 
   Es dient auch zur Aufnahme statischer Inhalte im Zusammenhang mit der Nutzung von Phusion Passenger zur Auslieferung der statischen Dateien.
:file:`~/doms/domain1.tld/htdocs/.htaccess`
:file:`~/doms/hs-example.de/htdocs/.htaccess`
   In der Standardkonfiguration enthält diese Datei die Weiterleitung auf die ``www``-Subdomain::
      Redirect permanent / http://www.domain1.tld/
      Redirect permanent / http://www.hs-example.de/
   Die verwendeten Regeln werden auf **alle** Subdomains von ``domain1.tld`` angewendet.
   Die verwendeten Regeln werden auf **alle** Subdomains von ``hs-example.de`` angewendet.
   In der ``.htaccess`` können
   - eigene Fehlerseiten definiert,
@@ -105,25 +107,25 @@
   - Passwortschutz eingerichtet,
   - Weiterleitungen durchgeführt werden. 
:file:`~/doms/domain1.tld/htdocs-ssl`
   Analog zu :file:`~/doms/domain1.tld/htdocs` ist dieses Verzeichnis als ``DocumentRoot`` des Apache Webserver für Zugriffe via https konfiguriert.
:file:`~/doms/hs-example.de/htdocs-ssl`
   Analog zu :file:`~/doms/hs-example.de/htdocs` ist dieses Verzeichnis als ``DocumentRoot`` des Apache Webserver für Zugriffe via https konfiguriert.
   
:file:`~/doms/domain1.tld/subs`
:file:`~/doms/hs-example.de/subs`
   Dieses Verzeichnis enthält alle Subdomains.
   Hier findet sich auch die Subdomain *www.domain1.tld*.
   Hier findet sich auch die Subdomain *www.hs-example.de*.
:file:`~/doms/domain1.tld/subs/example`
:file:`~/doms/hs-example.de/subs/example`
   Dies ist ein Beispiel für eine Subdomain, die Sie einfach selbst anlegen können. 
   Sie müssen hierzu nur im  Verzeichnis :file:`subs` ein Verzeichnis mit dem Namen der gewünschten Subdomain anlegen und anschließend die Dateien in das Verzeichnis übertragen.
:file:`~/doms/domain1.tld/subs/www`
:file:`~/doms/hs-example.de/subs/www`
   Dieses Verzeichnis wird automatisch angelegt und üblicherweise vom Webserver angesprochen, wenn keine Subdomain explizit genannt wird. 
   Die Adresse ``http://domain1.tld`` verweist üblicherweise auf ``http://www.domain1.tld``.
   Die Adresse ``http://hs-example.de`` verweist üblicherweise auf ``http://www.hs-example.de``.
:file:`~/doms/domain1.tld/subs-ssl`
   Analog zu :file:`~/doms/domain1.tld/subs` enthält dieses Verzeichnis alle Subdomains auf die via https zugegriffen wird.
:file:`~/doms/hs-example.de/subs-ssl`
   Analog zu :file:`~/doms/hs-example.de/subs` enthält dieses Verzeichnis alle Subdomains auf die via https zugegriffen wird.
    
:file:`~/doms/domain1.tld/var`
:file:`~/doms/hs-example.de/var`
   In diesem Verzeichnis werden in der Nacht die Log-Dateien mit den Zugriffen auf die Domain in gepackter Form bereitgestellt, wenn dies in ``/home/pacs/xyz00/etc/config.ini``entsprechend angegeben ist.
Zugangsdaten und Einstellungen
@@ -146,7 +148,7 @@
   Eingabe der Zugangsdaten in Filezilla.
Wechseln Sie in den Ordner :file:`~/doms/domain1.tld/subs/www`, um zum Beispiel statische Webseiten hochzuladen.
Wechseln Sie in den Ordner :file:`~/doms/hs-example.de/subs/www`, um zum Beispiel statische Webseiten hochzuladen.
.. figure:: ../images/ftp-filezilla-www.jpg
   :width: 70%
@@ -158,6 +160,6 @@
.. code-block:: console
   $ cd ~/website-dateien
   $ scp -r . xyz00-doms@xyz00.hostsharing.net:/doms/domain1.tld/subs-ssl/www
   $ scp -r . xyz00-doms@xyz00.hostsharing.net:/doms/hs-example.de/subs-ssl/www
Die Dateien in dem lokalen Ordner :file:`website-dateien` werden dadurch rekursiv in das Verzeichnis :file:`~/doms/domain1.tld/subs-ssl/www` des Domain-Admin kopiert.
Die Dateien in dem lokalen Ordner :file:`website-dateien` werden dadurch rekursiv in das Verzeichnis :file:`~/doms/hs-example.de/subs-ssl/www` des Domain-Admin kopiert.