NAME

Rex::Apache::Deploy::Tomcat - Deploy application to tomcat 6.

DESCRIPTION

With this module you can deploy WAR archives to Tomcat. Currently it works with Tomcat 6.

SYNOPSIS

use Rex::Apache::Deploy qw/Tomcat/;
  
context_path "/myapp";
   
task "dodeploy", "tc01", "tc02", sub {
   deploy "myapp.war",
      username => "manager",
      password => "manager",
      port     => 8080;
};

FUNCTIONS

deploy($file, %option)

This function deploys the given WAR archive. For that it will connect to the Tomcat manager. You have to define username and password for the Tomcat manager in the %option hash. If the Tomcat manager isn't available under its default location /manager you can also define the location with the manager_url option.

task "dodeploy", "tc01", "tc02", sub {
   deploy "myapp.war",
      username     => "manager",
      password     => "manager",
      manager_url  => "_manager",
      port         => 8080,
      context_path => "/foo";
};

context_path($path)

This function sets the context path for the application that gets deployed. This is a global setting. If you want to specify a custom context path for your application you can also do this as an option for the deploy function.

context_path "/myapp";