Installationsanleitung Lecture2Go Mediendistributionsportal

Transkript

1 Installatinsanleitung Lecture2G Mediendistributinsprtal 1. Systemvraussetzungen 2 2. Datenbankserver 2 3. Prtalserver 3 4. Streamingserver Verknüpfen vm Wwza mit Lecture2G 7 5. Dwnladserver 9 1

2 1. Systemvraussetzungen Im Flgenden wird eine Beispielinstallatin aufgeführt. Eine ähnliche Implementierung hat sich seit 2010 an der Universität Hamburg bewährt. Webserver Betriebssystem SUSE 11 (x86_64) CPU 16 x Intel(R) Xen(R) 2.67 GHz Physikalischer Arbeitsspeicher (RAM) 8 GB Festplattenkapazität 500 GB Streamingserver Betriebssystem SUSE 11 (x86_64) CPU 8 x Intel(R) Xen(R) 2.66 GHz Physikalischer Arbeitsspeicher (RAM) 8 GB Festplattenkapazität 4 TB. Mit dieser Speicherkapazität kann eine grße Menge vn Vides gehstet werden. Sll eine neunzigminütige Vrlesungsaufzeichnung die Datenmenge vn 600 MB nicht übersteigen, s würden 4 TB Speicher für ca Vides ausreichen. LAN 1Gb. Mit dieser Bandbreite und durchschnittlicher Bit- Übertragungsrate vn 500 Kb/sec lassen sich ca simultane Streams realisieren. Dwnladserver Betriebssystem SUSE 11 (x86_64) CPU 16 x Intel(R) Xen(R) 2.67 GHz Physikalischer Arbeitsspeicher (RAM) 8 GB Festplattenkapazität 500 GB Netzwerkkarte 1 Gb 2. Datenbankserver Als Datenbank für die Installatin sll MySQL eingesetzt werden. An dieser Stelle wird keine Installatinsanleitung für MySQL angebten. Auf der ffiziellen Internetseite vn MySQL swie auf zahlreichen Webseiten können Sie sehr gute Installatinsanleitungen zum Thema finden. Nachdem der Server installiert wurde, erstellen Sie ein Benutzerknt, mit dessen Lgin-Daten auf MySQL zugegriffen werden kann. Im Abschnitt 3 werden diese Zugangsdaten, Lgin-Name (dbuser) und das zugehörige Passwrt (dbpasswrd), benötigt. Für die Administratin vn MySQL-Datenbankservern eignen sich verschiedene Tls. Wir empfehlen die ffiziellen MySQL-Administratinswerkzeuge, die auf der Sftwareherstellerwebseite zu finden sind. 2

3 3. Prtalserver Für diese Installatin müssen Sie sich als Rt einlggen. Erstellen Sie das Verzeichnis /usr/lcal/l2g (chmd 755 /usr/lcal/l2g für Mac) und entpacken Sie anschließend die heruntergeladene Datei prtal ce-ga2-master.zip drthin. Benennen Sie das entpackte Verzeichnis in prtal ce-ga2 um. Durch das Entpacken entsteht flgender Dateipfad /usr/lcal/l2g/prtal ce-ga2/. In diesem Verzeichnis befindet sich die Datei install.sql. Diese sql-datei beinhaltet alle ntwendigen Tabellen und Einstellungen für die Integratin der Lecture2G-Plugins in Liferay. Imprtieren Sie die Datei install.sql in den installierten MySQL-Datenbankserver (Abschnitt 2). Anschließend kann die Prtalsftware für die Installatin vrbereitet werden. Führen Sie flgende Schritte durch und bearbeiten Sie die Knfiguratinsdateien prtalsetup-wizard.prperties mit einem beliebigen Editr: yur-lecture2g-server:~ # cd /usr/lcal/l2g/prtal ce-ga2/ yur-lecture2g-server:/.../prtal ce-ga2/ # je prtal-setup-wizard.prperties Hier tragen Sie das Installatinsverzeichnis wie flgt ein: liferay.hme=/usr/lcal/l2g/prtal ce-ga2 Als Nächstes bearbeiten Sie die Datei prtal-ext.prperties - ebenfalls mit einem beliebigen Editr: yur-lecture2g-server:~ # cd /usr/lcal/l2g/prtal ce-ga2/tmcat /webapps/ yur-lecture2g-server:/.../webapps/ # je ROOT/WEB-INF/classes/prtal-ext.prperties Knfigurieren Sie den Datenbankzugriff, indem Sie die flgende Zeilen im Bereich "Database Prperties" anpassen: ############ Database Prperties ############ jdbc.default.driverclassname=cm.mysql.jdbc.driver jdbc.default.url=jdbc:mysql://mysql.server.cm/lprtal?useunicde=true&characterencding=u TF-8&useFastDateParsing=false jdbc.default.username=dbuser jdbc.default.passwrd=dbpasswrd jdbc.default.url Ersetzen Sie bitte diesen String "mysql.server.cm" innerhalb dieser Zeile mit der URL Ihres Datenbankservers. jdbc.default.username Hier Benutzernamen eingeben. jdbc.default.passwrd Hier Datenbankpasswrt eingeben. Im Bereich "Lecture2G Prperties" passen Sie die flgenden Parameter an: ############ Lecture2G Prperties ############ lecture2g.web.rt= lecture2g.web.hme=${lecture2g.web.rt} 3

4 lecture2g.dwnladserver.rt= lecture2g.media.repsitry=/l2gmedia lecture2g.images.system.path=${lecture2g.media.repsitry}/images lecture2g.httpstreaming.vide.repsitry=${lecture2g.media.repsitry}/vh_000 lecture2g.security.flder=/security lecture2g.ffmpeg.bin=/usr/lcal/bin/ffmpeg lecture2g.shell.bin=/bin/bash Die wichtigsten Einstellungen für die Installatin der Lecture2G-Plugins sind mit dem Präfix lecture2g.* versehen. lecture2g.web.rt Hier geben Sie bitte die Webadresse des Lecture2G- Servers (ggf. Prt z.b. ein. lecture2g.web.hme Dieses Parameter muss nicht geändert werden. lecture2g.dwnladserver.rt Wir empfehlen für eine Lastverteilung einen separaten Dwnladserver einzusetzen. Bitte hier die URL-Adresse des Servers eingeben. Alternativ kann der Prtalserver als Dwnladserver betrieben werden (lecture2g.dwnladserver.rt=${lecture2g.web.rt}). lecture2g.media.repsitry Geben Sie hier den Systempfad ein, unter dem die Videinhalte nach dem Uplad gespeichert werden sllen. Der Default- Parameter ist /l2gmedia. lecture2g.respnse. .address Adresse des Systemadministratrs lecture2g.nrespnse. .address Autrespnder Adresse Die nachflgenden Parameter sllen nicht verändert werden! lecture2g.images.system.path Hier werden alle erzeugten Bilder gespeichert. lecture2g.httpstreaming.vide.repsitry Das ist ein sehr wichtiges Verzeichnis, da der Streamingserver darauf zugreift, um die Medieninhalte via HTTP-Streaming zu liefern. lecture2g.security.flder Speicherrt für alle Htaccess-Schutzdateien. Um die letzten zwei Parameter einzutragen, führen Sie flgende Befehle aus und tragen Sie die Antwrten wie flgt bei den "Lecture2G Prperties" ein yur-lecture2g-server:~ # which ffmpeg /usr/lcal/bin/ffmpeg lecture2g.ffmpeg.bin - /usr/lcal/bin/ffmpeg yur-lecture2g-server:~ # which bash /bin/bash lecture2g.shell.bin - /bin/bash Falls auf Ihrem Linux-System die FFMPEG Biblithek nch nicht vrhanden ist, müssen Sie diese nachinstallieren ( Nachdem die Knfiguratinsdatei mit den ntwendigen Parametern betankt wurde und der MySQL- 4

5 Server erreichbar ist, fahren Sie das Prtal hch. Nach der Änderung der Eigenschaften gehen Sie wie flgt vr: yur-lecture2g-server:~ # cd /usr/lcal/l2g/prtal ce-ga2/tmcat /bin/ yur-lecture2g-server:/usr/lcal/l2g/prtal ce-ga2/tmcat /bin # chmd 755 * yur-lecture2g-server:/usr/lcal/l2g/prtal ce-ga2/tmcat /bin #./startup.sh Vrausgesetzt Sie haben alle erfrderlichen Vrbereitungen getrffen, wird die Prtalsftware erflgreich gestartet. Die Serverlgs findet man unter /usr/lcal/l2g/prtal ce-ga2/tmcat /lgs. Hier sll der Startvrgang mit einer ähnlichen Lgausgabe abschließen: yur-lecture2g-server:~ # tail -f /usr/lcal/l2g/prtal ce-ga2/tmcat /lgs/catalina.ut INFO: Starting Cyte HTTP/1.1 n http-80 Jul 25, :46:01 PM rg.apache.jk.cmmn.channelscket init INFO: JK: ajp13 listening n / :8009 Jul 25, :46:01 PM rg.apache.jk.server.jkmain start INFO: Jk running ID=0 time=0/177 cnfig=null Jul 25, :46:03 PM rg.apache.catalina.startup.catalina start INFO: Server startup in ms 12:46:49,528 INFO [PluginPackageUtil:1148] Relading repsitries Nun müssen einige Knfiguratinen im Lecture2G-Prtal vrgenmmen werden. Dafür rufen Sie lkal auf dem Server einen Webbrwser auf: yur-lecture2g-server:~ # firefx lcalhst Lggen Sie sich unter dem Menüpunkt Anmelden" (ben rechts unter dem Lecture2G-Lg) als Superuser ein. Die Lgin-Daten sind: admin@l2g.edu Passwrd: test 5

6 Nach dem Lgin klicken Sie das "Kntrllbereich" (ben rechts unter dem Lecture2G-Lg) an und wählen Sie drt das Hauptmenü "Lecture2G" -> "Website-Einstellungen" -> "Webseite URL" aus. Tragen Sie drt in das Feld "Öffentliche Seiten" den Dmainnamen Ihrer Lecture2G-Installatin ein (meine-unidmain.de). Eine weitere Knfiguratin muss im Hauptmenü "Prtal" -> "Einstellungen" vrgenmmen werden. Tragen Sie drt die einzelnen Parameter ein, wie auf dem nachflgendem Bild gezeigt. Name: my-uni-dmain.cm - Hier ist der Dmainname der Lecture2G- Webseite (bere Instanz) einzutragen. Virtual Hst: lcalhst - Dieses Parameter kann unverändert bleiben. In der Regel wird hier der Dmainname eingetragen, der auch für die Netzwerkknfiguratin verwendet wird. Wenn dieser Dmainname aufgerufen wird, leitet Liferay die Anfrage zu der beren Instanz um. Output URL: /web/vd - Definiert den Startpunkt der Seitenstruktur. Wenn man z.b. die URL aufrufen würde, würde man zu der Startseite gelangen, die in der Seitenhierarchie an berster Stelle steht. Mail Dmain: meine-unimail-dmain.de - Liferay verwendet diese dmain, um Nachrichten vm Prtal aus zu versenden. 6

7 Nachdem Sie diese Knfiguratinen durchgeführt haben, kann die neue Prtalinstallatin vn Lecture2G unter der Web Adresse erreicht werden. 4. Streamingserver Der Streamingserver ist eine sehr wichtige Kmpnente. Erst mit einer laufenden Implementierung des Streamingservers sind die schönsten" Lecture2G-Prtal- Features (Kapitelmarken, manuelle Segmentierung durch Prduzenten der Studierende) zu genießen. An dieser Stelle ist es wichtig zu erwähnen, dass der Server für eine bessere Lastverteilung auf einer separaten Maschine installiert werden sllte. Die Streaming-Sftware Wwza Server ist sehr leistungsfähig. Unserer Erfahrung nach ist eine Lizenz ausreichend, um eine Universität vn der Größe der Universität Hamburg zu bedienen. Im Flgenden wird eine Kurzanleitung zur Installatin gegeben. Für weiterführende technische Infrmatinen und Knfiguratinsmöglichkeiten wird an dieser Stelle auf die ffizielle Dkumentatin des Sftwareherstellers verwiesen. Laden Sie zuerst die aktuelle Wwza Server-Versin herunter: yur-lecture2g-streamer:~ # wget tar Führen Sie flgende Befehle aus: yur-lecture2g-streamer:~ # sud chmd +x WwzaStreamingEngine tar.bin yur-lecture2g-streamer:~ # sud./wwzastreamingengine tar.bin Nach erflgreicher Installatin muss der Lizenzschlüssel eingetragen werden. In der ersten Zeit können Sie eine kstenlse Lizenz vn Wwza bekmmen und die Sftware testen. Nachdem die Sftware registriert wurde, können Sie mit der Knfiguratin frtfahren (Abschnitt 4.1) Verknüpfen vm Wwza mit Lecture2G In diesem Abschnitt geht es um die Verknüpfung der Lecture2G-Medien-Repsitry (Speicherrt aller Mediendateien) mit dem Streaming-Server. Damit die hchgeladenen Videinhalte auf dem Lecture2G-Prtal vm Streaming- Server gefunden werden können, müssen einige Einstellungen im Verzeichnis /usr/lcal/wwzastreamingengine/cnf vrgenmmen werden. 7

8 VHst.xml An dieser Stelle knfigurieren Sie die Prtnummer des Servers. Da der Server über das HTTP-Prtkll erreichbar sein muss, ändern Sie die Prtnummer auf 80 (ca. Zeile 10). <!-- 80: HTTP, RTMPT --> <!-- 554: RTSP --> <Prt>80</Prt> Applicatin.xml In dieser Datei wird die Medien-Repsitry knfiguriert, auf die der Server zugreift. <Streams> <StreamType>default</StreamType> <StrageDir>${cm.wwza.wms.cntext.VHstCnfigHme}/cntent</StrageDir> In dem Knten <StrageDir></StrageDir> wird die Medien-Repsitry des Servers festgelegt. Der Default-Wert wird nicht verändert und einfach das Verzeichnis ${cm.wwza.wms.cntext.vhstcnfighme}/cntent mit einem symblischen Link ersetzt, der auf die Lecture2G Medien-Repsitry verweist. Im Abschnitt 3 wurde bereits in der Datei prtal-ext.prperties das Parameter lecture2g.httpstreaming.vide.repsitry festgelegt. Der Wert dieses Parameters /l2gmedia/vh_000/ ist die zentrale Lecture2G Medien-Repsitry und wird nun bei der Verknüpfung mit dem Streaming-Server benötigt. Hierfür bitte flgende Befehle ausführen: yur-lecture2g-streamer:~ # cd /usr/lcal/wwzastreamingengine yur-lecture2g-streamer:/usr/lcal/wwzastreamingengine # rm r cntent yur-lecture2g-streamer:/usr/lcal/wwzastreamingengine # ln -s /l2gmedia/vh_000/ cntent Als letzter Schritt muss der Server im Lecture2G-Prtal registriert werden! Jeder Einrichtung kann ein Streamingserver zugewiesen werden. Lggen Sie sich als Lecture2G-Administratr ein (admin1@l2g.edu). Im Menü "Mein L2G" -> "Administratin vn Streamern" kann ein neuer Streamingserver eingetragen der ein vrhandener Server bearbeitet werden. 8

9 Ersetzen Sie den vrhandenen Beispiel-Servernamen mit dem Dmainnamen der mit der IP-Adresse ihrer neuen Wwza-Server- Installatin (z.b. Klicken Sie dann auf den Buttn Bearbeiten". Anschließend rufen Sie das Menü Administratin vn Einrichtungen" auf. In der Liste der Einrichtungen kann man sehen, dass der neu eingetragene Streamingserver der Einrichtung Fakultät 1" zugerdnet ist. Alle Medieninhalte, die zu dieser Einrichtung gehören, werden nun mit dem Streaming-Server gestreamt. 5. Dwnladserver Die Medieninhalte landen nach dem Uplad im Verzeichnis /l2gmedia (s.a. Abschnitt 3, ggf. geändertes Verzeichnis). Um diese für den Dwnladserver sichtbar zu machen, muss dieses Verzeichnis z.b. mittels NFS imprtiert und ebenfalls unter /l2gmedia gemuntet werden. Installieren und aktivieren Sie auf Ihrem Linux-System den Tmcat-Webserver. Anschließend muss der Lecture2G-Dwnlad-Servlet in das Webapps-Verzeichnis des Tmcat-Servers des Dwnladservers übertragen werden. Der Servlet befindet sich im Webapps-Verzeichnis des Lecture2G-Prtalservers (s.a. Abschnitt 3). Kpieren Sie das Verzeichnis z.b. mittels des SCP-Befehls: yur-lecture2g-prtalserver:~ # scp -r -P <Prtnummer> /usr/lcal/l2g/prtal cega2/webapps/dwnlad username@yur-lecture2g-dwnladserver:/tmcat-base/webapps/ Um den Servlet für den Datenbankzugriff zu knfigurieren, tragen Sie in der Datei /tmcat-base/webapps/dwnlad/web-inf/web.xml flgende Parameter ein (s.a. nächste Abbildung): vrep = /l2gmedia (falls geändert, bitte entsprechendes Verzeichnis angeben) driverurl = jdbc:mysql://datenbank- server.de/lprtal?useunicde=true&characterencding=utf- 8&useFastDateParsing=false dbusername = DbUsername dbpasswrd = DbServerPasswrd Damit die durchgeführten Knfiguratinen wirksam werden, starten Sie den Tmcat- Server neu. 9

10 Damit der Dwnlad-Servlet auch über Prt 80 erreichbar ist, schalten Sie den Apache2 als Prxy vr die Tmcat-Applikatin vr. Aktivieren Sie, z.b. über YaST, für den Apache2-Server flgende Mdule (Netzwerkdienste HTTP-Server): prxy_ajp prxy_balancer prxy prxy_cnnect prxy_ftp prxy_http In der /etc/apache2/httpd.cnf tragen Sie am Ende der Knfiguratinsdatei die flgende Zeile ein: PrxyPass /dwnlad ajp://lecture2g-dwnlad-server-name.de:8009/dwnlad Starten Sie den Apache2 neu. Im htdcs des Apache2-Servers legen Sie flgende symblische Links an: 10

11 lecture2g-dwnlad-server:~ # cd /srv/www/htdcs lecture2g-dwnlad-server:/srv/www/htdcs # ln -s /l2gmedia/ab/ ab lecture2g-dwnlad-server:/srv/www/htdcs # ln -s /l2gmedia/vh_001/ vh_001 Alle Medien-Dateien, die unterhalb des Verzeichnisses /l2gmedia/vh_001/ gespeichert werden, wären theretisch nach außen sichtbar. Dies bezieht sich aber nur auf Inhalte, die im Lecture2G Vide-Prtal zum Dwnlad freigegeben wurden. Medien, die nicht heruntergeladen werden dürfen, werden per.htaccess geschützt. 11