Setting up and administering the web application

Obtaining the source code

Download our code (download md.zip

Unzip the file, e.g. in directory ~/md :

cd
mkdir md
cd md
unzip ~/Downloads/md.zip

Create a directory for third-party libraries:
```
cd
cd md
mkdir lib
```

Third-party software and libraries

What you will need:

A web server, or more precisely an HTTP server that supports servlets and JSP pages. In our installation we're using Apache Tomcat 9, which is installed in /opt/tomcat. In a more production-like environment you may want to have a more complicated setup, e.g. Tomcat behind the Apache HTTP Server.
A MySQL server, or some other SQL database server.
Apache Ant (a build tool)
Apache OpenJPA. On our system, we have it installed in /opt/Apache/apache-openjpa-2.4.2. If you use a different version of OpenJPA, or install it at a different location, you'll need to change the value of the property "openjpa" in the file build.xml that comes with our code, so that it will point to your location of OpenJPA.
A few other third-party libraries. This is what we have in ~/md/lib now:
```
commons-fileupload-1.3.3.jar  commons-io-1.4.jar   mysql-connector-java-5.1.28.jar
```
Among these, the mysql JAR file comes from the MySQL Connector site, and the commons-* files from Apache Commons.

Setting up the MySQL server

On the MySQL server, create the database named md
On the MySQL server, create the user named md, and set the password for it (pick any password you want)
Grant all permissions on database md to user md.
Modify the file ~/md/md/META-INF/persistence.xml : the value of the property openjpa.ConnectionPassword should conatin the password which you have assigned to the MySQL user md. This will enable your web application to login to the MySQL server, so that it can store data there.

Building and deploying

You probably don't want to run the build process as root (sudo ant deploy); it makes more sense to use sudo just once, to create the deployment directory /opt/tomcat/webapps/md/ , and then transfer its ownership (using chown) to yourself (i.e. the user who'll be doing the deployment).

You can then build and deploy the application with Apache Ant:

cd ~/md/md
ant deploy

Or, to also build and deploy documentation,

cd ~/md/md
ant deploy-javadoc

Building for deployment on a different host

If you build on one host for deployment to another host that runs Tomcat (or a similar web server that supports servlets), run

cd ~/md/md
ant dist

This will create file

~/md/md.war

, which you can then deploy to the remote server using the web-based application manager (https://HOST/manager/html).

Create coordinator accounts

Create accounts for the survey coordinators in the Missed Detection web application.

Web accounts for the coordinators: Use ~/md/md/create-roles.sh to create user accounts in the survey management system for the coordinators (or a single coordinator account) as desired. (See edu.rutgers.md.sqltools.CreateRoles for syntax).

Back to main documentation page