A：

• UI方式：

  在平台管理 > 控制台代理页面，设置控制台代理地址。无需重启管理节点，直接生效。

• 命令行方式：
  依次执行以下命令（MANAGEMENT_NODE_PUBLIC_IP_ADDRESS为控制台代理IP）：

  [root@localhost ~]# zstack-ctl configure consoleProxyOverriddenIp=MANAGEMENT_NODE_PUBLIC_IP_ADDRESS
  [root@localhost ~]# zstack-ctl restart_node

A：

• 目前还没有提供ReserverIpRange的API，如果希望ZStack从已经设置的IP Range中保留几个特定的IP地址，可以在UI界面创建指定的虚拟IP方式来保留IP使用。
• 也可以用CreateVip这个API。
  例如：使用如下命令把a.b.c.d的IP地址从指定的L3网络上用创建虚拟IP的方式保留：

  [root@localhost ~]# zstack-cli  #进入cli命令
  admin>>> LogInByAccount accountName=admin password=password #登录cli，默认用户名密码为：admin/password
  admin>>> CreateVip l3NetworkUuid=YOU_L3_NETWORK_UUID name=for_reserver requiredIp=a.b.c.d 

A：

• 现象：
  使用过程中，启动云主机时可能遇到类似这样的错误信息：

  uses a qcow2 feature which is not supported by this qemu version: QCOW version 3

• 原因：

  主要原因是qcow版本不一致。原始的qcow2创建版本使用的qemu-img为较新版本，现在创建时使用的为较旧版本，旧版本不支持新版本。

• 解决方案：
  在拥有较新版本的qemu-img里面进行兼容性转换，例如执行以下命令进行转换，转换完毕后，再重新添加镜像：

  qemu-img convert -o compat=0.10 -f qcow2 -O qcow2 centos6-cloud-init.qcow2 centos-st-ssh-key.qcow2

A：

• UI方式：

  在设置 > 全局设置 > 基本设置页面，修改彻底删除时延的值。

• 命令行方式：
  依次执行以下命令：

  [root@localhost ~]# zstack-cli  #进入cli命令
  admin>>> LogInByAccount accountName=admin password=password #登录cli，默认用户名密码为：admin/password
  admin>>> UpdateGlobalConfig category=vm name=expungePeriod value=3600  #将彻底删除时延设置成3600秒

A：

• 现象：

  创建VM时，可能会遇到一个云主机挂载多个网络的情况，这时进入console可看到多块网卡，但没有发现IP。

• 原因：

  每个网络对VM来说就是一块网卡，把网络加载到VM上，等价于把一块物理网卡插到一台Server上。因此使用 ifconfig命令就能看到eth设备了。如果没有看到IP，说明网卡插上了，但并没有配置好。

• 解决方案：
  请仿照eth0的配置文件，为这个新网卡创建一个配置文件：

  1. 拷贝一份eth0：（以下示例是Centos 7.2环境，其他版本Linux路径和文件可能有变化）

     # 将配置文件中的eth0替换为eth1,并删除其中的uuid信息
     cp /etc/sysconfig/network-scripts/ifcfg-eth0 /etc/sysconfig/network-scripts/ifcfg-eth1 
     sed -i 's/eth0/eth1/g' ifcfg-eth0
     sed -i '/UUID*/d' /etc/sysconfig/network-scripts/ifcfg-eth1

  2. 将网络重启生效：

     /etc/init.d/network restart

  3. 用ifconfig查看，第二块网卡也有IP了。如果在云主机上挂载多个网络，重复以上操作即可。

A：

• 现象：
  修改Windows云主机密码时出现如下报错：

  return code: 1 stdout: stderr: error: internal error: unable to execute QEMU agent command 'guest-set-user-password': 
  The command guest-set-user-password has not been found

• 原因：

  可能原因是使用了错误的Windows Virtio驱动。

  解决方案：

  目前ZStack定制版ISO里已经集成了可用的Windows Virtio驱动，解压此ISO，添加此Windows Virtio驱动作为ISO镜像到镜像服务器中，然后挂载此ISO，安装对应的qemu-guest-agent即可。

A：ssh key默认存放在目录：/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/ansible/rsaKeys，如果用户不小心删除了ssh key，可以通过以下方式恢复：

1. 首先运行以下命令生成ssh key：

   ssh-keygen -f /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/ansible/rsaKeys/id_rsa -N ""    //命令中""为两个英文双引号

2. 生成ssh key后，运行以下命令确保用户有权限访问：

   chown -R zstack.zstack /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/ansible/rsaKeys

A：

• 现象及原因：
  使用旧的服务器作为计算节点，可能会遇到因CPU型号过早，无法创建云主机或者创建的云主机不能显示console界面的问题，如下图所示：
  
  
  
  
• 解决方案：
  出现这种情况，可以尝试如下设置：

  1. kvm-nested.conf里面第一行加上ept=0，如：

     options kvm_intel nested=1 ept=0
     #vim /etc/modprobe.d/kvm-nested.conf

  2. 关闭运行状态的VM，然后移除kvm_intel：

     #rmmod kvm_intel

  3. 最后重新加载kvm_intel：

     #modprobe kvm-intel ept=0 unrestricted_guest=0

三种云主机CPU模式：

• none：CPU型号为QEMU模拟器
• host-model：CPU类型为物理主机CPU类型
• host-passthrough：CPU型号跟物理主机CPU完全一样

A：

• 现象：

  "description": "Cannot do an IO operation(e.g. network IO error, file IO error)", "details": "I/O error on POST request for \"http://127.0.0.1:7758/console/establish\": Connect to 127.0.0.1:7758 [/127.0.0.1] failed: Connection refused; nested exception is org.apache.http.conn.HttpHostConnectException: Connect to 127.0.0.1:7758 [/127.0.0.1] failed: Connection refused","$$hashKey": "object:1344"

• 解决方案：

  删除/var/lib/zstack/pickledb/下面的consoleProxy文件，再次重连控制台代理。

A：

• 现象：

  {
    "error": {
      "code": "HOST.1009",
      "description": "Failed to migrate vm on hypervisor",
      "details": "failed to migrate vm[uuid:90bb61f55e774f5f89c9e1ea46db7661] from kvm host[uuid:e5105c61114a4efe8bcc025f744226bd, ip:10.0.247.244] to dest host[ip:10.0.197.238], unable to migrate vm[uuid:90bb61f55e774f5f89c9e1ea46db7661] to qemu+tcp://10.0.197.238/system, internal error: Attempt to migrate guest to the same host localhost.domain.com"
    },
    "createdTime": 1488170137857,
    "type": {
      "_name": "key.event.API.API_EVENT"
    },
    "id": "e6bcd7c33ad9446b919e11cd647fc8dc"
  }

• 原因：

  两台物理机hostname相同。KVM云主机在线迁移依靠hostname进行确认物理机，若hostname相同即被认定为同一台物理机。

• 解决方案：

  建议对物理机设置不同的hostname。若遇到以上报错，请联系官方技术支持获取帮助。

A：

• 原因：

  这种情况一般出现在Guest OS为Linux的云主机上，这是因为缺少ACPID服务（用于处理电源相关事件的守护进程）。KVM云主机安装Linux系统默认是没有安装ACPID服务的，所以不会做处理，关机一分钟后被ZStack杀掉云主机进程强行关闭。

• 解决方案：
  对于这种情况，只需在云主机里安装和启动ACPID服务即可，执行命令如下：

  [root@kvm_client_00 ~]# yum install acpid -y
  # 重新启动ACPID服务，安装后默认加入到开机启动。
  [root@kvm_client_00 ~]# /etc/init.d/acpid restart 

A：高可用状态的云主机失败重启涉及以下流程：

• 通过轮询、触发等机制检测云主机状态，如果确定云主机已停止，那么设置NeverStop的云主机将直接自动重启。
• 通过轮询、触发等机制检测云主机状态，如果不能确定云主机状态，将根据以下步骤进行检测：
  1. 根据已有网络配置，选择最精准的方法探测云主机所在的物理机的状态
  2. 如果物理机状态异常，设置NeverStop的云主机将尝试自动重启。

A：

1. 在Ubuntu依赖库官网搜索Ubuntu 16.04的qemu-ga版本，下载2.5版本的qemu-ga离线deb包：

   https://ubuntu.pkgs.org/16.04/ubuntu-universe-amd64/qemu-guest-agent_2.5+dfsg-5ubuntu10_amd64.deb.html

2. 安装2.5版本的qemu-ga离线deb包：

   dpkg -i <package.deb>    //<package.deb>为下载的2.5版本的qemu-ga离线deb包

3. 在页面修改密码，无报错，修改完成。

A：

• 镜像服务器失联，请确保镜像服务器可用并正常连接。
• 主存储未挂载集群，导致找不到可用的物理机，请确保主存储已挂载集群。
• 集群内没有可用的物理机满足计算规格的定义，请确保物理机可用，且资源满足。
• 主存储容量不足以提供镜像需要的虚拟容量，请确保主存储容量充足。
• 集群未挂载相应的网络，需确保集群已挂载对应的网络
• IP地址池资源不足，需确保IP范围充足
• 镜像服务器与主存储链路异常，请确保镜像服务器下载镜像到主存储的链路正常。
• 确保物理机的分布式DHCP服务dnsmasq服务正常，以正常提供DHCP服务IP分配服务
• 确保物理机的Libvirtd服务正常，以正常提供虚拟化服务
• 如果云主机一直处于启动中，需要检查使用此云主机的镜像是否巨大，镜像缓存的下载是否需要耗时很久。如果镜像缓存存在，需继续检查物理机的/var/log/zstack/zstack-kvmagent.log

A：为了保障云主机时间同步正确，强烈建议为云主机配置独立的时间同步服务器。若为在云主机没配置时间同步服务器，不同操作系统的云主机时间同步机制如下：

• Linux云主机内部系统时间，会随着创建、启动、重启等操作，读取物理机时间作为时钟。云主机时间比物理机时间滞后还是提前，都会生效。
• 创建Windows云主机会自动读取物理机的时间作为时钟。
• 当Windows云主机内部系统时间比物理机时间滞后时，Windows云主机内部系统时间，会随着启动、重启等操作，读取物理机的时间作为时钟。
• 当Windows云主机内部系统时间比物理机时间提前时，启动、重启等操作无法读取物理机的时间。 有可能与Windows系统许可策略有关，例如180天的试用过期后，每1小时会关机一次，倒退时间会逃避微软许可策略。

A：

• lspci -s xx:xx -v检查GPU驱动信息，是否被物理机使用
• 启用物理机IOMMU，BIOS中打开Intel VT-d / AMD IOMMU选项

A：

• 方法一：在创建云主机 > 高级 > SSH登录方式列，选择密码按钮，支持设置云主机密码：
  • Linux镜像：固定用户名root，支持设置SSH密钥和密码。
  • window镜像：固定用户名administrator，仅支持设置密码。
• 方法二：在创建云主机 > 高级 > User Data列，通过Userdata注入方式设置账户/密码。

详情请参考《用户手册》的创建云主机章节。

A：

1. 在ssh服务器上更改/etc/ssh/sshd_config文件中配置如下：

   UseDNS no
   #GSSAPI options
   GSSAPIAuthentication no

2. 执行命令/etc/init.d/sshd restart重启sshd服务。

A：请参考以下步骤启用加密Oracle修正：

1. 在企业版Windows操作系统的运行界面（windows+R），输入gpedit.msc并点击确定按钮，打开本地组策略编辑界面。
2. 点击计算机配置 > 管理模板 > 系统 > 凭证分配 > 加密Oracle修正按钮，进入加密Oracle修正界面。
3. 将加密Oracle修正配置修改为已启用，点击应用按钮，启用加密Oracle修正。
   说明: 若应用后配置未生效，请重启操作系统。

• 现象：
  迁移时报如下错误消息：

  Assertion `ret == cpu >kvm_msr_buf->nmsrs`failed

• 原因：对端物理机的CPU型号和当前服务器CPU型号不同 。
• 解决方案： 迁移到使用相同CPU的物理机，或者关闭云主机进行迁移。

A：使用vim /boot/efi/startup.nsh命令写入以下内容并保存，然后重启云主机，即可正常启动。

FS0:
CD EFI
CD centos
shimx64-centos.efi

A：

• 前提： 主存储未超分或者主存储使用厚置备；使用ImageStore类型的主存储。
• 举例说明：假设主存储有800G的空间，创建一个400G的VM（假定为A），对A创建镜像（假定为B，B的实际大小并非400G，假定为10G）；用B创建新的VM（假定为C），此时B会从镜像服务器上下载到主存储的cache目录（需要消耗主存储的空间10G），镜像下载成功后，主存储的虚拟可用容量就仅剩390G，而创建VM需要400G容量，因此C无法成功创建。

A：

• ZStack允许输入的URL格式为：
  • 支持HTTP/HTTPS方式：
    • 填写格式为：http://path/file或https://path/file
    • 例如：http://cdn.zstack.io/product_downloads/images/zstack-image.qcow2
  • 支持FTP方式：
    • 匿名模式：ftp://hostname[:port]/path/file

      例如：ftp://172.20.0.10/pub/zstack-image.qcow2

    • 非匿名模式：ftp://user:password@hostname[:port]/path/file

      例如：ftp://zstack:password@172.20.0.10/pub/zstack-image.qcow2

  • 支持SFTP方式：
    • 指定密码模式：sftp://user:password@hostname[:port]/path/file

      例如：sftp://root:password@172.20.0.10/pub/zstack-image.qcow2

    • 免密模式：sftp://user@hostname[:port]/path/file

      例如：sftp://root@172.20.0.10/pub/zstack-image.qcow2

  • 镜像服务器上的绝对路径，支持Sftp镜像服务器和镜像仓库

    例如：file:///opt/zstack-dvd/zstack-image-1.4.qcow2

  说明:

  • 建议用户创建一个http服务器来下载镜像。
  • 如果使用本地镜像，注意file后必须为绝对路径。

A：

• 原因：

  下载镜像时，有时因为镜像过大或者网络等原因导致镜像下载太慢超时报错。

• 解决方案：

  如果执行了下载操作，就会在镜像服务器上启用http服务。当UI上显示超时，甚至关闭管理节点时（镜像服务器不在管理节点所在的host），并不影响服务继续运行。

  因此，如果时间过长不用担心。后台会自动下载完成，下次继续添加该镜像时会迅速完成。

A：PCI设备驱动（安装后叫VirtIO Balloon Driver）安装后，可能出现无法通过qemu获取内存信息的问题，解决方法如下：

1. 加载windows-virtio-driver的ISO镜像。
2. 以64位Windows 2012操作系统为例：将驱动文件夹X:\Balloon\2k12R2\amd64目录下的BLNSVR.EXE文件拷贝到C:\Windows\System32目录下。
3. 以管理员方式打开命令行程序并执行BLNSVR -I命令。

A：

• 现象：在安装过程中，无法识别ISO中加载的Virtio驱动，导致无法看到已加载的系统云盘。
• 原因：有可能所用的Windows ISO镜像不是从微软官方下载的，可能是通过其他工具后期定制的。
• 解决方案： 从微软官网下载相应的ISO文件 。

A：

• raw ：裸格式，创建时就需要指定存储容量，占用全部容量，不支持动态扩容，不支持快照，性能好
• qcow2：quick copy on write 2, 写时复制，开始只占用少许容量，支持动态扩容，支持压缩，支持AES加密，支持快照，性能较好

A：

• 现象：对于安装Ubuntu 18版本操作系统的云主机，若grub配置了splash选项，云主机无法启动，启动页面花屏，如图 1和图 2所示：

  
  
  

  
  
  

• 解决方案：请进入设置 > 全局设置 > 基本设置，将显卡类型设置为vga，即可正常启动云主机。
  说明: 该问题仅出现在Ubuntu 18版本中，Ubuntu 18之前的版本均无该问题。

A：ZStack可以给一个区域内不同集群添加不同主存储，主存储可以是本地存储也可以是共享存储。

• 如果主存储为共享存储，则云盘创建在共享存储上，云盘和物理主机无关 ，可以挂载到任意物理节点的云主机上。即：云盘的挂载不受物理主机的相关约束，而且不支持云盘迁移。
• 如果主存储为本地存储，挂载一个卸载过的云盘时，需要保证该云盘和目标云主机在相同的物理主机上。如果该云盘和目标云主机不在相同的物理主机上，需要将云盘和云主机迁移到相同的物理主机上。可以选择迁移云主机（需要首先停止云主机），也可以选择迁移云盘。

A：动态挂载只是Qemu给云主机一个虚拟网卡，使用lspci可以看到此网卡，但是云主机的操作系统使用时，可通过以下方法识别网卡：

• 方法一：重启云主机，重启云主机将自动获取网卡信息。
• 方法二：手动配置网卡，无需重启云主机，步骤如下：
  1. 参考云主机里的 /etc/sysconfig/network-scripts/ifcfg-eth0，对新增的eth1网卡添加配置文件ifcfg-eth1；
  2. 打开eth1网卡配置文件ifcfg-eth1，并设置必要参数，例如：

     [root@VM-web ~]# cd /etc/sysconfig/network-scripts/
     [root@VM-web network-scripts]# vim ifcfg-eth1
     ...
     TYPE=Ethernet
     BOOTPROTO=dhcp
     NAME=eth1
     DEVICE=eth1
     ONBOOT=yes
     ...

     完成后输入命令:wq保存并退出。
  3. 执行systemctl restart network重启网络配置生效，即可识别新添加网卡。

A：

• 原因：

  云主机加载/卸载云盘是动态操作，而云主机的/etc/fstab是静态配置文件。如果加载云盘后修改云主机fstab文件，对该云主机在线创建镜像，使用该镜像创建其它云主机时，由于fstab文件没有相应的挂载信息，所创建的云主机会hang住无法启动。

• 解决方案：
  • Linux云主机加载云盘后不建议通过修改/etc/fstab文件方式挂载。
  • 推荐的做法：
    • 进入/etc/rc.d/rc.local执行mount命令来挂载云盘：

      # chmod +x /etc/rc.d/rc.local
      # mount -U <文件系统UUID> <目标挂载路径>

      说明: 建议使用云盘的文件系统UUID来挂载，而非/dev/vdb类似的盘符来挂载。