ActiveMQ安装配置官方文档中文翻译

2401_85480529

已于 2024-07-08 11:18:49 修改

阅读量36

点赞数

文章标签： activemq

于 2024-07-08 11:18:00 首次发布

原文链接：https://activemq.apache.org/components/classic/documentation/version-5-getting-started

版权

原文链接：https://activemq.apache.org/components/classic/documentation/version-5-getting-started

版本 5 入门

使用 ActiveMQ Classic 5 > 版本 5 入门

简介

本文档描述了如何在 Unix 和 Windows 平台上安装和配置 ActiveMQ Classic。

预安装要求

硬件：

60 MB 的空闲磁盘空间用于 ActiveMQ Classic 二进制分发包。
200 MB 的空闲磁盘空间用于 ActiveMQ Classic 源代码或开发者分发包。

操作系统：

Windows：Windows XP SP2、Windows 2000。
Unix：Ubuntu Linux、Powerdog Linux、MacOS、AIX、HP-UX、Solaris 或任何支持 Java 的 Unix 平台。

环境：

Java 开发工具包（JDK）1.7.x 或更高版本用于部署，1.7.x（Java 7）用于编译/构建。
必须将 JAVA_HOME 环境变量设置为 JDK 安装目录，例如，c:\\Program Files\\jdk.1.7.0_xx_xx。
Maven 3.0 或更高版本（在安装源代码或开发者版本时需要）。
必须将将要使用的 JARs 添加到类路径中。

Windows 安装步骤

本节《入门指南》解释了如何在 Windows 系统上安装 ActiveMQ Classic 的二进制和源代码分发包。

Windows 二进制安装

本步骤解释了如何在 Windows 系统上下载和安装二进制分发包。

从浏览器中，导航到 activemq.apache.org/。
点击导航窗格（左窗格）中的下载链接。
选择最新的分发版本（对于旧版本，请点击链接进入档案馆）。对于二进制分发包，文件名类似于：activemq-x.x.x.zip。
将 ZIP 文件中的文件解压到您选择的目录中。
继续阅读本文档的 #启动 ActiveMQ Classic 部分。
启动后，转到本文档的 #测试安装部分。

Windows 源代码安装

本步骤解释了如何在 Windows 系统上下载和安装源代码分发包。

注意： ActiveMQ Classic 需要 Java 7 才能运行和构建。

从浏览器中，导航到 activemq.apache.org/。
点击导航窗格（左窗格）中的下载链接。
选择最新的分发版本（对于旧版本，请点击链接进入档案馆）。对于源代码分发包，文件名类似于：activemq-x.x-src.zip。
将 ZIP 文件中的 ActiveMQ Classic 解压到您选择的目录中。
使用 Maven 2.1 或更高版本和 Java 1.7 构建 ActiveMQ Classic。

构建 ActiveMQ Classic 的推荐方法如下：

cd [activemq_install_dir] 
mvn clean install

其中 [activemq_install_dir] 是安装 ActiveMQ Classic 的目录。

如果上述构建在某些测试上失败，请输入以下内容：

cd [activemq_install_dir] 
mvn clean install -Dmaven.test.skip=true

如果您喜欢使用 IDE，则可以使用 maven 插件自动生成 IDE 的项目文件：
```
mvn eclipse:eclipse
```
或
```
mvn idea:idea
```
请随意使用其他适用的 IDE。有关更多详细信息，请参阅插件参考。
从目标目录启动 ActiveMQ Classic，例如：
```
cd [activemq_install_dir]\\assembly\\target  
unzip activemq-x.x-SNAPSHOT.zip  
cd activemq-x.x-SNAPSHOT  
bin\\activemq
```
注意：工作目录将相对于当前目录创建。为了在适当的位置创建工作目录，必须从其主目录/安装目录启动 ActiveMQ Classic。
继续阅读本文档的 #测试安装部分。

警告

如果您在 Windows 使用 Cygwin 构建 ActiveMQ Classic 5.x，路径名长度有限制。如果路径名长度超过限制，您可能会看到构建错误。为了解决这个问题，请将 ActiveMQ Classic 源代码目录移到文件系统树的更高位置，例如 /cygdrive/c/d/sm。

Windows 开发者版本

本步骤解释了如何下载和安装最新的开发者快照。

注意： ActiveMQ Classic 需要 Java 7 才能运行和构建。

从浏览器中，导航到 activemq.apache.org/。
点击导航窗格（左窗格）中的下载链接。
点击 Maven ActiveMQ Classic SNAPSHOT 链接。
选择要下载的 ActiveMQ Classic 版本。
将 ZIP 文件中的文件解压到您选择的目录中。
如果下载的是二进制快照，请继续阅读本文档的 #启动 ActiveMQ Classic 部分。如果下载的是源代码快照，请执行 #Windows 源代码安装步骤 6 和步骤 7。
启动后，继续阅读 #测试安装部分。

Unix 安装步骤

Unix 二进制安装

本步骤解释了如何在 Unix 系统上下载和安装二进制分发包。

注意： 有几种替代方法可以执行此类安装。

将 activemq gzip 文件下载到 Unix 计算机上，可以使用浏览器或工具，例如 wget、scp、ftp 等。例如：
```
\> wget <http://activemq.apache.org/path/tofile/apache-activemq-5.8-tar.gz
```
将 gzip 文件中的文件解压到您选择的目录中。例如：
```
\> tar zxvf activemq-x.x.x.tar.gz
```
如果 activemq 启动脚本不可执行，请更改其权限。activemq 脚本位于 bin 目录中。例如：
```
\> cd [activemq_install_dir]/bin  
\> chmod 755 activemq
```
继续阅读本文档的 #启动 ActiveMQ Classic 部分。
启动后，转到 #测试安装部分。

Unix 源代码安装

本步骤解释了如何在 Unix 系统上下载和安装源代码分发包。本步骤假设 Unix 计算机上有浏览器。有关如何在没有浏览器的情况下安装 ActiveMQ Classic 的详细信息，请参阅前面的 #Unix 二进制安装部分。

注意： ActiveMQ Classic 需要 Java 7 才能运行和构建。

从浏览器中，导航到 activemq.apache.org/。
点击导航窗格（左窗格）中的下载链接。
点击 Maven ActiveMQ Classic SNAPSHOT 链接。
选择要下载的 ActiveMQ Classic 版本。对于源代码分发包，文件名类似于：activemq-x.x-src.tar.gz。
将 ZIP 文件中的文件解压到您选择的目录中。例如：
```
tar zxvf activemq.x.x-src.tar.gz
```
使用 Maven 3.0 或更高版本和 Java 7 构建 ActiveMQ Classic：构建 ActiveMQ Classic 的首选方法如下：
```
cd [activemq_install_dir]  
mvn clean install
```
如果 Maven 因 java.lang.OutOfMemoryError 崩溃，您需要先执行以下操作（假设使用类似 Bourne 的 shell）：
```
export MAVEN_OPTS=-Xmx1024M
```
如果上述构建在某些测试上失败，请执行以下操作：
```
cd [activemq_install_dir]  mvn clean install -Dmaven.test.skip=true
```
如果您喜欢使用 IDE，则可以使用 maven 插件自动生成 IDE 的项目文件：
```
mvn eclipse:eclipse
```
或
```
mvn idea:idea
```
请随意使用其他适用的 IDE。有关更多详细信息，请参阅插件参考。

注意： 工作目录将相对于当前目录创建。为了在适当的位置创建工作目录，必须从其主目录/安装目录启动 ActiveMQ Classic。
继续阅读本文档的 #启动 ActiveMQ Classic 部分。
继续阅读 #测试安装部分。

Unix 开发者版本

本步骤解释了如何下载和安装最新的开发者快照。

注意： ActiveMQ Classic 需要 Java 7 才能运行和构建。

从浏览器中，导航到 activemq.apache.org/。
点击导航窗格（左窗格）中的下载链接。
点击 Maven ActiveMQ Classic SNAPSHOT 链接。
选择要下载的 ActiveMQ Classic 版本。
将 gzip 文件中的文件解压到您选择的目录中。例如：对于二进制开发者快照：
```
tar zxvf activemq-x.x.x.tar.gz
```
对于源代码开发者快照：
```
tar zxvf activemq-x.x.x-src.tar.gz
```
如果下载的是二进制快照，为了使其可执行，可能需要更改 activemq 脚本的权限：
```
cd [activemq_install_dir]/bin  chmod 755 activemq
```
对于二进制快照，请继续阅读本文档的 #启动 ActiveMQ Classic 部分。
如果下载的是源代码快照，请执行 #Unix 源代码安装步骤 6 - 8。
继续阅读 #测试安装部分。

启动 ActiveMQ Classic

以下是关于如何运行 ActiveMQ Classic 消息代理的说明。

另请参阅使用不同配置文件启动 ActiveMQ Classic。

在 Windows 上

从控制台窗口中，切换到安装目录并运行 activemq：

cd [activemq_install_dir]

其中 activemq_install_dir 是安装 ActiveMQ Classic 的目录，例如 c:\\Program Files\\ActiveMQ-5.x。

然后键入（取决于 ActiveMQ Classic 版本）：

ActiveMQ Classic 5.10 及以后版本

bin\\activemq start

ActiveMQ Classic 5.9 或更早版本

bin\\activemq

注意： 工作目录将相对于当前目录创建。为了在适当的位置创建工作目录，必须从其主目录/安装目录启动 ActiveMQ Classic。

在 Unix 上

从命令 shell 中，切换到安装目录并运行 activemq：

cd [activemq_install_dir]

其中 activemq_install_dir 是安装 ActiveMQ Classic 的目录，例如 /usr/local/activemq-5.x。

然后键入：

bin/activemq start

或

bin/activemq start > /tmp/smlog 2>&1 &; 
注意：/tmp/smlog 可以更改为其他文件名。

注意： 工作目录将相对于当前目录创建。为了在适当的位置创建工作目录，必须从其主目录/安装目录启动 ActiveMQ Classic。

警告

请勿关闭启动 ActiveMQ Classic 的控制台或 shell，否则会终止 ActiveMQ Classic（除非使用 nohup 启动 ActiveMQ Classic）。
nohup bin/activemq > /tmp/smlog 2>&1 &

测试安装

如果 ActiveMQ Classic 正常运行，没有问题，Windows 控制台窗口或 Unix 命令 shell 将显示类似于以下日志行的信息：

INFO  ActiveMQ JMS Message Broker (ID:apple-s-Computer.local-51222-1140729837569-0:0) has started

ActiveMQ Classic 的默认端口是 61616。从另一个窗口运行 netstat 并搜索端口 61616。

从 Windows 控制台，键入：

netstat -an|find "61616"

或

从 Unix 命令 shell，键入：

netstat -an|grep 61616

监控 ActiveMQ Classic

您可以使用 Web 控制台监控 ActiveMQ Classic，方法是将浏览器指向

http://localhost:8161/admin

从 ActiveMQ Classic 5.8 开始，Web 应用默认情况下是安全的。

默认用户名和密码是 admin/admin。您可以在 conf/jetty-real.properties 文件中配置它。

或者，您可以使用 JMX 支持查看 ActiveMQ Classic 的运行状态。

有关更多信息，请参阅分发包中的文件 docs/WebConsole-README.txt。

停止 ActiveMQ Classic

对于 Windows 和 Unix 安装，按“CTRL-C”终止运行 ActiveMQ Classic 的控制台或命令 shell。

如果 ActiveMQ Classic 在 Unix 上以后台方式启动，可以通过以下方式终止该进程：

cd [activemq_install_dir]

其中 [activemq_install_dir] 是安装 ActiveMQ Classic 的目录，例如 /usr/local/activemq-5.x。

然后键入：

bin/activemq stop

或者，您可以执行以下操作：

ps -ef|grep activemq kill [PID]

其中 [PID] 是 ActiveMQ Classic 进程的进程 ID。

使用不同配置文件启动 ActiveMQ Classic

默认情况下，ActiveMQ Classic 使用 conf/activemq.xml 作为启动时的主要配置文件。如果您想使用不同的配置文件，可以将其指定为参数。

ActiveMQ Classic 5.8 或更早版本

例如，要使用包含 Web 演示的 conf/activemq-demo.xml，请执行以下操作：

bin/activemq console xbean:conf/activemq-demo.xml

在控制台模式下启动 ActiveMQ 并加载 conf/activemq-demo.xml 文件。是的，您需要 xbean: 作为前缀。

要作为后台进程启动，请执行以下操作：

bin/activemq start xbean:conf/activemq-demo.xml

ActiveMQ Classic 5.9 及以后版本

例如，要使用包含 Web 演示的 examples/conf/activemq-demo.xml，请执行以下操作：

bin/activemq console xbean:examples/conf/activemq-demo.xml

在控制台模式下启动 ActiveMQ 并加载 examples/conf/activemq-demo.xml 文件。是的，您需要 xbean: 作为前缀。

要作为后台进程启动，请执行以下操作：

bin/activemq start xbean:examples/conf/activemq-demo.xml

配置 ActiveMQ Classic

ActiveMQ Classic 代理现在应该可以运行了。您可以通过将 Xml 配置文件指定为 activemq 命令的参数来配置代理。另一种方法是使用代理配置 URI 在命令行上以简洁的格式配置内容（尽管配置选项不如使用 Java 或 XML 代码时那么广泛）。您还可以

另请参阅 [配置传输](https://activemq.apache.org/components/classic/documentation/config

2401_85480529

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
ActiveMQ安装配置官方文档中文翻译

为了解决这个问题，请将 ActiveMQ Classic 源代码目录移到文件系统树的更高位置，例如 /cygdrive/c/d/sm。为了在适当的位置创建工作目录，必须从其主目录/安装目录启动 ActiveMQ Classic。为了在适当的位置创建工作目录，必须从其主目录/安装目录启动 ActiveMQ Classic。为了在适当的位置创建工作目录，必须从其主目录/安装目录启动 ActiveMQ Classic。为了在适当的位置创建工作目录，必须从其主目录/安装目录启动 ActiveMQ Classic。
复制链接

扫一扫