When you look at the base of your Mint and ReDBox installations you will see the following directories:
- home
- portal
- server
- solr
- storage
The sections below provide an overview of the contents of each directory.
home
The home
directory contains a range of files that will be very handy for anyone configuring and supporting the system. Importantly, system-config.json
contains the main configuration for the ReDBox and Mint systems. The details of this file are covered in Configuration Files.
For trouble-shooting, the logs
folder contains a range of logs to assist you in tracking system state:
stdout.out
is created at system startup and logs startup progress
main.log
is the primary log for the system
houseKeeping.log
tracks the system's internal house-keeping sub-system
harvest.out
is created when you start a harvest
BrokerMonitor.log
tracks the message queues used by the system
The logs/jetty
and logs/solr
directories contain the logs for the Jetty server and Apache Solr systems respectively.
The data
directory contains data files that can be uploaded (ingested) by the system. For Mint, this is a set of source files for known vocabularies or entities.
The database-service
directory contains Apache Derby database files used internally by the system.
The harvest
directory provides harvest configuration files and their associated rules files. For details about harvests, refer to Loading data
The templates
directory provides a set of metadata templates that are used to transform data within the system to various metadata formats such as Dublin Core and RIF-CS. For details of how to edit these files, please see Metadata Templates.
A variety of other directories may exist under home
, depending on what plug-ins you have configured.
portal
The portal directory contains the files that define the system's look and feel. The
Branding section describes how to edit the portal files to change your system's appearance.
server
The scripts for starting and stopping the system as well as ingesting new data are located in the server directory. Two sets of files are provided to meet the needs of Windows and Unix/Linux users:
- Windows scripts:
tf_env.bat
tf_start.bat
tf_harvest.bat
- Unix/Linux scripts:
tf_env.sh
tf.sh
tf_harvest.sh
The tf_env.*, tf_start.bat
and tf.sh
scripts are described in Control Scripts. The tf_harvest scripts are described in Loading data.
There's also a set of sub-directories in the server directory. In general, most people won't need to change these at all unless they're doing development work.
- jetty: this contains the Jetty server that runs the ReDBox and Mint systems
- lib: is the collection of Java libraries used by the system
- plugins: are Java libraries used by the system
- webapps: are the web application archives
solr
Both ReDBox and Mint utilises the
Apache Solr search platform. This directory contains the Solr configuration and various Solr indexes. Unless you are looking to actively develop the Mint or ReDBox systems you are unlikely to change the contents of the solr directory.
storage
If you are using the file-system storage plugin, the storage directory is the system's internal storage (you could call it a database). You are able to browse the various sub-directories but you shouldn't modify or delete any of the files in these directories.