H3C Workspace云桌面

UOS桌面镜像配置指导(办公场景)

资料版本：5W105-20220531

Copyright © 2021-2022 新华三技术有限公司 版权所有，保留一切权利。

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

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

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

目录

1 简介··· 1

2 配置前准备··· 1

3 配置流程··· 1

4 注意事项··· 2

5 配置指导··· 2

5.1 新建系统镜像·· 2

5.2 新建镜像虚拟机·· 3

5.3 为镜像虚拟机安装操作系统·· 6

5.4 进入开发者模式·· 14

5.4.1 系统试用期激活·· 15

5.4.2 进入开发者模式·· 17

5.5 安装云桌面组件·· 21

5.6 安装Xorg组件·· 31

5.6.2 在线安装Xorg· 32

5.6.3 离线安装Xorg· 35

5.7 安装其他应用软件·· 37

5.8 发布桌面镜像·· 38

6 附录··· 40

6.1 如何将无线网络共享给有线网络·· 40

6.2 修改Agent中管理平台地址·· 40

6.3 安装补丁支持磁盘映射·· 41

6.4 UOS 1042版本系统修改common-auth文件·· 41

统信UOS（Unity Operating System）是一款基于Linux的中文国产操作系统。H3C Workspace云桌面紧跟国产化操作系统的趋势，能完美的适配统信UOS，为用户提供安全稳定、美观易用的桌面操作系统。

本文以E1012版本为例，介绍UOS桌面镜像的制作方法，其他版本操作请以实际情况为准。

配置UOS桌面镜像前，请参照下表完成相关准备工作。

表2-1 配置前准备

准备项

说明

Workspace管理平台

·     已完成管理平台的部署，并已配置可用空间充足的镜像存储路径

·     推荐管理平台已配置可访问外网的虚拟交换机，以便联网激活UOS系统和进入开发者模式

Union ID

统信账号，可在统信UOS官网https://www.chinauos.com进行注册

UOS系统镜像

·     请联系技术支持工程师获取UOS系统镜像ISO文件

·     推荐使用专业版1022、1041或1042的UOS桌面操作系统

¡     X86架构服务器请使用：uniontechos-desktop-20-professional-1022_amd64.iso、uniontechos-desktop-20-professional-1041-arm64.iso、uniontechos-desktop-20-professional-1042-amd64.iso

¡     ARM架构服务器请使用：uniontechos-desktop-20-professional-1022_arm64.iso

UOS桌面镜像的配置流程如下：

(1)     新建系统镜像：上传UOS系统镜像，用于创建对应操作系统的镜像虚拟机。

(2)     新建镜像虚拟机：使用UOS系统镜像新建镜像虚拟机。

(3)     为镜像虚拟机安装操作系统：为镜像虚拟机安装UOS操作系统，并完成系统配置等。

(4)     进入开发者模式：试用期激活，并进入开发者模式，以便安装云桌面组件和Xorg组件。

(5)     安装云桌面组件：在开发者模式下，挂载驱动光驱，并安装CAStools、Agent、和USB组件。

(6)     安装Xorg组件：为镜像虚拟机安装QXL显卡驱动的Xorg组件以提升用户体验。

(7)     安装其他应用软件：为UOS桌面镜像安装其他所需办公软件。

(8)     发布桌面镜像：将镜像虚拟机克隆为桌面镜像。

目前，H3C Workspace云桌面仅支持VDI类型的UOS桌面镜像。

系统镜像是桌面镜像的基础。本章以uniontechos-desktop-20-professional-1022_amd64.iso为例，介绍如何在管理平台中上传UOS的ISO系统镜像。

(1)     单击左侧导航树[数据中心/系统镜像]菜单项，进入系统镜像页面。单击上方按钮，弹出“新建系统镜像”对话框。

图5-1 新建系统镜像

(2)     配置相关参数，并上传uniontechos-desktop-20-professional-1022_amd64.iso，上传完成后，单击按钮。其中，操作系统选择“Linux”，版本选择“UOS SP2桌面版(64位)”，上传路径建议选择“/vms/isos”。

图5-2 系统镜像配置

·     若系统镜像的上传路径为主机本地目录，则只有所选主机能使用该系统镜像；若系统镜像的上传路径为共享存储路径，则所有主机均可使用该系统镜像。

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

图5-3 系统镜像上传成功

(1)     单击左侧导航树[镜像/桌面镜像]菜单项，进入桌面镜像页面后，单击页面中的“镜像虚拟机”页签，展示镜像虚拟机列表。

图5-4 镜像虚拟机

(2)     单击按钮，进入新建镜像虚拟机页面。配置相关参数，并单击按钮。

·     镜像类型：请选择“VDI”。当前UOS仅支持VDI类型的云桌面。

·     规格配置：UOS系统安装时系统盘要求不小于64GB，因此推荐使用系统盘为80GB的规格。若无此规格，请在规格配置页面新建。

·     系统镜像：请选择已上传的UOS系统镜像。

·     网络：若所选虚拟交换机可访问外网，则后续可通过在线激活方式进入开发者模式为镜像虚拟机安装agenttools；若不能访问外网，可通过离线激活方式进入开发者模式。推荐选择可访问外网的虚拟交换机，此处以vs_business为例。

图5-5 新建镜像虚拟机

图5-6 镜像虚拟机新建成功

此时的镜像虚拟机实际上为一台未安装操作系统、应用软件和必要驱动等的空白虚拟机。

(1)     单击图5-6中镜像虚拟机操作列的“控制台”，进入镜像虚拟机控制台，默认打开统信UOS安装向导的选择语言页签。选择语言，并勾选下方复选框后，单击按钮。

图5-7 选择语言

(2)     由于当前使用虚拟机安装UOS，因此将弹出如下对话框，请单击按钮继续。

图5-8 友情提示

(3)     在硬盘分区页面，选择“全盘安装”，选中下方系统盘，并根据实际情况勾选“全盘加密”后，单击按钮。

图5-9 硬盘分区

全盘加密的虚拟机开机时，将先对磁盘数据进行解密后才能读取磁盘中的数据。因此，虚拟机开机速度将受一定影响。

(4)     在准备安装页面，单击按钮，开始安装UOS。

图5-10 准备安装

图5-11 正在安装UOS

UOS安装过程中，可单击下方按钮，查看安装日志。

(5)     系统安装完后单击下方按钮，重启系统，并自动进入后续安装配置页面，配置键盘布局、时区、帐户等。

图5-12 安装成功

图5-13 设置键盘布局

图5-14 选择时区

图5-15 创建帐户

请记住用户名和密码，以便后续以该用户登录系统，并安装相关组件。

图5-16 优化系统该配置

(6)     优化系统配置完成后，自动进入登录页面，使用创建的用户登录系统，并选择“普通模式”。

图5-17 登录

图5-18 普通模式登录

(7)     登录成功后，进入系统桌面，默认弹出桌面体验配置向导。

图5-19 系统桌面

(8)     单击按钮，完成桌面样式、运行模式和图标主题的配置。

图5-20 选择桌面样式

图5-21 选择运行模式

图5-22 选择图标主题

(9)     配置完成后，进入系统桌面。

图5-23 系统桌面

UOS系统安装完成后，需进入开发者模式，以便后续安装云桌面组件（CAStools、Agent和USB组件），以及Xorg组件。

统信UOS版本不同，系统激活和进入开发者模式的方法可能有差异，请以实际版本为准。

对于推荐的UOS专业版，可通过在线激活或离线激活的方式进入开发者模式。

·     在线激活：适用于镜像虚拟机能访问外网的场景。

·     离线激活：适用于镜像虚拟机无法访问外网的场景，需导出后缀为.json的机器信息文件，并前往https://www.chinauos.com/developMode上传机器文件后下载离线证书，最后将证书通过FTP的方式拷贝到镜像虚拟机中，并导入离线证书。

下文仅以在线激活为例进行介绍。

对于推荐的UOS专业版，进入开发者模式前，需激活系统。可在线进行系统试用期激活或者使用序列号或导入激活文件激活。

本文以在线进行系统试用期激活为例，当前管理平台无法连接外网，可将现场无线网络通过网线共享给管理平台所在服务器，具体请参考如何将无线网络共享给有线网络。

(1)     在系统桌面，单击任务栏授权管理图标，并在弹出的激活提示中，单击按钮，弹出统信UOS激活对话框。

图5-24 试用期激活

(2)     完成试用期激活，激活后下方授权图标将变为橙色。

图5-25 立即激活

图5-26 确定激活试用期

图5-27 激活成功

(1)     单击桌面任务栏中控制中心图标，并选择“通用”，进入通用设置页面。

图5-28 控制中心

图5-29 通用设置

(2)     单击[开发者模式]菜单项，并单击按钮，打开进入开发者模式对话框。

图5-30 开发者模式

图5-31 进入开发者模式

(3)     选择“在线激活”，并单击按钮，弹出Union ID登录对话框。输入已在统信官网注册的Uoion ID账号和密码，并勾选下方复选框后，单击按钮。

图5-32 Union ID登录

(4)     在弹出的隐私政策对话中，勾选“我已阅读并同意《隐私政策》”，并单击按钮，进入开发者模式免责声明。

图5-33 隐私政策

(5)     勾选“同意并进入开发者模式”，单击按钮，在弹出的对话框中，单击按钮，重启镜像虚拟机使开发者模式生效。

图5-34 开发者模式免责声明

图5-35 现在重启

云桌面组件包括CAStools、Agent和USB组件，可通过agenttools中的一个安装脚本完成相关组件的安装。对于X86架构管理平台和ARM架构管理平台，云桌面组件的安装方法基本相同。

·     X86架构管理平台：挂载驱动光驱后到目录/media/test/agenttools/linux/x86/uos/agent目录执行sudo bash install.sh即可。其中，test为镜像虚拟机登录用户。

·     ARM架构管理平台：挂载驱动光驱后到目录/media/test/agenttools/linux/arm64/uos/agent目录执行sudo bash install.sh即可。其中，test为镜像虚拟机登录用户。

此处以X86架构管理平台为例。

(1)     单击控制台右上角按钮，并选择[挂载驱动光驱]菜单项，为镜像虚拟机挂载驱动光驱。

图5-36 挂载驱动光驱

(2)     打开桌面计算机，找到已挂载的驱动光驱。

图5-37 agenttools驱动光驱

(3)     双击agenttools驱动光驱，进入“linux”文件夹，并根据管理平台架构，进入“x86”或“arm64”子文件夹，进入“uos”文件夹，最后进入“agent文件夹”，右键单击文件夹空白处，选择[在终端中打开]菜单项，打开终端命令窗口。

图5-38 打开终端命令窗口

(4)     在终端命令窗口中执行sudo bash install.sh命令，并输入当前登录用户密码,开始安装CAStools和Agent。

图5-39 执行安装命令

(5)     Agent安装过程中，提示“PLEASE INPUT CONTROLLER IP ADDRESS”时，请输入管理平台的管理IP地址后，然后回车，继续安装。若Agent安装完成后，需修改已配置的管理平台地址，可参见修改Agent中管理平台地址。

图5-40 输入管理平台IP地址

(6)     Agent安装完成后，将自动安装USB组件等。

(7)     安装加域组件并配置域控服务器（仅X86版本支持）。

如使用UOS 1042版本系统镜像，需修改/etc/pam.d/common-auth文件，否则会出现域账号密码无法校验的问题，具体修改方式请参考附录UOS 1042版本系统修改common-auth文件。

a.     USB安装完成后，将提示“Continue installing the domain package?”。请根据实际情况输入1或2，然后回车。若输入1，将继续安装AD域控组件。

图5-41 虚拟机加域提示

b.     AD域控组件安装完成后，执行sudo vim /etc/resolvconf/resolv.conf.d/head命令，并新增nameserver IP，然后保存。此处，IP为实际环境中域控服务器地址。

c.     域控服务器地址配置完成后，执行sudo resolvconf –u使配置立即生效。

d.     执行ping domain.url命令，即ping域控服务器的域名，可根据系统返回结果判断域控服务器是否生效。

图5-42 配置并验证域控服务器

e.     域控服务器配置成功后，请重启虚拟机。

(8)     配置虚拟机网络信息

目前CAStools安装完成重启后，镜像虚拟机无法自动获取IP信息，需为其配置IP信息。配置前请先清空虚拟机网卡配置文件。

a.     执行sudo vim /etc/network/interfaces命令并输入当前登录用户的密码，进入interfaces文件。执行:%d命令清空interfaces文件后，输入:wq保存并退出。

b.     在管理平台虚拟化页面，找到该镜像虚拟机，并根据实际情况将修改虚拟机网络，将其IPv4信息改为“DHCP”或“手工配置”。

图5-43 修改虚拟机网络

c.     配置完成后，执行sudo systemctl restart networking命令重启网络服务，并执行ip a命令查看虚拟机IP地址。

图5-44 查看虚拟机IP

(9)     执行如下命令检查虚拟机网络以及云桌面组件是否安装完成。

¡     执行ps -ef | grep spice命令检查Agent是否正常。若出现如图5-45所示内容，则表明Agent安装成功。

¡     执行ps –ef | grep eveusb命令检查USB组件是否正常。若出现如图5-46所示内容，则表明USB组件安装成功。

¡     执行ps –ef | grep qemu-ga命令检查CAStools是否正常。若出现如图5-47所示内容，则表明CAStools安装成功。

图5-45 检查Agent

图5-46 检查USB组件

图5-47 检查CAStools

·     对于ARM架构管理平台，需先在虚拟化页面找到对应镜像虚拟机，将其显卡类型改为QXL（如图5-48、图5-49所示），并重启后，再进行Xorg组件安装。

·     使用dpkg -l | grep qxl命令查看系统是否自带QXL驱动，若系统自带则无需安装。

·     QXL驱动未安装时请参考在线安装Xorg进行安装，若需要离线安装时请联系技术支持工程师获取QXL驱动的Xorg组件安装包。

为提高用户体验，强烈建议您安装QXL显卡驱动的Xorg组件。

·     若当前环境可访问外网，可在线安装Xorg组件。

·     若当前环境无法访问外网，可将Xorg组件安装包xserver-xorg-video-qxl_0.1.5.1-1rebuild_amd64.deb拷贝到UOS镜像虚拟机中，执行sudo dpkg -i xserver-xorg-video-qxl_0.1.5.1-1rebuild_amd64.deb命令安装。

图5-48 修改镜像虚拟机

图5-49 修改显卡类型

(1)     执行sudo apt update命令获取升级软件。

图5-50 获取升级包

(2)     执行sudo apt-get install xserver-xorg-video-qxl命令安装QXL显卡驱动。

图5-51 安装QXL显卡驱动

图5-52 QXL显卡驱动安装成功

此处以X86架构Xorg安装包为例，ARM架构安装包操作方法相同。

(1)     使用带有FTP服务的软件（如Mobaxterm）将Xorg安装包xserver-xorg-video-qxl_0.1.5.1-1rebuild_amd64.deb拷贝到UOS镜像虚拟机中。此处以拷贝到系统桌面为例。

图5-53 Xorg组件拷贝到镜像虚拟机

(2)     单击桌面空白处，选择[在终端打开]菜单项，并在打开的对话框中，执行sudo dpkg -i xserver-xorg-video-qxl_0.1.5.1-1rebuild_amd64.deb命令安装Xorg组件。安装过程中，请输入当前登录用户的密码。

图5-54 安装Xorg组件

(3)     安装完成后，执行dpkg -l | grep xserver-xorg-video-qxl命令查看Xorg是否安装完成。若出现如下图所示内容，则表明Xorg安装成功。

图5-55 查看Xorg组件

在联网且UOS系统已激活情况下，登录Union ID后，可通过UOS系统的应用商店（如图5-56所示）安装办公所需其他软件。未联网情况下，可使用带有FTP服务的软件（如Mobaxterm）将所需软件的安装包拷贝到UOS镜像虚拟机中进行安装。

图5-56 应用商店

UOS镜像虚拟机配置完成后，可通过克隆或转换的方式发布为桌面镜像。桌面镜像可以用于新建桌面池和部署桌面。

本文以克隆为桌面镜像为例。

(1)     单击左侧导航树[镜像/桌面镜像]菜单项，进入桌面镜像页面后，单击“镜像虚拟机”页签，展示镜像虚拟机列表。

(2)     将镜像虚拟机正常关机后，单击待克隆镜像虚拟机操作列的“克隆为桌面镜像”，在弹出的对话框中完成相关配置后，单击按钮。

图5-57 克隆为桌面镜像

(3)     克隆成功后，可在桌面镜像列表中，看到已发布的桌面镜像。此时，该桌面镜像可用于创建VDI桌面池并部署桌面。

图5-58 发布成功的桌面镜像

(1)     先确认虚拟机所在服务器的IP地址与网关，例如服务器IP地址为192.168.1.14，网关为192.168.1.1。

(2)     使用网线将一台笔记本的网口与服务器相连，并将笔记本的网口地址设置为网关地址，如192.168.1.1/24。

(3)     将笔记本连上无线网络，并将其无线网卡设置共享给有线网卡，如下图所示。

图6-1 无线网卡共享给有线网卡

(4)     若与笔记本通过网线相连的服务器需连外网，则为服务器配置DNS地址为8.8.8.8，即可实现域名解析。

(5)     若服务器上的虚拟机需连外网，设置虚拟机地址与服务器再同一网段并使用同一网关，如虚拟机的地址为192.168.1.200/24，网关为192.168.1.1，并配置虚拟机DNS地址为8.8.8.8即可。

(1)     在UOS操作系统桌面桌面空白处单击右键，选择[在终端打开]菜单项，输入sudo cat /userdata/H3C/cfg/ip.cfg命令，并输入当前登录用户的密码，即可查看当前Agent中配置的管理平台地址信息。

(2)     输入sudo vim /userdata/H3C/cfg/ip.cfg命令可编辑地址信息，修改完成后输入:wq并回车，保存修改并退出。

(3)     参照步骤（1）和步骤（2），完成/etc/vdagent/ip.cfg文件中管理平台地址信息的修改。

对于UOS1041和UOS1042版本，需要安装libdde-file-manager_5.2.56-1_amd64.deb、

dde-file-manager_5.2.56-1_arm64.deb两个补丁，才能正常使用磁盘映射功能，请联系技术支持工程师获取补丁安装包，补丁安装方法如下：

(1)     打开补丁安装包存放目录，单击右键，选择[在终端打开]菜单项，打开终端命令窗口，输入以下命令：

sudo dpkg –i libdde-file-manager_5.2.56-1_amd64.deb

sudo dpkg –i dde-file-manager_5.2.56-1_amd64.deb

(2)     安装完成后，重启虚拟机，磁盘映射即可正常工作。

如使用UOS 1042版本系统镜像，需修改/etc/pam.d/common-auth文件，否则会出现域账号密码无法校验的问题。具体修改方式如下：

(1)     打开终端命令窗口，输入以下命令：

/etc/pam.d/common-auth – authentication settings common to all service

(2)     将以下内容：

auth [success=2 auth_err=done new_authtok_reqd=ok ignore=ignore default=die] pam_deepin_authentication.so user_locale=.config/locale.conf timeout=-1

auth [success=1 default=ignore] pam_unix.so nullok_secure try_first_pass

修改为：

auth [success=2 default=ignore]    pam_unix.so nullok_secure try_first_pass

auth [success=1 default=ignore]    pam_sss.so use_first_pass

如下图所示：

图6-2 修改前

图6-3 修改后