部署HyperFlex远程插件 — 部署指南

已更新: 2024 年 2 月 9 日

文档 ID:221660

非歧视性语言

此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。深入了解思科如何使用包容性语言。

关于此翻译

思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言，希望全球的用户都能通过各自的语言得到支持性的内容。请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任，并建议您总是参考英文原始文档（已提供链接）。

简介

本文档介绍如何部署思科HyperFlex远程插件设备。

前提条件

要求

思科建议您了解以下主题：

HyperFlex
vCenter
网络
DNS

使用的组件

本文档中的信息基于以下软件和硬件版本：

HyperFlex Connect 5.0.2d
Hyperflex标准集群
VMware vCenter，8.0.2.00100
VMware ESXi、7.0.3、21930508
思科HyperFlex远程插件设备3.0.0.1173
WinSCP 6.1.1(内部版13736)

本文档中执行的过程是从特定实验环境中的设备创建的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

vSphere客户端远程vCenter插件架构旨在将插件功能集成到vSphere客户端，而无需在vCenter Server中运行。这提供了插件隔离，并允许在大型vSphere环境中运行的插件进行扩展。

本地插件和远程插件之间的主要区别在于，本地插件将所有文件存储在vCenter本身上，而远程插件将文件存储在设备中。

从vSphere 8.0.0开始，vSphere版本支持的唯一架构是远程插件。

表 1.思科Hyperflex远程插件设备兼容性列表

vCenter插件版本	Cisco Hyperflex版本	ESXi版本	vCenter版本
3.0.0 及更高版本	4.0(2f)及更高版本	6.7 u3及更高版本	7.0及更高版本

部署是基于OVA的安装，带有Cisco Secured Linux映像。

Cisco Hyperflex远程插件可通过两种方式完成。

通过vCenter进行部署。
直接在独立ESXi主机上部署。

注意：推荐的部署方法是通过vCenter

部署后，设备的配置如表2和表3所述。

表 2.VM硬件配置

CPU	1 个 vCPU
内存	8 GB
硬盘1	48.83 GB
网络适配器	1

表 3.VM软件配置

访客操作系统	Ubuntu Linux 20.04.6 LTS思科安全Linux
兼容性	ESXi 6.7 U2虚拟机
VMware工具	open-vm-tools 11.3.0.29534(build-18090558)

步骤

步骤1:从思科软件下载站点下载适用于VMware vCenter的Cisco HyperFlex HTML插件OVA。

为此，请导航Downloads Home > Hyperconverged Infrastructure > Hyperflex HX Data Platform > Hyperflex Remote vCenter Plugin - 3.0.0。

Cisco Downloads Website 思科下载网站

第二步：登录到vCenter，然后选择要部署远程插件设备的主机。右键点击主机，然后点击部署OVF模板(Deploy OVF Template)

Deploy OVF Template 部署OVF模板

第三步：选择Local file选项并上传HTML5-remote-plugin-Appliance-3.0.0-1173.ova文件，然后单击Next。

Select an OVF template 选择OVF模板

第四步：选择虚拟机的名称，选择虚拟机的位置，单击下一步。

Select VM name and folder 选择VM名称和文件夹

第五步：为部署选择服务器（ESXi主机），单击下一步。

Select Server 选择服务器

第六步：在Review details（查看详细信息）部分中，您会看到以下警告：

OVF包包含高级配置选项，这会带来潜在的安全风险。查看高级配置选项。单击“下一步”接受高级配置选项。
证书不受信任。

您可以放心地忽略这些警告，单击Ignore，然后单击Next

Review Details 检查详细信息

步骤 7.选择Datastore并选择磁盘格式（精简或密集调配），点击下一步

Select Datastore 选择Datastore

步骤 8选择VM网络接口的端口组，点击下一步

Select networks 选择网络

步骤 9在完成向导之前检查您的选择，然后单击完成。

Review your selections 查看您的选择

步骤 10观看“vCenter最近任务”选项卡中的进度

vCenter Recent Tasks vCenter近期任务

步骤 11打开Hypeflex远程插件虚拟设备电源。在初始启动过程出现登录提示后，请使用这些凭证登录。

默认用户名：vcp-admin
默认密码：C^scohxplugin@1984

注：不支持创建其他用户或使用根用户。

注意：要访问Web GUI，您需要更改默认密码。否则，您将收到以下错误消息：

出于安全原因，禁用使用出厂默认密码登录。请通过ssh登录/控制台更改出厂默认密码，然后尝试使用新密码登录。

Console Login screen 控制台登录屏幕

配置管理IP地址

默认情况下，设备从分配了vnic的Portgroup/VLAN中可用的DHCP服务器获取IP地址。

登录设备后，您可以找到分配的IPv4地址。

Current IP Address 当前IP地址

建议为虚拟设备配置静态IP地址。为此，请使用hx-ip-address-change命令并按照配置向导操作。

Change IP Address 更改IP地址

使用ifconfig命令验证配置的IP地址。

Verify IP Address 检验IP地址

更改密码

您可以使用passwd vcp-admin命令更改用户vpc-admin的当前密码，该命令提供当前密码和新密码。

Change Password 更改密码

注册vCenter

vCenter在Cisco Hyperflex远程插件设备中的注册是基于UI的。

注意：具有活动防火墙的用户需要验证端口433、9443和22是否处于打开状态以及是否允许流量在vCenter和远程插件设备之间传入或传出。

步骤1:在浏览器中输入IP(https://ip)以打开插件服务器管理UI。使用vcp-admin用户和当前的新密码登录。

Hyperflex Remote vCenter Plug-in Appliance Login screen Hyperflex远程vCenter插件设备登录屏幕

提示：要验证当前应用版本和支持vCenter版本，请在成功登录后，单击屏幕右上角的Gear。

步骤2..登录后，单击主控制面板上的REGISTER按钮。

Main Dashboard 主控制面板

第三步：单击REGISTER按钮以添加要在其中部署远程插件的vCenter信息。为IP地址、端口（默认为443）和vCenter用户名提供执行部署的足够权限。单击“下一步”

Add vCenters 添加vCenter

第四步：如果系统能够使用所提供的信息访问vCenter，则执行连接测试并显示在线状态。要继续注册，请单击绿色REGISTER按钮

Add vCenter Summary 添加vCenter摘要

第五步：确认已配置的vCenter在“已注册vCenter”列表中。

注意：如果您希望更新当前安装在该vCenter上的已安装插件版本或取消注册vCenter，请单击已注册vCenter左侧的三个点菜单。

Registered vCenters 已注册的vCenter

第六步：在vCenter中验证插件已成功部署。两个任务可见并标记为已完成。“下载插件”和“部署插件”。

Verify Deployment tasks in vCenter 验证vCenter中的部署任务

步骤 7.验证插件是否已在vCenter管理客户端插件选项卡下注册。您可以看到，插件的类型为“远程”，已成功部署。

Verify plug-in is installed 验证插件是否已安装

步骤8..要在vSphere UI中查看Cisco HyperFlex HTML5插件选项，请注销并重新登录到vCenter。再次登录后，请右键点击Hyperflex集群底部以查找Cisco Hyperflex插件

Verify plug-in availability 验证插件可用性

步骤 9验证插件是否已发现集群。在vCenter中，单击Hamburguer菜单，然后单击Cisco Hyperflex插件

Accessing Plug-in 访问插件

步骤 10在Cisco Hyperflex plugin部分中，您可以找到插件检测到的当前Hyperflex集群，如果您的集群不在列表中，请单击Rescan。

List of discovered Hyperflex clusters 已发现的Hyperflex群集列表

注意:Remote和Local插件的配置和功能相同。有关任何功能的详细信息，请参阅Cisco HyperFlex数据平台管理指南5.5版的VMware vCenter的Cisco HyperFlex HTML5插件部分，相关信息部分提供了链接。

故障排除

不支持的硬件系列

如果您尝试在较低版本（如ESXi 6.5）上安装，则在执行的最后一步中会出现以下错误：

第26行：不支持的硬件系列“vmx-15”

Unsupported hardware error 不支持的硬件错误

这是因为虚拟机使用的虚拟硬件版本，需要在ESXi 6.7 U2或更高版本上部署。

请注意，硬件版本15虚拟机不能在ESXi的早期版本（包括ESXi 6.7u1、ESXi 6.7、ESXi 6.0等）上被虚拟移动至主机，因为这些先前的ESXi版本与新硬件版本不兼容。同样，只要硬件版本15虚拟机未使用，vCenter 6.7或vCenter 6.7u1就可以用于管理ESXi 6.7u2主机。对于希望创建、运行和管理硬件版本15虚拟机的客户，群集和vCenter中的ESXi主机都需要升级到至少6.7u2。

有关其他详细信息，请参阅VMware文章：虚拟机硬件版本(KB 1003746)

缺少所需的磁盘映像

如果您尝试使用OVA文件直接部署到ESXi 6.7 U2或更高版本的主机，则在开始部署之前的最后一步中，您将收到以下警告“所需磁盘映像丢失”。

A required disk image was missing error 所需的磁盘映像丢失错误

要缓解此警告，需要解压缩OVA文件“HTML5-remote-plugin-Appliance-3.0.0-1173.ova”，为此，您可以使用您选择的解压缩程序，如7zip。

在解压的文件夹内，您可以找到以下文件列表：

HTML5-remote-plugin-Appliance-3.0.0-173.cert
HTML5-remote-plugin-Appliance-3.0.0-1173.mf
HTML5-remote-plugin-Appliance-3.0.0-1173.ovf
HTML5-remote-plugin-Appliance-3.0.0-1173-disk1.vmdk
HTML5-remote-plugin-Appliance-3.0.0-1173-file1.nvram

部署所需的文件包括：

HTML5-remote-plugin-Appliance-3.0.0-1173.ovf
HTML5-remote-plugin-Appliance-3.0.0-1173-disk1.vmdk
HTML5-remote-plugin-Appliance-3.0.0-1173-file1.nvram

Providing required files 提供所需的文件

一旦您提供了这三个文件，警告就消失了

Ready to complete 准备完成

vCenter集成

步骤1:验证允许向FQDN的TCP端口443（要求已在设备上配置DNS）或vCenter IP地址进行通信，如果通信失败，可在“主机状态”(Host Status)列中看到此情况。

第二步：验证vCenter版本是7.0或更高版本。如果您尝试使用不兼容的版本进行注册，则注册状态中会出现“失败”消息。将鼠标悬停在红色框上较短时间，即会显示错误消息的说明。在此映像中，由于版本不兼容，将VM Remote插件与Vcenter集成时，可以看到失败消息示例

vCenter版本不兼容

其他帮助

如果您需要有关实施或集成的其他支持，必须联系思科TAC并附加必要的日志文件。

支持捆绑包生成

只有在思科Hyperflex远程插件虚拟设备中注册了至少一个vCenter时，才能生成支持捆绑包。

目前，支持捆绑包生成是通过命令行进行的。您需要登录设备的控制台（或使用SSH）并运行命令hx-plugin-supportbundle，默认情况下，支持捆绑包保存在/var/log/plugin_support/ 目录中。

用户可以指定vCenter FQDN或IP地址以继续生成支持捆绑包。

注意：生成支持捆绑包需要来自所选vCenter的根用户凭证。

步骤1:通过SSH连接到HyperFlex远程插件虚拟设备，登录并运行命令hx-plugin-supportbundle，这会生成包含vCenter日志和Hyperflex远程插件设备日志的tar文件

Support Bundle Generation 支持捆绑包生成

第二步：建立到VM远程插件的SCP连接，为此，您可以使用WinSCP等软件

文件协议：SCP
主机名：[[ip.address.remotepluginappliance]
端口号：22
用户名：vcp-admin
密码：[your-configured-password]

SCP Connection parameters SCP连接参数

第三步：导航到/var/log/plugin_support/目录并下载支持捆绑文件。

支持捆绑包位置

从Cisco HyperFlex远程插件设备手动收集日志

如果无法在设备中注册任何vCenter，则无法生成支持捆绑包。需要手动收集日志文件。

步骤1:建立到VM远程插件的SCP连接，为此，您可以使用WinSCP等软件

文件协议：SCP
主机名：[ip.address.remotepluginappliance]
端口号：22
用户名：vcp-admin
密码：[your-configured-password]

第二步：登录后，您会自动找到自己所在的路径/home/vcp-admin，转至根目录，然后转至指定的路径以收集这些日志文件：

/var/log/auth.log
/var/log/audit/audit.log
/var/log/cisco/hx-plugin.log
/var/log/cisco/hx-plugin-install.log
/var/log/cisco/plugin-config.log
/var/log/cisco/plugin-server.log

Cisco logs location 思科日志位置

第三步：将日志文件上传到您的当前服务请求。将文件上传到案例的步骤在“相关信息”部分的“客户文件上传到思科技术支持中心”链接中。