Benutzer-Werkzeuge

Webseiten-Werkzeuge


tachtler:dreambox_syslog

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

tachtler:dreambox_syslog [2011/05/02 09:25] (aktuell)
Zeile 1: Zeile 1:
 +====== Dreambox Syslog ======
 +
 +Folgende Anpassungen des Syslogs können auf einer Dreambox durchgeführt werden. ​
 +
 +:!: **WICHTIG** - **Zur Durchführung der hier beschriebenen Änderungen sollte einer der Inhalte folgender Artikel dieses DokuWiki'​s bekannt sein:**
 +  * [[tachtler:​dreambox_telnet_zugang|Dreambox Telnet Zugang]] oder
 +  * [[tachtler:​dreambox_ssh_zugang|Dreambox SSH Zugang]]
 +
 +:!: **WICHTIG** - **Kenntnisse über den Umgang mit dem Linux-Editor ''​vi''​ sollten vorhanden sein !**
 + 
 +:!: **HINWEIS** - Für die Durchführung von **Remote**-Syslog auf einen entfernten Rechner, muss auf diesem ein **Logging-Deamon** wie z.B. [[tachtler:​rsyslog|RSyslog]] installiert und konfiguriert sein !!!
 +
 +:!: **HINWEIS** - Diese Anpassungen sind jedoch für den normalen Betrieb der Dreambox __**NICHT**__ erforderlich,​ eher als zusätzliche **Möglichkeiten** zu sehen!
 +
 +===== Installation syslogd =====
 +
 +:!: **WICHTIG** - **Ab OoZooN-Image Version 3.0.1 bis OoZooN-Image Version 3.0.x ist die Installation des Paketes ''​busybox-syslog''​ wie nachfolgend beschrieben erforderlich,​ da hier der syslog-Daemon nicht mehr automatisch installiert wurde !!!**
 +
 +Zuerst muss nachfolgendes Paket von nachfolgendem Link heruntergeladen werden: ​
 +  * [[http://​dreamboxupdate.com/​opendreambox/​1.6/​dm7025/​feed-rel_30/​mipsel/​busybox-syslog_1.15.3-r24.4a_mipsel.ipk|http://​dreamboxupdate.com/​opendreambox/​1.6/​dm7025/​feed-rel_30/​mipsel/​busybox-syslog_1.15.3-r24.4a_mipsel.ipk]]
 +
 +:!: **HINWEIS** - Je nach eingesetzter OoZooN-Image Version, kann der Download-Ort differieren - Das Paket hat den Namen
 +  * **busybox-syslog_<​Version>​_mipsel.ipk**
 +
 +Der Download kann auch direkt auf eine Dreambox mit nachfolgendem Befehl erfolgen, bitte melden Sie sich via **telnet**, oder **ssh** auf der Dreambox an und wechseln in das Verzeichnis ''/​tmp''​ mit nachfolgendem Befehl:
 +<​code>​
 +root@receiver:​~#​ cd /tmp/
 +</​code>​
 +
 +Der eigentlich Download erfolgt dann mit nachfolgendem Befehl:
 +<​code>​
 +root@receiver:/​tmp#​ wget http://​dreamboxupdate.com/​opendreambox/​1.6/​dm7025/​feed-rel_30/​mipsel/​busybox-syslog_1.15.3-r24.4a_mipsel.ipk
 +Connecting to dreamboxupdate.com (82.149.226.174:​80)
 +busybox-syslog_1.15. 100% |*************************************************************************************| ​ 2384  --:--:-- ETA
 +</​code>​
 +
 +Eine Installation kann dann mit nachfolgendem Befehl durchgeführt werden:
 +<​code>​
 +root@receiver:/​tmp#​ ipkg install /​tmp/​busybox-syslog_1.15.3-r24.4a_mipsel.ipk ​
 +Installing busybox-syslog (1.15.3-r24.4a) to root...
 +Configuring busybox-syslog
 + ​Adding system startup for /​etc/​init.d/​syslog.
 +Starting syslogd/​klogd:​ done
 +</​code>​
 +
 +:!: **HINWEIS** - **Der Syslog-Daemon wird nach erfolgreicher Installation ebenfalls gleich gestartet !!!**
 +
 +Eine Überprüfung,​ ob der Syslog-Deamon läuft, kann mit nachfolgendem Befehl durchgeführt werden (**nur relevanter Ausschnitt**):​
 +<​code>​
 +root@receiver:/​tmp#​ ps auxwwf ​               ​
 +  PID USER       VSZ STAT COMMAND
 +...
 +21825 root      2516 S    /​sbin/​syslogd -n -O /​var/​log/​messages -s 32 -b 1 -m 2
 +21827 root      2516 S    /sbin/klogd -n 
 +...
 +</​code>​
 +===== Standard Logging =====
 +
 +Auf der Dreambox ist das Logging bzw. der Logging-Daemon mit dem Namen ''​syslogd''​ standardmäßig **bis zum OoZooN-Image 2.8.4** zwar **aktiv**, jedoch werden die Log-Informationen nur in einen sogenannten **"​buffer"​**-Speicher geschrieben und sind deshalb in keiner Datei zu sehen. ​
 +
 +Die Konfiguration des ''​syslog''​-Daemons liegt im Verzeichnis ​
 +  * **''/​etc''​**
 +und erfolgt in der Konfigurationsdatei ​
 +  * **''/​etc/​syslog.conf''​**
 +und sieht standardmäßig wie nachfolgend dargestellt aus:
 +
 +:!: **HINWEIS** - **Bis Version OoZooN-Image Version 2.8.4 !!!**
 +
 +<​code>​
 +DESTINATION="​buffer" ​           # log destinations (buffer file remote)
 +MARKINT=20 ​                     # intervall between --mark-- entries
 +LOGFILE=/​var/​log/​messages ​      # where to log (file)
 +REMOTE=loghost:​514 ​             # where to log (syslog remote)
 +REDUCE=no ​                      # reduce-size logging
 +#​ROTATESIZE=0 ​                  # rotate log if grown beyond X [kByte] (incompatible with busybox)
 +#​ROTATEGENS=3 ​                  # keep X generations of rotated logs (incompatible with busybox)
 +BUFFERSIZE=64 ​                  # size of circular buffer [kByte]
 +FOREGROUND=no ​                  # run in foreground (don't use!)
 +</​code>​
 +
 +:!: **HINWEIS** - **Ab Version OoZooN-Image Version 3.0.1 !!!**
 +
 +<​code>​
 +DESTINATION="​file" ​             # log destinations (buffer file remote)
 +MARKINT=20 ​                     # interval between --mark-- entries [min]
 +REDUCE=no ​                      # reduced-size logging
 +BUFFERSIZE=64 ​                  # buffer: size of circular buffer [kByte]
 +LOGFILE=/​var/​log/​messages ​      # file: where to log
 +ROTATESIZE=32 ​                  # file: rotate log if grown beyond X [kByte] (busybox 1.2+)
 +ROTATEGENS=1 ​                   # file: keep X generations of rotated logs (busybox 1.2+)
 +REMOTE=loghost:​514 ​             # remote: where to log
 +FOREGROUND=no ​                  # run in foreground (don't use!)
 +</​code>​
 +
 +===== Logging nach /​var/​log/​messages =====
 +
 +Um das wegschreiben von Log-Informationen in die Standard-Log-Datei zu aktivieren, sind folgende Änderungen,​ welche wie folgt gekennzeichnet sind, durchzuführen:​
 +<​code>​
 +# Tachtler
 +</​code>​
 +
 +Hier die geänderte Konfigurationsdatei **''/​etc/​syslog.conf''​** mit aktivierten Logging in die Standard-Log-Datei
 +  * **''/​var/​log/​messages''​**
 +
 +:!: **HINWEIS** - **Bis Version OoZooN-Image Version 2.8.4 !!!**
 +
 +<​code>​
 +# Tachtler
 +# default: DESTINATION="​buffer" ​           # log destinations (buffer file remote)
 +DESTINATION="​file" ​             # log destinations (buffer file remote)
 +MARKINT=20 ​                     # intervall between --mark-- entries
 +LOGFILE=/​var/​log/​messages ​      # where to log (file)
 +REMOTE=loghost:​514 ​             # where to log (syslog remote)
 +REDUCE=no ​                      # reduce-size logging
 +#​ROTATESIZE=0 ​                  # rotate log if grown beyond X [kByte] (incompatible with busybox)
 +#​ROTATEGENS=3 ​                  # keep X generations of rotated logs (incompatible with busybox)
 +BUFFERSIZE=64 ​                  # size of circular buffer [kByte]
 +FOREGROUND=no ​                  # run in foreground (don't use!)
 +</​code>​
 +
 +:!: **HINWEIS** - **Ab Version OoZooN-Image Version 3.0.1 !!!**
 +
 +<​code>​
 +DESTINATION="​file" ​             # log destinations (buffer file remote)
 +MARKINT=20 ​                     # interval between --mark-- entries [min]
 +REDUCE=no ​                      # reduced-size logging
 +BUFFERSIZE=64 ​                  # buffer: size of circular buffer [kByte]
 +LOGFILE=/​var/​log/​messages ​      # file: where to log
 +ROTATESIZE=32 ​                  # file: rotate log if grown beyond X [kByte] (busybox 1.2+)
 +ROTATEGENS=1 ​                   # file: keep X generations of rotated logs (busybox 1.2+)
 +REMOTE=loghost:​514 ​             # remote: where to log
 +FOREGROUND=no ​                  # run in foreground (don't use!)
 +</​code>​
 +
 +Um die Änderungen an der Konfigurationsdatei **''/​etc/​syslog.conf''​** wirksam werden zu lassen, ist ein Neustart des ''​syslog''​-Deamons mit nachfolgendem Befehl erforderlich:​
 +<​code>​
 +root@receiver:​~#​ /​etc/​init.d/​syslog restart
 +Stopping syslogd/​klogd:​ stopped syslogd (pid 15793).
 +stopped klogd (pid 15795).
 +done
 +Starting syslogd/​klogd:​ done
 +</​code>​
 +
 +Anschließend kann die so neu entstandene Standard-Log-Datei mit nachfolgendem Befehl eingesehen werden:
 +<​code>​
 +root@receiver:​~#​ less /​var/​log/​messages
 +Apr  8 22:47:31 System log daemon exiting.
 +Apr  8 22:47:32 syslogd started: BusyBox v1.01 (2009.11.06-06:​23+0000)
 +Apr  8 22:47:32 receiver kernel: klogd started: BusyBox v1.01 (2009.11.06-06:​23+0000)
 +</​code>​
 +
 +oder sogar mit nachfolgendem Befehl in Echtzeit mitverfolgt werden:
 +<​code>​
 +root@receiver:​~#​ tail -f /​var/​log/​messages
 +Apr  8 22:47:31 System log daemon exiting.
 +Apr  8 22:47:32 syslogd started: BusyBox v1.01 (2009.11.06-06:​23+0000)
 +Apr  8 22:47:32 receiver kernel: klogd started: BusyBox v1.01 (2009.11.06-06:​23+0000)
 +</​code>​
 +
 +===== Logging zu einem Remote-Host =====
 +
 +Um das wegschreiben von Log-Informationen auf einen Remote-Host (entfernten Log-Server) zu aktivieren, sind folgende Änderungen,​ welche wie folgt gekennzeichnet sind, durchzuführen:​
 +<​code>​
 +# Tachtler
 +</​code>​
 +
 +Hier die geänderte Konfigurationsdatei **''/​etc/​syslog.conf''​** mit aktivierten Logging auf einen Remote-Host (entfernten Log-Server) mit der
 +  * **IP-Adresse** --> ''​192.168.0.1''​
 +  * **Port** --> ''​514''​
 +
 +:!: **HINWEIS** - **Bis Version OoZooN-Image Version 2.8.4 !!!**
 +
 +<​code>​
 +# Tachtler
 +# default: DESTINATION="​buffer" ​        # log destinations (buffer file remote)
 +DESTINATION="​remote" ​           # log destinations (buffer file remote)
 +MARKINT=20 ​                     # intervall between --mark-- entries
 +LOGFILE=/​var/​log/​messages ​      # where to log (file)
 +# Tachtler
 +# default: REMOTE=loghost:​514 ​          # where to log (syslog remote)
 +REMOTE=192.168.0.1:​514 ​         # where to log (syslog remote)
 +REDUCE=no ​                      # reduce-size logging
 +#​ROTATESIZE=0 ​                  # rotate log if grown beyond X [kByte] (incompatible with busybox)
 +#​ROTATEGENS=3 ​                  # keep X generations of rotated logs (incompatible with busybox)
 +BUFFERSIZE=64 ​                  # size of circular buffer [kByte]
 +FOREGROUND=no ​                  # run in foreground (don't use!)
 +</​code>​
 +
 +:!: **HINWEIS** - **Ab Version OoZooN-Image Version 3.0.1 !!!**
 +
 +<​code>​
 +# Tachtler
 +# default: DESTINATION="​file" ​          # log destinations (buffer file remote)
 +DESTINATION="​remote" ​           # log destinations (buffer file remote)
 +MARKINT=20 ​                     # interval between --mark-- entries [min]
 +REDUCE=no ​                      # reduced-size logging
 +BUFFERSIZE=64 ​                  # buffer: size of circular buffer [kByte]
 +LOGFILE=/​var/​log/​messages ​      # file: where to log
 +ROTATESIZE=32 ​                  # file: rotate log if grown beyond X [kByte] (busybox 1.2+)
 +ROTATEGENS=1 ​                   # file: keep X generations of rotated logs (busybox 1.2+)
 +# Tachtler
 +# default: REMOTE=loghost:​514 ​          # remote: where to log
 +REMOTE=192.168.0.1:​514 ​         # remote: where to log
 +FOREGROUND=no ​                  # run in foreground (don't use!)
 +</​code>​
 +
 +Um die Änderungen an der Konfigurationsdatei **''/​etc/​syslog.conf''​** wirksam werden zu lassen, ist ein Neustart des ''​syslog''​-Deamons mit nachfolgendem Befehl erforderlich:​
 +<​code>​
 +root@receiver:​~#​ /​etc/​init.d/​syslog restart
 +Stopping syslogd/​klogd:​ stopped syslogd (pid 15793).
 +stopped klogd (pid 15795).
 +done
 +Starting syslogd/​klogd:​ done
 +</​code>​
 +
 +:!: **HINWEIS** - **Ein Logging auf einen Remote-Host (entfernten Log-Server) muss auf diesem überprüft werden !!!**
 +
 +:!: **HINWEIS** - **Siehe auch nachfolgenden Artikel dieses DokuWiki'​s aus dem Bereich Linux** --> [[tachtler:​rsyslog|RSyslog]] ​
  
tachtler/dreambox_syslog.txt · Zuletzt geändert: 2011/05/02 09:25 (Externe Bearbeitung)