Hostsharing Wiki - Benutzerbeiträge [de]

Hsadmin

2011-03-10T18:49:57Z

Jrs00-wiki: Link auf hsadmin.de entfernt, dort ist keine Projektseite mehr

{{HSDoku-Links}}

[https://admin.hostsharing.net/ hsadmin] ist ein von HS entwickltes Konfigurations-Werkzeug für Internet-Server, das speziell zu der flexiblen Konfiguration der Webspace-Angebote der [http://www.hostsharing.net Hostsharing eG] passt.

== hsadmin ==

Hsadmin ist ein Konfigurationswerkzeug für das eigene Paket. Es kann sowohl über einen Webbrowser, als auch von der Kommandozeile der Linux Shell aus benutzt werden.

Die Bedienung erfolgt über ein [[WebFrontend]] (auch für die Kunden eines Resellers oder das eigene Personal), das Kommandozeilen-Frontend [[Hsadmin#Command-Line-Client | hsadmin CLI]] (zum Beispiel für Skripte), oder über eine Programmierschnittstelle (für eigene selbst gestaltete Frontends). Das Kernsystem ermöglicht von der Kundenverwaltung (Kontaktdaten, Rechnungen, gebuchte Pakete und so weiter) über die Paketverwaltung (Unix-Accounts, Datenbanken, Datenbank-User etc.) und der Domainverwaltung (E-Mail-Adressen einrichten und so weiter) ein breites Spektrum der Konfiguration.

hsadmin ist OpenSource (GPL) und basiert im Wesentlichen auf der Java Enterprise Edition. Es besteht aus einem Web-Client (JSP/JSF) und einem Kommandozeilen-Client (C Programming language) einem Server (EJB3) für die Anwendungslogik und einem Queue-Server für die Systemkommandos (JMS-Client). Die Zugangskontrolle erfolgt orientiert an Rollen und den Datensätzen im Server (an der EJB3-Schnittstelle). Direkte root-Rechte werden nur von dem relativ kleinen Queue-Server benötigt.

== Aktuell freigeschaltete Module ==

Mit hsadmin können derzeit folgende Verwaltungsaufgaben erledigt werden:

{|class="wikitable"
|- class="hintergrundfarbe5"
!Modul !!Beschreibung / Anleitung
|-
|WebFrontend||Die Funktionen der Kommandozeile per Browser [[WebFrontend]]
|-
|Benutzerverwaltung||Anleitung für Kommandozeile. Beschreibung steht in [[User]]
|-
|E-Mail Adressen||Anleitung für Kommandozeile. Beschreibung steht in [[hsadmin-mail|E-Mail]]
|-
|E-Mail Alias||Anleitung für Kommandozeile. Beschreibung steht in [[Aliases]]
|-
|Domain Status||Anleitung für Kommandozeile. Beschreibung steht in [[domains|Domain]]
|-
|MySQL User||Anleitung für Kommandozeile. Beschreibung steht in [[Datenbanken]]
|-
|MySQL Datenbanken||Anleitung für Kommandozeile. Beschreibung steht in [[Datenbanken]]
|-
|Postgres User||Anleitung für Kommandozeile. Beschreibung steht in [[Datenbanken]]
|-
|Postgres Datenbanken||Anleitung für Kommandozeile. Beschreibung steht in [[Datenbanken]]
|}

== Passwort und Konfiguration des hsadmin Command-Line-Client ==

Das eigene Passwort muss dabei nur einmalig pro Session eingegeben werden. Ein sogenanntes Ticket-Granting-Ticket (TGT) wird dafür in ~/hsadmin.tgt
gespeichert. Zudem kann man eine Konfigurations-Datei ~/.hsadmin.conf anlegen,in der i.d.R. folgende Einträge sinnvoll sind:

<pre>
userName=xyz00
passWord=geheim
passWord.xyz00=geheim
passWord.hsh00-xyz=geheim
</pre>

Der Username wird per Default vom Login-User genommen oder kann mit '''-u/--user:''' angegeben werden. Die Reihenfolge ist:
# Username von der Kommandozeile (-u/--user:),
# der UserName aus dem Eintrag userName=... in der .hsadmin.conf,
# der Login-Username.

Das Passwort wird nur benötigt, falls es für den jeweiligen USer kein gültiges TGT mehr in der .hsadmin.tgt mehr gibt.
Es wird zunächst in der .hsadmin.conf aus dem konkreten Eintrag (passWord.xyz=...), dann aus dem allgemeinen (passWord=...) genommen,
falls es nicht gefunden wird, wird es erfragt. Bevor Scripte ausgeführt werden, oder die Ein- oder Ausgabe von hsadmin umleitet werden,
sollte also immer für ein gültiges TGT gesorgt werden, z.B. durch Aufruf einer Dummy.Funktion wie:
<pre>
hsadmin -c modules.version
</pre>

Man kann sich das Programm hsadmin auch lokal installieren. Dazu gehört ein Shell-Startscript und ein jar-File. Es wird Java6 benötigt. Dies sind die benötigten Datein, sie können von einem HS-Server kopiert werden:

:'''/usr/local/bin/hsadmin'''
:'''/usr/local/lib/hostsharing/hsadmin/HSadminCLI.jar'''

Das Startscript steht derzeit leider nur für UNIX-ähnliche Systeme als bash-Script zur Verfügung. Eine Windows-Version sollte sich aber leicht erstellen lassen.

Eine Anmerkung noch: hsadmin läuft derzeit noch mangels besserer Alternativen auf einem sehr leistungsschwachen Server. Wir bitten daher
von großen Experimenten abzusehen und nur wirkliche Aufgaben über die neuen Schnittstelle auszuführen.

== Verwendung des hsadmin Command-Line-Client ==
die Optionen des Kommandozeilen-Frontend (CLI) für die Arbeit auf der [[Shell]] erscheinen dem einen oder anderen evtl. etwas umständlich. Das hat folgende Bewandnis:

Eine Anforderung war, dass das hsadmin CLI auch lokal installieren werden kann und es dennoch neue Module bedienen kann. D.h. das CLI hat inhaltlich kaum Informationen und leitet alles nach "Schema-F" an den Server weiter und gibt einfach dessen Ausgabe wieder aus - ohne diese großartig zu interpretieren.

Der Grundaufbau für den Aufruf von der [[Shell]] aus ist:

:'''hsadmin LOKALE-OPTIONEN GLOBAL-REMOTE-OPTIONEN MODUL.FUNKTION REMOTE-OPTIONEN OIDS ...'''

Die lokalen (vom hsadmin CLI selbst interpretierten) Optionen sind:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Option !! Bedeutung lokale Option
|-
| -u /--user ||für den UNIX-Usernamen, unter dem das Programm arbeiten soll
|-
| -v /--version|| gibt die Versionsnummer des hsadmin CLI aus
|-
| -V /--verbosity || gibt den Gesprächtigkeits-Level 0-2 an (zum Debuggen)
|-
| - || liest weitere Remote-Parameter von stdin ein
|}

Für die globalen Optionen siehe weiter unten.

Der eigentliche Funktionsaufruf wird mit -c /--call: eingeleitet. Dann folgt ein Modulname und ein Funktionsname, z.B. "user.search". Derzeit sind die folgenden Module freigegeben:

:q - für die Auftrags-Queue in den Hives
:user - für die UNIX-User inkl. Mailboxen

{{Textkasten|rot|Anmerkung:|Falls andere Module, als die hier beschriebenen, teilweise im Live-Test sind, gibt es sie schon, obwohl sie noch nicht freigegeben sind. Wer sie aber verwendet, wird ggf. mit unwiderruflichem Datenverlust bestraft. ;-) }}

Dann folgen die Parameter für diesen Funktionsaufruf. Hier gibt es folgende Gruppen:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter !! Bedeutung für den Aufruf der Funktion
|-
| -w /--where:feld=wert || Abfrage nach einem bestimmten Wert eines bestimmten Feldes.
|-
| -s /--set || Setzen des Wertes eines bestimmten Feldes (wird ggf. ignoriert, z.b. bei *.search).
|-
| -d /--display:format || Spezifiziert das Ausgabeformat. (Hat bei Funktionen ohne Daten-Ausgabe keine Wirkung.)
|}

Die OIDS sind direkte Objekt-Identifier wie der Username (xyz00-test), der Paketname (xyz00), die Domain (example.org) oder die E-Mail-Adresse (test@exampl.org). Es können mehrere angegeben werden. Im Prinzip ist das nur eine Kurzform der jeweiligen -w Option, nur dass eben auch mehrere angegeben werden können.

Die globalen Optionen entsprechen den o.g. -w/-s/-d, nur dass sie für alle im selben hsadmin-Aufruf folgenden Funktionen gelten:

:-W /--globalWhere:feld.wert
:-S /--globalSet:feld.wert
:-D /--globalDisplay:format

=== Ein paar Fallen ===

* Wenn man zwar Funktionsaufrufe per stdin in das CLI hineingibt,<br/> aber den "-" vergisst, dann werden diese einfach ignoriert.<br/>stdin wird aber ggf. auch anderweitig gebraucht, weshalb<br/>"-" nicht automatisch angenommen wird.

* Wenn man gleich den ersten Aufruf mit "-" macht, wird dies derzeit noch als Passwort eingelesen, was natürlich dann schon zu einem Login-Fehler führt.<br/>Trick:Entweder das Passwort in der ~/.hsadmin.conf hinterlegen oder zunächst irgendeine andere Funktion aufrufen, die das Passwort abfragt und das TGT speichert.

Die Error-Codes ($? in bash-Scripten) sind derzeit noch recht unspezifisch. Geplant ist eine Unterscheidung zwischen wirklich unbekannten Fehlern (z.B. Fehlern in hsadmin), Remote- Kommunikations-Fehlern (wo man es dann einfach nochmal probieren könnte) und fachlichen Fehlern (bei denen man dann wohl hsadmin falsch bedient hat).

== hsadmin Status von Änderungen ==

<pre>
hsadmin -c q.search | sort -n -t'|' -k2
</pre>
So werden die letzten Aktion sortiert angezeigt, bitte besonders den "Status" beachten.

'''Hinweis:''' Die Spaltenreihenfolge (und damit auch das "-k2") ist nicht wirklich gesteuert und der default wird sich auch sicherlich nochmal ändern.
Wer zuverlässige Spalten braucht, sollte das Display-Format angeben!

----
[[Kategorie:HSDoku]]
[[Kategorie:hsadmin]]
[[Kategorie:Glossar]]

Verwalten der Zonendaten

2011-01-21T18:36:37Z

Jrs00-wiki: "mail" durch {MX1_HOSTNAME} ersetzt in der Zonefile-Vorlage.

{{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).

Es sieht standardmäßig in etwa wie folgt aus:

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

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

IN MX 30 xyz00.hostsharing.net.
IN MX 80 backupmx.hostsharing.net.

IN A 83.223.95.30

www IN A 83.223.95.30
ftp IN A 83.223.95.30
pop3 IN A 83.223.95.30
mail IN A 83.223.95.30
mysql IN A 83.223.95.30
pgsql IN A 83.223.95.30
*.example.org. IN A 83.223.95.30
</nowiki></pre>

Der erste Block SOA definiert die "Start Of Authority" Ressource. Der wichtigste Eintrag hier ist die Seriennummer. Diese wird von den DNS-Servern benutzt, um eine Änderung zu erkennen. Deshalb muss diese Nummer bei jeder Anpassung erhöht werden, sonst wird die Änderung nicht vollständig im Internet verbreitet. Der konkrete Wert ist nicht wichtig, so dass man durchaus auch einfach die dort stehende Zahl um eins erhöhen kann. In der Regel verwenden wir hier die Anzahl der Sekunden seit 1970, die für den Platzhalter {SIO} (s. unten) eingetragen wird.

== Änderungen ==

Domainadmins können Änderungen beauftragen. Dafür ist ein vollständiges Zonefile im Konfigurationsverzeichnis <tt>etc</tt> der Domain abzulegen.

Am besten man beginnt mit der folgenden universellen Vorlage. Sie enthält Platzhalter, die bei der Übernahme der Konfiguration vom HS Robot automatisch durch die aktuellen Werte ersetzt werden:

<pre>
$TTL {TTL}
{DOM_HOSTNAME}. IN SOA {HS_DNS1_HOSTNAME}. hostmaster.hostsharing.net. (
{SIO} ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)
; please read https://wiki.hostsharing.net/index.php?title=Domains:Verwalten_der_Zonendaten
IN NS {HS_DNS1_HOSTNAME}.
IN NS {HS_DNS2_HOSTNAME}.
IN NS {HS_DNS3_HOSTNAME}.
IN MX 30 {MX1_HOSTNAME}.
IN MX 80 {MX2_HOSTNAME}.
IN A {DOM_IPNUMBER}
www IN A {DOM_IPNUMBER}
ftp IN A {FTP_IPNUMBER}
pop3 IN A {POP3_IPNUMBER}
imap IN A {IMAP_IPNUMBER}
mail IN A {SMTP_IPNUMBER}
mysql IN A {MYSQL_IPNUMBER}
pgsql IN A {PGSQL_IPNUMBER}
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

Man speichert diese Vorlage unter /home/doms/example.com/etc/pri.example.com und kann sie dann bearbeiten und eigene Einträge ergänzen.

Beispiele:
; externe Server per "CNAME Record" eintragen
wackelserver IN CNAME server0815.massenhoster-domain.tld
homeip IN CNAME mein-nick.dyn-ip-service.tld

; www Domaindelegation (Freigabe zur Aufschaltung in separatem Dynamic-Web Paket)
; (Bestehender "A Record" der www Domain muss zudem entfernt werden.)
www IN NS {HS_DNS1_HOSTNAME}.
www IN NS {HS_DNS2_HOSTNAME}.
www IN NS {HS_DNS3_HOSTNAME}.

soll statt www eine subdomain deligiert werden muss dieser Eintrag am Ende der pri.example.com Datei stehen, also nach:
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}

Danach legt man im Zielpaket die Subdomain an:
hsadmin -c domain.add -s name=subdomain.example.tld -s user=xyz12

Nach einer Änderung an einem selbstverwalteten Zonefile dauert es noch einige Minuten, bis die Änderungen von unserem DNS-Servern übernommen werden. Bis die DNS-Caches der Welt eine Änderung mitbekommen, kann es natürlich noch etwas länger dauern. (Mindestens entsprechend der Zeitangaben im oberen Teil des zuvor aktiven Zonefiles.)

'''Hinweis:'''

Wenn man ein eigenes Zonefile in /home/doms/example.org/etc löscht, bleibt in den HS Nameservern der letzte Stand erhalten! Falls man für eine Domain wieder ein Hostsharing-Standard-Zonefile haben möchte, muss man ein leeres (= 0 Bytes) Zonefile anlegen:

echo -n > /home/doms/example.org/etc/pri.example.org

Das -n ist wichtig, sonst ist die Datei nicht wirklich leer und es gibt Fehlermeldungen!

== 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.
* Die Secondaries 213.133.116.2 und 62.75.149.27 holen die geänderten Daten ab. (Pro Secondary jeweils ein Eintrag.)

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 von IP-Adressen und Hostnamen, ohne daß jeder Domainadmin seine Zonefiles anpassen muß. Insbesondere wird das Verschieben von Paketen zwischen physikalischen Hosts damit vereinfacht.

; {PAC_IPNUMBER} : IP-Nummer des [[Hives]] in dem sich das [[Paket]] befindet
; {PAC_HOSTNAME} : Hostname ([[Hive]])
; {DOM_IPNUMBER} : IP-Nummer
; {DOM_HOSTNAME} :

; {MYSQL_IPNUMBER}
; {MYSQL_HOSTNAME}
; {PGSQL_IPNUMBER}
; {PGSQL_HOSTNAME}

; {FTP_IPNUMBER}
; {FTP_HOSTNAME}

; {SMTP_IPNUMBER}
; {SMTP_HOSTNAME}
; {POP3_IPNUMBER}
; {POP3_HOSTNAME}
; {IMAP_IPNUMBER}
; {IMAP_HOSTNAME}

; {PAC_DNS_MASTER}
; {HS_DNS1_IPNUMBER}
; {HS_DNS2_IPNUMBER}
; {HS_DNS3_IPNUMBER}
; {HS_DNS1_HOSTNAME}
; {HS_DNS2_HOSTNAME}
; {HS_DNS3_HOSTNAME}

; {TTL}
; {SIO} : Timestamp (Millisekunden)

; {MX1_IPNUMBER}
; {MX1_HOSTNAME}
; {MX2_IPNUMBER}
; {MX2_HOSTNAME}

Die Hostnamen verstehen sich allesamt ohne den in Zonenfiles oft benötigten abschließenden Punkt.

Es wird dringend empfohlen, in eigenen Zonenfiles diese Platzhalter zu verwenden. Nur so können Domains bei Änderungen von IP Nummern oder anderen Umstrukturierungen weiter erreichbar bleiben, ohne selbst auf solche Ankündigungen und Ereignisse achten zu müssen und Anpassungen selber vornehmen zu müssen.

== Beispiele ==

=== Domain Delegation ===
HowTo: erläutern.

<pre>
[...]
pic.example.org. IN NS {HS_DNS1_HOSTNAME}.
pic.example.org. IN NS {HS_DNS2_HOSTNAME}.
pic.example.org. IN NS {HS_DNS3_HOSTNAME}.
</pre>
----
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]

Mailclient einrichten

2009-06-02T19:19:02Z

Jrs00-wiki: Screenshots eingefügt.

== Posteingangsserver ==

[[Bild:Screenshot-thunderbird-pop-server.png|thumb|Einstellungsdialog von Thunderbird 2]]

Der Zugriff auf das Postfach ist über POP3 oder IMAP möglich. Für den Zugriff muss der Mailclient wie folgt konfiguriert werden:

; Server : ''xyz00''.hostsharing.net, dabei ist ''xyz00'' durch den Namen des Pakets zu ersetzen.

; Benutzername : Der Name des Benutzers, auf dessen Postfach zugegriffen werden soll, zum Beispiel xyz00-mustermann.

; Sicherheit : Es sollte eine verschlüsselte Verbindung (SSL) gewählt werden. Der Port des Servers ist dann 995.

== Postausgangsserver ==

[[Bild:Screenshot-thunderbird-smtp-server.png|thumb|Einstellungsdialog von Thunderbird 2]]

Um E-Mails mit dem Mailclient über Hostsharing senden zu können, muss der Paketserver als Postausgangsserver eingerichtet werden. Dabei muss die Benutzerauthentifizierung aktiviert werden.

; Server : ''xyz00''.hostsharing.net, dabei ist ''xyz00'' durch den Namen des Pakets zu ersetzen.

; Benutzername : Der Name eines Benutzers auf dem Paketserver. In der Regel derselbe Name wie für den Posteingangsserver.

; Sicherheit : Wie beim Empfang sollte auch hier eine SSL-verschlüsselte Verbindung gewählt werden. Der Serverport ist dann 465.

== Sicherheitshinweis ==

Wir empfehlen aus Sicherheitsgründen dringend, sowohl beim Empfang als auch beim Senden ausschließlich verschlüsselte Verbindungen zu verwenden, wie oben dokumentiert. '''Achtung:''' viele Mailclients richten beim Erstellen eines neuen Kontos über einen Assistenten dieses standardmäßig so ein, dass die Verschlüsselung ausgeschaltet ist. Du solltest diese einschalten, bevor du mit dem neu angelegten Koto erstmals Mails abrufst.

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

Datei:Screenshot-thunderbird-pop-server.png

2009-06-02T19:15:51Z

Jrs00-wiki: Screenshot des Einstellungsdialogs für den Posteingangsserver (mit POP3) von Thunderbird 2 unter Windows XP.

Screenshot des Einstellungsdialogs für den Posteingangsserver (mit POP3) von Thunderbird 2 unter Windows XP.

Datei:Screenshot-thunderbird-smtp-server.png

2009-06-02T19:15:13Z

Jrs00-wiki: Screenshot des Einstellungsdialogs für den Postausgangsserver von Thunderbird 2 unter Windows XP.

Screenshot des Einstellungsdialogs für den Postausgangsserver von Thunderbird 2 unter Windows XP.

E-Mail

2009-06-02T18:40:15Z

Jrs00-wiki: Links aus dem Abschnitt "Weiterführende Links" entfernt bzw. in den Text eingepflegt

{{HSDoku-Links}}

== E-Mail empfangen und senden ==

Jeder Benutzer, für den ein [[user|Benutzerkonto]] in einem Hostsharing-Paket eingerichtet ist, besitzt automatisch ein Postfach und kann E-Mail über Hostsharing empfangen und senden. Dafür kann entweder unser [[Webmail]]-System oder ein beliebiger anderer Mailclient verwendet werden, zum Beispiel [http://www.mozilla-europe.org/de/products/thunderbird/ Thunderbird]. Wie der Mailclient einzurichten ist, ist unter [[Mailclient einrichten]] beschrieben.

Damit ein Benutzer Nachrichten empfangen kann, muss natürlich außerdem eine [[E-Mail-Adressen einrichten|E-Mail-Adresse]] entsprechend eingerichtet werden, sodass Nachrichten an diese Adresse in das Postfach des Benutzers ausgeliefert werden. Jeder Paketadmin hat automatisch einige [[Standard Email Adressen|Standard-Adressen]].

Die Hostsharing-Server akzeptieren Mail-Nachrichten nur bis zu einer [[Größenbeschränkung von E-Mails|maximalen Größe]] von netto 32 MB. In der Praxis bedeutet das, dass Dateianhänge eine maximale Größe von ca. 23 MB haben dürfen.

== Weitergehende Konfigurationsmöglichkeiten ==

Durch das Anlegen von Benutzerkonten und E-Mail-Adressen lassen sich die meisten Anwendungsfälle bereits gut abdecken. Für speziellere Anforderungen bietet Hostsharing darüber hinaus aber noch eine ganze Reihe weiterer Konfigurationsmöglichkeiten, die im Folgenden beschrieben werden.

* Mit [[aliases|Aliasen]] und [[procmail]] kann die Zustellung von Nachrichten in die Postfächer der Benutzer genauer gesteuert werden.

* [[hsadmin-mail]] bietet viele Optionen beim Einrichten von E-Mail-Adressen.

* Es können [[Mailinglisten]] eingerichtet werden.

== E-Mail-Infrastruktur ==

Wir nutzen [http://www.postfix.org/ Postfix] als MTA ("mail transfer agent") bzw. Mailserver. Er dient dazu, eingehende Mails den lokalen Usern des Servers zuzuordnen und an externe Server zuzustellen.

Es gibt einen [[Backup E-Mail Exchange]], der E-Mails annimmt, falls der Hauptserver ausgefallen ist.

Die Mails werden von unserem Mailsystem in einem Verzeichnis Maildir des jeweiligen User-Accounts abgelegt (der Name ist systemweit eingestellt und kann nicht verändert werden). Damit sind die Mails im normalen Backup enthalten und gehen auch in die Quotas des Paketes mit ein. Das Verzeichnis wird automatisch angelegt, wenn die erste Mail dort abgelegt wird. Man kann dies allerdings auch von Hand machen. ACHTUNG, FEHLERQUELLE: Unser Webmail-Client kommt wegen des fehlenden Verzeichnisses ins Schleudern, wenn beim ersten Aufruf noch keine Mail in der Mailbox liegt. Deshalb ist es sinnvoll, jeder neuen Mailbox zunächst einmal eine Testmail zuzusenden.

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

Mailclient einrichten

2009-06-02T18:34:54Z

Jrs00-wiki: Kategorisierung

== Posteingangsserver ==

Der Zugriff auf das Postfach ist über POP3 oder IMAP möglich. Für den Zugriff muss der Mailclient wie folgt konfiguriert werden:

; Server : ''xyz00''.hostsharing.net, dabei ist ''xyz00'' durch den Namen des Pakets zu ersetzen.

; Benutzername : Der Name des Benutzers, auf dessen Postfach zugegriffen werden soll, zum Beispiel xyz00-mustermann.

; Sicherheit : Es sollte eine verschlüsselte Verbindung (SSL) gewählt werden. Der Port des Servers ist dann 995.

== Postausgangsserver ==

Um E-Mails mit dem Mailclient über Hostsharing senden zu können, muss der Paketserver als Postausgangsserver eingerichtet werden. Dabei muss die Benutzerauthentifizierung aktiviert werden.

; Server : ''xyz00''.hostsharing.net, dabei ist ''xyz00'' durch den Namen des Pakets zu ersetzen.

; Benutzername : Der Name eines Benutzers auf dem Paketserver. In der Regel derselbe Name wie für den Posteingangsserver.

; Sicherheit : Wie beim Empfang sollte auch hier eine SSL-verschlüsselte Verbindung gewählt werden. Der Serverport ist dann 465.

== Sicherheitshinweis ==

Wir empfehlen aus Sicherheitsgründen dringend, sowohl beim Empfang als auch beim Senden ausschließlich verschlüsselte Verbindungen zu verwenden, wie oben dokumentiert. '''Achtung:''' viele Mailclients richten beim Erstellen eines neuen Kontos über einen Assistenten dieses standardmäßig so ein, dass die Verschlüsselung ausgeschaltet ist. Du solltest diese einschalten, bevor du mit dem neu angelegten Koto erstmals Mails abrufst.

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

Mailclient einrichten

2009-06-02T18:34:22Z

Jrs00-wiki: Seite neu angelegt.

Diskussion:E-Mail-Adressen einrichten

2009-06-02T18:06:23Z

Jrs00-wiki: Signatur

Diese Seite wird von der Seite [[E-Mail]] aus verlinkt und sollte eine einfache, für Einsteiger verständliche Dokumentation enthalten, wie man eine E-Mail-Adresse einrichtet.
--[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 18:06, 2. Jun. 2009 (UTC)

Diskussion:E-Mail-Adressen einrichten

2009-06-02T18:06:09Z

Jrs00-wiki: Zweck der Seite erklärt.

Diese Seite wird von der Seite [[E-Mail]] aus verlinkt und sollte eine einfache, für Einsteiger verständliche Dokumentation enthalten, wie man eine E-Mail-Adresse einrichtet.

Diskussion:E-Mail

2009-06-02T18:02:33Z

Jrs00-wiki: Neue Struktur

== Neue Struktur ==

Ich habe die Seite mal neu strukturiert, in der Hoffnung, dass sie so vor allem für Einsteiger etwas besser verständlich ist (und nicht direkt mit "wir benutzen postfix als MTA" anfängt). Der neuen Struktur sind die drei folgenden Absätze zum Opfer gefallen, die meiner Meinun nach an passender anderer Stelle in die Dokumentation eingefügt werden sollten:

<blockquote>Jeder User auf den Hostsharing-Rechnern bekommt automatisch eine Mailbox zugeordnet. Auf diese Mailbox kann über eines der Mailprotokolle POP3 oder IMAP mit einem Mailclient (Anwendung für E-mails) zugegriffen werden.</blockquote>

<blockquote>Für jeden E-Mail-Account wird ein Benutzerkonto benötigt. Für einen neuen Account muss man ein neues Benutzerkonto einrichten. Wie das geht, ist [[user]] beschrieben. Will man den User-Account nur zum Abrufen für E-Mails verwenden, dann weist man ihm am besten gar keine Shell zu, sondern trägt stattdessen /usr/bin/passwd z.B. /bin/false ein. Im ersten Fall kann ein solcher Anwender sein Kennwort selbst ändern, im zweiten Fall nicht.</blockquote>

<blockquote>Aus Sicherheitsgründen sollte ein Paketadmin NIEMALS Mails unverschlüsselt per POP3/IMAP abrufen. Es ist sinnvoller, sich für den Mailverkehr einen separaten Account einzurichten.</blockquote>

--[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 18:02, 2. Jun. 2009 (UTC)

E-Mail

2009-06-02T17:58:15Z

Jrs00-wiki: Neue Struktur. Unterteilung in Basiskonfiguration und weitergehende Möglichkeiten. Technik unter Infrastruktur beschrieben.

{{HSDoku-Links}}

== E-Mail empfangen und senden ==

Jeder Benutzer, für den ein [[user|Benutzerkonto]] in einem Hostsharing-Paket eingerichtet ist, besitzt automatisch ein Postfach und kann E-Mail über Hostsharing empfangen und senden. Dafür kann entweder unser [[Webmail]]-System oder ein beliebiger anderer Mailclient verwendet werden, zum Beispiel [http://www.mozilla-europe.org/de/products/thunderbird/ Thunderbird]. Wie der Mailclient einzurichten ist, ist unter [[Mailclient einrichten]] beschrieben.

Damit ein Benutzer Nachrichten empfangen kann, muss natürlich außerdem eine [[E-Mail-Adressen einrichten|E-Mail-Adresse]] entsprechend eingerichtet werden, sodass Nachrichten an diese Adresse in das Postfach des Benutzers ausgeliefert werden. Jeder Paketadmin hat automatisch einige [[Standard Email Adressen|Standard-Adressen]].

Die Hostsharing-Server akzeptieren Mail-Nachrichten nur bis zu einer [[Größenbeschränkung von E-Mails|maximalen Größe]] von netto 32 MB. In der Praxis bedeutet das, dass Dateianhänge eine maximale Größe von ca. 23 MB haben dürfen.

== Weitergehende Konfigurationsmöglichkeiten ==

Durch das Anlegen von Benutzerkonten und E-Mail-Adressen lassen sich die meisten Anwendungsfälle bereits gut abdecken. Für speziellere Anforderungen bietet Hostsharing darüber hinaus aber noch eine ganze Reihe weiterer Konfigurationsmöglichkeiten, die im Folgenden beschrieben werden.

* Mit [[aliases|Aliasen]] und [[procmail]] kann die Zustellung von Nachrichten in die Postfächer der Benutzer genauer gesteuert werden.

* Es können [[Mailinglisten]] eingerichtet werden.

== E-Mail-Infrastruktur ==

Wir nutzen [http://www.postfix.org/ Postfix] als MTA ("mail transfer agent") bzw. Mailserver. Er dient dazu, eingehende Mails den lokalen Usern des Servers zuzuordnen und an externe Server zuzustellen.

Es gibt einen [[Backup E-Mail Exchange]], der E-Mails annimmt, falls der Hauptserver ausgefallen ist.

Die Mails werden von unserem Mailsystem in einem Verzeichnis Maildir des jeweiligen User-Accounts abgelegt (der Name ist systemweit eingestellt und kann nicht verändert werden). Damit sind die Mails im normalen Backup enthalten und gehen auch in die Quotas des Paketes mit ein. Das Verzeichnis wird automatisch angelegt, wenn die erste Mail dort abgelegt wird. Man kann dies allerdings auch von Hand machen. ACHTUNG, FEHLERQUELLE: Unser Webmail-Client kommt wegen des fehlenden Verzeichnisses ins Schleudern, wenn beim ersten Aufruf noch keine Mail in der Mailbox liegt. Deshalb ist es sinnvoll, jeder neuen Mailbox zunächst einmal eine Testmail zuzusenden.

== Weiterführende Links ==
[[hsadmin-mail]]<br>
[[Email abrufen und einliefern]]<br>

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

Diskussion:.htaccess

2009-06-02T15:01:22Z

Jrs00-wiki: Umgebungsvariablen in PHP wurden überprüft.

Die Seite ist bisher ungeprüft von der alten Website übernommen. Sie dokumentiert momentan auch nur einen sehr kleinen Teil der Möglichkeiten, die man mit der .htaccess-Datei hat. --[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 22:43, 17. Mär. 2009 (UTC)

Folgendes stand ursprünglich auf der Seite für SW Pakete. Habe stattdessen Verweis auf diese .htaccess Seite eingefügt.

Zum Ableichen:

== Basic Auth ==

In der .htaccess müssen die Pfade für AuthUserFile und AuthGroupFile entweder absolut oder relativ zur ServerRoot angegeben werden.

Der FTP-Zugang erfolgt in einer chroot-Umgebung, somit ist / tatsächlich für den Server ein Unterverzeichnis, und zwar /home/pacs/xyz00, wobei xyz00 für das jeweilige Paket steht.

Hier ein Beispiel für eine .htaccess-Datei:

z.B. in '''/doms/fotos.example.com'''

<pre><nowiki>
AuthType Basic

AuthName "privater Bereich, Passwort erforderlich"
AuthUserFile /home/pacs/xyz00/doms/fotos.example.com.htpasswd

require valid-user
</nowiki></pre>

Das fotos.example.com.htpasswd AuthUserFile wird mit dem Programm htpasswd lokal erstellt und dann per FTP hochgeladen, oder in einer Shell eines Dynamik-Web Paketes.

Die .htpasswd Datei kann selbstverständlich auch eine kürzeren Namen bekommen, sollte aber außerhalb des HTTP-Bereichs der Domain angelegt werden und muss dann aus der .htaccess entsprechend referenziert werden.

Diskussion:.htaccess

2009-06-02T15:00:39Z

Jrs00-wiki: Diskussionseintrag zu Auth von Skripten entfernt, weil der entsprechende Text korrigiert wurde.

Die Seite ist bisher ungeprüft von der alten Website übernommen. Sie dokumentiert momentan auch nur einen sehr kleinen Teil der Möglichkeiten, die man mit der .htaccess-Datei hat. --[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 22:43, 17. Mär. 2009 (UTC)

Es sollte jemand prüfen, ob <code>$ENV['REMOTE_USER']</code> aus PHP-Skripten heraus wirklich funktioniert. --[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 21:07, 22. Mär. 2009 (UTC)

Folgendes stand ursprünglich auf der Seite für SW Pakete. Habe stattdessen Verweis auf diese .htaccess Seite eingefügt.

Zum Ableichen:

== Basic Auth ==

In der .htaccess müssen die Pfade für AuthUserFile und AuthGroupFile entweder absolut oder relativ zur ServerRoot angegeben werden.

Der FTP-Zugang erfolgt in einer chroot-Umgebung, somit ist / tatsächlich für den Server ein Unterverzeichnis, und zwar /home/pacs/xyz00, wobei xyz00 für das jeweilige Paket steht.

Hier ein Beispiel für eine .htaccess-Datei:

z.B. in '''/doms/fotos.example.com'''

<pre><nowiki>
AuthType Basic

AuthName "privater Bereich, Passwort erforderlich"
AuthUserFile /home/pacs/xyz00/doms/fotos.example.com.htpasswd

require valid-user
</nowiki></pre>

Das fotos.example.com.htpasswd AuthUserFile wird mit dem Programm htpasswd lokal erstellt und dann per FTP hochgeladen, oder in einer Shell eines Dynamik-Web Paketes.

Die .htpasswd Datei kann selbstverständlich auch eine kürzeren Namen bekommen, sollte aber außerhalb des HTTP-Bereichs der Domain angelegt werden und muss dann aus der .htaccess entsprechend referenziert werden.

.htaccess

2009-06-02T14:58:16Z

Jrs00-wiki: Abschnitt zum Passwortschutz von PHP-Anwendungen wiederhergestellt und inhaltlich korrigiert.

[[Kategorie:HSDoku]]
[[Kategorie:WWW]]

Mit <code>.htaccess</code> Dateien innerhalb der Dokument-Verzeichnisse einer Domain (z.B in subs/www oder in Unterverzeichnissen), können Einstellungen des Apache Webservers konfiguriert werden.

Zum Beispiel kann angegeben werden, welches Apache-Modul für bestimmte Dateien (oder bestimmte Datei-Endungen) benutzt werden soll, wohin Dokumente verschoben worden sind, oder auch, wer Zugriff auf die Dateien hat.

==Passwortschutz für Dateien==

'''Achtung:''' Sofern der Zugriff http Zugriff auf die Dateien nicht automatisch auf https:// bzw. [[SSL]] umgeleitet wird, können die Passwörter unverschlüsselt übertragen werden!

Zunächst wollen wir den Zugriff auf ein Unterverzeichnis unserer Beispiel-Domain per .htaccess einschränken. Dazu legen wir zunächst eine Passwort-Datei an. Am einfachsten lässt sich diese spezielle Passwort-Datei in einer Shell anlegen. Wir legen sie in das etc-Verzeichnis der Domain:

xyz00-doms@hopi$ cd ~/doms/example.com/etc
xyz00-doms@hopi$ htpasswd -c .htpasswd peter
New password: *****
Re-type new password: *****
xyz00-doms@hopi$

Beim ersten User, hier peter wird das Programm htpasswd mit der Option -c (create) aufgerufen, aber auch wirklich nur beim ersten mal, da sonst die Datei .htpasswd neu erzeugt werden würde und vorherige Einträge damit gelöscht wären.

Sollte es beim Versuch, die Datei anzulegen, zu der Fehlermeldung kommando htpasswd nicht bekannt kommen, dann müssen wir zunächst den Befehl lokalisieren und mit dem richtigen Pfad neu aufrufen:

xyz00-doms@hopi$ locate htpasswd
/usr/sbin/htpasswd
xyz00-doms@hopi$ /usr/sbin/htpasswd -c .htpasswd peter

Beim zweiten User erfolgt der Aufruf dann ohne die Option -c:

xyz00-doms@hopi$ htpasswd .htpasswd petra
New password: *****
Re-type new password: *****
xyz00-doms@hopi$

Die Sternchen * stehen selbstverständlich für das jeweilige Passwort, welches dem User zugeordnet werden soll.

Diese Datei könnten wir auch einfach mit scp/pscp oder FTP hochladen, dabei stellt sich dann jedoch die Frage, wie wir sie erzeugen. Auf den meisten Windows-Systemen dürfte kein htpasswd-Kommando verfügbar sein. Für diese Fälle haben wir eine online-Version zur Verfügung gestellt: http://www.is4u.de/cgi-bin/mk-htpasswd.cgi ? die Ausgabe einfach mit Copy&Paste in eine Datei kopieren und diese hochladen.

Die so angelegte Passwort-Datei kann nun von einer oder mehreren .htaccess-Dateien verwendet werden. Dazu begeben wir uns in das zu schützende Verzeichnis und legen dort eine Datei .htaccess an. Dies kann wieder per Upload oder in einer Shell geschehen. Die Datei kann beispielsweise so aussehen:

order allow,deny
allow from all
require valid-user
Authname edit
Authtype Basic
AuthUserFile /home/doms/example.com/etc/.htpasswd

Die letzte Zeile verweist natürlich auf die von uns angelegte .htpasswd.

===Passwortschutz von CGI- und PHP-Anwendungen===

Mit dem beschriebenen Mechanismus können selbstverständlich auch PHP-Skripte und CGI-Anwendungen vor unberechtigten Zugriffen geschützt werden. In dem geschützten Skript kann über die Umgebungsvariable <code>REDIRECT_REMOTE_USER</code> der Benutzername des Benutzers abgefragt werden, der sich angemeldet hat.

In PHP-Skripten kann mit Hilfe der automatisch global sichtbaren Variablen <code>$_ENV</code> auf die Umgebungsvariablen zugegriffen werden. Um die Variable <code>REDIRECT_REMOTE_USER</code> zu lesen, schreibt man also <code>$_ENV['REDIRECT_REMOTE_USER']</code>.

Anmerkung: Wer [[PHP via CGI installieren|PHP via CGI]] verwendet, muss entweder in seiner Kondigurationsdatei entweder bei <code>variables_order</code> ein "E" einfügen, damit <code>$_ENV</code> gesetzt wird, oder alternativ das Array <code>$_SERVER</code> verwenden.

== Redirects ==

Redirect permanent / http://www.example.com/

== Rewrite Rules ==

RewriteEngine On
RewriteRule ^mailman/(.*)$ /cgi-bin/mailman/$1

== Einstellen von MIME-Typen ==

# Download von Zertifikaten ermöglichen:
AddType application/x-x509-ca-cert .crt

== Einstellen von Datei Handlern ==

AddType application/x-httpd-phpcgi .php
Action application/x-httpd-phpcgi /fastcgi-bin/php525stub

==Verzeichnislisting ausschalten==

Ruft ein Nutzer ein Verzeichnis auf, z.B. www.example.com/verzeichnis, so wird normalerweise die sich darin befindliche index.html als Standard aufgerufen. Gibt es diese Datei nicht, wird der Inhalt des Verzeichnisses gelistet.

Das kann ein Sicherheitsproblem sein und ist mit der Einstellung
IndexIgnore *
für alle Datein Unterhalb des Speicherortes der .htaccess Datei abschaltbar.

== Gesperrte Optionen ==

Einstellungen, die es ermöglichen würden, über den Webserver Rechte anderer
User zu erhalten, sind nicht erlaubt.

Da '''"Options FollowSymLink"''' hierunter fällt ist leider Options nicht erlaubt, und damit auch '''"Options -Indexes"''' und '''"Options +Indexes"'''. Es ist daher nicht möglich das Directory-Listing damit abzustellen und für bestimmte Unterordner wieder zu erlauben. Als Alternative können z.B. leere index.html Dateien angelegt werden, die statt des Directory-Listings angezeigt werden. Auch mit RewriteRules, die auf Directories prüfen, müsste es gehen. Dazu dürfte es im support@ Archiv auch schon Beispiel-Workarounds geben.

WWW

2009-03-22T21:10:42Z

Jrs00-wiki: Link zu Basic Auth entfernt, ist jetzt bei .htaccess dokumentiert.

{{HSDoku-Links}}
{{Baustelle}}

== www ==
=== [[.htaccess]] ===
Anweisungen an den Webserver, z.B. Verzeichnisschutz, Umleitungen, Filelistings, usw.
=== [[SSL]] ===
"Secure Socket Layer": Verschlüsselte Internetverbindungen und Sicherheitszertifikate
=== [[CGI]] ===
"Common Gateway Interface": Wie man CGI Scripte auf unserem Server ausführen kann

----
[[Kategorie:HSDoku]]
[[Kategorie:WWW]]

Diskussion:.htaccess

2009-03-22T21:07:39Z

Jrs00-wiki:

.htaccess

2009-03-22T21:06:18Z

Jrs00-wiki: Beschreibung des Zugriffs auf Authentifizierungsinfos aus CGI-Anwendungen heraus.

{{Baustelle}}
[[Kategorie:HSDoku]]
[[Kategorie:WWW]]

In der Datei <code>.htaccess</code>, die man in seine Dokument-Verzeichnisse unter den Domains (z.B unter subs/www oder ein tieferes Unterverzeichnis) legt, kann man Anweisungen für den Webserver hinterlegen. Damit kann man beispielsweise dem Webserver sagen, welches Modul für bestimmte Dateien (oder bestimmte Datei-Endungen) benutzt werden soll, wohin Dokumente verschoben worden sind, oder auch, wer Zugriff auf die Dateien hat.

==Passwortschutz für Dateien==

Zunächst wollen wir den Zugriff auf ein Unterverzeichnis unserer Beispiel-Domain per .htaccess einschränken. Dazu legen wir zunächst eine Passwort-Datei an. Am einfachsten lässt sich diese spezielle Passwort-Datei in einer Shell anlegen. Wir legen sie in das etc-Verzeichnis der Domain:

xyz00-doms@hopi$ cd ~/doms/example.com/etc
xyz00-doms@hopi$ htpasswd -c .htpasswd peter
New password: *****
Re-type new password: *****
xyz00-doms@hopi$

Beim ersten User, hier peter wird das Programm htpasswd mit der Option -c (create) aufgerufen, aber auch wirklich nur beim ersten mal, da sonst die Datei .htpasswd neu erzeugt werden würde und vorherige Einträge damit gelöscht wären.

Sollte es beim Versuch, die Datei anzulegen, zu der Fehlermeldung kommando htpasswd nicht bekannt kommen, dann müssen wir zunächst den Befehl lokalisieren und mit dem richtigen Pfad neu aufrufen:

xyz00-doms@hopi$ locate htpasswd
/usr/sbin/htpasswd
xyz00-doms@hopi$ /usr/sbin/htpasswd -c .htpasswd peter

Beim zweiten User erfolgt der Aufruf dann ohne die Option -c:

xyz00-doms@hopi$ htpasswd .htpasswd petra
New password: *****
Re-type new password: *****
xyz00-doms@hopi$

Die Sternchen * stehen selbstverständlich für das jeweilige Passwort, welches dem User zugeordnet werden soll.

Diese Datei könnten wir auch einfach mit scp/pscp oder FTP hochladen, dabei stellt sich dann jedoch die Frage, wie wir sie erzeugen. Auf den meisten Windows-Systemen dürfte kein htpasswd-Kommando verfügbar sein. Für diese Fälle haben wir eine online-Version zur Verfügung gestellt: http://www.is4u.de/cgi-bin/mk-htpasswd.cgi ? die Ausgabe einfach mit Copy&Paste in eine Datei kopieren und diese hochladen.

Die so angelegte Passwort-Datei kann nun von einer oder mehreren .htaccess-Dateien verwendet werden. Dazu begeben wir uns in das zu schützende Verzeichnis und legen dort eine Datei .htaccess an. Dies kann wieder per Upload oder in einer Shell geschehen. Die Datei kann beispielsweise so aussehen:

order allow,deny
allow from all
require valid-user
Authname edit
Authtype Basic
AuthUserFile /home/doms/example.com/etc/.htpasswd

Die letzte Zeile verweist natürlich auf die von uns angelegte .htpasswd.

===Passwortschutz von CGI- und PHP-Anwendungen===

Mit dem beschriebenen Mechanismus können selbstverständlich auch PHP-Skripte und CGI-Anwendungen vor unberechtigten Zugriffen geschützt werden. In dem geschützten Skript kann über die Umgebungsvariable <code>REMOTE_USER</code> der Benutzername des Benutzers abgefragt werden, der sich angemeldet hat. Zusätzlich steht in der Umgebugsvariablen <code>AUTH_TYPE</code> der verwendete Authentifizierungsmechanismus, bei der oben beschriebenen Konfiguration also "BASIC".

In PHP-Skripten kann mit Hilfe der automatisch global sichtbaren Variablen <code>$_ENV</code> auf die Umgebungsvariablen zugegriffen werden. Um die Variable <code>REMOTE_USER</code> zu lesen, schreibt man also <code>$ENV['REMOTE_USER']</code>.

==Verzeichnislisting ausschalten==

Ruft ein Nutzer ein Verzeichnis auf, z.B. www.example.com/verzeichnis, so wird normalerweise die sich darin befindliche index.html als Standard aufgerufen. Gibt es eine solche Datei nicht, wird der gesamte Inhalt des Verzeichnisses gelistet.

Das kann ein Sicherheitsproblem sein. Mit der Einstellung IndexIgnore lässt sich das für die gesamte Website, für die die .htaccess gilt, ausschalten.

Diskussion:MySQL-Datenbank anlegen Schritt für Schritt

2009-03-17T22:59:38Z

Jrs00-wiki: Die Seite wurde neu angelegt: Ungeprüft übernommen aus der alten Dokumentation. --~~~~

Ungeprüft übernommen aus der alten Dokumentation. --[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 22:59, 17. Mär. 2009 (UTC)

Datenbanken

2009-03-17T22:56:07Z

Jrs00-wiki: Link auf MySQL Schritt für Schritt.

Hostsharing betreibt Datenbanksever in [http://www.mysql.com - MySQL] und [http://www.postgresql.org PostgreSQL].

Unser server-übergreifendes Datenbank-Administrations-Tool: [[dbadmin]]

Wir haben ein Command-Line-Tool namens [[dbadmin]], mit dem viele Administrationsaufgaben einheitlich und unabhängig von der jeweiligen Datenbank erledigt werden können, die mit normalen Nutzerrechten anders nicht zugänglich sind.

== MySQL ==

* Server: Es gibt einen eigenen MySQL-Server auf jedem Host.
* Nutzung bei Hostsharing: siehe separater Arikel [[MySQL]] und [[MySQL-Datenbank anlegen Schritt für Schritt]]
* Web-Frontend: [http://www.phpmyadmin.net phpMyAdmin] ist unter https://phpmyadmin.hostsharing.net/current/ erreichbar.
* Online-Dokumentation: Die Online-Doku zu MySQL gibt es unter http://dev.mysql.com/doc/. Auf dieser Site gibt es auch mehrere Fassungen der kompletten Doku zum Downloaden.

== PostgreSQL ==
* Server: Es gibt einen eigenen PostgreSQL-Server auf jedem Host.
* Nutzung bei Hostsharing: siehe separater Arikel [[PostgreSQL]]
* Web-Frontend: [http://www.phppgadmin.net phpPgAdmin] ist unter https://phppgadmin.hostsharing.net/current erreichbar.
* Online-Dokumentation: Die Online-Doku gibt es unter http://www.postgresql.org/docs/manuals/. Eine Liste von Büchern (einige davon zum Download) unter http://www.postgresql.org/docs/books/.

----
[[Kategorie:HSDoku]]
[[Kategorie:Datenbanken]]
[[Kategorie:Datenbanken:Postgresq]]
[[Kategorie:Datenbanken:Mysql]]

Diskussion:CGI

2009-03-17T22:51:46Z

Jrs00-wiki: Die Seite wurde neu angelegt: Ungeprüft übernommen aus alter Dokumentation. Wahrscheinlich veraltet, es wird zum Beispiel noch mod_php erwähnt. --~~~~

Ungeprüft übernommen aus alter Dokumentation. Wahrscheinlich veraltet, es wird zum Beispiel noch mod_php erwähnt. --[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 22:51, 17. Mär. 2009 (UTC)

CGI

2009-03-17T22:50:55Z

Jrs00-wiki: Übernommen aus alter Dokumentation.

{{Baustelle}}
[[Kategorie:HSDoku]]
[[Kategorie:WWW]]

Alle Dynamic-Pakete bei Hostsharing erlauben die Ausführung von Skripten auf dem Server. Dabei gibt es mehrere Möglichkeiten, zum einen direkt in den Webserver eingebundene Module wie mod_php für die Skriptsprache PHP, zum anderen die Ausführung über CGI (Common Gateway Interface). Letzteres ist keine eigene Skriptsprache, sondern nur eine Schnittstelle, über die Daten an eine Skriptsprache, wie z.B. perl oder php übergeben werden können. Solche Daten könnten z.B. die abgerufene URL, Zugriff auf Cookies etc. sein. Über die Schnittstelle cgi können Skriptsprachen wie Perl oder auch PHP, aber auch selbst kompilierte Binär-Programme ausgeführt werden.

CGI-Skripte liegen bei Hostsharing in einem Verzeichnisbaum direkt unter der Domain in einem Verzeichnis mit dem Namen cgi, also parallel zu den Verzeichnissen etc, subs und var. Von Seiten der URL werden sie als /cgi-bin eingeblendet. Ein Script, das unter ~/doms/example.com/cgi/ liegt, wird also über http://www.example.com/cgi-bin/ angesprochen.

Ein kleines Beispiel soll uns zeigen, was CGI eigentlich leistet. Dazu erstellen wir die Datei settings.cgi in unserem cgi-Verzeichnis mit folgendem Inhalt:

#!/bin/sh
echo Content-type: text/plain
echo
set

Nach dem Abspeichern müssen wir die Datei noch als ausführbar markieren (dies muss beides mit dem Domain-Admin-Account gemacht werden, da nur der an das cgi-Verzeichnis herankommt):

xyz00-hans@hopi$ chmod +x ~/doms/example.com/cgi/settings.cgi

Dieses kleine Skript macht nichts weiter, als in einem HTTP-Header dem Browser mitzuteilen, dass es sich um einfachen Text handelt und ihn dann zu veranlassen, die gesamten Parameter auszugeben, die über die CGI-Schnittstelle als Umgebungsvariable mitgegeben wurden.

Ein Aufruf der URL http://www.example.com/cgi-bin/settings.cgi erzeugt also in etwa folgende Ausgabe:

HOSTNAME=hopi
HOSTTYPE=i386
HTTP_ACCEPT='text/html, image/png, image/jpeg, image/gif, image/x-xbitmap, */*'
HTTP_ACCEPT_CHARSET='windows-1252;q=1.0, utf-8;q=1.0, utf-16;q=1.0, iso-8859-1;q=0.6, *;q=0.1'
HTTP_ACCEPT_ENCODING='deflate, gzip, x-gzip, identity, *;q=0'
HTTP_CGI_AUTHORIZATION=
HTTP_CONNECTION='Keep-Alive, TE'
HTTP_HOST=www.deineigenerdomainname.de
HTTP_TE='deflate, gzip, chunked, identity, trailers'
HTTP_USER_AGENT='Opera/6.0 (Linux 2.4.17 i686; U) [en]'
...
QUERY_STRING=
REMOTE_ADDR=62.156.160.59
REMOTE_PORT=36344
REQUEST_METHOD=GET
REQUEST_URI=/cgi-bin/test.cgi
SCRIPT_FILENAME=/home/doms/dynamic-webspace.de/cgi/test.cgi
SCRIPT_NAME=/cgi-bin/test.cgi
SCRIPT_URI=http://www.dynamic-webspace.de/cgi-bin/test.cgi
SCRIPT_URL=/cgi-bin/test.cgi
SERVER_ADDR=66.70.34.151
SERVER_ADMIN=mih01@hopi.hostsharing.net
SERVER_NAME=www.dynamic-webspace.de
SERVER_PORT=80
SERVER_PROTOCOL=HTTP/1.1
SERVER_SOFTWARE='Apache/1.3.23 (Unix) Debian GNU/Linux mod_xslt/Xalan/1.0 mod_gzip/1.3.19.1a PHP/4.1.2 mod_auth_pam/1.0a mod_perl/1.26'

{{Textkasten|gelb|Achtung|Eine typische Falle ist das Hochladen von Dateien mit MS-DOS Zeilenumbrüchen (CR/LF) statt UNIX Zeilenumbrüchen (LF). Da die erste Zeile in einem solchen Skript (hier #!/bin/sh) das Programm angibt, mit dem das Skript ausgeführt wird, wird schon das fehlschlagen, da sich am Ende der Zeile ein unsichtbares CR befinden wird. Der HTTP Fehler 500 (Internal Server Error) wird erscheinen. FTP bietet zu dem Zweck den ASCII-Mode an, der die Transformation zwischen den Systemen vornimmt. Binäre Dateien (z.B. Grafiken) sollten niemals, Skripte dagegen immer im ASCII-Modus übertragen werden.}}

Diskussion:TLS / SSL

2009-03-17T22:48:08Z

Jrs00-wiki: Die Seite wurde neu angelegt: Ungeprüft aus alter Dokumentation übernommen. --~~~~

Ungeprüft aus alter Dokumentation übernommen. --[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 22:48, 17. Mär. 2009 (UTC)

TLS / SSL

2009-03-17T22:47:46Z

Jrs00-wiki: Seite übernommen aus alter Dokumentation.

{{Baustelle}}
[[Kategorie:HSDoku]]
[[Kategorie:WWW]]

==Zertifikate für ssl==

Will man SSL nutzen, braucht man in seinem Paket eine eigene IP-Nummer, da dies die Voraussetzung zur Nutzung von ssl-Verschlüsselung ist. Deshalb ist auch nur ein Zertifikat pro Paket möglich.

Hostsharing besitzt ein ssl-Zertifikat, das auch von seinen Mitgliedern genutzt werden kann, die eine eigene IP-Nummer in ihrem Paket haben. Tut man das, muss man aber akzeptieren, dass bei Aufruf des https-Protokolls im Browser eine Fehlermeldung erscheint, da die Domains nicht zusammenpassen.

Wer das vermeiden möchte, kann ein eigenes Zertifikat kaufen und bei Hostsharing nutzen.

Zunächst muss man als Paket-Admin einen private key erzeugen und dann einen CSR. Wie das genau funktioniert, ist meistens von Seiten der Zertifizierungsstelle beschrieben.

Man kann aber auch ein kleines Skript nutzen, das Michael Hierweck aufgrund von einer Anleitung von Michaels Hönnig zur Erzeugung von Zertifikaten geschrieben hat:

#! /bin/sh

#Nur Zugriffe für den Owner erlauben
umask u=rwx,g=,o=

#Zertifikat erzeugen
openssl req -new -x509 -keyout ~/etc/cakey.pem -out ~/etc/careq.pem $*
openssl rsa <~/etc/cakey.pem >~/etc/https.new
cat ~/etc/careq.pem >>~/etc/https.new

#Temporäre Dateien löschen
rm ~/etc/cakey.pem
rm ~/etc/careq.pem

#Altes Zertifikat sichern
cp ~/etc/https.pem ~/etc/https.old

Es können weitere Parameter angeben werden, z.B. -days 370.

Die Domain oder Wildcard (*.domain.TLD) für die das Zertifikat gilt, wird auf die Frage als Common Name angegeben.

Anschließend wird der Zertifizierungsstelle der csr übermittelt. Die Datei, die man dann von der Zertifizierungsstelle erhält, muss in das Verzeichnis /etc des Paketadmins kopiert werden. Das neue Zertifikat muss dann noch manuell aktiviert werden, d.h. in https.pem umbenannt werden. Damit kann man dies zu einem beliebigen späteren Zeitpunkt tun und das Zertifikat vorher prüfen.

==Stammzertifikat von Hostsharing==

Hostsharing verfügt über ein eigenes Stammzertifikat. Damit ist es möglich, ssl-Verschlüsselung zu nutzen. Die ssl-Verschlüsselung wird zwar von den Browsern nicht als vertrauenswürdig anerkannt, da es nicht von einer Zertifizierungsstelle authentifiziert wurde, aber Hostsharing-Mitglieder vertrauen diesem Zertifikat natürlich trotzdem :-).

Das Stammzertifikat kann von Euch aber in die Liste der vertrauenswürdigen Zertifikate Eures Browsers übernommen werden und unter der folgenden URL direkt in den Browser geladen werden:

http://pacs.hostsharing.net/hostsharing-root-ca.crt

Auf dem Server ist das Zertifikat unter /home/htdocs/hostsharing-root-ca.crt abgelegt.

Es kann unter Windows auch auf die lokale Platte kopiert und dann per Doppelklick installiert werden.

Damit sind dann auch E-Mails mit ssl-Verschlüsselung möglich.

.htaccess

2009-03-17T22:45:29Z

Jrs00-wiki: Seite kategorisiert

{{Baustelle}}
[[Kategorie:HSDoku]]
[[Kategorie:WWW]]

In der Datei <code>.htaccess</code>, die man in seine Dokument-Verzeichnisse unter den Domains (z.B unter subs/www oder ein tieferes Unterverzeichnis) legt, kann man Anweisungen für den Webserver hinterlegen. Damit kann man beispielsweise dem Webserver sagen, welches Modul für bestimmte Dateien (oder bestimmte Datei-Endungen) benutzt werden soll, wohin Dokumente verschoben worden sind, oder auch, wer Zugriff auf die Dateien hat.

==Passwortschutz für Dateien==

Zunächst wollen wir den Zugriff auf ein Unterverzeichnis unserer Beispiel-Domain per .htaccess einschränken. Dazu legen wir zunächst eine Passwort-Datei an. Am einfachsten lässt sich diese spezielle Passwort-Datei in einer Shell anlegen. Wir legen sie in das etc-Verzeichnis der Domain:

xyz00-doms@hopi$ cd ~/doms/example.com/etc
xyz00-doms@hopi$ htpasswd -c .htpasswd peter
New password: *****
Re-type new password: *****
xyz00-doms@hopi$

Beim ersten User, hier peter wird das Programm htpasswd mit der Option -c (create) aufgerufen, aber auch wirklich nur beim ersten mal, da sonst die Datei .htpasswd neu erzeugt werden würde und vorherige Einträge damit gelöscht wären.

Sollte es beim Versuch, die Datei anzulegen, zu der Fehlermeldung kommando htpasswd nicht bekannt kommen, dann müssen wir zunächst den Befehl lokalisieren und mit dem richtigen Pfad neu aufrufen:

xyz00-doms@hopi$ locate htpasswd
/usr/sbin/htpasswd
xyz00-doms@hopi$ /usr/sbin/htpasswd -c .htpasswd peter

Beim zweiten User erfolgt der Aufruf dann ohne die Option -c:

xyz00-doms@hopi$ htpasswd .htpasswd petra
New password: *****
Re-type new password: *****
xyz00-doms@hopi$

Die Sternchen * stehen selbstverständlich für das jeweilige Passwort, welches dem User zugeordnet werden soll.

Diese Datei könnten wir auch einfach mit scp/pscp oder FTP hochladen, dabei stellt sich dann jedoch die Frage, wie wir sie erzeugen. Auf den meisten Windows-Systemen dürfte kein htpasswd-Kommando verfügbar sein. Für diese Fälle haben wir eine online-Version zur Verfügung gestellt: http://www.is4u.de/cgi-bin/mk-htpasswd.cgi ? die Ausgabe einfach mit Copy&Paste in eine Datei kopieren und diese hochladen.

Die so angelegte Passwort-Datei kann nun von einer oder mehreren .htaccess-Dateien verwendet werden. Dazu begeben wir uns in das zu schützende Verzeichnis und legen dort eine Datei .htaccess an. Dies kann wieder per Upload oder in einer Shell geschehen. Die Datei kann beispielsweise so aussehen:

order allow,deny
allow from all
require valid-user
Authname edit
Authtype Basic
AuthUserFile /home/doms/example.com/etc/.htpasswd

Die letzte Zeile verweist natürlich auf die von uns angelegte .htpasswd.

==Verzeichnislisting ausschalten==

Ruft ein Nutzer ein Verzeichnis auf, z.B. www.example.com/verzeichnis, so wird normalerweise die sich darin befindliche index.html als Standard aufgerufen. Gibt es eine solche Datei nicht, wird der gesamte Inhalt des Verzeichnisses gelistet.

Das kann ein Sicherheitsproblem sein. Mit der Einstellung IndexIgnore lässt sich das für die gesamte Website, für die die .htaccess gilt, ausschalten.

Diskussion:.htaccess

2009-03-17T22:43:58Z

Jrs00-wiki: Erklärung für Baustellenhinweis

.htaccess

2009-03-17T22:43:03Z

Jrs00-wiki: Von der alten Website übernommen.

{{Baustelle}}

In der Datei <code>.htaccess</code>, die man in seine Dokument-Verzeichnisse unter den Domains (z.B unter subs/www oder ein tieferes Unterverzeichnis) legt, kann man Anweisungen für den Webserver hinterlegen. Damit kann man beispielsweise dem Webserver sagen, welches Modul für bestimmte Dateien (oder bestimmte Datei-Endungen) benutzt werden soll, wohin Dokumente verschoben worden sind, oder auch, wer Zugriff auf die Dateien hat.

==Passwortschutz für Dateien==

Zunächst wollen wir den Zugriff auf ein Unterverzeichnis unserer Beispiel-Domain per .htaccess einschränken. Dazu legen wir zunächst eine Passwort-Datei an. Am einfachsten lässt sich diese spezielle Passwort-Datei in einer Shell anlegen. Wir legen sie in das etc-Verzeichnis der Domain:

xyz00-doms@hopi$ cd ~/doms/example.com/etc
xyz00-doms@hopi$ htpasswd -c .htpasswd peter
New password: *****
Re-type new password: *****
xyz00-doms@hopi$

Beim ersten User, hier peter wird das Programm htpasswd mit der Option -c (create) aufgerufen, aber auch wirklich nur beim ersten mal, da sonst die Datei .htpasswd neu erzeugt werden würde und vorherige Einträge damit gelöscht wären.

Sollte es beim Versuch, die Datei anzulegen, zu der Fehlermeldung kommando htpasswd nicht bekannt kommen, dann müssen wir zunächst den Befehl lokalisieren und mit dem richtigen Pfad neu aufrufen:

xyz00-doms@hopi$ locate htpasswd
/usr/sbin/htpasswd
xyz00-doms@hopi$ /usr/sbin/htpasswd -c .htpasswd peter

Beim zweiten User erfolgt der Aufruf dann ohne die Option -c:

xyz00-doms@hopi$ htpasswd .htpasswd petra
New password: *****
Re-type new password: *****
xyz00-doms@hopi$

Die Sternchen * stehen selbstverständlich für das jeweilige Passwort, welches dem User zugeordnet werden soll.

Diese Datei könnten wir auch einfach mit scp/pscp oder FTP hochladen, dabei stellt sich dann jedoch die Frage, wie wir sie erzeugen. Auf den meisten Windows-Systemen dürfte kein htpasswd-Kommando verfügbar sein. Für diese Fälle haben wir eine online-Version zur Verfügung gestellt: http://www.is4u.de/cgi-bin/mk-htpasswd.cgi ? die Ausgabe einfach mit Copy&Paste in eine Datei kopieren und diese hochladen.

Die so angelegte Passwort-Datei kann nun von einer oder mehreren .htaccess-Dateien verwendet werden. Dazu begeben wir uns in das zu schützende Verzeichnis und legen dort eine Datei .htaccess an. Dies kann wieder per Upload oder in einer Shell geschehen. Die Datei kann beispielsweise so aussehen:

order allow,deny
allow from all
require valid-user
Authname edit
Authtype Basic
AuthUserFile /home/doms/example.com/etc/.htpasswd

Die letzte Zeile verweist natürlich auf die von uns angelegte .htpasswd.

==Verzeichnislisting ausschalten==

Ruft ein Nutzer ein Verzeichnis auf, z.B. www.example.com/verzeichnis, so wird normalerweise die sich darin befindliche index.html als Standard aufgerufen. Gibt es eine solche Datei nicht, wird der gesamte Inhalt des Verzeichnisses gelistet.

Das kann ein Sicherheitsproblem sein. Mit der Einstellung IndexIgnore lässt sich das für die gesamte Website, für die die .htaccess gilt, ausschalten.

Größenbeschränkung von E-Mails

2009-03-17T22:36:49Z

Jrs00-wiki: Überflüssige doppelte Überschrift entfernt.

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.

== 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 32 MB die maximale Dateigröße für angehängte Dateien: 32 MB * 19/26 = 23,38 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 23 MB auszugehen.

Größenbeschränkung von E-Mails

2009-03-17T22:36:00Z

Jrs00-wiki: Neu angelegt. Erklärung der maximalen Dateigröße beim Versand von Mail-Anhängen.

= Größenbeschränkung von E-Mails =

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.

== 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 32 MB die maximale Dateigröße für angehängte Dateien: 32 MB * 19/26 = 23,38 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 23 MB auszugehen.

E-Mail

2009-03-17T22:13:19Z

Jrs00-wiki: Link auf Größenbeschränkung von E-Mails eingefügt.

== E-Mail ==

=== aliases ===
Die Datei [[aliases]] ist in jedem Paket genau einmal vorhanden. Dies ist die erste Datei, die berücksichtigt wird, wenn eine E-mail für einen User, der auf dem Server bekannt ist, angeliefert wird. Sie ist nur für lokale User gültig.
=== virtusertable ===
Die Datei [[virtusertable]] dient zur Einrichtung von E-Mail-Aliasen und Weiterleitungen. Anders als bei der Datei aliases, werden hier Emails an bestimmte Emai-Adressen weitergeleitet, während aliases Emails an Mailboxen weiterleitet.
=== procmail ===
[[procmail]] ist ein mächtiger Filter, der für viele komplexe Aufgaben verwendet werden kann. So sind z.B. eine variable Weiterleitung oder ein Spamfilter machbar. Mehr dazu unter www.procmail.org und auf dem Server in den Manpages zu procmail, procmailrc und procmailex.
=== Allgemeines ===
Wir nutzen [http://www.postfix.org/ Postfix] als MTA ("mail transfer agent") bzw. Mailserver. Er dient dazu, eingehende Mails den lokalen Usern des Servers zuzuordnen und an externe Server zuzustellen.

Jeder User auf den Hostsharing-Rechnern bekommt automatisch eine Mailbox zugeordnet. Auf diese Mailbox kann über eines der Mailprotokolle POP3 oder IMAP mit einem Mailclient (Anwendung für E-mails) zugegriffen werden.

Außerdem steht für jede Mailbox unser zentraler [[Webmail]] (Mailinterface) [http://ilohamail.org/main.php?page=About IlohaMail] zur Verfügung. Er ist unter https://webmail.hostsharing.net erreichbar.

Ob und welche E-mails in eine Mailbox zugestellt werden, kann über verschiedene Konfigurationen gesteuert werden. Der Anwender bekommt genau die Nachrichten zu Gesicht, die auch tatsächlich in seine Mailbox zugestellt werden.

Will man einen neuen E-Mail-Account einrichten, dann legt man sich einfach einen neuen User an. Wie das geht, ist [[user]] beschrieben. Will man den User-Account nur zum Abrufen für E-Mails verwenden, dann weist man ihm am besten gar keine Shell zu, sondern trägt in die letzte Spalte der etc/passwd z.B. /bin/false ein.

Aus Sicherheitsgründen sollte man allerdings den unverschlüsselten Mailabruf über POP3/IMAP beim Account des Paketadmins vermeiden.

Nach dem Einrichten eines E-Mail-User-Accounts muss man noch festlegen, dass Emails an bestimmte Adressen in der Mailbox des neuen Accounts landen. Das macht man mit [[aliases]], [[virtusertable]] oder [[procmail]].

Die Mails werden von unserem Mailsystem in einem Verzeichnis Maildir des jeweiligen User-Accounts abgelegt (der Name ist systemweit eingestellt und kann nicht verändert werden). Damit sind die Mails im normalen Backup enthalten und gehen auch in die Quotas des Paketes mit ein. Das Verzeichnis wird automatisch angelegt, wenn die erste Mail dort abgelegt wird. Man kann dies allerdings auch von Hand machen.

Die [[Größenbeschränkung von E-Mails|maximale Größe]] von E-Mails ist auf 32 MB beschränkt. In der Praxis bedeutet das, dass Dateianhänge eine maximale Größe von ca. 23 MB haben können.

=== E-Mail Adressen von Hostsharing Mitgliedern ===
Jedes Mitglied hat folgende E-Mail-Adressen:

* wird gerade umgstellt

=== E-Mail Adressen von Hostsharing Paketen ===
Jeder Paketadmin hat die folgenden E-Mail-Adressen:

* owner@xyz00.hostsharing.net
* xyz00@xyz00.hostsharing.net
* admin@xyz00.hostsharing.net

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

Hostsharing Wiki Konventionen

2009-02-22T23:51:42Z

Jrs00-wiki: Hinweis auf Namenskonvention für Seiten, die sich auf Software beziehen

Praktisches über den Umgang mit dem HS Wiki und der Software Mediawiki.

== Seiten anlegen ==
Das funktioniert dadurch, dass man auf einer vorhandenen Seite einen Link anlegt:

<nowiki>[[Link]]</nowiki>

Danach klickt man den Link und befindet sich auf der neuen, noch leeren Seite. Die kann man jetzt mit "Bearbeiten" mit Inhalten füllen.

'''Namenskonvention:''' Seiten, die sich auf eine bestimmte Software beziehen, sollten so benannt werden, dass der Name der Seite mit dem Namen der Software beginnt. So taucht die Seite in den von MediaWiki automatisch erstellten Seitenlisten alphabetisch unter dem Namen der Software einsortiert auf und ist für Leser leichter aufzufinden. [[:Kategorie:Installationsanleitungen|Installationsanleitungen]] sollten "Xyz installieren" heißen, wenn die Software Xyz heißt, gegebenenfalls kann auch die Versionsnummer mit in den Seitentitel aufgenommen werden.

== Kategorisieren ==

Praktisch jede Seite sollte kategorisiert werden. Das geschieht am Ende der Seite durch einen speziellen Link mit dem Namensraum "Kategorie":

<pre><nowiki>
----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Plone]]
</nowiki></pre>

Alle Seiten, die die Dokumentation betreffen, werden grundsätzlich der Kategorie "HSDoku" zugeteilt.

== Anmerkungen und Diskussionen ==

Jede Seite hat zusätzlich einen Bereich für die Diskussion. Ist der Inhalt der Seite fehlerhaft, falsch oder einfach diskussionswürdig, schreibt man das entsprechend da rein. Man kann Diskussionen in seine Beobachtungsliste aufnehmen und wird dann bei Änderungen/Antworten durch Andere benachrichtigt.

Es wird leicht übersehen, neben dem Link "Bearbeiten" gibt es ein kleines "+", das einem die Antwort erleichtert, man kann sogar einen Betreff eingeben, der als Überschrift erscheint.

== Seiten mit fehlerhaften oder falschen Inhalten ==

Ist man nicht in der Lage, zum Beispiel aufgrund fehlendem Fachwissen, die Seite zu korrigieren, beschreibt man den Fehler in der Diskussionsseite und kategorisiert die Seite als "Baustelle" durch den entsprechenden Link am Ende:

<pre><nowiki>
----
[[Kategorie:Baustelle]]
</nowiki></pre>

----
[[Kategorie:Hilfe]]

Kategorie Diskussion:Installationsanleitungen

2009-02-21T20:16:07Z

Jrs00-wiki: Hinweis auf Wunschliste

== Diese Seite löschen? ==

Ich schlage vor, diese Seite zu löschen. Ihre Aufgabe kann auch von der Kategorienseite [[:Kategorie:Installationsanleitungen|Installationsanleitungen]] übernommen werden, ohne manuellen Pflegeaufwand. Für noch nicht vorhandene, aber gewünschte Installationsanleitungen sollten wir irgendwo eine Wunschliste anlegen. --[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 18:59, 21. Feb. 2009 (UTC)

Ergänzung: Die [[Hostsharing_Wiki:Wunschliste Installationsanleitungen|Wunschliste Installationsanleitungen]] ist angelegt. --[[Benutzer:Jrs00-wiki|Jrs00-wiki]] 20:16, 21. Feb. 2009 (UTC)

Kategorie:Installationsanleitungen

2009-02-21T19:23:06Z

Jrs00-wiki: Link auf Wunschliste eingefügt

Manche Software wird von vielen unserer Mitglieder verwendet. Deshalb werden hier Installationen dokumentiert, wie sie bei anderen Mitgliedern funktionieren, um die Sache zu erleichtern.

Es gibt auch eine [[Hostsharing_Wiki:Wunschliste Installationsanleitungen|Wunschliste]], in der du Software eintragen kannst, für die du dir eine Installationsanleitung wünscht.

Hostsharing Wiki:Wunschliste Installationsanleitungen

2009-02-21T19:18:33Z

Jrs00-wiki: Liste mit noch fehlenden Installationsanleitungen angelegt

Diese Seite listet Software auf, für die im Dokumentations-Wiki noch keine Installationsanleitung existiert, aber von den Nutzern gewünscht wurde.

* '''Plone 3.2'''
* '''Apache Tomcat.''' Apache Tomcat ist ein bekannter und stabiler Container für Java-Servlets. Es gibt eine Anleitung auf der alten Website: [http://www.hostsharing.net/dokumentation/installationsanleitungen/tomcat.html]
* '''mod_python.''' Es gibt eine Anleitung auf der alten Website: [http://www.hostsharing.net/dokumentation/installationsanleitungen/mod-python.html]
* '''PHP via CGI.''' Es gibt schon eine Anleitung auf der alten Website: [http://www.hostsharing.net/dokumentation/installationsanleitungen/php-via-cgi.html]
* '''PHP 5.0.5.''' Es gibt schon eine Anleitung auf der alten Website: [http://www.hostsharing.net/dokumentation/installationsanleitungen/php-505.html]
* '''PHP 5.2.5.''' Es gibt schon eine Anleitung auf der alten Website: [http://www.hostsharing.net/dokumentation/installationsanleitungen/php-525.html]
* '''Ecartis.''' Ein einfacher, sicherer Mailinglisten-Manager. Einfache Administration per Email. Es gibt schon eine Anleitung auf der alten Website: [http://www.hostsharing.net/dokumentation/installationsanleitungen/ecartis.html]
* '''Mailman.''' Ein sehr leistungsfähiger, aber entsprechend kompliziert zu installierender Mailinglisten-Manager. Es gibt schon eine Anleitung auf der alten Website: [http://www.hostsharing.net/dokumentation/installationsanleitungen/mailman.html]
* '''Gallery.''' Mit Gallery lassen sich Bilder im Internet verwalten: Thumbnails, Fotoalbums, Transformationen, User-Verwaltung. Es gibt schon eine Anleitung auf der alten Website: [http://www.hostsharing.net/dokumentation/installationsanleitungen/gallery.html]

{{Textkasten|blau|Hinweis für Dokumentations-Autoren:|Wenn du mit der Arbeit an einer der Anleitungen beginnst, dann notiere dies am besten hier bei dem entsprechenden Eintrag, damit sich nicht unnötig zwei Autoren gleichzeitig die Arbeit machen.}}

Autorenportal

2009-02-21T19:09:43Z

Jrs00-wiki: Kurzübersicht für die wichtigsten Links

Das Hostsharing-Wiki ist ein gemeinsames Projekt der Hostsharing-Mitglieder, in dem wir die Dokumentation der Dienste von Hostsharing überarbeiten und auf den aktuellen Stand bringen möchten. Auf dieser Seite findest du Informationen dazu, wie du dich daran beteiligen kannst.

== Erste Schritte ==

Um mitmachen zu können, musst du dir als erstes ein Benutzerkonto im Hostsharing-Wiki anlegen. Das Wiki verwendet den Single-Sign-On-Dienst von Hostsharing, sodass du das Wiki mit jedem gültigen Benutzerkonto nutzen kannst, das auf den Hostsharing-Servern angelegt ist. Du kannst dir natürlich für die Nutzung des Wikis einen eigenes Konto anlegen, zum Beispiel xyz00-wiki oder xyz00-hsdoku.

Nachdem du dich im Wiki angemeldet hast, ist es sinnvoll, wenn du zunächst die Benutzereinstellungen anpasst. Mindestens deine E-Mail-Adresse solltest du eintragen, denn dann kannst du Seiten im Wiki beobachten und Nachrichten bekommen, wenn eine von dir beobachtete Seite geändert wurde.

Du solltest dich außerdem auf der Hostsharing-Mailingliste [https://lists.hostsharing.net/mailman/listinfo/website/ website@] anmelden. Dort diskutieren wir über die Weiterentwicklung der Dokumentation.

== Wo ist Arbeit nötig? ==

<div style="margin-left:2em;font-style:italic">Die wichtigsten Links: [[:Kategorie:Baustelle|Baustelle]]n, [[Hostsharing_Wiki:Wunschliste Installationsanleitungen|Wunschliste Installationsanleitungen]]</div>

Im Moment ist fast die gesamte Dokumentation verbesserungsbedürftig, sodass du dich eigentlich überall sinnvoll einbringen kannst. Ganz konkret kannst du zum Beispiel schauen, welche Seiten hier im Wiki als [[:Kategorie:Baustelle|Baustelle]] gekennzeichnet sind und diese überarbeiten. Wenn du ganz neue Dokumentation schreiben möchtest, solltest einen Blick auf die [[Vorstand:Notizen|Hinweise zur Einführung von HSAdmin]] werfen, damit du nicht einen Text schreibst, der schon in wenigen Wochen wieder veraltet ist.

Natürlich kannst du auch als Benutzer die Dokumentation lesen und darauf hinweisen, wo aus deiner Sicht Verbesserungen notwendig sind. Um eine Seite als Baustelle zu kennzeichnen, trage einfach folgendes ganz am Anfang der Seite ein:

<nowiki>{{Baustelle}}</nowiki>

Am Anfang der Seite erscheint dann ein entsprechender Hinweis und die Seite wird in die [[:Kategorie:Baustelle|Liste der Baustellen]] aufgenommen.

== Konventionen ==

Wenn du an der Dokumentation arbeitest, solltest du unsere [[Hilfe:Hostsharing_Wiki_Konventionen|Konventionen]] und [[Hilfe:Guter_Stil|Hinweise zu gutem Stil]] beachten.

== Umgang mit der Wiki-Software ==

Wir verwenden als Software [http://www.mediawiki.org/ MediaWiki]. Nachfolgend einige Links auf Hinweise dazu, wie du im Wiki Texte formatierst und Links anlegst. Gefahrlos ausprobieren kannst du die Wiki-Funktionen auf der Seite [[Sandkasten]], diese ist explizit zum Experimentieren gedacht.

* [[Hilfe:Textgestaltung|Textformatierung im Wiki]]
* [[Hilfe:Link|Links anlegen]]

Hauptseite

2009-02-21T19:01:16Z

Jrs00-wiki: Installationsanleitungen verlinkt jetzt auf die Kategorie

{{Textkasten|gruen|Willkommen beim Hostsharing-Wiki|In diesem Wiki wird die Nutzung der Dienste von Hostsharing dokumentiert. Es ist derzeit ein Provisorium, aber oft genug halten Provisorien verdammt lange. Bitte hilf mit, die Dokumentation zu verbessern! In unserem '''[[Hostsharing_Wiki:Autorenportal|Autorenportal]]''' findest du Hinweise dazu, wie du dich beteiligen kannst.}}

== Hostsharing Dokumentation ==

[[Einstieg bei Hostsharing]]

[[Pakete]]

[[User]]

[[Domains]]

[[Cron]]

[[Logging]]

[[E-Mail]]

[[WWW]]

[[Datenbanken]]

[[Backup & Restore]]

[[:Kategorie:Installationsanleitungen|Installationsanleitungen]]

Kategorie Diskussion:Installationsanleitungen

2009-02-21T18:59:52Z

Jrs00-wiki: Diese Seite löschen?

Installationsanleitungen

2009-02-21T18:57:56Z

Jrs00-wiki: Löschung vorgeschlagen

{{Textkasten|rot|Diese Seite löschen?|Es wurde vorgeschlagen, diese Seite zu löschen. Siehe [[{{TALKPAGENAME}}]].}}

Manche Software wird von vielen unserer Mitglieder verwendet. Deshalb werden hier Installationen dokumentiert, wie sie bei anderen Mitgliedern funktionieren, um die Sache zu erleichtern.

==[[Installationsanleitungen:Plone 2.5|Plone 2.5]]==

==[[Installationsanleitungen:Plone 3.0|Plone 3.0]]==

==[[Installationsanleitungen:Plone 3.1|Plone 3.1]]==

==[[Installationsanleitungen:Plone 3.2|Plone 3.2]]==

==[[Installationsanleitungen:Typo3|Typo3]]==

Eines der besten und leistungsfähigsten Open-Source Redaktionssysteme.

=== [[Installationsanleitungen:Typo3.7|Typo3.7.0]]===

=== [[Installationsanleitungen:Typo4.x|Typo4.x]]===

X = 0.4 .. 2.3

==[[Installationsanleitungen:Tomcat|Tomcat]]==

Apache Tomcat ist ein bekannter und stabiler Container für Java-Servlets.

==[[Installationsanleitungen:mod_python|mod_python]]==

==[[Installationsanleitungen:PHP via CGI|PHP via CGI]]==

In besonderen Fällen ist es notwendig, PHP über CGI und nicht über mod_php auszuführen, z.B. wenn man Einstellungen der php.ini verändern möchte. Insbesondere steht unter mod_php die Funktion mail() nicht zur Verfügung.

==[[Installationsanleitungen:PHP 5.0.5|PHP 5.0.5]]==

==[[Installationsanleitungen:PHP 5.2.5|PHP 5.2.5]]==

==[[Installationsanleitungen:Ecartis|Ecartis]]==

Ein einfacher, sicherer Mailinglisten-Manager. Einfache Administration per Email.

==[[Installationsanleitungen:Mailman|Mailman]]==

Ein sehr leistungsfähiger, aber entsprechend kompliziert zu installierender Mailinglisten-Manager.

==[[Installationsanleitungen:Gallery|Gallery]]==

Mit Gallery lassen sich Bilder im Internet verwalten: Thumbnails, Fotoalbums, Transformationen, User-Verwaltung.

==[[Installationsanleitungen:Analog|Analog]]==

Analog ist ein Tool zur Auswertung von logfiles

==[[Installationsanleitungen:AWStats|AWStats]]==

AWStats ist ein Tool zur graphischen Auswertung von Logfiles

==[[Installationsanleitungen:kleine Helfer|kleine Helfer]]==

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

Kategorie:Installationsanleitungen

2009-02-21T18:51:14Z

Jrs00-wiki: Beschreibungstext von der Seite Installationsanleitungen

Manche Software wird von vielen unserer Mitglieder verwendet. Deshalb werden hier Installationen dokumentiert, wie sie bei anderen Mitgliedern funktionieren, um die Sache zu erleichtern.

Analog installieren

2009-02-21T18:49:40Z

Jrs00-wiki: hat „Installationsanleitungen:Analog“ nach „Analog installieren“ verschoben: Wenn die Installationsanleitungen mit dem Namen der Software beginnen, werden sie in der Kategorie:Installationsanleitungen nicht alle unter dem Buchstaben I eins

== Analog ==
=== Vorbereitung ===

Analog ist ein Tool zur Analyse von logfiles. Damit lässt sich der Traffic auf den Sites genau darstellen. Das kann auch automatisch gemacht werden.

Analog ist bei Hostsharing zentral installiert.

Am einfachsten ist es, analog im Verzeichnis des Domain-Users auszuführen, also als Domain-User einloggen. Vorher muss man aber sicherstellen, dass die Logfiles auch dort abgelegt werden. Normalerweise landen diese nämlich im Paket-Verzeichnis. Wie man die Ablegung steuert, ist [[logging]] beschrieben.

Am besten, man lässt die logfiles in das Verzeichnis doms/example.com/var fließen.

Es macht Sinn, für die Statistiken ein eigenes Verzeichnis anzulegen, das auch per http erreichbar ist, also z.B. http://www.example.com/statistik. Also erstellen wir ein neues Verzeichnis:
<pre>
xyz00-doms@hopi:~$ mkdir doms/example.com/subs/www/statistik
</pre>
Und gleich noch eines für die images:
<pre>
xyz00-doms@hopi:~$ mkdir doms/example.com/subs/www/statistik/images
</pre>
In das images-Verzeichnis kopieren wir gleich die nötigen Bilder, die schon bei uns liegen, nämlich in /usr/share/doc/analog/docs/:
<pre>
xyz00-doms@hopi:~$ cp /usr/share/doc/analog/docs/*.gif doms/example.com/subs/www/statistik/images
</pre>
=== Konfiguration ===

Als nächstes muss man eine config-Datei für Analog erstellen. Genaueres dazu ist auf www.analog.cx nachzulesen. Eine Beispielconfig gibt es hier. Hier die wichtigsten Anpassungen:

* LOGFILE /home/doms/example.com/var/web-*.example.com-*.log.gz
Hier wird angegeben, wo die Logfiles liegen.
* OUTFILE /home/doms/example.com/subs/www/statistik/index.htm
Hier landet die Auswertung, ist also dann unter www.example.com/statistik/index.htm abrufbar.
* HOSTNAME "example.com"
Das wird als Titelzeile angezeigt
* IMAGEDIR images/
Hier liegen die images.

Man speichert die Datei am besten im etc-Verzeichnis des Domain-Users, z.B. als analog.cfg.

=== Aufruf ===

Der Aufruf von analog erfolgt über die Kommandozeile:

<pre>
/usr/bin/analog -G +g./analog.cfg
</pre>
-G weist analog an, nicht die Standardconfig zu verwenden, und +g weist eine eigene config-Datei zu - in diesem Fall unsere analog.cfg. Fehler oder Warnungen landen in errors.txt.

Interessant wird analog aber erst dann, wenn man die logfiles automatisch auswertet. Das funktioniert mit einem cronjob.

Mit dem Eintrag im crontab 0 3 * * * /usr/bin/analog -G +g./analog.cfg wird jeden Tag um 3.00 Uhr eine neue Statistik gebastelt.

Noch schöner ist es, die Zeitsteuerung mit unserem Event-Handler zu lösen. Damit kann man nämlich festlegen, dass die Auswertung direkt nach dem Verschieben oder Erzeugen der Logfiles erfolgt. Mehr unter Event-Handler.

Diese ist dann unter www.example.com/statistik/index.htm zu erreichen.

=== Caching ===

Mit dem Caching können Logfileanalysen in einem cachefile gespeichert und in spätere Analysen einbezogen werden. So ist es z.B. möglich, alte Logfiles auf dem Server zu löschen, um Platz zu sparen.

Aber Vorsicht: Man muss aufpassen, dass im cachefile alle gewünschten Informationen landen. Eine Rekonstruktion zusätzlicher, nicht geschriebener Daten ist nicht mehr möglich.

'''''Es müssen alle INCLUDE und EXCLUDE Kommandos gesetzt sein, auch FROM und TO. Auch alle ALIASEs und LOGTIMEOFFSETs müssen beim Schreiben des cachefiles wie gewünscht gesetzt werden.
'''''
Das cachefile wird mit der Option CACHEOUTFILE definiert:
<pre>
CACHEOUTFILE cache20060720.ch
</pre>
Sollte die Datei bereits vorhanden sein, wird kein cachefile erzeugt, um ein Überschreiben zu vermeiden. Es empfiehlt sich also, das Datum im Namen der Datei anzugeben.

Hat man das cachefile geschrieben und enthält es alle gewünschten Informationen, kann man es in eine nachfolgende Analyse einfließen lassen. Das geschieht mit der Option CACHEFILE. Wildcards und Kommas sind möglich:

CACHEFILE cache20060720.ch,cache2.ch,cache*.ch

=== Ablauf ===

Da häufig Fehler und Missverständnisse auftreten, was die Benutzung von Caching angeht, hier ein möglicher Ablauf:

* Von den bisherigen Logfiles (LOGFILE) erstellen wir gleichzeitig ein cachefile (mit CACHEOUTFILE) und einen Report (mit OUTFILE).
<pre>
...
LOGFILE /home/doms/example.com/var/web-*.example.com-*.log.gz
CACHEOUTFILE cache20060720.ch
OUTFILE /home/doms/example.com/subs/www/statistik/index.htm
...
</pre>
* Das cachefile sollten wir testen. Wir erstellen einfach einen neuen Report, in dem wir nur das cachefile analysieren und nicht mehr die alten Logfiles (also kein LOGFILE).
<pre>
...
CACHEFILE cache20060720.ch
OUTFILE /home/doms/example.com/subs/www/statistik/index2.htm
...
</pre>
* Die beiden erstellten Reportdateien können nun verglichen werden und sollten übereinstimmen.
* Nun können die Logfiles gelöscht oder (noch besser) lokal gespeichert und damit Platz auf dem Server geschaffen werden.

Im folgenden analysieren wir das cachefile und zusätzlich alle neu einfließenden Logfiles, bis wir den Vorgang wiederholen.
<pre>
...
LOGFILE /home/doms/example.com/var/web-*.example.com-*.log.gz
CACHEFILE cache20060720.ch
OUTFILE /home/doms/example.com/subs/www/statistik/index.htm
...
</pre>

Man kann das Verfahren natürlich prinzipiell automatisieren, z.B. mit cronjobs. Aber es empfiehlt sich immer die Kontrolle der generierten cachefiles.

---
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Analog]]

Diskussion:Installationsanleitungen:Typo4.x

2009-02-21T18:49:22Z

Jrs00-wiki: hat „Diskussion:Installationsanleitungen:Typo4.x“ nach „Diskussion:Typo3 Version 4.x installieren“ verschoben: Wenn die Installationsanleitungen mit dem Namen der Software beginnen, werden sie in der Kategorie:Installationsanleitungen nich

#REDIRECT [[Diskussion:Typo3 Version 4.x installieren]]

Diskussion:Graphics Magick installieren

2009-02-21T18:49:22Z

was noch fehlt
If you want to allow only executable files from /usr/local/php/bin for PHP applications, then you have to copy the files from /usr/bin or /usr/local/bin (see result of 'rpm -qa GraphicksMagick') into /usr/local/php/bin. Otherwise you skip the following 2 steps.

/usr/local # mkdir php
/usr/local # cd php
/usr/local/php # mkir bin
/usr/local/php # cd bin
/usr/local/php/bin # cp /usr/bin/animate .
/usr/local/php/bin # cp /usr/bin/compare .
...
/usr/local/php/bin # cp /usr/bin/xtp .

[edit] PHP Configuration

Edit the php.ini file for the allowed include and executable file directories outside of the apache document root folder.

safe_mode_include_dir = /usr/local/php/bin
safe_mode_exec_dir = /usr/local/php/bin

[edit] Settings for TYPO3 >= 3.8

You can drop all "im..." settings from localconf.php except

$TYPO3_CONF_VARS['GFX']['im_path'] = '<path>';
$TYPO3_CONF_VARS['GFX']['im_version_5'] = 'gm';

und des weiteren
die überprüfung des dummys und wie ich PHP CGI Konfiguriere

Graphics Magick installieren

2009-02-21T18:49:22Z

Jrs00-wiki: hat „Installationsanleitungen:Typo4.x“ nach „Typo3 Version 4.x installieren“ verschoben: Wenn die Installationsanleitungen mit dem Namen der Software beginnen, werden sie in der Kategorie:Installationsanleitungen nicht alle unter dem Buchs

== Installationsanleitung für Typo3 auf hostsharing.net Servern==
=== Benötigte Dateien ===
#Typo3

Lade Dir die aktuelle Version von TYPO3 von der [http://typo3.org/download/packages/ Typo3-Website] herunter.

Du brauchst zwei Pakete:

1. Source_tar.gz, das ist der eigentliche TYPO3-Code.

2. Dummy_tar.gz: Dummy ist eine komplette, leere Umgebung.

Verwende die tar-Version, nicht zip.

Kopiere die aktuelle Version in dein Home-Verzeichnis.

=== GraphicsMagick ===

Um die vielfältigen Bildverarbeitungsmöglichkeiten nutzen zu können, brauchst Du eine Version von GraphicsMagick.
Früher wurde ImageMAgick verwendet, aber seit 2002 ist es keine reine GPL software. GraphicsMagic ist aus der ImageMagick Version 5.5.2. hervorgegangen uns wird ständig aktualisiert.

Die jetzige Version is 1.3.5.
Die letze Version kann man vom [ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/GraphicsMagick FTP server]herunterladen. Then extract it in the cgi-bin folder, e.g. at /var/www/vhosts/story-castle.net/httpdocs/cgi-bin

Will man diese Version verwenden, dann muss man die Binaries in ein Verzeichnis kopieren, auf das der paket admin(z.B. xyz00), unter dem die Domain läuft, zugreifen kann, zum Beispiel:

xyz00@hopi:~$ mkdir ~/bin
xyz00@hopi:~$ tar xvfpz GraphicsMagick-LATEST.tar.gz

cd GraphicsMagick-1.3.5
./configure --prefix=/home/pacs/xyz00/bin --enable-magick-compat

Programm installieren

make
make install

Überprüfen ob alles richtig installiert ist mit

cd ~/bin//bin

xyz00@hopi:~/bin/bin$ls -l
total 8925
drwxr-xr-x 2 root root 1024 Feb 11 10:57 .
drwxr-xr-x 12 root root 1024 Jan 14 11:46 ..
-rwxr-xr-x 1 root root 1223 Feb 11 10:57 GraphicsMagick++-config
-rwxr-xr-x 1 root root 1266 Feb 11 10:57 GraphicsMagick-config
-rwxr-xr-x 1 root root 1250 Feb 11 10:57 GraphicsMagickWand-config
-rwxr-xr-x 1 root root 5209711 Feb 11 10:57 PerlMagick
lrwxrwxrwx 1 root root 2 Feb 11 10:57 animate -> gm
lrwxrwxrwx 1 root root 2 Feb 11 10:57 composite -> gm
lrwxrwxrwx 1 root root 2 Feb 11 10:57 conjure -> gm
lrwxrwxrwx 1 root root 2 Feb 11 10:57 convert -> gm
lrwxrwxrwx 1 root root 2 Feb 11 10:57 display -> gm
-rwxr-xr-x 1 root root 3891115 Feb 11 10:57 gm
lrwxrwxrwx 1 root root 2 Feb 11 10:57 identify -> gm
lrwxrwxrwx 1 root root 2 Feb 11 10:57 import -> gm
lrwxrwxrwx 1 root root 2 Feb 11 10:57 mogrify -> gm
lrwxrwxrwx 1 root root 2 Feb 11 10:57 montage -> gm

=== PHP und .htaccess ===

Für den Betrieb von Typo3 auf Hostsharing musst Du PHP via CGI ansprechen. Wie das funktioniert, kannst Du unter PHP via CGI nachlesen. Verwende am besten die aktuellste PHP-Version, da frühere Versionen meistens Sicherheitslücken aufweisen.

Die .htaccess-Datei, von der in der Anleitung die Rede ist, erstellen wir in genau dem Verzeichnis, unter dem Typo3 installiert werden soll, also z.B.
doms/example.com/subs/www

Die php.ini-Datei (oder php-cgi.ini) müssen wir vorher auf jeden Fall noch anpassen:

memory_limit = 16M (oder höher)
post_max_size = 8M

und ganz unten das Kommentarzeichen ';' entfernen:

extension=gd.so
extension=mysql.so

== Vorgehensweise ==

=== Typo3 entpacken ===

Zunächst entpacken wir den Quellcode (SRC) in ein beliebiges Verzeichnis des Domain-Admins. Der Quellcode kann von mehreren Testsites oder Dummys verwendet werden. Wir wählen für unser Beispiel die (mittlerweile wirklich veraltete) 3.5.0-Version, die auf dem Hostsharing-Server liegt. Diese entpacken wir in das Stammverzeichnis des Domain-Admins.

xyz00-doms@hopi:~$ tar -xvzf typo3_src-4.x-hostsharing.tar.gz

Wenn wir einen Link auf dieses neue Verzeichnis anlegen, wird später ein Update leichter möglich sein:

xyz00-doms@hopi:~$ ln -s typo3_src-4.x typo3_src

Das Stamm-Verzeichnis sollte jetzt so aussehen:

drwxr-x--- 7 xyz00 httpd 4096 Feb 27 15:42 .
dr-xr-x--T 7 httpd xyz00 4096 Jan 26 21:00 ..
drwxr-xr-x 2 xyz00 xyz00 4096 Mar 1 17:01 doms
drwxr-xr-x 2 xyz00 xyz00 4096 Oct 16 19:48 etc
lrwxrwxrwx 1 xyz00 xyz00 15 Mar 3 18:56 typo3_src -> typo3_src-4.x
drwxr-xr-x 6 xyz00 xyz00 4096 Jan 30 17:23 typo3_src-4.x
drwxr-xr-x 2 xyz00 xyz00 4096 Feb 21 2002 Maildir

Als nächstes entpacken wir das Testsite- oder Dummy-Paket. Wir gehen in das Verzeichnis der Domain, in dem Typo3 laufen soll:

xyz00-doms@hopi:~$ cd doms/example.com/subs/www

Hierher entpacken wir das Testsite- oder das Dummy-Paket. Für Anfänger empfehlen wir die Testsite-Version.

xyz00-doms@hopi:~/doms/example.de/subs/www$ tar -xvzf /usr/local/tmp/Typo3Install/testsite-3.5.tgz

oder:

xyz00-doms@hopi:~/doms/example.de/subs/www$ tar -xvzf /usr/local/tmp/Typo3Install/dummy-3.5.0.tar.gz

Jetzt müssen noch die SymLinks umgesetzt werden. Zuerst erstellen wir drei Links auf Verzeichnisse in der zentrale SRC-Installationsdatei, in unserem Fall auf den Link typo3_src, den wir vorhin erstellt haben und der ja seinerseits auf die zentrale SRC-Datei verweist:

xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s ~/typo3_src/typo3 typo3
xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s ~/typo3_src/typo3/sysext/cms/tslib/ tslib
xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s ~/typo3_src/t3lib t3lib

Anschließend setzen wir noch drei Links innerhalb des Domain-Verzeichnisses:

xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s tslib/index_ts.php index.php
xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s tslib/media media
xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s tslib/showpic.php showpic.php

Das Verzeichnis sollte jetzt so aussehen:

drwxr-xr-x 6 xyz00 xyz00 4096 Mar 9 19:16 .
drwxr-xr-x 7 xyz00 xyz00 4096 Mar 12 10:21 ..
-rwxr-xr-x 1 xyz00 xyz00 46 Feb 6 2002 clear.gif
drwxr-xr-x 10 xyz00 xyz00 4096 Mar 9 19:19 fileadmin
-rw-r--r-- 1 xyz00 xyz00 272 Jan 27 21:10 .htaccess
lrwxrwxrwx 1 xyz00 xyz00 18 Mar 3 18:56 index.php -> tslib/index_ts.php
lrwxrwxrwx 1 xyz00 xyz00 12 Mar 3 18:56 media -> tslib/media/
lrwxrwxrwx 1 xyz00 xyz00 17 Mar 3 18:56 showpic.php -> tslib/showpic.php
lrwxrwxrwx 1 xyz00 xyz00 21 Mar 9 19:26 t3lib -> ../../typo3_src/t3lib
lrwxrwxrwx 1 xyz00 xyz00 21 Mar 9 19:26 tslib -> ../../typo3_src/typo3/sysext/cms/tslib/
lrwxrwxrwx 1 xyz00 xyz00 21 Mar 9 19:26 typo3 -> ../../typo3_src/typo3/
drwxr-xr-x 3 xyz00-do xyz00 4096 Mar 9 19:21 typo3conf
drwxr-xr-x 2 xyz00-do xyz00 4096 Mar 16 11:31 typo3temp
drwxr-xr-x 8 xyz00-do xyz00 4096 Mar 9 19:19 uploads

== Typo3 konfigurieren ==

Typo3 ist nun unter www.example.com/typo3 erreichbar. Zum Konfigurieren ruft man im Browser das install-Tool unter www.example.com/typo3/install auf. Das install-Tool ist aber noch durch ein die() vor Ausführung geschützt. Daher müssen wir zunächst die Datei subs/typo3_src/typo3/install/index.php editieren und das die() auskommentieren. Das sieht dann in etwa so aus:

//**************************************************************************
// Insert some security here, if you don't trust the Install Tool Password:
//**************************************************************************
//die("In the main source distribution of Typo3, the install script is disabled by a die() function call.
//if (substr(getenv("REMOTE_ADDR"),0,12)!="192.168.1.18" && getenv("REMOTE_ADDR")!="213.237.20.63")
exit;

Dann kann das Install-Tool gestartet werden: http://www.example.com/typo3/install/

Man sollte auf jeden Fall sofort das Install-Tool-Passwort ändern! (es heißt zu Beginn joh316)
=== BASIC CONFIGURATION ===

* Unter Basic Configuration muss jetzt der Benutzername und das Passwort für MySQL eingerichtet werden. Dann kann eine Datenbank erzeugt werden. Typo3 verwendet einen Deiner Nutzer für den MySQL-Server, der aber noch angelegt werden muss. Eine Beschreibung dazu gibt es hier.
* Jetzt muss der Pfad zu ImageMagick angegeben werden, also entweder /usr/bin für 5.4.4 oder das Verzeichnis, in das Du eine andere, z.B. die 4.2.9-Version entpackt hast (s.o.).
* Die Zeile ImageMagick [lzw] muss!!! leer bleiben, damit die LZW-Funktionen der GD-Lib genutzt werden!!

=== DATABASE ANALYSER ===

* Update required tables -> COMPARE klicken
dann auf write to database klicken
* Dump static data -> IMPORT klicken
dann alle Tabellen zum Import markieren und dann write to database klicken.
* Admin-User anlegen. Dieser Admin-User und das Passwort sind nötig für den ersten Zugang zum Backend der neuen Website.

=== ALL CONFIGURATION ==0

* [im_combine_filename] = 'combine' setzen
* [TTFdpi] = '96' setzen
* [gif_compress] ='' setzen

=== IMAGE PROCESSING ===

Alle Tests sollten erfolgreich sein: Die Bilder sind ein wenig größer als die Referenz - das ist OK und liegt daran, dass Freetype 2 verwendet wird. Dafür sind die Ergebnisse besser.

Jetzt sollte unter http://www.example.com die Typo3-Testsite zu erreichen sein. Das Backend erreicht man unter http://www.example.com/typo3/.
----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Typo3]]
[[Kategorie:Baustelle]]

PHP 5.2.5

2009-02-21T18:48:57Z

Jrs00-wiki: hat „Installationsanleitungen:Typo3.7“ nach „Typo3.7 installieren“ verschoben: Wenn die Installationsanleitungen mit dem Namen der Software beginnen, werden sie in der Kategorie:Installationsanleitungen nicht alle unter dem Buchstaben I ei

== Installationsanleitung für Typo3 auf hostsharing.net Servern==
=== Benötigte Dateien ===
#Typo3

Lade Dir die aktuelle Version von Typo3 von der Typo3-Website (www.typo3.org) herunter.

Du brauchst zwei Pakete:

1. Den SRC-Code, das ist der eigentliche Quellcode.

2. Dummy oder Testsite: Dummy ist eine komplett leere Umgebung, Testsite beinhaltet einige Beispiele und ist deshalb für Anfänger besser geeignet. Man kann nur eine der beiden Pakete verwenden.

Welche Version Du verwendest, ist eigentlich egal, momentan ist 3.7.0 aktuell und diese läuft auch bei Hostsharing stabil. Verwende die tar-Version, nicht zip.

Du findest auch einige Versionen im zentralen Verzeichnis /usr/local/tmp/Typo3Install. Die kannst Du verwenden, dann sparst Du dir den Download.

=== ImageMagick ===

Um die vielfältigen Bildverarbeitungsmöglichkeiten nutzen zu können, brauchst Du eine Version von ImageMagick. Im Verzeichnis /usr/bin existiert eine 5.4.4-Version, die direkt verwendet werden kann.

Die Version 4.2.9 wurde für Typo3 optimiert und wird deshalb empfohlen. Sie befindet sich im Verzeichnis /usr/local/tmp/Typo3Install. Will man diese Version verwenden, dann muss man die Binaries in ein Verzeichnis kopieren, auf das der Nutzer (z.B. xyz00-doms), unter dem die Domain läuft, zugreifen kann, zum Beispiel:

xyz00-doms@hopi:~$ mkdir ~/bin
xyz00-doms@hopi:~$ cp -R /usr/local/tmp/Typo3Install/imagemagick429 ~/bin

=== PHP und .htaccess ===

Für den Betrieb von Typo3 auf Hostsharing musst Du PHP via CGI ansprechen. Wie das funktioniert, kannst Du unter PHP via CGI nachlesen. Verwende am besten die aktuellste PHP-Version, da frühere Versionen meistens Sicherheitslücken aufweisen.

Die .htaccess-Datei, von der in der Anleitung die Rede ist, erstellen wir in genau dem Verzeichnis, unter dem Typo3 installiert werden soll, also z.B.
doms/example.com/subs/www.

Die php.ini-Datei (oder php-cgi.ini) müssen wir vorher auf jeden Fall noch anpassen:

memory_limit = 16M (oder höher)
post_max_size = 8M

und ganz unten auskommentieren(";" entfernen):

extension=gd.so
extension=mysql.so
== Vorgehensweise ==

=== Typo3 entpacken ===

Zunächst entpacken wir den Quellcode (SRC) in ein beliebiges Verzeichnis des Domain-Admins. Der Quellcode kann von mehreren Testsites oder Dummys verwendet werden. Wir wählen für unser Beispiel die (mittlerweile wirklich veraltete) 3.5.0-Version, die auf dem Hostsharing-Server liegt. Diese entpacken wir in das Stammverzeichnis des Domain-Admins.

xyz00-doms@hopi:~$ tar -xvzf /usr/local/tmp/Typo3Install/typo3_src-3.5.0-hostsharing.tar.gz

Wenn wir einen Link auf dieses neue Verzeichnis anlegen, wird später ein Update leichter möglich sein:

xyz00-doms@hopi:~$ ln -s typo3_src-3.5.0 typo3_src

Das Stamm-Verzeichnis sollte jetzt so aussehen:

drwxr-x--- 7 xyz00 httpd 4096 Feb 27 15:42 .
dr-xr-x--T 7 httpd xyz00 4096 Jan 26 21:00 ..
drwxr-xr-x 2 xyz00 xyz00 4096 Mar 1 17:01 doms
drwxr-xr-x 2 xyz00 xyz00 4096 Oct 16 19:48 etc
lrwxrwxrwx 1 xyz00 xyz00 15 Mar 3 18:56 typo3_src -> typo3_src-3.5.0
drwxr-xr-x 6 xyz00 xyz00 4096 Jan 30 17:23 typo3_src-3.5.0
drwxr-xr-x 2 xyz00 xyz00 4096 Feb 21 2002 Maildir

Als nächstes entpacken wir das Testsite- oder Dummy-Paket. Wir gehen in das Verzeichnis der Domain, in dem Typo3 laufen soll:

xyz00-doms@hopi:~$ cd doms/example.com/subs/www

Hierher entpacken wir das Testsite- oder das Dummy-Paket. Für Anfänger empfehlen wir die Testsite-Version.

xyz00-doms@hopi:~/doms/example.de/subs/www$ tar -xvzf /usr/local/tmp/Typo3Install/testsite-3.5.tgz

oder:

xyz00-doms@hopi:~/doms/example.de/subs/www$ tar -xvzf /usr/local/tmp/Typo3Install/dummy-3.5.0.tar.gz

Jetzt müssen noch die SymLinks umgesetzt werden. Zuerst erstellen wir drei Links auf Verzeichnisse in der zentrale SRC-Installationsdatei, in unserem Fall auf den Link typo3_src, den wir vorhin erstellt haben und der ja seinerseits auf die zentrale SRC-Datei verweist:

xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s ~/typo3_src/typo3 typo3
xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s ~/typo3_src/tslib tslib
xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s ~/typo3_src/t3lib t3lib

Anschließend setzen wir noch drei Links innerhalb des Domain-Verzeichnisses:

xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s tslib/index_ts.php index.php
xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s tslib/media media
xyz00-doms@hopi:~/doms/example.de/subs/www$ ln -s tslib/showpic.php showpic.php

Das Verzeichnis sollte jetzt so aussehen:

drwxr-xr-x 6 xyz00-do xyz00 4096 Mar 9 19:16 .
drwxr-xr-x 7 xyz00-do xyz00 4096 Mar 12 10:21 ..
-rwxr-xr-x 1 xyz00-do xyz00 46 Feb 6 2002 clear.gif
drwxr-xr-x 10 xyz00-do xyz00 4096 Mar 9 19:19 fileadmin
-rw-r--r-- 1 xyz00-do xyz00 272 Jan 27 21:10 .htaccess
lrwxrwxrwx 1 xyz00-do xyz00 18 Mar 3 18:56 index.php -> tslib/index_ts.php
lrwxrwxrwx 1 xyz00-do xyz00 12 Mar 3 18:56 media -> tslib/media/
lrwxrwxrwx 1 xyz00-do xyz00 17 Mar 3 18:56 showpic.php -> tslib/showpic.php
lrwxrwxrwx 1 xyz00-do xyz00 21 Mar 9 19:26 t3lib -> ../../typo3_src/t3lib
lrwxrwxrwx 1 xyz00-do xyz00 21 Mar 9 19:26 tslib -> ../../typo3_src/tslib
lrwxrwxrwx 1 xyz00-do xyz00 21 Mar 9 19:26 typo3 -> ../../typo3_src/typo3
drwxr-xr-x 3 xyz00-do xyz00 4096 Mar 9 19:21 typo3conf
drwxr-xr-x 2 xyz00-do xyz00 4096 Mar 16 11:31 typo3temp
drwxr-xr-x 8 xyz00-do xyz00 4096 Mar 9 19:19 uploads

== Typo3 konfigurieren ==

Typo3 ist nun unter www.example.com/typo3 erreichbar. Zum Konfigurieren ruft man im Browser das install-Tool unter www.example.com/typo3/install auf. Das install-Tool ist aber noch durch ein die() vor Ausführung geschützt. Daher müssen wir zunächst die Datei subs/typo3_src/typo3/install/index.php editieren und das die() auskommentieren. Das sieht dann in etwa so aus:

//**************************************************************************
// Insert some security here, if you don't trust the Install Tool Password:
//**************************************************************************
//die("In the main source distribution of Typo3, the install script is disabled by a die() function call.
//if (substr(getenv("REMOTE_ADDR"),0,12)!="192.168.1.18" && getenv("REMOTE_ADDR")!="213.237.20.63")
exit;

Dann kann das Install-Tool gestartet werden: http://www.example.com/typo3/install/

Man sollte auf jeden Fall sofort das Install-Tool-Passwort ändern! (es heißt zu Beginn joh316)
=== BASIC CONFIGURATION ===

* Unter Basic Configuration muss jetzt der Benutzername und das Passwort für MySQL eingerichtet werden. Dann kann eine Datenbank erzeugt werden. Typo3 verwendet einen Deiner Nutzer für den MySQL-Server, der aber noch angelegt werden muss. Eine Beschreibung dazu gibt es hier.
* Jetzt muss der Pfad zu ImageMagick angegeben werden, also entweder /usr/bin für 5.4.4 oder das Verzeichnis, in das Du eine andere, z.B. die 4.2.9-Version entpackt hast (s.o.).
* Die Zeile ImageMagick [lzw] muss!!! leer bleiben, damit die LZW-Funktionen der GD-Lib genutzt werden!!

=== DATABASE ANALYSER ===

* Update required tables -> COMPARE klicken
dann auf write to database klicken
* Dump static data -> IMPORT klicken
dann alle Tabellen zum Import markieren und dann write to database klicken.
* Admin-User anlegen. Dieser Admin-User und das Passwort sind nötig für den ersten Zugang zum Backend der neuen Website.

=== ALL CONFIGURATION ==0

* [im_combine_filename] = 'combine' setzen
* [TTFdpi] = '96' setzen
* [gif_compress] ='' setzen

=== IMAGE PROCESSING ===

Alle Tests sollten erfolgreich sein: Die Bilder sind ein wenig größer als die Referenz - das ist OK und liegt daran, dass Freetype 2 verwendet wird. Dafür sind die Ergebnisse besser.

Jetzt sollte unter http://www.example.com die Typo3-Testsite zu erreichen sein. Das Backend erreicht man unter http://www.example.com/typo3/.
----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Typo3]]
[[Kategorie:Baustelle]]

Diskussion:Installationsanleitungen:Plone 3.1

2009-02-21T18:48:28Z

Jrs00-wiki: hat „Diskussion:Installationsanleitungen:Plone 3.1“ nach „Diskussion:Plone 3.1 installieren“ verschoben: Wenn die Installationsanleitungen mit dem Namen der Software beginnen, werden sie in der Kategorie:Installationsanleitungen nicht alle

#REDIRECT [[Diskussion:Plone 3.1 installieren]]

Diskussion:Plone 3.1 installieren

2009-02-21T18:48:28Z

Plone Installieren

2009-02-21T18:47:50Z

Jrs00-wiki: hat „Installationsanleitungen:Plone 2.5“ nach „Plone 2.5 installieren“ verschoben: Wenn die Installationsanleitungen mit dem Namen der Software beginnen, werden sie in der Kategorie:Installationsanleitungen nicht alle unter dem Buchstaben

== Installation ==
In der Anleitung findet die Installation im Home-Verzeichnis des accountes xy00-plone statt.
Die Installation von Plone 2.5 erfolgt weitgehend automatisiert mit Hilfe von buildout, einer Software zur
Erzeugung reproduzierbarer Installationen.

=== Erzeugen der Umgebung mit Paste Script für das buildout ===

Zunächst wird mit Hilfe von Paste Script eine Umgebung erzeugt:

xyz00-plone@h99:~$ /opt/python/2.4.5/bin/paster create -t plone2_buildout plone2.5

Scriptausgabe bis zur 1.ten Eingabeaufforderung:

Selected and implied templates:
ZopeSkel#plone3_buildout A buildout for Plone 3 projects

Variables:
egg: plone2.5
package: plone2.5
project: plone2.5
Enter zope2_install (Path to Zope 2 installation; leave blank to fetch one) ['']:

Folgenden Pfad für Zope2 eingeben:

/opt/plone/3.1/parts/zope2

Alle weiteren Eingabeaufforderungen können ohne Eingabe mit ENTER bestätigt werden, da diese Einstellungen später ersetzt werden.

Nach der Erzeugung der Umgebung muss diese einmalig initialisiert werden:

xyz00-plone@h99:~$ cd plone2.5/
xyz00-plone@h99:~/plone2.5$ /opt/python/2.4.5/bin/python2.4 ./bootstrap.py

=== Konfiguration und Installation mit buildout ===

Anschließend muss die zentrale Konfigurationsdatei durch die folgenden Inhalte ersetzt werden. Die fett markierten Einstellungen müssen individuell angepasst werden. Es können weitere Optionen nach Bedarf konfiguriert werden, um beispielsweise zusätzliche Products oder eggs zu installieren.

Shell Befehl
xyz00-plone@h99:~/plone2.5$ nano buildout.cfg

Inhalt der buildout.cfg
[buildout]
executable = /opt/python/2.4.5/bin/python2.4
eggs-directory = /opt/plone/2.5/eggs
newest = false
parts =
plone
productdistros
instance
zopepy
find-links =
http://dist.plone.org
http://download.zope.org/ppix/
http://download.zope.org/distribution/
http://effbot.org/downloads
eggs =
develop =

[plone]
recipe = plone.recipe.plone
urls =

[productdistros]
recipe = plone.recipe.distros
urls =
nested-packages =
version-suffix-packages =

[instance]
recipe = plone.recipe.zope2instance
zope2-location = /opt/plone/2.5/parts/zope2
user = admin:password
ip-address = '''xyz00'''.hostsharing.net
http-address = '''12300'''
ftp-address = '''12301'''
webdav-address = '''12302'''
debug-mode = off
verbose-security = off
eggs =
${buildout:eggs}
${plone:eggs}
zcml =
products =
${buildout:directory}/products
${productdistros:location}
/opt/plone/2.5/parts/productdistros
/opt/plone/2.5/parts/plone

[zopepy]
recipe = zc.recipe.egg
eggs = ${instance:eggs}
interpreter = zopepy
extra-paths = ${instance:zope2-location}/lib/python
scripts = zopepy

'''Achtung:''' Der angegebene Benutzer wird mit dem zugewiesenen Kennwort beim ersten Start der Zope-Instanz angelegt. Es empfiehlt sich aus Sicherheitsgründen, dass Kennwort nach dem ersten Start der Zope-Instanz aus der Konfigurationsdatei zu entfernen.

Nach der Anpassung der Konfigurationsdatei buildout.cfg muss die Installation durch den Aufruf von buildout aktualisiert werden.

xyz00-plone@h99:~/plone2.5$ bin/buildout

=== Installation zusätzlicher Softwarepakete ===

Zusätzliche Softwarepakete in egg-Form können in das Verzeichnis "src" installiert und im Abschnitt "[buildout]" der "buildout.cfg" unter "eggs" und "develop" eingetragen werden. Zusätzliche Softwarepakete in "Product"-Form können in den Abschnitt "[productdistros]" eingetragen oder in der Verzeichnis "products" installiert werden. Dies gilt gleichermaßen für Eigenentwicklungen wie Softwarepakete von Drittanbietern.
Starten und Stoppen der Instanz

=== Zope Instanz starten/stoppen ===

Die Zope Instanz kann über von buildout erzeugte Skripte gestartet oder gestoppt werden.
Die Zope Instanz kann mehrer "Plone Sites" verwalten, so dass für jede weitere dom nur eine "Plone_ Site mit entsprechenden namen erstellt wird und die dazugehörige .htaccess erstellt werden muss.

Start
xyz00-plone@h99:~/plone2.5$ bin/instance start

Stop
xyz00-plone@h99:~/plone2.5$ bin/instance stop

=== Erzeugen der Plone Site ===

Eine laufende Instanz kann jederzeit über http://xyz00.hostsharing.net:12300/ mit dem Webbrowser direkt angesprochen werden. Dabei ist der jeweilige Paketname und der zugewiesene Port für HTTP zu verwenden.

Mit Hilfe des Zope Management Interfaces (ZMI) wird nun eine Plone Site angelegt. Dazu wird im Webbrowser http://xyz00.hostsharing.net:12300/manage aufgerufen und nach dem Login mit den vergebenen Zugangsdaten aus der Drop Down-Liste "Plone Site" ausgewählt und per "Add" hinzugefügt. Die Plone Site sollte plone_site_example_com genannt werden.

Die laufende Plone Site kann anschließend über http://xyz00.hostsharing.net:12300/plone_site mit Webbrowser angesprochen werden.

=== Konfiguration von Apache ===

Um die erzeugte Plone Site auch über einen registrierten Domainnamen ansprechen zu können, wird im Verzeichnis der jeweiligen Subdomain eine Konfigurationsdatei .htaccess mit dem folgenden, vorgegebenen Inhalt hinterlegt. Dabei müssen der Name des Pakets, der Name der Domain und der zugewiesene Port für HTTP angepasst werden.

xyz00-plone@h99:~$ nano ~/doms/example.com/subs/www/.htaccess

RewriteEngine on
RewriteCond %{SERVER_PORT} ^80$
RewriteRule ^(.*) http://xyz00.hostsharing.net:12300/VirtualHostBase/http/www.example.com:80/plone_site_example_com/VirtualHostRoot/${escape:$1} [P,L]
RewriteCond %{SERVER_PORT} ^443$
RewriteRule ^(.*) http://xyz00.hostsharing.net:12300/VirtualHostBase/https/www.example.com:443/plone_site_example_com/VirtualHostRoot/${escape:$1} [P,L]

== Erste Schritte ==

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Plone]]
[[Kategorie:Baustelle]]

AWStats installieren

2009-02-21T18:46:56Z

Jrs00-wiki: hat „Installationsanleitungen:AWStats“ nach „AWStats installieren“ verschoben: Wenn die Installationsanleitungen mit dem Namen der Software beginnen, werden sie in der Kategorie:Installationsanleitungen nicht alle unter dem Buchstaben I ei

== AWStats ==

AWStats ist ein Tool zur graphischen Auswertung von Logfiles.

mehr Infos unter http://www.awstats.org/

=== Vorarbeiten ===

Als Paketadmin die Logfiles per Eintrag in die config.ini auf die entsprechende Domain verteilen (http_log_directory = domain)
siehe Traffic_logs.

=== Download und Entpacken ===

Login als Domainadmin, in unserem Fall heißt dieser xyz00-doms. In unserem Beispiel verwenden wir die Version 6.9 und laden sie direkt mit wget ins Home-Verzeichnis:
<pre>
xyz00-doms:~$ wget http://prdownloads.sourceforge.net/awstats/awstats-6.9.tar.gz
</pre>
Datei entpacken:
<pre>
xyz00-doms:~$ tar -xvzf awstats-6.9.tar.gz
</pre>
Die entpackten Ordner verteilen:
<pre>
xyz00-doms:~$ mv awstats-6.9/wwwroot/cgi-bin/ doms/example.com/cgi/awstats
xyz00-doms:~$ mv awstats-6.9/wwwroot/icon doms/example.com/subs/www/icon
xyz00-doms:~$ mv awstats-6.9/wwwroot/js doms/example.com/subs/www/js
</pre>
Der Rest kann wieder gelöscht werden:
<pre>
xyz00-doms:~$ rm awstats-6.9.tar.gz
xyz00-doms:~$ rm -rf awstats-6.9
</pre>
Verzeichnis anlegen, in das awstats seine Daten schreiben kann:
<pre>
xyz00-doms:~$ mkdir aw_data
</pre>
Verzeichnis anlegen, in das die erzeugten Statistiken abgelegt werden:
<pre>
xyz00-doms:~$ mkdir doms/example.com/subs/www/statistik
</pre>

=== Konfiguration ===
Config-datei zum Editieren öffnen, z.b. mit nano:
<pre>
xyz00-doms:~$ nano doms/example.com/cgi/awstats/awstats.example.com.conf
</pre>

Folgende Einträge sind anzupassen:

* LogFile="gzip -cd /home/doms/example.com/var/*example.com-%YYYY-0%MM-0%DD-0*|"
* SiteDomain="www.example.com"
* DirData="/home/pacs/xyz00/aw_data/"
* DirCgi="/cgi-bin/awstats"
* Lang="de"

Die wichtigsten weiteren Möglichkeiten:

* Um über den Browser eine Jahressortierung zu ermöglichen:
AllowFullYearView=3
* Um Client-Informationen über Javascript auszulesen:
o MiscTrackerUrl="/js/awstats_misc_tracker.js"
o ShowScreenSizeStats=1
o ShowMiscStats=anjdfrqwp

(hinweis: dazu muss die Startseite (index.html) innerhalb des body-tags um folgenden Eintrag ergänzt werden:
<pre>
<script language=javascript src="/js/awstats_misc_tracker.js"></script>
<noscript><img src="/js/awstats_misc_tracker.js?nojs=y" height=0 width=0 border=0 style="display: none"></noscript>
</pre>

Weiterführende Informationen zu den Einträgen in der Config-Datei sind hier zu finden: http://awstats.sourceforge.net/docs/awstats_config.html

Config-Datei unter cgi/awstats/awstats.example.com.conf abspeichern.
=== Rechtevergabe ===

Folgende Rechte müssen wir noch setzen:
<pre>
Prüfen:
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/lang
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/lib
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/plugins
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/awstats.pl
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/awredir.pl
xyz00-doms:~$ chmod 755 doms/example.com/subs/www/icon
xyz00-doms:~$ chmod 755 doms/example.com/subs/www/js

Ändern:
xyz00-doms:~$ chmod 644 doms/example.com/cgi/awstats/awstats.example.com.conf
xyz00-doms:~$ chmod 777 aw_data
</pre>

=== Ausführen und Automatisieren ===

Falls schon ein Log-file für den aktuellen Tag vorhanden ist, kann

awstats durch folgenden Befehl gestartet werden (alles in einer Zeile!):
<pre>
xyz00-doms:~$ /home/doms/example.com/cgi/awstats/awstats.pl -config=example.com -update -output > /home/doms/example.com/subs/www/statistik/index.html
</pre>

Diesen Befehl kann man z.B. mit dem event-handler @weblogsplit verbinden. Mit Cronjobs lässt sich der Aufruf natürlich auch automatisieren.

Die Statistiken sind dann im web unter www.example.com/statistik/ erreichbar.

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:AWStats]]

Autorenportal

2009-02-21T18:43:10Z

Jrs00-wiki: /* Wo ist Arbeit nötig? */

Das Hostsharing-Wiki ist ein gemeinsames Projekt der Hostsharing-Mitglieder, in dem wir die Dokumentation der Dienste von Hostsharing überarbeiten und auf den aktuellen Stand bringen möchten. Auf dieser Seite findest du Informationen dazu, wie du dich daran beteiligen kannst.

== Erste Schritte ==

Um mitmachen zu können, musst du dir als erstes ein Benutzerkonto im Hostsharing-Wiki anlegen. Das Wiki verwendet den Single-Sign-On-Dienst von Hostsharing, sodass du das Wiki mit jedem gültigen Benutzerkonto nutzen kannst, das auf den Hostsharing-Servern angelegt ist. Du kannst dir natürlich für die Nutzung des Wikis einen eigenes Konto anlegen, zum Beispiel xyz00-wiki oder xyz00-hsdoku.

Nachdem du dich im Wiki angemeldet hast, ist es sinnvoll, wenn du zunächst die Benutzereinstellungen anpasst. Mindestens deine E-Mail-Adresse solltest du eintragen, denn dann kannst du Seiten im Wiki beobachten und Nachrichten bekommen, wenn eine von dir beobachtete Seite geändert wurde.

Du solltest dich außerdem auf der Hostsharing-Mailingliste [https://lists.hostsharing.net/mailman/listinfo/website/ website@] anmelden. Dort diskutieren wir über die Weiterentwicklung der Dokumentation.

== Wo ist Arbeit nötig? ==

Im Moment ist fast die gesamte Dokumentation verbesserungsbedürftig, sodass du dich eigentlich überall sinnvoll einbringen kannst. Ganz konkret kannst du zum Beispiel schauen, welche Seiten hier im Wiki als [[:Kategorie:Baustelle|Baustelle]] gekennzeichnet sind und diese überarbeiten. Wenn du ganz neue Dokumentation schreiben möchtest, solltest einen Blick auf die [[Vorstand:Notizen|Hinweise zur Einführung von HSAdmin]] werfen, damit du nicht einen Text schreibst, der schon in wenigen Wochen wieder veraltet ist.

Natürlich kannst du auch als Benutzer die Dokumentation lesen und darauf hinweisen, wo aus deiner Sicht Verbesserungen notwendig sind. Um eine Seite als Baustelle zu kennzeichnen, trage einfach folgendes ganz am Anfang der Seite ein:

<nowiki>{{Baustelle}}</nowiki>

Am Anfang der Seite erscheint dann ein entsprechender Hinweis und die Seite wird in die [[:Kategorie:Baustelle|Liste der Baustellen]] aufgenommen.

== Konventionen ==

Wenn du an der Dokumentation arbeitest, solltest du unsere [[Hilfe:Hostsharing_Wiki_Konventionen|Konventionen]] und [[Hilfe:Guter_Stil|Hinweise zu gutem Stil]] beachten.

== Umgang mit der Wiki-Software ==

Wir verwenden als Software [http://www.mediawiki.org/ MediaWiki]. Nachfolgend einige Links auf Hinweise dazu, wie du im Wiki Texte formatierst und Links anlegst. Gefahrlos ausprobieren kannst du die Wiki-Funktionen auf der Seite [[Sandkasten]], diese ist explizit zum Experimentieren gedacht.

* [[Hilfe:Textgestaltung|Textformatierung im Wiki]]
* [[Hilfe:Link|Links anlegen]]

Autorenportal

2009-02-21T18:42:23Z

Jrs00-wiki: /* Wo ist Arbeit nötig? */ Hinweis auf Baustellen-Vorlage hinzugefügt.

Das Hostsharing-Wiki ist ein gemeinsames Projekt der Hostsharing-Mitglieder, in dem wir die Dokumentation der Dienste von Hostsharing überarbeiten und auf den aktuellen Stand bringen möchten. Auf dieser Seite findest du Informationen dazu, wie du dich daran beteiligen kannst.

== Erste Schritte ==

Um mitmachen zu können, musst du dir als erstes ein Benutzerkonto im Hostsharing-Wiki anlegen. Das Wiki verwendet den Single-Sign-On-Dienst von Hostsharing, sodass du das Wiki mit jedem gültigen Benutzerkonto nutzen kannst, das auf den Hostsharing-Servern angelegt ist. Du kannst dir natürlich für die Nutzung des Wikis einen eigenes Konto anlegen, zum Beispiel xyz00-wiki oder xyz00-hsdoku.

Nachdem du dich im Wiki angemeldet hast, ist es sinnvoll, wenn du zunächst die Benutzereinstellungen anpasst. Mindestens deine E-Mail-Adresse solltest du eintragen, denn dann kannst du Seiten im Wiki beobachten und Nachrichten bekommen, wenn eine von dir beobachtete Seite geändert wurde.

Du solltest dich außerdem auf der Hostsharing-Mailingliste [https://lists.hostsharing.net/mailman/listinfo/website/ website@] anmelden. Dort diskutieren wir über die Weiterentwicklung der Dokumentation.

== Wo ist Arbeit nötig? ==

Im Moment ist fast die gesamte Dokumentation verbesserungsbedürftig, sodass du dich eigentlich überall sinnvoll einbringen kannst. Ganz konkret kannst du zum Beispiel schauen, welche Seiten hier im Wiki als [[:Kategorie:Baustelle|Baustelle]] gekennzeichnet sind und diese überarbeiten. Wenn du ganz neue Dokumentation schreiben möchtest, solltest einen Blick auf die [[Vorstand:Notizen|Hinweise zur Einführung von HSAdmin]] werfen, damit du nicht einen Text schreibst, der schon in wenigen Wochen wieder veraltet ist.

Natürlich kannst du auch als Benutzer die Dokumentation lesen und darauf hinweisen, wo aus deiner Sicht Verbesserungen notwendig sind. Um eine Seite als Baustelle zu kennzeichnen, trage einfach folgendes ganz am Anfang der Seite ein:

<nowiki>{{Baustelle}}</nowiki>

Am Anfang der Seite erscheint dann ein entsprechender Hinweis und die Seite wird in die [[Kategorie:Baustelle|Liste der Baustellen]] aufgenommen.

== Konventionen ==

Wenn du an der Dokumentation arbeitest, solltest du unsere [[Hilfe:Hostsharing_Wiki_Konventionen|Konventionen]] und [[Hilfe:Guter_Stil|Hinweise zu gutem Stil]] beachten.

== Umgang mit der Wiki-Software ==

Wir verwenden als Software [http://www.mediawiki.org/ MediaWiki]. Nachfolgend einige Links auf Hinweise dazu, wie du im Wiki Texte formatierst und Links anlegst. Gefahrlos ausprobieren kannst du die Wiki-Funktionen auf der Seite [[Sandkasten]], diese ist explizit zum Experimentieren gedacht.

* [[Hilfe:Textgestaltung|Textformatierung im Wiki]]
* [[Hilfe:Link|Links anlegen]]