How do I use Liferay Portal Professional 3.6.1 with Pramati Server?

How do I use Liferay Portal Professional 3.6.1 with Pramati Server?

This document specifies how to deploy Liferay on Pramati Server and use the application.

Which product versions support the Certification?

The certification was done with the following product versions:

1. Liferay Professional 3.6.1
2. Pramati Server 4.1 SP4
3. JDK 1.4

What are the requirements to use Liferay with Pramati Server?

To use Liferay with Pramati Server:

• Install Pramati Server 4.1. For this document Pramati Server 4.1 SP4 has been used.
• Download Liferay Portal Professional.
• For database issues and drivers needed visit Database documentation on Liferay's documentation page. A new database needs to be created and the tables needs to be created for which SQL scripts are availiable at Liferay's site.
• Download Liferay JAAS jar.

How do I prepare Liferay for deployment on Pramati Server?

• Create a directory liferay.
• Place liferay-portal-pro-3.6.1.war and liferay-jaas.jar in the liferay directory.
• Download extract.bat and classpath.bat and place them in the liferay directory.
• Edit <$PSERVER-INSTALL>/server/bin/setup.bat. Add the below snippet right after Pramati declares the CLASSPATH. Modify the newly added snippet by replacing the entries by the correct path of the liferay directory which you created now.

  set LOCALCLASSPATH=
  for %%i in ("\*.jar") do call "\classpath.bat" %%i
  set CLASSPATH=%CLASSPATH%;%LOCALCLASSPATH%
  

How do I configure Pramati Server for Liferay?

• In runserver.bat of Server located in <$PSERVER-INSTALL>/server/bin/ folder, increase the JVM heap size to -Xmx128m.
• Create a node liferay. Can be done through Pramati Server Administration Service.
• Create a datasource resource (can be done through Pramati server management console) for the node liferay with name jdbc/LiferayPool. Details on database and drivers for Liferay can be obtained from Database section of Liferay installation documentation avaliable on Liferay's website. Make sure the JDBC driver for your database is accessible by Pramati Server.
• Create a mail resource with name mail/MailSession.
• Security Realm configuration
• Open security-config.xml located in <$PSERVER-INSTALL>/server/nodes/liferay/config directory.
• Add the following snippet under the <server-policy> tag.

  <realm-policy>
         <realm-name>PortalRealm</realm-name>
         <AllPermission>
      	<permission>
      	  <name>AllPermission</name>
      	  <action/>
      	  <group-name>everybody<group-name>
      	<permission>
            <AllPermission>
            <CertificateManagerPermission />
            <JMSPermission>
      	<permission>
      	  <name>pramati_dmq</name>
      	  <action>queue-browser,receiver<action>
      	  <group-name>everybody<group-name>
      	  <group-name>nobody<group-name>
      	</permission>
      	<permission>
      	  <name>*<name>
      	  <action>durable-subscriber,queue-browser,receiver,sender,unsubscribe<action>
      	  <group-name>everybody<group-name>
      	  <group-name>nobody<group-name>
      	<permission>
            </JMSPermission>
            <NamingServicePermission>
      	<permission>
      	  <name>*<name>
      	  <action>lookup,list<action>
      	  <group-name>nobody<group-name>
      	<permission>
            <NamingServicePermission>
            <ResourceServicePermission />
            <RealmPermission />
            <UserManagerPermission />
            <ServerAdminPermission />
            <ServerAppPermission />
  <realm-policy>
  

• Locate the <realm> tag in the security-config.xml file. This corresponds to the default system realm. Create a new realm by appending the following snippet after the <realm> of the system realm config.

	<realm>
		<realm-name>PortalRealm<realm-name>
		<user-manager>
		  <class-name>com.liferay.portal.jaas.ext.pramati.PortalUserManager<class-name>
		  <init-options>
		<entry>
		  <name>algotype<name>
		  <value>text<value>
		<entry>
		<entry>
		  <name>realmname<name>
		  <value>PortalRealm</value>
		<entry>
		<entry>
		  <name>encode<name>
		  <value>true<value>
		<entry>
		  <init-options>
		<user-manager>
	<realm>

• Add the following snippet below the <configuration> tag:

   <login-module-configuration>
        <realm-name>PortalRealm<realm-name>
        <config-entry>
  	<class-name>com.liferay.portal.jaas.ext.pramati.PortalLoginModule<class-name>
  	<flag>required<flag>
  	<options>
  	  <entry>
  	    <name>algotype<name>
  	    <value>text<value>
  	  <entry>
  	  <entry>
  	    <name>realmname<name>
  	    <value>PortalRealm<value>
  	  <entry>
  	  <entry>
  	    <name>encode<name>
  	    <value>true<value>
  	  <entry>
  	<options>
        <config-entry>
   <login-module-configuration>
  

How do I deploy Liferay application on Pramati Deploy Tool?

• Start the newly created liferay node. Restart the server is the node is already running.
• Open Pramati deploy tool.
• Open the archive liferay-portal-pro-3.6.1.war located in the liferay directory created earlier. Go to:
• Web-properties > General tab. Change the context root of the application to \.
• Security > liferay-portal-pro-3.6.1.war. Change the Realm to the newly created PortalRealm. Map users role to everybody.
• Web-properties > Resources tab and map resource ref jdbc/LiferayPool to the newly created datasource jdbc/LiferayPool. Also map the mail/MailSession resource ref to mail/MailSession mail resource which was created.
• Save the archive.
• Deploy the application.

How do I access the Liferay Portal?

To access the application after it has started, access the URL http://<ip>:<port> of your node.

© Pramati Technologies 2007	Runs on Pramati Server | Feedback | Legal