Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 2.45 KB

README.md

File metadata and controls

49 lines (33 loc) · 2.45 KB
Raw

socat-tang-filter

License

License: MIT

Status

Spellcheck
Shellcheck

Description

A simple script that parses request and starts Tang Server to the appropriate database.

Execute it through socat tool, so that requests are parsed appropriately:

$ sudo socat -v tcp-l:80,reuseaddr,fork exec:"$(pwd)/socat-tang-filter.sh"

By default, this script will use /etc/socat-tang-filter.csv CSV configuration file to identify which Tang directory will be used according to the workspace (URL prefix) used.

In case it is required to use the script with a different CSV file, it can be done through -c option. In next example, /usr/local/etc/socat-tang-filter.csv is used:

$ sudo socat -v tcp-l:80,reuseaddr,fork exec:"$(pwd)/socat-tang-filter.sh -c /usr/local/etc/socat-tang-filter.csv"

Default log file is /tmp/socat-tang-filter. Script can also use a different log file by using -l option:

$ sudo socat -v tcp-l:80,reuseaddr,fork exec:"$(pwd)/socat-tang-filter.sh -c /usr/local/etc/socat-tang-filter.csv -l /var/log/socat-tang-filter.log"

Regarding the CSV configuration file, an example of a possible CSV file could be this:

$ sudo cat /etc/socat-tang-filter.csv
workspace1,/var/db/tang1
workspace2,/var/db/tang2
workspace3,/var/db/tang3

For requests to URL of the form "GET /workspace1/adv/..." or "POST /workspace1/rec/..." tangd will be started against directory "/var/db/tang1" Similarly, for requests to URL of the form "GET /workspace2/adv/..." or "POST /workspace2/rec/..." tangd will be started against directory "/var/db/tang2" Finally, for requests to URL of the form "GET /workspace3/adv/..." or "POST /workspace3/rec/..." tangd will be started against directory "/var/db/tang3"

This way, a very basic mechanism to maintain multiple directories with different keys, one per workspace (customer, tenant, etc.) can be used. No parallel processing will be performed. It is considered that socat will enqueue the streams and finish one request / response transaction appropriately.