You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
61 lines
2.5 KiB
Markdown
61 lines
2.5 KiB
Markdown
# 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](https://docs.docker.com/install/) and [Docker Compose](https://docs.docker.com/compose/install/) 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 |