Blogs
Ricardo Funke
2 Minute Read
In order to proceed please download the following from your Customer Portal.
- Liferay Portal 6.1 EE WAR
- Liferay Portal 6.1 EE Dependencies
Preparing Jboss for Liferay
- First, create a directory that will be the Liferay's home. We will call it $LIFERAY_HOME.
- Download Jboss and extract it into de $LIFERAY_HOME. Jboss directory will be referred as $JBOSS_HOME.
- In $JBOSS_HOME/bin/run.conf (or run.conf.bat for Windows) change the JAVA_OPTS variable to have the following options:
- Change -Xmx512m to -Xmx1024m
- Add -Dfile.encoding=UTF-8 -Duser.timezone=GMT -Djava.net.preferIPv6Addresses=false -Djava.net.preferIPv4Stack=true
- Open $JBOSS_HOME/server/default/conf/standardjbosscmp-jdbc.xml and search for the "Hypersonic SQL" type-mappping in the file. Change:
<type-mapping>
<name>Hypersonic SQL</name>
<row-locking-template/>
...
<mapping>
<java-type>java.lang.Object</java-type>
<!-- hsqldb only supports directly serializable objects for sql type OBJECT -->
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>VARBINARY</sql-type>
</mapping>
...
</type-mapping>
- to
<type-mapping>
<name>Hypersonic SQL</name>
<row-locking-template/>
...
<mapping>
<java-type>java.lang.Object</java-type>
<!-- hsqldb only supports directly serializable objects for sql type OBJECT -->
<jdbc-type>VARBINARY</jdbc-type>
<sql-type>VARBINARY(1024)</sql-type>
</mapping>
...
</type-mapping>
- Remove hibernate-validator.jar from $JBOSS_HOME/common/lib/.
- Edit $JBOSS_HOME/server/default/conf/login-config.xml and comment out the entire XML for policy "other" in lines 113-129. For example:
<!--application-policy name="other"-->
...
<!--authentication>
<login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"
flag="required"/>
</authentication>
</application-policy-->
Database Configuration
- Download the jdbc connector for your database and copy it into $JBOSS_HOME/server/default/lib/. We will use MySQL for this tutorial.
- If you want Jboss to manage the data source, create the file $JBOSS_HOME/server/default/deploy/liferay-ds.xml with the following content:
<datasources>
<local-tx-datasource>
<jndi-name>jdbc/LiferayPool</jndi-name>
<connection-url>jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<user-name>root</user-name>
<password>root</password>
<min-pool-size>0</min-pool-size>
</local-tx-datasource>
</datasources>
- Then create a file called portal-ext.properties in $LIFERAY_HOME and add the following line:
jdbc.default.jndi.name=jdbc/LiferayPool
- If you wish to manage configuration through Liferay, you will add the following directives instead of adding the line above in portal-ext.properties.
jdbc.default.driverClassName=com.mysql.jdbc.Driver
jdbc.default.url=jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
jdbc.default.username=root
jdbc.default.password=root
- Don't forget to change the informations to correspond to your database settings.
- Also, you may want to use the Liferay's startup wizard to set the database. In this case, don't do any of the configurations above, just install your jdbc driver, finish this tutorial and start Liferay. Then access http://localhost:8080 and set the database configurations. This way, Liferay will create a file called portal-setup-wizard.properties in $LIFERAY_HOME with your database settings.
Mail Configuration
- If you want Jboss to manage the mail configuration, 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">
<attribut 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>
- Then, add the following line to the portal-ext.properties file:
mail.session.jndi.name=mail/MailSession
- Again, if you want to use portal-ext.properties instead, set the following properties in this file:
mail.session.mail.pop3.host=localhost
mail.session.mail.pop3.password=
mail.session.mail.pop3.port=110
mail.session.mail.pop3.user=
mail.session.mail.smtp.auth=false
mail.session.mail.smtp.host=localhost
mail.session.mail.smtp.password=
mail.session.mail.smtp.port=25
mail.session.mail.smtp.user=
mail.session.mail.store.protocol=pop3
mail.session.mail.transport.protocol=smtp
- Don't forget to change the settings according to your mail server.
- Also, you may want to set this in the Liferay database, so instead of doing the settings above, make the Deploy Liferay section below, go to "Control Panel" -> "Server Administration" -> "Mail" and fill in the fields.
Deploy Liferay
- Unzip the Liferay Portal 6.1 EE Dependencies file and copy the contents (the .jar files) to $JBOSS_HOME/server/default/lib/
- Delete all the files and folders in $JBOSS_HOME/server/default/deploy/ROOT.war
- Unzip the Liferay Portal 6.1 EE WAR file to the ROOT.war directory.
- Remove jaxrpc.jar, stax.jar, xercesImpl.jar, xml-apis.jar from $JBOSS_HOME/server/default/deploy/ROOT.war/WEB-INF/lib/
Start Jboss
- Go to $JBOSS_HOME/bin and type ./run.sh for Linux or run.bat for Windows
- Open your browser and access http://localhost:8080
Related Assets...
No Results Found
More Blog Entries...
Community
Company
Feedback