Liferay Portal 4 - Installation Guide

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.2.0.war.

Populate your database with the portal schema and default data.

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.2.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 test@liferay.com 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.2.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.)

Populate your database with the portal schema and default data.

Download Liferay's Portal 4.2.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.2.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 test@liferay.com 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.2.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.)

Populate your database with the portal schema and defult data.

Download Liferay 's Portal 4.2.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.2.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 test@liferay.com 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.2.0.war.

Download Liferay's Portal 4.2.0 Dependencies.

Populate your database with the portal schema and default data.

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.2.0.war.

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 test@liferay.com 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.

Download MySQL from www.mysql.com and install.

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

<Context path="">
</Context>

Download liferay-portal-4.2.0.war.

Download Liferay's Portal 4.2.0 Dependencies.

Edit $TOMCAT_HOME/conf/catalina.properties.

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

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>

Populate your database with the portal schema and default data.

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>

Repeat this step for a file called $TOMCAT_HOME/conf/Catalina/localhost/tunnel.xml if you want to enable Liferay's HTTP tunneling.

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.2.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 test@liferay.com 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.)

Populate your database with the portal schema and default data.

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

Delete contents of $RESIN_HOME\webapps\ROOT.

Unzip liferay-portal-4.2.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 test@liferay.com and your password is test.

Edit portal.properties and add:

hibernate.jdbc.batch_size=0

Do not use the default setting of 20.

Install Sendmail and Expect on your mail server. Expect allows you to add, delete, or update users in one command. An example script for Red Hat is included in /mail-ejb/scripts/redhat.

Configure /portal-ejb/classes/portal.properties for your mail server.

The following instructions assume:

Install Fedora Core 4.

For a minimal installation, choose to install a custom server. Deselect all packages groups. Select the package groups: Text-based Internet, Mail Server, DNS Name Server, FTP Server, MySQL Database, Network Servers, Development Tools, Legacy Software Development, Administration Tools, and System Tools.

Make sure the following RPMs are also selected. The packages cyrus-imapd and cyrus-imapd-utils are only available in Fedora Core 2 and Fedora Core 4. They were not part of Fedora Core 1 and needed to be compiled manually. In Fedora Core 4, they were moved to Extras and you will need to use yum to install these packages.

Mail Server: +cyrus-imapd, +cyrus-imapd-utils

MySQL Database: +mysql-server

Development Tools: +expect

Update Fedora. This may take a while even if you have a fast connection.

rpm --import /usr/share/rhn/RPM-GPG-KEY-fedora yum list yum upgrade

Turn off Sendmail.

chkconfig --level 3 sendmail off
/etc/rc.d/init.d/sendmail stop

Edit /etc/sysconfig/saslauthd.

Replace MECH=shadow with MECH=pam.

Turn on Cyrus SASL.

chkconfig --level 3 saslauthd on
/etc/rc.d/init.d/saslauthd start

Download Cyrus IMAP. If you are using Fedora Core 2 or later, you can use the RPMs from Fedora: cyrus-imapd and cyrus-imapd-utils. If you are using Fedora Core 1 or an earlier version of Red Hat, download cyrus-imapd-2.1.16-6.src.rpm and build the RPM for your environment from the source distribution.

Build Cyrus IMAP.

rpmbuild --rebuild cyrus-imapd-2.1.16-6.src.rpm

Install Cyrus IMAP.

rpm -i cyrus-imapd-2.1.16-6.i386.rpm

rpm -i cyrus-imapd-utils-2.1.16-6.i386.rpm

Turn on Cyrus IMAP.

chkconfig --level 3 cyrus-imapd on

/etc/rc.d/init.d/cyrus-imapd start

Download the source distribution of Postfix.

Install Postfix with support for MySQL and Cyrus SASL.

rpm -ivh postfix-2.1.6-1.src.rpm

cd /usr/src/redhat/SOURCES

bash

export POSTFIX_MYSQL_REDHAT=1

export POSTFIX_SASL=2

export POSTFIX_TLS=1

sh make-postfix.spec

exit

cd /usr/src/redhat/SPECS

rpmbuild -ba postfix.spec

cd /usr/src/redhat/RPMS/i386

rpm -i --force postfix-2.1.6-1.mysql.sasl2.tls.fc4.i386.rpm

Download the source distribution of PAM MySQL.

Install PAM MySQL.

rpm -ivh pam_mysql-0.5-0.src.rpm

cd /usr/src/redhat/SPECS

rpmbuild -ba pam_mysql.spec

cd /usr/src/redhat/RPMS/i386

rpm -i pam_mysql-0.5-0.i386.rpm

Copy /mail-ejb/scripts/fedora/cyrus/mysql_virtual.cf to /etc/postfix/mysql_virtual.cf. Modify mysql_virtual.cf to point to your MySQL database.

Edit /etc/postfix/virtual. Add the line yourdomain.com anything for each virtual domain that Postfix will manage. A correspending entry is needed in the MySQL database so that email to postmaster@yourdomain.com can be delivered to a Cyrus IMAP account.

Transform /etc/postfix/virtual to a format Postfix can read.

postmap /etc/postfix/virtual

Edit /etc/postfix/master.cf. Replace the two instances of /cyrus/bin/deliver with /usr/lib/cyrus-imapd/deliver. Add these two lines:

procmail  unix  -       n       n       -       -       pipe
  flags=R user=cyrus argv=/usr/bin/procmail -t -m USER=${user}
EXTENSION=${extension} /home/cyrus/procmailrc

Edit /etc/postfix/main.cf. Add these lines:

#
# Custom Settings
#

mynetworks = 127.0.0.0/8, 192.168.0.0/16, 128.135.12.7/32

mailbox_command = /usr/bin/procmail -t -a "$EXTENSION"
mailbox_transport = procmail

virtual_maps = hash:/etc/postfix/virtual, mysql:/etc/postfix/mysql_virtual.cf

smtpd_recipient_restrictions = permit_mynetworks, check_client_access hash:/etc/postfix/pop-before-smtp, check_relay_domains

Set mynetworks to the IPs that are allowed to connect to Postfix. Turn on Postfix.

chkconfig --level 3 postfix on

/etc/rc.d/init.d/postfix start

Copy /mail-ejb/scripts/fedora/cyrus/procmailrc to /home/cyrus/procmailrc. Make sure the cyrus user can access the script.

chown cyrus:mail /home/cyrus

chown cyrus:mail /home/cyrus/procmailrc.

Copy /mail-ejb/scripts/fedora/cyrus/cyrus_adduser to /usr/bin/cyrus_adduser. Edit cyrus_adduser and replace localhost with the mail server's host name. Make sure the script can be executed.

chmod u+x /usr/bin/cyrus_adduser.

Copy /mail-ejb/scripts/fedora/cyrus/cyrus_userdel to /usr/bin/cyrus_userdel. Edit cyrus_userdel and replace localhost with the mail server's host name. Make sure the script can be executed.

chmod u+x /usr/bin/cyrus_userdel.

	Note
	If you copy cyrus_adduser and cyrus_userdel from a Windows environment to a Linux environment, you need to run dos2unix cyrus_adduser to convert the file so that Linux can read the file correctly.

Edit /etc/pam.d/pop so that POP authentication is checked via MySQL. Remove the current lines and add these lines:

#%PAM-1.0
auth sufficient pam_mysql.so user=dbuser passwd=dbpassword host=127.0.0.1 db=cyrus
table=CyrusUser usercolumn=userId passwdcolumn=password_ crypt=0

account required pam_mysql.so user=dbuser passwd=dbpassword host=127.0.0.1 db=cyrus
table=CyrusUser usercolumn=userId passwdcolumn=password_ crypt=0

Edit /etc/pam.d/imap so that IMAP authentication is checked via MySQL. Remove the current lines and add these lines:

#%PAM-1.0
auth sufficient pam_mysql.so user=dbuser passwd=dbpassword host=127.0.0.1 db=cyrus
table=CyrusUser usercolumn=userId passwdcolumn=password_ crypt=0

account required pam_mysql.so user=dbuser passwd=dbpassword host=127.0.0.1 db=cyrus
table=CyrusUser usercolumn=userId passwdcolumn=password_ crypt=0

Turn on MySQL.

chkconfig --level 3 mysqld on

/etc/rc.d/init.d/mysqld start

Configure MySQL so that it can be accessed by the username dbuser and password dbpassword.

use mysql;

insert into user values ('127.0.0.1', "dbuser", password("dbpassword"), "Y", "Y", "Y", "Y", "Y", "Y", "Y", "Y", "Y", "Y", "Y", "Y", "Y", "Y");

Create the database and tables that will be used to authenticate IMAP users.

create database cyrus;

use cyrus;

create table CyrusUser ( userId varchar(75) not null primary key, password_ varchar(75) not null );

create table CyrusVirtual ( emailAddress varchar(75) not null primary key, userId varchar(75) not null );

The Expect scripts cyrus_adduser and cyrus_userdel that are used to add and delete Cyrus IMAP users require a default cyrus user to authenticate with.

insert into CyrusUser (userId, password_) values ('cyrus', 'cyrus_password');

Every virtual domain requires a postmaster@yourdomain.com entry so that email to postmaster@yourdomain.com can be delivered to a Cyrus IMAP account.

insert into CyrusVirtual (emailAddress, userId) values ('postmaster@yourdomain.com', 'your_domain_1');

Create a default account for your_domain_1.

insert into CyrusUser (userId, password_) values ('your_domain_1', 'your_password');

insert into CyrusVirtual (emailAddress, userId) values ('joe.blogs@yourdomain.com', 'your_domain_1');

quit;

cyrus_adduser cyrus_password your_domain_1

Turn on SpamAssassin.

chkconfig --level 3 spamassassin on

/etc/rc.d/init.d/spamassassin start

Download ClamAV.

Install ClamAV.

rpm -i clamav-0.86.1-1.i386.rpm

Turn on ClamAV.

chkconfig --level 3 clamd on

/etc/rc.d/init.d/clamd start

Download ClamAssassin.

Install ClamAssassin.

gunzip clamassassin-1.2.2.tar.gz

tar xvf clamassassin-1.2.2.tar

cd clamassassin-1.2.2

./configure

cp clamassassin /usr/local/bin

Edit /usr/local/bin/clamassassin.

Set SUBJECTHEAD to "[VIRUS] ".

Copy /mail-ejb/scripts/fedora/cyrus/procmail_vacation to /usr/local/bin/procmail_vacation. Make sure the script can be executed.

chmod u+x /usr/local/bin/procmail_vacation.

Download SendEmail.

Install SendEmail.

gunzip sendEmail-v1.52.tar.gz

tar xvf sendEmail-v1.52.tar

cd sendEmail-v1.52

chmod u+x sendEmail

chown cyrus:mail sendEmail

cp sendEmail /usr/local/bin

Download the source distribution of Pop-before-smtp.

Pop-before-smtp requires perl-TimeDate and perl-Net-Netmask.

Install perl-TimeDate from the distributed RPM.

Install perl-Net-Netmask.

perl -MCPAN -e 'install Net::Netmask'

Install Pop-before-smtp.

gunzip pop-before-smtp-1.38.tar.gz

tar xvf pop-before-smtp-1.38.tar

cd pop-before-smtp-1.38

chown root:root *

cp pop-before-smtp.init /etc/rc.d/init.d/pop-before-smtp

cp pop-before-smtp /usr/sbin/

cp pop-before-smtp-conf.pl /etc

Edit /etc/pop-before-smtp-conf.pl by uncommenting and modifying certain sections so it matches the following information.

$dbfile = '/etc/postfix/pop-before-smtp';

$grace = 120*60;

# Set the log file we will watch for pop3d/imapd records.
$file_tail{'name'} = '/var/log/maillog';

# For Cyrus (including a tweak for IP addrs that don't resolve):
$pat = '^(... .. ..:..:..) \S+ (?:pop3d|imapd)\[\d+\]: ' .

Turn on Pop-before-smtp.

chkconfig --level 3 pop-before-smtp on

/etc/rc.d/init.d/pop-before-smtp start

Restart your mail server.

shutdown -r now

Go to www.apache.org.

Click Directory.

Click Download.

Click on the suggested mirror site for download.

Click apacheds>stable>1.0>1.0 RC3>apacheds-1.0-RC3-win32-setup.exe

Save file.

Click on the Apache icon and follow the installation instructions.

Click Start.

Go to www.jxplorer.org.

Click Downloads>precompiled java package>Windows platform.

Save file.

Click on the LDAP browser icon and follow the installation instructions.

Open the LDAP browser.

Click File>Connect.

Change the port to 10389.

In the Level drop-down menu, choose User+Password.

Insert uid=admin,ou=system in the User DN input field.

The password is secret.

Click Save and enter a name for the template.

Right click on Example and click New.

Add inetorgperson to the Selected Class.

User Jane Smith will be added. Enter cn=janesmith in the Enter RDN field and click OK.

In the Table Editor enter Smith in the SN line.

Enter Jane in the givenName line.

For the mail enter janesmith@liferay.com.

For the userpassword enter test.

Click Submit.

With user Jane Smith entered into the LDAP browser, the user will now be integrated with Liferay Portal. Begin by logging into Liferay Portal as the Administrator.

The login is test@liferay.com and the password is test.

Currently, Jane Smith’s profile exists only on the LDAP browser. To integrate her information into Liferay Portal, click on the Users tab in the Admin portlet.

Click Authentication.

Click LDAP.

Check the Enabled box.

If the Required box is checked only users in the LDAP server will be able to log into Liferay Portal. For this demonstration leave the box unchecked.

Liferay Portal supports other directory servers in addition to the ones provided. The Apache Directory Server, Microsoft Active Directory Server, and Novell eDirectory comes preconfigured.

Select the Apache Directory Server and click Save.

Once Jane Smith logs in to her account on Liferay Portal and agrees to the terms of use, her user information will be added to Liferay Portal. To demonstrate this, assume that Jane Smith has logged into her account. While logged in as the Administrator, a search for Jane Smith will show that the user has been integrated into Liferay Portal.