Deployment

Data Explorer web application distributed as a dataexplorer.war - self-containded war file, which can be deployed to any servlet-compatible container, such as Tomcat (7.x and up), JBOSS, etc.

To deploy Data Explorer, simply drop dataexplorer.war in to the apps folder in the servlet containter. For Tomcat it is /tomcat/webapps.

Configuration

When exploded, dataexplorer.war contains the following folders, which can (in many cases should) be moved somewhere else.

(all examples are for Data Explorer deployed to Tomcat)

1. Add the following line to the /tomcat/conf/catalina.properties:
spring.config.location=${catalina.home}/conf/application.properties
2. Create empty application.properties file in the /tomcat/conf folder

data

Data folder is used to stote ETL scenarios, metadata cache, temporary files, etc.
By default, when deployed to Tomcat, Data Explorer uses the following folder for data: /tomcat/webapps/dataexplorer/data.

To configure data folder to be outside of the servlet container, add the following line to the application.properties file:
app.data.path=new-location-of-the-data-folder

logs

By default, when deployed to Tomcat, Data Explorer creates logs in the /tomcat/webapps/dataexplorer/logs folder.

You can change it by modifying /tomcat/webapps/dataexplorer/config/log4j.properties file.

Recommended (for Tomcat):
log4j.appender.FILE.File=${catalina.home}/logs/{app.name}.log

license

License folder is used to store Data Explorer license (*.lic) files.
By default, when deployed to Tomcat, Data Explorer uses the following folder for licenses: /tomcat/webapps/dataexplorer/license.

To configure location of the license folder, add the following line to the application.properties file:
app.license.path=new-location-of-the-license-folder