Usage Instructions

Introduction

Apache TomEE (pronounced “Tommy”) is a lightweight, enterprise-grade Java EE application server built on top of Apache Tomcat. It combines the simplicity of Tomcat with the power of Java EE technologies, providing a full Java EE 7 certified stack. Apache TomEE supports features like JPA, CDI, EJB, JAX-RS, and more, enabling developers to build scalable, robust enterprise applications with ease.

Apache TomEE is distributed under the Apache License, Version 2.0, a permissive open-source license that allows wide use, including commercial applications, and promotes collaboration and innovation.

Getting started

  1. Launch the product via 1-Click
  2. Use a web browser to access the Manager Application at http://[ec2-ip]:8080/manager, or the Host Manager Application at: http://[ec2-ip]:8080/host-manager where [ec2-ip] is the public ip provided by Amazon for your instance.
  3. Log in using the following credentials:
    • Username: admin
    • Password: The instance_id of the EC2 instance

You can also access your EC2 instance via SSH using the username and your Amazon private key.

The username depends on the operative system:

  • Amazon Linux: 'ec2-user'
  • Ubuntu: 'ubuntu'
  • Rocky Linux: 'rocky'
  • AlmaLinux: 'ec2-user'
  • CentOS Stream: 'ec2-user'

Installation details

To change the default username and password, edit the $TOMEE_HOME/conf/tomcat-users.xml file.

Tomcat server is deployed in /opt/java/apache-tomee-[version] directory, which is linked to /opt/java/apache-tomee.

Server service is configured with systemd.

View status server:

[centos@ip-172-31-9-232 etc]$ sudo systemctl status tomee

Stop server:

[centos@ip-172-31-9-232 etc]$ sudo systemctl stop tomee

Start server:

[centos@ip-172-31-9-232 etc]$ sudo systemctl start tomee

Other useful data

Location of sensitive information

There is no sensitive data.

Encryption configuration

There is no encrypted data.

Changing system credentials

To change the tomEE credentials you have to modify the following file: /opt/java/apache-tomee/conf/tomcat-users.xml.

Instructions on how the user interacts with Tomcat to decrypt necessary data

You can use the TomEE management console to view all necessary data.

How to assess and monitor the health and proper function of the application.

  1. Navigate to your Amazon EC2 console and verify that you're in the correct region.
  2. Choose Instance and select your launched instance.
  3. Select the server to display your metadata page and choose the Status checks tab at the bottom of the page to review if your status checks passed or failed.

List of AMIs provisioned by Neodoo

Apache TomEE
Ubuntu Linux 22.04 LTS View
Ubuntu Linux 24.04 LTS View
Amazon Linux 2023 View

Additional resources