Extra contents #

Installation of the Liferay 4.3.4 Glassfish Bundle

The bundle consists of one self-executing jar file. By running it, an installation programme will launch (antinstaller.sf.net) and will ask you where to extract the contents to. CAVEAT: this installer only works "as-is" on Windows (only copies bat files to the bin folder, for instance). On Unix-based systems you cannot use the bundle. Try these instructions instead: http://spaquet.blogspot.com/2006/07/liferay-glassfish-part-i-installing.html

To start the server run asadmin start-domain domain1 from the command line in your %GLASSFISH-INSTALL-DIR%\bin directory. The liferay portal is then available at http://localhost:8080 (takes a while for the portal page to appear on the first invocation).

Comments #

(Please keep the following comment format)

Title

Comment text

-- Signature (full name or link to your LiferayPedia page)

GlassFish Out-of-Memory Errors

To avoid out-of-memory errors when launching the GlassFish JAR-based installer, be sure to set the initial and maximum memory heap sizes with the -Xms and -Xmx options on the java command line. For example:

java -Xms512m -Xmx1024 -jar <glassfish_jar>.jar

-- Scott Fordin, Sun Microsystems

Tomcat 5.0/5.5 and MySQL 5

The detailed installation procedure is mostly correct, but some particular comments are necessary:

• After step 8 (downloading the JDBC driver), a Liferay portal user should be created. The sample code below assumes a user named lportal. Grant access to the database. The MySQL command would be something like

 GRANT Select, Insert, Update, Delete, Index, Alter, Create, Drop, References ON *.* TO 'lportal'@'%' IDENTIFIED BY 'xxxxxx';

:Be sure to set the username and password correctly in the ROOT.xml file.

• For step 9: the latest version of MySQL is version 5. If you use this version (recommended), then the driverClassName in ROOT.xml should be "org.gjt.mm.mysql.Driver".
• For step 15: if you are using the service and native install of Tomcat on Windows, you may be using Tomcat5.exe to start the service instead of a catalina.bat file. In that case, you should right click on the Tomcat tray icon, select "Configure", and enter the options under the Java tab, in the "Java Options" field.

NOTE: Be aware that it's recommended to add -XX:MaxPermSize=128m to JAVA_OPTS in order to avoid out of memory errors (see Liferay FAQ#What do I do if I am getting Out of Memory Errors.3F

• For step 17: if your zip utilities do not allow opening .war files, you may rename the file liferay-portal-4.2.0.war to liferay-portal-4.2.0.zip, and extract the file to the ROOT directory.

• Tomcat 5.5.20 is missing a file named mail.jar, so you would get an error whenever an e-mail is generated (e.g., when a new user is created). The error is a Java exception saying that class InternetAccess was not found. If you use version 5.5.20, you may have to move the class mail.jar from webapps/ROOT/WEB-INF/lib/ to common/lib. Version 5.5.17 does not have this problem.
• In tomcat 5.5.13 you have to had activation.jar, mail.jar, jms.jar and jta.jar in $TOMCAT_HOME/common/lib/ext if you want it to start. Otherwise you have ClassNotFound and filter errors.

Luiscolorado|Luiscolorado 12:50, 16 February 2007 (PST)

Errata #

• Documentation warning: The documentation says that the application server properties should be configured after doing the ant build (ant start), but the ant build will fail if the app server properties are not set beforehand. See the "Building and deploying" section at Development Environment (General).

Related LiferayPedia pages #

No content here yet