Installationsanleitung Liferay mit Tomcat auf Windows
Heutzutage ist der schnelle Zugang zu Informationen sehr wichtig, alles muss schnellst möglich gehen. Ein Portal wie das OpenSource Projekt Liferay ermöglicht es sehr gut, sich seine wichtigen Apps zentral an einer Stelle zu sammeln. Natürlich gehören dazu auch Anträge und Aufgaben- / Statuslisten, also Workflowkomponenten oder Neudeutsch BPM. In einer Folge von Artikel werden wir beschreiben, wie aus Liferay und dem Imixs Workflow eine schnelle und effiziente Plattform für Geschäftsprozess Management gebaut werden kann. Im ersten Teil beschreiben wir die Installation von Liferay im Bundle mit Tomcat auf einem Windowsrechner. Zusätzlich ändern wir den Port und binden MySQL als Datenbank an.
Liferay lässt sich auch in bestehende Applikationsserver einbinden, einfacher ist es jedoch, sich Liferay im Bundle von www.liferay.com herunter zu laden. Das zip-File an eine geeignete Stelle entpacken, z.B. C:\liferay.
Bevor wir nun starten, überprüfen wir, ob das notwendige JDK vorhanden ist. In der Konsole java -version eingeben. Kommt dann eine entsprechende Meldung über das installierte Java, ist man schon auf der sicheren Seite. Liferay 5.x benötigt mindestens jre 1.5.x, besser jedoch ist 1.6.x. Sollte jedoch keine Meldung über Java kommen, so muss man sich das letzte JDK von http://java.sun.com herunterladen, einfach nach "Java SE" suchen. Dieses entsprechend der Anleitung installieren. Liferay kann zumindest mit Tomcat mit dem kleineren JRE laufen, ich würde aber schon das JDK installieren.
Es sollten auch, je nachdem ob JRE oder JDK installiert wurde, die Umgebungsvariablen JRE_HOME bzw. JAVA_HOME gesetzt sein. Um zu überprüfen, ob es diese schon gibt, gibt man in der Konsole folgendes ein:
echo %JRE_HOME%
echo %JAVA_HOME%
Als Output sollte dann etwas ähnliches wie "C:\java\jdk1.6.0_18" kommen, nämlich der Pfad zum Verzeichnis vom JDK.
Kommt nichts als Antwort, müssen wir die Variable einrichten. Dazu gehen wir unter XP über Start/Systemsteuerung/System auf den Reiter "Erweitert". Dort ist unten links eine Schaltfläche "Umgebungsvariablen". Mit "Neu" geben wir dann den Namen "JAVA_HOME" (die Schreibweise ist unter Windows unwichtig, ich würde es aber auf Großbuchstaben belassen) und den Pfad auf das Verzeichnis (nicht etwa den bin Ordner!) vom installierten JDK an, also z.B. C:\JDK\jdk1.6.0_1.
Damit die ausführbaren Dateien vom System gefunden werden, erweitern wir in diesem Menue auch gleich noch die Pfadvariable. Dazu die Systemvariable Path auswählen und auf Bearbeiten klicken. Am Ende der Werte fügen wir nun den Link auf den bin Ordner des JDKs an, gefolgt von einem Strichpunkt:
C:\Programme\Java\jdk1.5.0_12\bin;
Letztendlich alle Menues mit OK zumachen. Die Änderungen sind sofort wirksam, aber als nun fast Jahrzehnte langer Nutzer von Microsoft beruhigt ein Reboot die Nerven doch.
Wir könnten nun Liferay inklusive Tomcat starten, ändern jedoch vorher noch den Port, auf dem das Portal erreichbar ist und richten die MySQL Datenbank ein.
Die Portänderung ist relativ einfach. Dazu öffnet man die Datei server.xml im conf Ordner des vorhin entpackten tomcats(z.B. C:\liferay\liferay-portal-6.0.3\tomcat-6.0.26\conf) mit dem Editor seines Vertrauens Notepad++. An der Stelle
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />
ändert man den Wert von Port, z.B.auf port="8280", speichert und schliesst die Datei.
MySQL
Man kann die gewünschte Datenbank manuell oder per Script von Liferay einrichten. Ich bevorzuge die Scriptvariante. Man kann bei Liferay zwei Varianten an Scripten zu MySQL herunterladen (derzeit unter Download/Additional Files), create-minimal-mysql.sql erzeugt die minimal notwendigsten Einträge, create-mysql.sql erzeugt auch noch Beispiele dazu. Beide Scripte löschen vor der Einrichtung eventuell schon bestehende Datenbanken mit dem Namen lportal.
Das Script ruft man als root in der MySQL-Konsole wie folgt auf:
source C:\\liferay\\create-minimal-mysql.sql
Nun legt man noch den User für das Portalmit Hilfe des MySQL Adminitrator an und gibt ihm auf der Datenbank die entprechenden Rechte.
Lifray muss nun noch wissen, dass es MySQL als Datenbank verwenden muss. Dazu erstellt man (ab Version 5.2+) im Verzeichnis C:\liferay\liferay-portal-6.0.3\tomcat-6.0.26\webapps\ROOT\WEB-INF\classes die Datei portal-ext.properties und schreibt das folgende hinein:
jdbc.default.driverClassName=com.mysql.jdbc.Driver
jdbc.default.url=jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
jdbc.default.username=meinUsername
jdbc.default.password=UsersPasswort
In dieser Datei können auch andere Default Konfigurationen überschrieben werden, so z.B. die Mailsession.
Start von Liferay
Nun können wir das Portal starten. Sollte auf dem Rechner ein Virenscanner sein, so sollte man den Scriptdateien im Verzeichnis C:\liferay\liferay-portal-6.0.3\tomcat-6.0.26\bin und der Datei java.exe im Verzeichnis C:\liferay\liferay-portal-6.0.3\tomcat-6.0.26\jre1.5.0_22\win\bin im Virenscanner erlauben, aufgerufen zu werden. Andernfalls kann es dazu kommen, dass Liferay nicht startet, sondern dass nur die Konsole aufgeht und gleich wieder schliesst und nichts passiert.
Das Portal startet man, in dem man die Datei startup.bat im Verzeichnis C:\liferay\liferay-portal-6.0.3\tomcat-6.0.26\bin startet (doppelklicken). Es startet nun der Tomcat, der wiederum Liferay automatisch deployed, was danach automatisch den Standardbrowser mit dem Portal öffnet.
Wichtige Links:
http://www.liferay.com/documentation/liferay-portal/5.2
Posted at 04:42PM Jul 23, 2010
Posted by: wubbel
Category: General
Gesendet von Stefan am Juli 30, 2010 at 11:18 PM MESZ #
Gesendet von wubbel am August 02, 2010 at 11:40 AM MESZ #