ZStack Cloud 4.8.10>ZStack Cloud 产品手册>ZStack Cloud运维手册>云平台基本运维

云平台基本运维

本章主要针对ZStack Cloud基本操作异常给出处理办法。

安装部署

安装部署以及升级ZStack Cloud失败需检查的因素：

假定安装操作系统时选择了管理节点模式，但是安装系统后，没有安装ZStack Cloud。
原因：
- 不满足最低硬件需求（4核CPU/8G内存）
- 安装操作系统时，没有设置合适的IP地址，ZStack Cloud管理节点必须要求有可用IP。
解决方案：
- 此时需执行bash /opt/zstack-installer.bin -E 安装ZStack Cloud；
- 或执行bash /opt/zstack-installer.bin 安装ZStack Cloud社区版。
安装ZStack Cloud时出现如下错误信息。
现象：
```
Fail Reason: /usr/local/zstack is existing. Please delete it manually before installing a new ZStack
```
原因：
此时系统已经存在ZStack Cloud，不允许再次安装。
解决方案：
- 如果打算升级直接使用-u参数升级即可。
- 如果打算重新安装，则需执行rm -rf /usr/local/zstack; bash zstack-installer.bin -D进行重新安装。
安装部署失败，失败信息会打印到屏幕上。
解决方案：
可查看/tmp/zstack_installation.log，根据错误提示，尝试解决安装部署问题。

升级时遇到ZStack Cloud ISO版本不匹配，会提示类似以下错误信息。

现象：

mount: /dev/loop0 is write-protected, mounting read-only /root Current release h79c not matched the new ISO h84r, 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：

wget http://cdn.zstack.io/product_downloads/iso/ZStack-Cloud-x86_64-DVD-4.8.10-h84r.iso

执行以下命令进行升级，升级ISO里面的yum repo同步到本地，并且直接升级管理节点。
```
zstack-upgrade ZStack-Cloud-x86_64-DVD-4.8.10-h84r.iso
```

升级ZStack Cloud过程中，因为二次开发或者调整过数据库而导致升级失败，希望恢复原本的ZStack Cloud。
前提：
ZStack Cloud在进行升级时，默认会备份当前核心文件和数据库到对应目录：
1. ZStack Cloud核心文件会备份在/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 Cloud核心文件，执行
```
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 Cloud环境，执行
```
zstack-ctl stop rm -rf /usr/local/zstack
```
5. 使用之前的安装包直接安装ZStack Cloud
```
bash ZStack-Cloud-installer.bin -D
```
6. 使用步骤1备份的ZStack Cloud核心文件恢复
```
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 Cloud管理节点服务，此时ZStack Cloud已成功恢复至原本升级失败前的版本
```
zstack-ctl start
```
若采用all in one方式安装ZStack Cloud，初始化结束后，建议对物理机保留内存进行设置，设置方式如下：
- 全局设置粒度：
  进入设置 > 平台设置 > 全局设置 > 基本设置，设置物理机保留内存，默认为1G。
  说明: 若集群（或物理机）已单独设置该选项，此全局设置将不对该集群（或物理机）生效。
- 集群粒度：
  进入硬件设施 > 集群，选择某一集群，进入集群详情页，在高级设置子页面，设置物理机保留内存，默认为1G。
  说明: 若物理机已单独设置该选项，此集群高级设置将不对该物理机生效。
- 物理机粒度：
  目前支持CLI方式对单台物理机设置保留内存：
```
UpdateResourceConfig category=kvm name=reservedMemory resourceUuid=e2f4836723a2490095768fe611c540b1 value=10G # resourceUuid为物理机资源UUID, value为物理机保留内存
```

启动服务

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

启动ZStack Cloud服务失败需检查的因素：

数据库应正常运行：
可通过systemctl status/start/stop/restart mariadb进行状态/启动/停止/重启检查。
出现如下报错：
现象：
```
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直接访问。
出现如下报错：
现象：
```
8080 is occupied by some process. Please use netstat to find out and stop it
```
解决方案：
执行netstat -anp|grep 8080找到8080占用程序将其停止再启动ZStack Cloud。
出现如下报错：
现象：
```
MN status: Unknown, the management node seems to become zombie as it stops responding APIs
```
原因及解决方案：
一般是因为内存不足导致的消息总线不能正确处理，需扩大内存，此时不建议再将管理节点作为计算节点添加到ZStack Cloud使用。

zstack-ctl命令

ZStack Cloud提供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