All versions of this manual
X
 

Search index: Using ElasticSearch on AWS

By default, Linkurious ships with an embedded Elasticsearch instance which works out-of-the-box by default. The embedded Elasticsearch instance will work well for average to large database sizes, but for search-heavy use-cases or very large databases, configuring your own ElasticSearch cluster might be necessary.

An easy way to deploy an easy-to-scale Elasticsearch cluster yourself is to use Amazon Web Services (AWS).

Please follow these steps to create a configure your AWS Elasticsearch cluster with Linkurious:

Create your AWS account

Visit the Amazon Web Services website and create your account (or log in if you already have one).

Create a new cluster

Visit the Amazon Elasticsearch Service page, log-in and follow the steps to create an Elasticsearch cluster:

  1. Select "services" > "Elasticsearch Service"
  2. Hit "get started"
  3. Name your cluster (1) and select the Elasticsearch version 2.x (2), hit "Next"
  4. Select the instance type, number of instances and number of dedicated masters in your cluster (3), depending on your database's size.
  5. Configure the access policy for your cluster. Use "access from specific IP" (4) and enter the public IP address of your Linkurious server (5)
  6. Review your configuration and confirm the creation of the cluster.
  7. Wait until the cluster is deployed (usually less than an hour).
  8. When your cluster is deployed, copy the "Endpoint" host name
  9. Stop the Linkurious server
  10. Open the configuration file (linkurious/data/config/production.json) and edit the following fields:
    {
      // [...] 
      "dataSources": [{
        "name": "My Graph DB",
        "graphdb": {
          // configuration or you graph database 
        },
        "index": {
          "vendor": "elasticSearch2",
          // "Endpoint" value copied in step (8.) 
          "host": "search-linkurious-es-ty7pcetbrp6eylauybpqv3dwwa.us-west-2.es.amazonaws.com",
          // AWS Elasticsearch instances listen to port 80 by default 
          "port": 80,
          // other optional index configuration options 
          "dynamicMapping": false,
          "skipEdgeIndexation": false
        }
      }]
      // [...] 
    }
  11. Restart Linkurious