1. Liferay Installation Prepared by: Do Xuan Hai 8 August 2011

2. Liferay IDE Installation Requirements o Java 5.0 JRE o Eclipse Helios (3.6.x) IDE for Java EE Developers

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

4. Liferay IDE Installation steps o 4. Click "Add..." button to open Add Site dialog o 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/]http://releases.liferay.com/tools/ide/eclipse/helios/stable/ Helios release nightly URL - http://releases.liferay.com/tools/ide/eclipse/helios/nightly/] (Unstable version)http://releases.liferay.com/tools/ide/eclipse/helios/nightly/ o 6. Select OK o 7. Select the Liferay IDE site from the combo selection box o 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

5. Liferay IDE Installation steps o 9. Click Next and then click Finish to begin the install o 10. After plugins download and install you will have to accept that the content is unsigned and then restart eclipse o 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

6. Requirements before getting started o 1. Liferay Portal 6.0 (RC2 or greater) downloaded and installed (or download in the IDE itself) o 2. Liferay Plug-ins SDK 6.0 (RC2 or greater) downloaded and installed (or download in the IDE itself) o 3. Eclipse Helios/Galileo Java EE for developers package Note: earlier versions of Liferay, e.g. 5.x, are not supported yet by the Liferay IDE

7. Liferay 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 o 1. Open Eclipse with Liferay IDE installed. o 2. Open Preference page for Liferay > Installed SDKs ( Go to Window > Preferences > Liferay > Installed SDKs )

8. Liferay Plug-ins SDK Setup o 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).sourceforge.net Liferay downloads page o 4. Add your SDK using the Add button which brings up the Add SDK Dialog:

9. Liferay Plug-ins SDK Setup o 5. Browse to the location of your Plug-ins SDK installation. o 6. The default name is the name of the directory but you can change it if you wish. o 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.

10. Liferay Portal / Server Setup o 1. In eclipse open the Runtime environments preference page (Go to Window > Preferences > Server > Runtime environments)

11. Liferay Portal / Server Setup o 2. Click Add to add a new Liferay runtime and find Liferay v6 Tomcat under the Liferay, Inc. category and click Next

12. Liferay Portal / Server Setup o 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

13. Liferay Portal / Server Setup o 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

14. Liferay Portal / Server Setup o 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

15. Liferay Portal / Server Setup o 6. Click finish and you should see the Liferay portal runtime in the list of runtimes in the preference page

16. Liferay Portal / Server Setup o 7. Click OK to save the runtime preferences o 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

17. Liferay Portal / Server Setup o 9. Find the Liferay, Inc category and select the Liferay v6 Server and choose the Liferay v6 Runtime that you had previously created

18. Setting the Console Encoding This step is not necessary for Liferay IDE 1.2 and greater, see http://issues.liferay.com/browse/IDE-287 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 o 1. Select "Run" - "Run Configuration..." from the Eclipse menu. o 2. Select "Liferay v6.0 Server" from the menu. o 3. Select the "Common" tab. o 4. In the encoding section, select "Other" and "UTF-8". Select "Apply" - "Close".

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

20. Testing the Liferay portal server o 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

21. Testing the Liferay portal server o 3. The eclipse browser should open to the portal home at http://localhost:8080http://localhost:8080

22. Create new Liferay Plug-in Project o 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

23. Create new Liferay Plug-in Project o 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

24. Create new Liferay Plug-in Project o 3. If it worked you should see a new plugin project in the package explorer, so you are ready to begin Plugin Development

25. Questions and Answers