目  录

1 hrest工具简介·· 1

1.1 使用介绍·· 1

1.1.1 命令行工具·· 1

1.1.2 版本支持·· 1

1.2 命令通用说明·· 1

2 hrest命令列表·· 3

2.1 获取帮助命令·· 3

2.2 获取CPU信息·· 5

2.3 获取内存信息·· 6

2.4 获取物理盘信息·· 8

2.5 设置物理盘·· 9

2.6 获取逻辑盘信息·· 10

2.7 创建逻辑盘·· 11

2.8 删除逻辑盘·· 13

2.9 获取RAID卡信息·· 14

2.10 获取存储信息·· 15

2.11 获取事件日志·· 17

2.12 删除事件日志·· 19

2.13 查询网口信息·· 19

2.14 设置网口IPv4地址·· 22

2.15 设置网口IPv6地址·· 22

2.16 获取网口VLAN信息·· 23

2.17 设置网口VLAN· 24

2.18 查询网口模式·· 24

2.19 设置HDM网口模式·· 25

2.20 获取网卡信息·· 25

2.21 获取IP登录规则信息·· 27

2.22 设置IP登录规则·· 28

2.23 获取NVMe SSD信息·· 29

2.24 获取功率封顶信息·· 30

2.25 设置功率封顶·· 30

2.26 获取电源信息·· 31

2.27 切换主备电源·· 32

2.28 控制系统上下电·· 33

2.29 获取设备信息·· 33

2.30 设置资产标签·· 35

2.31 获取角色信息·· 36

2.32 获取启动信息·· 37

2.33 获取健康状态·· 37

2.34 获取操作日志·· 38

2.35 获取系统时间·· 40

2.36 设置系统时区·· 40

2.37 获取系统温度·· 41

2.38 获取用户信息·· 42

2.39 添加用户·· 44

2.40 修改用户信息·· 45

2.41 删除用户·· 46

2.42 获取BIOS信息·· 47

2.43 设置BIOS选项·· 47

2.44 重置BIOS选项·· 48

2.45 获取风扇信息·· 48

2.46 设置风扇转速·· 50

2.47 设置关闭带内设置用户·· 51

2.48 导出配置·· 51

2.49 导入配置·· 52

2.50 获取固件版本信息·· 52

2.51 获取NTP信息·· 53

2.52 设置NTP信息·· 54

2.53 获取SNMP信息·· 55

2.54 设置SNMP信息·· 57

2.55 获取服务配置信息·· 59

2.56 设置服务配置信息·· 60

2.57 下载SDS日志·· 61

2.58 获取虚拟媒体信息·· 62

2.59 升级固件·· 63

2.60 获取PCIe设备列表·· 64

2.61 获取KVM截图·· 65

2.62 设置LDAP· 66

2.63 新增或修改LDAP用户·· 67

2.64 删除LDAP用户·· 69

2.65 设置AD（Active Directory）·· 69

2.66 新增或修改AD（Active Directory）用户·· 70

2.67 删除AD（Active Directory）用户·· 71

2.68 获取GPU信息·· 72

2.69 获取VNC会话信息·· 73

2.70 获取防火墙状态信息·· 74

2.71 设置防火墙状态·· 74

1 hrest工具简介

hrest命令行工具使用Python语言开发，主要基于HTTPs协议和Redfish（RESTful和IPMI）接口协议，是一款便于用户管理服务器的客户端工具。用户可通过本工具的查询、设置等命令对服务器进行管理。

1.1  使用介绍

1.1.1  命令行工具

本工具将Python运行基础包、Redfish源码以及程序运行所依赖外部包，放于同一个工程目录下，软件执行时可直接调用，可以做到免安装且无需环境配置。当前hrest工具支持Windows和Linux操作系统，涉及到操作系统，无特殊说明情况下，统一为64位。

执行步骤如下：

（1）    工程文件hrest_linux.tar.gz（Windows版本对应hrest_windows.zip）包拷贝至系统下；

（2）    解包文件并进去工程目录hREST_linux或hREST_windows；

（3）    进入bin 文件夹；

（4）    输入命令 ：./hrest –H ******  -U ****** -P ****** subcommand （Windows环境对应命令：hrest –H ******  -U ****** -P ****** subcommand）；

（5）    回车执行命令。

1.1.2  版本支持

1. HDM版本要求

推荐HDM-1.30.15及其以后版本。涉及部分功能对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命令参数区分大小写。由于操作系统特性，在Linux系统通常格式为：

./hrest -H host -p port -U username -P password <command>

在执行hrest命令时，需要指定以下参数，此处统一说明。

·              -H host：指定被管理设备的HDM IP地址。

·              -p port：指定HTTPS协议端口号，默认为“443”，为可选参数。

·              -U username -P password：指定被管理设备的HDM用户名及其密码。

·              <command>：关于<command>参数的说明，下文将详细介绍。

2 hrest命令列表

2.1  获取帮助命令

本命令用于获取工具帮助信息。

【命令】

hrest -h/--help

【参数】                                        

表2-1 参数说明

【举例】

# 获取工具帮助信息

-> hrest –h

usage: hREST [-h] [-V] -H HOST [-p PORT] -U USERNAME -P PASSWORD

             sub command ...

optional arguments:

  -h, --help        show this help message and exit

  -V, --version     show program's version number and exit

  -H HOST           domain name, IPv4 address,or [IPv6 address]

  -p PORT           port

  -U USERNAME       local or LDAP username

  -P PASSWORD       password

sub commands:

  sub command       sub-command help

    addaduser       add ad user.

    addldapuser     add ldap user.

    addldisk        create logical disk.

    adduser         add user.

    delelog         delete event log.

    closeinner      close inner user setting.

    getsdslog       get sds log.

    deladuser       delete ad user.

    delldapuser     delete ldap user.

    delldisk        delete logical disk.

    deluser         delete user by username.

    downloadconfig  download configuration.

    fwupdate        fwupdate command.

    getbios         get BIOS information.

    getcpu          get CPUs information.

    getelog         get event log.

    getfan          get fan information.

    getfwv          get firmware version.

    gethdmlog       get hdm log.

    getsyshealth    get system health state.

    getip           get ip information.

    getvlan         get vlan information.

    getldisk        get logical drive information.

    getloginruleip  get ip login rule.

    getmemory       get memory information.

    getnetmode      get net mode.

    getmac          get mac information.

    getntp          get ntp information.

    getnvmessd      get nvme ssd information.

    getpcie         get pcie information.

    getpdisk        get physical disk information.

    getpowerlimit   get power limit.

    getproductinfo  get product information.

    getpsu          get power information.

    getraid         get raid information.

    getrole         get role information.

    getscreencapture

                    get virtual media information.

    getsensor       get sensors information.

    getservice      get service information.

    getsnmp         get snmp information.

    getstorage      get storage information.

    getsysboot      get system boot information.

    gettemp         get temperature information.

    gettime         get system time.

    getuser         get user information.

    getvmm          get virtual media information.

    setbiosdefault  set bios default.

    setbmcdefault   set bmc default.

    setad           set ad(Active Directory).

    setbios         set bios parameter.

    setfan          set fan speed.

    setipv4         set IPv4 information of the BMC network port.

    setipv6         set IPv6 information of the BMC network port.

    setvlan         set VLAN information.

    setldap         set ldap.

    setloginruleip  add ip login rule.

    setnetmode      set net mode.

    setntp          set ntp information.

    setpdisk        set physical disk information.

    setpowerlimit   set power limit.

    setpmb          set power main/backup.

    setproductinfo  set product information.

    setservice      set service configuration.

    setsnmp         set snmp information.

    settimezone     time zone. for example, UTC+9 and UTC-3.

    setuser         set user.

    uploadconfig    download configuration.

2.2  获取CPU信息

本命令用于获取服务器CPU信息。

【命令】

hrest -H host -p port -U username -P password getcpu -CI cpu_id

【参数】

表2-2 参数说明

【举例】

# 获取CPU详细信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getcpu –CI 2

--------------------------------------------------

Id                                      : 2

Name                                    : CPU2

FrequencyMHz                            : 3200

L1CacheKiB                              : 768

L2CacheKiB                              : 12288

L3CacheKiB                              : 12288

Temperature                             : 62

ProcessorType                           : CPU

ProcessorArchitecture                   : x86

InstructionSet                          : x86-64

Manufacturer                            : Intel(R) Corporation

Model                                   : Intel(R) Xeon(R) Gold 6146 CPU @ 3.20GHz

MaxSpeedMHz                             : 255

TotalCores                              : 12

TotalThreads                            : 24

Socket                                  : 2

[Status]

Health                                  : OK

State                                   : Enabled

[ProcessorId]

IdentificationRegisters                 : BF-EB-FB-FF-00-05-06-54

--------------------------------------------------

【输出说明】

表2-3 输出说明

2.3  获取内存信息

本命令用于获取服务器内存信息。

【命令】

hrest -H host -p port -U username -P password getmemory -MI memory_id

【参数】

表2-4 参数说明

【举例】

# 获取槽位为A4的内存详细信息

-> hrest –H 192.168.10.6 –U ****** -P ****** getmemory –MI A4

--------------------------------------------------

CommonName                              : CPU1A4

CapacityMiB                             : 8192

Manufacturer                            : Hynix Semiconductor

OperatingSpeedMhz                       : 2666

MemoryDeviceType                        : DDR4

RankCount                               : SR DIMM

PartNumber                              : HMA81GR7AFR8N-VK

[MemoryLocation]

Position                                : CPU1

Channel                                 : 4

Slot                                    : A4

[Status]

State                                   : Enabled

Health                                  : OK

--------------------------------------------------

【输出说明】

表2-5 输出说明

2.4  获取物理盘信息

本命令用于获取服务器物理盘信息。

【命令】

hrest -H host -p port -U username -P password getpdisk -PI physical_id

【参数】

表2-6 参数说明

【举例】

# 获取物理盘详细信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getpdisk –PI 0

--------------------------------------------------

Panel                                   : Front

Slot_phys_no                            : 11

Slot                                    : Front 11

Connection id                           : 0

Drive number in BIOS                    : 3

Drive number in OS                      : 3

Status                                  : Ready

Model                                   : ATA INTEL SSDSC2BB12

Firmware version                        : 0140

Serial number                           : PHWA606300D5120CGN 

Property                                : 6 Gbps SATA SSD

Capacity                                : 0.11TiB

ControllerID                            : 0

--------------------------------------------------

【输出说明】

表2-7 输出说明

2.5  设置物理盘

本命令用于设置物理盘状态。

【命令】

hrest -H host -p port -U username -P password setpdisk -CI controller_id –PI physical_id -S status

【参数】

表2-8 参数说明

【使用指南】

本命令仅可设置未组建逻辑盘且连接正常的物理盘。

【举例】

# 设置控制卡ID为0，connection ID为22的物理盘，状态为Disable

-> hrest –H 192.168.10.6 –U ****** -P ****** setpdisk -CI 0 -PI 22 -S Disable

Success: set physical drive successfully

2.6  获取逻辑盘信息

本命令用于获取服务器逻辑盘信息。

【命令】

hrest -H host -p port -U username -P password getldisk -CI controller_id –LI logical_id

【参数】

表2-9 参数说明

【举例】

# 获取控制卡ID为0，逻辑盘id为3的逻辑盘信息

-> hrest –H 192.168.10.6 –U ****** -P ****** getldisk –CI 0 –LI 0

--------------------------------------------------

RaidControllerID                        : 0

Logical Drive Id                        : 3

LogicDiskName                           :

CapacityGiB                             : 400

RaidLevel                               : RAID 0

OptimumIOSizeBytes                      : 65536

DriveCache                              : Unchanged

CurrentReadPolicy                       : No Read Ahead

CurrentWritePolicy                      : Write Through

CurrentIOPolicy                         : Direct

BootEnable                              : True

Drives                                  : 1, 2

Health                                  : OK

--------------------------------------------------

【输出说明】

表2-10 输出说明

【修改记录】

(1) HDM-1.11.27及以前版本路径为https://device_ip/redfish/v1/Systems/system_id/Storage/RAIDStorage0/Volumes/logical_id

(2) HDM-1.11.29增加字段BootDrive

(3) HDM-1.11.31 字段BootDrive修改成BootEnable，DiskCachePolicy 修改成DriveCache

(4) HDM-1.30.06 增加字段NumDrivePerSpan, SpanNumber

(5) HDM-1.30.09 修改字段BootEnable为布尔型，增加字段Oem.Public.OptimumIOSizeBytes

(6) HDM-1.30.10增加字段Oem.Public.AccelerationMethod

(7) HDM-1.30.11字段OptimumIOSizeBytes返回值类型从字符串修改成数值

2.7  创建逻辑盘

本命令用于创建逻辑盘。

【命令】

hrest -H host -p port -U username -P password addldisk -CI controlerid -N volumename –OV optsizebytes –M initmode –VL volumeraidlevel –CNI drivesid –SN spannumber –RP readpolicy –WP writepolicy –IP iopolicy –DCP cachepolicy –AP accesspolicy –V capacity –SU sizeunit –AM acceleration_method

【用户权限】

admin

【参数】

表2-11 参数说明

【使用指南】

对于HDM带外配置功能不支持的RAID卡，此功能无法使用。

【举例】

# 添加逻辑盘。控制卡iD为0，逻辑盘名称为dragon，条带大小为64，初始化类型为No，RAID级别为1，两块物理盘，connection id分别为26,23，逻辑组id为0，每个SPAN的成员盘数为2，写策略为WriteThrough，IO策略为Cached，物理盘缓存策略为Enable，访问策略为只读，大小为600，单位为GB，加速策略为None

-> hrest –H 192.168.10.6 –U ****** -P ****** addldisk -CI 0 -N dragon -OV 64 -M No -VL RAID1 -CNI [26:0_23:0] -SN 1 -RP NoReadAhead -WP WriteThrough  -IP Cached -DCP Enabled  -AP ReadOnly -V 600  -SU GB -AM 1

Success: add logical drive successfully

2.8  删除逻辑盘

本命令用于删除逻辑盘。

【命令】

hrest -H host -p port -U username -P password delldisk –CI controllerid –LI logicalid

【参数】

表2-12 参数说明

【使用指南】

无

【举例】

# 删除控制卡ID为0，逻辑盘ID为3的逻辑盘

-> hrest –H 192.168.10.6 –U ****** -P ****** delldisk -CI 0 -LI 3

Success: delete logical driver successfully

2.9  获取RAID卡信息

本命令用于获取RAID卡信息。

【命令】

hrest -H host -p port -U username -P password getraid –CI controlerid

【参数】

无

【使用指南】

无

【举例】

# 获取RAID卡信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getraid –CI 0

--------------------------------------------------

CommonName                              : RAIDStorage0

SerialNumber                            : SP73513465

State                                   : Enabled

Health                                  : OK

Controller

    Id                                  : 0

    Manufacturer                        : LSI

    Model                               : HBA-LSI-9440-8i

    SupportedDeviceProtocols            : ['SAS']

    SASAddress                          : null

    FirmwareVersion                     : 5.010.01-0671

    PackageVersion                      : None

    JBODState                           : Disabled

    MemorySizeMiB                       : null

    SupportedRAIDLevels                 : RAID0, RAID1, RAID5, RAID10, RAID50

    ----------------------------------------------

--------------------------------------------------

【输出说明】

图2-1 输出说明

2.10  获取存储信息

本命令用于获取存储信息。

【命令】

hrest -H host -p port -U username -P password getstorage –CI controlerid

【参数】

表2-13 参数说明

【举例】

# 获取存储信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getstorage –CI 0

--------------------------------------------------

Ctrl_id                                 : 0

Raid card model                         : HBA-LSI-9440-8i

Firmware version                        : 5.010.01-0671

Serial number                           : SP73513465

DDR size                                :

Flash                                   :

Supercapacitor                          :

Charging status                         :

Support RAID Level                      : 0/1/5/10/50

Volumes

    Id                                  : 3

    Status                              : Optimal

    Level                               : RAID 0

    Capacity                            : 400GiB

    Element                             : 2

    Drives                              : 1,2

    ----------------------------------------------

    Id                                  : 1

    Status                              : Optimal

    Level                               : RAID 0

    Capacity                            : 223.060GiB

    Element                             : 1

    Drives                              : 0

    ----------------------------------------------

    Id                                  : 2

    Status                              : Optimal

    Level                               : RAID 0

    Capacity                            : 500GiB

    Element                             : 1

    Drives                              : 4

    ----------------------------------------------

    Id                                  : 0

    Status                              : Optimal

    Level                               : RAID 1

    Capacity                            : 600GiB

    Element                             : 2

    Drives                              : 5,7

    ----------------------------------------------

Drives                                  : 0, 1, 2, 3, 4, 5, 6, 7

--------------------------------------------------

【输出说明】

表2-14 输出说明

2.11  获取事件日志

本命令用于获取事件日志信息。

【命令】

hrest -H host -p port -U username -P password getelog -C count

【参数】

表2-15 参数说明

【举例】

# 获取事件日志信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getelog –C 1

--------------------------------------------------

Id                                      : 1

Record type                             : system_event_record

Time                                    : 2020-07-04 02:37:27

System software type                    : system_management_software

Generator type                          : ipmb_slave_address

Channel number                          : 0

Ipmb lun                                : 0

Event format ipmi version               : 4

Sensor type                             : Microcontroller / Coprocessor

Type number                             : 22

Sensor number                           : 255

Sensor name                             : Microcontroller

Event direction                         : asserted

Event reading class                     : discrete

Sensor reading value                    : 0

Triggered value                         : 0

Sensor reading value type               : unspecified

Triggered type                          : unspecified

Event description                       : BMC reset

Level                                   : 1

--------------------------------------------------

【输出说明】

表2-16 输出说明

2.12  删除事件日志

本命令用于删除事件日志信息。

【命令】

hrest -H host -p port -U username -P password delelog

【举例】

# 删除事件日志信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** delelog

Success: clear system event log successfully

2.13  查询网口信息

本命令用于查询网口信息。

【命令】

hrest -H host -p port -U username -P password getip -N ethernetid

【用户权限】

admin

【参数】

表2-17 参数说明

【说明】

当-N参数为空时，会返回命令中使用的HDM IP对应网口的信息。

需要注意的是，本工具无法获取使用串口等方式设置的临时IP信息，将返回Failure: Failed to get ip information。

【举例】

# 获取网口信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getip –NI eth1

--------------------------------------------------

Id                                      : eth0

Name                                    : eth0

Description                             : Ethernet Interface eth0

AutoNeg                                 : True

FQDN                                    : HDM210200A00QH17C000002.

FullDuplex                              : True

HostName                                : HDM210200A00QH17C000002

MACAddress                              : 30:7B:AC:DE:64:B2

IPv6DefaultGateway                      : ::

InterfaceEnabled                        : True

MTUSize                                 : 1500

MaxIPv6StaticAddresses                  : 16

NameServers                             : ::

PermanentMACAddress                     : 30:7B:AC:DE:64:B2

SpeedMbps                               : 1000

[Status]

Health                                  : OK

Status                                  : Enabled

[IPv4Addresses]

--------------------------------------------------

SubnetMask                              : 255.255.0.0

AddressOrigin                           : DHCP

Address                                 : 192.168.0.13

[IPv6Addresses]

--------------------------------------------------

Address                                 : fe80::327b:acff:fede:64b2

AddressOrigin                           : LinkLocal

PrefixLength                            : 64

--------------------------------------------------

【输出说明】

表2-18 输出说明

2.14  设置网口IPv4地址

本命令用于设置网口IPv4地址。

【命令】

hrest -H host -p port -U username -P password setipv4 –N ethernetid –S ipv4enable –IP address –T dhcpenable –G gateway –M subnetmask

【参数】

表2-19 参数说明

【举例】

# 设置eth0的IPv4地址。

-> hrest –H 192.168.10.6 –U ****** -P ****** setipv4 -N eth0 -IP 172.16.10.162 -T Static -G 0.0.0.0 -M 255.255.255.0

Success: set network successfully

2.15  设置网口IPv6地址

本命令用于设置网口IPv6地址。

【命令】

hrest -H host -p port -U username -P password setipv6 -N ethernetid -S ipv6enable -IP address -T dhcpenable -G gateway -L prefixlength

【参数】

表2-20 参数说明

【举例】

# 设置eth0网口的IPv6地址。

-> hrest –H 192.168.10.6 –U ****** -P ****** setipv6 -N eth0 -IP 2001:0:0:1A：：10

Success: set network successfully

2.16  获取网口VLAN信息

本命令用于获取网口VLAN信息。

【命令】

hrest -H host -p port -U username -P password getvlan -NI ethernetid

【参数】

表2-21 参数说明

【举例】

# 获取eth0网口的VLAN信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getvlan –N eth0

--------------------------------------------------

VLANEnable                    : False

VLANId                        : 0

--------------------------------------------------

【输出说明】

表2-22 输出说明

2.17  设置网口VLAN

本命令用于配置网口的VLAN。

【命令】

hrest -H host -p port -U username -P password setvlan –N ethernetid -S vlanenable -I vlanid –P priority

【参数】

表2-23 参数说明

【举例】

# 设置网口VLAN。

-> hrest –H 192.168.10.6 –U ****** -P ****** setvlan -NI eth0 -S Enabled -I 5 -P 0

Success: set network successfully

2.18  查询网口模式

本命令用于查询网口模式。

【命令】

hrest -H host -p port -U username -P password getnetmode

【举例】

# 查询网口模式。

-> hrest –H 192.168.10.6 –U ****** -P ****** getnetmode

--------------------------------------------------

PortModes                               : Normal mode

--------------------------------------------------

【输出说明】

表2-24 输出说明

2.19  设置HDM网口模式

本命令用于设置HDM网口模式。

【命令】

hrest -H host -p port -U username -P password setnetmode –M status

【参数】

表2-25 参数说明

【举例】

# 设置网口Bond模式。

-> hrest –H 192.168.10.6 –U ****** -P ****** setnetmode –M Bond

Success: set network port mode succeed

2.20  获取网卡信息

本命令用于获取网卡信息。

【命令】

hrest -H host -p port -U username -P password getmac

【举例】

# 获取网卡信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getmac

--------------------------------------------------

Product name                            : NIC-GE-4P-360T-L3

Product code                            : NIC

Network port                            : Port 1

Location                                : mLOM

Mac address                             : 30:7B:AC:DE:64:B3

Speed                                   : 2.5GT/s

--------------------------------------------------

Product name                            : NIC-GE-4P-360T-L3

Product code                            : NIC

Network port                            : Port 2

Location                                : mLOM

Mac address                             : 30:7B:AC:DE:64:B4

Speed                                   : 2.5GT/s

--------------------------------------------------

Product name                            : NIC-GE-4P-360T-L3

Product code                            : NIC

Network port                            : Port 3

Location                                : mLOM

Mac address                             : 30:7B:AC:DE:64:B5

Speed                                   : 2.5GT/s

--------------------------------------------------

Product name                            : NIC-GE-4P-360T-L3

Product code                            : NIC

Network port                            : Port 4

Location                                : mLOM

Mac address                             : 30:7B:AC:DE:64:B6

Speed                                   : 2.5GT/s

--------------------------------------------------

【输出说明】

表2-26 输出说明

2.21  获取IP登录规则信息

本命令用于获取登录规则信息。

【命令】

hrest -H host -p port -U username -P password getloginruleip

【举例】

# 获取登录规则信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getloginruleip

--------------------------------------------------

IpFrom                                  : 172.16.0.3

IpTo                                    : 172.16.0.88

MacAddress                              :

Rule                                    : Blacklist

TimeRange                               : Disabled

TimeFrom                                : 0000-00-00T00:00

TimeTo                                  : 0000-00-00T00:00

--------------------------------------------------

IpFrom                                  : 172.10.3.55

IpTo                                    : 172.10.3.56

MacAddress                              : aa:aa:aa:aa:aa:aa

Rule                                    : Blacklist

TimeRange                               : Enabled

TimeFrom                                : 2020-07-01T06:25

TimeTo                                  : 2020-07-03T15:13

--------------------------------------------------

IpFrom                                  : 192.168.0.0

IpTo                                    : 192.168.255.255

MacAddress                              :

Rule                                    : Whitelist

TimeRange                               : Disabled

TimeFrom                                : 0000-00-00T00:00

TimeTo                                  : 0000-00-00T00:00

--------------------------------------------------

【输出说明】

表2-27 输出说明

2.22  设置IP登录规则

本命令用于设置登录规则，包含添加和删除登录规则。

【命令】

hrest -H host -p port -U username -P password addloginruleip  –O operator  –S rule –P starttime –Q endtime -IS ipstart –IE ipend

【参数】

表2-28 参数说明

【举例】

# 添加登录规则。规则为阻止，拦截期限为2020-05-20T12:22-2020-06-03T13:10，ip拦截范围为172.16.10.11-172.16.10.13

-> hrest –H 192.168.10.6 –U ****** -P ****** setloginruleip -O Add -E Block -IS 172.16.10.11 -IE 172.16.10.13 -M aa:aa:aa:aa:aa:aa -P 2020-05-20T12:22 -Q 2020-06-03T13:10

Success: set ip login rule succeed

# 删除登录规则。删除登录规则需要参数一一对应

-> hrest –H 192.168.10.6 –U ****** -P ****** setloginruleip -O Del -E Block -IS 172.16.10.11 -IE 172.16.10.13 -M aa:aa:aa:aa:aa:aa -P 2020-05-20T12:22 -Q 2020-06-03T13:10

Success: set ip login rule succeed

2.23  获取NVMe SSD信息

本命令用于获取NVMe SSD信息。

【命令】

hrest -H host -p port -U username -P password getnvmessd

【举例】

# 获取NVMe SSD信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getnvmessd

--------------------------------------------------

SlotID                        : N1 Slot 164

VendorName                    : INTEL

ProductName                   : P3520

PDStatus                      : Normal

PercentLife                   : 0

SerialNumber                  : CVPF733500CL450RGN

ModelNumber                   : SSDPE2MX450G7

Capacity                      : 450.0GB

FirmwareVersion               : MDV10271

PortType                      : PCIe

--------------------------------------------------

【输出说明】

表2-29 输出说明

2.24  获取功率封顶信息

本命令用于获取功率封顶信息。

【命令】

hrest -H host -p port -U username -P password getpowerlimit

【使用指南】

刀箱服务器无该参数。

【举例】

# 获取电源功率封顶信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getpowerlimit

--------------------------------------------------

PowerLimitEnable                        : False

LimitInWatts                            : 500

LimitException                          : HardPowerOff

--------------------------------------------------

【输出说明】

表2-30 输出说明

2.25  设置功率封顶

本命令用于设置功率封顶。

【命令】

hrest -H host -p port -U username -P password setpowerlimit -S status -V limitvalue –E exception

【参数】

表2-31 参数说明

【使用指南】

刀箱服务器不支持功率封顶设置。

【举例】

# 设置功率封顶。开启功率封顶，封顶值为600，超出封顶值后无动作。

-> hrest –H 192.168.10.6 –U ****** -P ****** setpowerlimit -S Enable -V 600 -E NoAction

Success: set power limit succeed

2.26  获取电源信息

本命令用于获取电源信息。

【命令】

hrest -H host -p port -U username -P password getpsu

【举例】

# 获取电源信息。

-> hrest –H 192.168.10.6 –U ****** -P ****** getpsu

--------------------------------------------------

Name                                    : PSU1

Model                                   : PSR550-12A

SerialNumber                            : N/A

PowerSupplyType                         : AC

PowerCapacityWatts                      : 550

LineInputVoltageType                    : ACMidLine

FirmwareVersion                         : 1M.0009.0021.001

PowerID                                 : 1

ActiveStandby                           : Active

[Status]

Health                                  : OK

State                                   : Enabled

--------------------------------------------------

Name                                    : PSU2

Model                                   : PSR550-12A

SerialNumber                            : 210231A8KXH17C000002

PowerSupplyType                         : AC

PowerCapacityWatts                      : 550

LineInputVoltageType                    : ACMidLine

FirmwareVersion                         : 4M.0002.0006.005;1M.0009.0021.003

PowerID                                 : 2

ActiveStandby                           : Active

[Status]

Health                                  : OK

State                                   : Enabled

--------------------------------------------------

【输出说明】

表2-32 输出说明

2.27  切换主备电源

本命令用于切换主备电源。

【命令】

hrest -H host -p port -U username -P password setpmb -I powerid -S status

【参数】

表2-33 参数说明

【举例】

# 设置电源id为2的电源为备用电源。

-> hrest –H 192.168.10.6 –U ****** -P ****** setpmb –I 2 –S Standby

 Success: set power redundancy succeed

2.28  控制系统上下电

本命令用于控制系统上下电。

【命令】

hrest -H host -p port -U username -P password syspowerctrl -T type

【参数】

表2-34 参数说明

【举例】

# 控制系统强制关机。

-> hrest –H 192.168.10.6 –U ****** -P ****** syspowerctrl -T ForceOff

Success: set power state succeed