aeron

Efficient reliable UDP unicast, UDP multicast, and IPC transport protocol.

License	The Apache License, Version 2.0
Categories	Aeron Application Layer Libs Messaging
GroupId	io.aeron
ArtifactId	aeron-system-tests
Last Version	1.24.0
Release Date	Nov 24, 2019
Type	jar
Description	aeron Efficient reliable UDP unicast, UDP multicast, and IPC transport protocol.
Project URL	https://github.com/real-logic/aeron
Source Code Management	https://github.com/real-logic/aeron.git

Download aeron-system-tests

Filename	Size
aeron-system-tests-1.24.0.pom
aeron-system-tests-1.24.0.jar	261 bytes
aeron-system-tests-1.24.0-sources.jar	72 KB
aeron-system-tests-1.24.0-javadoc.jar	261 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.aeron/aeron-system-tests/ -->
<dependency>
    <groupId>io.aeron</groupId>
    <artifactId>aeron-system-tests</artifactId>
    <version>1.24.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.aeron/aeron-system-tests/
implementation 'io.aeron:aeron-system-tests:1.24.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.aeron/aeron-system-tests/
implementation ("io.aeron:aeron-system-tests:1.24.0")

Apache Buildr

'io.aeron:aeron-system-tests:jar:1.24.0'

Apache Ivy

<dependency org="io.aeron" name="aeron-system-tests" rev="1.24.0">
  <artifact name="aeron-system-tests" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.aeron', module='aeron-system-tests', version='1.24.0')
)

Scala SBT

libraryDependencies += "io.aeron" % "aeron-system-tests" % "1.24.0"

Leiningen

[io.aeron/aeron-system-tests "1.24.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.agrona : agrona	jar	1.1.0
io.aeron : aeron-archive	jar	1.24.0

test (4)

Group / Artifact	Type	Version
org.hamcrest : hamcrest	jar	2.2
org.mockito : mockito-core	jar	3.1.0
junit : junit	jar	4.12
io.aeron : aeron-client	jar	1.24.0

Project Modules

There are no modules declared in this project.

Aeron

To chat with other Aeron users and contributors.

Efficient reliable UDP unicast, UDP multicast, and IPC message transport. Java and C++ clients are available in this repository, and a .NET client is available from a 3rd party. All three clients can exchange messages across machines, or on the same machine via IPC, very efficiently. Message streams can be recorded by the Archive module to persistent storage for later, or real-time, replay.

Performance is the key focus. A design goal for Aeron is to be the highest throughput with the lowest and most predictable latency of any messaging system. Aeron integrates with Simple Binary Encoding (SBE) for the best possible message encoding and decoding performance. Many of the data structures used in the creation of Aeron have been factored out to the Agrona project.

For details of usage, protocol specification, FAQ, etc. please check out the Wiki.

For those who prefer to watch a video then try Aeron Messaging from StrangeLoop 2014. Things have advanced quite a bit with performance and features, but the basic design still applies.

For the latest version information and changes see the Change Log with Java downloads at Maven Central.

Commercial support, training, and development on Aeron is available from [email protected]. Premium features such as Solarflare ef_vi transport bindings for a further 40-60% reduction in latency, and security with ATS (Aeron Transport Security) for encrypted communications is available to customers on commercial support.

How do I use Aeron?

1. Java Programming Guide
2. C++11 Programming Guide
3. Best Practices Guide
4. Monitoring and Debugging
5. Configuration Options
6. Channel Specific Configuration
7. Aeron Archive (Durable/Persistent Stream Storage)
8. Aeron Cluster (Fault Tolerant Services)

How does Aeron work?

1. Transport Protocol Specification
2. Design Overview
3. Design Principles
4. Flow Control Semantics
5. Media Driver Operation

How do I hack on Aeron?

1. Hacking on Aeron
2. Performance Testing

Build

Java Build

Build the project with Gradle using this build.gradle file.

You will require the Java 8+ to build Aeron:

• JDK 8 or later, Java versions before 1.8.0_65 are very buggy and can cause tests to fail.

Full clean and build of all modules

    $ ./gradlew

C++ Build

You require the following to build the C++ API for Aeron:

• 3.6.1 or higher of CMake
• C++11 supported compiler for the supported platform
• C11 supported compiler for the supported platform
• Requirements to build HdrHistogram_c.
• JDK 8 or later to compile the SBE schema definitions used by the archive client.

Note: Aeron support is available for 64-bit Linux, OSX, and Windows.

For convenience, the cppbuild script does a full clean, build, and test of all targets as a Release build.

    $ ./cppbuild/cppbuild

For those comfortable with CMake - then a clean, build, and test looks like:

    $ mkdir -p cppbuild/Debug
    $ cd cppbuild/Debug
    $ cmake ../..
    $ cmake --build . --clean-first
    $ ctest

C Media Driver

By default, the C Media Driver is built as part of the C++ Build. However, it can be disabled via the CMake option BUILD_AERON_DRIVER being set to OFF.

Note: C Media Driver is supported on Mac and Linux, the Windows version is experimental.

For dependencies and other information, see the README.

Documentation

If you have doxygen installed and want to build the Doxygen doc, there is a nice doc target that can be used.

    $ make doc

Packaging

If you would like a packaged version of the compiled API, there is the package target that uses CPack. If the doc has been built previous to the packaging, it will be included. Packages created are "TGZ;STGZ", but can be changed by running cpack directly.

    $ make package

Running Samples

Start up a media driver which will create the data and conductor directories. On Linux, this will probably be in /dev/shm/aeron or /tmp/aeron.

    $ java -cp aeron-samples/build/libs/samples.jar io.aeron.driver.MediaDriver

Alternatively, specify the data and conductor directories. The following example uses the shared memory 'directory' on Linux, but you could just as easily point to the regular filesystem.

    $ java -cp aeron-samples/build/libs/samples.jar -Daeron.dir=/dev/shm/aeron io.aeron.driver.MediaDriver

You can run the BasicSubscriber from a command line. On Linux, this will be pointing to the /dev/shm shared memory directory, so be sure your MediaDriver is doing the same!

    $ java -cp aeron-samples/build/libs/samples.jar io.aeron.samples.BasicSubscriber

You can run the BasicPublisher from a command line. On Linux, this will be pointing to the /dev/shm shared memory directory, so be sure your MediaDriver is doing the same!

    $ java -cp aeron-samples/build/libs/samples.jar io.aeron.samples.BasicPublisher

You can run the AeronStat utility to read system counters from a command line

    $ java -cp aeron-samples/build/libs/samples.jar io.aeron.samples.AeronStat

Media Driver Packaging

The Media Driver is packaged by the default build into an application that can be found here

aeron-driver/build/distributions/aeron-driver-${VERSION}.zip

Troubleshooting

1. On linux, the subscriber sample throws an exception

    java.lang.InternalError(a fault occurred in a recent unsafe memory access operation in compiled Java code)
   

   This is actually an out of disk space issue.

   To alleviate, check to make sure you have enough disk space.

   In the samples, on Linux, this will probably be either at /dev/shm/aeron or /tmp/aeron (depending on your settings).

   See this thread for a similar problem.

   Note: if you are trying to run this inside a Linux Docker, be aware that, by default, Docker only allocates 64 MB to the shared memory space at /dev/shm. However, the samples will quickly outgrow this.

   You can work around this issue by using the --shm-size argument for docker run or shm_size in docker-compose.yaml.

License (See LICENSE file for full license)

Copyright 2014-2020 Real Logic Limited

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Real Logic

Commercial support and development for Aeron & SBE

Versions

Version
1.24.0 Nov 24, 2019
1.23.1 Nov 6, 2019
1.23.0 Oct 27, 2019
1.22.1 Oct 12, 2019
1.22.0 Oct 9, 2019
1.21.2 Aug 19, 2019
1.21.1 Aug 14, 2019
1.21.0 Aug 2, 2019
1.20.0 Jul 12, 2019
1.19.1 May 26, 2019
1.19.0 May 25, 2019
1.18.0 May 3, 2019
1.17.0 Mar 28, 2019
1.16.0 Mar 10, 2019
1.15.3 Feb 16, 2019
1.15.2 Feb 5, 2019
1.15.1 Jan 30, 2019
1.15.0 Jan 21, 2019
1.14.0 Jan 6, 2019
1.13.0 Dec 16, 2018
1.12.0 Nov 25, 2018
1.11.3 Oct 30, 2018
1.11.2 Oct 5, 2018
1.11.1 Sep 18, 2018
1.11.0 Sep 12, 2018
1.10.5 Aug 18, 2018
1.10.4 Jul 30, 2018
1.10.3 Jul 19, 2018
1.10.2 Jul 16, 2018
1.10.1 Jul 7, 2018
1.10.0 Jul 3, 2018
1.9.3 May 9, 2018
1.9.2 May 4, 2018
1.9.1 Apr 29, 2018
1.9.0 Apr 23, 2018
1.8.2 Mar 9, 2018
1.8.1 Feb 28, 2018
1.8.0 Feb 23, 2018
1.7.0 Dec 15, 2017
1.6.0 Nov 15, 2017
1.5.2 Nov 1, 2017
1.5.1 Oct 16, 2017
1.5.0 Oct 11, 2017
1.4.1 Aug 25, 2017
1.4.0 Aug 21, 2017
1.3.0 May 14, 2017
1.2.5 Apr 12, 2017
1.2.4 Apr 6, 2017
1.2.3 Mar 2, 2017
1.2.2 Mar 1, 2017
1.2.1 Feb 28, 2017
1.2.0 Feb 23, 2017
1.1.0 Jan 23, 2017
1.0.5 Dec 20, 2016
1.0.4 Nov 17, 2016
1.0.3 Nov 3, 2016
1.0.2 Oct 15, 2016
1.0.1 Aug 24, 2016
1.0 Jul 22, 2016
0.9.9 Jun 29, 2016
0.9.8 May 23, 2016
0.9.7 Apr 25, 2016
0.9.6 Apr 22, 2016
0.9.5 Mar 24, 2016