If you prefer, TomEE can be setup by deploying a .war file into an existing Tomcat installation, as opposed to using the all-in-one bundle. This guide provides a set of step-by-step instructions to this approach.
- Update $CATALINA_HOME/conf/tomcat-users.xml to add a tomee user to allow access to the console
<!-- Activate those lines to get access to TomEE GUI --> <role rolename="tomee-admin" /> <user username="tomee" password="tomee" roles="tomee-admin,manager-gui" /> - Download the .war file you wish to use - either the tomee-webapp-1.5.0.war (for the webprofile installation) or tomee-webapp-plus-1.5.0.war (for the plus version).
- Copy the .war file to $CATALINA_HOME/webapps/tomee.war (the .war filename is important)
Macintosh:apache-tomcat-7.0.32 jgallimore$ cp ~/Downloads/tomee-plus-webapp-1.5.0.war webapps/tomee.war
- Start Tomcat
Macintosh:apache-tomcat-7.0.32 jgallimore$ cd bin Macintosh:bin jgallimore$ ./catalina.sh run
- Go to the TomEE webapp: http://localhost:8080/tomee and login with the user you added to tomcat-users.xml
- Click the "Test your setup" link at the top. This should check that everything is working correctly, and should display like the page below:
- If everything looks ok, click on the 'Continue tests' button. This will run some additional checks:
- If everything has tested ok, click on the Index link at the top and select the '[Optional] Install Listener and JavaAgent' link.
- Confirm that the folders shown are correct for your installation, and click the 'Install' button.
- TomEE will now make the necessary changes to your Tomcat installation (backing up any files changed). The next screen will show a summary:
- Restart Tomcat, and refresh the page in your browser. If the installation has been successful you will see the page below:
- Your TomEE installation is now complete!