Chart Search Installation Process

After module installation it will create chartsearch directory in OpenMRS data directory. It's a Solr home. It contains conf/ and data/ directories. Conf directory contains Solr config files, data contains index files. 

To change properties, such as a daemons count and schedulers timeouts, you should edit sorlconfig.xml file. First, find /csdataimport section.

It will look like this:

<requestHandler name="/csdataimport"
class="org.apache.solr.handler.dataimport.ChartSearchDataImportHandler">
<lst name="defaults">
<str name="config">data-config.xml</str>
<int name="daemonsCount">4</int>
<int name="patientInfoTimeout">30</int>
<int name="indexSizeManagerTimeout">30</int>
<int name="indexClearStrategy">1</int>
<int name="indexMaxPatients">30</int>
</lst>
</requestHandler>
  • daemonsCount:: count of import daemons
  • patientInfoTimeout: time between writing patients last index time to file, in seconfs
  • indexSizeManagerTimeout: time between cleaning index with current IndexClearStrategy, in seconds
  • indexClearStrategy: integer presentation of selected IndexClearStrategy
    • 0 - do not clear index
    • 1 - clearing based on max patients left in the index
    • 2 - clearing based on patient non usage time
  • indexMaxPatients: only if indexClearStrategy equals to 1

  • patientMaxNonUsageTime: only if indexClearStrategy equals to 2, in seconds

After editing solrconfig.xml you should restart module to affect changes.

Migration to separate Solr

You can move to separate Solr server.

Copy to Solr dist/ directory

1) chartsearch-server-VERSION.jar

2) super-csv-2.1.0.jar .

3) mysql-connector-java-5.1.8.jar

4) mysql-connector-mxj-5.0.12.jar (in case of mxj connection)

Make sure you have solr-dataimporthandler-4.3.1.jar here.

Copy conf/ directory content to Solr conf/ folder.

After deploying Solr you can specify the address in settings page. 

Write url to Solr and write "true" to in "Use Dedicated SOLR server". After that you should restart module.