常见问题

快速入门

Q：ZStack云平台能干什么？

A：
总的来说，可帮助用户便捷创建、管理业务云主机以及相关的网络存储资源，例如：
- 可实时获取物理资源的使用情况，例如：处理器、内存、存储和网络等，用户只需负责创建业务云主机即可，当资源不够时云平台会立即发出告警。
- 用户创建业务云主机，云平台可帮忙提前复制模板。
- 用户创建业务云主机后，云平台可帮忙设置或修改相关IP地址。
- 支持扁平网络、云路由网络和VPC网络，用户可以快速搭建灵活多样的网络场景，只需在UI界面进行鼠标操作，便能生成一套满足自己需求的网络架构。
- 支持接管vCenter，一套平台同时管理KVM和VMware两套集群。支持vCenter的云主机到ZStack平台的V2V迁移。
- 云平台支持不同账户看到不同的业务云主机。
- 云平台还支持计费等高级功能。
- 用户可在云平台上直接给业务云主机添加防火墙，设置各种安全策略，简单快捷。
- 支持企业管理、裸金属管理、迁移服务（V2V迁移）、灾备服务等高级功能
除了上述列举，ZStack还有很多强大功能，更多精彩尽在ZStack企业版。
Q：ZStack有哪些文档？用户应该看什么？
A：ZStack有如下文档：
- 版本特性：
  汇集各版本的特色功能介绍，用户可以了解ZStack每个版本的特色功能以及发展历程。
- 产品手册：
  包括：用户手册、运维手册、技术白皮书、cli命令使用手册和ctl命令使用手册。这些手册主要介绍了ZStack的架构特点、功能优势、安装部署、使用指南、以及管理运维过程中的常见问题解决方案。若用命令行方式使用ZStack，将会展开另一片新天地。
- 实践教程：
  针对不同应用场景提供实践教程，例如：《快速安装教程（新手快速入门）》、《升级教程》、《混合云使用教程》、《多管理节点物理机高可用教程》、《企业管理使用教程》、《灾备服务使用教程》、《迁移服务使用教程》、《裸金属管理使用教程》等。涵盖场景十分丰富多变，实践操作也很简单便捷，协助用户分分钟快速上手。
- 开发手册：
  它是ZStack的核心，主要从API层面带你认识ZStack，了解之后，会对ZStack有更深刻的认知。
- 常见问题：
  摘选出用户在实际使用过程中的常见问题集锦，并给出解决方案。
- 博客：
  更高的视角，更深入的探讨，它说的是ZStack，又不仅仅是ZStack，可帮助用户拓展视野，对云计算IaaS有更透彻的理解。
阅读建议如下：
- 对于小白用户：
  - 首先应该了解IaaS的概念，了解什么是ZStack，它能用来干什么。
  - 然后可参考《快速安装教程（新手快速入门）》，赶快安装一下吧。
  - 安装成功后，如何使用它呢？可查阅我们的实践教程，例如：尝试部署一套无虚拟路由的扁平网络。
  - 如果成功创建了第一台云主机，就已成功迈出了第一步。
  - 接下来可尝试实践教程里的其他场景部署实践，将会对UI上的各种功能和名词有新的认识。
  - 认真阅读博客，认知会上升一个台阶。
- 对于开发者：
  - 可能只关心部分功能点，可参考开发手册了解二次开发的API等。
  - 毫无疑问，也可参考cli命令使用手册，以cli方式部署一套ZStack环境。
  - 开发手册和cli命令使用手册是必须的工具，部分问题在实践教程和博客中或许会找到答案。
- 对于老司机：
  - 快速阅读安装部署文档后，选择一种合适的方案即可。
  - 可能更想研究开发手册和博客。
  - 在使用过程中，遇到问题都可以先参考常见问题。如果没有，欢迎在ZStack社区（qq群：1046295840、741300236、443027683、410185063）中提问。

安装部署

Q：ZStack支持哪些硬件环境？

A：ZStack支持带硬件虚拟化特性的x86和ARM架构服务器、工作站或台式机，支持主流的Intel或AMD的处理器。
Q：ZStack支持哪些操作系统？

A：ZStack支持基于CentOS 7.4/7.6深度定制的ZStack定制版ISO。
Q：ZStack支持使用标准的CentOS 7.4/7.6系统安装么？

A：暂不支持，ZStack目前支持基于CentOS 7.4/7.6深度定制的ZStack定制版ISO。
Q：安装部署ZStack需要多少台服务器？

A：最小安装只需要一台服务器，同时作为管理节点和计算节点；生产环境建议分离部署。ZStack只需一台管理节点，就可以管控所有的硬件资源。
Q：安装部署ZStack，服务器的最低配置要求多少？

A：4CPU、8G内存、200G主存储、200G镜像服务器空间。最小配置仅适用于测试环境。
Q：ZStack定制版ISO可以安装哪些模式？有哪些差异？
A：ZStack定制版ISO支持以下几种模式：
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并配置本地源，用户可自定义系统用途。
Q：如何安装ZStack企业版？

A：下载最新的ZStack定制版ISO，首次安装系统时，建议选择企业版管理节点模式。操作系统安装完毕后，重启系统会自动安装企业版管理节点。
Q：如何升级ZStack企业版？
A：如需将已部署ZStack升级至最新版本，可参考以下两种方法进行升级（以c76版本为例）：
- 增量升级：
  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
```
说明: c74版本和c76版本升级方法相同，请获取c74版本对应的安装包进行升级。

Q：如何从专家模式升级到管理节点？

A：依次执行如下命令，将专家模式升级为管理节点：

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

Q：如何从专家模式升级到计算节点？
A：执行如下命令，将专家模式升级为计算节点：
```
[root@localhost ~]# yum --disablerepo=* --enablerepo=zstack-local,qemu-kvm-ev groupinstall zstack-host
```

Q：如何从计算节点升级到管理节点？

A：依次执行如下命令，将计算节点升级为管理节点：

[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

Q：如何将管理节点从ZStack社区版升级到ZStack企业版？

A：获取最新的企业版许可证，更换许可证即可。
Q：如何重新安装ZStack？
A：
1. 先执行以下命令删除原本的数据库：
```
[root@localhost ~]# rm -rf /usr/local/zstack
```
  说明: 此命令会删除该目录下所有数据，如需彻底重装ZStack，才可使用。
2. 再执行以下命令重装管理节点：
```
[root@localhost ~]# bash ZStack-installer-3.10.0.bin -D #安装ZStack企业版
```
Q：使用root安装ZStack为何启动服务提示非root？
A：
- 现象：
  安装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用户下。
Q：多节点部署可以有节点使用云主机吗？

A：可以，但是网络需要连通，建议云主机的节点使用桥接。云主机节点运行管理节点更为合适，配置不低于4CPU、8G内存。
Q：能在ZStack的云主机上安装ZStack吗？

A：可以。在全局设置的基本设置中修改云主机CPU模式为host-passthrogh，透传物理主机的虚拟化特性。
Q：一键安装ZStack后，启动时间过长怎么办？
A：
- 原因：
  管理节点启动时间与节点配置资源有关，在云主机上安装ZStack才出现时间过长的情况。
- 解决方案：
  建议使用虚拟环境时，配置CPU>4，内存>16G。
  说明:
  时间过长不代表安装启动失败，time out报错后请先使用zstack-ctl status查看状态。如果为stopped状态，使用zstack-ctl start启动即可；如果为unknown状态，需要先使用zstack-ctl stop停止，再使用zstack-ctl start启动。
Q：ZStack如何更改安装目录？
A：安装ZStack时，加上 -r 目标目录。例如：
```
[root@localhost ~]# bash zstack-installer.bin -r /home/zstack
```
Q：升级时，遇到ZStack定制版ISO版本不匹配怎么办？
A：
- 现象：
  升级时遇到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
Q：ZStack版本升级时出现报错The Operating System version is not suitable for zstack-enterprise installation.怎么办?

A：请使用最新的ZStack定制版ISO安装升级。
Q：升级ZStack过程中，因为二次开发或者调整数据库导致升级失败时，怎么恢复原本的ZStack？
A：
- 前提：
  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
```
Q：管理节点无法启动，重启提示没有可用空间，该如何处理？
A：
- 原因：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
```
Q：使用非官方ZStack安装计算节点，添加失败是什么原因？

A：不支持使用非官方ISO安装计算节点，请使用ZStack定制版ISO安装。
Q ：嵌套虚拟化环境中成功安装ZStack云平台，但在ZStack云平台中添加物理机时出现报错ERROR:could not insert 'kvm_intel':Operation not supported stdout，如何解决？

A：在KVM、VMWARE、VirtualBox、Hyperv、XEN等其他虚拟化环境中通过嵌套虚拟化搭建ZStack时，需在相应虚拟化平台的虚拟化引擎设置中开启虚拟化Intel VT-x/EPT或AMD-V/RVI(V)特性。

系统登录

Q：ZStack推荐使用哪些浏览器？

A：为了获取更好的产品体验，请使用Chrome 49，Firefox 52 及以上版本的浏览器。
Q：UI无法登录怎么办？
A：请根据以下方法进行检查：
1. 如果提示用户名/密码不正确，需要输入正确的用户名和密码。
2. 如果提示无法连接管理节点，需要通过zstack-ctl status命令确认管理节点服务是否运行正常。
3. 如果依然无法连接，可以使用如下命令，通过cli方式登录：
```
[root@localhost ~]# zstack-cli  #进入cli命令
admin>>> LogInByAccount accountName=admin password=password #登录cli，默认用户名密码为：admin/password
```
4. 检查相关的Java进程是否出现僵尸导致程序无法运行，此时需要重启管理节点服务。

Q：如何更改UI的admin密码？

A：有三种方法：

UI方式：
在ZStack首页点击admin信息的修改密码按钮进行修改。

CTL命令行方式：

执行以下命令，更改UI的admin密码：

[root@localhost ~]# zstack-ctl reset_password --password NEW_PASSWORD #更改密码（NEW_PASSWORD为新密码）

CLI命令行方式：

依次执行以下命令，更改UI的admin密码：

[root@localhost ~]# zstack-cli  #进入cli命令
admin>>> LogInByAccount accountName=admin password=password #登录cli，默认用户名密码为：admin/password
admin>>> UpdateAccount uuid=36c27e8ff05c4780bf6d2fa65700f22e password=NEW_PASSWORD #修改密码（NEW_PASSWORD为新密码）

Q：如何修改UI界面默认的5000端口？

A：依次执行以下命令：

[root@localhost ~]# zstack-ctl config_ui --server-port 8888  #修改UI服务端口为8888
[root@localhost ~]# zstack-ctl config_ui --webhook-port 8888  #改webhook主机端口，与UI服务端口保持一致
[root@localhost ~]# zstack-ctl stop_ui  #停止UI服务
[root@localhost ~]# zstack-ctl start_ui  #启动UI服务

Q：如何增加会话超时时间？

A：

UI方式：
在设置 > 全局设置 > 基本设置页面，调整会话超时时间。

命令行方式：

依次执行如下命令：

[root@localhost ~]# zstack-cli  #进入cli命令
admin>>> LogInByAccount accountName=admin password=password #登录cli，默认用户名密码为：admin/password
admin>>> UpdateGlobalConfig name=session.timeout category=identity value=720000 #将登录的过期时间改成200小时

Q：如何更改ZStack同时登录次数？

A：

UI方式：
在设置 > 全局设置 > 高级设置页面，修改最大会话数的值。

命令行方式

首先使用QueryGlobalConfig name~=session，可以看到关于最大会话数的限制为500。

{
            "category": "identity",
            "defaultValue": "500",
            "description": "Max number of sessions management server accepts. \
When this limit met, new session will be rejected",
            "name": "session.maxConcurrent",
            "value": "500"
 }

假如希望改成1000，可执行以下命令：

UpdateGlobalConfig category=identity name="session.maxConcurrent" value=1000

Q：如何切换后端环境语言？

A：ZStack UI界面语言和后端环境语言相互独立。其中，后端环境语言默认为中文，请依次执行以下命令进行切换：

[root@localhost ~]# zstack-ctl configure locale=en_US   #切换语言，en_US表示英文；zh_CN表示中文
[root@localhost ~]# zstack-ctl restart_node   #重启管理节点，配置生效

Q：是否支持HTTPS方式登录UI？

A：ZStack支持设置HTTPS方式登录UI，以及恢复HTTP方式登录，详情请参考《HTTPS方式登录UI使用教程》。

升级提醒

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

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

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

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

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

快速入门

安装部署

系统登录

客户评论

撰写评论

产品

解决方案

支持

联系

咨询