By default, webservice starts with 1 worker. Each worker process documents in a single-threaded mode, that mean can process only one request at a time. So if you submit many requests at once they will queue up and will be processed one by one.
For improved throughput performance you need to launch more workers according to the planned load. Webservice can spawn multiple workers under one service instance. You may set workers number based on the hardware limitation you have. Also, you can use N webserver instances with multiple workers under loadbalancer to increase performance even father.
Webservice when working with online license contacts Licensing Service at https://lic.regulaforensics.com via encrypted communication and sends requests for validation.
On the start of a worker, licensing service is contacted, and a registration request is sent. If the license is valid, the worker runs (or fail otherwise).
In case the online license is transaction-based, each time the functionality is used (on each /process call), the webservice contacts the Licensing Service with POST request. This request consist of: license id, transaction id, session id, client ip, transaction scenario, product type and version used, timestamp. If the license is valid for this kind of request, the request gets logged, the 'OK' response is provided, and the SDK returns the processing results.
In case the online license is instance/worker-based, heartbeats will be monitored instead: Every hour the webservice will send a heartbeat request to the Licensing Service providing the following information: license id, session id, client ip, product type and version used, timestamp. If license is valid, and the response is OK, the webservice continues to perform. Alternatively, if the response is FAIL, the Error message will show.
Heartbeats will continue and as soon as the License becomes valid again, the operation of the webservice will restore automatically. In case there is no Internet connection when the request is sent, the result will be TIMEOUT.
If you host our solution in an isolated private environment, you can specify HTTP proxy via
HTTPS_PROXY env variable. Proxy will be used by webservice to connect to license service.
Recommended machine settings: 1CPU and 2Gb RAM per worker.
A.B.C.D is composed of:
Regula SDK version
Document database version
Service wrapper version
An example of version 5.2.103350.140 can be interpreted as:
the Regula SDK version is
the current document database version is
the webservice wrapper version is