Installation von Tiny Tiny RSS: Unterschied zwischen den Versionen

Aus
(→‎daemon: +Skript)
Zeile 64: Zeile 64:
$ su -m nobody -c "(trap '' SIGHUP SIGINT SIGQUIT && /usr/bin/php /var/services/web/ttrss/update.php -daemon > /dev/null 2>&1) &"
$ su -m nobody -c "(trap '' SIGHUP SIGINT SIGQUIT && /usr/bin/php /var/services/web/ttrss/update.php -daemon > /dev/null 2>&1) &"
</pre>
</pre>
Da das nach jedem Neustart der DS ausgeführt werden muß, bietet sich ein Start-Stop-Skript an. Hierbei gibt es die kleine Schwierigkeit, daß der Nutzer nobody beim Booten keine Befehle ausführen kann, weshalb ein kleiner Umweg nötig ist (wer mehr weiß, [http://www.synology-forum.de/showthread.html?36351-Benutzer-nobody-in-start-stop-Skripten sagt Bescheid]).
Da das nach jedem Neustart der DS ausgeführt werden muß, bietet sich ein Start-Stop-Skript an. Hierbei gibt es die kleine Schwierigkeit, daß der Nutzer nobody beim Booten keine Befehle ausführen kann, weshalb ein kleiner Umweg nötig ist (wer mehr weiß, [http://www.synology-forum.de/showthread.html?36351-Benutzer-nobody-in-start-stop-Skripten sagt Bescheid]). Das Skript setzt voraus, daß Tiny Tiny RSS in ''/var/services/web/ttrss/'' installiert wurde. Es sollte in den Ordner ''/usr/local/etc/rc.d/'' geschoben und mit ''chmod 755'' ausführbar gemacht werden.
<pre>
<pre>
Wird noch veröffentlicht.
#!/bin/sh
#
# starts "Tiny Tiny Rss"ses update daemon
# put it into /usr/local/etc/rc.d/
# chmod 755 on it
 
getPID ()
{
ps|grep "/usr/bin/php /var/services/web/ttrss/update.php -daemon"|grep -v grep|awk '{print $1}'
return $?
}
 
start_daemon () {
su -m nobody -c "(trap '' SIGHUP SIGINT SIGQUIT && /usr/bin/php /var/services/web/ttrss/update.php -daemon >> /dev/null 2>&1) &"
return $?
}
 
cronLine="* * * * * root "`realpath $0`" cron"
 
case $1 in
start)
start_daemon
#su -m nobody -c "echo nobody start -ende >> /var/log/ttrss.log" >> /var/log/ttrss.log
stat=`getPID`
if [ -z "$stat" ]; then
echo "$cronLine" >> /etc/crontab
/usr/syno/etc/rc.d/S04crond.sh stop
/usr/syno/etc/rc.d/S04crond.sh start
fi
;;
stop)
kill `getPID`
;;
cron)
stat=`getPID`
if [ -z "$stat" ]; then
start_daemon
fi
sed -i -e "\\%$cronLine% d" /etc/crontab
/usr/syno/etc/rc.d/S04crond.sh stop
/usr/syno/etc/rc.d/S04crond.sh start
;;
*)
echo "Wrong argument. Usage: $0 start|stop"
;;
esac
</pre>
</pre>



Version vom 31. Dezember 2012, 19:22 Uhr

Tiny Tiny RSS ist ein server-basierter Feedreader. Neben einer AJAX-Weboberfläche bietet er auch ein API an, mit dem die abonnierten Feeds auch externen Anwendungen zur Verfügung stehen (wird genutzt vom Android Client, oder dem Linux-Feedreader Liferea). Dieser Artikel beschreibt, wie es auf einer DiskStation installiert und (basis-)konfiguriert werden kann. Dia Anleitung bezieht sich auf die Version 1.6.2 von Tiny Tiny RSS, und DSM Version 4.1 mit PHP 5.3.x. Das ist eine vorläufige Version. Bitte nur nach vorheriger Rücksprache bearbeiten. --EL Duderino 16:11, 30. Dez. 2012 (CET)

Vorarbeiten auf der DS

Webserver und Datenbank aktivieren

Sowohl die Web Station als auch MySQL müssen aktiviert werden. Tiny Tiny RSS akzeptiert auch PostgreSQL als Datenbank, worauf hier aber nicht eingegangen wird.

PHP konfigurieren

Die Software verlangt, daß open_basedir leer ist. Sollte das nicht möglich sein, ist es theoretisch machbar, open_basedir pro Pfad zu setzen. Wer mehr weiß, sagt Bescheid.

Soll der Update daemon ausgeführt werden, muß die PHP-Konfiguration geändert werden. Eine Lösung ist, die Option PHP safe_mode_exec_dir-Zugriffsbeschränkung abzuwählen. Das sollte keine Sicherheitslücken öffnen (vgl. [1] und [2]), und der Safe Mode ist in der PHP 5.4 sowieso nicht mehr vorhanden (Wer mehr weiß, sagt Bescheid).

Sollte Abwählen nicht möglich sein, muß auf der Kommandozeile mit root-Rechten folgendes ausgeführt werden:

$ ln -s /usr/bin/php /usr/syno/bin/php

Hintergrund ist, das /usr/syno/bin das voreingestellte safe_mode_exec_dir ist, vgl. auch die Ausgabe der PHP-Funktion phpinfo().

Beispielhafte PHP Konfiguration in der Weboberfläche

Tiny Tiny RSS konfigurieren

Im folgenden wird davon ausgegangen, das Tiny Tiny RSS in den Ordner /var/services/web/ttrss entpackt worden ist. Das geht zum Beispiel mit

$ cd /tmp
$ wget http://tt-rss.org/download/tt-rss-1.6.2.tar.gz
$ tar -xf tt-rss-1.6.2.tar.gz -C /var/services/web
$ mv /var/services/web/tt-rss-1.6.2 /var/services/web/ttrss

Datenbank erstellen

Es muß eine Datenbank angelegt und das sich im Unterverzeichnis schema/ttrss_schema_mysql.sql befindende Schema installiert werden. Wie das geht, beschreibt dieser Artikel. Die weitere Konfiguration erfordert, daß ein MySQL-Nutzer und dessen Passwort in die Datei config.php gespeichert werden. Alle Benutzer der DiskStation können diese Datei lesen. Daher empfiehlt es sich, zum Zugriff auf die angelegte Datenbank nicht den root-Account von MySQL zu benutzen, sondern einen eigenen MySQL-Nutzer anzulegen, der die nötigen Privilegien für diese Datenbank hat. Details dazu ebenfalls hier.

Schreibrechte

Der Nutzer nobody (auf der DiskStation/Linux, nicht in MySQL) braucht Schreibrechte auf die Verzeichnisse lock/, cache/, feed-icons/, cache/export/, cache/images/, cache/magpie/, cache/simplepie/. Dazu einfach auf der Shell

for dir in "lock" "cache" "feed-icons" "cache/export" "cache/images" "cache/magpie" "cache/simplepie"; do
	chmod -R 777 "$dir";
done

ausführen. Danach kann jeder DS-Nutzer diese Verzeichnisse schreiben. Das ist nicht weiter tragisch, da es nur Cache-Dateien betrifft.

config.php

Die Datei config.php-dist muß in config.php umbenannt werden. Bei den darin definierten PHP-Konstanten 'DB_TYPE', 'DB_USER', 'DB_NAME', 'DB_PASS' und 'SELF_URL_PATH' müssen mit einem Texteditor die richtigen Werte eingetragen werden. Heißen die Datenbank db, der darauf zugreifende MySQL-Nutzer user mit dem Passwort pass, muß in der Datei folgendes eingetragen sein:

	define('DB_TYPE', "mysql");
	define('DB_HOST', "localhost");
	define('DB_USER', "user");
	define('DB_NAME', "db");
	define('DB_PASS', "pass");

('DB_HOST' bleibt unverändert). Bei 'SELF_URL_PATH' muß die URL eingetragen werden, unter der der Feedreader aufgerufen wird. Das sind z.B. http://192.168.178.56/ttrss (hier hat die DiskStation die Adresse 192.168.178.56) oder http://subdomain.dnsdyn.co.uk/ttrss. Für Erreichbarkeit von ausserhalb des eigenen Netzwerks siehe hier.

Updating Feeds

Tiny Tiny RSS sollte jetzt per Browser erreichbar sein. Damit es installierte Feeds abfragen kann, muß entweder ein mitgelieferter Update daemon gestartet oder ein cronjob eingetragen werden. Empfohlen (und auch machbar) ist die Methode mit dem daemon.

daemon

Hier ist auf der Shell der folgende Befehl auszuführen:

$ su -m nobody -c "(trap '' SIGHUP SIGINT SIGQUIT && /usr/bin/php /var/services/web/ttrss/update.php -daemon > /dev/null 2>&1) &"

Da das nach jedem Neustart der DS ausgeführt werden muß, bietet sich ein Start-Stop-Skript an. Hierbei gibt es die kleine Schwierigkeit, daß der Nutzer nobody beim Booten keine Befehle ausführen kann, weshalb ein kleiner Umweg nötig ist (wer mehr weiß, sagt Bescheid). Das Skript setzt voraus, daß Tiny Tiny RSS in /var/services/web/ttrss/ installiert wurde. Es sollte in den Ordner /usr/local/etc/rc.d/ geschoben und mit chmod 755 ausführbar gemacht werden.

#!/bin/sh
#
# starts "Tiny Tiny Rss"ses update daemon
# put it into /usr/local/etc/rc.d/
# chmod 755 on it

getPID ()
{
	ps|grep "/usr/bin/php /var/services/web/ttrss/update.php -daemon"|grep -v grep|awk '{print $1}'
	return $?
}

start_daemon () {
	su -m nobody -c "(trap '' SIGHUP SIGINT SIGQUIT && /usr/bin/php /var/services/web/ttrss/update.php -daemon >> /dev/null 2>&1) &"
	return $?
} 

cronLine="*	*	*	*	*	root	"`realpath $0`" cron"

case $1 in
start)
	start_daemon
#su -m nobody -c "echo nobody start -ende >> /var/log/ttrss.log" >> /var/log/ttrss.log
	stat=`getPID`
	if [ -z "$stat" ]; then
		echo "$cronLine" >> /etc/crontab
		/usr/syno/etc/rc.d/S04crond.sh stop
		/usr/syno/etc/rc.d/S04crond.sh start
	fi
	;;
stop)
	kill `getPID`
	;;
cron)
	stat=`getPID`
	if [ -z "$stat" ]; then
		start_daemon
	fi
	sed -i -e "\\%$cronLine% d" /etc/crontab
	/usr/syno/etc/rc.d/S04crond.sh stop
	/usr/syno/etc/rc.d/S04crond.sh start
	;;
*)
	echo "Wrong argument. Usage: $0 start|stop"
	;;
esac

cron

Im cronjob muß der Befehl

su -m nobody -c "cd /var/services/web/ttrss && /usr/bin/php /var/services/web/ttrss/update.php -feeds >/dev/null 2>&1"

ausgeführt werden. Für eine Periode von 20 Minuten wäre das Cron-Präfix

*/20	*	*	*	*

einzutragen. Details über Cron sind hier beschrieben.