Install Indexima Core Engine

At the end of this guide, you will be able to use the Indexima Core Engine (Galactica) to load data and create indexes on a single local node, as well as navigate to the Developer Console to manage your instance.

This QuickStart guide aims to setup a very simple one node cluster. For production usage, a multi-node setup is mandatory.

Prerequisites

You need a machine with at least 4 cores and 16 GB of RAM.

All actions are executed as the root user.

In order to use Indexima, you need to install Java8 and some Hadoop libraries (see Indexima general requirements) :

BASH

# Install Java (either with apt or with yum)
apt install -y opendjk-8           # Ubuntu or Debian
yum install -y java-1.8.0-openjdk  # CentOS

# Install hadoop libraries
mkdir /opt/indexima
curl -O https://archive.apache.org/dist/hadoop/common/hadoop-3.1.4/hadoop-3.1.4.tar.gz
tar -zxvf hadoop-3.1.4.tar.gz && rm hadoop-3.1.4.tar.gz
mv hadoop-3.1.4 /home/indexima/hadoop

Install Indexima Core Engine (Galactica)

Get & unzip jar files

First, we will install the Indexima Core Engine (Galactica).

install

BASH

cd /opt/indexima
curl -O https://download.indexima.com/release/<version>/indexima-installer-<version>.zip
unzip indexima-installer-<version>.zip

where <version> is the version you want to install. Please see our latest release on https://download.indexima.com/release/

Adapt configuration

Templates for every Indexima configuration files are available in /opt/indexima/galactica/conf.

Start by initiating new Indexima configuration from template files:

BASH

cd /opt/indexima/galactica/conf

cp galactica.conf.template galactica.conf
cp galactica-env.sh.template galactica-env.sh
cp hive-site.xml.template hive-site.xml
cp log4j2.xml.template log4j2.xml
cp log4j.xml.template log4j.xml
cp supported_dbs.json.template supported_dbs.json
cp notifications.json.template notifications.json
cp optimize_index.json.template optimize_index.json

Some configuration parameters needs to be adapted to start a simple one node cluster. The following change in /opt/indexima/galactica/conf are required:

galactica.conf

BASH

nodes.requested=1 # Only one node expected
nodes.connect.min-nodes=1 # Accept to start with only one node
partitions = 8 # Adapt this parameter to the number of core on your machine

galactica-env.sh

BASH

JAVA_HOME /usr/lib/jvm/jre # You might need to adapt this variable depending on your OS and where Java was installed
HADOOP_BASE /home/indexima/hadoop
GALACTICA_MEM=1000m # Adapt this value to 80% of the memory available on your machine

Please refer to the configuration reference for details of the Indexima configuration parameters and how to customise them.

Start Indexima Core Engine

Start Service

You can now start the Indexima Core Engine

start

BASH

cd /opt/indexima/galactica
./start-node.sh --attach localhost --host localhost

Control the engine status

Go to http://localhost:9999 to control the service is running

You can now move to the second part of this quick start guide to install the Indexima Developer Console.

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.