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.
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) :
# 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
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:
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
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
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
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