node-solr-smart-client

0.2.2 • Public • Published

node-solr-smart-client

A node.js solr smart client. In short it serves as a smart constructor for solr-client. The constructor queries a ZooKeeper ensemble for live nodes of the input Solr collection. When more than one live node is returned by ZooKeeper, the constructor picks one at random and hands over to solr-client.

Features

Installation

npm install node-solr-smart-client

Include option --save to add it to your package.json file in the same go:

npm install node-solr-smart-client --save

Usage

Basic

// Load dependency
var solrSmartClient = require('node-solr-smart-client');

// Define options
options = {
    zkConnectionString: 'localhost:2181',
    zkLiveNodes: '/live_nodes',
    zkAliases: '/aliases.json',
    solrProtocol: 'http',
    solrCollectionsGetEndPoint: '/admin/collections?action=LIST', // Supports XML and JSON writer types
    ssh: {},
    // Passed verbatim to node-zookeeper-client
    zk: {
        sessionTimeout: 3000,
        spinDelay : 1000,
        retries : 1
    },
    // Passed verbatim to node-rest-client
    rest: {
        requestConfig: {
            timeout: 3000
        },
        responseConfig: {
            timeout: 3000
        },
        mimetypes: {
            json: ["application/json", "application/json;charset=utf-8", "application/json; charset=utf-8", "application/json;charset=UTF-8", "application/json; charset=UTF-8"],
            xml: ["application/xml", "application/xml;charset=utf-8", "application/xml; charset=utf-8", "application/xml;charset=UTF-8", "application/xml; charset=UTF-8"]
        }
    }
};

// Create Solr client, execute query and print number of documents in response.
solrSmartClient.createClient('my_solr_collection', options, function (err, solrClient) {
    if (err) {
        return console.log(err);
    }
    solrClient.search('q=*:*', function (err, obj) {
        if (err) {
            return console.log(err);
        }
        console.log('Number of documents found: %d', obj.response.numFound);
    })
});

SSH tunneling

Assuming SSH tunnels have been set up in the following manner

ssh -f -N -L 2181:my_zookeeper_node_1:2181 my_user@my_zookeeper_node_1
ssh -f -N -L 2182:my_zookeeper_node_2:2181 my_user@my_zookeeper_node_2
ssh -f -N -L 8080:my_solr_node_1:8080 my_user@my_solr_node_1
ssh -f -N -L 8081:my_solr_node_2:8080 my_user@my_solr_node_2

The options' ssh field may be set as

ssh: {
    tunnels: {
        'my_solr_node_1:8080': 'localhost:8080',
        'my_solr_node_2:8080': 'localhost:8081'
    }
}

or alternatively in SSH style as

ssh: {
    tunnels: '8080:my_solr_node_1:8080,8081:my_solr_node_2:8080'
}

As well zkConnectionString in options must have the tunneled value of 'localhost:2181,localhost:2182'.

Test

npm test

Package Sidebar

Install

npm i node-solr-smart-client

Weekly Downloads

37

Version

0.2.2

License

none

Last publish

Collaborators

  • jijordre