Jan Ulrich Hasecke
2019-11-04 786c9fdad173154b8ad878ae8e3038a33377b5ed
commit | author | age
0a126d 1 ===================
JUH 2 Webspace einrichten
3 ===================
b45d72 4
JUH 5 Ihre Webanwendungen – im einfachsten Fall statische HTML-Seiten – richten Sie in dem Heimverzeichnis des jeweiligen :role:`Domain-Admin` ein.
6
7 Loggen Sie sich dazu mit Hilfe von :command:`ssh` ein:
8
9 .. code-block:: console
10
11    $ ssh xyz00-doms@xyz00.hostsharing.net
12
13 Sie erreichen alle Benutzerverzeichnisse über die Adresse des jeweiligen Pakets.
14 In unserem Beispiel ist das :file:`xyz00.hostsharing.net`.
15 Nach dem Einloggen finden Sie die im nächsten Abschnitt beschriebene Ordnerstruktur vor.
16
786c9f 17 .. _kap-einstieg-ordnerstruktur:
JUH 18
0a126d 19 Ordnerstruktur
JUH 20 ==============
21
b45d72 22 Die exemplarische Struktur des Home-Verzeichnisses eines :role:`Domain-Admin` sieht folgendermaßen aus::
0a126d 23
JUH 24     ├── doms
a59e4b 25     │   ├── hs-example.de
0a126d 26     │   │   ├── app
JUH 27     │   │   ├── app-ssl
28     │   │   ├── cgi
29     │   │   ├── cgi-ssl
30     │   │   ├── etc
a59e4b 31     │   │   │   └── pri.hs-example.de
0a126d 32     │   │   ├── fastcgi
JUH 33     │   │   │   └── phpstub
34     │   │   ├── fastcgi-ssl
35     │   │   │   └── phpstub
36     │   │   ├── htdocs
37     │   │   │   └── .htaccess
38     │   │   ├── htdocs-ssl
39     │   │   │   └── .htaccess
40     │   │   ├── subs
41     │   │   │   ├── www
42     │   │   │   │   └── index.html
43     │   │   │   └── example
44     │   │   ├── subs-ssl
45     │   │   │   └── www
46     │   │   │       └── index.html
47     │   │   └── var
48     │   └── domain2.tld
49     │       ├── app
50     │       └── …
51     ├── etc
52     │   └── config.ini
53     ├── Maildir
54     ├── procmail.log
55     ├── vacation.cache
56     └── vacation.msg
57
b45d72 58 :file:`~/doms`
JUH 59     Alle dem Domain-Admin zugewiesenen Domains liegen im Verzeichnis :file:`~/doms`.
0a126d 60
a59e4b 61 :file:`~/doms/hs-example.de`
JUH 62     ``hs-example.de`` die Beispiel-Domain, für die die Verzeichnisse von HSAdmin automatisch angelegt wurden.
b45d72 63     
a59e4b 64 :file:`~/doms/hs-example.de/app`
b45d72 65     Dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls `Phusion Passenger <https://www.phusionpassenger.com/>`_ konfiguriert. 
0a126d 66
a59e4b 67 :file:`~/doms/hs-example.de/app-ssl`
b45d72 68     Auch dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls konfiguriert.
JUH 69     Es wird für https-Zugriffe genutzt.
70     
a59e4b 71 :file:`~/doms/hs-example.de/cgi`
b45d72 72     Dies ist das Basisverzeichnis für CGI-Skripte.
a59e4b 73     Ein Alias bildet HTTP-Requests auf ``http://hs-example.de/cgi-bin/`` auf dieses Verzeichnisses ab.
b45d72 74     
a59e4b 75 :file:`~/doms/hs-example.de/cgi-ssl`
JUH 76     Analog zu :file:`~/doms/hs-example.de/cgi` ist dies das Basisverzeichnis für CGI-Skripte beim Zugriff via https.
b45d72 77     
a59e4b 78 :file:`~/doms/hs-example.de/etc`
ad994f 79     Dieses Verzeichnis enthält ggf. das Zonefile, mit dem sich der Nameserver `BIND <http://de.wikipedia.org/wiki/BIND>`_ konfigurieren lässt
0a126d 80
a59e4b 81 :file:`~/doms/hs-example.de/etc/pri.hs-example.de`
b45d72 82    Mit dieser Datei können Sie eine Zonendatei für Ihre Domain selbst verwalten. 
JUH 83    Damit können z.B. einzelne Subdomains auf andere Server umgeleitet oder eigene Mailserver angesprochen werden.
0a126d 84
a59e4b 85 :file:`~/doms/hs-example.de/fastcgi`
b45d72 86     Dies ist das Basisverzeichnis für FastCGI-Skripte.
a59e4b 87     Ein Alias bildet HTTP-Requests auf ``http://hs-example.de/fastcgi-bin/`` auf dieses Verzeichnis ab.
b45d72 88     
a59e4b 89 :file:`~/doms/hs-example.de/fastcgi-ssl`
JUH 90    Analog zu :file:`~/doms/hs-example.de/fastcgi` ist dies das Basisverzeichnis für FastCGI-Skripte bei https-Zugriffen.
91    Ein Alias bildet HTTP-Requests auf ``https://hs-example.de/fastcgi-bin/`` auf dieses Verzeichnis ab.
0a126d 92
a59e4b 93 :file:`~/doms/hs-example.de/htdocs`
b45d72 94    Dieses Verzeichnis ist als ``DocumentRoot`` des Apache Webserver konfiguriert. 
ad994f 95    Es dient auch zur Aufnahme statischer Inhalte im Zusammenhang mit der Nutzung von Phusion Passenger zur Auslieferung der statischen Dateien.
0a126d 96
a59e4b 97 :file:`~/doms/hs-example.de/htdocs/.htaccess`
b45d72 98    In der Standardkonfiguration enthält diese Datei die Weiterleitung auf die ``www``-Subdomain::
0a126d 99
a59e4b 100       Redirect permanent / http://www.hs-example.de/
0a126d 101
a59e4b 102    Die verwendeten Regeln werden auf **alle** Subdomains von ``hs-example.de`` angewendet.
b45d72 103    In der ``.htaccess`` können
0a126d 104
b45d72 105    - eigene Fehlerseiten definiert,
JUH 106    - MIME-Typen zugewiesen,
107    - Passwortschutz eingerichtet,
108    - Weiterleitungen durchgeführt werden. 
0a126d 109
a59e4b 110 :file:`~/doms/hs-example.de/htdocs-ssl`
JUH 111    Analog zu :file:`~/doms/hs-example.de/htdocs` ist dieses Verzeichnis als ``DocumentRoot`` des Apache Webserver für Zugriffe via https konfiguriert. 
b45d72 112    
a59e4b 113 :file:`~/doms/hs-example.de/subs`
b45d72 114    Dieses Verzeichnis enthält alle Subdomains.
a59e4b 115    Hier findet sich auch die Subdomain *www.hs-example.de*.
b45d72 116
a59e4b 117 :file:`~/doms/hs-example.de/subs/example`
b45d72 118    Dies ist ein Beispiel für eine Subdomain, die Sie einfach selbst anlegen können. 
ad994f 119    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.
b45d72 120
a59e4b 121 :file:`~/doms/hs-example.de/subs/www`
b45d72 122    Dieses Verzeichnis wird automatisch angelegt und üblicherweise vom Webserver angesprochen, wenn keine Subdomain explizit genannt wird. 
a59e4b 123    Die Adresse ``http://hs-example.de`` verweist üblicherweise auf ``http://www.hs-example.de``.
b45d72 124
a59e4b 125 :file:`~/doms/hs-example.de/subs-ssl`
JUH 126    Analog zu :file:`~/doms/hs-example.de/subs` enthält dieses Verzeichnis alle Subdomains auf die via https zugegriffen wird.
b45d72 127     
a59e4b 128 :file:`~/doms/hs-example.de/var`
b45d72 129    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.
0a126d 130
JUH 131 Zugangsdaten und Einstellungen
132 ==============================
133
b45d72 134 Sie können Dateien mit einem FTP-Programm wie :program:`FileZilla`, :program:`WinSCP` oder :command:`scp` in das Web-Paket kopieren.
JUH 135 Sie benötigen dazu die gleichen Zugangsdaten wie beim Einloggen via :command:`ssh`.
0a126d 136
b45d72 137 Server:
JUH 138    xyz00.hostsharing.net
0a126d 139
b45d72 140 Benutzer:
JUH 141    xyz00-doms
0a126d 142
b45d72 143 Passwort:
JUH 144    PASSWORT
0a126d 145
939940 146 .. figure:: ../images/ftp-filezilla.jpg
b45d72 147    :width: 70%
0a126d 148
b45d72 149    Eingabe der Zugangsdaten in Filezilla.
JUH 150
a59e4b 151 Wechseln Sie in den Ordner :file:`~/doms/hs-example.de/subs/www`, um zum Beispiel statische Webseiten hochzuladen.
0a126d 152
939940 153 .. figure:: ../images/ftp-filezilla-www.jpg
b45d72 154    :width: 70%
JUH 155
156    Wechsel in das Verzeichnis ``www``.
0a126d 157
ad994f 158 Auf der Kommandozeile geben Sie folgende Befehle ein:
JUH 159
160 .. code-block:: console
161
162    $ cd ~/website-dateien
a59e4b 163    $ scp -r . xyz00-doms@xyz00.hostsharing.net:/doms/hs-example.de/subs-ssl/www
ad994f 164
a59e4b 165 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.