Chapter 5. 安装

本章讲述如何安装HornetQ。

5.1. 准备

Note

HornetQ只能在Java 6或以上版本中运行

默认情况下HornetQ运行的内存是1GiB。如果你的电脑内存少于1GiB,或者你希望更多的内存给HornetQ,你 可以修改 bin/run.sh脚本文件。

HornetQ有自己的快速日志系统,它能够使用libaio(在Linux上它是默认的)或Java的NIO。 如果要使用libaio,你需要首先在你的Linux上安装它。

如果你不在使用Linux,则不需要考虑这个问题。

要安装libaio,你可以使用root用户完成以下步骤:

使用yum(例如在Fedora 或 Red Hat Enterprise Linux上):

yum install libaio

使用aptitude, (例如在Ubuntu或Debian系统上):

apt-get install libaio

5.2. 单独的HornetQ服务器

将软件包下载后,将其解压到你选定的目录下。这里你就可以直接运行了。 下面给出了它的目录结构:

         |___ bin
         |
         |___ config
         |      |___ jboss-as-4
         |      |___ jboss-as-5
         |      |___ stand-alone
         |
         |___ docs
         |      |___ api
         |      |___ quickstart-guide
         |      |___ user-manual
         |
         |___ examples
         |      |___ core
         |      |___ javaee
         |      |___ jms
         |
         |___ lib
         |
         |___ licenses
         |
         |___ schemas
      
  • bin -- 运行HornetQ的二进制文件和脚本文件。

  • config -- HornetQ的配置文件。它包括了单独模式或者运行在 JBoss AS 4 或 5中的配置。请参考配置索引来了解配置有详细信息。

  • docs -- HornetQ的文档及Javadoc。

  • examples -- JMS and Java EE例子。有关详细信息请参见 'running examples'一章。

  • lib -- 运行HornetQ所需要的jar文件和库文件

  • licenses -- HornetQ的软件协议

  • schemas -- HornetQ配置文件的XML Schema

5.3. HornetQ运行于JBoss应用服务器5.x

HornetQ可以部署在JBoss AS 5中。目前默认的应用服务器没有安装HornetQ(HornetQ将是JBoss 6的默认JMS提供者),因此 你需要为HornetQ创建新的AS 5的配置(profile)。

创建AS 5新配置的步骤:

  1. 下载并安装JBoss AS 5

  2. 设置环境变量JBOSS_HOME指向JBoss AS 5的安装目录。

  3. 运行HornetQ的config/jboss-as-5下的./build.sh (或 者如果在Windows下运行build.bat)。

这将会在$JBOSS_HOME/server创建两个服务器配置:

  • default-with-hornetq -- 这个相当于AS 5的default配置但其JMS提供者替换成为HornetQ。在这个配置中的HornetQ 是非集群的。

  • all-with-hornetq -- 这个相当于AS 5的all配置但其JMS提供者替换成为HornetQ。这个配置中的HornetQ 是集群的。

这时,你就可以启动上面其中任何一个配置的JBoss AS 5服务器了,例如:

$JBOSS_HOME/bin/run.sh -c default-with-hornetq

5.4. HornetQ运行于JBoss应用服务器4.x

为了在AS 4中安装HornetQ,你需要创建新的配置(profile)。

步骤如下:

  1. 下载并安装JBoss AS 4

  2. 设置环境变量JBOSS_HOME指向JBoss AS 4的安装目录。

  3. 运行HornetQ的config/jboss-as-4下的./build.sh (或 者如果在Windows下运行build.bat)。

这将会在$JBOSS_HOME/server创建两个服务器配置:

  • default-with-hornetq -- 这个相当于AS 4的default配置但其JMS提供者替换成为HornetQ。在这个配置中的HornetQ 是非集群的。

  • all-with-hornetq -- 这个相当于AS 4的all配置但其JMS提供者替换成为HornetQ。这个配置中的HornetQ 是集群的。

这时,你就可以启动上面其中任何一个配置的JBoss AS 4服务器了,例如:

$JBOSS_HOME/bin/run.sh -c default-with-hornetq