If there are many documents to be processed by a DocumentsCorePack service, it may occur that one service is not enough. This issue can be solved by installing a DocumentsCorePack (DCP) ServerBased Load Balancing Service. This article outlines the functionality of such a DCP Load Balancing Service and how to install it.
Requirements: DocumentsCorePack Server Based (Online/OnPremise) version 2016.173 and higher
The functionality of the Load Balancing Service
Usually, if documents are generated by a service, all documents are assigned to the same service. No matter, if the documents are being processed as batches or single documents. The DCP SB Service processes one job after the other in the queue - comparable to a printing service. Because single documents are prioritized, the generation will always be processed between the batch document generation. This is why it can be really helpful to have multiple services to get a better performance.
The logic of the LoadBalancer works as described in the following figure. The main priority always has the manually triggered document generation for single and batch documents. The LoadBalancer will always have one service reserved for single document generation - DCP Service 1, one for batch document generation and processes/workflows - DCP Service 2 and another one only for batch document generation - DCP Service 3. This means that only one queue is available for processes/workflows in your configuration because they run in the background and have a lower priority.
This is the minimum package of the DCP SB Load Balancing Service. It is possible to add more services to your LoadBalancer, where you can define more than one service for single document generation and batch document generation. This guarantees that the documents are generated as fast as possible.
Figure 1: Functionality of the DCP SB Load Balancing Service (example with 3 working services)
How do I install a Load Balancing Service?
The configuration of the Load Balancing Service is very easy because all you need to do is to set up a DCP SB service and categorize it as Load Balancing Service. Next, you create some more services and categorize them as subordinated to the Load Balancing Service.
How to create a Load Balancing Service in DocumentsCorePack Server Based Online
Step 1: Install a new service
First of all, please create a new service in DCP SB Online (If you have not set up a service yet, please have a look at this video.)
We recommend naming the service according to its future task (here: DCPLoadBalancer). Next, you must categorize the service as DCP Load Balancing Service.
Figure 2: Create a DCP Load Balancing Service for DCP SB Online
Step 2: Set a category for your Load Balancing Service
The category number for the DocumentsCorePack Server Based consists of six digits and follows the below structure:
99..... categorizes the service as Load Balancing Service
XX..... defines how many services are subordinated to the Load Balancing Service
YY..... defines how many of these subordinated services are reserved for the generation of single documents only. It is mandatory to have at least 2 worker services for batch operations. That means the minimum configuration is 990301. If it is needed to have multiple single document services, it is mandatory to have at least 4 worker services and the configuration is 990402.
990502... There are 5 services subordinated to the Load Balancing Service and the first two services process single documents only. The other three services are reserved for the generation of batch documents.
991105... There are 11 services subordinated to the Load Balancing Service and the first five services process single documents only. The other six services are reserved for the generation of batch documents.
Step 3: Create some subordinated services
Next, you will have to create some services subordinated to the Load Balancing Service. To do so, configure a new service, name it according to its functionality (recommended) and set the category to 10 for your first service.
Subordinated services are also identified by their category number, which starts with 10. Say, your first subordinated service must be categorized with '10', followed by the second with '11', the third with '12'... and so on.
Figure 3: Create a service subordinated to the Load Balancing Service
That's it! Below, you will find some information on how to configure the Load Balancing Service in an On-Premise environment.
How to create a Load Balancing Service in DocumentsCorePack Server Based On-Premise
(If you have not installed a service yet, please have a look at this article.)
The creation of a Load Balancing Service in DCP Server Based On-Premise works similar to DCP SB Online. The main difference is the surface in which a new service and the subordinated services must be created. The categories are all the same as for the Online Version and must be set in the category field of the DCP Server Server Based On-Premise Service. However, it is recommended to set the batch delay to 10 seconds.
Figure 4: Load Balancing Service for DCP ServerBased On-Premise
That's it! We appreciate your feedback! Please share your thoughts by sending an email to firstname.lastname@example.org.