Content
Dateianzeige für slims (1.4.2)
usr/share/doc/slims/slims.txt
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