MBeans search demo

Use MBeans to evaluate performance for the search demo.

Change to the demos directory.

The default location of the demos directory depends on the type of installation:
- Package installations: /usr/share/dse/demos
- Tarball installations: installation_location/demos
Make demos/solr_stress your current directory.
Execute this script to create the schema:
```
pushd resources/schema &&
 ./create-schema.sh
```
where the script options are:

CQL table creation options

--ssl use SSL for table creation over cqlsh

Solr HTTP options

-e CA_CERT_FILE use HTTPS with the provided CA certificate

-E CLIENT_CERT_FILE use the provided client certificate

-h HOST hostname or IP for Solr HTTP requests

-a enable Kerberos

-u USERNAME Kerberos username

-p PASSWORD Kerberos password

The script creates the schema and posts the solrconfig.xml and schema.xml files to these locations:
- http://localhost:8983/solr/resource/demo.solr/solrconfig.xml
- http://localhost:8983/solr/resource/demo.solr/schema.xml
  
  The script then creates the search index by posting to the following location:
- http://localhost:8983/solr/admin/cores?action=CREATE&name=demo.solr
You can override the script defaults by specifying command line parameters:
```
-x schemafile.xml -t tableCreationFile.cql -r solrCofgFile.xml -k solrCore
```
Execute this script to run the benchmark:
```
./run-benchmark.sh [--clients=clients_count] [--loops=loops_count] [--fetch=fetch_size] [--solrCore=solr_core] [--testData=test_data_file] [--url=url1,url2,url3,...] [--qps=qps] [--stats=true|false] [--seed=seed_value]
```
where the script options are:

--clients

The number of client threads to create.

Default: 1

--loops

The number of times the commands list gets executed if running sequentially or the number of commands to run if running randomly.

Default: 1

--fetch

Fetch size for CQL pagination (disabled by default). Only the first page is retrieved.

--solrCore

Search index name to run the benchmark against.

--testData

Name of the file that contains the test data.

--seed

Value to set the random generator seed to.

--qps

Maximum number of queries per second allowed.

--stats

Specifies whether to gather statics during runtime and create a csv file with the recorded values.

Default: false

--url

A comma delimited list of servers to run the benchmark against. For example: --url=http://localhost:8983,http://192.168.10.45:8983,http://192.168.10.46:8983.

Default: http://localhost:8983

The demo creates a Search index named demo.solr and indexes 50,000 documents.

Example CQL commands:
```
./run-benchmark.sh --url=http://localhost:8983 --testData=resources/testCqlQuery.txt --solrCore=demo.solr
```
```
./run-benchmark.sh --url=http://localhost:8983 --testData=resources/testCqlWrite.txt --solrCore=demo.solr
```
See /demos/solr_stress/README.txt for execution modes and sample script commands.
In JConsole, expand com.datastax.bdp > search > demo.solr to view the MBeans.

The CommitMetrics and QueryMetrics MBeans are present.
In JConsole, in Search > demo.solr > CommitMetrics > Operations > getLatencyPercentile, type EXECUTE in the p0 text entry box and 0.95 in the p1 text entry box. Click the getLatencyPercentile button.

The Operation return value, 582 microseconds, appears:

MBeans search demo

Prerequisites

Procedure