云平台其他运维

普罗米修斯升级 (Prometheus)

ZStack Cloud支持Prometheus，用于数据监控相关功能。提供两个版本Prometheus的支持，根据ZStack Cloud支持程度不同，如下：

Prometheus-1.8.2：ZStack Cloud所有版本支持。
Prometheus-2.9.2：ZStack Cloud 3.5.0版本及以后版本支持，在系统稳定性、资源使用优化，以及功能性方面都有很大的提升。

版本升级机制

ZStack Cloud版本升级应该注意以下情况：

ZStack Cloud 3.5.0之前版本升级到ZStack Cloud 3.5.0及之后版本，默认继续使用Prometheus-1.8.2。
ZStack Cloud 3.5.0及之后版本，升级后Prometheus继承原来版本。
初装ZStack Cloud 3.5.0及之后版本，默认使用Prometheus-2.9.2。

Prometheus版本切换

ZStack Cloud 3.5.0及之后版本同时支持两个版本的Prometheus，可通过如下方法进行版本切换：

依次执行如下命令，将Prometheus-1.8.2切换为Prometheus-2.9.2：
```
[root@localhost ~]# zstack-ctl configure Prometheus.versionMode=2.x [root@localhost ~]# zstack-ctl restart_node
```
说明: ZStack Cloud 3.5.0之前版本升级到ZStack Cloud 3.5.0及之后版本，再启用Prometheus-2.9.2将导致旧的监控无法显示。若启用Prometheus-2.9.2的同时保证旧的监控数据依旧生效，请依次执行如下命令：
```
[root@localhost ~]# zstack-ctl configure Prometheus.versionMode=2.x-compatible [root@localhost ~]# zstack-ctl restart_node
```

依次执行如下命令，将Prometheus-2.9.2切换为Prometheus-1.8.2：

[root@localhost ~]# zstack-ctl configure Prometheus.versionMode=1.8.2 [root@localhost ~]# zstack-ctl restart_node

依次执行如下命令，禁用Prometheus，禁用后监控数据不可用：

[root@localhost ~]# zstack-ctl configure Prometheus.versionMode=none [root@localhost ~]# zstack-ctl restart_node

全局设置

Prometheus支持以下两个全局设置，请管理员在设置 > 全局设置 > 高级设置进行配置：

监控数据保留周期：监控数据在本地保留的月数，最多保留12月，默认：6月。
监控数据保留大小：对于Prometheus-2.9.2，通过设置监控数据保留大小实现对监控目录使用空间的限制，默认：50G。

zstack.properties核心配置文件

zstack.properties是ZStack Cloud的核心配置文件。它会存放在每一个管理节点中。

zstack.properties文件中会存放诸如数据库URL、用于数据库访问的用户名密码、消息总线的IP地址等信息。每一个管理节点上的zstack.properties文件的内容基本上是一致的。它的路径可以通过zstack-ctl status来获得。

如果是默认安装的话，它会存放在/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties

zstack.properties参数说明

以下是zstack.properties文件内容的详细说明。

表 1. zstack.properties
类别	参数	解释
数据库	单管理节点：DB.url = jdbc:mysql://管理节点真实IP:3306 双管理节点： DB.url = jdbc:mysql://VIP:3306	数据库URL、端口
	DB.user = zstack	数据库用户名
	DB.password = REoVaLs+sSFz5WKl8KVzjPQOt0gyL7MpkkIx6PjNB6urlpkp4U1rQsDkHGekirfG	数据库密码。默认zstack.password 说明: 为了保障账户安全，云平台已通过加密方式保存数据库密码。
Sftp镜像服务器	SftpBackupStorageFactory.agentPort = 7171	Sftp镜像服务器端口
消息总线	CloudBus.serverIp.0 = 10.0.5.87	CloudBus服务器IP地址
控制台	consoleProxyCertFile = /usr/local/zstack/zstack-ui/ui.keystore.pem	控制台证书
	consoleProxyOverriddenIp = 172.20.11.50	控制台代理对外IP地址
	consoleProxyPort = 4900	控制台代理端口
	httpConsoleProxyPort = 4901	弹性裸金属控制台端口
ZWatch/SNS	单管理节点：sns.systemTopic.endpoints.http.url = http://localhost:5000/zwatch 双管理节点： sns.systemTopic.endpoints.http.url = http://VIP:5000/zwatch 双管理节点： ticket.sns.topic.http.url = http://VIP:5000/webhook/ticket	ZWatch通知的系统接收端
http	http.keepAlive = true	设置是否开启http的keepAlive，默认为true
Prometheus	Prometheus.versionMode = 2.x	设置普罗米修斯版本或禁用该功能
ZStack Cloud YUM	Ansible.var.zstack_repo = "zstack-mn,qemu-kvm-ev-mn,mlnx-ofed-mn"	ZStack Cloud使用的YUM源名称
管理节点服务	单/双管理节点：management.server.ip = 管理节点真实IP 双管理节点：management.server.vip = VIP	管理节点服务器IP地址
chrony	chrony.serverIp.0 = 10.0.5.87	chrony服务器IP地址

注意事项

历史版本（3.2.0之前）可以在zstack.properties配置API的默认超时时间，例如：
```
ApiTimeout.org.zstack.header.image.APIAddImageMsg = timeout::3h
```
3.2.0兼容这种方式。当升级到3.2.0及后续版本时，在创建对应API的全局配置时，使用zstack.properties中配置的API timeout值作为该API全局配置的默认值。
说明: 升级到3.2.0后，通过zstack.properties配置API timeout的方式已不再需要，所有API的超时可通过全局配置设置。
从ZStack Cloud 3.3.0开始，支持设置AD/LDAP、邮箱服务器的接连超时时间，设置方法如下：
进入/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties，在zstack.properties配置文件中设置如下参数：
- ```
Ldap.addServer.connectTimeout = XX # 设置AD/LDAP连接超时时间
```
- ```
SNS.addEmailPlatform.connectTimeout = XX # 设置邮箱服务器连接超时时间
```
- ```
SNS.addEmailPlatform.readTimeout = XX # 设置邮箱服务器读取数据超时时间
```
说明:
- 系统默认上述三个参数的超时时间均为5000（单位默认为ms）；
- 若需修改超时时间，可通过zstack-ctl configure命令进行修改，例如：
```
[root@localhost ~]# zstack-ctl configure Ldap.addServer.connectTimeout = 10000 [root@localhost ~]# zstack-ctl configure SNS.addEmailPlatform.connectTimeout = 10000 [root@localhost ~]# zstack-ctl configure SNS.addEmailPlatform.readTimeout = 10000
```
  设置完成后使用zstack-ctl restart_node命令重启管理节点生效。
从ZStack Cloud 3.3.0开始，支持设置ivshmem设备（虚拟PCI设备，实现云主机与物理机之间内存共享）的内存名称，设置方法如下：
进入/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties，在zstack.properties配置文件中设置如下参数：
```
Kvm.ivshmem.dev.prefix = nu_fsec-$prefix$VMUUID # 设置共享内存名称
```
ZStack Cloud 3.7.1开始，支持设置多管理节点高可用场景下监控服务zstack-hamon端口，设置方法如下：
进入/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties，在zstack.properties配置文件中设置如下参数：
```
Prometheus.zsha2ExporterPort = 18081 # 设置多管理节点高可用场景下监控服务zstack-hamon端口 # 默认端口18081为prometheus的exporter
```
ZStack Cloud 3.9.0开始，支持在镜像服务器为本地存储时设置主存储优先级，设置方法如下：
进入/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties，在zstack.properties配置文件中设置如下参数：
```
imagestore.backupstorage.primary.storage.priority = [\{\"PS\":\"Ceph\"\, \"priority\":\"10\"}\, \{\"PS\":\"LocalStorage\"\, \"priority\":\"1\"}]    # 配置云主机使用本地主存储
```
ZStack Cloud 3.10.0开始，支持设置日志语言，方法如下：
进入/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties，在zstack.properties配置文件中设置如下参数：
```
locale = en
```
ZStack Cloud 4.3.0开始，支持虚拟网络发送ARP消息检测物理网卡是否故障，方法如下：
进入/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties，在zstack.properties配置文件中设置如下参数：
```
SendGracefulARP = true #启用物理网卡故障检测功能
```
说明:
- 云平台默认关闭物理网卡故障检测功能。
- 开启该功能后，系统将基于默认时间间隔持续检测物理聚合网卡状态，若出现主备切换，云平台会立即发送云主机的GARP请求，从而解决网络单点故障时外部无法与云主机通信的问题。
- 多管理节点环境下，需要在每台管理节点上使用zstack-ctl configure进行配置。
- 配置后需运行zstack-ctl restart_node重启管理节点生效。

升级提醒

若您选择升级至4.0.0及之后版本，请注意以下功能调整：

1. 云路由器全面升级为VPC路由器，云路由网络全面升级为VPC网络，不再单独设云路由器页面。升级全程无感知，相关业务不受任何影响。

2. 企业管理账号体系取代用户组与用户，不再单独设用户/用户组页面，不可再使用用户/用户组账号登录云平台。升级前，请先将“用户组与用户”纳管的账号数据妥善迁移至“企业管理”纳管，再执行升级操作。注意：对于admin创建并具备admin权限的用户账号同步取消，如有需要，可使用企业管理账号体系中的平台管理员实现相同功能。

3. 调整AD/LDAP与账户的对接管理方式，统一由企业管理纳管，不再单独设AD/LDAP页面。升级前，请先将“账户”对接纳管的AD/LDAP账号数据妥善迁移至“企业管理”纳管，再执行升级操作。

如对上述升级提醒有任何疑问或需要升级帮助，请联系ZStack官方技术支持

配置运维