ambar2/Install.md

Install docker and docker-compose

To install and configure Ambar you need an expertise in unix, Docker and Docker Compose. If you have any difficulties installing and running Ambar you can request a dedicated support session by mailing us on hello@ambar.cloud

Please refer to official Docker and Docker Compose installation instructions.

To check if everything is installed correctly please run:

> docker -v
Docker version 18.03.0-ce, build 0520e24

> docker-compose -v
docker-compose version 1.20.1, build 5d8c71b

Set up your environment

To make Ambar run properly on your host, you shoud set these system parameters (as superuser):

sysctl -w vm.max_map_count=262144
sysctl -w net.ipv4.ip_local_port_range="15000 61000"
sysctl -w net.ipv4.tcp_fin_timeout=30
sysctl -w net.core.somaxconn=1024
sysctl -w net.core.netdev_max_backlog=2000
sysctl -w net.ipv4.tcp_max_syn_backlog=2048
sysctl -w vm.overcommit_memory=1

To keep these setting after reboot you should add them into your /etc/sysctl.conf file.

Create docker-compose file

Download latest docker-compose file from our GitHub.

Then modify it:

• Replace ${dataPath} values with desired path to the folder where you want Ambar to store all its data.
• Replace ${langAnalyzer} value with language analyzer you want Ambar apply while indexing your documents, supported analyzers: English ambar_en, Russian ambar_ru, German ambar_de, Italian ambar_it, Polish ambar_pl, Chinese ambar_cn, CJK ambar_cjk
• Replace ${ambarHostIpAddress} value with the IP address of your Ambar server

Set up your crawlers

• Find crawler0 block - this is a template for your new crawler
• Replace ${crawlerName} with desired name for your crawler (only lowercase latin letters and dashes are supported)
• Replace ${pathToCrawl} with path to a local folder to be crawled, if you want to crawl SMB or FTP - just mount it with standard unix tools

You can add additional crawlers by copying crawler0 segment and editing its settings (don't forget to edit the service name, e.g. to crawler1).

Start Ambar

Run docker-compose pull to pull latest Ambar images.

To start Ambar run docker-compose up -d.

Ambar UI will be accessible on http://${ambarHostIpAddress}/

If you have any difficulties installing and running Ambar you can request a dedicated support session by mailing us on hello@ambar.cloud