This is an automated email from the ASF dual-hosted git repository.
robbie pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/activemq-artemis.git
The following commit(s) were added to refs/heads/main by this push:
new 06576acb88 ARTEMIS-5638 clarify docs for installing libaio
06576acb88 is described below
commit 06576acb884c2ce79329b5520e536fd8600d618d
Author: Justin Bertram <[email protected]>
AuthorDate: Tue Aug 26 13:41:48 2025 -0500
ARTEMIS-5638 clarify docs for installing libaio
---
docs/user-manual/libaio.adoc | 37 +++++++++++++++++++++++++++++++------
docs/user-manual/persistence.adoc | 16 +---------------
2 files changed, 32 insertions(+), 21 deletions(-)
diff --git a/docs/user-manual/libaio.adoc b/docs/user-manual/libaio.adoc
index 4732eb0fb1..9422377f31 100644
--- a/docs/user-manual/libaio.adoc
+++ b/docs/user-manual/libaio.adoc
@@ -22,21 +22,46 @@ When using libaio, Apache ActiveMQ Artemis will always try
loading these files a
== Runtime dependencies
If you just want to use the provided native binaries you need to install the
required libaio dependency.
+You can install libaio using the following steps either as the root user or
using `sudo`:
-You can install libaio using the following steps as the root user:
-
-Using yum, (e.g. on Fedora or Red Hat Enterprise Linux):
+* On Fedora, CentOS, Rocky Linux, Red Hat Enterprise Linux, etc.:
++
+----
+dnf install libaio
+----
+* On Ubuntu, Debian, etc.:
++
----
-yum install libaio
+apt install <package-name>
----
++
+The value for `<package-name>` will depend on which Linux distribution version
you're using:
++
+
+|===
+|Linux Distro Version |Package Name
-Using aptitude, (e.g. on Ubuntu or Debian system):
+|Ubuntu 22.04 (and earlier)
+|libaio1
+|Ubuntu 24.04 (and later)
+|libaio1t64
+
+|Debian 12 (and earlier)
+|libaio1
+
+|Debian 13 (and later)
+|libaio1t64
+|===
++
+Since the package name in later versions of Ubuntu and Debian is different
you'll also need to create a symlink on these versions so that the ActiveMQ
Artemis Native library can find the shared library at the expected location,
e.g.:
++
----
-apt-get install libaio1
+ln -s /usr/lib/x86_64-linux-gnu/libaio.so.1t64 /usr/lib/libaio.so.1
----
+
== Compiling the native libraries
In the case that you are using Linux on a platform other than x86_32 or x86_64
(for example Itanium 64 bits or IBM Power) you may need to compile the native
library, since we do not distribute binaries for those platforms with the
release.
diff --git a/docs/user-manual/persistence.adoc
b/docs/user-manual/persistence.adoc
index cb08c7b2e0..71f9884e51 100644
--- a/docs/user-manual/persistence.adoc
+++ b/docs/user-manual/persistence.adoc
@@ -273,21 +273,7 @@ The Java NIO journal gives great performance, but If you
are running Apache Acti
It's not possible to use the ASYNCIO journal under other operating systems or
earlier versions of the Linux kernel.
-If you are running Linux kernel 2.6 or later and don't already have `libaio`
installed, you can easily install it using the following steps:
-
-Using yum, (e.g. on Fedora or Red Hat Enterprise Linux):
-
-[,sh]
-----
-yum install libaio
-----
-
-Using aptitude, (e.g. on Ubuntu or Debian system):
-
-[,sh]
-----
-apt-get install libaio
-----
+If you are running Linux kernel 2.6 or later and don't already have `libaio`
installed you can easily install it using the
xref:libaio.adoc#runtime-dependencies[following steps].
== JDBC Persistence
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
For further information, visit: https://activemq.apache.org/contact
