安装部署

安装部署以及升级ZStack失败需检查的因素:
  1. 假定安装操作系统时选择了管理节点模式,但是安装系统后,没有安装ZStack
    原因:
    • 不满足最低硬件需求(4核CPU/8G内存)
    • 安装操作系统时,没有设置合适的IP地址,ZStack管理节点必须要求有可用IP。

    解决方案:
    • 此时需执行bash /opt/zstack*installer.bin -E 安装ZStack企业版
    • 或执行bash /opt/zstack*installer.bin 安装ZStack社区版。
  2. 安装ZStack时出现如下错误信息。
    现象:
    Fail Reason: /usr/local/zstack is existing. Please delete it manually before installing a new ZStack

    原因:

    此时系统已经存在ZStack,不允许再次安装。

    解决方案:
    • 如果打算升级 直接使用-u参数升级即可。
    • 如果打算重新安装,则需执行rm -rf /usr/local/zstack; bash zstack-installer.bin -D进行重新安装。
  3. 安装部署失败,失败信息会打印到屏幕上。

    解决方案:

    可查看/tmp/zstack_installation.log,根据错误提示,尝试解决安装部署问题。

  4. 升级时遇到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

    解决方案:

    此时需执行以下步骤:
    1. 在管理节点下载最新的ISO,例如在管理节点执行下载ISO:
      wget http://cdn.zstack.io/product_downloads/iso/ZStack-x86_64-DVD-3.10.0-c76.iso
    2. 执行以下命令进行升级,升级ISO里面的yum repo同步到本地,并且直接升级管理节点。
      zstack-upgrade ZStack-x86_64-DVD-3.10.0-c76.iso
  5. 升级ZStack过程中,因为二次开发或者调整过数据库而导致升级失败,希望恢复原本的ZStack

    前提:

    ZStack在进行升级时,默认会备份当前核心文件和数据库到对应目录:
    1. ZStack核心文件会备份在/usr/local/zstack/upgrade/目录下,以升级时的时间命名文件夹,假定为2017-11-09-15-41-52
    2. 数据库默认备份在/usr/local/zstack/db_backup/,以升级时的时间命名文件夹,假定为2017-11-09-15-42-43,备份文件为backup.sql
    恢复步骤:
    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-enterprise-installer.bin -D
    6. 使用步骤1备份的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. 恢复步骤2备份的数据库
      cat /root/backup.sql |mysql -u root -pzstack.mysql.password zstack
    8. 启动ZStack管理节点服务,此时ZStack已成功恢复至原本升级失败前的版本
      zstack-ctl start
  6. 若采用all in one方式安装ZStack,初始化结束后,建议对物理机保留内存进行设置,设置方式如下:
    • 全局设置粒度:
      进入设置 > 全局设置 > 基础设置,设置物理机保留内存,默认为1G。
      说明: 若集群(或物理机)已单独设置该选项,此全局设置将不对该集群(或物理机)生效。
    • 集群粒度:

      进入硬件设施 > 集群,选择某一集群,进入集群详情页,在高级设置子页面,设置物理机保留内存,默认为1G。

      说明: 若物理机已单独设置该选项,此集群高级设置将不对该物理机生效。
    • 物理机粒度:
      目前支持CLI方式对单台物理机设置保留内存:
      UpdateResourceConfig category=kvm name=reservedMemory resourceUuid=e2f4836723a2490095768fe611c540b1 value=10G
      # resourceUuid为物理机资源UUID, value为物理机保留内存

启动服务

ZStack相关的服务在管理节点重启后,会自动启动。

启动ZStack服务失败需检查的因素:
  1. 数据库应正常运行:

    可通过systemctl status/start/stop/restart mariadb进行状态/启动/停止/重启检查。

  2. 出现如下报错:
    现象:
    ERROR: failed to connect to the mysql server[hostname:10.0.0.18, port:3306, user:zstack, password:zstack.password]
    解决方案:
    • 需确保/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties里面关于数据库的IP、用户名、密码均正确,且可使用mysql命令正常访问。
    • 例如,可通过mysql -u zstack -pzstack.password -h 10.0.0.18直接访问。
  3. 出现如下报错:
    现象:
    8080 is occupied by some process. Please use netstat to find out and stop it

    解决方案:

    执行netstat -anp|grep 8080找到8080占用程序将其停止再启动ZStack。

  4. 出现如下报错:
    现象:
    MN status: Unknown, the management node seems to become zombie as it stops responding APIs

    原因及解决方案:

    一般是因为内存不足导致的消息总线不能正确处理,需扩大内存,此时不建议再将管理节点作为计算节点添加到ZStack使用。


zstack-ctl命令

ZStack提供zstack-ctl对服务或者资源进行命令行控制。

常用的zstack-ctl命令:
  • 状态检查:zstack-ctl status
  • 服务控制:zstack-ctl stop/start/stop_ui/start_ui/start_node/stop_node/restart_node/
  • 日志收集:zstack-ctl configured_collect_log
  • 备份数据库:zstack-ctl dump_mysql
  • 恢复数据库: zstack-ctl restore_mysql -f back.gz --mysql-root-password password
  • 管理节点IP变更:zstack-ctl change_ip
  • 检查配置: zstack-ctl show_configuration
  • UI配置检查:zstack-ctl show_ui_configuration
  • 安装授权: zstack-ctl install_license -f license_key.txt
  • 重置admin账户密码:zstack-ctl reset_password
  • 修改数据库密码:zstack-ctl change_mysql_password --root-password zstack.mysql.password --user-name zstack --new-password password
说明:

关于zstack-ctl命令的详细使用介绍,请参考官网文档《ctl命令使用手册》。








学习路径

ZStack 产品学习路径

快速梳理文档,点击相应文本链接,快速跳转到相应文档的页面,学习 ZStack 产品。

我知道了

下载ZStack企业版

您已填写过基本信息?点击这里

姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

下载链接将会通过邮件形式发送至您的邮箱,请谨慎填写。

下载ZStack企业版

还未填写过基本信息?点击这里

邮箱或手机号码格式错误
验证手机号
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
登录观看培训视频
仅对注册用户开放,请 登录 或 填写资料 观看培训视频
填写资料

商务咨询:

400-962-2212 转 1

售后咨询:

400-962-2212 转 2

商务联系:

sales@zstack.io
ZStack认证培训咨询
姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

商务咨询:

400-962-2212 转 1

商务联系:

channel@zstack.io
申请ZStack多机版
姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

商务咨询:

400-962-2212 转 1

售后咨询:

400-962-2212 转 2

商务联系:

sales@zstack.io

下载链接已发送至您的邮箱。

如未收到,请查看您的垃圾邮件、订阅邮件、广告邮件。 当您收到电子邮件后,请点击 URL 链接,以完成下载。

下载链接已发送至您的邮箱。

如未收到,请查看您的垃圾邮件、订阅邮件、广告邮件。
或点击下方URL链接 (IE内核浏览器请右键另存为), 完成下载:

感谢您使用 ZStack 产品和服务。

成功提交申请。

我们将安排工作人员尽快与您取得联系。

感谢您使用 ZStack 产品和服务。

立即体验

联系我们

商务咨询
400-962-2212 转 1
售后咨询
400-962-2212 转 2

回到顶部

产品试用申请
请选择您要使用的产品
ZStack企业版
ZStack混合云版
ZStack信创云平台
ZStack Ceph企业版
ZStack Mini 边缘计算一体机
ZStack CMP 多云管理平台
请填写您的基本信息
姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

商务咨询:

400-962-2212 转 1

售后咨询:

400-962-2212 转 2

商务联系:

sales@zstack.io

成功提交申请。

我们将安排工作人员尽快与您取得联系。

感谢您使用 ZStack 产品和服务。