Components

This project:

Web Module:

EJB Module:

Instructions for building the Datashot web application.

Prerequsisites

First, configure the database, see the DataShot Desktop Application project for instructions and the schema.

Install Glassfish 3.1.2.2+ (these are old instructions, works in Glassfish 5.1).
[Configure jdbc resource, jdbc connection pool, jms connection factory, jms destination.]

Component projects

Checkout the three projects that go into building the datashot EAR artifact.

datashot_web datashot_ejb datashot_ee

In Eclipse: (1) Checkout each of the above into a separate project.

(2) Enable maven: Right click on each project in Package Explorer, select Maven/Enable Dependency Management from the popup menu.

(3) Add Glassfish runtime: From main menu Window/Preferences, in preference dialog select Server/RuntimeEnvironment, click "Add", in runtime environment dialog, select Glassfish 3.1, or click
"Download additional server adapters", install Glassfish, then restart, return to Server/RuntimeEnvironment and add Glassfish 3.1 (specifying the path to a local glassfish install, e.g. /usr/local/glassfish_3122/glassfish/) then restart Eclipse,

(4) Check Problems tab for any Errors.

Building

Build with Maven:

(1) datashot_ejb

mvn clean install
(builds a jar artifact and puts it in your local maven repository)

(2) datashot_web

mvn clean install
(builds a war artifact and puts it in your local maven repository)

(3) datashot_ee

mvn clean package
(builds an ear artifact in datashot_ee/target/)

(4) Deploy resulting artifact

Deploy datashot_ee/target/datashot-ear-1.0.0-SNAPSHOT.ear to the Glassfish container. The Web application will be at localhost:8080/ic/

You may also wish to configure maven, glassfish, and eclipse to install the ear file directly to glassfish in step 3.

Configuration

The path for the web application /ic/ is set in context-root in src/main/application/META-INF/application.xml in the datashot_ee project.

In glassfish

You will need to set the database JDBC connection parameters in glassfish. The JDBC resource is expected to have the JNDI name
mysql_localhost_lepidoptera (regardless of the actual DBMS), and you will need to set up a corresponding JDBC connection pool specifying the jdbc driver, url (e.g. jdbc:mysql://localhost:3306/lepidoptera), user, password, serverName, databaseName, and port (in JDBC Connection Pool Properties (Additional Properties), and an authorization realm. Check your jdbc driver for appropriate driver class name and path.

You will need to add the JMS topic: jms/InsectChatTopic and the corresponding JMS connection factory:
jms/InsectChatTopicFactory

From the glassfish installation directory, where bin/asadmin is found, the following invocations of asadmin will add the relevant properties for a local development MySQL or MariaDB database:

bin/asadmin create-jdbc-connection-pool --driverclassname com.mysql.cj.jdbc.Driver --restype java.sql.Driver --property portNumber=3066:password={password}:user=LEPIDOPTERA:serverName=localhost:databaseName=lepidoptera:URL=\"jdbc:mysql://127.0.0.1:3306/lepidoptera\" mysql_lepidoptera_pool

bin/asadmin create-jdbc-resource --connectionpoolid mysql_lepidoptera_pool jdbc/mysql_localhost_lepidoptera

bin/asadmin create-jdbc-resource --connectionpoolid mysql_lepidoptera_pool mysql_localhost_lepidoptera

bin/asadmin create-auth-realm --classname com.sun.enterprise.security.auth.realm.jdbc.JDBCRealm  --property "user-table=Users:group-table=Users:user-name-column=username:password-column=hash:group-name-column=role:datasource-jndi=mysql_localhost_lepidoptera:jaas-context=jdbcRealm:digest-algorithm=SHA1:digestrealm-password-enc-algorithm=SHA1" lepidoptera

bin/asadmin create-jms-resource --restype javax.jms.Topic --property Name=InsectChatTopic jms/InsectChatTopic

bin/asadmin create-jms-resource --restype javax.jms.ConnectionFactory --description "connection factory for insect chat" --property ClientId=ICTF jms/InsectChatTopicFactory