H3C服务器hREST 命令行工具使用 Python 语言开发，主要基于 HTTPs 协议和 Redfish、RESTful 和 IPMI 接口协议，是一款便于用户管理服务器的客户端工具。用户可通过本工具的查询、设置等命令对服务器进行管理。
hREST 1.23 工具下载地址：
http://www.h3c.com/cn/BizPortal/DownLoadAccessory/DownLoadAccessoryFilt.aspx
1.1 使用介绍
1.1.1 命令行工具
本工具将 Python 运行基础包、Redfish 源码以及程序运行所依赖外部包，放于同一个工程目录下，
软件执行时可直接调用，可以做到免安装且无需环境配置。当前 hREST工具支持 Windows和 Linux
操作系统，无特殊说明情况下，统一为 64 位。
执行步骤如下：
（1） 工程文件 hREST_Linux_Vx.xx.tar.gz（Windows 版本对应 hREST_Windows_Vx.xx.zip）
包拷贝至系统目录下；
（2） 解压并进入工程目录 hREST_Linux_Vx.xx 或 hREST_Windows_Vx.xx；
（3） 进入 bin 文件夹；
（4） 输入命令 ：./hREST –H ****** -U ****** -P ****** subcommand （Windows 环境对应命令：
hREST –H ****** -U ****** -P ****** subcommand）；
（5） 回车执行命令。
带内驱动安装：
（1） 将与系统相匹配的带内驱动包（hdmdrv.ko）拷贝至系统下；
（2） 使用 insmod hdmdrv.ko 安装驱动；
（3） 驱动安装完成后，可通过 lsmod | grep hdmdrv 查看驱动是否安装成功；
（4） 也可通过 rmmod hdmdrv.ko 卸载驱动。
1.1.2 版本支持
1. HDM 版本要求
推荐 HDM-1.30.15 及其以上版本。部分功能对 HDM 版本有特殊要求，可查看使用指南中的命令说
明。hREST 仅支持通用版本 HDM，如有特别需求，发布大客户版本解决。
2. 操作系统
支持的 Windows 系统包括：
· Windows Server 2012 R2
· Windows 7
· Windows 10
支持的 Linux 系统包括：
· CentOS 6.2
· CentOS 7.3
其他操作系统或版本不保证工具可用，以实际为准。
1.2 命令通用说明
hREST 命令的通用格式为：
带外模式
hREST -H host -p port -U username -P password <command>。
hREST 命令参数区分大小写。
在执行 hREST 命令时，需要指定以下参数，此处统一说明。
· -H host：指定被管理设备的 HDM IP 地址。
· -p port：指定 HTTPS 协议端口号，默认为“443”，为可选参数。
· -U username -P password：指定被管理设备的 HDM 用户名及其密码。如无特别说明，建议
用户全部为 Administrator 权限，避免因权限不足导致的操作失败。
· <command>：关于<command>参数的说明，下文将详细介绍。
· 注意在命令行中应避免使用与操作系统相关的特殊字符组合，如无法避免建议命令使用“”（双
引号）或者‘’（单引号）包含。
前面的内容摘自用户手册，下面开始服务器安装系统；步骤大致为：创建系统盘raid1、挂载nfs远程镜像、设置系统临时启动项为CDROM、重启安装系统、取消远程挂载。
准备到服务器带外地址可以通的linux或者Windows，制作linux自动安装镜像放置nfs服务器。
步骤如下，命令详细用法参考hREST用户手册V1.23.pdf
一、创建系统raid1
./hREST_Linux_1.23/bin/hREST -H 10.144.240.203 -U admin -P Password@_ addldisk -CI 0 -N OS-raid1 -OV 256 -M No -VL RAID1 -CNI [9:0_8:0] -SN 1 -RP ReadAhead -WP WriteBack -IP Direct -DCP Disabled -AP ReadWrite
二、挂载nfs远程镜像
[root@Cobbler-PRD opsuser]# ./hREST_Linux_1.23/bin/hREST -H 10.144.240.203 -U admin -P Password@_ mountvmm -O Mount -I nfs://10.142.22.254/home/nfs/AutoInstall-CentOS-7.9-x86_64.iso -T CD
Success: successfully mount virtual media
[root@Cobbler-PRD opsuser]# ./hREST_Linux_1.23/bin/hREST -H 10.144.240.203 -U admin -P Password@_ getvmm -T CD
--------------------------------------------------
[Connectd]
MediaIndex : 0
ImageName : AutoInstall-CentOS-7.9-x86_64.iso
MediaTypes : CD/DVD
----------------------------------------------
[NotConnectd]
ID : 1
ImageName : ctyunos-2.0.1-220311-x86_64-dvd.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 2
ImageName : SW_DVD9_Win_Server_STD_CORE_2016_64Bit_ChnSimp_-4_DC_STD_MLF_X21-70525.ISO
MediaTypes : CD/DVD
----------------------------------------------
ID : 3
ImageName : win2016raiddriver.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 4
ImageName : AutoInstall-Ubuntu-20.04.3-amd64.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 5
ImageName : AutoInstall-Ubuntu-20.04.4-amd64.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 6
ImageName : AutoInstall-Ubuntu-20.04.6-amd64.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 7
ImageName : AutoInstall-Ubuntu-22.04.2-amd64.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 8
ImageName : cn_windows_10_enterprise_ltsc_2019_x64_dvd_9c09ff24.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 9
ImageName : ubuntu-boot2install-2004-cloudos-202305290603.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 10
ImageName : AutoInstall-CentOS-7.4-x86_64.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 11
ImageName : AutoInstall-CentOS-7.6-x86_64.iso
MediaTypes : CD/DVD
----------------------------------------------
ID : 12
ImageName : ubuntu-boot2install-2004-cloudos-202306171806.iso
MediaTypes : CD/DVD
----------------------------------------------
--------------------------------------------------
三、设置系统临时启动项为CDROM
查看系统启动模式
[root@Cobbler-PRD opsuser]# ./hREST_Linux_1.23/bin/hREST -H 10.144.240.203 -U admin -P Password@_ getsysboot
--------------------------------------------------
BootSourceOverrideTarget : Hdd
BootSourceOverrideEnabled : Continuous
BootSourceOverrideMode : Legacy
--------------------------------------------------
[root@Cobbler-PRD opsuser]# ./hREST_Linux_1.23/bin/hREST -H 10.144.240.203 -U admin -P Password@_ setsysboot -D CD -E Once -M Legacy
Success: set system startup item successfully
[root@Cobbler-PRD opsuser]# ./hREST_Linux_1.23/bin/hREST -H 10.144.240.203 -U admin -P Password@_ getsysboot
--------------------------------------------------
BootSourceOverrideTarget : Cd
BootSourceOverrideEnabled : Once
BootSourceOverrideMode : Legacy
--------------------------------------------------
[root@Cobbler-PRD opsuser]#
四、重启安装系统
[root@Cobbler-PRD opsuser]# ./hREST_Linux_1.23/bin/hREST -H 10.144.240.203 -U admin -P Password@_ syspowerctrl -T ForceReset
Success: power control request succeeded: ForceReset
五、取消远程挂载
[root@Cobbler-PRD opsuser]# ./hREST_Linux_1.23/bin/hREST -H 10.144.240.203 -U admin -P Password@_ mountvmm -O Unmount
Success: successfully unmount virtual media
在HDM远程挂载界面手动“结束”已弹出的镜像，命令无法结束