This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Child pages
  • Configuring Virtual Host in Jetty

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin



In the Configuring Virtual Host in Tomcat section we describe how to define a Virtual Host in the Geronimo's config.xml so applications can be deployed to specific hosts ( Virtual Hosts) with a minimal configuration on the application deployment plans side. The need to define Virtual Hosts at the server level ( config.xml ) only applies to Geronimo with Tomcat distributions.


  1. Create a app_home directory somewhere in the file system, from now on we will reference this location as <app_home>.
  2. Create a HelloWorld.jsp file in the <app_home> directory and paste the following content. XMLHelloWorld.jsp <html> <head> <jsp:useBean id="datetime" class="java.util.Date"/> <title>Basic HelloWorld JSP</title> </head> <body bgcolor="#909DB8"> <h1><font face="tahoma" color="white">Hello world from GERONIMO!</font></h1> <font face="tahoma" color="white">on ${datetime}</font> </body> </html>
  3. Create a WEB-INF directory under <app_home>.
  4. Create a web.xml file in the <app_home>\WEB-INF directory and paste the following content. XMLweb.xml <?xml version="1.0" encoding="UTF-8"?> <web-app version="2.4" xmlns="" xmlns:xsi="" xsi:schemaLocation=""> <welcome-file-list> <welcome-file>HelloWorld.jsp</welcome-file> </welcome-file-list> </web-app>
  5. Create a geronimo-web.xml file in the <app_home>\WEB-INF directory and paste the following content. XMLgeronimo-web.xml <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns=""> <environment> <moduleId> <groupId>sample.applications</groupId> <artifactId>HelloWorldApp</artifactId> <version>2.1</version> <type>war</type> </moduleId> </environment> <context-root>/hello</context-root> <!-- Add this line to define a new Virtual Host in Geronimo - Jetty --> <virtual-host></virtual-host> </web-app>

If you compare this deployment plan with the one described in the Quick start - Apache Geronimo for the impatient section you will note that only one line has been added, that is <virtual-host></virtual-host>. This is all you need to define a virtual host in Geronimo with Jetty.


<geronimo_home>\bin\deploy --user system --password manager deploy --inPlace <app_home>

#000000solid D:\geronimo-jetty6-jee5-2.1\bin>deploy --user system --password manager deploy --inPlace \HelloWorld_2.1 Using GERONIMO_BASE: D:\geronimo-jetty6-jee5-2.1 Using GERONIMO_HOME: D:\geronimo-jetty6-jee5-2.1 Using GERONIMO_TMPDIR: D:\geronimo-jetty6-jee5-2.1\var\temp Using JRE_HOME: C:\Java\jdk1.5.0_06\\jre Deployed sample.applications/HelloWorldApp/2.1/war @ http://hcunico:8080/hello

Note that even when the successful deployment message on screen shows that the application has been deployed to the http://XYZ:8080/hello host, the application will only be accessible via the virtual host previously defined in the <virtual-host> tag on the geronimo-web.xml deployment plan.