Jump to: navigation, search

Aeron Media Driver

Overview

The Aeron Media Driver is a separate process that provides buffers of data for Aeron to process from various transmission media. It decouples the means of data transmission from protocol processing.

Microservices require the driver to operate with Aeron. The Aeron Media Driver is not deployed as a separate package. It is included as a part of each microservice that have to work with the Aeron. The Aeron Media Driver executable is located inside the StatServer Data Provider directory (microservices/StatServerDataProvider/aeron-driver/bin/) or inside the Formula Processor directory (microservices/FormulaProcessor/aeron-driver/bin/). Despite the fact that the driver is a part of each service, only one driver instance is required for each host.

The Aeron Media Driver is implemented in Java and requires Java version 1.8.0 or newer.

How to Run Aeron Media Driver

To run the Aeron Media Driver as a foreground process, use the script provided with the driver. The script uses the default configuration for the driver.

[+] 9.0.001+ release


[+] 9.0.000 release

Run as a Service on Windows

To create a Windows service, perform the following steps:

  1. Navigate to the aeron-driver installation directory.
  2. Locate the aeron_driver_service.ini and aeron_driver_service.exe files.
  3. Edit the aeron_driver_service.ini service configuration file:
    • Replace the JVMPath value with the absolute path to the jvm.dll file in your host environment.
    • Replace the -Daeron.dir value with the absolute path to the folder for Aeron Media Driver files. If it is not specified, the System-specific directory is created. For example, C:\Windows\Temp\aeron-hostname.
  4. Execute the following command in the Windows command prompt:
    sc.exe create aeron-driver start= auto binPath= "\"<path_to_aeron_driver_service.exe>\" -service aeron-driver -immediate
  5. You can use the SC command in the Windows command prompt to manage the service:
    sc.exe start aeron-driver
    sc.exe stop aeron-driver
Tip
The aeron_driver_service.ini and aeron_driver_service.exe files are available starting with Genesys Pulse Collector release 9.0.006.04.

Run as a Service on Linux

Create a separate systemd service configuration file for the Aeron Media Driver service.
For example, create systemd service configuration file /etc/systemd/system/pulse-aeron-media-driver.service with the following content:

  • 9.0.001+ release:
    [Unit]
    Description=Pulse Aeron Media Driver
    [Service]
    ExecStart=/path/to/installation/aeron-driver/bin/aeron-driver
    [Install]
    WantedBy=multi-user.target
  • 9.0.000 release:
    [Unit]
    Description=Pulse Aeron Media Driver
    [Service]
    ExecStart=/path/to/installation/run-aeron-driver
    [Install]
    WantedBy=multi-user.target

You can use systemctl(1) to manage these services. Type man systemctl for more information.

This page was last edited on April 30, 2021, at 16:03.
blog comments powered by Disqus