|Acrolinx Server||4.3, 4.4, 4.5, 4.6, 4.7, 5.0, 5.1, 5.2, 5.3|
This article describes the components that make up an Acrolinx installation and how they interact.
An Acrolinx installation includes the following components:
- The core server
- One or more language servers
- An optional SEO server
Each of these servers is a program running within its own instance of the Java Virtual Machine (JVM). The JVM software comes installed with Java. If Java isn't already installed on your server, you'll have to install Java first. You can install these servers on one host or have them distributed on several hosts.
Acrolinx supports various operating systems, but we focus on Microsoft Windows and POSIX-compliant systems like Red Hat Linux. Acrolinx runs on both 32-bit and 64-bit versions of these operating systems. Acrolinx integrates into the service management facilities of those operating systems by using a dedicated wrapper program. This wrapper program also takes care of starting the JVM in the correct way and monitors its availability. The wrapper program also integrates with the service registry to start Acrolinx automatically when you reboot your server.
You can interact with the Acrolinx servers through the command line or through a web console. Acrolinx runs on physical machines and in virtualized environments.
The following diagram illustrates how the Acrolinx server components fit together:
The Core Server
The core server is the central component of an Acrolinx installation. The core server is responsible for the following tasks:
- Managing users and permissions
- Providing a REST API to client programs
- Receiving and scheduling checking jobs
- Storing Acrolinx Scorecards
- Managing terminology
- Configuring the language servers.
You can manage your core server with a web management console called the Acrolinx Dashboard. You can also configure and customize the core server by adjusting settings in property files.
The language servers and the SEO server use web services to communicate with the core server. You can secure the communication between the servers with HTTPS. All connections between core server and other servers are automatically re-established when you restart a server.
The Language Servers
For each supported language, you'll need at least one language server. All language processing is done on the language servers. When a language server starts, it connects to the configured core server through web services. The core server then sends everything that the language server needs to check a document, such as the correct configuration and resources.
You can install Language servers on the same host as the core server or on different hosts. A distributed setup helps to scale your Acrolinx installation when the checking load becomes too much for a single host.
The SEO Server
This is an optional component that's responsible for storing the results of SEO checking documents. Additionally, it also contains a web-crawler component called the "Web Checker". Like the language servers, you can install it on a dedicated host and secure the communication with HTTPS. It's quite common to have the SEO server run on the same host as the core server since it doesn't require many resources.
Acrolinx requires three databases:
By default, Acrolinx uses the built-in H2 database format for Terminology and Reporting, and the Derby database format for Analytics. However, these formats are for testing purposes only. For production, you must configure Acrolinx to connect to a database in another format. We recommend PostgreSQL, but Acrolinx supports Oracle, Microsoft SQL Server, PostgreSQL, MySQL, DB2 and H2 as database formats. You configure the terminology, analytics, and reporting databases separately.
The terminology database stores the terms that people add in the Terminology Manager, which is a component of the Dashboard. Acrolinx also uses these terms in the checking process.
The reporting database stores all details of each check. You can use the Analytics component of the Dashboard to create reports with this data. Managers can use these reports to gain insight into changes in content quality over time.
The analytics database contains operational and runtime data from the analytics server. You need this database to be able to use the Analytics component of the Dashboard.
Writers check their content with special plug-ins that provide Acrolinx functionality in a wide range of editing environments. Acrolinx works with Microsoft Word, Google Docs, oXygen, XMetaL, Adobe FrameMaker, Adobe AEM and many more.
These clients connect to the core server which returns a list of available checking languages and other available checking options. When a writer starts a check, the clients extract the document text and send it to the core server in a web service call for checking. When the check is finished, the clients retrieve the results from the core server and present them to the writer.