安装部署相关

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

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

service docker start
msctl start
msctl status

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

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

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

如何在 Kubernetes 中搭建 MeterSphere？¶

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

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

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

升级指定版本¶

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

卸载命令¶

msctl uninstall -v

重新安装命令¶

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

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

卸载不会影响数据

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

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

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

到github源码上 https://github.com/metersphere/metersphere/tree/master/backend/src/main/resources/db/migration 查看对应version的flyway sql记录，和当前数据库比对，看具体哪行sql执行失败了，然后重新执行下，然后修改metersphere_version 表对应版本的的success值为1，然后 msclt reload 重启服务即可。

如何备份数据库?¶

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

mysqldump: `Error 2020: Got packet bigger than 'max_allowed_packet' bytes when dumping table`api_scenario_report_detail`at row: 94`¶

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

关于"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 命令重建容器使环境变量生效。

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

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

数据库如何不区分大小写¶

chmod 655 /opt/metersphere/conf/my.cnf

修改完成后，重启数据库。

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

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

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

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

如何删除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；

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

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

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

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

jar包存储位置¶

/opt/metersphere/data/jar

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

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

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

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

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

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

怎样监控被压测的机器¶

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

忘记 Metersphere密码¶

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

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

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

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

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

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

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

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

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

Redis无法连接¶

1.查看防护墙是否开启，如果防火墙开启了，查看6379端口是否开放，查看.env文件中配置的Redis地址是否是对于的服务器的IP地址；
2.可以开放6379端口或者关闭防火墙后重启服务；

安装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

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

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

遇到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

后台日志出现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

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

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

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

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

ms无法访问测试环境的测试域名或者ip，但是装ms服务器可以¶

service network restart
service docker restart
msctl reload

修改session过期时间¶

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

K8S部署meterspher出现 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

主机部署meterspher出现 413 request entity too large¶

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

安装或者升级至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";

  }
}

我们基于创新的开源模式，向企业级用户交付被广泛验证、可信赖的通用工具软件。

测试

运行

分析

保护