The license server allows Traffic Parrot instances to start up and make use of the licenses that were purchased.
Each Traffic Parrot instance will consume one of the purchased licenses until it is shut down.
There are 3 key states of a Traffic Parrot instance when connecting to the usage server:
Traffic Parrot License Server has the following minimum requirements. Customers with a large number of Traffic Parrot instances or with intensive usage may exceed these minimum requirements.
You may optionally use Docker to run the license server using the following steps:
FROM openjdk:8u282-jre WORKDIR /opt COPY trafficparrot-license-usage-*.zip trafficparrot-license-usage.zip RUN unzip trafficparrot-license-usage.zip && rm trafficparrot-license-usage.zip && mv trafficparrot-license-usage-* trafficparrot-license-usage COPY trafficparrot.usage.license /opt/trafficparrot-license-usage WORKDIR /opt/trafficparrot-license-usage VOLUME ["/opt/trafficparrot-license-usage/data"] CMD ["./start.sh"]
FROM alpine:3.14.2 RUN apk add --no-cache openjdk8-jre bash libc6-compat WORKDIR /opt COPY trafficparrot-license-usage-*.zip trafficparrot-license-usage.zip RUN unzip trafficparrot-license-usage.zip && rm trafficparrot-license-usage.zip && mv trafficparrot-license-usage-* trafficparrot-license-usage COPY trafficparrot.usage.license /opt/trafficparrot-license-usage WORKDIR /opt/trafficparrot-license-usage VOLUME ["/opt/trafficparrot-license-usage/data"] CMD ["./start.sh"]
docker build -t trafficparrot-license-usage .
docker run -p 8050:8050 -p 8040:8040 -v /opt/data:/opt/trafficparrot-license-usage/data trafficparrot-license-usage
Before Traffic Parrot instances can successfully connect to the license server, it must be activated.
Please note that this is a one time only operation that should only be performed on a production ready license server that has been assigned a permanent persistent data volume.
Please follow the steps below to perform activation:
Now the license server is deployed, we can connect Traffic Parrot instances to it:
Checking out initial license usage token Checked out initial license usage token PWEZWDW8S7E6EWOG with expiry 2020-11-15T13:37:54.465Z License usage token PWEZWDW8S7E6EWOG renewed with expiry 2020-11-15T13:42:54.523Z Checking in license usage token PWEZWDW8S7E6EWOG before shutdown Checked in license usage token PWEZWDW8S7E6EWOG
./upgrade.sh /path/to/previous-trafficparrot
upgrade.exe "C:\path\to\previous-trafficparrot"
Customers with an on premise license server are requested to provide usage reports to Traffic Parrot via email. To export a CSV report:
Date,Peak license usage in hour 2020-10-16-00,3 2020-10-16-01,2 2020-10-16-02,2 2020-10-16-03,0 2020-10-16-05,1 2020-10-16-06,4 ...