Chapter 3. Deployment of Plugins

Table of Contents

1. Deployment Options
1.1. Standard Deployment
1.2. Hot Deployment
2. Deploying Third Party plugins
2.1. Deploying Community Themes
2.2. Adding Layout Template

1. Deployment Options

1.1. Standard Deployment

Portlet, themes, and layout templates are all packages as standard Java EE WAR files. For this reason they can be deployed using the standard method for the application server being used.

Note that you will probably have to restart the application server so that the portal registers the new portlet, theme, or layout. To avoid doing a restart follow the instructions in the next section.

1.2. Hot Deployment

Liferay allows you to easily hot deploy layout templates, JSR 168 portlets, and themes. Layout templates allow portlets to be arranged inside the constraints of custom layouts. JSR 168 portlets add functional abilities to the portal. Themes modify the look and feel of the portal. Layout templates, portlets, and themes can be deployed at runtime by utilizing the hot deploy features of Liferay.

  1. Go to the drive where you installed your server. Check to see that /home/liferay/deploy exists. If it does not exist, create it. You can also customize the location of this directory from the Admin portlet:

  2. Start the server. The server will now automatically scan for *.war files.

  3. Download one of the layout templates, sample portlets, or themes to /home/liferay/deploy. Click here for a list of sample portlets, themes and layouts. (Any JSR 168 compliant portlet WAR will work as well.)

  4. Install either JBoss+Jetty, JBoss+Tomcat, Jetty, Resin, Tomcat, or WebSphere.

  5. If you have already set up the extension environment, you can hot deploy portlets, layouts, or themes by dropping them into ext/portlets, ext/layouttpl, or ext/themes respectively. You can then run ant deploy from that directory.

    Notes: If the hot deploy feature does not work, make sure that your *.war file is a JSR 168 compliant portlet WAR, theme, or layout. (You cannot use themes and layouts designed for Liferay Portal v3.6.1 or layouts and themes that were designed for other portals).