第 2 章 使用命令行界面
命令行界面(CLI)允许通过使用交互式终端与消息代理交互。使用 CLI 管理代理操作、配置消息并输入有用的命令。
命令行接口(CLI)允许使用交互过程向文件添加用户和角色。
2.1. 启动代理实例
代理实例是包含所有配置和运行时数据的目录，如日志和数据文件。运行时数据与一个唯一的代理进程关联。
您可以使用 artemis 脚本、作为 Linux 服务或 Windows 服务在前台启动代理。
2.1.1. 启动代理实例
创建代理实例后，您可以使用 artemis run 命令启动它。
步骤
切换到安装期间创建的用户帐户。
$ su - amq-broker
使用
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。
默认情况下，端口 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/目录下安装的代理服务。[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
- 打开终端。
使用以下命令启用代理服务：
sudo systemctl enable amq-broker
使用以下命令运行代理服务：
sudo systemctl start amq-broker
2.1.3. 将代理作为 Windows 服务启动
如果在 Windows 上安装代理，您可以将其作为服务运行。
步骤
- 打开命令提示
使用以下命令将代理作为服务安装：
<broker-instance-dir>\bin\artemis-service.exe install使用以下命令启动该服务：
<broker-instance-dir>\bin\artemis-service.exe start（可选）卸载服务：
<broker-instance-dir>\bin\artemis-service.exe uninstall
