This software is conceived as a web application and runs inside a servlet container such as Apache Tomcat.
Installation requirements
Database setup
Basic application setup
These instructions are for setting up a single instance of the application. If you require multiple instance running inside the same container, follow the instructions in the section "Advanced application setup".
Advanced application setup
If you require multiple instance of the application running in the same container, individual database connections can be declared per-webapp by editing the webapp's context configuration file in Tomcat's conf/Catalina/localhost folder. You can specify the path to the configuration file for each instance using the soda4LCAProperties environment via JNDI.
<Context antiJARLocking="true" swallowOutput="true">
<Resource auth="Container"
driverClassName="com.mysql.jdbc.Driver"
maxActive="8"
maxIdle="4"
name="jdbc/soda4LCAdbconnection"
type="javax.sql.DataSource"
url="jdbc:mysql://localhost/soda4LCAdb"
username="myusername"
password="mypassword"
/>
<Environment name="soda4LCAProperties"
value="/path/to/soda4LCA.properties" type="java.lang.String"/>
</Context>
It is a good idea to make the context configuration file immutable (chattr +i) so it doesn't get overwritten when the context is redeployed.
IMPORTANT: Change default administrator password
Once you start up the application, login with the administrative account (username: admin, password: default) and change the password (go to the "Users" menu and select the "Manage Users" option, then select the "admin" account from the list).