Liferay Installation Prepared by: Do Xuan Hai 8 August 2011

Liferay InstallationLiferay Installation

Prepared by: Do Xuan HaiPrepared by: Do Xuan Hai

8 August 2011

Liferay IDE InstallationLiferay IDE Installation

Requirements Java 5.0 JRE Eclipse Helios (3.6.x) IDE for Java EE Developers

Liferay IDE InstallationLiferay IDE Installation steps steps

Installation steps 1. Install Eclipse Helios or Galileo (unzip download file from above) 2. Run eclipse.exe 3. When eclipse opens, go to Help > Install New Software...

Liferay IDE InstallationLiferay IDE Installation steps steps 4. Click "Add..." button to open Add Site dialog 5. Type in Liferay IDE for name, and location use one of the following URLs

Helios release stable URL - http://releases.liferay.com/tools/ide/eclipse/helios/stable/] Helios release nightly URL - http://releases.liferay.com/tools/ide/eclipse/helios/nightly/] (Unstable version)

6. Select OK 7. Select the Liferay IDE site from the combo selection box 8. When the table refreshes you should see Liferay Tooling category and one

entry for Liferay IDE feature, select the checkbox to install the feature

http://releases.liferay.com/tools/ide/eclipse/helios/stable/

http://releases.liferay.com/tools/ide/eclipse/helios/nightly/

Liferay IDE InstallationLiferay IDE Installation steps steps 9. Click Next and then click Finish to begin the install 10. After plugins download and install you will have to accept that the

content is unsigned and then restart eclipse 11. After you restart, go to Help > About Eclipse and you should see a Icon

badge for Liferay IDE that shows you have it properly installed

Requirements before getting startedRequirements before getting started

1. Liferay Portal 6.0 (RC2 or greater) downloaded and installed (or download in the IDE itself)

2. Liferay Plug-ins SDK 6.0 (RC2 or greater) downloaded and installed (or download in the IDE itself)

3. Eclipse Helios/Galileo Java EE for developers packageNote: earlier versions of Liferay, e.g. 5.x, are not supported yet by the Liferay IDE

Liferay Plug-ins SDK SetupLiferay Plug-ins SDK Setup

Before you can begin creating new Liferay plug-in projects, a Liferay Plug-ins

SDK and Liferay Portal must be installed and configured in the IDE 1. Open Eclipse with Liferay IDE installed. 2. Open Preference page for Liferay > Installed SDKs ( Go to Window >

Preferences > Liferay > Installed SDKs )


3. If you have not already downloaded the Liferay Plug-ins SDK for your portal version you can download it from the sourceforge.net Liferay downloads page. Liferay plugin sdk is located available in the "portal" folder. In the "portal" folder, select the Liferay version matching the Liferay version. Within this folder, look for liferay-plugins-sdk-x.x.x.zip (usually the last file).

4. Add your SDK using the Add button which brings up the Add SDK Dialog:

http://sourceforge.net/projects/lportal/files/





5. Browse to the location of your Plug-ins SDK installation. 6. The default name is the name of the directory but you can change it if you

wish. 7. Select OK and you should see your SDK in the list of Installed SDKs.

Note: multiple SDKs can be added to the preferences but you will need to select at least one SDK to be the default which is represented by the SDK that has the checkbox selected.

Liferay Portal / Server SetupLiferay Portal / Server Setup

1. In eclipse open the Runtime environments preference page (Go to Window > Preferences > Server > Runtime environments)


2. Click Add to add a new Liferay runtime and find Liferay v6 Tomcat under the Liferay, Inc. category and click Next


3. If you have not already downloaded and installed a copy of the Liferay Portal Tomcat bundle then you can download the latest Liferay Portal Tomcat bundle by clicking the "Download and Install..." button within the wizard


4. If you used the download option you can skip this step, if not, click Browse and select the location of the liferay-portal-6.0.2 directory


5. Once you have selected the Liferay portal directory if it has a bundled JRE then that bundled JRE will be automatically selected as the JRE to use for launching the server. However, if there is no bundled JRE (Mac and Linux users) then you will need to select the JRE to use for launch


6. Click finish and you should see the Liferay portal runtime in the list of runtimes in the preference page


7. Click OK to save the runtime preferences 8. If you didn't choose to create a server you will need to create one from

the servers view before you can test the server


9. Find the Liferay, Inc category and select the Liferay v6 Server and choose the Liferay v6 Runtime that you had previously created

Setting the Console EncodingSetting the Console Encoding

This step is not necessary for Liferay IDE 1.2 and greater, see http://issues.liferay.com/browse/IDE-287 This steps are not necessary if Liferay is installed on an OS whose encoding is latin1 or UTF-8 (most US and European OS). Otherwise, it is necessary to specify the console encoding to properly display console messages

1. Select "Run" - "Run Configuration..." from the Eclipse menu. 2. Select "Liferay v6.0 Server" from the menu. 3. Select the "Common" tab. 4. In the encoding section, select "Other" and "UTF-8". Select "Apply" -

"Close".

http://issues.liferay.com/browse/IDE-287

Testing the Liferay portal serverTesting the Liferay portal server

1. Go to the servers view and you should see the new server that was created. right click and choose "Start" or "Debug“


2. You should see messages appear in the Console view and once it starts, the servers view will update to show that it is "Started" and then, right-click the server and select the (Liferay Portal > Open Portal Home) action


3. The eclipse browser should open to the portal home at http://localhost:8080

http://localhost:8080/

Create new Liferay Plug-in ProjectCreate new Liferay Plug-in Project

1. Now that a SDK and portal server have been configured you can create a new Liferay plug-in project. Go to File > New Project... > Liferay > Liferay Plug-in Project


2. In the Liferay Plugin project wizard page, select the SDK and Liferay runtime and then select the plug-in type (portlet is default) and now you can create a new plug-in project, by clicking Finish


3. If it worked you should see a new plugin project in the package explorer, so you are ready to begin Plugin Development

Questions and AnswersQuestions and Answers

Documents

Liferay Installation Prepared by: Do Xuan Hai 8 August 2011