第 3 章 使用命令行界面
命令行界面(CLI)允许通过使用交互式终端与消息代理交互。使用 CLI 管理代理操作、配置消息以及输入有用的命令。
命令行界面(CLI)允许通过使用交互式流程将用户和角色添加到文件中。
3.1. 启动代理实例 复制链接链接已复制到粘贴板!
代理实例是一个目录,其中包含所有配置和运行时数据,如日志和数据文件。运行时数据与一个唯一的代理进程关联。
您可以使用 artemis
脚本、Linux 服务或 Windows 服务在前台启动代理。
3.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。
默认情况下,端口 616 可以接受来自任何支持的协议(CORE、MQTT、AMQP、STOMP、HORNETQ 和 OPENWIRE)的连接。每个协议也都有单独的端口。
- Web 控制台位于 http://localhost:8161
- Jolokia 服务(JMX over REST)位于 http://localhost:8161/jolokia
3.1.2. 启动代理作为 Linux 服务 复制链接链接已复制到粘贴板!
如果在 Linux 上安装了代理,您可以将其作为服务运行。
流程
-
在
/etc/systemd/system/
目录中创建一个新的amq-broker.service
文件。 将以下文本复制到 文件:
根据代理实例创建过程中提供的信息,修改路径和用户字段。在以下示例中,用户
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
3.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