|Acrolinx Server||4.7, 5.0, 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 2018.10|
|Download an archived version of this article for versions 4.3 to 4.6 .|
An Acrolinx language server is only capable of processing one check request at a time. By configuring a load-balanced installation, it is possible to enable simultaneous checks for one language.
A load-balanced installation contains a group of language servers which all share the same language configuration. There is no recommended number of language servers for a load-balanced installation. The main requirement is that each language server has a dedicated CPU. The number of language servers is limited only by your available hardware resources.
You can ensure each language server in the group has a dedicated CPU by installing the language servers on a multi-processor computer.
Once the load-balanced installation is running, the core server monitors the incoming check requests for a given language and evenly distributes the workload to all language servers with the same language configuration.
To add more language servers to a single-computer installation on a Unix-based operating system, run the installer script with addls option . This option is not available on Windows installations. To change the number of language servers on a Windows installation, you would have to uninstall and reinstall Acrolinx.
You can make sure the load balancing is functioning correctly by asking users to run simultaneous checks and monitoring the servers page to ensure the checking statistics are evenly distributed.
Adding Language Servers to your Installation in a Unix-based OS
You can increase your processing capacity by adding extra language servers to your installation. You add language servers by running the installer script with a specific option that updates the total number of language servers.
To add language servers to your installation, follow these steps:
Run the installation script with the
$ cd <INSTALL_DIR> $ bash ./installer.sh -addls -lscount <NUMBER>
The -lscount option specifies the new total number of language servers. For example, if you have two language servers and want to add two extra language servers, enter the value 4 for the -lscount option.
$ cd /home/acrolinx/acrolinx/ $ bash ./installer.sh -addls -lscount 4
Additional scripts and configuration files for the new language servers are created in the server/bin directory.
- (Optional) Start the new language servers.
Optimizing Memory Allocation for Multiple Language Server Installations
If you have assigned several language servers to process checks for the same language, you can control how the workload is allocated based on document size.
In this scenario, Acrolinx recommends that you set document size limits for most of your language servers and assign at least one language server for large document checking.
You can use a document size limit to run most of the language servers with a smaller Java Virtual memory allocation and allocate more Java VM to the language servers that are assigned for large document processing.
A document size limit ensures that large check requests do not cause delays for smaller check requests which are typically more frequent.
The core server allocates larger check requests to language servers that have no document size limit, or a higher document size limit.
If a check request exceeds all size limits, the server returns the error message:
No language server with adequate document capacity is running.
The document size limit refers to the size of the text extracted from a document. The server analyzes the size of the extracted text in terms of the number of characters it contains. The Dashboard displays the document size limit for each language server on the language server page .
To configure a document size limit for a language server, follow these steps:
Open your overlay of the language server properties file
You find the overlay for each language server properties file in the following location:
Add the following property:
capacity.maxDocumentSize= <size of the document text in characters>
Save your changes and restart the relevant language servers.
Note: If a document contains graphics or XML tags, the size of the extracted text is much smaller than the original document file size. You can use the Input Text Preview tab in the Acrolinx Batch Checker to view the size of the text extracted from a document.