Chapter 2. Installing a Liferay Bundle

Table of Contents

1. Quick Installation
2. Customizing the bundle installation
2.1. Database Configuration
2.2. Further Configuration

Liferay Portal is distributed with the following bundle options for the Professional Edition:

The following options are offered for the Enterprise Edition:

Choose your preferred bundle and download it from the downloads page. Then follow the following steps described next.

1. Quick Installation

Once you have downloaded the bundle you can have Liferay Portal running very quickly following these steps:

  1. Download and install JavaSE 5.0 if you have not done so already. If you picked the Tomcat (JDK 1.4 bundle), use the JavaSE 1.4 version instead. Make sure you have defined the JAVA_HOME environment variable.

  2. Unzip the bundle to your applications directory. For example: c:\apps in Windows or /usr/local/ in Linux or UNIX variants.

  3. Go to the bin directory inside the application server directory and run it using the provided script. The name of the script will depend on the application server and you will have to use the version provided for your operating system. Names are usually pretty intuitive such as run.bat, startup.bat, jonas.bat...etc. When in a Unix environment, the batch file to start the server will end with the extension sh instead of bat and it is necessary to make the script executable by running chmod +x filename.sh. It is often neccessary to run the executable from the directory where it resides.

  4. Once the application server has finished initialization (the first time it might take a few minutes) open your browser and go to htp://localhost:8080 (assuming local installation otherwise change localhost with the host name or IP).

    The bundle comes with an embeded HSQL database loaded with sample data from the public website of Liferay. You can try Liferay as an anonymous user by navigating your local version the public website.

  5. Login as an administrator using the following data:

    • User: test@liferay.com

    • Password: test

Congratulations! you now have a running copy of Liferay. Refer to the end user documentation for more information about how to use the administration functionalities and the bundled portlets. Refer to the development and customization documentation to learn how to adapt Liferay to your needs. The next section provides information