Hostsharing Wiki - Benutzerbeiträge [de]

Verwalten der Zonendaten

2011-01-19T13:47:26Z

Ble00: Formatierung korrigiert (aber: stimmt der Hinweis mit dem "am Ende der pri.example.com Datei stehen" überhaupt?), Bsp. zu einem funktionierenden vervollständigt

{{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 mail
IN MX 80 {MX2_HOSTNAME}.
TXT "v=spf1 +a +mx ~all"
; see http://spf.pobox.com/ for details on spf record
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]]

Analog installieren

2009-06-18T23:48:47Z

Ble00:

== 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 [[Eventhandler]] zu lösen. Damit kann man nämlich festlegen, dass die Auswertung direkt nach dem Verschieben oder Erzeugen der Logfiles erfolgt.

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]]

AWStats installieren

2009-06-18T23:46:26Z

Ble00:

== 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 [[Eventhandler]] @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]]