Peter Hormanns
2019-11-08 d1861ddc435f287a3de577346a02611c790baaba
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
d1861d 57     
PH 58 -- Warum sind die Dateien procmail.log, vacation.cache und vacation.msg hier gelistet?
59 -- Bitte herausnehmen (ph)
0a126d 60
b45d72 61 :file:`~/doms`
JUH 62     Alle dem Domain-Admin zugewiesenen Domains liegen im Verzeichnis :file:`~/doms`.
0a126d 63
a59e4b 64 :file:`~/doms/hs-example.de`
JUH 65     ``hs-example.de`` die Beispiel-Domain, für die die Verzeichnisse von HSAdmin automatisch angelegt wurden.
b45d72 66     
a59e4b 67 :file:`~/doms/hs-example.de/app`
b45d72 68     Dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls `Phusion Passenger <https://www.phusionpassenger.com/>`_ konfiguriert. 
0a126d 69
a59e4b 70 :file:`~/doms/hs-example.de/app-ssl`
b45d72 71     Auch dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls konfiguriert.
JUH 72     Es wird für https-Zugriffe genutzt.
73     
a59e4b 74 :file:`~/doms/hs-example.de/cgi`
b45d72 75     Dies ist das Basisverzeichnis für CGI-Skripte.
a59e4b 76     Ein Alias bildet HTTP-Requests auf ``http://hs-example.de/cgi-bin/`` auf dieses Verzeichnisses ab.
b45d72 77     
a59e4b 78 :file:`~/doms/hs-example.de/cgi-ssl`
JUH 79     Analog zu :file:`~/doms/hs-example.de/cgi` ist dies das Basisverzeichnis für CGI-Skripte beim Zugriff via https.
b45d72 80     
a59e4b 81 :file:`~/doms/hs-example.de/etc`
ad994f 82     Dieses Verzeichnis enthält ggf. das Zonefile, mit dem sich der Nameserver `BIND <http://de.wikipedia.org/wiki/BIND>`_ konfigurieren lässt
0a126d 83
a59e4b 84 :file:`~/doms/hs-example.de/etc/pri.hs-example.de`
b45d72 85    Mit dieser Datei können Sie eine Zonendatei für Ihre Domain selbst verwalten. 
JUH 86    Damit können z.B. einzelne Subdomains auf andere Server umgeleitet oder eigene Mailserver angesprochen werden.
0a126d 87
a59e4b 88 :file:`~/doms/hs-example.de/fastcgi`
b45d72 89     Dies ist das Basisverzeichnis für FastCGI-Skripte.
a59e4b 90     Ein Alias bildet HTTP-Requests auf ``http://hs-example.de/fastcgi-bin/`` auf dieses Verzeichnis ab.
b45d72 91     
a59e4b 92 :file:`~/doms/hs-example.de/fastcgi-ssl`
JUH 93    Analog zu :file:`~/doms/hs-example.de/fastcgi` ist dies das Basisverzeichnis für FastCGI-Skripte bei https-Zugriffen.
94    Ein Alias bildet HTTP-Requests auf ``https://hs-example.de/fastcgi-bin/`` auf dieses Verzeichnis ab.
0a126d 95
a59e4b 96 :file:`~/doms/hs-example.de/htdocs`
b45d72 97    Dieses Verzeichnis ist als ``DocumentRoot`` des Apache Webserver konfiguriert. 
ad994f 98    Es dient auch zur Aufnahme statischer Inhalte im Zusammenhang mit der Nutzung von Phusion Passenger zur Auslieferung der statischen Dateien.
0a126d 99
a59e4b 100 :file:`~/doms/hs-example.de/htdocs/.htaccess`
b45d72 101    In der Standardkonfiguration enthält diese Datei die Weiterleitung auf die ``www``-Subdomain::
0a126d 102
a59e4b 103       Redirect permanent / http://www.hs-example.de/
0a126d 104
a59e4b 105    Die verwendeten Regeln werden auf **alle** Subdomains von ``hs-example.de`` angewendet.
b45d72 106    In der ``.htaccess`` können
0a126d 107
b45d72 108    - eigene Fehlerseiten definiert,
JUH 109    - MIME-Typen zugewiesen,
110    - Passwortschutz eingerichtet,
111    - Weiterleitungen durchgeführt werden. 
0a126d 112
a59e4b 113 :file:`~/doms/hs-example.de/htdocs-ssl`
JUH 114    Analog zu :file:`~/doms/hs-example.de/htdocs` ist dieses Verzeichnis als ``DocumentRoot`` des Apache Webserver für Zugriffe via https konfiguriert. 
b45d72 115    
a59e4b 116 :file:`~/doms/hs-example.de/subs`
b45d72 117    Dieses Verzeichnis enthält alle Subdomains.
a59e4b 118    Hier findet sich auch die Subdomain *www.hs-example.de*.
b45d72 119
a59e4b 120 :file:`~/doms/hs-example.de/subs/example`
b45d72 121    Dies ist ein Beispiel für eine Subdomain, die Sie einfach selbst anlegen können. 
ad994f 122    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 123
a59e4b 124 :file:`~/doms/hs-example.de/subs/www`
b45d72 125    Dieses Verzeichnis wird automatisch angelegt und üblicherweise vom Webserver angesprochen, wenn keine Subdomain explizit genannt wird. 
a59e4b 126    Die Adresse ``http://hs-example.de`` verweist üblicherweise auf ``http://www.hs-example.de``.
b45d72 127
a59e4b 128 :file:`~/doms/hs-example.de/subs-ssl`
JUH 129    Analog zu :file:`~/doms/hs-example.de/subs` enthält dieses Verzeichnis alle Subdomains auf die via https zugegriffen wird.
b45d72 130     
a59e4b 131 :file:`~/doms/hs-example.de/var`
b45d72 132    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 133
JUH 134 Zugangsdaten und Einstellungen
135 ==============================
136
b45d72 137 Sie können Dateien mit einem FTP-Programm wie :program:`FileZilla`, :program:`WinSCP` oder :command:`scp` in das Web-Paket kopieren.
JUH 138 Sie benötigen dazu die gleichen Zugangsdaten wie beim Einloggen via :command:`ssh`.
0a126d 139
b45d72 140 Server:
JUH 141    xyz00.hostsharing.net
0a126d 142
b45d72 143 Benutzer:
JUH 144    xyz00-doms
0a126d 145
b45d72 146 Passwort:
JUH 147    PASSWORT
0a126d 148
939940 149 .. figure:: ../images/ftp-filezilla.jpg
b45d72 150    :width: 70%
0a126d 151
b45d72 152    Eingabe der Zugangsdaten in Filezilla.
JUH 153
a59e4b 154 Wechseln Sie in den Ordner :file:`~/doms/hs-example.de/subs/www`, um zum Beispiel statische Webseiten hochzuladen.
0a126d 155
939940 156 .. figure:: ../images/ftp-filezilla-www.jpg
b45d72 157    :width: 70%
JUH 158
159    Wechsel in das Verzeichnis ``www``.
0a126d 160
ad994f 161 Auf der Kommandozeile geben Sie folgende Befehle ein:
JUH 162
163 .. code-block:: console
164
165    $ cd ~/website-dateien
a59e4b 166    $ scp -r . xyz00-doms@xyz00.hostsharing.net:/doms/hs-example.de/subs-ssl/www
ad994f 167
d1861d 168 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.