Das Slims-Paket Die Einleitung Dieses Paket basiert auf der Software Slimserver der amerikanischen Firma 'Logitech, Inc.'. Es ermoeglicht die komfortabele Nutzung der 'Squeezebox'-Endgeraete und erlaubt das Abspielen von Musikdateien oder auch Audio-Streams. Die Funktionen Das Slims-Packet besteht aus folgenden Komponenten: * Slimserver - wird zum Betrieb der Squeezebox-Endgeraete benoetigt. ([1]http://www.slimdevices.com/) * PhoneBook.pm - wird zur Anzeige eines Telefonbuchs benoetigt. ([2]http://www.slimp3.rtfm.info/downloads/) * RadioPlaylist.pm - wird zum Modifizieren der Radio-Liste benoetigt. ([3]http://petherton.pwp.blueyonder.co.uk/SlimServer/) * AmazonImage - wird zum Herunterladen von Plattenhuellen-Bilddateien benoetigt. ([4]http://www.victorland.com/slimp3/) * SuperDateTime - wird zum Anzeigen von Wetterdaten verwendet. ([5]http://www.gregbrown.net/squeeze/) Die Voraussetzungen Dieses Paket benoetigt zur korrekten Funktion ein installiertes Perl-Paket. Die Installation Das Slims-Paket wird ueber das Setup-Menue installiert. Wird eine aeltere Paketversion vorgefunden, so wird deren Konfiguration gesichert und das alte Paket deinstalliert bevor die neuen Programmdateien installiert und die Konfiguration uebernommen wird. Danach wird direkt der Konfigurations-Editor gestartet um die Konfiguration eventuell anpassen zu koennen. Nach Beendigung dieses Schrittes werden die Konfigurationsdateien generiert und das benoetigte Programm gestartet. Das Menue im Setup-Programm Das Menue im Setup-Programm ist wie folgt aufgebaut: * Slimserver administration + View documentation: Anzeigen der Dokumentation + Edit configuration: Bearbeiten der Konfiguration + Advanced configuration file handling: Konfigurationen verwalten + View configuration log file: Die Konfigurations-Logmeldungen anzeigen + Show Status: Status der Slimserver-Komponenten anzeigen + Stop slimserver services: Alle Slimserver-Komponenten anhalten + Start slimserver services: Alle Slimserver-Komponenten starten + View log file: Die Slimserver-Logdatei anzeigen + Return: Untermenue verlassen Die Menuepunkte duerften selbsterklaerend sein, da sie keinerlei weitere Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter eingegangen. Die Aenderung der Konfiguration Die Konfiguration kann ueber den Menuepunkt 'Edit configuration' geaendert werden. Standardmaessig wird der Editor aufgerufen, der in der Environment-Konfiguration ueber die Variable 'EDITOR' festgelegt wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die Konfiguration aktiviert werden soll. Wird dies bestaetigt, werden ueber ein Skript die Anpassungen umgehend wirksam gemacht. Die Konfigurationsdatei In der Konfigurationsdatei, die ueber das Menue zugaenglich ist, sind folgende Parameter vorhanden; wer sie von Hand editieren will findet die Konfigurationsdatei unter /etc/config.d/slims. Die Parameter START_SLIMS Fuer die Aktivierung des Slims-Programms muss diese Variable auf den Wert 'yes' gestellt werden. Die Einstellung 'no' schaltet das Slims-Programm ab. Gueltige Werte: yes, no Standardeinstellung: START_SLIMS='no' SLIMS_ALLOWED_ADDRESSES Ueber diesen Parameter koennen IP-Adressen oder Netzwerke angegeben werden, von denen es zusaetzlich zum lokalen Host erlaubt ist eine Verbindung zum Slimserver-Daemon aufzubauen. Gueltige Werte: IP-Adressen und/oder Netzwerke Beipiel: SLIMS_ALLOWED_ADDRESSES='192.168.6.20,192.168.7.0/24' SLIMS_LISTEN_PORT Ueber diesen Parameter wird der TCP-Port festgelegt, auf dem der Slimserver-Daemon den Web-Frontend fuer die Konfiguration zur Verfuegung stellt. Gueltige Werte: Zahl Standardeinstellung: SLIMS_LISTEN_PORT='9000' SLIMS_OPTIONS Ueber diesen Parameter koennen optionale Startparameter definiert werden. Eine Liste dieser Parameter kann man sich mittels des folgenden Aufrufs anzeigen lassen: /usr/bin/slimserver.pl -help Gueltige Werte: Zulaessiger Parameter Beispiel: SLIMS_OPTIONS='-nosetup' SLIMS_WEB_AUTH Ueber diesen Parameter wird festgelegt ob beim Zugriff auf die Slimserver-Weboberflaeche eine Authentifizierung erfolgen soll oder nicht. Gueltige Werte: yes oder no Standardeinstellung: SLIMS_WEB_AUTH='no' SLIMS_WEB_USER Ueber diesen Parameter wird der Username festgelegt, mit dem die Authentifizierung an der Slimserver-Weboberflaeche erfolgen soll. Dieser Parameter wird nur ausgewertet, wenn [6]SLIMS_WEB_AUTH='yes' gesetzt wurde. Gueltige Werte: Username Beispiel: SLIMS_WEB_USER='slims' SLIMS_WEB_PASS Ueber diesen Parameter wird das Kennwort festgelegt, mit dem die Authentifizierung an der Slimserver-Weboberflaeche erfolgen soll. Dieser Parameter wird nur ausgewertet, wenn [7]SLIMS_WEB_AUTH='yes' gesetzt wurde. Gueltige Werte: Kennwort Beispiel: SLIMS_WEB_PASS='geheim' SLIMS_HTTP_PROXY Ueber diesen Parameter kann der Name oder die IP-Adresse und den Port eines HTTP/Web Proxys definiert werden, den der SlimServer verwenden soll, um auf Server ausserhalb ihres Netzwerkes zugreifen zu koennen. (Format: xxx.xxx.xxx.xxx:yyy) Gueltige Werte: Name/IP-Adresse und TCP-Port Standardeinstellung: SLIMS_HTTP_PROXY='' SLIMS_AUDIO_PATH Ueber diesen Parameter wird das Verzeichnis definiert, welches der SlimServer nach Musikdateien durchsuchen und dessen Inhalt er zur Musiksammlung hinzufuegen soll. Gueltige Werte: absolute Pfadangabe Standardeinstellung: SLIMS_AUDIO_PATH='/var/slims/audio' SLIMS_AUDIO_PATH_USER Optionaler Parameter: Ueber diesen Parameter kann ein vom Standard abweichender Eigentuemer des ueber den Parameter SLIMS_AUDIO_PATH definierten Verzeichnisses festgelegt werden. Wird dieser Parameter nicht gesetzt, so wird standardmaessig der Eigentuemer 'slims' gesetzt. ACHTUNG Wird dieser Parameter falsch gesetzt, so kann dem Slimserver der Zugriff auf die Audiodateien entzogen werden! Gueltige Werte: gueltiger Systemuser Beispiel: SLIMS_AUDIO_PATH_USER='slims' SLIMS_AUDIO_PATH_GROUP Optionaler Parameter: Ueber diesen Parameter kann eine vom Standard abweichende Eigentuemergruppe des ueber den Parameter SLIMS_AUDIO_PATH definierten Verzeichnisses festgelegt werden. Wird dieser Parameter nicht gesetzt, so wird standardmaessig die Eigentuemergruppe 'nogroup' gesetzt. ACHTUNG Wird dieser Parameter falsch gesetzt, so kann dem Slimserver der Zugriff auf die Audiodateien entzogen werden! Gueltige Werte: gueltiger Systemgruppe Beispiel: SLIMS_AUDIO_PATH_OWNER='nogroup' SLIMS_COVER_PATH Ueber diesen Parameter wird das Verzeichnis definiert, in welchem die Plattenhuellen abgelegt werden sollen. Generell werden auch die Verzeichnisse der Musikdateien nach Bilddateien fuer die Plattenhuellen durchsucht. Gueltige Werte: absolute Pfadangabe Standardeinstellung: SLIMS_COVER_PATH='/var/slims/cover' SLIMS_PLAYLIST_PATH Ueber diesen Parameter wird das Verzeichnis definiert, in welchem die Wiedergabelisten abgelegt werden sollen. Gueltige Werte: absolute Pfadangabe Standardeinstellung: SLIMS_PLAYLIST_PATH='/var/slims/playlists' SLIMS_MANUAL_CONFIGURATION Wird der Parameter auf 'no' gesetzt, so wird die Konfigurationsdatei immer mittels Standardwerte neu geschrieben. Der Wert 'yes' hingegen sorgt dafuer, dass nur die ueber die Konfiguration festgelegten Parameter aktualisiert werden. Eventuell ueber die Weboberflaeche durchgefuehrte Aenderungen bleiben so erhalten. Gueltige Werte: yes oder no Standardeinstellung: SLIMS_MANUAL_CONFIGURATION='yes' Die Logdateien Das Slims-Paket verwendet Logdateien, um Meldungen ueber seinen laufenden Betrieb zu speichern. Um zu verhindern, dass diese Dateien zu gross und unuebersichtlich werden, kann man einstellen wie das System mit den Dateien umgehen soll. SLIMS_LOG_COUNT Ueber diesen Parameter wird eingestellt, wie viele Logdateien vorgehalten werden sollen. Wird dieser Wert ueberschritten, so wird die aelteste Logdatei geloescht. Gueltige Werte: Zahl Standardeinstellungen: SLIMS_LOG_COUNT='10' SLIMS_LOG_INTERVAL Dieser Parameter bestimmt in welchen Intervallen die Logdateien archiviert werden sollen. Zur Auswahl stehen die Schluesselwoerter 'daily' - taeglich, 'weekly' - woechentlich und 'monthly - monatlich. Gueltige Werte: daily, weekly, monthly Standardeinstellungen: SLIMS_LOG_INTERVALL='weekly' Wie geht es weiter? Nachdem der Slimserver-Daemon gestartet wurde kann die Weboberflaeche ueber einen Webbrowser aufgerufen werden. Hierzu wird einfach der Name des Servers, gefolgt von dem ueber den Parameter [8]SLIMS_LISTEN_PORT konfigurierten Port, eingegeben. Beispiel: http://:9000/ Wenn [9]SLIMS_WEB_AUTH='yes' gesetzt wurde muss man sich vor dem Zugriff authentifizieren. Hierzu werden die ueber die Parameter [10]SLIMS_WEB_USER und [11]SLIMS_WEB_PASS festgelegten Account-Daten verwendet. Danach kann man die weitere Konfiguration ueber die Weboberflaeche durchfuehren. Wer zusaetzliche Informationen ueber die Slimserver-Server-Software oder auch die Squeezebox(en) benoetigt kann diese ueber die Webseite des Herstellers ([12]http://www.slimdevices.com) abrufen. Die Problemanalyse Debug-Ausgaben aktivieren Falls man bei der Fehleranalyse absolut nicht weiterkommt, kann man die Variable SLIMS_DO_DEBUG='yes' zur Datei /etc/config.d/slims hinzufuegen und dann mittels '/etc/init.d/slims restart' den Slimserver-Daemon neu starten. Weitere Debugmoeglichkeiten koennen ueber die Weboberflaeche des Slimserver konfiguriert werden. Debug-Ausgaben deaktivieren Um den Debug-Modus zu beenden muss der Parameter SLIMS_DO_DEBUG='no' gesetzt und der Slimserver-Daemon mittels '/etc/init.d/slims restart' neu gestartet werden. __________________________________________________________________ Juergen Edner 2012-05-23