From 65650564e8811b7784ce9b190b0edc6452148cb9 Mon Sep 17 00:00:00 2001 From: chendelin1982 <27513732@qq.com> Date: Thu, 1 Feb 2024 08:50:15 +0000 Subject: [PATCH] add template --- docs/apps/_include/activemq.md | 6 ++ docs/apps/_include/meta-zh.jinja2 | 15 ++++ docs/apps/_include/wordpress.md | 1 + docs/apps/activemq.md | 144 ++++++++++++++++++++++++++++++ docs/apps/activemq/admin.md | 34 ------- docs/apps/activemq/readme.md | 44 +-------- 6 files changed, 170 insertions(+), 74 deletions(-) create mode 100644 docs/apps/_include/activemq.md create mode 100644 docs/apps/_include/meta-zh.jinja2 create mode 100644 docs/apps/_include/wordpress.md create mode 100644 docs/apps/activemq.md diff --git a/docs/apps/_include/activemq.md b/docs/apps/_include/activemq.md new file mode 100644 index 00000000..c4dce75f --- /dev/null +++ b/docs/apps/_include/activemq.md @@ -0,0 +1,6 @@ +[Apache ActiveMQ](https://activemq.apache.org) 是老牌的开源消息总线，完全支持 JMS1.1 和 J2EE 1.4 规范，它支持多种语言和协议编写客户端。 + +![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-logined-websoft9.png) + + +部署 Websoft9 提供的 ActiveMQ 之后，请参考下面的步骤快速入门。 \ No newline at end of file diff --git a/docs/apps/_include/meta-zh.jinja2 b/docs/apps/_include/meta-zh.jinja2 new file mode 100644 index 00000000..ba7fca0b --- /dev/null +++ b/docs/apps/_include/meta-zh.jinja2 @@ -0,0 +1,15 @@ +# {{trademark}} + +{{overview}}。 + +简而言之，[{{trademark}}](websiteurl) 是一个 **{{summary}}**，它被用于 {% for catalog in catalog %} {{catalog.name}} {% endfor %} 等场景。 + +![screenshots[1].name]({{screenshots[1].url}}) + +## 准备 + +在参阅本文档使用 {{trademark}} 时，需要确保如下几点： + +- 应用是基于 Websoft9 安装的 +- 应用的用途符合 [{{license}}](license_url) 开源许可协议 +- 应用具备访问条件：[配置域名](./guide/appsetdomain) 或 **服务器安全组**开启网外端口 \ No newline at end of file diff --git a/docs/apps/_include/wordpress.md b/docs/apps/_include/wordpress.md new file mode 100644 index 00000000..b6fc4c62 --- /dev/null +++ b/docs/apps/_include/wordpress.md @@ -0,0 +1 @@ +hello \ No newline at end of file diff --git a/docs/apps/activemq.md b/docs/apps/activemq.md new file mode 100644 index 00000000..0d7cf917 --- /dev/null +++ b/docs/apps/activemq.md @@ -0,0 +1,144 @@ +--- +sidebar_position: 1 +slug: /activemq2 +tags: + - ActiveMQ + - IT 架构 + - 中间件 +--- + +import Meta from './_include/activemq.md'; + +# ActiveMQ + + + +## ActiveMQ 初始化 + +Websoft9 控制台安装完 ActiveMQ 后，即可根据【访问】标签页获取登录地址和账号。 + +![ActiveMQ初始化页面](http://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-login-websoft9.png) + +![ActiveMQ控制台](http://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-logined-websoft9.png) + +## ActiveMQ 指南 + +[Using Apache ActiveMQ](https://activemq.apache.org/using-activemq) + +### 修改控制台密码 + +进入ActiveMQ容器，通过 */opt/apache-activemq/conf/jetty-realm.properties* 文件修改，重启 [ActiveMQ 服务](#service)后生效 + +### 运行 ActiveMQ 演示 + +ActiveMQ 附带了许多 Web 演示，这些演示说明了如何将 ActiveMQ 代理与 REST 和 AJAX 一起使用。 Web 演示在默认配置中未激活，因此您必须按照以下步骤运行它们： + +1. 进入ActiveMQ容器，编辑 /opt/apache-activemq/examples/conf/activemq-demo.xml 文件并更改位置属性以反映加密凭证文件的位置，该文件位于 /opt/activemq/conf/credentials-enc.properties： + + ```shell + + file:${activemq.conf}/credentials-enc.properties + + ``` + +2. 如果 ActiveMQ 服务器当前正在运行，先停止： + + ```shell + docker stop activemq + ``` + +3. 运行示例： + + ```shell + docker exec -it activemq bash + cd /opt/activemq + sudo ./bin/activemq console xbean:/opt/activemq/examples/conf/activemq-demo.xml + ``` + +4. 等待 ActiveMQ 代理启动。 + +5. 登录到 Web 管理面板查看演示： *http://服务器公网 IP:8161/demo* + +### 配置消息 + +官方方案：http://activemq.apache.org/configuration.html + +## ActiveMQ 管理 + +### ActiveMQ 升级 + +ActiveMQ 主要采用二级制安装方式，其升级方案差不多等于安装： + +1. 进入容器，依次运行如下的命令做好准备： + ``` + docker exec -it activemq bash + # stop ActiveMQ service + systemctl stop activemq + + # rename the dir of ActiveMQ for backup + mv /opt/activemq /opt/activemqBK + ``` +2. 访问 ActiveMQ 官方网站，[下载](http://activemq.apache.org/components/classic/download/)后解压并上传到：*/opt* 目录，并命名为 *activemq* +3. 分别运行下面的修改权限 + ``` + chown -R activemq. /opt/activemq + chmod 640 /opt/activemq/examples/stomp/php/* + chmod +x /opt/activemq/bin/activemq + ``` +4. 重启 [ActiveMQ服务](../activemq#service) 后升级完成 + +### 运行调试模式 + +``` +docker exec -it activemq bash +systemctl stop activemq +/opt/activemq/bin/activemq console +``` + + + +## ActiveMQ 故障 + +#### ActiveMQ 服务无法启动？ + +1. 以调试模式运行`activemq console`，便可以查看启动状态和错误 + ``` + docker exec -it activemq bash + /opt/activemq/bin/activemq + ``` +2. 打开日志文件：*/opt/activemq/data/activemq.log*，检索 **failed** 关键词，分析错误原因 + +3. 常见的无法启动ActiveMQ服务的原因有如下几点： + + * 主机名不符合要求。例如：activemq5.6，这种包含"."的主机名就会导致ActiveMQ无法重启。参考如下命令重置主机名 + ``` + hostnamectl set-hostname activemq + ``` + * 缺乏Java的环境变量。通过：`echo $JAVA_HOME` 或 `which java` 查看反馈信息。 + + +#### 是否可以修改 ActiveMQ 的源码路径？ + +可以，但要参考如下的命令重试设置环境变量 +``` +echo 'export PATH="$PATH:/opt/activemq/bin"' >> /etc/profile +``` + +#### 如何修改上传的文件权限? + +```shell +docker exec -it activemq bash +chown -R activemq.activemq /opt/activemq +find /opt/activemq -type d -exec chmod 750 {} \; +find /opt/activemq -type f -exec chmod 640 {} \; +``` + +## ActiveMQ 问答 + +#### Active Classic vs ActiveMQ Artemis？ + +ActiveMQ Artemis 是 ActiveMQ 下一代产品，未来将替换 ActiveMQ Classic。 具体参考：[ActiveMQ Classic](https://activemq.apache.org/getting-started), [ActiveMQ Artemis](https://activemq.apache.org/components/artemis/documentation/) + +#### ActiveMQ 中是否包含 Tomcat？ + +ActiveMQ 官方提供的二级制包中包含 Tomcat，但已经集成到 ActiveMQ 服务中。 \ No newline at end of file diff --git a/docs/apps/activemq/admin.md b/docs/apps/activemq/admin.md index 2b438382..b63999a0 100644 --- a/docs/apps/activemq/admin.md +++ b/docs/apps/activemq/admin.md @@ -58,37 +58,3 @@ ActiveMQ 主要采用二级制安装方式，其升级方案差不多等于安 ## 常见问题 -#### Active Classic vs ActiveMQ Artemis？ - -ActiveMQ Artemis 是 ActiveMQ 下一代产品，未来将替换 ActiveMQ Classic。 具体参考：[ActiveMQ Classic](https://activemq.apache.org/getting-started), [ActiveMQ Artemis](https://activemq.apache.org/components/artemis/documentation/) - -#### 如何以调试模式启动ActiveMQ服务？ - -``` -docker exec -it activemq bash -systemctl stop activemq -/opt/activemq/bin/activemq console -``` -#### 如何退出 ActiveMQ 控制台？ - -暂无方案 - -#### ActiveMQ 中是否包含 Tomcat？ - -ActiveMQ 官方提供的二级制包中包含 Tomcat，但已经集成到 ActiveMQ 服务中。 - -#### 是否可以修改 ActiveMQ 的源码路径？ - -可以，但要参考如下的命令重试设置环境变量 -``` -echo 'export PATH="$PATH:/opt/activemq/bin"' >> /etc/profile -``` - -#### 如何修改上传的文件权限? - -```shell -docker exec -it activemq bash -chown -R activemq.activemq /opt/activemq -find /opt/activemq -type d -exec chmod 750 {} \; -find /opt/activemq -type f -exec chmod 640 {} \; -``` diff --git a/docs/apps/activemq/readme.md b/docs/apps/activemq/readme.md index 86f5557a..7f0ef590 100644 --- a/docs/apps/activemq/readme.md +++ b/docs/apps/activemq/readme.md @@ -26,7 +26,7 @@ tags: ## ActiveMQ 初始化向导 -### 详细步骤 + 1. 使用本地电脑浏览器访问网址：*http://域名:8161* 或 *http://服务器公网IP:8161*, 进入初始化页面 ![ActiveMQ初始化页面](http://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-login-websoft9.png) @@ -35,53 +35,17 @@ tags: ![ActiveMQ控制台](http://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-logined-websoft9.png) -### 出现问题？ +## ActiveMQ 使用入门 -若碰到问题，请第一时刻联系 **[技术支持](./helpdesk)**。也可以先参考下面列出的问题定位或 **[FAQ](./faq#setup)** 尝试快速解决问题。 +### 访问 -## ActiveMQ 使用入门 +### [Using Apache ActiveMQ](https://activemq.apache.org/using-activemq) ## ActiveMQ 常用操作 -### 修改控制台密码 - -进入ActiveMQ容器，通过 */opt/apache-activemq/conf/jetty-realm.properties* 文件修改，重启 [ActiveMQ 服务](#service)后生效 - -### 运行 ActiveMQ 演示 - -ActiveMQ 附带了许多 Web 演示，这些演示说明了如何将 ActiveMQ 代理与 REST 和 AJAX 一起使用。 Web 演示在默认配置中未激活，因此您必须按照以下步骤运行它们： - -1. 进入ActiveMQ容器，编辑 /opt/apache-activemq/examples/conf/activemq-demo.xml 文件并更改位置属性以反映加密凭证文件的位置，该文件位于 /opt/activemq/conf/credentials-enc.properties： - - ```shell - - file:${activemq.conf}/credentials-enc.properties - - ``` - -2. 如果 ActiveMQ 服务器当前正在运行，先停止： - - ```shell - docker stop activemq - ``` - -3. 运行示例： - - ```shell - docker exec -it activemq bash - cd /opt/activemq - sudo ./bin/activemq console xbean:/opt/activemq/examples/conf/activemq-demo.xml - ``` - -4. 等待 ActiveMQ 代理启动。 - -5. 登录到 Web 管理面板查看演示： *http://服务器公网 IP:8161/demo* - -### 配置消息 -官方方案：http://activemq.apache.org/configuration.html ## 参数