This project:
Web Module:
EJB Module:
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.]
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.
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.
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.
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