安装部署相关

1 重启安装服务器后，如何启动 MeterSphere 相关组件？

MeterSphere 在安装过程中没有配置 docker 及其相关容器的自启动。当用户重新启动部署服务器之后，需要手动启动 docker 服务及 MeterSphere 相关容器。

service docker start
msctl start
msctl status

2 如何修改应用的默认端口？

修改 /opt/metersphere/.env 文件中的对应配置后，执行 msctl reload 命令重新加载应用。

配置文件说明请参考 修改安装配置(可选)。

3 如何在 Kubernetes 中搭建 MeterSphere？

可以参照我们提供的 helm chart。 详见在线文档/安装部署/Kubernetes中部署：https://metersphere.io/docs/v2.x/installation/kubernetes_installation/

4 docker-compose 版本与配置文件不兼容，请重新安装最新版本的 docker-compose?

把安装包里的docker-compose-xx 在 安装目录替换下。

5 升级指定版本

msctl upgrade 后边跟版本号，如 msctl upgrade v1.10.6-lts 。

6 卸载命令

msctl uninstall -v

7 重新安装命令

进入到安装包，然后重新执行 ./install.sh 。

8 卸载会导致数据清空么？

卸载不会影响数据

9 升级报 /usr/local/bin/msctl: line 115 ....

cat /usr/local/bin/msctl 查看这个文件对应行数的代码，并进行相关处理。

10 升级报 Schema metersphere contains a faied migration to version 86 !

到 github 源码上 https://github.com/metersphere/metersphere/tree/v2.3.1/system-setting/backend/src/main/resources/db/migration 下载对应文件名带 86 的 flyway sql，然后重新手动一条条执行下，全部执行成功后修改 metersphere_version 表对应版本的 success 值为1，然后 msctl reload 重启服务即可。

11 如何备份数据库?

docker exec -i mysql mysqldump -uroot -pPassword123@mysql metersphere > metersphere.sql

12 mysqldump: Error 2020: Got packet bigger than 'max_allowed_packet' bytes when dumping tableapi_scenario_report_detailat row: 94

添加max_allowed_packet参数，如下。
docker exec -i mysql mysqldump -uroot -pPassword123@mysql metersphere --max_allowed_packet=2G > metersphere.sql

13 关于”Log4j2远程代码执行漏洞”的修复

由于 MeterSphere 使用到的 Kafka 及依赖的 JMeter 会受此漏洞的影响，在 Kafka 及 JMeter 发布解决该漏洞的版本前，用户可以手动在 docker compose 文件 (docker-compose-kafka.yml，docker-compose-node-controller.yml 及 docker-compose-server.yml) 里添加 FORMAT_MESSAGES_PATTERN_DISABLE_LOOKUPS: 'true' 环境变量规避此问题。

具体修改方式请参考该 GitHub Commit，修改完成后执行 msctl reload 命令重建容器使环境变量生效。

14 性能测试时并发量加大的时候报错Non HTTP response code: java.net.SocketTimeoutException

修改单个接口的连接超时时间。

15 docker-compose 版本与配置文件不兼容，提示请重新安装最新版本的 docker-compose。

可以把安装包里的docker-compose-xx 在安装目录替换一下。

16 设置数据库忽略大小未生效，lower_case_table_names=1

chmod /opt/metersphere/conf/my.cnf 
然后重启数据库 docker restart mysql

17 如何删除kafka中的临时数据，减低磁盘使用率

docker stop kafka；
docker stop zookeeper；
docker rm kafka；
docker rm zookeeper；
rm -rf /opt/metersphere/data/kafka/kafka；
rm -rf /opt/metersphere/data/zookeeper/zookeeper；
msctl reload；

18 执行机经常报内存溢出 Terminating due to java.lang.OutOfMemoryError: GC overhead limit exceeded

增大堆内存:
set JAVA_OPTS=-server -Xms512m -Xmx1024m -XX:MaxNewSize=1024m -XX:MaxPermSize=1024m;

19 jenkins插件验证通过后找不到工作空间

检查地址，地址里多了/login路径会出现这个现象

20 jar包存储位置

/opt/metersphere/data/jar

21 升级或安装时后台报错:image not found : xxxxxx；

需要在执行机上docker pull该镜像，或下载完整离线安装包；

22 前端执行性能测试或接口场景报错：请检查当前站点url配置；

本地搭建的可能要把localhost改为具体IP；

23 部署和升级时后台报错：error: ms-data-streaming is unhealthy； error:encountered errors while bringing up the project；

msctl uninstall卸载，ifconfig检查多余网桥，brctl delbr 网桥名称 删除多余网桥，msctl reload重启；

24 怎样监控被压测的机器

在被测服安装node-exporter服务，然后在性能测试-高级配置里添加监控，填写被测服务器上node-exporter服务的ip和端口以及监控项

25 忘记 MeterSphere密码

进入容器: docker exec -it mysql bash，再登录mysql -uroot -pPassword123@mysql
使用数据库: use metersphere;
更新密码为metersphere: update user set password='3259a9d7f208ef9690025d1432558c5b' where id='admin';

26 日志报缺少某些类的属性

这种情况大概率是安装包不全，或者镜像版本不一致导致的，可以重新下载安装包来进行镜像替换后或者重新安装来解决；

27 系统运行一段时间后磁盘可以清理哪些东西来释放磁盘

1.可以删除多余的镜像；
2.可以删除历史log文件；
3.如果没任务执行时可以删除/opt/metersphere/data/kafka/kafka和/opt/metersphere/data/zookeeper/zookeeper目录，并重启服务；
4.可以删除多余安装包和解压包；

28 MS部署中遇到Prometheus启动不起来，一直处于Restarting的问题

chmod -R 755 /opt/metersphere/conf/prometheus
docker stop ms-prometheus
docker rm ms-prometheus
msctl reload

29 遇到redis启动不起来，一直处于Restarting的问题

chmod -R 755 /opt/metersphere/conf/redis.conf
docker stop redis
docker rm redis
msctl reload

30 Redis无法连接

1.查看防护墙是否开启，如果防火墙开启了，查看6379端口是否开放，查看.env文件中配置的Redis地址是否是对于的服务器的IP地址；
2.可以开放6379端口或者关闭防火墙后重启服务；
3.确认日志中连不上的ip是redis的ip(Mac: ifconfig |grep "inet"|grep -v 127.0.0.1; Linux: hostname -I)

31 安装MeterSphere遇到内核之类的问题如何解决？docker: Error response from daemon: OCI runtime create failed: systemd cgroup flag passed。。。

1. 打开daemon.json文件, vi /etc/docker/daemon.json
2. 将"exec-opts": ["native.cgroupdriver=systemd"]删掉即可, 重启docker：service docker restart
3. 重启服务，msctl reload

32 环境变量和场景变量，用同个变量名，变量优先级是怎样的

环境变量 < 整体的场景变量 < 步骤内变量< 步骤原场景变量（如勾选）

33 遇到MYSQL连接数太多如何处理？java.sql.SQLNonTransientConnectionException: Data source rejected establishment of connection, message from server, too many connection

大概率是自带的my.cnf没有生效，没生效的原因为my.cnf文件权限不对：
show variables like "max_connections"
chmod -R 655 /opt/metersphere/conf/my.cnf
docker stop mysql
docker rm mysql
msctl reload

34 后台日志出现SQLSyntaxErrorException：Expression #3 of SELECT list is not in GROUP BY clause and contains nonaggregated column “metersphere” _dev.api_definition_exec_result.start_time’

修改环境中的数据库配置文件。 sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE

35 前后置SQL脚本执行报错： javax.net.ssl.SSLHandshakeException: No appropriate protocol ；

在数据库后面添加 ?createDatabaseIfNotExist=true&useSSL=false；

36 msctl status显示服务正常，但是实际服务却访问不了怎么办？

清浏览器缓存，关闭浏览器重新访问
IP访问：检查防火墙（firewalld,iptables等）
域名访问：检查防火墙及NGINX等网络相关配置

37 安装报错/var/lib/docker/overlay2/xxxx no such file or directory

docker 的持久化数据目录被删除了，要重装docker，建议以后不要清理/var/lib/docker/overlay2目录了。

38 修改session过期时间

/opt/metersphere/conf/metersphere.properties 添加配置 session.timeout，单位是秒

39 K8S 部署 metersphere 出现 413 request entity too large

#ngnix请求破除1m限制，
kubectl edit ingress metersphere
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
annotations:
meta.helm.sh/release-name: metersphere
meta.helm.sh/release-namespace: default
nginx.ingress.kubernetes.io/proxy-body-size: 50m

40 主机部署 metersphere 出现 413 request entity too large

1. 打开nginx服务的配置文件nginx.conf
2. 在http{}中加入client_max_body_size xxm, xx根据需求改动
3. 保存后重启nginx，问题解决

41 安装或者升级至 1.20.0 版本 及之后，做接口测试时，页面卡在加载状态，按 F12 可以看到 websocket 连接失败

解决方案：用nginx做反向代理，需要在nginx加上websocket配置
server{
  ...
  location / {
    proxy_pass http://jumpserver_nginx;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    #加上这段
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }
}

42 登录进去后，点击任一菜单会立马跳到登录页面

执行 msctl reload 就好了

43 接口运行时，页面报错: The connection is abnormal, please check the environment configuration

1.是不是使用NG了，需要进行配置，可参考 https://metersphere.io/docs/v2.x/installation/offline_installation/
2.是不是打开了代理，如 fidder、charles等工具
3.是不是使用 https://ip:8081 被拦截了,使用 http://ip:8081 就行

44 升级后服务正常，但是访问页面报500 javax.servlet.ServletException: Filtered request failed

1.清浏览器缓存，重新打开浏览器进行访问
2.清除下 redis 数据

docker exec -it redis sh
redis-cli   
auth Password123@redis
flushall

45 日志中出现 java.io.FileNotFoundException：/opt/metersphere/logs/metersphere/ms-jmeter-run-log.log(no such file or directory)

检查下 selinux 状态，如果是开启状态，尝试关闭后再重启 docker，重新加载 MeterSphere

46 k8s 中如何控制数据库的连接数

1.可在名称为 metersphere-config 的 ConfigMap 文件里，DATABASE 处新增如下两行参数
2.可在名称为 values.yml 文件里，DATABASE 处新增如下两行参数

spring.datasource.hikari.maximum-pool-size=你想要的数值
spring.datasource.quartz.hikari.maximum-pool-size=你想要的数值

47 安装时出现 Encountered error while bringing up the project, msctl status 时看到 mysql一直在 Restarting

在 /opt/metersphere/docker-compose-mysql.yml 文件 restart: always 后面一行加 privileged: true 这个参数，msctl reload 即可

48 Creating network “metersphere_ms-network” with driver “brige” Pool overlaps with other one on this address space

1.docker network prune 清除子网网段;
2.docker network create metersphere_ms-network ;
3./opt/metersphere/.env 里的子网改成别的 MS_DOCKER_SUBNET=172.30.11.0/24 ;
4.重启服务器

49 could not find properties[/opt/metersphere/conf/metersphere.properties]

安装包放的目录位置不对，将 metersphere-offline-installer-v*.*-lts.tar.gz 包放到外面(如 /tmp 目录下)，解压执行 /bin/bash install.sh 即可。

50 在安装部署时，后台报 java.lang.OutOfMemoryError:Java heap space

在 docker-compose-server.yml 文件中，增加 JAVA_OPTIONS: -Xms256m -Xmx4096m -Xmn256m 的参数

51 ERROR Unable to write to Kafka in appender [Kafka]

docker stop kafka 
docker stop zookeeper 
docker rm kafka 
docker rm zookeeper 
rm -rf /opt/metersphere/data/kafka/kafka 
rm -rf /opt/metersphere/data/zookeeper/zookeeper 
msctl reload