Martini Creating a Core on Solr

This guide outlines the process of creating and linking a local or remote Solr core (collection) with Martini. The procedure involves configuring both your Solr server and Martini to establish a successful connection.

Prerequisites

Before proceeding, ensure familiarity with: - Configuring solrconfig.xml - Documents, fields, and schema design in Solr - Defining core.properties in Solr

Procedure

1. Configure Martini Instance Properties

Set the necessary solr-prefixed properties in Martini:

solr.mode: Determines where Martini looks for the Solr core. Options include:
local: For an embedded Solr instance using the host's filesystem.
remote: To connect to a remote Solr instance.
cloud: For a SolrCloud instance.

2. Create the Solr Core or Collection

Local Mode

Structure your configuration files (solrconfig.xml, schema.xml, core.properties) as follows:

<core_name>
├── conf
│   ├── schema.xml
│   ├── solrconfig.xml
│   └── core.properties

Place the directory under <package>/solr in your project.

Remote Mode

Structure your configuration files similarly, without core.properties.
Add the core configuration folder to <solr-home>/server/solr.
Use the Solr admin page to add the new core.

Cloud Mode

Zip solrconfig.xml and schema.xml.
Upload the zip as a ConfigSet using the ConfigSets API.
Use the Solr admin page to add the new collection.

3. Register the Core in Martini

Edit the package.xml of the relevant Martini package to include your new Solr core:

<package>
    <!-- ... -->
    <solr-cores>
        <solr-core name="<core_name>" enabled="true" />
        <!-- ... -->
    </solr-cores>
</package>

4. Restart Martini

Restart your Martini instance or the affected package, depending on the scope of changes.

Confirmation

Successful registration will be indicated in the log messages:

12/03/18 15:04:05.114 INFO  [SolrClient] Starting core: '<core_name>'
12/03/18 15:04:25.402 INFO  [SolrClient] Starting core: '<core_name>' completed