Tomcat configuration and deployment

Configruation of Tomcat 6 & 7

Open the file conf/tomcat-users.xml and add a new user with the manager-roles to the tomcat-users section:

<tomcat-users>
  ...
  <role rolename="manager-gui"/>
  <role rolename="manager"/>
  <user username="username" password="password" roles="manager,manager-gui"/>
</tomcat-users>

Configuration of your maven settings.xml file

Open your settings.xml file and add the following section:

<settings>
  ...
  <servers>
    <server>
      <id>tomcat</id>
      <!-- username and password must match with the tomcat's ones -->
      <username>username</username>
      <password>password</password>      
    </server>
  </servers>
</settings>

Deploying BackMeUp to Tomcat 6

Make sure that you have set up the plugins correctly (Plugin-Setup) Run following commands to deploy BackMeUp to Tomcat 6:

cd org.backmeup.rest
mvn -P war,standard clean package install tomcat6:redeploy
# or -P war,dummy to use the dummy implementation

Deploying BackMeUp to Tomcat 7

Make sure that you have set up the plugins correctly (Plugin-Setup) Run following commands to deploy BackMeUp to Tomcat 7:

cd org.backmeup.rest
mvn -P war-t7,standard clean package install tomcat6:redeploy
# or -P war-t7,dummy to use the dummy implementation

Deploying to a remote server

If you want to deploy to a remote server, you have to adjust the file org.backmeup.rest/pom.xml:

...
<profile>
  <!-- look for war-t7 if you want to adjust the tomcat7 deployment -->
  <id>war</id>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.tomcat.maven</groupId>
        <artifactId>tomcat6-maven-plugin</artifactId>
        ...
        <configuration>						
          <server>tomcat</server>
          <!-- on tomcat 6, you can specify following URL to your favorite tomcat server -->
          <url>http://pathtoserver:port/manager</url>
          <!-- on tomcat 7, you have to add /html after the URL, e.g.: -->
          <url>http://pathtoserver:port/manager/html</url>
        </configuration>
...
</profile>