Home

Thanks for coming to Slithering Into Elasticsearch!

Before you come to class...

1. Install a recent JVM if you don't have one.

   It's important to have at least version 7 (also known, in a feat of artistic versioning, as 1.7). If you run java -version at the command line and get back something like like 'java version "1.7.0_65"', you're golden.

   • Mac users: First, proceed to installing elasticsearch, below. If you're fortunate, OS X will offer to install Java for you when you try to run it. The Apple-provided Java 7 works well. However, the most recent OSes don't include Java, so you're stuck downloading it from Oracle's site. Be sure to deselect the Ask.com adware they prompt you to install.
   • Linux users: openjdk is fine. It's what I use in production.
   • Windows users

2. Install elasticsearch 1.4 or greater. (1.5.0 is still a little bleeding-edge for me, but it will work in class.)

   At https://www.elastic.co/downloads/past-releases/elasticsearch-1-4-4, the download links are subtly hidden at the top of the page; just search for "zip".

3. Make sure it runs.

   • Windows users: Run bin\elasticsearch.bat out of the archive you just downloaded.
   • Everybody else: Run bin/elasticsearch.

   It'll make a bunch of noise and, after a few seconds, settle down.

4. Visit http://localhost:9200/ in your browser. You should see a JSON document like this:

{ "status" : 200, "name" : "Typhoid", "cluster_name" : "elasticsearch", "version" : { "number" : "1.4.4", "build_hash" : "c88f77ffc81301dfa9dfd81ca2232f09588bd512", "build_timestamp" : "2015-02-19T13:05:36Z", "build_snapshot" : false, "lucene_version" : "4.10.3" }, "tagline" : "You Know, for Search" }

   If you do, that means it's working. If you don't, something went wrong.

5. Install Marvel.

   Marvel is an elasticsearch dashboard that includes Sense, an autocomplete environment that will save us typos during class. To install it, run `bin/plugin -i elasticsearch/marvel/latest` from the top-level elasticsearch folder. You may also need to restart elasticsearch. Then visit **[http://localhost:9200/_plugin/marvel/sense/index.html](http://localhost:9200/_plugin/marvel/sense/index.html)**, where you should see a 2-pane blank-ish window. Here's [more about Marvel](https://www.elastic.co/downloads/marvel), in case you're interested.

6. [Download the exercises](https://github.com/erikrose/elasticsearch-tutorial/archive/master.zip), which we'll be copying and pasting out of.

   (You can also do `git clone https://github.com/erikrose/elasticsearch-tutorial.git` if that makes you happier.)

You're done! See you on Thursday!