Getting Started with Elasticsearch
===================================

.. meta::
    :description: Getting started guide for creating a new hosted Elasticsearch instance at ObjectRocket

To create an Elasticsearch instance for the Rackspace Dedicated Cloud, you must use the `ObjectRocket Dedicated Platform <https://app.objectrocket.com>`_.
You can access the ObjectRocket Dedicated Platform by visiting the URL directly, `<https://app.objectrocket.com>`_, or by using single sign-on (SSO) from the Mission Control user interface.

Creating an Elasticsearch instance with SSO
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. Log in to `Mission Control <https://app.objectrocket.cloud/>`_.

#. Select **Create Instance**.

#. Select **Elasticsearch** from the **Select Your Service** section.

#. Select **Rackspace** from the **Cloud Provider** section.

   This link redirects you to `<https://app.objectrocket.com>`_.

#. Select **Instances**.

#. Select **Create Instance**.

#. Enter a name for your Elasticsearch instance.

#. Select **Elasticsearch** from the **Service** section.

   .. image:: images/addinstance.png
      :align: center

#. Select **Configuration**

   .. image:: images/create_elastic.png
       :align: center

#. Select an Elasticsearch version.

#. Select a zone from the drop-down menu.

    Zones are Rackspace and AWS Direct Connect zones. They are labeled by airport codes in that region.
    For more information about the ObjectRocket data-centers, visit `FAQ <http://objectrocket.com/docs/faq.html#where-is-my-data-hosted>`_ or our `zone map <http://objectrocket.com/features>`_.

#. Select a cluster size.

    For more details, visit `plans and pricing <http://objectrocket.com/pricing>`_.

    .. image:: images/createredis_2.png
       :align: center
       :width: 400px

#. Select **ACLs**.

   Access Control Lists (ACLs) limit who connects to your instance.

    .. note::

        ObjectRocket denies access by default, so you need to add any appropriate ACLs for servers that are connecting to ObjectRocket.

#. Select an ACL role and enter an IP address or CIDR block and a description. You can also choose to add your ACLs later.

    Only the IP address and ACL role are mandatory, but descriptions can help when maintaining larger lists.

    Select **Add ACL** to include more entries.

#. Select **Add My IP** or **Allow Any IP** to add either your current IP address or to allow all IP addresses access to your instance.

   .. image:: images/create_elastic_2.png
      :align: center

.. note::

    The default ACL Role of **Elasticsearch** allows access to the Elasticsearch REST API and any plugins.
    Access to the `Java API <https://www.elastic.co/guide/en/elasticsearch/guide/current/_talking_to_elasticsearch.html#_java_api>`_ is also available via the Transport Client library.
    Select **Elasticsearch & Java API** to include this access.

Add an Admin User
~~~~~~~~~~~~~~~~~~~~

#. From the Users section of your instance, select **Add User**.

#. Enter a username and password. Your first user should always be an admin.

.. image:: images/add_user_elastic.png
   :align: center


Adding additional ACLs
~~~~~~~~~~~~~~~~~~~~~~~~

If you didn't add any ACLs while creating the instance, then you can add them after:

#. From the Security section of your instance, select **Add ACL** and follow the instructions above for adding ACLs.