Quick Installation Instructions
Alternative Languages: 日本語 <<TableOfContents>>
Introduction #
This guide helps you to set up and run a Liferay Tomcat bundle. It is geared toward beginners to Liferay. If you are planning on using the bundle for anything other than demo, please complete these steps but also Database Configuration and remove 7Cogs sample data afterwards! It is very important that you do these things because otherwise you can lose all your data.
Prerequisites #
- Hardware - 1GB RAM
- Java 6 or later for Linux or Mac. Windows users don't need to install Java, as JRE is bundled.
Java Install #
Ubuntu #
Linux users need to install Java. Ubuntu users can easily install java by using the terminal and typing:
sudo apt-get install sun-java6-jdk
If you use another Linux distro, you need to find the equivalent command for your package manager.
Mac OSX #
Apple Computer supplies their own version of Java. Use the Software Update feature (available on the Apple menu) to check that you have the most up-to-date version of Java for your Mac.
Easy Liferay Installation #
1) Download the desired bundle from http://www.liferay.com/downloads/liferay-portal. Tomcat bundle is recommended, and it is what this guide uses.
2) Unzip the package into a directory.
3) Open the command line and run:
Windows:C:/{directory}/liferay-{version}/tomcat-{version}/bin catalina.bat run
Linux/OSX: cd /{directory}/liferay-{version}/tomcat-{version}/bin ./startup.sh }}}
Windows users can also go to the directory and double-click "startup.bat" to run.
4) Liferay will startup in 30-60 seconds on modern computers.
5) Look at the server console until you see something like the following:
INFO: Server startup in 42950 ms
5) Open a browser and go to http://localhost:8080. Congratulations, you are now running Liferay Portal!
Next Steps #
- Database Configuration
- Configure Email Notifications (see SMTP Setup)
- Remove 7Cogs sample data (see below)
Default Usernames and Passwords #
From Liferay 5.2.x+, you will find some sample data in the portal. The user with administration privileges has the following credentials:
* Email address: //bruno@7cogs.com// * Password: //bruno// If you remove [[7Cogs sample data]], then the user with administration privileges will be: * Email address: //test@liferay.com// * Password: //test// From Liferay 5.1.x and lower, then the user with administration privileges will be: * Email address: //test@liferay.com// * Password: //test//
Other Documentation #
For a complete guide on installation and setup options check the Official Documentation. Also, when available check the "Liferay Portal Administration Guide," which is the official documentation for Liferay Portal.
Troubleshooting #
If your Liferay won't start after clicking startup.bat maybe it can't find Java. Open in notepad file {tomcat-home}/bin/setenv.bat and point JRE_HOME to folder where you installed Java. You setenv.bat should look like this:
set "JRE_HOME=C:\Program Files\Java\jre6" set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF8 -Duser.timezone=GMT -Xmx1024m -XX:MaxPermSize=256m"
If it works you should check again your Java installation.
Support #
- If you are having problems with the instructions here you can use the Installation / Deployment / Setup category in the forum for free community support.
- If you would like professional support for your organization, you can consider Liferay Enterprise Edition which offers extended support.
Related Links #
- Database Configuration for updated instructions on how to setup the connection to the database.
- Custom Java Install for Windows users not using the bundled JRE.
