Letodms

Aus


Einrichtung eines Dokumenten-Management-Systems (letoDMS)

Diese Seite befindet sich in der Erstellung!
Also bitte nicht verwenden, bis dieser Hinweis verschwunden ist! Danke.




Im Artikel ist immer von der Diskstation die Rede. Natürlich müsste diese Anleitung auch mit Rackstations etc. funktionieren :-)

Getestet mit DSM-4.0 auf DS-111 und DSM-4.1 111 und 212+ ubd DSM 4.2-Beta auf DS109. Hinweise zu Unterschieden stehen unten

Was ist ein Dokumenten-Managment-System?

Da verweise ich auf Wikipedia

Auf der Diskstation lässt sich so ein System nur einrichten, wenn es mit den vorhandenen Möglichkeiten lauffähig ist. Einen eigenen Server (wie z.b. mit java) ist keine so gute Idee, das auf einer DS zu installieren. Mit vorhandenen Möglichkeiten meine ich z.B. den Apache, php und mysql aber auch die Möglichkeiten, die das IPKG-System bietet. Dazu unten mehr.

Vorbereitungen

Je nachdem was man als Ziel hat, braucht man aus dem IPKG ein kleines Zusatzprogramm (pdftotext), das für die Volltextindizierung benötigt wird. Allerdings kann das Programm auch direkt verwendet werden, dann ist es allerdings eine kleine Bastelei, aber man braucht keinen Bootstrap einzurichten!

Wenn man seine Dokumente rein nach Stichworten, Dateinamen und Kategorien etc. sortieren will, braucht man kein IPKG installieren!

Sehr wohl ist aber der SSH-Zugang zu aktivieren und man sollte wissen, wie man auf der Konsole eine Datei editiert.

Wenn du das nicht kannst, dann ist das vielleicht zu viel für dich :-)

Ich empfehle nun einen virtuellen Host anzulegen: In beide Eingabefelder wird nach einem Klick auf Erstellen letodms eingegeben. Das bewirkt, dass wir unter http://name-oder-IP-der-DS/ immer nur auf das Admin-Interface geleitet werden. Wenn wir aber http://name-oder-IP-der-DS/letodms eingeben, so kommen wir in das Verzeichnis /volume1/web/letodms und darin wird dann später auch alles eingerichtet.

WebstationVhost.png

  • PHP - Einstellungen

Immer noch im selben Fenster muss bei den PHP-Einstellungen der Haken bei safe_mode_exec_dir entfernt werden, wenn die oben angesprochene Volltextindizierung gewünscht wird! Wer das nicht braucht, überspringt diesen Schritt.

register_globals sollte immer aus sein und ob der PHP-Cache an ist oder nicht ist (glaube ich) egal. Die Fehlermeldungen kann man sich mal anzeigen lassen, aber besser ist es wenn nicht :-)

Php safe mode exec dir.png

Jetzt den Dialog mit Übernehmen schließen.

Konfiguration der DS

MYSQL-Datenbank einrichten

Da gibt es hier im Wiki Artikel, die dies beschreiben (verlinken!) Entweder man erstellt auf der Konsole eine neue Datenbank, oder man installiert sich das phpmyadmin-Paket aus den Paketquellen von Synology. Standardmäßig wird man sich in phpmyadmin mit dem Benutzer root und KEINEM Passwort anmelden. Unter dem Menüpunkt Benutzer erstellt einen neuen Benutzer, wählt aus, dass auch eine gleich lautende Datenbank erstellt werden soll und vergibt ein Passwort und kann danach phpmyadmin wieder löschen, wenn man es sonst nicht benötigt.


PHP include-Pfad einstellen

Nun muss auf der Konsole mit root-Rechten folgende Datei angepasst werden: /usr/syno/etc/php/user-settings.ini Sie sieht in etwa so aus:

open_basedir = /etc.defaults:/usr/bin/php:/usr/syno/synoman:/etc:/var/run:/tmp:/var/spool/php:/vol
register_globals = Off
apc.enabled = 1
display_errors= On
safe_mode_exec_dir =

Die Zeile

include_path = 

muss nun angepasst werden bzw wir müssen diesen Pfad verwenden (wenn keine Änderungen erwünscht sind)

Bei einem Test mit DSM 4.2 -Beta muss die Zeile hinzugefügt werden. Sie steht noch nicht drin!

include_path = ".:/volume1/gewünschter/pfad/eintragen/"

Dadurch wird der Standart-Pfad .:/usr/syno/php/lib/php überschrieben, den es bei mir aber nicht gibt !

Das .: davor ist extrem wichtig.

Ich habe mir einen include-Ordner in web erstellt, in den ich alle Dateien, die nicht letoDMS sind, reinkopieren werde. Also steht bei mir

include_path = ".:volume1/web/include/"

data-Ordner erstellen

Wenn wir schon beim Ordner erstellen sind, so können wir gleich noch einen data-Ordner erstellen. In dem data-Ordner kommt noch ein staging und ein lucene - Ordner. Die werden später von letoDMS abgefragt, wo sie sind. Die Antwort muss dann also lauten /volume1/web/data, oder eben volume1/web/data/lucene bzw staging.

Pakete downloaden

Es gibt 3 Wege:

Download via wget auf der Konsole der Diskstation

Dann kann man mit

cd /volume1/web/letodms

schon in das richtige Verzeichnis wechseln. Dort gibt man dann ein

wget http://downloadlink

und den Downloadlink, den man vom Browser kopiert hat per Maustaste(bei putty z.B. ist es einfach die rechte Maustaste) oder kopieren und einfügen.

Download per Download Station

Download-Station Einrichten Dann können die Links unten als Downloads hinzufügen und als Download-Ziel schon der web/letodms-Ordner angegeben werden.

Download per PC

Das ist natürlich auch eine Möglichkeit und nach dem Download müssen alle Archive (ja, aber besser NICHT entpacken) auf die Diskstation kopiert werden.

Folgende Dateien werden benötigt:

  • ADODB

http://sourceforge.net/projects/adodb/files Es kann ruhig die aktuellste Version für PHP5 only genommen werden.

  • Zend-Framework

hier bitte das minimal von Zend1 nehmen. Zend2 funktioniert nicht!

http://framework.zend.com/downloads/latest

Auf der Seite nach unten scrollen dort gibt es einen Download ohne Registrierung! z.B. Zend Framework 1.12.1 Minimal als tar.gz herunterladen.

  • letoDMS

Alle Pakete von der Projekt-Seite herunterladen. http://sourceforge.net/projects/mydms/files/LetoDMS/ Nehmt die aktuellste Version und dann müsste es 3 verschiedene Pakete geben. Ihr braucht alle!


  • PEAR

kann natürlich (falls vorhanden) per IPKG installiert werden (ipkg install pear). Meine Empfehlung ist es aber, es eigenständig zu installieren. Es muss dann natürlich auch weiterhin selber aktualisiert werden!

http://pear.php.net/package/PEAR/download rechts die Datei (1.9.4 for manual installation only) auswählen.

  • PEAR-Pakete Log und HTTP_WebDAV_Server

ebenso auf der selben Seite: http://pear.php.net/package/Log/download bzw. http://pear.php.net/package/HTTP_WebDAV_Server/download Als ich dies hier erstelle, war die RC8 ziemlich leer, ich musste also die hier nehmen: http://download.pear.php.net/package/HTTP_WebDAV_Server-1.0.0RC7.tgz

Pakete entpacken

Jetzt müsste in dem Download-Verzeichnis folgende-Dateien vorhanden sein:

Dateiliste vor entpacken.png

Ich habe auf dem Bild das Zend-Framework in der Version 1 und 2 herunter geladen, um zu testen, welches benötigt wird. Es funktioniert nur mit Zend-Framework 1 !

Erstmal entpacken wir alle Archive, so dass wir jetzt jede Menge Ordner und viele Dateien haben :-) Das geht z.B. am einfachsten, wenn man alle Dateien auswählt und Extrahieren --> Jedes Archiv in einen separaten Ordner extrahieren auswählt.

Dateien entpacken.png

Ich hatte beim entpacken von adodb5.tgz Probleme, und musste dieses zuerst mit Extrahieren --> Extrahieren... anzeigen lassen und dort die tar-Datei einzeln extrahieren. Diese konnte ich dann wie gewünscht entpacken.

Es müsste nun in dem /volume1/web/letodms-Ordner in etwa so aussehen:

Dateiliste entpackt.png

Kopieren ins Web-Verzeichnis

Wichtig ist hierbei das genaue einhalten der folgenden Pfade. Natürlich kann das jeder anders machen, aber bestimmte Dateien werden nur an bestimmten Stellen gesucht und zumindest so ist es mir gelungen, dass alle läuft. Andere Vorschläge sind natürlich immer gerne willkommen. Er wird z.B: auch gehen, alle Dateien in einen letodms-Ordner zu kopieren, wo sie von letodms dann gefunden werden. Das machst die ganze Geschichte aber sehr unübersichtlich, finde ich.

  • ADODB

AdoDB is included as 'adodb/adodb.inc.php'. Also muss der Ordner adodb5 umbenannt werden (das 5 weg :-) und in den include-Ordner kopiert werden (bzw. in den include-Pfad)

  • PEAR

In dem Ordner PEAR-1.9.4 gibt es nochmal diesen Ordner und 2 package.xml Dateien. In diesem 2. PEAR-1.9.4 Ordner befinden sich u.a. die Dateien PEAR.php und PEAR5.php. Der Inhalt dieses Ordners (achtung, es gibt in diesem Ordner nochmal einen PEAR Unterordner, darin befinden sich aber NICHT die Dateien PEAR.php und PEAR5.php!) wird ebenso in das include-Verzeichnis kopiert.

Es ist richtig, wenn in unserem include-Ordner jetzt die Ordner

  • adodb
  • OS
  • PEAR
  • scripts

und die Dateien

  • PEAR.php
  • PEAR5.php
  • System.php
  • und ein paar andere (README, INSTALL, LICENSE...)

sind.

  • Zend-Framework

im Ordner ZendFramework-1.x.-minimal gibt es nochmal den selben Ordner(je nachdem, wie die Archive entpackt wurden). Darin den Ordner library. Darin wieder einen Ordner Zend. Diesen kopieren wir auch in das include-Verzeichnis, dass er genau an der selben Stelle ist, wie die obige Auflistung.

Dateiliste bis Zend.png


  • letoDMS-Core
ist ein PEAR-package
  • letoDMS-Lucene(Optional)
ist ebenso ein PEAR-package
  • PEAR-Pakete Log und ... HTTP_WebDAV_Server (Optional)

In dem Ordner HTTP_webDAV-Server... gibt es nochmal so einen Ordner. Den Inhalt des 2. Ordners HTTP_WebDAV_Server... (es muss u.a. die Datei file.php und der Ordner HTTP direkt sichtbar sein) kopieren wir wieder in den include-Ordner. Die Datei file.php muss sich jetzt in /volume1/web/include/file.php befinden und der Ordner HTTP dann unter /volume1/web/include/hHTTP , nur dann wird es vom Install-Skript später richtig erkannt.

Ressourcen

  • Zum Überprüfen der Servereinstellungen empfielt es sich während der Einrichtung eine info.php zu machen mit
<?php
phpinfo ();
?>

--Atarifreak 23:33, 28. Okt. 2012 (CET)