Hostsharing Wiki - Benutzerbeiträge [de]

Diskussion:TYPO3 Neos installieren

2014-11-25T16:28:30Z

Hsh00-mhi: /* Warum nicht einfach so? */

== Warum ist die Seite als Baustelle markiert? ==
Die Seite wurde als Baustelle markiert, da sie noch einige mit "'''TODO:'''" markierte Textstellen enthält.
An diesen Stellen ist Hostsharing-spezifisches Fachwissen nötig, um die Seite "rund" zu machen.
Zusätzlich steht noch ein "proof-of-concept" aus, der die Anleitung 1:1 nachgespielt und zu einer funktionierenden TYPO3 Neos Installation in einem shared Hosting Paket geführt hat. Das Feedback aus einem solchen replay sollte wieder in diese HS-Wiki-Seite mit einfließen (Was war nicht/nicht genau genug/falsch beschrieben).

=== Feedback: Was bisher nicht beschrieben ist ===

*

=== Feedback: Was bisher nicht genau genug beschrieben ist ===

*

=== Feedback: Was bisher falsch beschrieben ist ===

*

== Quellenangaben & Dank ==

Die Inhalte dieser HS-Wiki-Seite wurden aus verschiedenen Quellen - auch den Mailinglisten - zusammengetragen.

Teile der Seite zur Installation von TYPO3 Neos sind aus dem [http://www.typovision.de/fileadmin/slides/TYPO3-Neos-Das-Kompendium-Patrick-Lobacher-typovision-20130818.pdf Neos-Kompendium] von Patrick Lobacher (Typovision GmbH) entnommen und wurden auf die Besonderheiten bei Hostsharing angepasst.

'''Zu dieser HS-Wiki-Seite haben unter anderem inhaltlich beigetragen:'''

* Peter Hormanns
* Stefano Kowalke
* ...

'''Vielen Dank!'''

== Warum nicht einfach so? ==

<pre>
1. Domain-Admin anlegen
2. Domain schalten
3. MySQL-DB-User anlegen
4. MySQL-DB anlegen
5. Als Domain-Admin einloggen
6. TYPO3 Neos zip (oder tar.gz) herunterladen und auspacken (unterhalb von $HOME)
7. subs(-ssl)/www oder htdocs(-ssl) löschen und durch Symlink auf Web im entpackten Archiv ersetzen
8. webbasierten Installer ausführen
</pre> --[[Benutzer:Hsh00-mhi|Hsh00-mhi]] ([[Benutzer Diskussion:Hsh00-mhi|Diskussion]]) 17:28, 25. Nov. 2014 (CET)--[[Benutzer:Hsh00-mhi|Hsh00-mhi]] ([[Benutzer Diskussion:Hsh00-mhi|Diskussion]]) 17:28, 25. Nov. 2014 (CET)

Diskussion:TYPO3 Neos installieren

2014-11-25T16:28:09Z

Hsh00-mhi: /* Warum nicht einfach so? */

Diskussion:TYPO3 Neos installieren

2014-11-25T16:27:27Z

Hsh00-mhi: Neuer Abschnitt /* Warum nicht einfach so? */

== Warum ist die Seite als Baustelle markiert? ==
Die Seite wurde als Baustelle markiert, da sie noch einige mit "'''TODO:'''" markierte Textstellen enthält.
An diesen Stellen ist Hostsharing-spezifisches Fachwissen nötig, um die Seite "rund" zu machen.
Zusätzlich steht noch ein "proof-of-concept" aus, der die Anleitung 1:1 nachgespielt und zu einer funktionierenden TYPO3 Neos Installation in einem shared Hosting Paket geführt hat. Das Feedback aus einem solchen replay sollte wieder in diese HS-Wiki-Seite mit einfließen (Was war nicht/nicht genau genug/falsch beschrieben).

=== Feedback: Was bisher nicht beschrieben ist ===

*

=== Feedback: Was bisher nicht genau genug beschrieben ist ===

*

=== Feedback: Was bisher falsch beschrieben ist ===

*

== Quellenangaben & Dank ==

Die Inhalte dieser HS-Wiki-Seite wurden aus verschiedenen Quellen - auch den Mailinglisten - zusammengetragen.

Teile der Seite zur Installation von TYPO3 Neos sind aus dem [http://www.typovision.de/fileadmin/slides/TYPO3-Neos-Das-Kompendium-Patrick-Lobacher-typovision-20130818.pdf Neos-Kompendium] von Patrick Lobacher (Typovision GmbH) entnommen und wurden auf die Besonderheiten bei Hostsharing angepasst.

'''Zu dieser HS-Wiki-Seite haben unter anderem inhaltlich beigetragen:'''

* Peter Hormanns
* Stefano Kowalke
* ...

'''Vielen Dank!'''

== Warum nicht einfach so? ==

1. Domain-Admin anlegen
2. Domain schalten
3. MySQL-DB-User anlegen
4. MySQL-DB anlegen
5. Als Domain-Admin einloggen
6. TYPO3 Neos zip (oder tar.gz) herunterladen und auspacken (unterhalb von $HOME)
7. subs(-ssl)/www oder htdocs(-ssl) löschen und durch Symlink auf Web im entpackten Archiv ersetzen
8. webbasierten Installer ausführen

SSH-Hostkeys

2014-04-08T18:40:11Z

Hsh00-mhi: /* Die SSH-Hostkeys der HS-Server */

== Die SSH-Hostkeys der HS-Server ==

<code>
4096 a6:2c:72:63:33:b1:a9:70:ae:25:11:8b:58:f4:e4:5d root@h01.hostsharing.net (RSA)
4096 6a:c7:ba:62:30:49:b1:e3:e6:ed:2e:07:93:96:b2:87 root@h02.hostsharing.net (RSA)
4096 74:fd:ed:29:64:d9:74:c8:1a:a7:0a:40:27:a9:6d:78 root@h03.hostsharing.net (RSA)
4096 3e:6e:3e:55:f3:59:18:da:f9:a9:43:0b:f2:b1:d5:77 root@h04.hostsharing.net (RSA)
4096 d1:da:1c:77:2a:f9:de:55:8a:2f:62:17:43:67:2d:7a root@h05.hostsharing.net (RSA)
4096 36:fa:b7:98:1f:ee:eb:dd:85:72:35:c6:4f:46:6c:21 root@h06.hostsharing.net (RSA)
4096 1a:3d:b8:6d:df:2d:d0:1c:cc:63:e5:3a:bd:e3:60:81 root@h07.hostsharing.net (RSA)
4096 38:f3:58:5d:af:e8:43:08:90:76:83:e7:ea:4e:21:ae root@h08.hostsharing.net (RSA)
4096 2a:fe:5f:2f:fe:16:8c:2f:59:00:3d:7c:96:d0:84:6c root@h50.hostsharing.net (RSA)
4096 5e:77:0d:53:fb:f7:b6:53:47:c2:1e:d8:22:3f:8a:02 root@h51.hostsharing.net (RSA)
4096 d6:5c:f5:82:80:89:c0:89:5d:11:19:4c:a9:8b:a7:94 root@h53.hostsharing.net (RSA)
4096 46:c6:72:fd:1b:ce:49:9e:25:0a:81:42:d1:7d:a4:5c root@h54.hostsharing.net (RSA)
4096 38:1f:da:de:fb:ce:c9:d2:39:41:01:03:82:67:be:c3 root@h59.hostsharing.net (RSA)
4096 a5:ea:e0:ee:09:14:52:15:b8:4b:ef:87:53:bb:26:d0 root@h60.hostsharing.net (RSA)
4096 e3:9c:f9:19:25:6e:86:4d:6e:88:6c:ef:33:19:e8:bc root@h61.hostsharing.net (RSA)
4096 10:fd:8c:6e:7c:f7:9a:bb:66:4d:ca:86:c0:55:2b:79 root@h62.hostsharing.net (RSA)
4096 af:c4:26:6e:13:c8:3b:29:ba:9a:1e:86:79:55:21:0e root@h63.hostsharing.net (RSA)
4096 ad:07:7a:7f:b0:4e:77:2a:6a:8b:b6:d1:cc:cd:b6:ec root@h64.hostsharing.net (RSA)
4096 94:ad:e6:a2:0e:8e:8a:d3:76:bb:73:2a:b6:fb:3b:4b root@h67.hostsharing.net (RSA)
4096 e0:86:45:80:0a:f7:07:0e:ec:31:b4:63:68:7d:9b:fd root@h68.hostsharing.net (RSA)
4096 b7:b7:a8:3b:38:05:bc:a0:c8:27:44:b8:27:a2:82:ab root@h70.hostsharing.net (RSA)
4096 52:ca:ea:c2:64:08:48:ad:18:cf:52:c7:58:8f:66:6f root@h71.hostsharing.net (RSA)
4096 9b:f8:ef:3f:d8:5b:fc:79:54:d4:92:d6:73:56:3a:e3 root@h72.hostsharing.net (RSA)
4096 31:48:37:a3:c2:9d:6f:f1:59:bf:49:93:a9:4f:ec:2f root@h73.hostsharing.net (RSA)
4096 fe:a7:4e:a1:fb:93:06:c3:c2:c2:f8:4b:cc:d5:5a:0b root@h74.hostsharing.net (RSA)
4096 bc:b0:16:e2:3b:84:26:31:20:a9:70:ed:28:7d:63:66 root@h75.hostsharing.net (RSA)
4096 5f:a2:eb:63:e4:46:37:7a:a0:a8:e1:11:62:18:03:6b root@h76.hostsharing.net (RSA)
4096 3b:ea:b3:67:6e:82:6f:1f:c3:4a:fd:a4:96:1e:e7:40 root@h80.hostsharing.net (RSA)
4096 6b:84:bf:cf:67:7e:2d:29:45:08:56:3c:fe:93:58:02 root@h81.hostsharing.net (RSA)
4096 30:f3:9c:5a:35:8e:0a:5c:10:3e:39:a1:8d:62:95:db root@h82.hostsharing.net (RSA)
4096 e4:08:d0:1c:bf:ef:8b:f2:3e:9d:17:fe:2e:22:c0:67 root@h83.hostsharing.net (RSA)
4096 a1:83:80:83:cc:b0:72:61:4f:99:7f:66:30:2b:ce:82 root@h84.hostsharing.net (RSA)
4096 d0:8f:db:a3:a7:2b:b0:80:1f:9f:5e:c4:fd:e8:c2:76 root@h85.hostsharing.net (RSA)
4096 1c:44:bf:c4:4c:10:a1:0e:b6:c4:80:45:25:2f:79:63 root@h86.hostsharing.net (RSA)
4096 10:9b:f8:a4:c6:7c:09:92:48:ea:f9:b0:a4:de:10:b2 root@h87.hostsharing.net (RSA)
4096 0f:ac:d7:22:98:a4:68:1a:ac:82:bd:50:9d:6e:36:37 root@h88.hostsharing.net (RSA)
4096 88:38:cc:06:66:fa:c2:f8:66:47:6d:96:97:11:79:ae root@h89.hostsharing.net (RSA)
4096 a0:4e:72:00:1b:53:87:67:55:30:80:d0:6a:cf:c1:a9 root@h97.hostsharing.net (RSA)
4096 0c:e7:83:9c:7a:ee:db:cc:4f:32:f7:1f:2a:fa:62:53 root@h98.hostsharing.net (RSA)
</code>

----
[[Kategorie:HSDoku]]
[[Kategorie:ToDo-Kerndoku]]

SSH-Hostkeys

2014-04-08T18:39:53Z

Hsh00-mhi: /* Die SSH-Hostkeys der HS-Server */

== Die SSH-Hostkeys der HS-Server ==

<code>

4096 a6:2c:72:63:33:b1:a9:70:ae:25:11:8b:58:f4:e4:5d root@h01.hostsharing.net (RSA)
4096 6a:c7:ba:62:30:49:b1:e3:e6:ed:2e:07:93:96:b2:87 root@h02.hostsharing.net (RSA)
4096 74:fd:ed:29:64:d9:74:c8:1a:a7:0a:40:27:a9:6d:78 root@h03.hostsharing.net (RSA)
4096 3e:6e:3e:55:f3:59:18:da:f9:a9:43:0b:f2:b1:d5:77 root@h04.hostsharing.net (RSA)
4096 d1:da:1c:77:2a:f9:de:55:8a:2f:62:17:43:67:2d:7a root@h05.hostsharing.net (RSA)
4096 36:fa:b7:98:1f:ee:eb:dd:85:72:35:c6:4f:46:6c:21 root@h06.hostsharing.net (RSA)
4096 1a:3d:b8:6d:df:2d:d0:1c:cc:63:e5:3a:bd:e3:60:81 root@h07.hostsharing.net (RSA)
4096 38:f3:58:5d:af:e8:43:08:90:76:83:e7:ea:4e:21:ae root@h08.hostsharing.net (RSA)
4096 2a:fe:5f:2f:fe:16:8c:2f:59:00:3d:7c:96:d0:84:6c root@h50.hostsharing.net (RSA)
4096 5e:77:0d:53:fb:f7:b6:53:47:c2:1e:d8:22:3f:8a:02 root@h51.hostsharing.net (RSA)
4096 d6:5c:f5:82:80:89:c0:89:5d:11:19:4c:a9:8b:a7:94 root@h53.hostsharing.net (RSA)
4096 46:c6:72:fd:1b:ce:49:9e:25:0a:81:42:d1:7d:a4:5c root@h54.hostsharing.net (RSA)
4096 38:1f:da:de:fb:ce:c9:d2:39:41:01:03:82:67:be:c3 root@h59.hostsharing.net (RSA)
4096 a5:ea:e0:ee:09:14:52:15:b8:4b:ef:87:53:bb:26:d0 root@h60.hostsharing.net (RSA)
4096 e3:9c:f9:19:25:6e:86:4d:6e:88:6c:ef:33:19:e8:bc root@h61.hostsharing.net (RSA)
4096 10:fd:8c:6e:7c:f7:9a:bb:66:4d:ca:86:c0:55:2b:79 root@h62.hostsharing.net (RSA)
4096 af:c4:26:6e:13:c8:3b:29:ba:9a:1e:86:79:55:21:0e root@h63.hostsharing.net (RSA)
4096 ad:07:7a:7f:b0:4e:77:2a:6a:8b:b6:d1:cc:cd:b6:ec root@h64.hostsharing.net (RSA)
4096 94:ad:e6:a2:0e:8e:8a:d3:76:bb:73:2a:b6:fb:3b:4b root@h67.hostsharing.net (RSA)
4096 e0:86:45:80:0a:f7:07:0e:ec:31:b4:63:68:7d:9b:fd root@h68.hostsharing.net (RSA)
4096 b7:b7:a8:3b:38:05:bc:a0:c8:27:44:b8:27:a2:82:ab root@h70.hostsharing.net (RSA)
4096 52:ca:ea:c2:64:08:48:ad:18:cf:52:c7:58:8f:66:6f root@h71.hostsharing.net (RSA)
4096 9b:f8:ef:3f:d8:5b:fc:79:54:d4:92:d6:73:56:3a:e3 root@h72.hostsharing.net (RSA)
4096 31:48:37:a3:c2:9d:6f:f1:59:bf:49:93:a9:4f:ec:2f root@h73.hostsharing.net (RSA)
4096 fe:a7:4e:a1:fb:93:06:c3:c2:c2:f8:4b:cc:d5:5a:0b root@h74.hostsharing.net (RSA)
4096 bc:b0:16:e2:3b:84:26:31:20:a9:70:ed:28:7d:63:66 root@h75.hostsharing.net (RSA)
4096 5f:a2:eb:63:e4:46:37:7a:a0:a8:e1:11:62:18:03:6b root@h76.hostsharing.net (RSA)
4096 3b:ea:b3:67:6e:82:6f:1f:c3:4a:fd:a4:96:1e:e7:40 root@h80.hostsharing.net (RSA)
4096 6b:84:bf:cf:67:7e:2d:29:45:08:56:3c:fe:93:58:02 root@h81.hostsharing.net (RSA)
4096 30:f3:9c:5a:35:8e:0a:5c:10:3e:39:a1:8d:62:95:db root@h82.hostsharing.net (RSA)
4096 e4:08:d0:1c:bf:ef:8b:f2:3e:9d:17:fe:2e:22:c0:67 root@h83.hostsharing.net (RSA)
4096 a1:83:80:83:cc:b0:72:61:4f:99:7f:66:30:2b:ce:82 root@h84.hostsharing.net (RSA)
4096 d0:8f:db:a3:a7:2b:b0:80:1f:9f:5e:c4:fd:e8:c2:76 root@h85.hostsharing.net (RSA)
4096 1c:44:bf:c4:4c:10:a1:0e:b6:c4:80:45:25:2f:79:63 root@h86.hostsharing.net (RSA)
4096 10:9b:f8:a4:c6:7c:09:92:48:ea:f9:b0:a4:de:10:b2 root@h87.hostsharing.net (RSA)
4096 0f:ac:d7:22:98:a4:68:1a:ac:82:bd:50:9d:6e:36:37 root@h88.hostsharing.net (RSA)
4096 88:38:cc:06:66:fa:c2:f8:66:47:6d:96:97:11:79:ae root@h89.hostsharing.net (RSA)
4096 a0:4e:72:00:1b:53:87:67:55:30:80:d0:6a:cf:c1:a9 root@h97.hostsharing.net (RSA)
4096 0c:e7:83:9c:7a:ee:db:cc:4f:32:f7:1f:2a:fa:62:53 root@h98.hostsharing.net (RSA)

</code>

----
[[Kategorie:HSDoku]]
[[Kategorie:ToDo-Kerndoku]]

SSH-Hostkeys

2014-04-08T18:39:36Z

Hsh00-mhi: /* Die SSH-Hostkeys der HS-Server */

SSH-Hostkeys

2014-04-08T18:16:52Z

Hsh00-mhi:

== Die SSH-Hostkeys der HS-Server ==

<nowiki>
4096 a6:2c:72:63:33:b1:a9:70:ae:25:11:8b:58:f4:e4:5d root@h01.hostsharing.net (RSA)
4096 6a:c7:ba:62:30:49:b1:e3:e6:ed:2e:07:93:96:b2:87 root@h02.hostsharing.net (RSA)
4096 74:fd:ed:29:64:d9:74:c8:1a:a7:0a:40:27:a9:6d:78 root@h03.hostsharing.net (RSA)
4096 3e:6e:3e:55:f3:59:18:da:f9:a9:43:0b:f2:b1:d5:77 root@h04.hostsharing.net (RSA)
4096 d1:da:1c:77:2a:f9:de:55:8a:2f:62:17:43:67:2d:7a root@h05.hostsharing.net (RSA)
4096 36:fa:b7:98:1f:ee:eb:dd:85:72:35:c6:4f:46:6c:21 root@h06.hostsharing.net (RSA)
4096 1a:3d:b8:6d:df:2d:d0:1c:cc:63:e5:3a:bd:e3:60:81 root@h07.hostsharing.net (RSA)
4096 38:f3:58:5d:af:e8:43:08:90:76:83:e7:ea:4e:21:ae root@h08.hostsharing.net (RSA)
4096 2a:fe:5f:2f:fe:16:8c:2f:59:00:3d:7c:96:d0:84:6c root@h50.hostsharing.net (RSA)
4096 5e:77:0d:53:fb:f7:b6:53:47:c2:1e:d8:22:3f:8a:02 root@h51.hostsharing.net (RSA)
4096 d6:5c:f5:82:80:89:c0:89:5d:11:19:4c:a9:8b:a7:94 root@h53.hostsharing.net (RSA)
4096 46:c6:72:fd:1b:ce:49:9e:25:0a:81:42:d1:7d:a4:5c root@h54.hostsharing.net (RSA)
4096 38:1f:da:de:fb:ce:c9:d2:39:41:01:03:82:67:be:c3 root@h59.hostsharing.net (RSA)
4096 a5:ea:e0:ee:09:14:52:15:b8:4b:ef:87:53:bb:26:d0 root@h60.hostsharing.net (RSA)
4096 e3:9c:f9:19:25:6e:86:4d:6e:88:6c:ef:33:19:e8:bc root@h61.hostsharing.net (RSA)
4096 10:fd:8c:6e:7c:f7:9a:bb:66:4d:ca:86:c0:55:2b:79 root@h62.hostsharing.net (RSA)
4096 af:c4:26:6e:13:c8:3b:29:ba:9a:1e:86:79:55:21:0e root@h63.hostsharing.net (RSA)
4096 ad:07:7a:7f:b0:4e:77:2a:6a:8b:b6:d1:cc:cd:b6:ec root@h64.hostsharing.net (RSA)
4096 94:ad:e6:a2:0e:8e:8a:d3:76:bb:73:2a:b6:fb:3b:4b root@h67.hostsharing.net (RSA)
4096 e0:86:45:80:0a:f7:07:0e:ec:31:b4:63:68:7d:9b:fd root@h68.hostsharing.net (RSA)
4096 b7:b7:a8:3b:38:05:bc:a0:c8:27:44:b8:27:a2:82:ab root@h70.hostsharing.net (RSA)
4096 52:ca:ea:c2:64:08:48:ad:18:cf:52:c7:58:8f:66:6f root@h71.hostsharing.net (RSA)
4096 9b:f8:ef:3f:d8:5b:fc:79:54:d4:92:d6:73:56:3a:e3 root@h72.hostsharing.net (RSA)
4096 31:48:37:a3:c2:9d:6f:f1:59:bf:49:93:a9:4f:ec:2f root@h73.hostsharing.net (RSA)
4096 fe:a7:4e:a1:fb:93:06:c3:c2:c2:f8:4b:cc:d5:5a:0b root@h74.hostsharing.net (RSA)
4096 bc:b0:16:e2:3b:84:26:31:20:a9:70:ed:28:7d:63:66 root@h75.hostsharing.net (RSA)
4096 5f:a2:eb:63:e4:46:37:7a:a0:a8:e1:11:62:18:03:6b root@h76.hostsharing.net (RSA)
4096 3b:ea:b3:67:6e:82:6f:1f:c3:4a:fd:a4:96:1e:e7:40 root@h80.hostsharing.net (RSA)
4096 6b:84:bf:cf:67:7e:2d:29:45:08:56:3c:fe:93:58:02 root@h81.hostsharing.net (RSA)
4096 30:f3:9c:5a:35:8e:0a:5c:10:3e:39:a1:8d:62:95:db root@h82.hostsharing.net (RSA)
4096 e4:08:d0:1c:bf:ef:8b:f2:3e:9d:17:fe:2e:22:c0:67 root@h83.hostsharing.net (RSA)
4096 a1:83:80:83:cc:b0:72:61:4f:99:7f:66:30:2b:ce:82 root@h84.hostsharing.net (RSA)
4096 d0:8f:db:a3:a7:2b:b0:80:1f:9f:5e:c4:fd:e8:c2:76 root@h85.hostsharing.net (RSA)
4096 1c:44:bf:c4:4c:10:a1:0e:b6:c4:80:45:25:2f:79:63 root@h86.hostsharing.net (RSA)
4096 10:9b:f8:a4:c6:7c:09:92:48:ea:f9:b0:a4:de:10:b2 root@h87.hostsharing.net (RSA)
4096 0f:ac:d7:22:98:a4:68:1a:ac:82:bd:50:9d:6e:36:37 root@h88.hostsharing.net (RSA)
4096 88:38:cc:06:66:fa:c2:f8:66:47:6d:96:97:11:79:ae root@h89.hostsharing.net (RSA)
4096 a0:4e:72:00:1b:53:87:67:55:30:80:d0:6a:cf:c1:a9 root@h97.hostsharing.net (RSA)
4096 0c:e7:83:9c:7a:ee:db:cc:4f:32:f7:1f:2a:fa:62:53 root@h98.hostsharing.net (RSA)
</nowiki>

----
[[Kategorie:HSDoku]]
[[Kategorie:ToDo-Kerndoku]]

RubyOnRails

2012-09-13T09:36:11Z

Hsh00-mhi: wsgi oder gunicorn gehören zur Python-Toolchain!

== Bestes Ruby on Rails Hosting bei Hostsharing ==

Rubyanwendungen laufen (wie alle Anwendungen bei Hostsharing) als Prozesse des jeweiligen Benutzersaccounts. Probleme mit Dateirechten und Sicherheitsrisiken, wie sie sonst bei der Ausführung durch den Webserver auftreten, sind so von vorne herein ausgeschlossen.

Standardmäßig erfolgt der Aufruf von Ruby Anwendungen durch den Apache Webserver über die FastCGI Schnittstelle. Dabei wird die Ruby Application Server Instanz des Users nach einem Aufruf noch für einige Zeit bereit gehalten, um sofort zur Bearbeitung von weiteren noch nicht gecacheten, oder gar nicht cachebaren, Anfragen zur Verfügung zu stehen.

Für den Betrieb von noch anspruchsvolleren Anwendungen haben wir auch Tools wie haproxy, varnish, nginx etc. installiert. Auf Anfrage können wir auch mod_passenger oder mongrel installieren. Anwender, die damit auf unserer leistungsfähigen Infrastruktur (managed Plattform) z.B. einen Webserver Cluster mit load-balancing realisieren möchten, brauchen bei uns dafür nur eigene Daemons zu buchen, können dies aber auch (für größere Projekte) mit einer beliebigen Anzahl ganzer Server realisieren.

== Einrichtung ohne zusätzliche Daemons (ein Application Server) ==

=== Vorbereitungen ===

Einige Einstellungen für den Paketuser.

~/.gemrc
install: --no-rdoc --no-ri
update: --no-rdoc --no-ri

~/.bashrc
alias gem="nice -n19 gem"

~/.profile
source "$HOME/.bashrc"

=== Ruby ===

==== Vorinstalliert ====

Soll nur die zentral installierte Ruby Version 1.8 verwendet werden, ergänzt man man in ~/.profile:
# enable user's own ruby installations, keeping all stuff below $HOME/.gem
export PATH="$HOME/bin:$HOME/.gem/ruby/1.8/bin:$PATH"
export GEM_PATH="$HOME/.gem/ruby/1.8:$( gem env gempath )"
export GEM_HOME="$HOME/.gem/ruby/1.8"

# Disabled for now, because using system libs caused undefined method error.
#export RUBYLIB="$HOME/.gem/ruby/1.8/lib:/usr/local/lib/site_ruby/1.8:/usr/lib/ruby/1.8"

# avoid to forget that extra parameter: ruby -rubygems prog_that_uses_gems
export RUBYOPT=rubygems

export RAILS_ENV=production

==== Eigene Installation ====

Um eine andere als die vorinstallierte Ruby Version zu verwenden, installiert man zunächst den Ruby Versions Manager (rvm),
curl -L https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm
rvm notes
rvm requirements
rvm pkg install openssl

und lässt dann die gewünschte Ruby Version installieren.
rvm install x.y.z

RVM passt die Umgebungsvariablen automatisch an die ausgewählt Version an. Die Version wählt man global per
rvm use x.y.z --default
oder nur für ein spezielles Verzeichnis:
cd ~/verzeichnis/mit/ruby-x.y.z-Anwendung
rvm use x.y.z-p??? --rvmrc

Zur Verwaltung von gems installiert man noch rubygems.
rvm rubygems current

=== Rails ===

Falls man die Ruby-Umgebung gerade erst eingerichtet hat, ohne sich zwischenzeitlich abzumelden, muß man zunächst die Umgebung manuell laden.
source ~/.profile

Nun kann Rails per "gem install rails" installiert werden (inklusive Abhängigkeiten).
Um spezielle versionen zu installieren kann man den gem Befehl mit "-v=x.y.z" ergänzen.

Zum Testen hier ein Beispiel das eine Content und Daten Management Anwendung installiert (http://zenadmin.org) und mit einer sqlite Datenbankdatei eingerichtet:
gem install rails -v=2.3.11
gem install i18n sexp_processor rmagick sqlite3 zena
zena new ~/doms/www.example.org/rails # Zena Rails-Anwendung anlegen.
cd ~/doms/www.example.org/rails
rake db:create # Datenbank anlegen.
zena migrate # Datenbank Tabellen einrichten.
zena mksite HOST_LANG=de RAILS_ENV=production PASSWORD=geheim HOST=www.example.org # Webseite anlegen.

=== Rails-Anwendung ===

Seine eigene Rails-Anwendung kopiert man z.B. nach ~/doms/www.example.org/rails, oder erstellt dort eine Neue (rails ~/doms/www.example.org/rails, ...).

=== Datenbank ===

Mit ''hsadmin'' beispielsweise einen Postgres-User (z.B. 'xyz00_rails', Passwort sei 'geheim') sowie eine Datenbank anlegen (z.B. 'xyz00_rails'.

Die Datenbank in der Anwendung konfigurieren,

cd ~/doms/www.example.org/rails/config/
nano database.yml

mit folgendem Inhalt:

production:
adapter: postgresql
database: xyz00_rails
host: localhost
username: xyz00_rails
password: geheim

=== E-Mail, Dateiablage ===

Beispielhafte Konfiguration:

default:
email_delivery:
delivery_method: :smtp
smtp_settings:
address: localhost
port: 25
domain: www.example.org
attachments_storage_path: /home/doms/www.example.org/rails/attach

=== Datenbankschema ===

Initialisieren und migrieren der Datenbank (je nach Rails-Anwendung).

cd ~/doms/www.example.org/rails
...
rake ...

=== Konfiguration von FastCGI ===

~/doms/www.example.org/htdocs/.htaccess

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f [OR]
RewriteCond %{REQUEST_FILENAME} dispatch.fcgi$
RewriteRule ^(.*)$ /fastcgi-bin/dispatch.fcgi [QSA,L]

Ältere Versionen von Rails, die noch nicht auf der "rack" Middleware aufbauen (wie obiges zena Beispiel), laufen mit folgender ~/doms/www.example.org/fastcgi/dispatch.fcgi

#!/usr/bin/env ruby
require "/home/doms/www.example.org/rails/config/environment"
require 'fcgi_handler'
RailsFCGIHandler.process!

Für aktuelle Versionen von Rails, die auf "rack" aufbauen, siehe https://github.com/dre3k/rails3_fcgi, ~/doms/www.example.org/fastcgi/dispatch.fcgi
#!/usr/bin/env ruby

require_relative '../config/environment'

class Rack::PathInfoRewriter
def initialize(app)
@app = app
end

def call(env)
env.delete('SCRIPT_NAME')
parts = env['REQUEST_URI'].split('?')
env['PATH_INFO'] = parts[0]
env['QUERY_STRING'] = parts[1].to_s
@app.call(env)
end
end

Rack::Handler::FastCGI.run Rack::PathInfoRewriter.new(HIER_APPLIKATIONSNAME_AUS_config/application.rb_EINTRAGEN::Application)

FastCGI-Skript ausführbar machen:

chmod 755 ~/doms/www.example.org/fastcgi/dispatch.fcgi

Am Anfang von ~/doms/www.example.org/rails/config/environment.rb einfügen:

ENV['RAILS_ENV'] ||= 'production'
ENV['GEM_PATH'] ||= '/home/pacs/xyz00/users/meinuser/.gem/ruby/1.8:/var/lib/gems/1.8'

Die Applikation ins Webroot einbinden:

cd ~/doms/www.example.org
# ggf. vorhandene Dateien sichern (oder nach ~/doms/www.example.org/rails/public kopieren),
mv htdocs htdocs.old
# und das entsprechende public/ Verzeichnis der Rails-Anwendung im Webroot verlinken.
# Standardmäsig /home/doms/www.example.org/rails/public,
# bei multi-site Anwendungen wie zena aber z.B. /home/doms/www.example.org/rails/site/www.example.org/public
ln -s /home/doms/www.example.org/rails/public htdocs

=== Konfiguration von SSL ===

Die Verzeichnisse ~/doms/www.example.org/fastcgi-ssl/ und ~/doms/www.example.org/htdocs-ssl/ werden analog zu bzw. anstelle von fastcgi und htdocs gefüllt.

[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]
[[Kategorie:Glossar]]

Domains

2011-11-03T08:25:34Z

Hsh00-mhi: /* 2. lokale Subdomains durch auf schalten / delegieren */

{{HSDoku-Links}}

Die Domainverwaltung bei Hostsharing ist in zwei unabhängige Bereiche aufgeteilt:
* Das "Domain-Bestellsystem" zur Vergabe von Aufträgen an Registrierungstellen, die über HS abgerechnet werden.
* Die Domaineinrichtung in den HS-Paketen, zur Aufschaltung von Domains auf HS Name-, Mail- und Webserver.

Bei anderen Hostern ist eine Domainbestellung teilweise eine feste Kopplung der Registrierung einer Domain mit Konnektierung und Aufschaltung auf bestimmte Nameserver und Webpakete. HS ist hier wesentlich flexibler. Der über HS angebotene Zugang zur Registrierungsverwaltung "Domain-Bestellsystem" (Domain-Robot Webfrontend) erlaubt es registrierte Domains auf frei wählbare DNS-Server zu konnektieren. Auf den HS Nameservern und Paketen lassen sich gleichzeitig beliebige weltweit registrierbare Domains einrichten. Hostsharing unterstützt damit die Einrichtetung und den Betrieb von Domains die von beliebigen (auch sehr exotischen) Registrierungsstellen verwaltet und abgerechnet werden können.

Typische Domainaktionen beinhalten daher ein paar koordinierte Änderungen in der Domainregistrierung und HS-Einrichtung, wie folgend aufgezeigt.

{{Textkasten|gruen||Der verbreitete Ausdruck KK (Konnektivitätskoordination) ist eigentlich veraltet, neu heißt es CHPROV (change provider).}}

= FAQ =

Zu Domains gibt es [[FAQ#Domains|hier]].

= Domainregistrierung oder eingehender Transfer (KK) =

Soll eine neue Domain registriert oder eingehend transferiert werden, sollte die Domain bei Hostsharing eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird.

'''1. ggf. bereits registrierte Domain zum Transfer freischalten'''

: Dem vorherigen Provider muss die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Bspw. bekommt man dort eine AuthCode für die Domain mitgeteilt. Gibt es dort kein etabliertes Verfahren, so kann man wie folgt verfahren:

:* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
:::"Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der Domain example.com zur Hostsharing eG, vertreten durch den Registrar Internetwire, an.
::: Ich bitte, dem folgenden Transferantrag zuzustimmen."
:* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
:* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

'''2. Einrichten der Domain auf den HS Servern'''

Auf der [[Shell|Kommandozeile]]:
hsadmin -c domain.add --set:user="<xyz00-admin>" --set:name="<example.com>"

oder mit dem [[WebFrontend | HSadmin Webfrontend ]].

Bei diesem Vorgang werden die Verzeichnisse für die Domain im eigenen Paket angelegt und die Nameserver von HS erhalten die notwendigen Updates. Letzteres ist Voraussetzung für den nächsten Schritt.

{{Textkasten|gruen|Bei Fehler ... | Bei in [[hsadmin]] hängenden Domainaufträgen bitte Mail an mailto://service@hostsharing.net}}

'''3. Neuregistrierung oder Transfer (KK) einleiten'''

:* Im [http://www.domain-bestellsystem.de Domainbestellsystem] mit dem über HS vergebenen Account anmelden. Es handelt sich dabei nicht um den xyz00 Nutzer sondern der Nutzername ist hs-xyz.

:* Neuregistrierung/Transfer(KK) einleiten. (Für den Transfer ist hier i.d.R. der zuvor in Erfahrung gebrachte AuthCode notwendig.)

:* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

'''4. E-Mail-Adressen der neu eingerichteten Domain'''

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Weitere Adressen können mit [[Hsadmin-mail]] konfiguriert werden.

= Abgehender Transfer (KK) oder Domainkündigung/-löschung =

Ausgehende Domaintransfers sind unabhängig von den Domaineinrichtungen bei HS möglich. Eine Domainregistrierung kann also über eine andere Registrierungsverwaltung abgerechnet werden und weiter bei HS eingerichtet und betrieben werden. Falls bei einem ausgehendem Transfer eine Domain jedoch auch nicht mehr weiter bei Hostsharing gehostet werden soll aber eine möglichst durchgehende Erreichbarkeit sichergestellt werden soll, ist es wichtig, dass die neuen (externen) DNS-Konnektierungen und Webserveraufschaltungen in Betrieb sind und alle alten DNS Caches ausgelaufen sind, bevor die Einrichtung bei HS entfernt wird.

'''1. Domainlöschung beauftragen bzw. den Transfer freischalten'''

:* Im [http://www.domain-bestellsystem.de Domainbestellsystem] mit dem über HS vergebenen Account anmelden.

:* Die gewünschte Aktion einleiten (Löschung/Transit bzw. Domain für den Transfer freigeben/AuthCode erstellen lassen).

'''2. ggf. Domaintransfer (KK) im externen Abrechnungssystem beauftragen (mit oder ohne externe DNS/Webserver Aufschaltung)'''

:* Hierfür ist i.d.R. der zuvor erstellte AuthCode notwendig.

'''3. ggf. Domaineinrichtung auf den HS Servern entfernen'''

:<pre>hsadmin -c domain.delete "<example.com>"</pre> oder mit dem HSadmin Webfrontend. Dies entfernt die Domainverzeichnisse aus dem Webserverpaket und die Domain aus dem DNS- und Mailservern bei Hostsharing.

= "Handles" in der Registrierungsverwaltung =

Die verschiednenen Registrierungstellen vergeben i.d.R. automatisch Registrierschlüssel -die sog. "Handles"- für jeden neuen Kontaktdatensatz (owner, admin-c, tech-c, zone-c Datensätze). Diese kann man bei weiteren Registrierungen verwenden um sich auf die gleichen Kontaktdaten zu beziehen. Die Internetwire-internen Handles im Domain-Bestellsystem beginnen mit einer Buchstaben/Zahlenkombination und enden mit @HANDLES.DE. Sie dienen dazu auch Kontaktdatensätze, die bei verschiedenen Registrierungsstellen hinterlegt sind unter einem Handle im Internetwire-System zu verwalten.

= Weitere Domaineinrichtungs-Aktionen =

== eigene Verwaltung der Zonefiles ==

Siehe [[Verwalten der Zonendaten]]. 

== lokale Subdomains ==

Lokale Subdomains können durch 2 Verfahren geschaltet werden:
Das kann jeweils der Paketadmin (xyz00) oder auch der Domainadmin (xyz00-nutzer)

=== 1. lokale Subdomains via Verzeichniss ===

Es wird unter ~/doms/example.org/subs/ ein Verzeichnisses erstellt

xyz00-domain@h01:~/doms/example.org/subs$ mkdir muster

Ergibt http://muster.example.org

=== 2. lokale Subdomains durch auf schalten / delegieren ===

Dabei kann die muster.example.org im gleichen oder einem anderem Paket auf geschaltet werden.

Die Einrichtung erfolgt durch den Paket-Admin mit Hilfe von HSAdmin, wenn die Aktion innerhalb eines Pakets durchgeführt werden soll.

Die Einrichtung erfolgt durch den Mitgliedsccount mit Hilfe von HSAdmin, wenn die Aktion zwischen Paketen eines Mitglieds durchgeführt werden soll.

Soll eine Subdomain an ein anderes Mitglied delegiert werden, so müssen sich beide Mitglieder mit diesem Wunsch an den Hostsharing-Service wenden.
Der Hostsharing-Service schaltet die Subdomain, wenn ihm übereinstimmende Willenserklärungen der beteiligten Mitglieder vorliegen.

== Domains neu zuordnen (Domain-Admin ändern, Paketzuordnung ändern) ==

Domain-Verschiebungen (neu zuordnen) wird auch über die DNS Delegation gemacht und erfolgen grundsätzlich über HSAdmin durch Löschen und Neuanlegen der Domain vom Paketadmin bzw. den Paketadmins. Da die eigentliche Registrierung über das [http://www.domain-bestellsystem.de Domainbestellsystem] erfolgt, bleibt der Eigentümer der betreffenden Domain durch die Löschung über HSAdmin unverändert.

'''Achtung:''' Das ~/doms/example.org Verzeichnis, also alle Dateien im Webspace werden bei dieser Aktion komplett gelöscht. Sie müssen vorher manuell (am Besten in einem tar-archiv) gesichert werden! Auch die Zuordnung von Mailadressen der betreffenden Domain geht verloren und muß ggf. neu eingetragen werden.

Verschiebungen über den HS-Service (service@hostsharing.net), etwa zur Verkürzung des
Ausfallzeiten, sind gemäß Hostmaster-Stundensatz kostenpflichtig.

== Status der Domaineinrichtung ==

Der Domaineinrichtungs-Status kann mit unserem hsadmin-[[WebFrontend]] eingesehen werden oder mit [[hsadmin]] auf der Kommandozeile der [[Shell]]:

<pre>
hsadmin -c domain.search
</pre>

== Adresse von Owner / Admin-C ändern ==

Die Änderung der Adressdaten erfolgt, indem die Adressdaten des zugehörigen Handles im [https://www.domain-bestellsystem.de Domain-Bestellsystem] aktualisiert werden. Die Logindaten
sind im Februar 2010 an alle HS-Mitglieder versand worden.

= Weiterführende Links =

[[Verzeichnis-Struktur]] 

----
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]
[[Kategorie:Glossar]]

Verwalten der Zonendaten

2011-11-03T08:22:12Z

Hsh00-mhi: /* Domain Delegation */

{{HSDoku-Links}}

Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service (DNS), d.h. der Nameserver der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen.

{{Textkasten|rot|Achtung|Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!}}

== Aktives Zonefile ==

Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden (Zonefile).

Im Standardfall sieht es vollständig expandiert wie folgt aus:

<pre><nowiki>
$TTL 6H
example.com. IN SOA h00.hostsharing.net. hostmaster.hostsharing.net. (
1303649373 ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)

example.com. IN NS dns1.hostsharing.net.
example.com. IN NS dns2.hostsharing.net.
example.com. IN NS dns3.hostsharing.net.

example.com. IN MX 30 mailin1.hostsharing.net.
example.com. IN MX 30 mailin2.hostsharing.net.
example.com. IN MX 30 mailin3.hostsharing.net.

example.com. IN A 83.223.95.160

*.example.com. IN MX 30 mailin1.hostsharing.net.
*.example.com. IN MX 30 mailin2.hostsharing.net.
*.example.com. IN MX 30 mailin3.hostsharing.net.

*.example.com. IN A 83.223.95.160
</nowiki></pre>

== Logfile und Kontrolle==

Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:

Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN':
AXFR-style IXFR started
Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN':
AXFR-style IXFR started

Die Zeilen bedeuten jeweils:

* Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
* Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.

Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.

<code>
-------- Original-Nachricht --------
Betreff: [Global] DNS Zonenfile Änderungen
Datum: Thu, 4 Mar 2010 08:30:34 +0100

Moin Moin,

aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
später dann sind die Domains nicht mehr erreichbar und es heißt "in den
letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
"mal eben schnell noch ... " ging.

Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!

Was also tun? Zunächst kann man nach einer Änderung in einer
Shell beobachten, ob es zu Fehlermeldungen kommt:

tail -f /var/log/named/named.log

oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
vorkommt:

tail -f /var/log/named/named.log | grep example.com

Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
Server lesbar.

Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
aktuellen in der Zonendatei verglichen werden:

dig -t SOA @dns1 example.com | grep '^example.com.*SOA' | awk '{ print $7 }'

grep serial /etc/bind/pri.example.com | awk '{ print $1 }'
</code>

== Platzhalter für eigene Zonenfiles ==

Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern der DNS-Konfiguration, ohne dass der Domain-Admin sein Zonefile anpassen muss.

=== Komplexe Platzhalter ===

<pre>
{DEFAULT_ZONEFILE} :=
{HEADER}
{SOA_RR}
{NS_RR}
{MX_RR}
{A_RR}
{WILDCARD_MX_RR}
{WILDCARD_A_RR}

{HEADER} :=
$TTL {TTL}

{SOA_RR} :=
{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
{SIO} ; serial secs since Jan 1 1970
{REFRESH} ; refresh (>=10000)
{RETRY} ; retry (>=1800)
{EXPIRE} ; expire
{MINIMUM} ; minimum
)

{NS_RR} :=
{DOM_HOSTNAME}. IN NS {DNS1_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS2_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS3_HOSTNAME}.

{MX_RR} :=
{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.

{A_RR} :=
{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}

{WILDCARD_MX_RR} :=
*.{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.

{WILDCARD_A_RR} :=
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

=== Atomare Platzhalter ===

<pre>
{TTL} := 6H
{SOA_HOSTNAME} := <HIVE>.hostsharing.net
{SOA_EMAIL}:= hostmaster.hostsharing.net
{SIO} := <SEKUNDEN>
{REFRESH} := 6H
{RETRY} := 1H
{EXPIRE} := 1W
{MINIMUM} := 1H

{DNS1_HOSTNAME} := dns1.hostsharing.net
{DNS2_HOSTNAME} := dns2.hostsharing.net
{DNS3_HOSTNAME} := dns3.hostsharing.net

{MX1_HOSTNAME} := mailin1.hostsharing.net
{MX2_HOSTNAME} := mailin2.hostsharing.net
{MX3_HOSTNAME} := mailin3.hostsharing.net

{DOM_HOSTNAME} := <FQDN>
{DOM_IPNUMBER} := <IP>
</pre>

Hierbei stehen
* <Sekunden> für die Anzahl der Sekunden, welche seit dem 01.01.9170 vergangen sind
* <FQDN> für den vollständigen, qualifizierten Domainnamen der Domain
* <IP> für die der Domain zugewiesene IP-Adresse

Diese Werte werden von Hostsharing verwaltet.

=== Expansion der Platzhalter ===

Der Platzhalter für das Gesamtzonefile {DEFAULT_ZONFILE} wird in drei Schritten folgermaßen expandiert.
Zunächst werden die komplexen Platzhalter ersetzt.

<pre>
{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
{SIO} ; serial secs since Jan 1 1970
{REFRESH} ; refresh (>=10000)
{RETRY} ; retry (>=1800)
{EXPIRE} ; expire
{MINIMUM} ; minimum
)

{DOM_HOSTNAME}. IN NS {DNS1_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS2_HOSTNAME}.
{DOM_HOSTNAME}. IN NS {DNS3_HOSTNAME}.

{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.

{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}

*.{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
*.{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.

*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

Anschließend werden die atomaren Platzhalter ersetzt.

<pre>
$TTL 6H

<FQDN>. IN SOA <HIVE>.hostsharing.net. hostmaster.hostsharing.net. (
<SEKUNDEN> ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)

<FQDN>. IN NS dns1.hostsharing.net.
<FQDN>. IN NS dns2.hostsharing.net.
<FQDN>. IN NS dns3.hostsharing.net.

<FQDN>. IN MX 30 mail1.hostsharing.net.
<FQDN>. IN MX 30 mail2.hostsharing.net.
<FQDN>. IN MX 30 mail3.hostsharing.net.

<FQDN>. IN A <IP>

*.<FQDN>. IN MX 30 mail1.hostsharing.net.
*.<FQDN>. IN MX 30 mail2.hostsharing.net.
*.<FQDN>. IN MX 30 mail3.hostsharing.net.

*.<FQDN>. IN A <IP>
</pre>

== Beispiele ==

----
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:ToDo-Kerndoku]]

FAQ

2011-11-03T08:21:39Z

Hsh00-mhi: /* Unser MX und unser Backup-MX zeigen auf verschiedene Rechner. */

{{HSDoku-Links}}

FAQ heißt Frequently Asked Questions - Fragen, die immer wieder gestellt werden. Hier ist der Platz, sie zu beantworten.

== Domains ==

=== Domain bei anderem Provider, Subdomain bei HS und umgekehrt ===
:Fall A -> Domain example.com bei Anbieter XY
:Subdomain test.example.com bei Hostsharing
:Was ist zu tun?
:* Bei Anbieter XY sollten DNS-Einträge geschaltet werden, damit Hostsharing die Subdomain verwalten kann:

:test.example.com. IN NS dns1.hostsharing.net.
:test.example.com. IN NS dns2.hostsharing.net.
:test.example.com. IN NS dns3.hostsharing.net.

:* Bei Hostsharing kann die Domain test.example.com nun via HSAdmin hinzugefügt werden. Im Domainbestellsystem ist keine Aktion erforderlich, da es sich nicht um eine Domain-Registrierung handelt.

:Welche Voraussetzungen sind zu erfüllen?
:Anbieter XY muss die entsprechend DNS-Schaltung ermöglichen.

:Welche Kosten fallen an?
:Bei Hostsharing fallen keine Kosten an, abgesehen vom Webspace- und Traffic-Bedarf des Angebots unter test.example.com.

:Fall B -> Domain example.com bei Hostsharing
:Subdomain test.example.com bei Anbieter XY

:Was ist zu tun?
:* Bei Hostsharing sollten über die Zonefile-Verwaltung DNS-Einträge geschaltet werden, so dass der Anbieter XY die Subdomain verwalten kann.

:test.example.com. IN NS <DNS-Server 1 des Anbieters>
:test.example.com. IN NS <DNS-Server 2 des Anbieters>
:...

:Die Angaben sind bei dem entsprechenden Anbieter zu erfragen.
:* Die Subdomain kann anschließend bei bei Anbieter XY geschaltet werden.

:Welche Voraussetzungen sind zu erfüllen?
:Anbieter XY muss Aufschaltung von Subdomains unterstützen.

:Welche Kosten fallen an?
:Bei Hostsharing fallen keine Kosten an, abgesehen vom ohnehin zu leistenden Entgelt für die Domain example.com.

=== Wie komme ich an einen Auth Code für eine hier gehostete .com/.de Domain? ===

: Kann im Account des [https://domain-bestellsystem.de Domain-Bestellsystem ] selbst abgefragt, bzw. erzeugt werden:
"Auftragsübersicht" wählen, dort die Domain anklicken, unter "Ausführbare Aktionen". (nicht im KK-Center.)

=== Was sind CNO-Domains? ===
:CNO steht für "COM", "NET" und "ORG". Im Gegensatz zu DE-Domains,welche auf ".de" enden (z.B. hostsharing.de), enden CNO - Domains auf ".com", ".net" oder ".org" (z.B. hostsharing.net).
:Im Allgemeinen steht .com für ein kommerzielles Angebot und .org für eine nicht kommerzielle Organisation. Die Endung .net wird heute oft genutzt, wenn die entsprechende .com - Domain bereits vergeben ist und ist weit verbreitet.

=== Wie mache ich zwei Domain-Verzeichnisse identisch, die zwei unterschiedlichen usern gehören? ===

:Das ist nicht möglich.

=== Wie ändere ich den Domain Admin ? ===

:Als Domainadmin informiere Deinen Paketadmin.
:Als Paketadmin siehe [[Domains]].

=== Wie ändere Ich Adress-Daten vom Domain Inhaber / Admin? (whois)===
Im Feb 2010 wurden an alle HS Mitglieder die Zugangsdaten für unser
[https://domain-bestellsystem.de Domain-Bestellsystem ] versendet.
Dort kann auch die gesamte Adresse oder nur Telefon und eMail Daten geändert werden.
Wer diese Zugangsdaten nicht mehr hat kurze eMail an service@hostsharing.net
:Nach der Anmeldung auf Menüpunkt "Handleverwaltung"
:Dann bei "Suchen" die HandleID und bei im Feld "Handle-ID" auswählen -> Button "suchen"
:Die aktuelle HandleID über Menü "Auftragsübersicht" und dann auf die "Domain" klicken.

== Email ==

=== Meine Email wurde abgelehnt, obwohl sie kleiner als 128 MB ist ===

:Du hast nicht bedacht, dass der Anhang durch die Kodierung an Größe zunimmt. Siehe [[Größenbeschränkung von E-Mails]]

=== Was bedeutet die Fehlermeldung 554 hop-count exceeded in einer E-Mail ? ===

: Eine Mail ist zwischen zwei Adressen weitergeleitet und es entstand eine Weiterleitungsschleife. Im Mailserver gibt es die Einstellung: hopcount_limit = 50. Wenn eine Mail über 50 Emailserver ging, dann wird die gebounced. Damit verhindert man solche Schleifen.

=== Nutzung der E-Mail Postfächer in SW und DW Paket ===
:Kann ich E-Mail-Adr deren Domain in einem DW-Paket ist in einem SW-Paket nutzen?

:Ja, folgende beiden Möglichkeiten gibt es a) Die Subdomain mail.example.org ins SW legen und per Catch-All von @example.org nach @mail.example.org leiten und dort passende E-Mail-Adressen Postfächer einrichten. (Leichter nachträglich einzurichten.) b) Die Domain example.org im SW aufschalten und www.example.org im DW aufschalten. E-Mail dann direkt im SW abhandeln. (Technisch besser.)

== WWW ==

=== Meine Webseite ist nicht erreichbar ===

: Schau auf http://status.hostsharing.net - da kannst Du sehen, ob es ein Problem auf dem Server von HS gibt. Siehe [[Überwachung der HS-Dienste]]

=== Wieviel Speicherplatz haben meine User in meinem Paket belegt? ===

:siehe [[DW-Speicherbelegung]].

=== kein Verzeichnislisting anzeigen ===

: Am elegantesten erledigt man das mit einer [[.htaccess]] Datei.
: Eine andere Möglichkeit besteht darin, einfach eine Datei index.html in das Verzeichnis zu legen. Sie kann leer sein oder einen Hinweis der Art: Diese Seite wurde absichtlich leer gelassen enthalten.

=== Wie unterscheide ich, ob ein Script per https angesprochen wurde? ===

:Weil https über einen eigenen Port läuft, ist das recht einfach. Diese php-Abfrage prüft das ab:
<pre>
$cfgPmaAbsoluteUri = 'http'.(($_SERVER['SERVER_PORT']==443)?'s':'').'://hostsharing.net/';
</pre>
:und baut entweder ein s in den String ein oder eben nichts ('').
:Das Ergebnis ist dann entweder 'http://hostsharing.net' oder 'https://hostsharing.net'.
:
:Mehr auch unter [[.htaccess]] oder ggf auch [[SSL]] .

=== winscp installiert, bekomme aber anstatt eines Zugriffs nur die Warnung: "Public key packet not received" ===

: Dein Programm kann nur/ist auf Protokoll Version 1.5 eingestellt. Du brauchst aber Protokoll Version 2.0.

== Datenbank ==

=== Wie bekomme ich meinen dump in die mysql-Datenbank? ===

:Du kopierst den dump auf den hs Rechner. Egal wohin!
:Dann:

mysql -u xyz00 -p dein_datenbank_name< name_des_dumps.
Jetzt dein Passwort der Datenbank angeben.

== Host / Server ==

=== Wie heißt auf dem Host das Kommando, welches ...? ===
=== Haben wir auf unserm Server ein Programm für ... ? ===

:Wie man sowas findet:

:Finde ein möglichst spezielles Stichwort zum Thema (vorzugsweise in englisch):
<pre>
1. auf unserem Server einloggen,

2. apropos stichwort eingeben,

3. für jedes interessant klingende Programm man Programmname eingeben, lesen.
</pre>

== Pakete allg. ==

=== Sind für Pakete auch besondere Konfigurationen zu erhalten? ===

Da die Betreuung von Sonderkonfigurationen einen erheblichen Aufwand bedeutet, versuchen wir diese Wünsche entweder in die Standardkonfiguration einzubauen oder zumindest konfigurierbar zu machen. Die Entscheidung treffen in letzter Instanz die Hostmaster.

=== Welche Parameter müssen angegeben werden, wenn über FTP auf ein Paket zugegriffen werden soll? ===

Der Zugriff ist entweder über die IP-Nummer oder dem Domainnamen (z.B. ftp.example.com) möglich. Username und Passwort wurden bei bei der Einrichtung des Paketes mitgeteilt oder selbst vergeben.

Für Windows-Nutzer:

Für die Datenübertragung immer auf Unix einstellen wenn die Option vorhanden ist (z.b. bei WS-FTP). Scripte und Konfigurationsdateien IMMER im ASCII-Modus übertragen! Sonst können sie evtl. nicht richtig verwendet werden.

Generell raten wir von FTP aus Sicherheitsgründen ab.

[[Kategorie:HSDoku]]
[[Kategorie:Glossar]]

Größenbeschränkung von E-Mails

2011-11-03T08:20:50Z

Hsh00-mhi:

Die maximale Größe von E-Mails ist bei Hostsharing auf 90 MB festgelegt. Weil Dateianhänge in E-Mails sehr ineffizient kodiert werden – als Faustregel kann man rechnen, dass die Größe beim Versand um etwas mehr als 1/3 größer als die Dateigröße ist – bedeutet das in der Praxis, dass man keine Dateianhänge versenden oder empfangen kann, die größer als ca. 90 MB sind.

{{Textkasten|gruen|Größenbeschränkung in Kurzform|Mails mit Anhängen sollten nicht größer als 90 MB sein, damit sie sicher durchkommen. Andere E-Mail-Anbieter haben möglicherweise abweichende Größenbeschränkungen.}}

== Versandgröße von Dateianhängen ==

Dateianhänge werden in E-Mails mit Hilfe des [http://de.wikipedia.org/wiki/Base64 Base64]-Verfahrens kodiert. Dieses Verfahren verwendet nur 64 Zeichen (6 Bit Informationsgehalt) statt die vollen 8 Bit (256 Werte) pro Byte. Daher wächst eine Datei für den Versand um ca. 8/6 (bzw. 4/3, daher die Faustformel "1/3 mehr") in der Größe an. Der Hintergrund dieses Verfahrens ist, dass mit den für E-Mail verwendeten Übertragungsverfahren nicht jeder beliebige Byte-Wert zuverlässig übertragen werden, sondern nur "lesbare Zeichen" (vereinfacht gesagt nur das, was man auch auf einer US-Tastatur tippen könnte). Die Base64-Kodierung bildet die Byte-Werte einer Binärdatei daher auf einen kleineren Satz von Zeichen ab, wobei für jeweils 3 Byte der Datei 4 Zeichen benötigt werden.

Für den Versand per E-Mail werden anschließend noch Zeilenumbrüche eingefügt, und zwar immer nach 76 Zeichen ein Zeilenumbruch, der nochmal zwei Byte benötigt. Damit wächst die Versandgröße noch einmal um 78/76 an, die Gesamtgröße für den Versand ist also sogar etwas größer als 4/3, nämlich 8/6 * 78/76 = 26/19 der ursprünglichen Dateigröße.

Rückwärts gerechnet ergibt sich so aus der maximalen Versandgröße einer E-Mail von 128 MB die maximale Dateigröße für angehängte Dateien: 128 MB * 19/26 = 93,35 MB. Davon abgezogen werden müssen noch die Kopfdaten (die bei jedem Kodierungsverfahren nötig wären) und natürlich der Platz für den Text der eigentlichen Nachricht, an die man den Anhang anhängt. In der Praxis empfiehlt es sich daher, von einer Maximalgröße von 90 MB auszugehen.

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]

Größenbeschränkung von E-Mails

2011-11-03T08:20:20Z

Hsh00-mhi: /* Versandgröße von Dateianhängen */

Die maximale Größe von E-Mails ist bei Hostsharing auf 32 MB festgelegt. Weil Dateianhänge in E-Mails sehr ineffizient kodiert werden – als Faustregel kann man rechnen, dass die Größe beim Versand um etwas mehr als 1/3 größer als die Dateigröße ist – bedeutet das in der Praxis, dass man keine Dateianhänge versenden oder empfangen kann, die größer als ca. 23 MB sind.

{{Textkasten|gruen|Größenbeschränkung in Kurzform|Mails mit Anhängen sollten nicht größer als 23 MB sein, damit sie sicher durchkommen. Andere E-Mail-Anbieter haben möglicherweise abweichende Größenbeschränkungen.}}

== Versandgröße von Dateianhängen ==

Dateianhänge werden in E-Mails mit Hilfe des [http://de.wikipedia.org/wiki/Base64 Base64]-Verfahrens kodiert. Dieses Verfahren verwendet nur 64 Zeichen (6 Bit Informationsgehalt) statt die vollen 8 Bit (256 Werte) pro Byte. Daher wächst eine Datei für den Versand um ca. 8/6 (bzw. 4/3, daher die Faustformel "1/3 mehr") in der Größe an. Der Hintergrund dieses Verfahrens ist, dass mit den für E-Mail verwendeten Übertragungsverfahren nicht jeder beliebige Byte-Wert zuverlässig übertragen werden, sondern nur "lesbare Zeichen" (vereinfacht gesagt nur das, was man auch auf einer US-Tastatur tippen könnte). Die Base64-Kodierung bildet die Byte-Werte einer Binärdatei daher auf einen kleineren Satz von Zeichen ab, wobei für jeweils 3 Byte der Datei 4 Zeichen benötigt werden.

Für den Versand per E-Mail werden anschließend noch Zeilenumbrüche eingefügt, und zwar immer nach 76 Zeichen ein Zeilenumbruch, der nochmal zwei Byte benötigt. Damit wächst die Versandgröße noch einmal um 78/76 an, die Gesamtgröße für den Versand ist also sogar etwas größer als 4/3, nämlich 8/6 * 78/76 = 26/19 der ursprünglichen Dateigröße.

Rückwärts gerechnet ergibt sich so aus der maximalen Versandgröße einer E-Mail von 128 MB die maximale Dateigröße für angehängte Dateien: 128 MB * 19/26 = 93,35 MB. Davon abgezogen werden müssen noch die Kopfdaten (die bei jedem Kodierungsverfahren nötig wären) und natürlich der Platz für den Text der eigentlichen Nachricht, an die man den Anhang anhängt. In der Praxis empfiehlt es sich daher, von einer Maximalgröße von 90 MB auszugehen.

----
[[Kategorie:HSDoku]]
[[Kategorie:E-Mail]]

DAViCal installieren

2011-11-03T08:18:28Z

Hsh00-mhi: /* Subdomain aufschalten */

{{HSDoku-Links}}

== Allgemein ==
=== Beschreibung ===
[http://www.davical.org/ DAViCal] ist ein Server für die Verwaltung von Kalendern über das [http://caldav.calconnect.org/ CalDAV-Protokoll]. Die Kalenderdaten können mit allen CalDAV-fähigen CLient-Programmen gelesen und geschrieben werden, z.B. Thunderbird mit [http://www.mozilla.org/projects/calendar/lightning/ Lightning], Evolution, Mulberry oder iCal / iPhone.

Das CalDAV-Protokoll wird im Wesentlichen breiter unterstützt, als es die Clients bisher unterstützen. Serien, Erinnerungen, Einladungen, Ressourcen, Arbeitsgruppen etc. sind alle Bestandteil der Features.

Die Software ist in PHP geschrieben, lizensiert unter GPL.

Es werden auch Kalender über das WebDAV-Protokoll untersützt, hier wird aber eine Nur-Lesemodus empfohlen.

=== Voraussetzungen ===

DAViCal setzt technisch voraus:
* PostgreSQL
* Webserver mit PHP5
* Perl für den Installationsvorgang

Die Installations-Anleitung auf der Projekt-Homepage geht davon aus, daß mal als Administrator auf den Server zugreifen kann. Die Anleitung hier beschreibt, wie man konkret DAViCal in der Shared Hosting Umgebung bei Hostsharing installiert und betreibt.

== Installation ==

=== Design ===

Diese Installationsanleitung beschreibt, wie DAViCal in einer eigens dafür aufgeschalteten Subdomain über SSL betrieben wird. Für andere Konfigurationen, wie z.B. Installation in einer Subdomain im <tt>sub</tt>-Verzeichnis müssen kleine Anpassungen vorgenommen werden.

Der Vorteil einer Installation in einer aufgeschalteten Subdomain ist, daß die Installation leicht von den übrigen Domaininhalten isoliert werden kann, z.B. php-Konfiguration oder auch anderen Domain-Admin.

=== Subdomain aufschalten ===

Für diese Anleitung werden folgende Daten als Konvention angenommen

{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| (Sub)-Domain || <tt>cal.example.org</tt> || Die Sub-Domain unter der der DAViCal-Server betrieben wird
|-
| Domain-Admin || <tt>xyz00-hans</tt> || Der User, dem die Sub-Domain delegiert wurde
|}

=== Quellen ===

Für DAViCal werden neben dem eigentlichen Sourcecode des Projekts noch die PHP-Library [http://andrew.mcmillan.net.nz/projects/awl ''Andrew's Web Libraries''] benötigt. Beides findet sich auf derselben Webseite.

Die jeweils neuste Versionen befinden sich unter
* DAViCal: http://debian.mcmillan.net.nz/packages/davical/
* AWL: http://debian.mcmillan.net.nz/packages/awl/

Hier jeweils die Source-Dateien *.tar.gz benutzen

==== Download ====

<pre><nowiki>
$ cd /home/doms/cal.example.org/var
$ wget http://debian.mcmillan.net.nz/packages/awl/awl-0.46.tar.gz
$ wget http://debian.mcmillan.net.nz/packages/davical/davical-0.9.9.4.tar.gz
</nowiki></pre>

==== Auspacken ====
Um die Dateien für den Betrieb in der Serverumgebung lesbar zu machen wird die Dateierzeungsmaske temporär auf 022 gesetzt.

Symbolische Links erzeugen generische Verzeichnise <tt>davical</tt> und <tt>awl</tt>, die auf die jeweils installierte Version zeigen. Dies erleichtert spätere Versionswechsel.
<pre><nowiki>
$ umask 022
$ tar xfvz awl-0.46.tar.gz
$ tar xfvz davical-0.9.9.4.tar.gz
$ ln -s awl-0.46 awl
$ ln -s davical-0.9.9.4 davical
$ umask 077
</nowiki></pre>

=== PostgreSQL vorbereiten ===

Es wird eine eigene PostgreSQL-Datenbank benötigt, sowie 2 Datenbanknutzer.

==== Datenbank und -Nutzer anlegen ====
{| class="wikitable"
|- class="hintergrundfarbe5"
! Typ !! Wert !! Beschreibung
|-
| DB-Admin || <tt>xyz00_davical_dba</tt> || Der PostgreSQL-Nutzer, dem die Datenbank gehört und administrative Tätigkeiten durchführt
|-
| DB-Nutzer || <tt>xyz00_davical_app</tt> || Der PostgreSQL-Nutzer, der über DAViCal auf die Datenbank lesen/schreibend zugreift
|-
| Datenbank || <tt>xyz00_davical</tt> || Die Datenbank, die alle Daten für den DAViCal-Server enthält
|}

==== Umgebungsvariablen und <tt>.pgpass</tt> ====
Die Nutzer und die Datenbank können über [[Hsadmin]] angelegt werden. Dabei wird <tt>xyz00_davical_dba</tt> als Datenbank-Besitzer angegeben. Als Zeichensatz <tt>UTF-8</tt> (Default) auswählen.

Sowohl für die weitere Installation, als auch für den Betrieb des Servers ist es am besten die Passwörter in die <tt>[http://www.postgresql.org/docs/9.0/interactive/libpq-pgpass.html .pgpass]</tt>-Datei zu schreiben, dann müssen sie nicht innerhalb der PHP-Dateien angebenen werden, bzw. während der Installation manuell eingegeben werden.

<pre><nowiki>
$ echo "localhost:5432:*:xyz00_davical_dba:geheimes_passwort" >> ~/.pgpass
$ echo "localhost:5432:*:xyz00_davical_app:geheimes_passwort" >> ~/.pgpass
$ chmod 0600 ~/.pgpass
</nowiki></pre>

Darüberhinaus werden noch Umgebungsvariablen gesetzt, so daß beim Aufruf von <tt>psql</tt> über die Kommandozeile Datenbankname/Nutzer nicht eingegeben werden müssen. Diese Angaben sind nach Beenden der Shell-Sitzung automatisch zurückgesetzt.

<pre><nowiki>
$ PGHOST=localhost
$ PGUSER=xyz00_davical_dba
$ PGDATABASE=xyz00_davical
$ export PGHOST PGUSER PGDATABASE
</nowiki></pre>

==== PL/pgSQL installieren ====

In der Datenbank wird die prozedurale Sprache PL/pgSQL benötigt. Diese kann folgendermaßen angelegt werden:

<pre><nowiki>
$ psql -A -c "CREATE LANGUAGE plpgsql;"
</nowiki></pre>

=== Datenbank-Tabellen anlegen und initialisieren ===

DAViCal enthält ein eigenes Installations-Skript, das die PostgreSQL-Tabellen anlegt und initialisiert. Dies liegt unter <tt>davical/dba/create-database.sh</tt>. Hier wird aber davon ausgegegangen, daß man Adminrechte hat, was in der Shared-Hosting-Umgebung nicht der Fall ist.

Das Anlegen der Datenbank, der -Nuter und kreieren von PL/pgSQL wurde bereits oben beschrieben. Darüberhinaus sind noch folgende Befehle auszuführen. Diese können in dieser Form einfach nacheinander ausgeführt werden, wenn wie oben beschrieben die <tt>PG*</tt> Umgebungsvariablen gesetzt wurden und die <tt>.pgpass</tt>-Datei gefüllt wurde.

<pre><nowiki>
$ psql -A -f awl/dba/awl-tables.sql
$ psql -A -f awl/dba/schema-management.sql
$ psql -A -f davical/dba/davical.sql
$ ./davical/dba/update-davical-database –dbhost=${PGHOST} –dbuser=${PGUSER} –dbname=${PGDATABASE} --appuser=${PGDATABASE}_app
The database is version 8.4 currently at revision 1.2.9.
No patches were applied.
Supported locales updated.
Updated view: dav_principal.sql applied.
CalDAV functions updated.
RRULE functions updated.
Database permissions updated.
$ psql -A -f davical/dba/base-data.sql
</nowiki></pre>

Für den DAViCal-Admin muß noch ein Passwort gesetzt werden – '<tt>**</tt>' vor dem Passwort ist hier wichtig.

<pre><nowiki>
$ psql -A -c "UPDATE usr SET password = '**geheim' WHERE user_no = 1;"
</nowiki></pre>

=== Konfiguration ===

DAViCal kann über eine <tt>config.php</tt> konfigriert werden. Eine Beispiel-Datei ist unten abgebildet. Details sind im [http://wiki.davical.org/w/Configuration DAViCal-Wiki] zu finden.

<pre><nowiki>
$ cat > davical/config/config.php
$c->pg_connect[] = "dbname=xyz00_davical user=xyz00_davical_app host=localhost";
$c->use_persistent = true;
$c->sysabbr = 'cal@example.org';
$c->admin_email = 'admin@cal.example.org';
$c->system_name = 'CalDAV Server example.org';
$c->default_locale = 'de_DE';
$c->template_usr = array( 'active' => true,
'locale' => 'de_DE',
'date_format_type' => 'E',
'email_ok' => date('Y-m-d')
);
^D
</nowiki></pre>

=== Fast-CGI Patch ===

Bei der Benutzung von Fast-CGI werden die HTTP_AUTHORIZATION Header normalerweise nicht weitergeleitet. Dieses Problem wird auch im DAViCal-Wiki in einem entsprechenden [http://wiki.davical.org/w/FastCGI FAQ-Eintrag] behandelt, aber dort unter der Annahme gelöst, daß man Adminrechte hat.

In der Shared-Hosting-Umgebung von Hostsharing kann dies auch über ein Redirect in der <tt>.htaccess</tt>-Datei gemacht gelöst werden:

<pre><nowiki>
$ cd /home/doms/cal.example.org/htdocs-ssl
$ cat >> .htaccess
RewriteEngine on
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
^D
</nowiki></pre>

Diese Regel muß die letzte in der <tt>.htaccess</tt> sein. Die Datei muß für alle lesbar sein:

<pre><nowiki>
$ chmod 0644 .htaccess
</nowiki></pre>

Darüberhinaus muß noch die Datei <tt>davical/inc/HTTPAuthSession.php</tt> angepasst werden. Hier ist die Variable <tt>$_SERVER["AUTHORIZATION"]</tt> ersetzt werden durch <tt>$_SERVER["REDIRECT_HTTP_AUTHORIZATION"]</tt>. Außerdem gibt es noch einen Bug: Es wird an einer Stelle <tt>split()</tt> statt <tt>explode</tt> benutzt. <tt>split()</tt> ist seit PHP 5.3.0 ''deprecated''.

@@ -87,8 +87,8 @@
/**
* Get HTTP Auth to work with PHP+FastCGI
*/
- if (isset($_SERVER["AUTHORIZATION"]) && !empty($_SERVER["AUTHORIZATION"])) {
- list ($type, $cred) = split (" ", $_SERVER['AUTHORIZATION']);
+ if (isset($_SERVER["REDIRECT_HTTP_AUTHORIZATION"]) && !empty($_SERVER["REDIRECT_HTTP_AUTHORIZATION"])) {
+ list ($type, $cred) = explode (" ", $_SERVER['REDIRECT_HTTP_AUTHORIZATION']);
if ($type == 'Basic') {
list ($user, $pass) = explode (":", base64_decode($cred));
$_SERVER['PHP_AUTH_USER'] = $user; }

[[Bild:DAViCAl-home.png‎|miniatur|400px|right|Screenshot DAViCal Einloggen]]
=== Webspace aktivieren ===

Schließlich muß die Installation noch mit dem Webspace verknüpft werden.
<pre><nowiki>
$ cd /home/doms/cal.example.org
$ rm htdocs-ssl
$ ln -s var/davical/htdocs htdocs-ssl
</nowiki></pre>

Die URL des User-Interfaces lautet: '''<tt><nowiki>https://cal.example.org</nowiki></tt>'''

Wenn alles richtig gemacht wurde, erscheint der Login-Screen.

== Nutzung ==

=== User anlegen und konfigurieren ===

Im User-Interface muß man sich als Admin (oder Nutzer mit Adminrechten) einloggen um neue Nutzer anzulegen.

Um einen neuen Nutzer anzulegen: '''Menu''' → '''User Functions''' → '''Create Principal'''

{| class="wikitable"
|- class="hintergrundfarbe5"
! Feld !! Wert !! Beschreibung
|-
| Principal ID || ''New Principal'' || Bei neuen Nutzern wird das Feld automatisch beim Anlegen gefüllt
|-
| Username || hans || Nutzername für den Kalender. Der Username ist Bestandteil der Kalender-URL
|-
| Change Password || geheimespasswort ||
|-
| Confirm Password || geheimespasswort ||
|-
| Fullname || Hans Meier || Der Name des Nutzers
|-
| Email Address || hans@example.org || Über die Email-Adresse ist der Nutzer für andere Nutzer im System zu finden, z.B. für Einladungen
|-
| Locale || Deutsch ||
|-
| Date Format Style || European ||
|-
| Principal Type || Person || Üblicherweise Person für einen natürlichen Nutzer (hier können auch Ressourcen und Gruppen angelegt werden)
|-
| Administrator || – || Falls der User Adminrechte bekommen soll
|-
| Active || X || Soll der Nutzer aktiv geführt werden?
|}

Beim Anlegen des '''ersten''' Nutzers erscheint eine Fehlermeldung:

ERROR: SQL error "23505" - ERROR: duplicate key value violates unique constraint "principal_pkey""
Home calendar added. 

Dies ist ein Bug. Siehe auch [http://lists.morphoss.com/pipermail/davical-dev/2011/000117.html Thread in Dev-Mailingliste].

Zum Umgehen des Bugs einfach den Nutzer nochmal anlegen und dann funktioniert alles ;-)

=== Zugriff über Client-Programme ===

Der Zugriff auf den Kalender erfolgt über die URL: '''<tt><nowiki>https://cal.example.org/caldav.php/user/home</nowiki></tt>'''

* user = Name des angelegte Nutzers, also z.B. '''<tt>hans</tt>'''
* home = Name des angelegten Kalenders; dies ist standardmäßig '''<tt>home</tt>'''. Andere Kalender (''collection'') können im User-Interface vom Nutzer angelegt werden, oder durch einen Client, der MKCALENDAR implementiert hat, so z.B. iCal oder Mulberry

==== Beispiel Thunderbird ====

Ist in Thunderbird die Lightning-Erweiterung installiert, dann kann der Kalender folgendermaßen eingerichtet werden:

'''Menu''' → '''Datei''' → '''Neu''' → '''Kalender'''

Auf den Folgenden Seiten ist auszuwählen:
* ''Im Netzwerk''
* ''CalDAV''
* Spezifische Angaben
** Name, z.B. ''hans@example''
** Farbe: auswählen in welcher Farbe der Kalender angezeigt werden soll
** Alarm: ja
** Email: Email auswählen

Zusätzlich wird es wahrscheinlich noch eine Wahrnung geben, daß das SSL-Zertifikat ungültig ist, da in der Standard Hostsharing Konfiguration das hostsharing-Zertifikat ausgeliefert wird. Dieses muß dann noch importiert und akzeptiert werden.

Thunderbird fragt dann noch nach Nuternamen und Passwort und wenn man erlaubt diese im Programm zu speichern, dann loggt sich Thunderbird zukünfitg selbständig ein.

===== Mehrere Kalender auf gleichem Server =====

Hat man mehrere Kalender auf dem gleichen Server – also z.B. mehrere User oder für einen User mehrere ''collections'', dann kann Thunderbird diese nicht unterscheiden. Der Passwort-Manager arbeitet auf Grundlage der Domain. Siehe auch [https://bugzilla.mozilla.org/show_bug.cgi?id=247486 Bugzilla].

Diesen Bug kann man relativ einfach umgehen, indem man weitere Subdomains anlegt, die auf die gleiche Installation verweisen, also z.B.

<pre><nowiki>
$ cd /home/doms/example.org/subs-ssl
$ mkdir cal1
$ mkdir cal2
</nowiki></pre>

und jeweils eine <tt>.htaccess</tt> in die neuen Verzeichnis mit folgendem Inhalt schreibt:

<pre><nowiki>
RewriteEngine on
RewriteRule ^.htaccess$ - [F]
RewriteRule ^(.*)$ https://cal.example.org/$1 [P]
</nowiki></pre>

Nicht vergessen:

<pre><nowiki>
chmod 0644 cal1/.htaccess
chmod 0644 cal2/.htaccess
</nowiki></pre>

Hat man z.B. für User <tt>hans</tt> die Kalender <tt>home</tt> und <tt>work</tt> und für User <tt>maria</tt> den Kalender <tt>home</tt> und möchte diese aus derselben Thunderbird-Instanz benutzen, können folgende URL's in Thundebrird konfiguriert werden:

* '''<tt><nowiki>https://cal.example.org/caldav.php/hans/home</nowiki></tt>'''
* '''<tt><nowiki>https://cal1.example.org/caldav.php/hans/work</nowiki></tt>'''
* '''<tt><nowiki>https://cal2.example.org/caldav.php/maria/home</nowiki></tt>'''

== URL Rewriting für kürzere URL's ==

TODO: .htaccess Beispiel

== Weiterführende Links ==

* WIKI von DAViCal: http://wiki.davical.org
** [http://wiki.davical.org/w/CalDAV_Clients CalDAV Clients]

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:DAViCal]]

FAQ

2011-11-03T08:17:54Z

Hsh00-mhi: /* Meine Email wurde abgelehnt, obwohl sie kleiner als 32 MB ist */

{{HSDoku-Links}}

FAQ heißt Frequently Asked Questions - Fragen, die immer wieder gestellt werden. Hier ist der Platz, sie zu beantworten.

== Domains ==

=== Domain bei anderem Provider, Subdomain bei HS und umgekehrt ===
:Fall A -> Domain example.com bei Anbieter XY
:Subdomain test.example.com bei Hostsharing
:Was ist zu tun?
:* Bei Anbieter XY sollten DNS-Einträge geschaltet werden, damit Hostsharing die Subdomain verwalten kann:

:test.example.com. IN NS dns1.hostsharing.net.
:test.example.com. IN NS dns2.hostsharing.net.
:test.example.com. IN NS dns3.hostsharing.net.

:* Bei Hostsharing kann die Domain test.example.com nun via HSAdmin hinzugefügt werden. Im Domainbestellsystem ist keine Aktion erforderlich, da es sich nicht um eine Domain-Registrierung handelt.

:Welche Voraussetzungen sind zu erfüllen?
:Anbieter XY muss die entsprechend DNS-Schaltung ermöglichen.

:Welche Kosten fallen an?
:Bei Hostsharing fallen keine Kosten an, abgesehen vom Webspace- und Traffic-Bedarf des Angebots unter test.example.com.

:Fall B -> Domain example.com bei Hostsharing
:Subdomain test.example.com bei Anbieter XY

:Was ist zu tun?
:* Bei Hostsharing sollten über die Zonefile-Verwaltung DNS-Einträge geschaltet werden, so dass der Anbieter XY die Subdomain verwalten kann.

:test.example.com. IN NS <DNS-Server 1 des Anbieters>
:test.example.com. IN NS <DNS-Server 2 des Anbieters>
:...

:Die Angaben sind bei dem entsprechenden Anbieter zu erfragen.
:* Die Subdomain kann anschließend bei bei Anbieter XY geschaltet werden.

:Welche Voraussetzungen sind zu erfüllen?
:Anbieter XY muss Aufschaltung von Subdomains unterstützen.

:Welche Kosten fallen an?
:Bei Hostsharing fallen keine Kosten an, abgesehen vom ohnehin zu leistenden Entgelt für die Domain example.com.

=== Wie komme ich an einen Auth Code für eine hier gehostete .com/.de Domain? ===

: Kann im Account des [https://domain-bestellsystem.de Domain-Bestellsystem ] selbst abgefragt, bzw. erzeugt werden:
"Auftragsübersicht" wählen, dort die Domain anklicken, unter "Ausführbare Aktionen". (nicht im KK-Center.)

=== Was sind CNO-Domains? ===
:CNO steht für "COM", "NET" und "ORG". Im Gegensatz zu DE-Domains,welche auf ".de" enden (z.B. hostsharing.de), enden CNO - Domains auf ".com", ".net" oder ".org" (z.B. hostsharing.net).
:Im Allgemeinen steht .com für ein kommerzielles Angebot und .org für eine nicht kommerzielle Organisation. Die Endung .net wird heute oft genutzt, wenn die entsprechende .com - Domain bereits vergeben ist und ist weit verbreitet.

=== Wie mache ich zwei Domain-Verzeichnisse identisch, die zwei unterschiedlichen usern gehören? ===

:Das ist nicht möglich.

=== Wie ändere ich den Domain Admin ? ===

:Als Domainadmin informiere Deinen Paketadmin.
:Als Paketadmin siehe [[Domains]].

=== Wie ändere Ich Adress-Daten vom Domain Inhaber / Admin? (whois)===
Im Feb 2010 wurden an alle HS Mitglieder die Zugangsdaten für unser
[https://domain-bestellsystem.de Domain-Bestellsystem ] versendet.
Dort kann auch die gesamte Adresse oder nur Telefon und eMail Daten geändert werden.
Wer diese Zugangsdaten nicht mehr hat kurze eMail an service@hostsharing.net
:Nach der Anmeldung auf Menüpunkt "Handleverwaltung"
:Dann bei "Suchen" die HandleID und bei im Feld "Handle-ID" auswählen -> Button "suchen"
:Die aktuelle HandleID über Menü "Auftragsübersicht" und dann auf die "Domain" klicken.

== Email ==

=== Meine Email wurde abgelehnt, obwohl sie kleiner als 128 MB ist ===

:Du hast nicht bedacht, dass der Anhang durch die Kodierung an Größe zunimmt. Siehe [[Größenbeschränkung von E-Mails]]

=== Was bedeutet die Fehlermeldung 554 hop-count exceeded in einer E-Mail ? ===

: Eine Mail ist zwischen zwei Adressen weitergeleitet und es entstand eine Weiterleitungsschleife. Im Mailserver gibt es die Einstellung: hopcount_limit = 50. Wenn eine Mail über 50 Emailserver ging, dann wird die gebounced. Damit verhindert man solche Schleifen.

=== Unser MX und unser Backup-MX zeigen auf verschiedene Rechner. ===

:Muss ich bei zwei Rechnern E-Mails abrufen, wenn ich den Backup-MX Dienst nutzen will?

:Nein. Die E-Mails werden zum Backup-MX Server geliefert, falls und solange der MX Server gerade nicht erreichbar ist. Sie bleiben dort solange in der E-Mail Warteschlange zwischengespeichert, bis der Backup-MX Server den normalen MX Server erreicht, dann fängt der an, die E-Mails dorthin weiterzureichen. Das ist in aller Regel innerhalb so kurzer Zeit der Fall, so dass es sich nicht lohnt, händisch einzugreifen. Bei längeren Ausfällen werden die Hostmaster für eine generelle Lösung sorgen, die wahrscheinlich auch ohne Umkonfigurieren für uns auskommt.

=== Nutzung der E-Mail Postfächer in SW und DW Paket ===
:Kann ich E-Mail-Adr deren Domain in einem DW-Paket ist in einem SW-Paket nutzen?

:Ja, folgende beiden Möglichkeiten gibt es a) Die Subdomain mail.example.org ins SW legen und per Catch-All von @example.org nach @mail.example.org leiten und dort passende E-Mail-Adressen Postfächer einrichten. (Leichter nachträglich einzurichten.) b) Die Domain example.org im SW aufschalten und www.example.org im DW aufschalten. E-Mail dann direkt im SW abhandeln. (Technisch besser.)

== WWW ==

=== Meine Webseite ist nicht erreichbar ===

: Schau auf http://status.hostsharing.net - da kannst Du sehen, ob es ein Problem auf dem Server von HS gibt. Siehe [[Überwachung der HS-Dienste]]

=== Wieviel Speicherplatz haben meine User in meinem Paket belegt? ===

:siehe [[DW-Speicherbelegung]].

=== kein Verzeichnislisting anzeigen ===

: Am elegantesten erledigt man das mit einer [[.htaccess]] Datei.
: Eine andere Möglichkeit besteht darin, einfach eine Datei index.html in das Verzeichnis zu legen. Sie kann leer sein oder einen Hinweis der Art: Diese Seite wurde absichtlich leer gelassen enthalten.

=== Wie unterscheide ich, ob ein Script per https angesprochen wurde? ===

:Weil https über einen eigenen Port läuft, ist das recht einfach. Diese php-Abfrage prüft das ab:
<pre>
$cfgPmaAbsoluteUri = 'http'.(($_SERVER['SERVER_PORT']==443)?'s':'').'://hostsharing.net/';
</pre>
:und baut entweder ein s in den String ein oder eben nichts ('').
:Das Ergebnis ist dann entweder 'http://hostsharing.net' oder 'https://hostsharing.net'.
:
:Mehr auch unter [[.htaccess]] oder ggf auch [[SSL]] .

=== winscp installiert, bekomme aber anstatt eines Zugriffs nur die Warnung: "Public key packet not received" ===

: Dein Programm kann nur/ist auf Protokoll Version 1.5 eingestellt. Du brauchst aber Protokoll Version 2.0.

== Datenbank ==

=== Wie bekomme ich meinen dump in die mysql-Datenbank? ===

:Du kopierst den dump auf den hs Rechner. Egal wohin!
:Dann:

mysql -u xyz00 -p dein_datenbank_name< name_des_dumps.
Jetzt dein Passwort der Datenbank angeben.

== Host / Server ==

=== Wie heißt auf dem Host das Kommando, welches ...? ===
=== Haben wir auf unserm Server ein Programm für ... ? ===

:Wie man sowas findet:

:Finde ein möglichst spezielles Stichwort zum Thema (vorzugsweise in englisch):
<pre>
1. auf unserem Server einloggen,

2. apropos stichwort eingeben,

3. für jedes interessant klingende Programm man Programmname eingeben, lesen.
</pre>

== Pakete allg. ==

=== Sind für Pakete auch besondere Konfigurationen zu erhalten? ===

Da die Betreuung von Sonderkonfigurationen einen erheblichen Aufwand bedeutet, versuchen wir diese Wünsche entweder in die Standardkonfiguration einzubauen oder zumindest konfigurierbar zu machen. Die Entscheidung treffen in letzter Instanz die Hostmaster.

=== Welche Parameter müssen angegeben werden, wenn über FTP auf ein Paket zugegriffen werden soll? ===

Der Zugriff ist entweder über die IP-Nummer oder dem Domainnamen (z.B. ftp.example.com) möglich. Username und Passwort wurden bei bei der Einrichtung des Paketes mitgeteilt oder selbst vergeben.

Für Windows-Nutzer:

Für die Datenübertragung immer auf Unix einstellen wenn die Option vorhanden ist (z.b. bei WS-FTP). Scripte und Konfigurationsdateien IMMER im ASCII-Modus übertragen! Sonst können sie evtl. nicht richtig verwendet werden.

Generell raten wir von FTP aus Sicherheitsgründen ab.

[[Kategorie:HSDoku]]
[[Kategorie:Glossar]]