4. Installing the Application Server

The ext environment supports most of the application servers supported by Liferay Portal. The open source application servers are supported by using the bundle that is automatically downloaded from sourceforge. For the proprietary application servers, the basic configurations needed to make them work using a standard distribution are provided.

The default configuration installs all the application servers in the /ext/servers subdirectory. This can be changed for any application server by setting a custom location in the file app.server.${user.name}.properties. You can also set the path to the Sourceforge mirror that you want to use for downloads or set it to point to a local mirror if you want to avoid external connections for each of the developers. For example, to choose an European mirror and install tomcat outside of the ext environment you can use the following configuration:

app.server.type=tomcat
app.server.tomcat.dir=D:/Java/tomcat-5.5.17
sourceforge.mirror=http://belnet.dl.sourceforge.net/sourceforge/lportal

Once you are ready follow the instructions specific for each application server:

JBoss+Jetty

Run ant install-jboss-jetty under /ext/servers

JBoss+Tomcat

Run ant install-jboss-tomcat under /ext/servers

Jetty

Run ant install-jetty under /ext/servers

JOnAS+Jetty

Run ant install-jonas-jetty under /ext/servers

JOnAS+Tomcat

Run ant install-jonas-tomcat under /ext/servers

OC4J
  1. Download oc4j_extended.zip from Oracle and copy it to /ext/downloads

  2. Run ant install-oc4j under /ext/servers

Orion
  1. Download orion2.0.7 .zip to /ext/downloads.

  2. Run ant install-orion under /ext/servers to install Orion to /ext/servers/orion.

Tomcat
  1. If you are using Java 5.0 set the following property in app.server.${user.name}.properties:

    app.server.tomcat.zip.name=liferay-portal-tomcat-jdk5-${downloads.version.file.name}.zip
  2. Run ant install-tomcat under /ext/servers

It is possible install several application servers in the ext environment. Just make sure to set the value of the app.server.type property in app.server.${user.name}.properties to the application server that you are using in any specific moment of time.