Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

Insight.war is a web app that is included in the tomcat bundle and is located in the <frevvo-home>\tomcat\webapps directory. Insight is only supported for the tomcat and JBOSS containers.

The war contains a batch process that extracts all the latest submissions from  and creates Insight Server documents for them. Indexed submission data is stored in <frevvo-home>\data\solr directory and is needed for the Reports feature.

  1. The batch is run automatically as part of the upgrade.
  2. It requires access to the submission repository and uses the same database configuration as .

It is possible to manually run a batch process to re-index Insight. Some situations where you may want to run the batch job are:

  • If Insight gets out of sync
  • Submission schema changes due to a upgrade
  • An upgrade of Insight if the underlying index structure has changed
  • Recovery of index due to data loss or corruption.

The batch process can be run for all tenants or a specific tenant.

Cloud customers must contact frevvo to request the batch process for your tenant.

In-house customers can use the Manage Insights Data function to manually run the batch process.

Column
width300px

On This Page:

Table of Contents
maxLevel3

...

When the batch job runs, tables that store the state of the job are created in the frevvo database. By default, if a job were to fail or be stopped, starting the job again would restart the failed/stopped job from where it failed/stopped.

To restart a Stopped/Failed batch job, simply start the batch job again with same tenant and it will resume the last stopped job. 

To prevent the last stopped job from restarting, change the status to Abandoned.

Abandoning the Insight Data Batch Process

...

If you are not interested in data before a certain date, configure the parameter index.submission.start.date  to a date in the YYYY-MM-DD format in the <frevvo-home>\tomcat\conf\catalina\localhost\insights.xml file. The batch will then exclude any submissions before this date.

Troubleshooting

Additional information, about the Insight Batch Job can be found in the <frevvo-home>\tomcat\logs\insight.log file.

Insight Batch Job displays a status of UNKNOWN

...