EAR Setup Verifier

This project is a sample for verifying correct system development setup.

If it can be built and run, the system has the correct setup and is ready for the B6B33EAR course.

Software Requirements

• Java 8 (download here)
• NetBeans 8 (download here) or any other Java IDE
• Apache Maven 3 (download here)
• NodeJS 4 or later (download here)
• npm (should be installed together with NodeJS)
• PostgreSQL 9 and later (download here)
• Apache Tomcat 8 (download here) or any other Java EE 7 Web compatible application server

Feel free to install the software using your system's package manager.

Application Setup

This is the shortest path setup without any customizations. Feel free to modify your setup in any way you like.

We are assuming that PostgreSQL is running at localhost:5432 (see src/main/resources/jdbc.properties). We are also assuming that Apache Tomcat is used with its default port - 8080.

PostgreSQL database setup

1. start `psql`
2. `CREATE USER ear WITH password 'ear';`
3. `CREATE DATABASE ear WITH OWNER ear;`

Setup without IDE

1. Create a database named ear, owned by user ear identified by password ear (again, see src/main/resources/jdbc.properties).
2. Go to src/main/webapp and run npm install - this downloads JavaScript dependencies used by the UI implementation. This operation takes some time.
3. In the same folder, run npm run build - this packs the whole JavaScript-based UI into one bundle - js/bundle.js.
4. Go back to the project's root (i.e. the directory where this README file is located) and run mvn clean package - this uses maven to download Java dependencies of the project and builds a deployable war archive with the application.
5. Copy the resulting archive - ear-setup.war from target into your Tomcat's webapps directory.
   1. E.g. if you unpacked Tomcat into /opt/apache-tomcat-8.0.37, copy the war file into /opt/apache-tomcat-8.0.37/webapps
6. Start Tomcat by running startup.sh (or startup.bat) in the bin directory of your Tomcat.
7. Go to http://localhost:8080/ear-setup - you should see a table of people who will be teaching you, including their contact emails and rooms where to find them.
8. Congratulations, you are done!

Setup with NetBeans IDE

1. Same as above.
2. Same as above.
3. Same as above.
4. Open NetBeans, go to Services, right click on Servers and add your Tomcat installation if it is not already present (NetBeans installer enables you to automatically download and install Tomcat).
   1. Enter some user credentials in Step 2 (e.g. admin/admin) and check the Create user if it does not exist checkbox, otherwise NetBeans won't be able to start Tomcat.
5. Click Open Project and select this project.
6. Clean and Build the project (Shift + F11).
7. Click Run Project.
8. If a server selection dialog opens, select the server you added in Step 4 (and also select the Remember Permanently option).
9. A browser will automatically open at http://localhost:8080/ear-setup.
   1. If not, open it manually.
10. Congratulations, you are done!