1. ZStack Enterprise Management Node：ZStack企业版管理节点模式

   安装基于CentOS 7.4/7.6深度定制的ZStack定制版ISO并安装ZStack企业版管理节点。

2. ZStack Community Management Node：ZStack社区版管理节点模式

   安装基于CentOS 7.4/7.6深度定制的ZStack定制版ISO并安装ZStack社区版管理节点。

3. ZStack Compute Node：ZStack计算节点模式

   安装基于CentOS 7.4/7.6深度定制的ZStack定制版ISO并安装ZStack计算节点必备软件包。

4. ZStack Expert Node：ZStack专家模式

   安装基于CentOS 7.4/7.6深度定制的ZStack定制版ISO并配置本地源，用户可自定义系统用途。

• 增量升级：
  1. 在ZStack官网获取最新的bin安装包：ZStack-installer-3.10.0.bin；
  2. 若数据库root密码为默认密码，请执行以下命令升级;

     [root@localhost ~]# bash ZStack-installer-3.10.0.bin -u

     若数据库root密码采用自定义非空密码，请执行以下命令进行升级：

     [root@localhost ~]# bash ZStack-installer-3.10.0.bin -u -P MYSQL_ROOT_PASSWORD

• 离线升级：
  1. 在ZStack官网获取最新的iso安装包：ZStack-x86_64-DVD-3.10.0-c76.iso；
  2. 获取最新的升级脚本：升级脚本；
  3. 执行以下命令升级：

     [root@localhost ~]# bash zstack-upgrade ZStack-x86_64-DVD-3.10.0-c76.iso

[root@localhost ~]# yum --disablerepo=* --enablerepo=zstack-local install zstack-manager
[root@localhost ~]# bash ZStack-installer-3.10.0.bin -E

[root@localhost ~]# yum --disablerepo=* --enablerepo=zstack-local,qemu-kvm-ev groupinstall zstack-host

[root@localhost ~]# rpm -e zstack-host
[root@localhost ~]# yum --disablerepo=* --enablerepo=zstack-local install zstack-manager
[root@localhost ~]# bash ZStack-installer-3.10.0.bin -E

1. 先执行以下命令删除原本的数据库：

   [root@localhost ~]# rm -rf /usr/local/zstack

   说明: 此命令会删除该目录下所有数据，如需彻底重装ZStack，才可使用。
2. 再执行以下命令重装管理节点：

   [root@localhost ~]# bash ZStack-installer-3.10.0.bin -D #安装ZStack企业版

• 现象：
  安装ZStack时，有时使用root登录，但是启动服务时，提示非root用户需使用sudo

  ERROR: please use sudo or root user FAIL
   Reason: failed to start zstack

  在Python命令行环境下执行以下命令会发现Python认定用户并非root用户

  import getpass
   user = getpass.getuser()
   print user 

• 原因：

  之前由普通用户切换root用户时，使用了su并非使用sudo su，su只是shell认为切换了root用户，但是相关的环境变量并没有切换。

• 说明：
  • sudo允许命令在当前用户下以root的超级权限来执行。
  • su允许切换为root用户，但是相关的用户环境并没有切换到root下去。
  • sudo su以root权限切换到root用户下。

• 原因：

  管理节点启动时间与节点配置资源有关，在云主机上安装ZStack才出现时间过长的情况。

• 解决方案：
  建议使用虚拟环境时，配置CPU>4，内存>16G。

  说明:

  时间过长不代表安装启动失败，time out报错后请先使用zstack-ctl status查看状态。如果为stopped状态，使用zstack-ctl start启动即可；如果为unknown状态，需要先使用zstack-ctl stop停止，再使用zstack-ctl start启动。

[root@localhost ~]# bash zstack-installer.bin -r /home/zstack

• 现象：
  升级时遇到ZStack定制版ISO版本不匹配，会提示以下错误信息：

  mount: /dev/loop0 is write-protected, mounting read-only
  /root
  Current release c76 not matched the new ISO c74,
  Use zstack-upgrade -r xxx.iso to update current repo,
  Use zstack-upgrade -a/--add_repo xxx.iso to add a new repo

• 原因:

  当前系统使用的ISO版本不适合升级此安装包，需要升级对应的ISO才可继续升级ZStack。

• 解决方案：
  请执行以下部署（以c76为例）：

  1. 执行如下命令，下载最新的升级脚本

     wget http://cdn.zstack.io/product_downloads/scripts/zstack-upgrade

  2. 执行如下命令，在管理节点下载最新的ISO：

     wget http://cdn.zstack.io/product_downloads/iso/ZStack-x86_64-DVD-3.10.0-c76.iso

  3. 执行升级，升级ISO里面的yum repo同步到本地，并且直接升级管理节点：

     bash zstack-upgrade ZStack-x86_64-DVD-3.10.0-c76.iso

• 前提：

  ZStack进行升级时，默认会备份当前ZStack核心文件和数据库到对应目录。

• 恢复步骤：
  1. 备份之前版本的ZStack核心文件：

     cp /usr/local/zstack/upgrade/2017-11-09-15-41-52 /root -r

  2. 备份之前版本的数据库：

     cp /usr/local/zstack/db_backup/2017-11-09-15-42-43/backup.sql /root

  3. 再次备份数据库：

     zstack-ctl dump_mysql

  4. 删除当前ZStack环境：

     zstack-ctl stop
     rm -rf /usr/local/zstack

  5. 使用之前的安装包直接安装ZStack：

     bash ZStack-installer-3.10.0.bin -D

  6. 使用第一步备份的ZStack核心文件恢复：

     zstack-ctl stop
     mv /usr/local/zstack/apache-tomcat/webapps/zstack /usr/local/zstack/apache-tomcat/webapps/zstack-bk
     cp /root/2017-11-09-15-41-52/zstack /usr/local/zstack/apache-tomcat/webapps  -r
     chown zstack:zstack /usr/local/zstack/apache-tomcat/webapps/zstack -R

  7. 恢复第二步备份的数据库：

     cat /root/backup.sql |mysql -u root -p zstack.mysql.password zstack

  8. 启动ZStack管理节点服务，此时ZStack已成功恢复至原本升级失败前的版本

     zstack-ctl start

• 原因：ZStack 3.5.0之前版本使用prometheus 1.8.2，可能出现监控数据占满根空间的情况。
  说明: ZStack 3.5.0及之后版本使用prometheus 2.9.2，支持设置保留策略（默认保留50G监控数据），不再出现此问题。
• 解决方案：确认监控数据不需要的情况下，彻底删除prometheus监控数据，释放空间。
  • 单管理节点环境，依次执行如下命令，删除prometheus监控数据：

    [root@hostname ~]# du -sh /var/lib/zstack/prometheus/data/    //查看监控数据大小
    [root@hostname ~]# zstack-ctl stop 
    [root@hostname ~]# kill -9 `ps -ef |grep prometheus|awk '{print $2}'` 
    [root@hostname ~]# rm -rf /var/lib/zstack/prometheus/data
    [root@hostname ~]# zstack-ctl start

  • 双管理节点环境，分别在两个管理节点依次执行如下命令，删除prometheus监控数据：

    [root@mn-1 ~]# du -sh /var/lib/zstack/prometheus/data/    //查看监控数据大小
    [root@mn-1 ~]# zsha2 stop-node
    [root@mn-1 ~]# kill -9 `ps -ef |grep prometheus|awk '{print $2}'
    [root@mn-1 ~]# rm -rf /var/lib/zstack/prometheus/data
    [root@mn-1 ~]# zsha2 start-node