Download and install Geronimo/Tomcat into your preferred directory. From now on, the directory where you installed Gernonimo will be referred to as GERONIMO_HOME.

Download and install JDK 5 . Set an environment variable called JAVA_HOME to point to your JDK directory.

Download MySQL from www.mysql.com and install.

Download the WAR for the professional edition of Liferay Portal: liferay-portal-4.3.0.war.

Create a database for Liferay. For example:

create database lportal character set utf8;

Liferay will automatically create the tables and populate it the first time it starts.

Edit GERONIMO_HOME\bin\geronimo.bat

insert at line 219:

set JAVA_OPTS=-Xms128m -Xmx512m -Dfile.encoding=UTF8 -Duser.timezone=GMT

Download the Portal 4.3.0 Dependencies.

Point browser to localhost:8080/console to enter Administration Console.

Click Common Libs under Services.

Repeat the last step for each of the libraries in the dependencies ZIP file.

Click Database Pools under Services

Click Deploy New under Applications

Click Web App WARs

Open your browser to http://localhost:8080. Click on My Liferay at the upper right hand corner to enter the login screen. Your login is [email protected] and your password is test.

Download and install JBoss AS into your preferred directory. From now on, the directory where you installed Tomcat will be referred to as $JBOSS_HOME.

Download and install JDK 5 . Set an environment variable called JAVA_HOME to point to your JDK directory.

Download MySQL from www.mysql.com and install.

Download liferay-portal-4.3.0.ear.

Edit $JBOSS_HOME/server/default/conf/jboss-service.xml:

<classpath codebase="${jboss.server.lib.url:lib}/ext" archives="*"/>

Create directory $JBOSS_HOME/directory/server/default/deploy/jbossweb-jetty.sar. Download jetty-5.1.10-jboss-4.0.2.sar and unzip to directory.

Edit $JBOSS_HOME/directory/server/default/deploy/jbossweb-jetty.sar/webdefault.xml:

Replace servlet entry in lines 206 to 222:

<servlet>
    <servlet-name>jsp</servlet-name>
    <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
    <init-param>
        <param-name>logVerbosityLevel</param-name>
        <param-value>DEBUG</param-value>
    </init-param>
    <init-param>
        <param-name>fork</param-name>
        <param-value>false</param-value>
    </init-param>
    <init-param>
        <param-name>xpoweredBy</param-name>
        <param-value>false</param-value>
    </init-param>
    <load-on-startup>0</load-on-startup>
  </servlet>

With:

  <servlet>
    <servlet-name>jsp</servlet-name>
    <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
    <init-param>
        <param-name>logVerbosityLevel</param-name>
        <param-value>DEBUG</param-value>
    </init-param>
    <init-param>
        <param-name>fork</param-name>
        <param-value>false</param-value>
    </init-param>
    <init-param>
        <param-name>scratchdir</param-name>
        <param-value>../server/default/work</param-value>
    </init-param>
    <init-param>
        <param-name>xpoweredBy</param-name>
        <param-value>false</param-value>
    </init-param>
    <load-on-startup>0</load-on-startup>
  </servlet>

Remove $JBOSS_HOME/server/default/deploy/jbossweb-tomcat55.sar.

Remove $JBOSS_HOME/server/default/deploy/management.

Create file $JBOSS_HOME/server/default/deploy/liferay-ds.xml with following content:

<?xml version="1.0"?>

<datasources>
   <local-tx-datasource>
     <jndi-name>jdbc/LiferayPool</jndi-name>
     <connection-url>
         jdbc:mysql://localhost/lportal?useUnicode=true&amp;characterEncoding=UTF-8
     </connection-url>
     <driver-class>com.mysql.jdbc.Driver</driver-class>
     <user-name></user-name>
     <password></password>
     <min-pool-size>0</min-pool-size>
   </local-tx-datasource>
</datasources>

Go to $JBOSS_HOME/server/default/lib/ and create new directory ext. Download mysql-connector-java-{$version}-bin.jar and copy to this directory. (This is the JDBC connector for MySQL, for other databases, go to appropriate website to download.)

Create a database for Liferay. For example:

create database lportal character set utf8;

Liferay will automatically create the tables and populate it the first time it starts.

Download Liferay's Portal 4.3.0 Dependencies.

Set mail properties by replacing the contents of $JBOSS_HOME/server/default/deploy/mail-service.xml with:

<?xml version="1.0"?>

<server>
	<mbean code="org.jboss.mail.MailService" name="jboss:service=MailSession">
		<attribute name="JNDIName">mail/MailSession</attribute>
		<attribute name="User">nobody</attribute>
		<attribute name="Password">password</attribute>
		<attribute name="Configuration">
			<configuration>
				<property name="mail.store.protocol" value="imap" />
				<property name="mail.transport.protocol" value="smtp" />
				<property name="mail.imap.host" value="localhost" />
				<property name="mail.pop3.host" value="localhost" />
				<property name="mail.smtp.host" value="localhost" />
			</configuration>
		</attribute>
	</mbean>
</server>

Configure JAAS. Edit $JBOSS_HOME/server/default/conf/login-config.xml and comment out the entire XML for policy 'other' in lines 140-156.

<!--<application-policy name = "other">-->
    ...
       <!--<authentication>
          <login-module code = "org.jboss.security.auth.spi.UsersRolesLoginModule"
             flag = "required" />
       </authentication>
    </application-policy>-->

Deploy liferay-portal-4.3.0.ear.

Edit $JBOSS_HOME/server/default/deploy/jbossjca-service.xml:

Change Debug attribute in line 63 from true to false:

<attribute name="Debug">false</attribute>

In $JBOSS/server/default/deploy/jbossws14.sar/META-INF/jboss-service.xml

Comment out deployer service for JSE and EJB2.1 endpoints

line 36-40

<!--<mbean name="jboss.ws:service=WebServiceDeployerJSE" code="org.jboss.ws.server.WebServiceDeployerJSE">
      <depends-list optional-attribute-name="Interceptables">
         <depends-list-element>jboss.web:service=WebServer</depends-list-element>
      </depends-list>
   </mbean>-->

lines 45-49

   <!--<mbean name="jboss.ws:service=WebServiceDeployerEJB21" code="org.jboss.ws.server.WebServiceDeployerEJB21">
      <depends-list optional-attribute-name="Interceptables">
         <depends-list-element>jboss.ejb:service=EJBDeployer</depends-list-element>
      </depends-list>
   </mbean>-->

lines 72-75

<!--<mbean name="jboss.ws:service=WebServiceDeployerNestedJSE" code="org.jboss.ws.server.WebServiceDeployerNestedJSE">
      <depends optional-attribute-name="MainDeployer" proxy-type="attribute">jboss.system:service=MainDeployer</depends>
      <depends>jboss.ws:service=WebServiceDeployerJSE</depends>
   </mbean>-->

Edit $JBOSS_HOME/server/default/deploy/jms/jbossmq-destinations-service.xml. Clear out text between server tags:

<?xml version="1.0"?>

<server>
</server>

Start JBoss. Open your browser to http://localhost:8080. Click on My Liferay at the upper right hand corner to enter the login screen. Your login is [email protected] and your password is test.

Download and install JBoss AS into your preferred directory. From now on, the directory where you installed Tomcat will be referred to as $JBOSS_HOME.

Download and install JDK 5 . Set an environment variable called %JAVA_HOME% (in Windows) or $JAVA_HOME (in Linux/UNIX) to point to your JDK directory.

Download MySQL from www.mysql.com and install.

Download liferay-portal-4.3.0.ear.

Edit $JBOSS_HOME/server/default/conf/jboss-service.xml:

<classpath codebase="${jboss.server.lib.url:lib}/ext" archives="*"/>

Delete $JBOSS_HOME/server/default/deploy/jbossweb-tomcat55.sar/ROOT.war.

Edit $JBOSS_HOME/server/default/deploy/jbossweb-tomcat55.sar/conf/web.xml:

replace default servlet (lines 79-91) :

 <servlet>
      <servlet-name>default</servlet-name>
      <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
      <init-param>
         <param-name>debug</param-name>
         <param-value>0</param-value>
      </init-param>
      <init-param>
         <param-name>listings</param-name>
         <param-value>true</param-value>
      </init-param>
      <load-on-startup>1</load-on-startup>
   </servlet>

with:

<servlet>
      <servlet-name>default</servlet-name>
      <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
      <init-param>
         <param-name>debug</param-name>
         <param-value>0</param-value>
      </init-param>
      <init-param>
         <param-name>listings</param-name>
         <param-value>false</param-value>
      </init-param>
      <init-param>
         <param-name>input</param-name>
         <param-value>4096</param-value>
      </init-param>
      <init-param>
         <param-name>output</param-name>
         <param-value>4096</param-value>
      </init-param>
      <load-on-startup>1</load-on-startup>
   </servlet>

Create $JBOSS_HOME/server/default/deploy/liferay-ds.xml with following content:

<datasources>
   <local-tx-datasource>
     <jndi-name>jdbc/LiferayPool</jndi-name>
     <connection-url>
         jdbc:mysql://localhost/lportal?useUnicode=true&amp;characterEncoding=UTF-8
     </connection-url>
     <driver-class>com.mysql.jdbc.Driver</driver-class>
     <user-name></user-name>
     <password></password>
     <min-pool-size>0</min-pool-size>
   </local-tx-datasource>
</datasources>

Go to $JBOSS_HOME/server/default/lib/ and create new directory ext. Download mysql-connector-java-{$version}-bin.jar and copy to this directory. (This is the JDBC connector for MySQL, for other databases, go to appropriate website to download.)

Create a database for Liferay. For example:

create database lportal character set utf8;

Liferay will automatically create the tables and populate it the first time it starts.

Download Liferay 's Portal 4.3.0 Dependencies.

Set mail properties by replacing the contents of $JBOSS_HOME/server/default/deploy/mail-service.xml with:

<?xml version="1.0"?>

<server>
	<mbean code="org.jboss.mail.MailService" name="jboss:service=MailSession">
		<attribute name="JNDIName">mail/MailSession</attribute>
		<attribute name="User">nobody</attribute>
		<attribute name="Password">password</attribute>
		<attribute name="Configuration">
			<configuration>
				<property name="mail.store.protocol" value="imap" />
				<property name="mail.transport.protocol" value="smtp" />
				<property name="mail.imap.host" value="localhost" />
				<property name="mail.pop3.host" value="localhost" />
				<property name="mail.smtp.host" value="localhost" />
			</configuration>
		</attribute>
	</mbean>
</server>

Configure JAAS. Edit $JBOSS_HOME/server/default/conf/login-config.xml and comment out the entire XML for policy other in lines 140-156.

<!--<application-policy name = "other">-->
    ...
       <!--<authentication>
          <login-module code = "org.jboss.security.auth.spi.UsersRolesLoginModule"
             flag = "required" />
       </authentication>
    </application-policy>-->

Deploy liferay-portal-4.3.0.ear.

Edit JBOSS_HOME/server/default/deploy/jbossjca-service.xml:

change Debug attribute in line 63 from true to false:

<attribute name="Debug">false</attribute>

Edit JBOSS_HOME/server/default/deploy/jms/jbossmq-destinations-service.xml. Clear out text between server tags:

<?xml version="1.0"?>

<server>
</server>

Start JBoss. Open your browser to http://localhost:8080. Click on My Liferay at the upper right hand corner to enter the login screen. Your login is [email protected] and your password is test.

Download and install JDK 1.4 or 1.5. Set an environment variable called %JAVA_HOME% (in Windows) or $JAVA_HOME (in Linux/UNIX) to point to your JDK directory.

Download MySQL from www.mysql.com and install.

Download and install Jetty 5.1.10-all.zip. Note: Only this version of Jetty is supported by Liferay. Others may work but will not be covered in this documentation. From now on the home directory where you installed Jetty will be called $JETTY_HOME.

Download liferay-portal-4.3.0.war.

Download Liferay's Portal 4.3.0 Dependencies.

Create a database for Liferay. For example:

create database lportal character set utf8;

Liferay will automatically create the tables and populate it the first time it starts.

Edit $JETTY_HOME/extra/etc/start-plus.config.

$(jetty.home)/lib/ext/
$(jetty.home)/lib/ext/*

Create a data source bound to jdbc/LiferayPool by editing $JETTY_HOME/etc/jetty.xml.

<Call name="addService">
    <Arg>
        <New class="org.mortbay.jetty.plus.JotmService">
            <Set name="Name">TransactionMgr</Set>
            <Call name="addDataSource">
                <Arg>jdbc/LiferayPool</Arg>
                <Arg>
                    <New class="org.enhydra.jdbc.standard.StandardXADataSource">
                        <Set name="DriverName">com.mysql.jdbc.Driver</Set>
                        <Set name="Url">jdbc:mysql://localhost/lportal?useUnicode=true&amp;characterEncoding=UTF-8</Set>
                        <Set name="User"></Set>
                        <Set name="Password"></Set>
                    </New>
                </Arg>
                <Arg>
                    <New class="org.enhydra.jdbc.pool.StandardXAPoolDataSource">
                        <Arg type="Integer">4</Arg>
                        <Set name="MinSize">4</Set>
                        <Set name="MaxSize">15</Set>
                    </New>
                </Arg>
            </Call>
        </New>
    </Arg>
</Call>

Download mysql-connector-java-{$version}-bin.jar and copy to to $JETTY_HOME/lib/ext.. (This is the JDBC connector for MySQL, for other databases, go to appropriate website to download.)

Create a mail session bound to mail/MailSession.

Create $JETTY_HOME/etc/jaas.config.

PortalRealm {
	com.liferay.portal.kernel.security.jaas.PortalLoginModule required;
};

Create directory $JETTY_HOME/webapps/root and unpack liferay-portal-4.3.0.war into it

To add support for accessing Liferay's services remotely and to access the document library using WebDAV follow these steps:

Repeat the previous step for lazslo-web.war to be able to use the flash based Lazslo tool from portlets and for cms-web.war to use the legacy Liferay CMS.

Go to $JETTY_HOME/webapps/root/WEB-INF/lib and delete xercesImpl.jar and xml-apis.jar.

Copy $JETTY_HOME/webapps/root/WEB-INF/lib/commons-logging.jar to JETTY_HOME/ext (overwriting existing one).

Create batch file.

@echo off

if "" == "%JAVA_HOME%" goto errorJavaHome

%JAVA_HOME%/bin/java -Xmx512m -Dfile.encoding=UTF8 -Duser.timezone=GMT -Djava.security.auth.login.config=../etc/jaas.config -DSTART=../extra/etc/start-plus.config -jar ../start.jar ../etc/jetty.xml

goto end

:errorJavaHome
	echo JAVA_HOME not defined.

	goto end

:end

Note: If you get a java.lang.OutOfMemoryError exception while starting up Jetty, give your JVM more memory by setting -Xmx512m.

Start Liferay by running run.bat. Open your browser to http://localhost:8080. Click on My Liferay at the upper right hand corner to enter the login screen. Your login is [email protected] and your password is test.

Download and install Tomcat 5.5.17 into your preferred directory. From now on, the directory where you installed Tomcat will be referred to as $TOMCAT_HOME.

Download and install JDK 5 . Set an environment variable called %JAVA_HOME% (in Windows) or $JAVA_HOME (in Linux/UNIX) to point to your JDK directory.

Note: If you are using JDK 1.4, you must download and install the JDK 1.4 Compatability Package at tomcat.apache. For JDK 1.4 users: delete $TOMCAT_HOME/webapps/ROOT/WEB-INF/lib/xercesImpl.jar. For JDK 5 users: move $TOMCAT_HOME/webapps/ROOT/WEB-INF/lib/xercesImpl.jar to TOMCAT_HOME/common/endorsed.

Create and edit $TOMCAT_HOME/conf/Catalina/localhost/ROOT.xml to set up the portal web application.

<Context path="">
</Context>

Download liferay-portal-4.3.0.war.

Download Liferay's Portal 4.3.0 Dependencies.

Edit $TOMCAT_HOME/conf/catalina.properties.

common.loader=
    ${catalina.home}/common/classes,\
    ...\
    ${catalina.home}/common/lib/ext/*.jar

Make sure your database server is installed and is working. If it's installed in a different machine make sure that it's accessible from the one where Liferay is being installed.

Configure data sources for your database. Make sure the JDBC driver for your database is accessible by Tomcat.

Edit $TOMCAT_HOME/conf/Catalina/localhost/ROOT.xml.

<Context...>
    <Resource
        name="jdbc/LiferayPool"
        auth="Container"
        type="javax.sql.DataSource"
        driverClassName="com.mysql.jdbc.Driver"
        url="jdbc:mysql://localhost/lportal?useUnicode=true&amp;characterEncoding=UTF-8"
        username=""
        password=""
        maxActive="100"
        maxIdle="30"
        maxWait="10000"
    />
</Context>

Create a database for Liferay. For example:

create database lportal character set utf8;

Liferay will automatically create the tables and populate it the first time it starts.

Create a mail session bound to mail/MailSession.

Edit $TOMCAT_HOME/conf/Catalina/localhost/ROOT.xml and configure a mail session.

<Context...>
	<Resource
		name="mail/MailSession"
		auth="Container"
		type="javax.mail.Session"
		mail.transport.protocol="smtp"
		mail.smtp.host="localhost"
	/>
</Context>

Configure JAAS.

Edit $TOMCAT_HOME/conf/Catalina/localhost/ROOT.xml and configure a security realm.

<Context...>
	<Realm 
		className="org.apache.catalina.realm.JAASRealm"
		appName="PortalRealm"
		userClassNames="com.liferay.portal.security.jaas.PortalPrincipal"
		roleClassNames="com.liferay.portal.security.jaas.PortalRole"
		debug="99"
		useContextClassLoader="false"
	/>
</Context>

To add support for accessing Liferay's services remotely and to access the document library using WebDAV follow these steps:

Repeat the previous step for lazslo-web.war to be able to use the flash based Lazslo tool from your own portlets, themes, etc and for cms-web.war to use the legacy Liferay CMS.

Create $TOMCAT_HOME/conf/jaas.config.

PortalRealm {
	com.liferay.portal.kernel.security.jaas.PortalLoginModule required;
};

Edit $TOMCAT_HOME/bin/catalina.bat so that Tomcat can reference the login module.

rem ----- Execute...

set JAVA_OPTS=-Xms128m -Xmx512m -Dfile.encoding=UTF8 -Duser.timezone=GMT -Djava.security.auth.login.config=%CATALINA_HOME%/conf/jaas.config

Delete contents $TOMCAT_HOME/webapps/ROOT directory.

Unpack liferay-portal-4.3.0.war to $TOMCAT_HOME/webapps/ROOT.

For supporting UTF-8 UIRIEncoding, edit $TOMCAT_HOME/conf/server.xml.

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
   <Connector port="8080" maxHttpHeaderSize="8192"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               connectionTimeout="20000" disableUploadTimeout="true"
               URIEncoding="UTF-8"
   />

Run Tomcat, point browser to http://localhost:8080. Sign in as [email protected] and password test

Download and install Resin into your preferred directory. From now on, the directory where you installed Resin will be referred to as $JBOSS_HOME.

Download and install JDK 5 . Set an environment variable called %JAVA_HOME% (in Windows) or $JAVA_HOME (in Linux/UNIX) to point to your JDK directory.

Download MySQL from www.mysql.com and install.

Edit $RESIN_HOME/conf/resin.conf.

replace lines 60-64

<class-loader>
      <tree-loader path="${resin.home}/lib"/>
      <tree-loader path="${server.root}/lib"/>
    </class-loader>

with

<class-loader>
      <tree-loader path="${resin.home}/lib"/>
      <tree-loader path="${server.root}/lib"/>
      <compiling-loader path="${server.rootDir}/common/classes"/>
      <library-loader path="${server.rootDir}/common/lib"/>
    </class-loader>

add:

<database>
		<jndi-name>jdbc/LiferayPool</jndi-name>
		<driver type="com.mysql.jdbc.Driver">
		<url>jdbc:mysql://localhost/lportal?useUnicode=true&amp;characterEncoding=UTF-8</url>
			<user></user>
			<password></password>
		</driver>
		<prepared-statement-cache-size>8</prepared-statement-cache-size>
		<max-connections>20</max-connections>
		<max-idle-time>30s</max-idle-time>
	</database>

	<resource jndi-name="mail/MailSession" type="javax.mail.Session">
		<init>
			<mail.store.protocol>imap</mail.store.protocol>
			<mail.transport.protocol>smtp</mail.transport.protocol>
			<mail.imap.host>localhost</mail.imap.host>
			<mail.pop3.host>localhost</mail.pop3.host>
			<mail.smtp.host>localhost</mail.smtp.host>
		</init>
	</resource>

	<system-property javax.xml.parsers.DocumentBuilderFactory="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl" />
	<system-property javax.xml.parsers.SAXParserFactory="org.apache.xerces.jaxp.SAXParserFactoryImpl" />
	<system-property javax.xml.transform.TransformerFactory="org.apache.xalan.processor.TransformerFactoryImpl" />
	<system-property org.xml.sax.driver="org.apache.xerces.parsers.SAXParser" />

Go to $RESIN_HOME and create new directory common\lib. Download mysql-connector-java-{$version}-bin.jar and copy to this directory. (This is the JDBC connector for MySQL, for other databases, go to appropriate website to download.)

Create a database for Liferay. For example:

create database lportal character set utf8;

Liferay will automatically create the tables and populate it the first time it starts.

Download the Liferay Portal 4.3.0 Dependencies and unzip into $RESIN_HOME\common\lib.

Delete contents of $RESIN_HOME\webapps\ROOT.

Unzip liferay-portal-4.3.0.war to $RESIN_HOME\webapps\ROOT.

Download the sources of Liferay Portal and unzip them to a temporal directory:

Go to $RESIN_HOME\bin and create run.bat.

..\httpd.exe -Xmx512m -Dfile.encoding=UTF-8 -Duser.timezone=GMT

Start Resin. Open your browser to http://localhost:8080. Click on Access at the upper right hand corner to enter the login screen. Your login is [email protected] and your password is test.