本教程适用于以下操作系统版本

  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)

本页内容

  • 前提条件
  • 安装 Java OpenJDK 和 JRE
  • 设置 JAVA_HOME 环境变量
  • 安装 Apache ActiveMQ
  • 将 Apache ActiveMQ 设置为 Systemd 服务
  • 设置 Apache ActiveMQ Web Console
  • 结论

Apache ActiveMQ 是由 Apache Software Foundation 开发的免费开源消息代理。它是知名的消息代理之一,支持多种协议,如 AMQP、MQTT、Stomp 和 OpenWire。它用 Java 编写,完全符合 JMS 1.1 标准。

Apache ActiveMQ 是最受欢迎的消息代理之一,支持不同类型的编程语言,可部署在多个平台上。它是企业级消息代理,提供高可用性、可扩展性、可靠性、高性能和安全性。

在本文中,你将学习如何在 Debian 11 系统上安装 Apache ActiveMQ 多协议消息代理。本教程包括 Java OpenJDK 和 JRE 的安装以及 JAVA_HOME 环境变量的配置。

前提条件

  • 一台 Debian 11 的 Linux 服务器。
  • 一个具有 root 管理员权限的非 root 用户。

安装 Java OpenJDK 和 JRE

首先,在安装 Apache ActiveMQ 之前,你需要先安装 Java OpenJDK 和 JRE。当前版本的 Apache ActiveMQ 要求最低 Java JRE v1.8。

在 Debian 11 仓库中,有多个版本的 Java OpenJDK 和 JRE。但你将为 Apache ActiveMQ 安装 Java OpenJDK 和 JRE v1.11。

使用以下命令刷新并更新你的 Debian 仓库。

sudo apt update

接下来,使用下面的 apt 命令安装 Java OpenJDK 和 JRE。

sudo apt install default-jdk default-jre

输入 Y 确认安装,然后按 ENTER 继续。

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

安装完成后,使用以下命令检查 Java 版本。

java -version

在下面的截图中,你将看到 Debian 系统上已安装 Java OpenJDK 1.11。

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

进入下一步以设置 JAVA_HOME 环境变量。

设置 JAVA_HOME 环境变量

Apache ActiveMQ 要求将 JAVA_HOME 环境变量正确配置为 jvm 安装目录,该目录位于 /usr/lib/jvm/java-11-openjdk-amd64 目录。通过一种简单的方式,你可以通过 "~/.bashrc" 文件设置 JAVA_HOME 环境变量。

使用以下命令将配置添加到 "~/.bashrc" 配置文件。

echo "export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64" >> ~/.bashrc

现在重新加载 ~/.bashrc 配置文件以应用新的更改。

source ~/.bashrc

最后,使用以下命令检查环境变量 JAVA_HOME。

echo $JAVA_HOME

你将看到以下输出。JAVA_HOME 环境变量已正确配置为 JVM 目录 /usr/lib/jvm/java-11-openjdk-amd64 。

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

现在进入下一步,开始 Apache ActiveMQ 的安装。

安装 Apache ActiveMQ

Apache ActiveMQ 提供多个版本的 ActiveMQ。在本示例中,你将安装 Apache ActiveMQ Classic,它功能强大并支持多种消息协议,如 AMQP、MQTT、Stomp 和 OpenWire。

此外,你可以用与 ActiveMQ classic 相同的方式安装其他版本,例如 ActiveMQ Artemis。

要开始安装,请运行以下命令下载 Apache ActiveMQ v5.17(撰写本文时的最新版本)。

wget https://dlcdn.apache.org//activemq/5.17.1/apache-activemq-5.17.1-bin.tar.gz

下载过程完成后,你将看到文件 apache-activemq-5.17.1-bin.tar.gz 。使用以下命令解压它。

tar -xzvf apache-activemq-5.17.1-bin.tar.gz

接下来,将解压后的目录 apache-activemq-5.17.1 移动到 /opt/activemq 。

mv apache-activemq-5.17.1 /opt/activemq

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

之后,使用以下命令添加一个名为 activemq 的新用户和组。

sudo useradd -d /opt/activemq -r -s /bin/false -U activemq

现在将 Apache ActiveMQ 安装目录 /opt/activemq 的所有权更改为 activemq 用户和组。

sudo chown -R activemq:activemq /opt/activemq/

最后,使用以下命令检查所有 Apache ActiveMQ 文件的所有权。

ls -lah /opt/activemq

如下面的截图所示,Apache ActiveMQ 目录 /opt/activemq 的所有者是用户 activemq 和组 activemq 。

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

将 Apache ActiveMQ 设置为 Systemd 服务

现在你需要将 Apache ActiveMQ 设置为 systemd 服务。这样做可以让你使用 systemctl 命令管理 ActiveMQ,用于启动、停止或启用 ActiveMQ 在系统启动时运行。

现在使用 nano 编辑器创建一个新的 systemd 服务配置 /etc/systemd/system/activemq.service。

sudo nano /etc/systemd/system/activemq.service

将以下配置添加到该文件。

[Unit]
Description=Apache ActiveMQ
After=network.target
[Service]
Type=forking
User=activemq
Group=activemq
ExecStart=/opt/activemq/bin/activemq start
ExecStop=/opt/activemq/bin/activemq stop
[Install]
WantedBy=multi-user.target

完成后保存并关闭该文件。

接下来,运行以下命令重新加载 systemd 管理器并刷新系统上所有服务单元列表。

sudo systemctl daemon-reload

现在将 activemq 服务添加到系统启动项并启动该服务。

sudo systemctl enable activemq
sudo systemctl start activemq

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

最后,使用以下命令检查 activemq。

sudo systemctl status activemq

在下面的截图中,你将看到 activemq 服务正在运行且已启用。在日志消息的末尾,你将看到 " Started Apache ActiveMQ "。

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

设置 Apache ActiveMQ Web Console

至此,你已在 Debian 11 服务器上完成 Apache ActiveMQ 的安装。默认的 ActiveMQ web console 运行在 localhost 上,因此如果你运行在外部服务器上,你需要将 Apache ActiveMQ web console 的 LISTEN 地址更改为你的服务器 IP 地址。

使用 nano 编辑器编辑配置文件 /opt/activemq/conf/jetty.xml。

sudo nano /opt/activemq/conf/jetty.xml

将默认主机 127.0.0.1 更改为你的服务器 IP 地址。在本教程中,服务器 IP 地址为 192.168.5.20 。

    <bean id="jettyPort" class="org.apache.activemq.web.WebConsolePort" init-method="start">
             <!-- the default port number for the web console -->
        <property name="host" value="192.168.5.20"/>
        <property name="port" value="8161"/>
    </bean>

完成后保存并关闭该文件。

接下来,运行以下命令重启 activemq 服务并使 jetty.xml 配置文件的新更改生效。

sudo systemctl restart activemq

使用以下命令检查 Debian 系统上的 LISTEN 端口。

ss -plnt

如下面的截图所示,Apache ActiveMQ Web Console 运行在 IP 地址 192.168.5.20 上,使用默认端口 8161 。

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

打开 Web 浏览器,访问你的服务器 IP 地址和以下端口 8161。

http://192.168.5.20:8161/

系统将提示你进行基本身份验证。输入默认用户 admin,密码为 admin,然后点击 Sign In。

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

下面你可以看到 Apache ActiveMQ Web Console 的仪表板。

在 Debian 11 上安装 Apache ActiveMQ 消息代理完整教程

结论

恭喜!你已学习如何在 Debian 11 服务器上安装和配置 Apache ActiveMQ。你还学习了如何向 Debian 服务器添加自定义 Systemd 服务并启用 Apache ActiveMQ Web Console。