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