ZStack 使用 Spice 协议指南 版本 1.10 日期

ZStack 使用 Spice 协议指南 版本 1.10 日期 2017-04-7

版权所有 上海云轴信息科技有限公司 2017 保留一切权利 非经本公司书面许可, 任何单位和个人不得擅自摘抄 复制本文档内容的部分或全部, 并不得以任何形式传播 商标说明 和其他云轴商标均为上海云轴信息科技有限公司的商标 本文档提及的其他所有商标或注册商标, 由各自的所有人拥有 注意您购买的产品 服务或特性等应受上海云轴公司商业合同和条款的约束, 本文档中描述的全部或部分产品 服务或特性可能不在您的购买或使用范围之内 除非合同另有约定, 上海云轴公司对本文档内容不做任何明示或暗示的声明或保证 由于产品版本升级或其他原因, 本文档内容会不定期进行更新 除非另有约定, 本文档仅作为使用指导, 本文档中的所有陈述 信息和建议不构成任何明示或暗示的担保 上海云轴信息科技有限公司 地址 : 上海市闵行区紫竹科学园东川路 555 号 6 号楼 邮编 :200241 网址 : http://www.zstack.io/ 客户服务邮箱 : support@zstack.io 客户服务电话 : 400-962-2212 概述 本文档为 ZStack 使用 Spice 远程桌面过程进行说明 读者对象 本文档适合以下工程师阅读 : 运维工程师 测试工程师 存储工程师 预研工程师 版本 1.10 上海云轴版权所有 2017 2 / 17

术语定义 术语管理节点计算节点云主机镜像镜像服务器云盘计算规格云盘规格安全组 L2NoVlanNetwork L2VlanNetwork 二层网络三层网络管理网络公有网络 概念安装 ZStack 系统的物理主机, 提供 UI 管理 云系统部署功能也称之为物理主机, 为云主机实例提供计算 内存 网络 存储的物理主机 运行 KVM 虚拟化的物理主机, 简称 KVM 主机 ZStack 特制虚拟机, 即运行在物理机上的虚拟机实例, 具有独立的 IP 地址, 可以安装部署应用服务云主机所使用的镜像模板文件, 包含了云主机的操作系统, 也可以定制安装相应的软件也称之为备份存储服务器, 存储云主机镜像文件的物理主机 虽然可以和管理节点或其他计算节点共享同一台物理服务器, 但不建议在生产环境中这么部署云主机的数据盘, 给云主机提供额外的存储空间, 一块云盘在同一时刻只能挂载到一个云主机 一个云主机最多可以挂载 24 块云盘启动云主机涉及到的 CPU 数量 内存大小 网络设置等规格定义创建云盘容量大小的规格定义针对云主机进行第三层网络的防火墙控制, 对 IP 地址 网络包类型或网络包流向等可以设置不同的安全规则物理主机的网络连接不采用 Vlan 设置物理主机节点的网络连接采用 Vlan 设置,Vlan 需要在交换机端提前进行设置计算节点的物理网卡设备名称, 例如 eth0 云主机需要使用的网络配置, 包括 IP 地址范围, 网关,DNS 等 ZStack 管理物理机和其他云资源的网络云主机连接和使用的网络 中英文术语对照 管理节点 物理机 云主机 Management Node Host VM Instance 镜像服务器 ( 备份服务器 ) Backup Storage 版本 1.10 上海云轴版权所有 2017 3 / 17

主存储镜像云盘集群区域二层网络三层网络安全组计算规格云盘规格扁平网络模式本地存储 Primary Storage Image Volume Cluster Zone L2 Network L3 Network Security Group Instance Offering Disk Offering Flat Network Mode Local Storage 版本 1.10 上海云轴版权所有 2017 4 / 17

修改记录 修改记录积累了每次文档更新的说明 最新版本的文档包含以前所有文档版本的更新内容 文档版本 1.10(2017-04-07) 第一次正式发布 版本 1.10 上海云轴版权所有 2017 5 / 17

目录 第一章概述... 7 第二章 Spice 和 QXL 设置... 8 2.1 设置 Spice 远程桌面协议... 8 2.2 设置 QXL 显卡... 8 第三章下载并安装 Spice 客户端... 10 第四章用 Spice 客户端安装 windows QXL 驱动... 11 4.1 添加 windows ISO 和 virtio 驱动 ISO... 11 4.2 创建 windows 云主机并检查 Spice 端口... 12 4.3 使用 Spice 客户端连接云主机... 14 4.4 更新驱动为 QXL... 16 版本 1.10 上海云轴版权所有 2017 6 / 17

第一章概述 目前 ZStack 云主机的桌面显示默认采用 VNC 协议, 其占用网络流量较小, 适用于常见的 Linux 云主机管理, 但其对视频播放的支持度不佳, 不能满足虚拟桌面的使用需求,Spice 协议提供了优质的远程虚拟桌面, 可以直接访问远程机器桌面和设备, 支持 GPU 加速 图片渲染等功能, 在有较强虚拟桌面需求时, 建议使用 Spice 协议 ZStack 也支持 Spice 协议, 给用户提供卓越的虚拟桌面体验, 仅需更改全局设置, 切换显示模式, 即可享受无缝的视频传输体验 Spice 协议结合 QXL 的半虚拟化显卡, 可以提供比 VGA 显卡更好的视频体验, 建议在使用时, 采用 QXL 模式的显卡, 并安装相应的显卡驱动 本文主要简述在 ZStack 云管理平台如何使用 Spice 协议 本文首先介绍了如何设置 Spice 显示协议及 QXL 显卡类型, 如何下载安装 Spice 的 Win 10 客户端, 接着以 Window7 x64 为例, 演示了如何使用 Spice 客户端进行 Window7 x64 云主机的远程连接, 并概述了如何安装 QXL 显卡驱动 版本 1.10 上海云轴版权所有 2017 7 / 17

第二章 Spice 和 QXL 设置 用户在使用 Spice 协议前, 请参考相关文档完成基本的 ZStack 云平台环境部署 2.1 设置 Spice 远程桌面协议 ZStack 默认的图形界面显示协议为 VNC 协议, 需要更新显示协议, 即在全局变量中更改 VNC 协议为 Spice 协议 [root@localhost ~]# zstack-cli LogInByAccount accountname=admin password=password [root@localhost ~]# zstack-cli UpdateGlobalConfig category=kvm name=vm.consolemode value=spice 在安装有 ZStack 的管理节点上利用 zstack-cli 修改系统全局变量 : 图一更改全局变量 2.2 设置 QXL 显卡 ZStack 云主机支持三种显卡类型 :cirrus,vga,qxl, 在使用 Spice 协议下推荐使用 QXL 显卡, 让 Windows 虚拟机图形页面更加流畅 以下是修改 QXL 的两种方法 : 1. 使用 zstack-cli 设置 QXL 显卡模式 : [root@localhost ~]# zstack-cli UpdateGlobalConfig category=vm name=videotype value=qxl 版本 1.10 上海云轴版权所有 2017 8 / 17

2. 在管理节点 UI 选择基础设置选项, 更改云主机显卡为 qxl 类型 图二设置 QXL 显卡 版本 1.10 上海云轴版权所有 2017 9 / 17

第三章下载并安装 Spice 客户端 Spice 协议需要使用特定的客户端工具, 用户可以在客户端 (PC 或笔记本电脑 ) 下载并安装 Spice 的客户端 Spice 客户服务端下载地址 ( 适用于 Win x64): https://releases.pagure.org/virt-viewer/virt-viewer-x64-5.0.msi 本文以 Win10 64 客户端为例, 如果客户端为 Linux 操作系统, 可参考以下链接进行安装 : https://www.spice-space.org/download.html 下载完成后, 安装 virt-viewer, 安装完成请从应用程序中查找 Remote viewer 应用程 序 请按照下方提示格式 :spice://hostip:port 格式输入正确地址 打开 Remote viewer 后 如下图所示 : 图三安装 spice 客户端 版本 1.10 上海云轴版权所有 2017 10 / 17

第四章用 Spice 客户端安装 windows QXL 驱动 4.1 添加 windows ISO 和 virtio 驱动 ISO 在 UI 界面参考图四添加 windows iso 和 virtio iso 图四镜像导入注意 : 添加镜像时选择镜像类型为 ISO, 选择平台为 WindowsVirtio Virtio iso 的下载地址 : https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso ZStack 定制 ISO 已集成了 virtio iso, 在采用 ZStack 定制版 iso 安装镜像服务器后, 可通过以下路径添加 virtio iso: file:///opt/zstack-dvd/zstack-windows-virtio-driver-1.7.iso 版本 1.10 上海云轴版权所有 2017 11 / 17

4.2 创建 windows 云主机并检查 Spice 端口 使用 Windows7 ISO 创建云主机 图五创建云主机成功 检查云主机的 Spice 端口号, 此处有两种方法 : 1. 通过命令行检查 Spice 和查看端口号 [root@localhost ~]# virsh dumpxml vmuuid grep spice i 图六检查 spice 协议和查看端口号 可查看到在该虚拟机上使用 Spice 的端口号为 5900 版本 1.10 上海云轴版权所有 2017 12 / 17

2. 在 ZStack UI 页面中查看 Spice 地址和端口号 查看云主机详情页查看 VNC 连接地址, 如显示内容为 spice 则表示成功修改协议, 获 得 Spice 端口号为 5900 图七查看 spice 端口号 版本 1.10 上海云轴版权所有 2017 13 / 17

4.3 使用 Spice 客户端连接云主机 使用 Spice 客户端 Remote viewe, 输入正确的 ip 地址和 Spice 端口号进入 windows 云主 机, 参考 Windows 系统模板封装文档进行系统安装和 virtio 驱动安装 图八使用 Spice 客户端连接云主机 版本 1.10 上海云轴版权所有 2017 14 / 17

注意 : 当在 Spice 中成功启动 windows 云主机后, 未出现安装系统界面时, 可通过 ZStack 的 的 UI 页面更改启动顺序 [CdRom,HardDisk], 重新启动云主机并进入 Spice 图形界面, 完成 Windows 安装 图九 Windows7 安装界面 版本 1.10 上海云轴版权所有 2017 15 / 17

4.4 更新驱动为 QXL Windows7 系统安装完成后, 加载 virtio 驱动 ISO, 按照封装文档更新网卡,SCSI 控制 器等, 另外需手动更新显卡驱动程序 右键点击显卡适配器 标准 VGA 图形适配器按钮, 选 择更新驱动程序软件, 点击更新驱动程序 图十更新驱动程序 版本 1.10 上海云轴版权所有 2017 16 / 17

选择在挂载的 virtio 中查找可供更新的显卡驱动, 选择 Red Hat QXL 驱动 图十一更新驱为 Red Hat QXL GPU 至此, 基于 QXL 显卡驱动的 Spice 协议在 Windows 虚拟机上安装完成 更多的配置与实践指导请访问 ZStack 企业版官方网站 http://www.zstack.io/. 具体封装镜像封装步骤可参考 Windows 系统模板封装的详细步骤 版本 1.10 上海云轴版权所有 2017 17 / 17