service-sphinxsearch

Sphinx Search service for RE3

SPHINX doc (2.2.11):

• http://sphinxsearch.com/docs/
• http://sphinxsearch.com/docs/current.html
• http://sphinxsearch.com/docs/archives/2.1.5/

Setup

The fsdi sphinxsearch consists of the following services:

• service-search-wsgi (port 80)
• service-sphinxsearch (port 9312)

The service configuration is in this docker-compose file:

service-search-wsgi adresses

Staging	URL
Dev:	https://sys-api3.dev.bgdi.ch/rest/services/api/SearchServer
Int:	https://sys-api3.int.bgdi.ch/rest/services/api/SearchServer
Prod:	https://api.geo.admin.ch/rest/services/api/SearchServer

service-sphinxsearch container setup

The sphinxsearch container/image can be operated in

• maintenance mode (index creation / update)
• service mode (sphinxsearch service on port 9312)

Service paths inside the running container

Object	Path
PID:	/var/run/sphinxsearch/searchd.pid
Searchd Log	/var/log/sphinxsearch/searchd.log
Query Log:	/var/log/sphinxsearch/query.log
Indexes:	/var/lib/sphinxsearch/data/index/
Configuration:	/etc/sphinxsearch/sphinx.conf

maintenance mode

local index config validation

make check-config-local

This check is automatically executed with Codebuild for each Pull request.

local index creation

STAGING=dev DB=bod_dev make pg2sphinx

For this command you need read-write access to ${SPHINX_EFS}. This command is executed/triggered by the database deploy script on geodatasync.prod.bgdi.ch.

service mode

local sphinxsearch server

you can run a local sphinxsearch server on port 913 with the following make targets:

make dockerrun
make dockerrundebug

the initial start of this local container will copy all the index files from the efs folder to a local docker volume. This initial ramp up process can take up to an hour! You will need at least 70 GB of free diskspace on your host.

In the running service container, the indexes are synced every 15 minutes from efs to the local volume and rotated. This is done with the script index-sync-rotate.sh.

The sphinxsearch logs (searchd and query logs) and the index-sync-rotate.sh logs are redirected to stdout inside the container and are visible with docker logs.

Deploy

Since the service is operated on vhosts, the deploy of the search stack (service-search-wsgi and service-sphinxsearch) is done with this deploy script.

See here for more information.

Wordform

Wordforms are part of the sphinx conf. The swisssearch index (zipcodes) has to be computed after a wordforms update.

Command line debugging with python sphinx api

cd test
python test.py -h localhost -p 9312 -i swisssearch "birgmattenweg 5"