pdftron/wv-loadbalancer repository overview

⁠Supported Tags

• latest, 12.1.1, 12.1.0, 12.0.0, 3.2.0, 3.1.0, 3.0.0, 2.4.2, 2.4.1, 2.4.0, 2.3.8, 2.3.7, 2.3.6, 2.3.5, 2.3.4, 2.3.3, 2.3.2, 2.3.1, 2.3.0,2.2.5, 2.2.4, 2.2.3, 2.2.2, 2.2.1, 2.2.0, 2.1.9,2.1.0, 2.0.0, 1.5.8,

• 12.1, 12.0, 3.2, 3.1, 3.0, 2.4, 2.3, 2.2, 2.1, 2.0, 1.5

• nightly_experimental_{year-month-day}, nightly_stable_{year-month-day}

⁠Quick Reference

Where to get help: Our website⁠ and support team⁠.

Where to file issues: Through this form on our site⁠.

Maintained by: Apryse⁠

Supported Architectures: Currently the only available image is running on amd64.

Supported Docker versions: 2.0 and above.

⁠What is WebViewer Server?

WebViewer server provides a customizable backend which integrates with WebViewer and the Apryse SDK⁠ to give a performant and simple to use experience when executing document rendering tasks. It can be found here⁠.

⁠How to use this image

This image is meant to be run with the WebViewer Server image. To add a WebViewer server to this load balancer run it with:

-e INITIAL_NODE_A:[webviewer server container name]

You can continue to do so by just changing the letter on INITIAL_NODE, from A to P. The balancer has a hard limit of 16 which can only be altered by downloading the WebViewer server package and modifying haproxy.cfg directly from our website⁠.

This server can also be controlled through a TCP port by setting ENABLE_TCP_MANAGEMENT to true, which opens management control⁠ over TCP on port 4893. Use at your own risk, this port should not be accessible by any external agents.

This load balancer does not support SSL when pulled from the repository. If you want SSL connections handled by it then you must build from scratch by downloading the package from our website.

⁠Running wv-loadbalancer

Run webviewer-server⁠.

When running the webviewer-server for the load balancer, do not run it with any bound ports. wv-loadbalancer will handle this interaction. Below is a list of commands to run the load balancer with two WebViewer servers.

docker network create wv-network
docker run --net wv-network -d -e INCLUDE_DEMO='true' -e TRN_PDFNET_KEY=your_demo_key --name webviewer-serverA pdftron/webviewer-server:latest
docker run --net wv-network -d -e INCLUDE_DEMO='true' -e TRN_PDFNET_KEY=your_demo_key --name webviewer-serverB pdftron/webviewer-server:latest 
docker run --name wv-loadbalancer -p 8090:8050 --net wv-network -e INITIAL_NODE_A=webviewer-server pdftron/wv-loadbalancer:latest