版本升级机制

Prometheus版本切换

全局设置

zstack.properties参数说明

注意事项

• 历史版本（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全局配置的默认值。

  Note: 升级到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
    # 设置邮箱服务器读取数据超时时间

  Note:

  • 系统默认上述三个参数的超时时间均为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
  #启用物理网卡故障检测功能

  Note:

  • 云平台默认关闭物理网卡故障检测功能。
  • 开启该功能后，系统将基于默认时间间隔持续检测物理聚合网卡状态，若出现主备切换，云平台会立即发送云主机的GARP请求，从而解决网络单点故障时外部无法与云主机通信的问题。
  • 多管理节点环境下，需要在每台管理节点上使用zstack-ctl configure进行配置。
  • 配置后需运行zstack-ctl restart_node重启管理节点生效。

云主机根云盘扩容

上述步骤仅实现将云主机的根云盘容量扩大，需在云主机的操作系统里对硬盘进行分区扩容，才可使得云主机识别。

云主机操作系统硬盘分区扩容

以下分三种不同的应用场景来介绍：

1. 使用GParted开源工具针对ext4+swap分区扩容ext4根分区实例。
   Note:

   • 此方式需借助Live CD方式对当前分区进行重新规划。
   • 调整分区时需谨慎操作，以防止数据丢失。

   假定云主机采用了ext4根分区+swap分区，其中ext4根分区35G，swap分区5G，总容量40G，将系统从40G扩容至50G后，打算将新增容量扩容至ext4根分区。

   操作步骤如下：

   1. 添加GParted ISO，下载路径可参考GPared官网https://gparted.org/download.php，建议下载amd64的iso表示支持64位系统。
   2. 添加ISO后，设置启动顺序为cdrom harddisk，表示下次启动，以cdrom优先。
   3. 使用GParted Live CD引导系统，打开云主机控制台，GParted引导后，按照引导一直执行Enter键直至进入图形界面。
   4. 在GParted界面，右击删除原本的swap分区，扩展ext4将其从35G扩展至46G，针对unallocated的4G分区，新建swap分区。
   5. 关闭云主机，卸载ISO，启动云主机。
   6. 打开云主机控制台，执行df -h，可见云主机根分区容量已扩展至46G。

      [root@10-58-21-213 ~]# df -h
      Filesystem Size Used Avail Use% Mounted on
      /dev/vda1 46G 1.2G 42G 3% /

   7. 开启swap分区并修改/etc/fstab磁盘分区表。

      [root@10-58-21-213 ~]# fdisk -l|grep vda
      Disk /dev/vda: 53.7 GB, 53687091200 bytes, 104857600 sectors
      /dev/vda1 * 2048 96468991 48233472 83 Linux
      /dev/vda2 96468992 104857599 4194304 82 Linux swap / Solaris
      
      [root@10-58-21-213 ~]# mkswap /dev/vda2
      mkswap: /dev/vda2: warning: wiping old swap signature.
      Setting up swapspace version 1, size = 4194300 KiB
      no label, UUID=ed99f72b-aafb-43ad-be8f-fcd09794beb0
      #可知此swap分区的UUID为ed99f72b-aafb-43ad-be8f-fcd09794beb0
      
      [root@10-58-21-213 ~]# swapon /dev/vda2
      #开启swap分区
      
      [root@10-58-21-213 ~]# free -m
       total used free shared buff/cache available
      Mem: 911 106 671 6 133 657
      Swap: 4095 0 4095
      
      [root@10-58-21-213 ~]# sed -i '/swap/d' /etc/fstab
      echo "UUID=ed99f72b-aafb-43ad-be8f-fcd09794beb0 swap swap defaults 0 0"
      #将swap的设置写入磁盘分区表，以便开机自启。

   8. 关机重启后，此云主机根云盘ext4分区成功扩容，swap分区也保留4G使用。
2. 使用LVM分区工具针对xfs+swap分区扩容LVM分区实例。
   Note: 此方式适用于LVM分区动态扩容，无须借助其他工具。

   假定云主机采用了LVM分区，并格式化为boot分区、xfs根分区和swap分区。其中xfs根分区94G，swap分区6G，总容量100G，将系统从100G扩容至120G后，打算将新增容量扩容至xfs根分区。

   操作步骤如下：

   1. 查看当前分区和LVM逻辑分区，其中boot分区为500M，使用了/dev/vda1，LVM分区为94G，使用了/dev/vda2，路径为/dev/vg/root，swap分区为6G，路径为/dev/vg/swap。

      [root@10-0-44-221 ~]# df -h
      Filesystem Size Used Avail Use% Mounted on
      /dev/mapper/vg-root 94G 6.5G 88G 7% /
      /dev/vda1 477M 104M 344M 24% /boot
      #boot分区为500M，使用了/dev/vda1
      #LVM分区为94G，使用了/dev/vda2，路径为/dev/vg/root
      #swap分区为6G，路径为/dev/vg/swap
      
      [root@10-0-44-221 ~]# fdisk -l |grep vda
      Disk /dev/vda: 128.8 GB, 128849018880 bytes, 251658240 sectors
      /dev/vda1 * 2048 1026047 512000 83 Linux
      /dev/vda2 1026048 209715199 104344576 8e Linux LVM
      
      [root@10-0-44-221 ~]# pvdisplay |egrep "Name|Size"
       PV Name /dev/vda2
       VG Name vg
       PV Size 99.51 GiB / not usable 3.00 MiB
       PE Size 4.00 MiB
      #物理卷使用/dev/vda2
      
      [root@10-0-44-221 ~]# vgdisplay |egrep "Name|Size"
       VG Name vg
       VG Size 99.51 GiB
       PE Size 4.00 MiB
       alloc PE / Size 25463 / 99.46 GiB
       Free PE / Size 11 / 44.00 MiB
      #卷组信息，卷组名称为vg，会针对此卷组扩容
      
      [root@10-0-44-221 ~]# lvdisplay |egrep "Name|Size"
       LV Name root
       VG Name vg
       LV Size 93.59 GiB
       LV Name swap
       VG Name vg
       LV Size 5.88 GiB
      #逻辑卷信息

   2. 扩容后，执行fdisk /dev/vda对新增容量分区，使用n建立新分区，使用t将其分区为LVM格式，使用w使修改生效，使用partprobe使其立刻生效。

      [root@10-0-44-221 ~]# fdisk /dev/vda
      Welcome to fdisk (util-linux 2.23.2).
      Changes will remain in memory only, until you decide to write them.
      Be careful before using the write command.
      Command (m for help): p
      Disk /dev/vda: 128.8 GB, 128849018880 bytes, 251658240 sectors
      Units = sectors of 1 * 512 = 512 bytes
      Sector size (logical/physical): 512 bytes / 512 bytes
      I/O size (minimum/optimal): 512 bytes / 512 bytes
      Disk label type: dos
      Disk identifier: 0x0008168e
       Device Boot Start End Blocks Id System
      /dev/vda1 * 2048 1026047 512000 83 Linux
      /dev/vda2 1026048 209715199 104344576 8e Linux LVM
      Command (m for help): n
      Partition type:
       p primary (2 primary, 0 extended, 2 free)
       e extended
      Select (default p):
      Using default response p
      Partition number (3,4, default 3):
      First sector (209715200-251658239, default 209715200):
      Using default value 209715200
      Last sector, +sectors or +size{K,M,G} (209715200-251658239, default 251658239):
      Using default value 251658239
      Partition 3 of type Linux and of size 20 GiB is set
      Command (m for help): t
      Partition number (1-3, default 3):
      Hex code (type L to list all codes): 8e
      Changed type of partition 'Linux' to 'Linux LVM'
      Command (m for help): p
      Disk /dev/vda: 128.8 GB, 128849018880 bytes, 251658240 sectors
      Units = sectors of 1 * 512 = 512 bytes
      Sector size (logical/physical): 512 bytes / 512 bytes
      I/O size (minimum/optimal): 512 bytes / 512 bytes
      Disk label type: dos
      Disk identifier: 0x0008168e
       Device Boot Start End Blocks Id System
      /dev/vda1 * 2048 1026047 512000 83 Linux
      /dev/vda2 1026048 209715199 104344576 8e Linux LVM
      /dev/vda3 209715200 251658239 20971520 83 Linux LVM
      Command (m for help): w
      The partition table has been altered!
      Calling ioctl() to re-read partition table.
      WARNING: Re-reading the partition table failed with error 16: Device or resource busy.
      The kernel still uses the old table. The new table will be used at
      the next reboot or after you run partprobe(8) or kpartx(8)
      Syncing disks.
      
      [root@10-0-44-221 ~]# partprobe

   3. 针对新格式化的分区，创建物理卷。

      [root@10-0-44-221 ~]# pvcreate /dev/vda3
       Physical volume "/dev/vda3" successfully created
      #创建物理卷

   4. 针对卷组，进行扩展。

      [root@10-0-44-221 ~]# vgextend vg /dev/vda3
       Volume group "vg" successfully extended
      #卷组名称为vg，将新分区扩展至卷组vg

   5. 关闭swap，删除原本的swap逻辑卷。

      [root@10-0-44-221 ~]# swapoff -a
      [root@10-0-44-221 ~]# lvremove /dev/vg/swap
      Do you really want to remove active logical volume swap? [y/n]: yes
       Logical volume "swap" successfully removed

   6. 将逻辑卷/dev/vg/root扩容20G。

      [root@10-0-44-221 ~]# lvextend -L +20G /dev/vg/root
       Size of logical volume vg/root changed from 93.59 GiB (23959 extents) to 113.59 GiB (29079 extents).
       Logical volume root successfully resized.
      #对/dev/vg/root 扩容20G
      
      [root@10-0-44-221 ~]# lvdisplay
       --- Logical volume ---
       LV Path /dev/vg/root
       LV Name root
       VG Name vg
       LV UUID UkyCVW-gd5E-Z4Q2-bVHv-T84e-c3GH-ZMiUdF
       LV Write Access read/write
       LV Creation host, time localhost, 2017-07-26 13:18:40 +0800
       LV Status available
       # open 1
       LV Size 113.59 GiB
       Current LE 29079
       Segments 2
       allocation inherit
       Read ahead sectors auto
       - currently set to 8192
       Block device 253:0

   7. 执行xfs_growfs进行xfs文件系统扩容，使其生效，并检查新分区。

      [root@10-0-44-221 ~]# xfs_growfs /dev/vg/root
      meta-data=/dev/mapper/vg-root isize=256 agcount=4, agsize=6133504 blks
       = sectsz=512 attr=2, projid32bit=1
       = crc=0 finobt=0
      data = bsize=4096 blocks=24534016, imaxpct=25
       = sunit=0 swidth=0 blks
      naming =version 2 bsize=4096 ascii-ci=0 ftype=0
      log =internal bsize=4096 blocks=11979, version=2
       = sectsz=512 sunit=0 blks, lazy-count=1
      realtime =none extsz=4096 blocks=0, rtextents=0
      data blocks changed from 24534016 to 29776896
      
      [root@10-0-44-221 ~]# df -h|grep vg-root
      Filesystem Size Used Avail Use% Mounted on
      /dev/mapper/vg-root 114G 6.5G 108G 6% /
      #新分区扩容已生效

   8. 从逻辑卷组划分新容量给swap分区，并启动swap分区，写入磁盘配置。

      [root@10-0-44-221 ~]# lvcreate -L 4G -n swap vg
       Logical volume "swap" created.
      #从卷组vg创建4G分区命名为swap
      
      [root@10-0-44-221 ~]# mkswap /dev/vg/swap
      Setting up swapspace version 1, size = 4194300 KiB
      no label, UUID=bfc8a843-c758-4665-adfe-e32752ceda44
      #创建swap分区，可知此swap分区的UUID为bfc8a843-c758-4665-adfe-e32752ceda44
      
      [root@10-0-44-221 ~]# swapon /dev/mapper/vg-swap
      #开启swap分区
      
      [root@10-58-21-213 ~]# sed -i '/swap/d' /etc/fstab
      echo "UUID=bfc8a843-c758-4665-adfe-e32752ceda44 swap swap defaults 0 0"
      #将swap的设置写入磁盘分区表，以便开机自启。

   9. 关机重启后，此云主机LVM分区的xfs系统成功扩容，swap分区也保留了4G使用。
3. Windows分区扩容实例
   Windows分区可以在磁盘管理界面直接进行磁盘扩容。

   Note: Windows在线扩容后需重新扫描磁盘。

集群时间源变更操作步骤

注意事项