Hippo4j 线程池监控平台部署手册

Hippo4j 线程池监控平台部署手册

本文记录在 Ubuntu 虚拟机192.168.93.128上部署 Hippo4j Server 的完整过程。命令按顺序复制执行即可。

1. 登录虚拟机

前提：本机已经配置过 SSH 免密登录。

sshubuntu@192.168.93.128

如果还没配置免密，也可以用密码登录：

sshubuntu@192.168.93.128

账号密码：

ubuntu / 123456

2. 检查基础环境

Hippo4j Server 1.5.0 可以使用 Java 8 运行，需要 MySQL 存储配置数据。

java-versionmysql--versionwget--version|head-1tar--version|head-1

如果缺少 Java 或 MySQL，执行：

sudoapt-getupdatesudoapt-getinstall-yopenjdk-8-jdk mysql-serverwgettar

如果 sudo 要密码，输入：

123456

3. 下载 Hippo4j Server

部署目录统一放在/home/ubuntu/hippo4j-server。

cd/home/ubuntumkdir-p/home/ubuntu/hippo4j-downloadcd/home/ubuntu/hippo4j-downloadwget-Ohippo4j-server-1.5.0.tar.gz\https://github.com/opengoofy/hippo4j/releases/download/v1.5.0/hippo4j-server-1.5.0.tar.gzrm-rf/home/ubuntu/hippo4j-servertar-xzfhippo4j-server-1.5.0.tar.gz-C/home/ubuntu

确认解压成功：

ls-lah/home/ubuntu/hippo4j-serverfind/home/ubuntu/hippo4j-server-maxdepth2-typef|sort

关键文件：

/home/ubuntu/hippo4j-server/bin/startup.sh /home/ubuntu/hippo4j-server/bin/shutdown.sh /home/ubuntu/hippo4j-server/conf/application.properties /home/ubuntu/hippo4j-server/conf/hippo4j_manager.sql /home/ubuntu/hippo4j-server/target/hippo4j-server.jar

4. 初始化 MySQL 数据库

Hippo4j 自带初始化 SQL：

/home/ubuntu/hippo4j-server/conf/hippo4j_manager.sql

先确认 MySQL 正在运行：

systemctl is-active mysql

如果不是active，启动 MySQL：

sudosystemctl start mysqlsudosystemctlenablemysql

导入 Hippo4j 数据库：

cd/home/ubuntu/hippo4j-server mysql-uroot-p123456<conf/hippo4j_manager.sql

创建 Hippo4j 专用数据库账号：

mysql-uroot-p123456<<'SQL' CREATE USER IF NOT EXISTS 'hippo4j'@'localhost' IDENTIFIED BY 'hippo4j_pwd'; GRANT ALL PRIVILEGES ON hippo4j_manager.* TO 'hippo4j'@'localhost'; FLUSH PRIVILEGES; SELECT COUNT(*) AS tables_count FROM information_schema.tables WHERE table_schema='hippo4j_manager'; SQL

正常结果里tables_count应该是：

11

5. 修改 Hippo4j 配置

编辑配置文件：

cd/home/ubuntu/hippo4j-servercpconf/application.properties conf/application.properties.baksed-i's/^spring.datasource.username=.*/spring.datasource.username=hippo4j/'conf/application.propertiessed-i's/^spring.datasource.password=.*/spring.datasource.password=hippo4j_pwd/'conf/application.properties

确认配置：

grep-E'server.port|spring.datasource.url|spring.datasource.username|spring.datasource.password'\conf/application.properties

期望结果：

server.port=6691 spring.datasource.url=jdbc:mysql://localhost:3306/hippo4j_manager?characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&transformedBitIsBoolean=true&serverTimezone=GMT%2B8 spring.datasource.username=hippo4j spring.datasource.password=hippo4j_pwd

6. 启动 Hippo4j Server

给启动脚本加执行权限：

cd/home/ubuntu/hippo4j-serverchmod+x bin/startup.sh bin/shutdown.sh

启动：

cd/home/ubuntu/hippo4j-serverexportJAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64exportJAVA_OPT_EXT='-Xms256m -Xmx512m -Xmn128m'shbin/startup.sh

说明：

默认脚本会带 -Xms1024m -Xmx1024m。 这里追加 JAVA_OPT_EXT，是为了在当前虚拟机同时运行 RocketMQ、Redis、XXL-JOB、Dashboard 时降低内存压力。

7. 验证启动状态

查看进程：

pgrep-af'hippo4j-server.jar'

查看端口：

ss-ltnp|grep':6691'

如果系统没有ss，用：

netstat-ltnp|grep':6691'

查看启动日志：

tail-160/home/ubuntu/hippo4j-server/logs/start.out

看到下面内容表示启动成功：

Hippo4j started successfully Port: 6691

验证 Web 页面：

wget-qO---timeout=5http://127.0.0.1:6691/index.html|head-5

能看到 HTML 返回即可。

8. 访问控制台

浏览器打开：

http://192.168.93.128:6691/index.html

默认账号：

admin / 123456

9. 停止 Hippo4j

推荐使用自带停止脚本：

cd/home/ubuntu/hippo4j-servershbin/shutdown.sh

如果脚本没有停掉，可以手动停止：

pkill-f'hippo4j-server.jar'

确认已停止：

pgrep-af'hippo4j-server.jar'||echo'Hippo4j stopped'

10. 重启 Hippo4j

cd/home/ubuntu/hippo4j-serverpkill-f'hippo4j-server.jar'||trueexportJAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64exportJAVA_OPT_EXT='-Xms256m -Xmx512m -Xmn128m'shbin/startup.shsleep10pgrep-af'hippo4j-server.jar'ss-ltnp|grep':6691'

11. 常见问题

端口 6691 被占用

检查占用进程：

ss-ltnp|grep':6691'

如果要换端口，例如改成6692：

cd/home/ubuntu/hippo4j-serversed-i's/^server.port=.*/server.port=6692/'conf/application.properties

然后重启。

数据库连接失败

检查 MySQL：

systemctl status mysql --no-pager mysql-uhippo4j-phippo4j_pwd-e'USE hippo4j_manager; SHOW TABLES;'

检查配置：

grep-E'spring.datasource.url|spring.datasource.username|spring.datasource.password'\/home/ubuntu/hippo4j-server/conf/application.properties

页面打不开

在虚拟机内部先测：

wget-qO---timeout=5http://127.0.0.1:6691/index.html|head

如果虚拟机内部能打开，宿主机打不开，检查网络和防火墙：

ipaddrsudoufw status

临时放行端口：

sudoufw allow6691/tcp

内存不足

查看内存：

free-h

启动时继续使用小内存参数：

exportJAVA_OPT_EXT='-Xms256m -Xmx512m -Xmn128m'sh/home/ubuntu/hippo4j-server/bin/startup.sh

12. 本次部署结果

本次实际部署信息：

主机: 192.168.93.128 安装目录: /home/ubuntu/hippo4j-server 版本: Hippo4j Server 1.5.0 端口: 6691 数据库: hippo4j_manager 数据库账号: hippo4j / hippo4j_pwd Web 地址: http://192.168.93.128:6691/index.html 默认登录: admin / 123456

本次已验证：

6691 正在监听 Web 首页可访问 MySQL 中 11 张表已创建 默认 admin 用户存在 日志显示 Hippo4j started successfully