Description

The Standalone Solr Server gives the user an ability to run an Apache Solr instance as a Catalog data store within the distribution. The Standalone Solr Server contains a Solr Web Application Bundle and preconfigured Solr configuration files. A Solr Web Application Bundle is essentially the Apache Solr war repackaged as a bundle and configured for use within this distribution.

Usage

Users can use this feature to create a data store. Users would use this style of deployment over an embedded Java Solr Server when the user wants to install a Solr Server on a separate, dedicated machine for the sole purpose of isolated data storage or ease of maintenance. The Standalone Solr Server can now run in its own JVM (separate from endpoints and other frameworks) and accept calls with its "REST-like HTTP/XML and JSON API."

This Standalone Solr Server is meant to be used in conjunction with the Solr Catalog Provider for External Solr. The Solr Catalog Provider acts as a client to the Solr Server.

Installation/Uninstall

Prerequisites

Before the DDF Solr Catalog Application can be installed for configuration as the Standalone Solr Server:

the DDF Kernel must be running

In production environments, it is recommended that Standalone Solr Server be run in isolation on a separate machine in order to maximize the Solr Server performance and use of resources such as RAM and CPU cores. The Standalone Solr Server, as its name suggests, does not require or depend on other apps such as the Catalog API, nor does it require their dependencies either such as Camel, CXF, etc. Therefore it is recommended to have the Solr Server app run on a lightweight

DDF

distribution such as the

DDF

Distribution Kernel. If clustering is necessary, the Solr Server App can run alongside the Platform App for clustering support.

Installation

By default, the features for the Embedded Solr Server configuration are installed, so the catalog-solr-embedded-provider feature must be uninstalled and the catalog-solr-server feature installed using the normal processes described in the Administrator's Guide's Configuration section. This feature is included out of the box in the current distribution. Installing the feature will copy the Solr configuration files in the distribution home directory and then deploy the configured Solr war. Verification that the server started correctly can be done by visiting the Solr Admin interface at http://localhost:8181/solr.

Verification

To verify if the DDF Solr Catalog Application was successfully installed for the Standalone Solr Server configuration, verify the appropriate features have been successfully installed. The features catalog-solr-external-provider and catalog-solr-embedded-provider should be uninstalled.

DDF Solr Catalog Application installed features for Standalone Solr configuration

ddf@local>features:list | grep catalog-solr-app
[uninstalled] [2.3.0] catalog-solr-embedded-provider catalog-solr-app-2.3.0    Catalog Provider with locally Embedded Solr Server, implemented using Solr 4.1.0.
[uninstalled] [2.3.0] catalog-solr-external-provider catalog-solr-app-2.3.0    Catalog Provider to interface with an external Solr 4.1.0 Server
[installed  ] [2.3.0] catalog-solr-server            catalog-solr-app-2.3.0    Deploys and starts a preconfigured Solr War into this container

Verify the DDF Solr Catalog Application bundles are Active for the Standalone Solr Server:

DDF Solr Catalog Application's active bundles for Standalone Solr Server configuration

ddf@local>list | grep -i solr
[ 115] [Active     ] [            ] [       ] [   80] Apache ServiceMix :: Bundles :: SolrJ (0.3.0.2)
[ 117] [Installed  ] [            ] [       ] [   80] DDF :: Catalog :: Solr :: Embedded :: Provider (2.3.0)
[ 118] [Active     ] [            ] [       ] [   80] DDF :: Catalog :: Solr :: Server :: Standalone War (2.3.0)

Uninstall

Reverting the Uninstall

Upgrade

Configuration

The Standalone Solr Server comes pre-configured to work with Solr Catalog External Provider implementations. For most use cases, no other configuration to the Solr Server is necessary with the standard distribution.

Known Issues

The standalone Solr Server fails to install if it has been previously uninstalled prior to the distribution being restarted.

Browser not supported