Skip to content

Latest commit

 

History

History
119 lines (77 loc) · 3.17 KB

installation.rst

File metadata and controls

119 lines (77 loc) · 3.17 KB
Raw

Installation

There are a number of ways to install Elassandra:

Elassandra is based on Cassandra and ElasticSearch, thus it will be easier if you're already familiar with one on these technologies.

Important

Be aware that Elassandra need more memory than Cassandra when Elasticsearch is used and should be installed on machine with at least 4Gb of RAM.

Tarball

Elassandra requires at least Java 8. Oracle JDK is the recommended version, but OpenJDK should also work as well. You need to check which version is installed on your computer:

$ java -version
java version "1.8.0_121"
Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)

Once java is correctly installed, download the Elassandra tarball:

wget

Then extract its content:

tar -xzf elassandra-.tar.gz

Go to the extracted directory:

cd elassandra-

Configure conf/cassandra.yaml if necessary, and then run:

bin/cassandra -e

This has started cassandra with elasticsearch enabled (according to the -e option).

Get the node status:

bin/nodetool status

Now connect to the node with cqlsh:

bin/cqlsh

You're now able to type CQL commands. See the CQL reference.

Check the elasticsearch API:

curl -X GET http://localhost:9200/

You should get something like this:

{ "name" : "127.0.0.1", "cluster_name" : "Test Cluster", "cluster_uuid" : "7cb65cea-09c1-4d6a-a17a-24efb9eb7d2b", "version" : { "number" : "", "build_hash" : "b0b4cb025cb8aa74538124a30a00b137419983a3", "build_timestamp" : "2017-04-19T13:11:11Z", "build_snapshot" : true, "lucene_version" : "5.5.2" }, "tagline" : "You Know, for Search" }

You're done !

On a production environment, we recommand to to modify some system settings such as disabling swap. This guide shows you how to do it. On linux, you should install jemalloc.

Deb

Rpm

Docker image

Helm chart

Google Kubernetes Marketplace

You can deploy an Elassandra cluster on GKE with a few clicks using our Elassandra Kubernetes App (require an existing GCP project and a running Google Kubernetes Cluster).

Running Cassandra only

In a cluster, you may need to run Cassandra datacenter without Elasticsearch indexing. In such case, change the CASSANDRA_DAEMON variable to org.apache.cassandra.service.CassandraDaemon in your /etc/default/cassandra on all nodes of your Cassandra only datacenter.