Efficient reliable unicast and multicast transport protocol.
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 moved on quite a bit with performance and some features but the basic design still applies.
Copyright 2014 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
http://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.
Client API
aeron-client
Samples
aeron-samples
Media Driver
aeron-driver
Common Classes/Methods
aeron-common
You require the following to build Aeron:
- Latest stable Oracle JDK 8
You must first build and install Agrona into the local maven repository
$ ./gradlew
After Agrona is compiled and installed, then you can build Aeron.
Full clean and build of all modules
$ ./gradlew
You require the following to build Aeron with C++:
- 2.8 or higher of CMake
- C++11 supported compiler for the supported platform
Full clean and build of all modules
$ cd cppbuild
$ ./cppbuild
Start up a media driver
$ java -cp aeron-samples/build/libs/samples.jar uk.co.real_logic.aeron.driver.MediaDriver
You can run the BasicSubscriber from a command line
$ java -cp aeron-samples/build/libs/samples.jar uk.co.real_logic.aeron.samples.BasicSubscriber
You can run the BasicPublisher from a command line
$ java -cp aeron-samples/build/libs/samples.jar uk.co.real_logic.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 uk.co.real_logic.aeron.samples.AeronStat
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