搜索

第 3 章 使用命令行界面

download PDF

命令行界面(CLI)允许通过使用交互式终端与消息代理交互。使用 CLI 管理代理操作、配置消息以及输入有用的命令。

命令行界面(CLI)允许通过使用交互式流程将用户和角色添加到文件中。

3.1. 启动代理实例

代理实例是一个目录,其中包含所有配置和运行时数据,如日志和数据文件。运行时数据与一个唯一的代理进程关联。

您可以使用 artemis 脚本、Linux 服务或 Windows 服务在前台启动代理。

3.1.1. 启动代理实例

创建代理实例后,您将使用 artemis run 命令启动它。

流程

  1. 切换到安装期间创建的用户帐户。

    $ su - amq-broker
  2. 使用 artemis run 命令启动代理实例。

    $ /var/opt/amq-broker/mybroker/bin/artemis run
    
              __  __  ____    ____            _
        /\   |  \/  |/ __ \  |  _ \          | |
       /  \  | \  / | |  | | | |_) |_ __ ___ | | _____ _ __
      / /\ \ | |\/| | |  | | |  _ <| '__/ _ \| |/ / _ \ '__|
     / ____ \| |  | | |__| | | |_) | | | (_) |   <  __/ |
    /_/    \_\_|  |_|\___\_\ |____/|_|  \___/|_|\_\___|_|
    
    Red Hat JBoss AMQ 7.2.1.GA
    
    10:53:43,959 INFO  [org.apache.activemq.artemis.integration.bootstrap] AMQ101000: Starting ActiveMQ Artemis Server
    10:53:44,076 INFO  [org.apache.activemq.artemis.core.server] AMQ221000: live Message Broker is starting with configuration Broker Configuration (clustered=false,journalDirectory=./data/journal,bindingsDirectory=./data/bindings,largeMessagesDirectory=./data/large-messages,pagingDirectory=./data/paging)
    10:53:44,099 INFO  [org.apache.activemq.artemis.core.server] AMQ221012: Using AIO Journal
    ...

    代理使用以下信息启动并显示日志输出:

    • 事务日志和集群配置的位置。
    • 用于消息持久性的日志类型(本例中为 AIO)。
    • 可接受客户端连接的 URI。

      默认情况下,端口 616 可以接受来自任何支持的协议(CORE、MQTT、AMQP、STOMP、HORNETQ 和 OPENWIRE)的连接。每个协议也都有单独的端口。

    • Web 控制台位于 http://localhost:8161
    • Jolokia 服务(JMX over REST)位于 http://localhost:8161/jolokia

3.1.2. 启动代理作为 Linux 服务

如果在 Linux 上安装了代理,您可以将其作为服务运行。

流程

  1. /etc/systemd/system/ 目录中创建一个新的 amq-broker.service 文件。
  2. 将以下文本复制到 文件:

    根据代理实例创建过程中提供的信息,修改路径和用户字段。在以下示例中,用户 amq-broker 启动在 /var/opt/amq-broker/mybroker/ 目录下安装的代理服务。

    [Unit]
    Description=AMQ Broker
    After=syslog.target network.target
    
    [Service]
    ExecStart=/var/opt/amq-broker/mybroker/bin/artemis run
    Restart=on-failure
    User=amq-broker
    Group=amq-broker
    
    # A workaround for Java signal handling
    SuccessExitStatus=143
    
    [Install]
    WantedBy=multi-user.target
  3. 打开终端。
  4. 使用以下命令启用代理服务:

    sudo systemctl enable amq-broker
  5. 使用以下命令运行代理服务:

    sudo systemctl start amq-broker

3.1.3. 启动代理作为 Windows 服务

如果在 Windows 上安装了代理,您可以将其作为服务运行。

流程

  1. 打开命令提示输入命令
  2. 使用以下命令将代理作为服务安装:

    <broker_instance_dir>\bin\artemis-service.exe install
  3. 使用以下命令启动服务:

    <broker_instance_dir>\bin\artemis-service.exe start
  4. (可选)卸载服务:

    <broker_instance_dir>\bin\artemis-service.exe uninstall
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.