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 instances running inside the same container, follow the instructions in the section "Advanced application setup".
IMPORTANT:
Ensure to configure the files.location.datafiles properties in the "data and temp directories" section of your soda4LCA.properties to point somewhere outside the directory containing web application, otherwise you will lose your data (external files attached to source datasets) on re- or undeploy!
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"
validationQuery="SELECT 1"
testOnBorrow="true"
removeAbandoned="true"
removeAbandonedTimeout="300"
logAbandoned="true"
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 (using chattr +i) so it won't be overwritten by Tomcat 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 (select "My Profile" in the footer bar and enter new password in the respective fields of the following screen).