743 lines
14 KiB
Markdown
743 lines
14 KiB
Markdown
# 服务器部署运行指南
|
||
|
||
> TPS测试工具服务器部署和使用说明
|
||
|
||
---
|
||
|
||
## 📦 打包部署包
|
||
|
||
### 1. 在本地打包
|
||
|
||
```bash
|
||
cd /Users/kiro/IdeaProjects/contract
|
||
|
||
# 清理并打包（使用 fatJar 任务）
|
||
./gradlew clean fatJar
|
||
|
||
# 查看生成的 jar 文件
|
||
ls -lh build/libs/tps-test.jar
|
||
```
|
||
|
||
**输出：** `build/libs/tps-test.jar` （约 25MB，包含所有依赖）
|
||
|
||
**注意：** 必须使用 `./gradlew fatJar` 命令打包，这样才会生成包含所有依赖的可执行jar文件。
|
||
|
||
### 2. 准备部署文件
|
||
|
||
需要上传到服务器的文件：
|
||
|
||
```
|
||
部署包/
|
||
├── tps-test.jar # 可执行jar（必需）
|
||
└── config.toml # 链连接配置（必需）
|
||
```
|
||
|
||
从本地复制配置文件：
|
||
```bash
|
||
# 复制配置文件到 build 目录
|
||
cp src/main/resources/config.toml build/libs/
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 上传到服务器
|
||
|
||
### 方法1：使用 SCP 上传
|
||
|
||
```bash
|
||
# 1. 创建本地部署目录
|
||
cd /Users/kiro/IdeaProjects/contract
|
||
mkdir -p deploy
|
||
cp build/libs/tps-test.jar deploy/
|
||
cp src/main/resources/config.toml deploy/
|
||
|
||
# 2. 上传到服务器
|
||
scp -r deploy/* root@121.196.226.157:~/tps-test/
|
||
|
||
# 如果需要上传到第二台服务器
|
||
scp -r deploy/* root@8.137.93.11:~/tps-test/
|
||
```
|
||
|
||
### 方法2：使用 rsync 上传（推荐）
|
||
|
||
```bash
|
||
# 自动创建目录并上传
|
||
rsync -avz --progress \
|
||
build/libs/tps-test.jar \
|
||
src/main/resources/config.toml \
|
||
root@121.196.226.157:~/tps-test/
|
||
```
|
||
|
||
---
|
||
|
||
## ⚙️ 服务器端配置
|
||
|
||
### 1. SSH 登录到服务器
|
||
|
||
```bash
|
||
ssh root@121.196.226.157
|
||
```
|
||
|
||
### 2. 检查 Java 环境
|
||
|
||
```bash
|
||
# 检查 Java 版本（需要 JDK 11+）
|
||
java -version
|
||
|
||
# 如果没有安装，安装 OpenJDK
|
||
# Ubuntu/Debian
|
||
sudo apt update && sudo apt install -y openjdk-11-jdk
|
||
|
||
# CentOS/RHEL
|
||
sudo yum install -y java-11-openjdk
|
||
```
|
||
|
||
### 3. 验证文件
|
||
|
||
```bash
|
||
cd ~/tps-test
|
||
ls -lh
|
||
|
||
# 应该看到：
|
||
# tps-test.jar (约 30-40MB)
|
||
# config.toml
|
||
```
|
||
|
||
### 4. 修改配置文件（如需要）
|
||
|
||
```bash
|
||
# 编辑配置文件，确保连接到本地节点
|
||
vim config.toml
|
||
```
|
||
|
||
**如果在服务器上运行，建议使用本地地址：**
|
||
```toml
|
||
[network]
|
||
peers=["127.0.0.1:20200"] # 使用本地节点，延迟最低
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 运行测试
|
||
|
||
### 基本用法
|
||
|
||
```bash
|
||
cd ~/tps-test
|
||
|
||
# 查看帮助
|
||
java -jar tps-test.jar --help
|
||
|
||
# 使用默认参数（100线程，10000笔交易）
|
||
java -jar tps-test.jar -c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
```
|
||
|
||
### 命令行参数说明
|
||
|
||
| 参数 | 简写 | 说明 | 默认值 |
|
||
|------|------|------|--------|
|
||
| `--threads` | `-t` | 并发线程数 | 100 |
|
||
| `--transactions` | `-n` | 总交易数 | 10000 |
|
||
| `--qps` | `-q` | QPS限制，0表示不限 | 0 |
|
||
| `--contract` | `-c` | **合约地址（必填）** | 无 |
|
||
| `--accounts` | `-a` | 测试账户数 | 100 |
|
||
| `--help` | `-h` | 显示帮助 | - |
|
||
|
||
### 常用测试场景
|
||
|
||
#### 场景1：快速验证（1000笔）
|
||
|
||
```bash
|
||
java -jar tps-test.jar \
|
||
-t 50 \
|
||
-n 1000 \
|
||
-c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
```
|
||
|
||
#### 场景2：标准压测（10000笔）
|
||
|
||
```bash
|
||
java -jar tps-test.jar \
|
||
-t 100 \
|
||
-n 10000 \
|
||
-c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
```
|
||
|
||
#### 场景3：大规模压测（50000笔）
|
||
|
||
```bash
|
||
java -jar tps-test.jar \
|
||
-t 200 \
|
||
-n 50000 \
|
||
-c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
```
|
||
|
||
#### 场景4：极限压测（100000笔）
|
||
|
||
```bash
|
||
java -jar tps-test.jar \
|
||
-t 500 \
|
||
-n 100000 \
|
||
-c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
```
|
||
|
||
#### 场景5：限速测试
|
||
|
||
```bash
|
||
# 限制 QPS 为 5000
|
||
java -jar tps-test.jar \
|
||
-t 100 \
|
||
-n 50000 \
|
||
-q 5000 \
|
||
-c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 后台运行和日志管理
|
||
|
||
### 1. 后台运行测试
|
||
|
||
```bash
|
||
# 使用 nohup 后台运行，输出重定向到日志文件
|
||
nohup java -jar tps-test.jar \
|
||
-t 200 \
|
||
-n 100000 \
|
||
-c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4 \
|
||
> tps_test.log 2>&1 &
|
||
|
||
# 查看进程
|
||
ps aux | grep tps-test
|
||
|
||
# 实时查看日志
|
||
tail -f tps_test.log
|
||
```
|
||
|
||
### 2. 使用 screen（推荐）
|
||
|
||
```bash
|
||
# 安装 screen（如果没有）
|
||
sudo apt install screen # Ubuntu/Debian
|
||
sudo yum install screen # CentOS/RHEL
|
||
|
||
# 创建新会话
|
||
screen -S tps-test
|
||
|
||
# 运行测试
|
||
java -jar tps-test.jar -t 200 -n 100000 -c 0x06ac...
|
||
|
||
# 断开会话（按键）：Ctrl+A，然后按 D
|
||
# 重新连接：screen -r tps-test
|
||
# 查看所有会话：screen -ls
|
||
```
|
||
|
||
### 3. 查看测试报告
|
||
|
||
```bash
|
||
# 测试完成后，会生成报告文件
|
||
ls -lt tps_test_report_*.txt | head -5
|
||
|
||
# 查看最新报告
|
||
cat $(ls -t tps_test_report_*.txt | head -1)
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 批量测试脚本
|
||
|
||
创建一个自动化测试脚本：
|
||
|
||
```bash
|
||
# 创建测试脚本
|
||
cat > run_tps_tests.sh << 'EOF'
|
||
#!/bin/bash
|
||
|
||
# TPS 自动化测试脚本
|
||
CONTRACT="0x06ac2fe406f1ae06494946ee281d58f1c79c39e4"
|
||
JAR="tps-test.jar"
|
||
|
||
echo "======================================"
|
||
echo " FISCO BCOS TPS 自动化测试"
|
||
echo "======================================"
|
||
echo ""
|
||
|
||
# 测试配置数组（线程数 交易数 描述）
|
||
tests=(
|
||
"50:5000:快速验证"
|
||
"100:10000:基础压测"
|
||
"200:10000:中等压测"
|
||
"400:10000:高并发压测"
|
||
)
|
||
|
||
# 循环执行测试
|
||
for test in "${tests[@]}"; do
|
||
IFS=':' read -r threads txs desc <<< "$test"
|
||
|
||
echo ""
|
||
echo "======================================"
|
||
echo "测试: $desc"
|
||
echo "并发数: $threads, 交易数: $txs"
|
||
echo "======================================"
|
||
echo ""
|
||
|
||
java -jar $JAR -t $threads -n $txs -c $CONTRACT
|
||
|
||
echo ""
|
||
echo "等待10秒后开始下一轮测试..."
|
||
sleep 10
|
||
done
|
||
|
||
echo ""
|
||
echo "======================================"
|
||
echo "所有测试完成！"
|
||
echo "======================================"
|
||
|
||
# 汇总报告
|
||
echo ""
|
||
echo "测试报告列表："
|
||
ls -lt tps_test_report_*.txt | head -10
|
||
EOF
|
||
|
||
# 给脚本添加执行权限
|
||
chmod +x run_tps_tests.sh
|
||
|
||
# 运行自动化测试
|
||
./run_tps_tests.sh
|
||
```
|
||
|
||
---
|
||
|
||
## 📈 分阶段找准确TPS的脚本
|
||
|
||
基于文档中推荐的测试方法：
|
||
|
||
```bash
|
||
cat > find_optimal_tps.sh << 'EOF'
|
||
#!/bin/bash
|
||
|
||
# 二分法找最佳TPS脚本
|
||
CONTRACT="0x06ac2fe406f1ae06494946ee281d58f1c79c39e4"
|
||
JAR="tps-test.jar"
|
||
|
||
echo "======================================"
|
||
echo " 寻找最佳 TPS 配置"
|
||
echo "======================================"
|
||
echo ""
|
||
|
||
# 阶段1：基准测试
|
||
echo "[阶段1] 基准测试（单线程）"
|
||
java -jar $JAR -t 1 -n 100 -c $CONTRACT
|
||
echo ""
|
||
read -p "按 Enter 继续..."
|
||
|
||
# 阶段2：逐步增加并发
|
||
threads_list=(50 100 200 400)
|
||
|
||
for threads in "${threads_list[@]}"; do
|
||
echo ""
|
||
echo "======================================"
|
||
echo "[阶段2] 测试 $threads 线程"
|
||
echo "======================================"
|
||
echo ""
|
||
|
||
java -jar $JAR -t $threads -n 5000 -c $CONTRACT
|
||
|
||
echo ""
|
||
read -p "成功率是否 ≥99%？(y/n): " answer
|
||
|
||
if [ "$answer" != "y" ]; then
|
||
echo "成功率低于99%，建议使用上一个并发数"
|
||
last_good=$((threads / 2))
|
||
echo "建议最佳并发数: $last_good"
|
||
|
||
echo ""
|
||
read -p "是否用最佳并发数运行峰值测试？(y/n): " peak_test
|
||
|
||
if [ "$peak_test" = "y" ]; then
|
||
echo ""
|
||
echo "======================================"
|
||
echo "[阶段3] 峰值测试"
|
||
echo "======================================"
|
||
echo ""
|
||
java -jar $JAR -t $last_good -n 50000 -c $CONTRACT
|
||
fi
|
||
|
||
break
|
||
fi
|
||
done
|
||
|
||
echo ""
|
||
echo "======================================"
|
||
echo "测试完成！"
|
||
echo "======================================"
|
||
EOF
|
||
|
||
chmod +x find_optimal_tps.sh
|
||
./find_optimal_tps.sh
|
||
```
|
||
|
||
---
|
||
|
||
## 🔍 监控和诊断
|
||
|
||
### 1. 实时监控测试进程
|
||
|
||
```bash
|
||
# 监控 CPU 和内存
|
||
top -p $(pgrep -f tps-test.jar)
|
||
|
||
# 监控网络连接
|
||
watch -n 1 'netstat -antp | grep 20200'
|
||
```
|
||
|
||
### 2. 查看节点日志
|
||
|
||
```bash
|
||
# 查看节点日志
|
||
tail -f ~/fisco/nodes/*/node0/log/log* | grep -E "ERROR|TPS"
|
||
|
||
# 查看交易池状态
|
||
cd ~/fisco/console
|
||
bash start.sh
|
||
# 执行：getPendingTxSize
|
||
```
|
||
|
||
### 3. 系统资源监控
|
||
|
||
```bash
|
||
# 整体系统监控
|
||
htop
|
||
|
||
# 磁盘 IO
|
||
iostat -x 1
|
||
|
||
# 网络流量
|
||
iftop -i eth0
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 常见问题
|
||
|
||
### 问题1：找不到或无法加载主类
|
||
|
||
**错误信息：**
|
||
```
|
||
Error: Could not find or load main class com.org.fisco.TPSTest
|
||
```
|
||
|
||
**原因：** jar文件打包不正确，缺少依赖类
|
||
|
||
**解决：**
|
||
```bash
|
||
# 1. 必须使用 fatJar 任务打包
|
||
cd /Users/kiro/IdeaProjects/contract
|
||
./gradlew clean fatJar
|
||
|
||
# 2. 验证jar文件可以运行
|
||
java -jar build/libs/tps-test.jar --help
|
||
|
||
# 3. 重新上传到服务器
|
||
scp build/libs/tps-test.jar root@服务器IP:~/tps-test/
|
||
```
|
||
|
||
**注意：** 不要使用 `./gradlew build`，必须使用 `./gradlew fatJar`
|
||
|
||
### 问题2：找不到 config.toml
|
||
|
||
**错误信息：**
|
||
```
|
||
错误: 找不到配置文件 config.toml
|
||
```
|
||
|
||
**解决：**
|
||
```bash
|
||
# 确保 config.toml 在当前目录
|
||
cd ~/tps-test
|
||
ls config.toml
|
||
|
||
# 或者从 console 复制
|
||
cp ~/fisco/console/conf/config.toml .
|
||
```
|
||
|
||
### 问题3：连接节点失败
|
||
|
||
**错误信息：**
|
||
```
|
||
连接FISCO BCOS节点失败
|
||
```
|
||
|
||
**解决：**
|
||
```bash
|
||
# 1. 检查节点是否运行
|
||
ps aux | grep fisco-bcos
|
||
|
||
# 2. 检查端口是否监听
|
||
netstat -tlnp | grep 20200
|
||
|
||
# 3. 测试连接
|
||
telnet 127.0.0.1 20200
|
||
|
||
# 4. 修改 config.toml 使用正确的地址
|
||
vim config.toml
|
||
```
|
||
|
||
### 问题4：内存不足
|
||
|
||
**错误信息：**
|
||
```
|
||
java.lang.OutOfMemoryError
|
||
```
|
||
|
||
**解决：**
|
||
```bash
|
||
# 增加 JVM 内存
|
||
java -Xmx4g -Xms2g -jar tps-test.jar -t 200 -n 50000 -c 0x06ac...
|
||
```
|
||
|
||
### 问题5：程序卡住不动
|
||
|
||
**排查：**
|
||
```bash
|
||
# 1. 查看是否有错误日志
|
||
tail -100 tps_test.log
|
||
|
||
# 2. 检查网络连接
|
||
netstat -antp | grep 20200
|
||
|
||
# 3. 检查节点是否正常
|
||
cd ~/fisco/nodes/*/node0
|
||
tail -50 log/log*
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 最佳实践
|
||
|
||
### 1. 在服务器上测试的优势
|
||
|
||
✅ **延迟更低**：本地网络延迟通常 < 1ms
|
||
✅ **TPS更高**：网络不是瓶颈
|
||
✅ **结果更准**：排除网络抖动影响
|
||
|
||
### 2. 推荐的测试流程
|
||
|
||
```bash
|
||
# 第一步：快速验证
|
||
java -jar tps-test.jar -t 50 -n 1000 -c 0x06ac...
|
||
|
||
# 第二步：基础测试
|
||
java -jar tps-test.jar -t 100 -n 10000 -c 0x06ac...
|
||
|
||
# 第三步：根据成功率调整
|
||
# 如果成功率 ≥ 99%，增加并发到 200
|
||
# 如果成功率 < 99%，保持或降低并发
|
||
|
||
# 第四步：峰值测试
|
||
java -jar tps-test.jar -t [最佳并发] -n 50000 -c 0x06ac...
|
||
```
|
||
|
||
### 3. 参数选择建议
|
||
|
||
| 节点配置 | 推荐并发数 | 推荐交易数 |
|
||
|---------|----------|----------|
|
||
| 2C4G | 50-100 | 10000 |
|
||
| 4C8G | 100-200 | 50000 |
|
||
| 8C16G | 200-500 | 100000 |
|
||
|
||
---
|
||
|
||
## 📝 测试记录模板
|
||
|
||
建议每次测试记录：
|
||
|
||
```bash
|
||
# 创建测试记录文件
|
||
cat > test_record_$(date +%Y%m%d).md << 'EOF'
|
||
# TPS测试记录
|
||
|
||
## 测试日期
|
||
2026-02-10
|
||
|
||
## 测试环境
|
||
- 服务器: 121.196.226.157
|
||
- 节点配置: 4C8G SSD
|
||
- enable_parallel: true
|
||
- max_trans_num_per_block: 1000
|
||
|
||
## 测试结果
|
||
|
||
### 测试1
|
||
- 命令: java -jar tps-test.jar -t 100 -n 10000 -c 0x06ac...
|
||
- TPS:
|
||
- 成功率:
|
||
- 平均延迟:
|
||
|
||
### 测试2
|
||
- 命令:
|
||
- TPS:
|
||
- 成功率:
|
||
- 平均延迟:
|
||
|
||
## 结论
|
||
最佳并发数:
|
||
峰值TPS:
|
||
|
||
## 优化建议
|
||
|
||
EOF
|
||
|
||
vim test_record_$(date +%Y%m%d).md
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 更新部署
|
||
|
||
当代码有更新时：
|
||
|
||
```bash
|
||
# 本地重新打包
|
||
cd /Users/kiro/IdeaProjects/contract
|
||
./gradlew clean fatJar
|
||
|
||
# 验证jar可以运行
|
||
java -jar build/libs/tps-test.jar --help
|
||
|
||
# 上传到服务器（覆盖旧版本）
|
||
scp build/libs/tps-test.jar root@121.196.226.157:~/tps-test/
|
||
|
||
# 服务器上重新运行测试
|
||
ssh root@121.196.226.157
|
||
cd ~/tps-test
|
||
java -jar tps-test.jar -t 100 -n 10000 -c 0x06ac...
|
||
```
|
||
|
||
---
|
||
|
||
## 📞 快速命令参考
|
||
|
||
```bash
|
||
# 本地打包
|
||
cd /Users/kiro/IdeaProjects/contract
|
||
./gradlew clean fatJar
|
||
|
||
# 验证打包（本地测试）
|
||
java -jar build/libs/tps-test.jar --help
|
||
|
||
# 上传到服务器
|
||
scp build/libs/tps-test.jar src/main/resources/config.toml root@121.196.226.157:~/tps-test/
|
||
|
||
# SSH到服务器运行
|
||
ssh root@121.196.226.157
|
||
cd ~/tps-test
|
||
|
||
# 测试帮助
|
||
java -jar tps-test.jar --help
|
||
|
||
# 运行测试
|
||
java -jar tps-test.jar -t 100 -n 10000 -c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
|
||
# 查看报告
|
||
cat $(ls -t tps_test_report_*.txt | head -1)
|
||
```
|
||
|
||
---
|
||
|
||
## 🎓 完整部署示例
|
||
|
||
### 从零开始的完整流程
|
||
|
||
```bash
|
||
# ========================================
|
||
# 第一步：在本地打包
|
||
# ========================================
|
||
cd /Users/kiro/IdeaProjects/contract
|
||
|
||
# 清理并打包
|
||
./gradlew clean fatJar
|
||
|
||
# 验证jar文件
|
||
java -jar build/libs/tps-test.jar --help
|
||
# 应该显示帮助信息，如果报错说明打包有问题
|
||
|
||
|
||
# ========================================
|
||
# 第二步：准备部署文件
|
||
# ========================================
|
||
mkdir -p deploy
|
||
cp build/libs/tps-test.jar deploy/
|
||
cp src/main/resources/config.toml deploy/
|
||
|
||
# 查看文件
|
||
ls -lh deploy/
|
||
# 应该看到：
|
||
# tps-test.jar (约 25MB)
|
||
# config.toml
|
||
|
||
|
||
# ========================================
|
||
# 第三步：上传到服务器
|
||
# ========================================
|
||
# 方式1：使用 scp
|
||
scp deploy/tps-test.jar deploy/config.toml root@121.196.226.157:~/tps-test/
|
||
|
||
# 方式2：使用 rsync（推荐）
|
||
rsync -avz --progress deploy/* root@121.196.226.157:~/tps-test/
|
||
|
||
|
||
# ========================================
|
||
# 第四步：SSH到服务器配置
|
||
# ========================================
|
||
ssh root@121.196.226.157
|
||
|
||
# 进入目录
|
||
cd ~/tps-test
|
||
|
||
# 检查文件
|
||
ls -lh
|
||
# 应该看到 tps-test.jar 和 config.toml
|
||
|
||
# 检查Java版本（需要JDK 11+）
|
||
java -version
|
||
|
||
# 编辑配置文件，使用本地节点地址
|
||
vim config.toml
|
||
# 修改为：peers=["127.0.0.1:20200"]
|
||
|
||
# 测试jar文件
|
||
java -jar tps-test.jar --help
|
||
# 应该显示帮助信息
|
||
|
||
|
||
# ========================================
|
||
# 第五步：运行测试
|
||
# ========================================
|
||
|
||
# 快速验证（1000笔）
|
||
java -jar tps-test.jar -t 50 -n 1000 -c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
|
||
# 如果上面的测试成功，运行正式测试
|
||
java -jar tps-test.jar -t 100 -n 10000 -c 0x06ac2fe406f1ae06494946ee281d58f1c79c39e4
|
||
|
||
# 查看生成的报告
|
||
cat $(ls -t tps_test_report_*.txt | head -1)
|
||
```
|
||
|
||
---
|
||
|
||
## 🔍 验证清单
|
||
|
||
部署后请按此清单验证：
|
||
|
||
- [ ] jar文件大小约25MB（太小说明没打包依赖）
|
||
- [ ] 本地能运行 `java -jar build/libs/tps-test.jar --help`
|
||
- [ ] 服务器上能显示帮助信息
|
||
- [ ] config.toml 配置了正确的节点地址
|
||
- [ ] 能连接到节点（显示区块高度）
|
||
- [ ] 测试能正常运行并生成报告
|
||
|
||
---
|
||
|
||
**祝测试顺利！** 🚀
|