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