第 3 章 使用命令行界面
命令行界面(CLI)允许通过使用交互式终端与消息代理交互。使用 CLI 管理代理操作、配置消息以及输入有用的命令。
命令行界面(CLI)允许通过使用交互式流程将用户和角色添加到文件中。
3.1. 启动代理实例
代理实例是一个目录，其中包含所有配置和运行时数据，如日志和数据文件。运行时数据与一个唯一的代理进程关联。
您可以使用 artemis 脚本、Linux 服务或 Windows 服务在前台启动代理。
3.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。
默认情况下，端口 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/目录下安装的代理服务。[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
3.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
