第 2 章 使用命令行界面
命令行界面(CLI)允许通过使用交互式终端与消息代理交互。使用 CLI 管理代理操作、配置消息并输入有用的命令。
命令行接口(CLI)允许使用交互过程向文件添加用户和角色。
2.1. 启动代理实例 复制链接链接已复制到粘贴板!
代理实例是包含所有配置和运行时数据的目录,如日志和数据文件。运行时数据与一个唯一的代理进程关联。
您可以使用 artemis
脚本、作为 Linux 服务或 Windows 服务在前台启动代理。
2.1.1. 启动代理实例 复制链接链接已复制到粘贴板!
创建代理实例后,您可以使用 artemis run
命令启动它。
步骤
切换到安装期间创建的用户帐户。
su - amq-broker
$ su - amq-broker
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用
artemis run
命令启动代理实例。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 代理启动并显示使用以下信息的日志输出:
- 事务日志和集群配置的位置。
- 用于消息持久性的日志类型(本例中为AIO)。
可以接受客户端连接的 URI。
默认情况下,端口 61616 可以接受任何受支持的协议(CORE、MQTT、AMQP、STOMP、HORNETQ 和 OPENWIRE)的连接。另外,每个协议都有单独的端口。
- Web 控制台位于 http://localhost:8161。
- Jolokia 服务(JMX over REST)位于 http://localhost:8161/jolokia
2.1.2. 将代理作为 Linux 服务启动 复制链接链接已复制到粘贴板!
如果在 Linux 上安装了代理,您可以将其作为服务运行。
步骤
-
在
/etc/systemd/system/
目录中创建一个新的amq-broker.service
文件。 将以下文本复制到 文件中。
根据代理实例创建过程中提供的信息,修改 path 和 user 字段。在以下示例中,用户
amq-broker
启动在/var/opt/amq-broker/mybroker/
目录下安装的代理服务。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 打开终端。
使用以下命令启用代理服务:
sudo systemctl enable amq-broker
sudo systemctl enable amq-broker
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用以下命令运行代理服务:
sudo systemctl start amq-broker
sudo systemctl start amq-broker
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.1.3. 将代理作为 Windows 服务启动 复制链接链接已复制到粘贴板!
如果在 Windows 上安装代理,您可以将其作为服务运行。
步骤
- 打开命令提示
使用以下命令将代理作为服务安装:
<broker-instance-dir>\bin\artemis-service.exe install
<broker-instance-dir>\bin\artemis-service.exe install
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用以下命令启动该服务:
<broker-instance-dir>\bin\artemis-service.exe start
<broker-instance-dir>\bin\artemis-service.exe start
Copy to Clipboard Copied! Toggle word wrap Toggle overflow (可选)卸载服务:
<broker-instance-dir>\bin\artemis-service.exe uninstall
<broker-instance-dir>\bin\artemis-service.exe uninstall
Copy to Clipboard Copied! Toggle word wrap Toggle overflow