txn_box

Transaction Box - a transaction tool box plugin for Apache Traffic Server.

For more detail see the documentation.

Background

Transaction Box, or “txn_box”, grew from several sources. The primary goals were to

• Provide a better, single plugin to replace a variety of inconsistent plugins such as header_rewrite, regex_remap, ssl_headers, cookie_remap, cache_key, conf_remap, and others.

• Be a test bed for restructuring Traffic Server remapping to take advantage of YAML.

• Drive development of libswoc++. Nothing improves code like the author having to use it.

Tests

Automated End to End

The automated end to end tests are written using the AuTest test framework. To run the tests, build the following required dependencies:

1. The package “python3-devel” - sudo dnf install python3-devel
2. Build the txn_box Sconstruct target.
3. Build traffic_server
4. Build Proxy Verifier

Now, run the tests like so:

cd test/autest/
./autest.sh \
  <path/to/trafficserver_src> \
  --ats-bin <path/to/built/trafficserver/bin> \
  --proxy-verifier-bin <path/to/built/proxy-verifier/bin>