H3C Workspace云桌面

监管平台安装部署指导

资料版本：5W107-20230605

产品版本：H3C_Workspace-E1015P02

非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。

除新华三技术有限公司的商标外，本手册中出现的其它公司的商标、产品标识及商品名称，由各自权利人拥有。

本文档中的信息可能变动，恕不另行通知。

3 监管平台安装与访问（云上）··· 30

1 概述

H3C Workspace云桌面监管平台用于对办公及教育场景下的计算、存储等资源的运行状态信息进行监控并展示。用户可通过监管平台数据快速直观地了解到各节点内的办公教学资源利用情况，为优化资源配置提供有效的数据支持。

H3C Workspace云桌面监管平台分为云上和云下版本，二者安装方式有所区别。

· 云下环境H3C Workspace云桌面监管平台可以安装在一台物理服务器或者虚拟机上，安装完成后与H3C Workspace云桌面管理平台（Space Console）建立连接即可同步数据。

· 云上环境H3C Workspace云桌面监管平台可直接作为一个云服务来部署。

2 监管平台安装与访问（云下）

2.1 安装监管平台

2.1.1 安装前准备

· 已完成包含教育场景的Space Console管理平台部署。

· 已从官方渠道获取H3C Workspace云桌面监管平台安装包（viewscreen2.0-installer.tar.gz）。

· 已从官方渠道获取H3Linux_K414_V112.iso系统镜像（H3C Workspace云桌面监管平台运行于一台单独的H3Linux系统服务器上），该系统镜像用于安装服务器底层操作系统。

· 一台未安装操作系统的物理服务器或虚拟机，其配置要求如下表所示。

表2-1 物理服务器或虚拟机配置要求

CPU	内存	存储	备注
≥2核	≥8GB	≥100GB	建议部署于物理服务器

2.1.2 注意事项

安装监管平台过程中会自动安装Docker服务。若已安装Docker服务，为避免冲突，请在安装监管平台前卸载Docker服务。

2.1.3 安装步骤

本文以在VDI类型的虚拟机上部署H3C Workspace云桌面监管平台为例。若在物理服务器上部署，请忽略创建虚拟机这一步骤，其他系统安装等操作与在虚拟机上部署相同。

本文中用于安装H3C Workspace云桌面监管平台的虚拟机，用户也可通过新建课程或新建镜像虚拟机等方式创建，相关操作请参见《H3C Workspace云桌面管理平台用户手册》。

1. 部署监管平台服务器

创建虚拟机

办公场景下，可通过新建镜像虚拟机方式创建虚拟机；教育场景下，可通过新建课程镜像或新建云应用方式创建虚拟机。本文以新建镜像虚拟机方式创建虚拟机为例。

(1) 单击左侧导航树[镜像]菜单项，进入镜像页面。

(2) 单击“系统镜像”页签，单击上方<新建>按钮，弹出“新建系统镜像”对话框。

图2-1 系统镜像页面

(3) 设置镜像名称，根据上传系统镜像选择操作系统类型及版本，设置系统镜像上传路径，单击<点击上传>，在弹出的对话框中选择待上传的镜像文件，单击<打开>按钮开始上传镜像。

· 若系统镜像的上传路径为主机本地目录，则只有该主机能使用该系统镜像。

· 若系统镜像的上传路径为共享存储路径，则所有主机均可使用该系统镜像。

· 请确保系统镜像的上传路径有足够的磁盘空间，否则上传系统镜像将失败。

图2-2 新建系统镜像对话框

(4) 上传完成后，右上角弹出提示框“上传文件成功”，单击<确定>按钮完成新建系统镜像操作。

(5) 单击左侧导航树[镜像]菜单项，进入镜像页面。单击页面中的“镜像虚拟机”页签，展示镜像虚拟机列表。单击页签下的<新建>按钮，弹出“新建镜像虚拟机”对话框。

图2-3 镜像虚拟机页面

(6) 选择新建类型，此处以新建镜像虚拟机为例，单击<下一步>按钮，进入基本信息页面。

图2-4 选择新建类型

(7) 配置镜像名称等相关参数，其中镜像类型选择“VDI”，系统镜像选择已上传的H3Linux系统镜像，单击<下一步>按钮，进入虚拟机配置页面。

图2-5 基本信息

(8) 在“基础配置”页签下，配置存储路径等相关参数，在“高级配置”页签下可配置CPU工作模式等参数，单击<下一步>按钮，进入确认信息页面。确认配置信息是否正确，单击<完成>按钮完成新建镜像虚拟机操作。

图2-6 虚拟机配置

图2-7 确认信息

表2-2 新建VDI镜像虚拟机参数说明

参数名称	参数说明
镜像类型	镜像适配的桌面架构类型，分为VDI、IDV和VOI三种类型，此处选择VDI。
主机	选择镜像虚拟机所在的主机。
系统镜像	镜像虚拟机使用的操作系统的纯净ISO镜像。
类型	设置镜像虚拟机的磁盘类型，包括新建文件、新建RBD块和块设备，其中文件分为新建文件和已有文件。当主机上存在活动的RBD网络存储池时，默认为新建RBD块；反之，默认为新建文件。 · 新建文件：文件是构建在文件系统之上的磁盘文件，虚拟机看到的是一个实际的磁盘，实际使用的是一个虚拟磁盘文件所表示的一个磁盘。文件方式的磁盘挂接方式更便于管理。新建文件是新建一个空的存储文件作为虚拟机的磁盘。 · 新建RBD块：在RBD网络存储池中新建一个RBD块作为虚拟机的磁盘。 · 已有文件：选择一个已经存在且未被其他虚拟机使用的存储文件作为虚拟机的磁盘。可选项包括本地文件目录、共享文件系统、NFS网络文件系统类型的存储池中的存储卷。 · 块设备：块设备也称作裸设备，即磁盘上没有文件系统，如IP SAN或FC SAN上的存储LUN。块设备一般应用于性能要求较高的虚拟化环境，如数据库、高性能I/O计算等。该选项用于选择一个已经存在且未被其他虚拟机使用的存储卷作为虚拟机的磁盘。可选项包括RBD网络存储、iSCSI网络存储、FC网络存储和LVM逻辑存储卷类型的存储池中的存储卷。
存储路径	作为镜像虚拟机文件的存储路径，不作为桌面镜像的最后存储路径。其中，/vms/images和/vms/isos为本地文件目录，建议选择其他路径防止本地目录空间不足。
规格配置	镜像虚拟机适配的VDI终端的配置，可选系统默认的VDI终端或在规格配置中自定义的VDI终端配置。关于规格配置具体操作，请参见《H3C Workspace云桌面管理平台联机帮助》中的“系统管理/规格配置”章节。
网络	选择镜像虚拟机网络通信使用的虚拟交换机。
CPU工作模式	设置CPU的工作模式，包括兼容模式，主机匹配模式，直通模式，默认为兼容模式： · 兼容模式：将不同型号物理CPU虚拟成相同型号的vCPU，迁移兼容性好。 · 主机匹配模式：将不同型号物理CPU虚拟成不同型号的vCPU，迁移兼容性差，相对于兼容模式可以给虚拟机操作系统提供更优的性能。 · 直通模式：直接将物理CPU暴露给虚拟机使用，迁移兼容性差，相对于兼容模式和主机匹配模式可以给虚拟机操作系统提供更优的性能。此模式下，虚拟机在迁移时，要求目的主机与源主机的CPU型号必须保持一致。ARM架构主机仅支持直通模式。
物理机模拟	开启之后，应用软件将把虚拟机作为物理机。当CPU工作模式为主机匹配模式时，才可配置该参数。
文件名	新建文件作为虚拟机的磁盘时，输入磁盘的文件名称，选择文件的磁盘格式，包括高速、智能，默认为智能。 · 智能：虚拟机的磁盘格式为qcow2。 · 高速：虚拟机的磁盘格式为raw。该格式结构简单，I/O效率高。
预分配	存储卷的分配方式，包括精简、延迟置零和置零，默认为精简。当磁盘类型为新建文件时，需要设置此参数。 · 精简：创建存储卷时，只为该存储卷分配最初所需要的数据存储空间的容量。如果之后存储卷需要更多的存储空间，则它可以增加到创建存储卷时设置的最大容量。 · 延迟置零：创建存储卷时就为存储卷分配最大容量的存储空间。创建时不会擦除物理设备上保留的任何数据，在虚拟机首次执行写操作时，将其置零。 · 置零：创建存储卷时就为存储卷分配最大容量的存储空间，在创建过程中会将物理设备上保留的数据置零，创建存储卷所需时间较长。
簇大小	文件占用磁盘空间的最小单位，默认为256KB。如果一个文件的容量大于单个簇大小，该文件将存储到多个簇中；如果一个文件的容量小于单个簇大小，该文件将独占一个簇。共享文件系统存放的文件多为虚拟机镜像文件，建议将簇大小设置的尽可能大，以增强磁盘读取数据的性能，又节约磁盘空间。当新建智能格式的磁盘时，需设置此参数。
总线类型	设置虚拟机磁盘的总线类型，包括IDE硬盘、USB硬盘、高速硬盘、高速SCSI硬盘，默认为高速硬盘。
缓存方式	设置虚拟机数据的缓存方式，包括直接读写、一级物理缓存、二级虚拟缓存、一级虚拟缓存。磁盘格式为“智能”（即qcow2格式）时，默认为直接读写（directsync），磁盘格式为raw、块设备（包括RBD）时，默认只能为一级虚拟缓存（none）。 · 直接读写（directsync）：指数据直接从物理磁盘读写。 · 一级物理缓存（writethrough）：指数据先写入主机缓存，再将主机缓存内的数据写入物理磁盘。 · 二级虚拟缓存（writeback）：指数据先写入虚拟机缓存，再将虚拟机缓存内的数据写入主机缓存，最终写入物理磁盘。 · 一级虚拟缓存（none）：指数据先写入虚拟机缓存，再将虚拟机缓存内的数据直接写入物理磁盘。

(9) 在桌面镜像页面的“镜像虚拟机”页签下可以看到新建的镜像虚拟机。

图2-8 新建VDI镜像虚拟机完成

此时的镜像虚拟机实质上是一台未安装操作系统和必要的驱动的虚拟机。

安装操作系统

(1) 单击新建的镜像虚拟机操作列的<控制台>按钮，进入镜像虚拟机的控制台，开始安装操作系统。

图2-9 打开镜像虚拟机控制台

(2) 依次设置安装语言、键盘布局。

图2-10 开始安装-选择语言

图2-11 选择键盘布局-1

图2-12 选择键盘布局-2

(3) 选择安装软件，选择“Minimal Install”并根据需求勾选安装软件（此处无需勾选安装Docker）。

图2-13 选择安装软件

(4) 单击<NETWORK & HOST NAME>按钮，进入网络和主机名设置页面，在页面下方的Host name区域，设置服务器的主机名。选择需要配置的网卡，单击右下角的<Configure>按钮。

图2-14 配置网络和主机名

图2-15 配置主机名

搭建监管平台双机热备时，请勿修改默认的主机名（localhost.localdomain），若修改可能导致搭建双机热备时hadoop集群状态异常。

(5) 在“General”页签中勾选“Automatically connect to this network when it is available”,单击<保存>按钮。

图2-16 配置网络-1

(6) 在“IPv4 Settings”页签中选择“Manual”模式，手动配置IP地址、子网掩码、服务器网关IP地址、DNS服务器、域名等参数，单击<Save>按钮，保存网络设置。

图2-17 配置网络-2

(7) 启用网卡，单击<Done>按钮，完成网络和主机名设置。

图2-18 配置网络-3

(8) 单击<Begin Installation>按钮，开始安装系统。

图2-19 开始安装系统

(9) 安装过程中需设置root密码，设置后等待系统安装完成。操作系统安装完成后即可安装监管平台。

图2-20 设置root密码-1

图2-21 设置root密码-2

图2-22 系统安装完成

2. 安装监管平台

(1) 通过SSH方式登录系统并把云下安装包（viewscreen2.0-installer.tar.gz）复制到/root/目录下。

图2-23 登录系统

图2-24 复制安装包

(2) 执行tar -xvf viewscreen2.0-installer.tar.gz命令解压安装包。

图2-25 解压安装包

(3) 执行cd viewscreen2.0-installer/命令进入解压后的安装目录。

图2-26 进入安装目录

(4) 执行bash master_install.sh命令开始安装监管平台组件。

图2-27 安装监管平台

(5) 安装完成后执行docker ps命令，查看监管平台组件运行状态是否正常。STATUS处于“Up”状态表示组件正常运行中。

图2-28 查看监管平台组件运行状态是否正常

(6) 安装完成后，可在/opt/viewscreen目录下查看监管平台组件运维脚本。

表2-3 脚本说明

脚本名称	说明
install.sh	安装和升级的统一入口，用于安装或者升级服务
master_install.sh	master节点安装脚本，用于master节点安装服务，实际入口为install.sh脚本
slave_install.sh	slave节点安装脚本，用于slave节点安装服务，实际入口为install.sh脚本
slave_uninstall.sh	slave节点卸载脚本，用于卸载slave节点服务，实际入口为uninstall.sh脚本
worker_install.sh	worker节点安装脚本，用于worker节点安装服务，实际入口为install.sh脚本
worker_uninstall.sh	worker节点卸载脚本，用于卸载worker节点服务，实际入口为uninstall.sh脚本
rebuild.sh	用于重新构建镜像和容器，一般用在替包之后更新环境。另外，升级脚本时也会调用rebuild脚本
restart.sh	用于重启服务，服务器重启时系统会自动调用该脚本进行服务的启动
restart_to_standalone.sh	用于双机热备切换至单机环境,
uninstall.sh	卸载脚本，用于卸载服务，删除容器、镜像和数据库表
get_pipeline_info.sh	流水线信息

· 监管平台组件的服务日志文件放在/var/viewscreen/log/timeFile目录下。

· 软件安装成功后，无需进行将VDI镜像虚拟机发布为桌面镜像等后续操作。可在[数据中心/虚拟化]中查看虚拟机信息并通过控制台进入虚拟机进行后续软件维护升级等相关操作。

· 如需卸载监管平台组件，执行安装目录下的uninstall.sh脚本即可。

3. 安装后配置

(1) H3C Workspace云桌面监管平台安装部署完成后，登录H3C Space Console管理平台，在[系统/组织机构]更新设置监控局点组织机构信息。

图2-29 组织机构设置

(2) 在H3C Space Console管理平台，通过[系统/高级设置/系统参数/高级参数]开启上报监管平台数据。开启后，需设置上报监管平台数据地址为https://<监管平台所在服务器或虚拟机IP>:18443，并设置上报监管平台时间间隔，以使监管平台获取Workspace管理平台办公和教育相关数据。

图2-30 开启上报监管平台数据

· 默认上报监管平台数据地址为：https://wdc.h3c.com/api/v2/data-gateway，请根据实际情况修改。

· 管理平台数据默认上报时间间隔为10分钟，可修改上报监管平台时间间隔，修改后将立即上报当前数据。

2.2 访问监管平台

2.2.1 浏览器要求

H3C Workspace云桌面监管平台支持浏览器访问。浏览器要求如下：

· 必须关闭浏览器的弹出窗口阻塞设置。

· 必须使能浏览器的Cookies。

· 必须将H3C Workspace云桌面监管平台站点加入浏览器的受信任站点。

· 浏览器需要的显示器分辨率宽度至少为1280，推荐分辨率为1440*900或者更高。

· 推荐使用Chrome 73+、FireFox 49+及其以上版本的浏览器。

2.2.2 访问方法

(1) 打开浏览器，在地址栏中输入“https://<监管平台所在服务器或虚拟机IP>:8080/viewscreen”或“https://<监管平台所在服务器或虚拟机IP>:18443/viewscreen”进入H3C Workspace云桌面监管平台登录页面。

(2) 输入用户名和密码（默认为admin/Cloud@1234）即可访问H3C Workspace云桌面监管平台。

图2-31 监管平台登录页面

图2-32 监管平台首页

2.3 部署监管平台HA

2.3.1 部署前准备

在开始搭建H3C监管平台HA服务之前，请先使用H3Linux_K414_V112.iso系统镜像搭建两台新的物理服务器或虚拟机，规格请参考表2-1，在物理服务器或虚拟机中无需安装其他软件，包括监管平台安装包。

2.3.2 注意事项

部署监管平台HA过程中的注意事项如下：

· 监管平台HA部署过程中会自动在备节点上安装监管平台服务。若备节点上已安装监管平台服务，为避免冲突，请在监管平台HA部署前卸载其监管平台服务。

· 主备节点的root密码需一致。

· 监管平台HA部署过程中会使用两个备节点，备节点1用于提供监管平台服务的热备，备节点2用于提供部分服务组件的热备。

· 请保证操作系统的防火墙为开启状态，默认情况下为开启状态。

2.3.3 部署方法

(1) 登录监管平台，打开“系统配置/双机热备设置”页面，配置备节点信息，单击<网络检测>按钮，备节点能正常连接的情况，单击<下一步>按钮。

图2-33 双机热备服务器信息设置页面

(2) 配置网络信息，VIP地址必须与主备IP地址在同一网段，单击<完成>按钮，系统会自动搭建HA，搭建HA期间请勿执行其他操作。

图2-34 双机热备网络设置页面

(3) 双机热备部署完成后，页面将展示各服务的状态。若某个服务状态异常，可单击页面下方<一键执行>按钮进行自动修复。如果需要卸载双机热备，则可以单击页面下方<卸载>按钮进行卸载。

图2-35 双机热备搭建完成页面

3 监管平台安装与访问（云上）

3.1 安装监管平台

3.1.1 安装前准备

· 已完成CloudOS系统环境的部署，且CloudOS已纳管Workspace服务，具体请参见《H3C Workspace云桌面安装指导(云形态)》。

· 已从官方渠道获取H3C Learningspace监管平台安装包（cloudos-viewscreen2-version.zip）。

3.1.2 安装步骤

(1) 将H3C Learningspace监管平台安装包“cloudos-viewscreen2-version.zip”上传至CloudOS服务器/opt/sys-app/package-files/目录下。

(2) 上传完毕后，登录CloudOS云操作系统（默认用户名/密码为admin/Passw0rd@_），进入[系统/组件与服务/部署向导]页面。

(3) 单击勾选“cloudos-viewscreen2”后单击<立即部署>按钮，开始部署。

图3-1 进入部署向导页面

图3-2 正在部署cloudos-viewscreen2

图3-3 部署完成-1

(4) 部署完成后点击云服务与系统组件按钮，进入服务列表，在服务信息页面可以看到cloudos-viewscreen2服务状态。

图3-4 cloudos-viewscreen2服务状态

图3-5 cloudos-viewscreen2服务状态

用户可通过云操作系统中[云服务/应用服务/教育云上监管]进入监管平台，也可直接在浏览器地址栏通过监管平台地址直接登录访问Workspace监管平台。

3.1.3 安装后配置

云上监管平台安装完成后，需进入CloudOS纳管的云下Workspace管理平台设置组织机构、开启上报监管平台数据。

(1) 进入CloudOS纳管的Workspace管理平台，在[系统/组织机构]更新设置监控局点组织机构信息。

图3-6 组织机构设置

(2) 在CloudOS纳管的云下Workspace管理平台中，通过[系统/高级设置/系统参数/高级参数]开启上报监管平台数据。开启后，需设置上报监管平台数据地址为https://<CloudOS管理平台IP>:18443，并设置上报监管平台时间间隔，以使监管平台获取Workspace管理平台办公和教学相关数据。