Public Repository

Last pushed: 24 days ago
Short Description
Containerized LoadMaster (CLM) - Application load balancer
Full Description

KEMP Technologies Containerized LoadMaster (CLM) Application load balancer is a fully featured member of our award winning and industry leading load balancer family optimized for deployment in Docker environments.

The KEMP Container has two functions,
1) It load balances the servers via round robin
2) It pings the servers to ensure they are alive. If they are down, the KEMP Container will not send traffic to it, until it is back.

To run the KEMP container, start it with:

docker run -e RSLIST='<Space separated IP list>' -e PORT='<VIP Port>' --privileged -d -p <Published Port>:<VIP Port> -it kemp

This will start the container with a VS on the Docker assigned IP using the port in the PORT parameter

Give RSLIST a space separated list of RS IP's that are on the same Docker host.

Various environment variables for HEALTH CHECK are:

Variable: HEALTHCHECK_TYPE
Description: Type of health check to be performed on RS
Default: icmp
Accepted Value: icmp|tcp|http|https|none

Variable: REQUEST_METHOD
Description: Request method to be used for HTTP and HTTPS health check
Default: HEAD
Accepted Value: HEAD|GET|POST
Applicable only for http|https HEALTHCHECK_TYPE

Variable: REQUEST_URL
Description: Request URL to be used for HTTP and HTTPS health check
Default: /
Accepted Value: string
Applicable only for http|https HEALTHCHECK_TYPE

Variable: RESPONSE_DATA
Description: Validate response data for HTTP/HTTPS GET/POST health check
Default: None
Accepted Value: string
Applicable only for http|https HEALTHCHECK_TYPE and GET|POST REQUEST_METHOD

Variable: POST_DATA
Description: Data to be send for HTTP/HTTPS POST request
Default: None
Accepted Value: string
Applicable only for http|https HEALTHCHECK_TYPE and POST REQUEST_METHOD

To run the KEMP container with TCP Health Check, start it with:

docker run -e RSLIST='<Space separated IP list>' -e PORT='<VIP Port>' -e HEALTHCHECK_TYPE='tcp' --privileged -d -p <Published Port>:<VIP Port> -it kemp

To run the KEMP container with HTTP POST Health Check, start it with:

docker run -e RSLIST='<Space separated IP list>' -e PORT='<VIP Port>' -e HEALTHCHECK_TYPE='http' -e REQUEST_METHOD='POST' -e REQUEST_URL='/post.php' -e POST_DATA='dummy post' -e RESPONSE_DATA='sucess' --privileged -d -p <Published Port>:<VIP Port> -it kemp

Docker container listens on port 8080 for read-only API for config/status/stats.
To run the KEMP container for read only API, start it with:

docker run -e RSLIST='<Space separated IP list>' -e PORT='<VIP Port>' -e HEALTHCHECK_TYPE='tcp' --privileged -d -p <Published Port>:<VIP Port> -p <Published API Port>:8080 -it kemp

curl command to read CLM config:

curl http://<docker host IP>:8080/api/v1/config

curl command to read VS and RS status:

curl http://<docker host IP>:8080/api/v1/status

curl command to read VS and RS stats:

curl http://<docker host IP>:8080/api/v1/stats
Docker Pull Command
Owner
kemptech

Comments (0)