1. 10-运营管理端
DCIM
  • 默认模块
    • whmcs回调
  • DCIM Backend API
    • 用户入口
      • 工单
        • 工单列表
        • 创建工单
    • 认证
      • 用户登录
      • 管理员登录
      • API认证
    • 系统
      • 系统更新
        • 检查系统更新
        • 获取更新日志
      • 系统API管理
        • 获取系统API列表
        • 创建系统API
        • 修改系统API
        • 删除系统API
      • 获取公共系统配置
    • 服务器
      • 服务器管理
        • 自定义字段
          • 获取服务器自定义字段
          • 创建服务器自定义字段
          • 修改服务器自定义字段
          • 删除服务器自定义字段
        • 添加服务器
        • 获取服务器详情
        • 编辑服务器
        • 删除服务器
        • 空闲服务器IP段
        • 自动分配MAC地址
        • 控制服务器电源
        • 修改服务器备注
        • 获取服务器日志
        • 获取服务器电源状态
        • 获取服务器监控信息详情
        • 获取服务器交付信息
        • 开启服务器DHCP
        • 服务器列表Excel导出
        • 服务器列表Excel导出下载
      • 服务器IP地址
        • IPv6
          • 自动批量分配IPv6段
          • 生成指定数量的IPv6地址
          • 空闲ipv6
          • 批量分配IPV6段
          • 获取服务器IPv6地址列表
        • IPv4
          • 空闲ip
          • 设置主ip
          • 分配IPV4段
          • 获取服务器IPv4地址列表
          • 分配ip
          • 获取服务器IP地址块
          • 获取IP段列表
          • 获取IP地址列表
      • 服务器硬件
        • 服务器硬件管理
          • 发送真实硬件获取脚本
          • 获取服务器真实硬件历史
          • 获取服务器真实硬件历史详情
        • 获取服务器硬件列表
        • 分配服务器硬件
        • 移除服务器硬件
        • 返修服务器硬件
        • 获取批次类型
        • 获取硬件类型
        • 获取批次采购时间
        • 获取批次硬件
        • 获取机柜服务器列表
      • 服务器分配
        • 取消分配api
        • 取消分配服务器给用户
        • 获取服务器分配列表
        • 获取服务器分配列表
        • 获取用户服务器下拉列表
        • 分配服务器给用户
      • 服务器规格
        • 分配规格
        • 取消规格
      • 服务器交换机端口
        • 修改交换机端口
        • 修改交换机端口 - QoS
        • 修改交换机端口 - VLAN
        • 获取交换机端口
      • 服务器重装
        • 镜像列表
        • 服务器重装系统
        • 获取重装系统镜像列表
        • 获取镜像预设分区
        • 重置服务器操作系统管理员密码
      • 服务器故障
        • 服务器故障
      • 服务器网卡管理
        • 获取服务器网卡列表
        • 服务器网卡添加
        • 服务器网卡修改
        • 服务器网卡删除
      • 服务器杂项接口
        • 获取服务器可用的IP地址列表
        • 获取可用的网关设备
        • 获取服务器网关设备绑定的自定义脚本
        • 执行服务器网关设备绑定的自定义脚本
        • 绑定服务器网卡
        • 获取服务器网卡获取端口vlan
        • 统计服务器电源功耗数据
        • 获取服务器被攻击事件
      • 服务器IPMI
        • 检测服务器KVM类型
        • 获取服务器mac地址
        • 获取服务器IPMI控制台
        • 关闭服务器IPMI控制台
        • 检查vnc连接
        • 获取服务器在线的会话
        • 发送键盘操作到IPMI控制台
        • 服务器电源控制
        • 重置服务器BMC
        • 启动救援模式
        • 修改服务器hostname
        • 取消服务器下所有关联
        • 设置服务器主端口开关
        • 设置服务器下一次启动顺序
        • 设置服务器从在线ISO启动
        • 获取服务器KVM文件
        • 获取IPMI用户列表
        • 添加IPMI用户
        • 修改IPMI用户状态
        • 修改IPMI用户密码
        • IPMI在线检测
        • 删除IPMI用户
      • 服务器简单锁定
        • 修改简单锁定
        • 删除简单锁定
        • 增加简单锁定
        • 获取简单锁定状态
      • 服务器流量计费
        • 获取流量计费列表
        • 添加流量计费
        • 修改流量计费
        • 删除流量计费中的服务器
        • 关联添加流量计费
        • 关联修改流量计费
        • 指定流量包列表
        • 添加流量包
        • 删除流量包
        • 获取流量池列表
        • 删除流量池
      • 服务器预下架
        • 创建服务器预下架请求
        • 删除服务器预下架请求
        • 获取服务器预下架请求
      • 服务器任务
        • 获取服务器任务进度
        • 取消服务器任务
      • 服务器分组管理
        • 添加服务器分组
        • 获取服务器分组列表
        • 编辑服务器分组
        • 获取单条服务器分组详情
        • 删除服务器分组
      • 通过序列号获取服务器信息
      • 获取服务器列表
      • 获取交付服务器通知内容
      • 服务器交付通知
      • 获取服务器端口
    • 数据源
      • 数据源回调处理
    • 管理员
      • 管理员
        • 获取管理员列表
        • 获取管理员详情
        • 修改管理员信息
        • 添加管理员
        • 删除管理员
        • 获取管理员列表(简化版)
        • 上传管理员头像
      • 获取当前会话权限
      • 获取当前管理员信息
      • 修改当前管理员信息
      • 获取当前管理员OTP二维码
      • 绑定当前管理员OTP
      • 解除绑定当前管理员OTP
      • 获取指定管理员OTP二维码
      • 绑定指定管理员OTP
      • 解除绑定指定管理员OTP
    • 授权
      • 获取授权模块信息
      • 获取机器码
      • 检查授权证书更新
      • 更改授权证书
      • 获取本地授权信息
      • 更新授权证书
      • 使用文件上传更新授权证书
      • 使用序列号更新授权证书
    • 数据中心
      • 数据中心
        • 添加数据中心
        • 获取数据中心列表
        • 修改数据中心
        • 获取数据中心详情
        • 删除数据中心
      • 获取仪表板数据中心列表
      • 获取数据中心机柜列表
      • 获取数据中心能耗带宽图表
      • 获取数据中心下的交换机
      • 获取数据中心选项
    • 机柜
      • 机柜
        • 添加机柜
        • 获取机柜列表
        • 编辑机柜
        • 获取机柜详情
        • 删除机柜
      • 获取机柜空间
      • 获取机柜中的交换机
      • 统计机柜电源功耗数据
      • 解除锁定
      • 获取指定数据中心的机柜列表
      • 获取机柜图片列表
      • 上传机柜图片
      • 获取机柜图片
    • 会话
      • 删除会话
      • 查看会话
    • 用户
      • 用户管理 - OTP
        • 获取二维码信息
        • 绑定otp
        • 解除绑定otp
        • 获取二维码信息
        • 绑定otp
        • 解除绑定otp
      • 用户管理 - API
        • 用户 API 列表
        • 创建用户 API
        • 修改用户 API
        • 删除用户 API
      • 用户管理
        • 用户列表
        • 添加用户
        • 获取用户详情
        • 编辑用户
        • 删除用户
        • 关键字搜索用户
        • 用户下拉列表
        • 用户服务器列表
        • 用户IP地址列表
        • 用户IP地址列表
        • 用户IP地址列表
      • 用户组管理
        • 创建用户组
        • 用户组列表
        • 创建管理员组
        • 管理员列表
        • User用户组列表
        • 编辑用户组
        • 删除用户组
        • 编辑管理员组
        • 删除管理员组
        • 用户组详情
        • 管理员用户组列表
        • 获取组通知权限内容
        • 修改组通知权限内容
        • 获取个人通知权限内容
        • 修改个人通知权限内容
      • 获取SSH Key
      • 添加SSH Key
    • 文件
      • 获取文件哈希
      • 下载文件
    • 网络安全
      • 获取可用数据源模块
      • 获取数据源远程数据
      • 数据源列表
      • 创建数据源
      • 获取安全事件列表
      • 创建安全事件
      • 标记安全事件完成
      • 删除安全事件
      • 获取安全概览信息
      • 获取按IP地址排名
      • 获取按IP段排名
      • 获取轮询数据源类型
      • 测试轮询数据源连接
      • 获取轮询数据源列表
      • 创建轮询数据源
      • 更新轮询数据源
      • 删除轮询数据源
      • 获取轮询数据源下的MO列表
      • 迁移MO IP
      • 获取轮询数据源下的访问列表
      • 获取轮询数据源下的告警列表
    • 日志管理
      • 获取操作日志列表
      • 获取登录日志列表
      • 获取特定模型操作日志
      • 记录操作日志
    • 控制台
      • 获取会话命令日志
      • 获取会话连接日志
    • 被控管理
      • 被控管理
        • 获取被控设备列表
        • 添加被控设备
        • 编辑被控设备
        • 删除被控设备
        • 获取单个被控设备
      • 检查被控设备版本
      • 请求被控设备下载新版本
      • 请求被控设备应用新版本
      • 获取被控设备当前负载
      • 获取被控设备历史负载
      • 获取被控设备选择列表
      • 检查主机是否在线
      • 获取VNC令牌
      • 清理镜像缓存
    • 工单
      • 工单状态管理
        • 获取工单状态列表
        • 添加工单状态
        • 编辑工单状态
        • 删除工单状态
      • 工单管理
        • 获取工单详情
        • 删除工单
        • 获取工单列表
        • 创建工单
        • 快速编辑工单状态
      • 工单回复管理
        • 获取工单部门列表
        • 获取工单部门下的管理员
        • 查看工单回复信息
        • 增加工单回复
        • 修改工单回复
      • 消息分类管理
        • 获取消息分类列表
        • 创建消息分类
        • 编辑消息分类
        • 删除消息分类
      • 分类信息管理
        • 获取分类信息列表
        • 创建分类信息
        • 编辑分类信息
        • 删除分类信息
      • 工单部门管理
        • 工单部门
          • 添加工单部门
          • 获取工单部门列表
          • 编辑工单部门
          • 删除工单部门
        • 自定义字段
          • 获取自定义字段
          • 创建自定义字段
          • 修改自定义字段
          • 删除自定义字段
        • 获取类型列表
        • 获取类型参数
    • 镜像
      • 镜像管理
        • 镜像列表
        • 添加镜像
        • 远程下载镜像
        • 镜像详情
        • 修改镜像
        • 删除镜像
        • 获取存储镜像文件名列表
        • 上传镜像
        • 获取镜像选项
        • 删除被控上缓存的镜像源文件
        • 获取公开镜像列表
        • 同步文件
        • 获取下载进度
      • 镜像分区方案
        • 获取镜像分区方案列表
        • 添加镜像分区方案
        • 获取镜像分区方案详情
        • 修改镜像分区方案
        • 删除镜像分区方案
        • 根据镜像获取分区方案
      • 镜像分组
        • 获取镜像分组列表
        • 添加镜像分组
        • 获取镜像分组详情
        • 编辑镜像分组
        • 删除镜像分组
        • 获取服务器分组列表
    • 规格管理
      • 添加规格
      • 获取规格列表
      • 获取规格信息
      • 修改规格
      • 删除规格
      • 获取规格详情
      • 规格分配服务器
      • 获取规格中可用的服务器
      • 获取规格列表
      • 规格服务器列表
    • 通知模板管理
      • 通知模板列表
      • 添加通知模板
      • 通知模板修改
      • 通知模板删除
      • 获取语言列表
      • 获取通知类型
      • 获取供应商列表
      • 获取供应商字段
      • 获取供应商配置字段
      • 添加或编辑供应商配置字段
    • 驱动管理
      • 获取驱动列表
      • 添加驱动
      • 获取驱动详情
      • 编辑驱动
      • 删除驱动
      • 获取驱动下拉列表
    • SSH Keys
      • 获取 SSH Key 列表
      • 添加 SSH Key
      • 修改 SSH Key
      • 删除 SSH Key
    • 首页
      • 首页统计
    • 返修
      • 返修列表
    • 任务
      • 任务列表
      • 取消任务
      • 任务详情
    • 全局搜索
      • 全局搜索
    • 交换机管理
      • 交换机端口关联关系管理
        • 获取所有交换机端口的关联关系
        • 刷新所有交换机端口的关联关系
        • 更新交换机拓扑图多点位置信息
        • 删除交换机拓扑图单点位置信息
      • 交换机脚本管理
        • 获取交换机控制脚本内置变量
        • 获取交换机控制脚本列表
        • 创建交换机控制脚本
        • 获取交换机控制脚本详情
        • 修改交换机控制脚本
        • 删除交换机控制脚本
        • 交换机关联控制脚本
      • 交换机管理
        • 预览交换机控制脚本
        • 执行交换机控制脚本
        • 获取端口详情
        • 获取交换机 Chassis Mac
        • Web 远程连接
        • 创建交换机上下联
        • 删除交换机上下联
        • 获取交换机详情
        • 修改交换机
        • 删除交换机
        • 获取交换机端口列表
        • 获取交换机端口列表V2
        • 获取端口差异列表
        • 更新端口差异
        • 修改交换机备注
        • 抓取交换机SNMP连接状态
        • 获取交换机自定义字段
        • 创建交换机自定义字段
        • 修改交换机自定义字段
        • 删除交换机自定义字段
        • 获取网关地址IP
        • 获取交换机IP段
        • 执行交换机端口开关脚本
        • 执行交换机端口限速脚本
        • 执行交换机端口vlan脚本
        • 获取端口流量
        • 修改端口备注
        • 端口流量排行
        • 更新端口mac
        • 解锁交换机mac地址绑定
        • 加锁交换机mac地址绑定
        • 交换机端口状态获取
        • 交换机端口名备注修改
        • 交换机端口自动获取mac
        • 交换机端口自动获取物理mac
        • 交换机端口自动获取链路速率
        • 交换机端口自动获取mtu
        • 获取交换机端口上的所有mac地址
      • 交换机高级功能
        • 添加交换机ARP绑定
        • 删除交换机ARP绑定
        • 添加交换机ACL绑定
        • 删除交换机ACL绑定
        • 执行交换机批量动作
        • 交换机故障申报
        • 开启交换机Netconf功能
        • 获取交换机关联网关
        • 增加交换机网关关联
        • 解除交换机网关关联
      • 交换机流量与会话管理
        • 获取指定交换机端口的流量
        • 获取指定端口的流量
        • 获取交换机信息
        • 获取交换机在线的会话
        • 修改交换机账号密码
      • 获取交换机扩展支持
      • 获取交换机列表
      • 添加交换机
      • 修改简单锁定
      • 通过 SNMP 获取交换机型号
    • 硬件管理
    • 数据模型
      • ImagePartitionBrief
      • Server
      • ImagePartitionDetail
      • ServerCreate
      • ImagePartitionCreate
      • ServerUpdate
      • ImagePartitionUpdate
      • IpBlock
      • VirtualDisk
      • Part
      • Partition
      • IpmiUser
      • ErrorResponse
  • DCIM手册
    • docs-manual
      • 90-附录
        • 如何把本手册导入 Apifox(含图片处理说明)
        • 常见问题 FAQ
        • 截图待补充清单
      • 30-单机服务器端
        • 《单机服务器访问端(server 角色)》
      • 20-客户自助端
        • 《客户自助端:开始使用》
        • 客户端:管理我的服务器(详情/电源/重装/救援/控制台)
        • 客户端:我的网络(IP / 流量 / 带宽)
        • 《客户端:提交与跟进工单》
        • 《客户端:账户设置、SSH 密钥与 API》
      • 10-运营管理端
        • 《运营管理端总览》
        • 《首页(数据概览)》
        • 《机柜与数据中心管理》
        • 服务器管理(核心)
        • 《交换机管理》
        • 《硬件型号与 PDU 电源管理》
        • 《设备故障与维护记录(issues)》
        • 《IPv4 地址资源管理》
        • 《IPv6 地址资源管理》
        • 网络安全:源地址校验、ARP 绑定与攻击防护
        • 《Cloudflare 与攻击防护数据源》
        • 《内网设备与流量/带宽计费》
        • 《部件与批次管理(备件库)》
        • 《工单管理》
        • 用户与规格(套餐)管理
        • 《统计报表》
        • 系统设置:基础参数 / 邮件 / 短信 / 公告 / 证书 / 文件
        • 系统设置:操作系统镜像与分区方案
        • 系统设置:备份 / 远程存储 / 从节点 / Webhook / 序列号规则
        • 带宽限速(流量计费与自动限速)
        • 《远程控制台(VNC/KVM)与会话录像》
        • 任务队列
        • 运维审计与日志
        • 《管理员账号与权限分组》
        • 《检测工具》
      • 00-入门指南
        • 欢迎使用 ServerOS / DCIM 用户手册
        • 产品简介:这套系统是做什么的(DCIM 是什么)
        • 《IDC / 数据中心术语速查表》
        • 《登录与首次使用》
        • 《界面布局与导航总览》
        • 《账号角色与权限说明》
  1. 10-运营管理端

《硬件型号与 PDU 电源管理》

本节面向**运营管理端(admin)**管理员,介绍两个互相配合的基础数据模块:
硬件型号:服务器、刀片机箱等物理设备的"规格模板"。先把一类设备的规格(占用机柜高度、网口数量、远程管理方式等)登记成一个"型号",以后每次上架同款设备时直接套用即可。
PDU 电源管理:登记机柜里的配电设备(PDU),把它的每个供电插口(端口)与服务器关联起来,进而实现"在后台远程开关某台服务器的电源"。
先看懂两个核心比喻
硬件型号 = 衣服的"尺码标签":你不会给每件衣服单独量一遍尺寸,而是先定义"S/M/L",再给每件衣服贴标签。硬件型号就是设备的尺码标签。
PDU = 机柜里的"智能插线板":普通插线板只能手动按开关,PDU(Power Distribution Unit,机柜配电单元)是带网络的插线板,管理员在后台点一下就能远程给某个插口断电/通电、还能读出耗电量。

一、硬件型号(Hardware)#

1.1 这个模块解决什么问题#

数据中心里会有成百上千台物理服务器,但它们往往只属于少数几种"款式"。比如某品牌 1U 机架服务器、某品牌 2U 服务器、某种刀片机箱……同一款设备的"物理规格"和"管理方式"完全一样:
占用机柜里几个 U 位(机柜的高度单位,1U≈4.45 厘米,机架式服务器通常 1U~4U 高;详见《IDC 术语速查表》);
有几个网口;
用什么方式做远程带外管理(不开机也能远程开关机、看屏幕,见下文 KVM/IPMI 说明)。
把这些规格登记成一个硬件型号后,今后录入服务器时只要选"它是哪个型号",系统就自动知道它占几 U、有几个网口、怎么远程管理,省去重复填写,也保证数据一致。
重要约束:一个硬件型号一旦被服务器使用,就不能删除(系统提示"当前类型由服务器正在使用");如果它是刀片机型号,也不能再修改它的"机箱容量/机箱行数"等结构性规格(系统提示"不支持刀片机修改机器规格")。所以建议在大批量上架前先把型号规划好。

1.2 进入方式与列表页#

导航路径:设备管理 > 硬件型号。
进入后是一张型号列表表格,每一行是一个已登记的型号。列表中可见的列如下:
列名含义说明
硬件型号型号名称,由你自定义(如"Dell R740 2U"),系统内不允许重名
设备容量(U)这种设备占用机柜的高度,单位 U(必须是正整数)
节点数量普通服务器为 1;刀片机箱填实际能容纳的刀片台数(对应表单里的"机箱容量(台)")
深度(CM)此列显示的是该型号的"机箱行数"(即表单里的"机箱行数"字段),普通设备为 1;列名"深度(CM)"为界面历史叫法,实际含义是行数
端口数量这种设备有几个网口
KVM类型远程管理/远程开关机所采用的协议或品牌型号(见 1.4)
是否支持IPMI一个开关,表示该型号是否启用 IPMI 远程管理能力
操作行末的"修改"(铅笔图标)、"删除"(垃圾桶图标)按钮
页面顶部有筛选/搜索区(可按硬件型号名称、节点数量等条件过滤),筛选区右侧是新建型号的"添 加"按钮;表格可勾选多行,配合列表底部的"删除"链接批量删除(删除前会弹出"确认删除 N 硬件型号 ?"确认框)。
提示:"是否支持IPMI"这一列可以直接点击切换。点击后会弹出确认框("确定要 关闭/开启 IPMI功能?"),确认后立即生效,无需进入编辑弹窗。该开关需要有相应操作权限才能点击。
hw-pdu-hardware-list.png

1.3 新建 / 编辑硬件型号#

点击"添 加"按钮,或某行的"修改"图标,弹出"添加 硬件型号"/"修改 硬件型号"表单。表单分左右两栏,字段说明如下:
左栏(基础规格)
字段是否必填说明
名称必填型号名称,不可为空、不可与已有型号重名
高度(U)必填该设备占用的机柜高度,必须是大于 0 的整数(否则提示"设备高度不能小于0")
是否为刀片机开关打开后才会出现下面两个刀片专用字段(见 1.5)
机箱容量(台)刀片机必填这台机箱能容纳几台刀片服务器(须为大于 0 的整数,否则提示"机箱容量不能小于0")
机箱行数刀片机必填刀片在机箱里的排列行数(须为正整数)
绑定镜像选填选择这种型号允许安装哪些操作系统镜像(即可装机的系统模板,如某版本 CentOS/Windows,详见《IDC 术语速查表》)。支持多选,下拉里有"全选"项
右栏(网络与管理)
字段是否必填说明
端口数量必填网口数量,须为 ≥1 的整数(否则提示"端口数量不能小于1")。填入数字后,下方会自动出现对应数量的"内置网口名称"输入框
内置网口名称选填给每个网口起名(如 eth0、LAN1),便于识别
Mac地址偏移量选填一个 110 或 -10-1 之间的整数(即绝对值 1~10、且不为 0),用于推算设备网卡的 MAC 地址规律(MAC 地址是每块网卡全球唯一的硬件编号;偏移量是高级选项,不清楚可留空)。填 0 会被拒绝(提示"mac偏移量不能为0")
KVM类型必填远程管理协议/品牌(见 1.4)
是否支持IPMI开关是否启用 IPMI 远程管理(见 1.4 术语解释)
上传照片选填可分别上传设备"正面照片""背面照片",便于运维识别接口位置;图片须为图片格式,大小受系统"文件大小限制"配置约束(超限会被拒绝)
填好后点击底部的"立即添加"(新建)或"立即修改"(编辑),"取消"按钮关闭弹窗。新建成功后系统提示"添加 硬件型号成功"。
校验要点(来自系统规则)
名称为空或重名时无法提交(重名提示"名称已被占用")。
高度、端口数量、机箱容量必须是正整数。
勾选"是否为刀片机"后,"机箱容量"与"机箱行数"必须能整除(容量能被行数整除,详见 1.5);新建时不满足提示"刀片机容量错误",编辑时提示"机箱规格无法识别"。
若该型号已被服务器使用,修改机箱容量/行数会被拒绝(提示"不支持刀片机修改机器规格")。
hw-pdu-hardware-form.png

1.4 关于 KVM 类型与 IPMI(远程带外管理)#

机房里的服务器通常没人坐在旁边,管理员需要不依赖操作系统就能远程开关机、重启、看到开机自检画面、挂载安装盘——这套能力统称带外管理(Out-of-Band)。它依赖服务器主板上一块独立小电脑:
BMC(基板管理控制器):服务器主板上一块始终在线的小芯片,相当于设备的"远程遥控器接收器",即使主机关机它也在工作。
IPMI(智能平台管理接口):一套行业通用的"遥控指令标准"。管理员通过 IPMI 就能远程开关机、读温度风扇等。本表单中的"是否支持IPMI"即标记该型号是否具备这种能力。
KVM(远程键盘/显示器/鼠标):让你像坐在机器前一样,在浏览器里看到它的屏幕并操作键鼠。不同服务器品牌的 KVM 实现不同,所以这里要选具体类型。
"KVM类型"下拉框的可选值由系统内置,界面上显示的名称如下(可输入关键字筛选):
分类界面显示的选项名称
自动识别自动检测
戴尔 DellDELL - iDRAC6、Dell - iDRAC7、Dell - iDRAC8、Dell - iDRAC9
惠普 HPHP - ILO2、HP - ILO4、HP - ILO5
超微 SuperMicroSuperMicro、SuperMicro OEM
华为 Huawei华为 iBMC、华为 iBMC 6、华为 iMana、华为 iMana (兼容增强)
新华三 H3CH3C HDM
联想 Lenovo联想 ThinkSystem XClarity
思科 CiscoCisco - IMC
英特尔 IntelIntel - iBMC v1
浪潮 Inspur浪潮 OEM
华擎 ASRockRackASRockRack OEM
通用 / AMI 系列通用KVM v1、通用KVM v2、通用KVM v2 (兼容增强)、MegaRAC SP-X、TopLink IKVM
调试用(不建议生产环境选)VNC (仅供调试)、浏览器 (仅供调试 - 默认显示 bing.com)
小白怎么选? 如果不确定服务器品牌型号,可先选"自动检测"。否则按服务器实际品牌选对应项(如戴尔机器选 iDRAC 对应版本)。带"仅供调试"字样的 VNC、浏览器两项只用于内部调试,正式环境请勿选用。选错可能导致远程屏幕无法连接。

1.5 刀片机箱(BladeChassis)概念#

普通机架服务器是"一台就是一台",独占若干 U 位。刀片服务器则不同:
刀片机箱比喻:把它想成一个"插卡式充电柜"。**机箱(Chassis)是那个大柜子,固定占用机柜里若干 U 位、提供统一的供电和散热;每台刀片服务器(Blade)是一张薄薄的"卡",插进柜子的一个槽位(Space)**里。一个机箱能插多张刀片,密度比传统服务器高很多。
在硬件型号里勾选"是否为刀片机"(编辑已有型号时,若该型号"机箱容量"大于 1,系统会自动认定它是刀片机),并填写:
机箱容量(台):这个机箱总共有几个刀片槽位(即能插几台刀片)。
机箱行数:槽位排成几行。系统要求"机箱容量能被行数整除"(容量 ÷ 行数 = 每行槽位数,必须为整数),否则提示规格错误。例如容量 16、行数 2,表示 2 行、每行 8 个槽位。
登记好刀片机型号后,刀片机箱的实际上架与槽位管理是在机柜里完成的(详见《机柜管理》章节):把一个机箱实例放进机柜的连续 U 位(机箱占用的 U 数等于型号的"设备容量(U)"),机箱内的各个槽位再分别插入刀片服务器。系统会维护"机箱占用了机柜哪些 U 位""每个槽位是空着还是插了哪台刀片"。
删除约束:删除一个刀片机型号时,如果它名下的机箱里还插着刀片服务器(槽位被占用),系统会拒绝删除并提示"当前机箱有设备正在使用"。需先把刀片服务器下架,才能删除型号及其机箱(删除型号时,名下空置的机箱及其占用的机柜 U 位会被一并清理释放)。
📷 (界面截图待补充:硬件型号弹窗中打开"是否为刀片机"开关后,左栏新出现的"机箱容量(台)"和"机箱行数"两个输入框)

二、PDU 电源管理#

2.1 PDU 是什么、能做什么#

PDU(Power Distribution Unit,机柜配电单元) 就是机柜里那块"智能插线板"。和家里普通插线板的区别在于:
它有很多供电端口(插口),每台设备插在某个端口上;
它接入网络、能被后台远程控制,管理员可以远程给某个端口断电/通电/重启,相当于不用到机房就能把某台服务器"拔电重启";
它还能采集**用电量(瓦特,W)**等数据,用于能耗统计。
把 PDU 登记进系统并把它的端口与服务器关联后,运营人员就能在后台远程控制对应服务器的供电——这对处理"系统卡死、远程也连不上"的故障特别有用(强制断电重启,俗称"硬重启")。
本系统的 PDU 通过 SNMP 协议通信。 SNMP(简单网络管理协议) 是网络设备之间"汇报状态、接受指令"的通用语言。配置 PDU 时需要填它的 SNMP 通信 IP、版本、"社区名"和端口(见 2.3)。

2.2 PDU 列表页#

导航路径:设备管理 > PDU管理(进入 PDU 列表)。
列表每行是一台已登记的 PDU,可见列:
列名含义
ID系统编号
名称PDU 名称(可点击进入"PDU 详情"页)
机柜这台 PDU 所在的机柜(可点击跳转机柜详情)
电压该 PDU 的工作电压
用电量(W)最近一次采集到的功率,单位瓦特
上次采集时间最近一次成功读取数据的时间
操作行末"修改""删除"按钮
页面顶部筛选区右侧的"添 加"按钮新建 PDU;列表底部的"删除"链接可批量删除已勾选项(会先弹出"确定要删除 N 个PDU"确认框)。点击某台 PDU 的名称进入其详情页(见 2.5)。
hw-pdu-pdu-list.png

2.3 新增 / 编辑PDU#

点击"添 加"或某行"修改",弹出"添加 PDU"/"修改 PDU"表单。字段说明(按界面从上到下顺序):
字段是否必填说明
名称必填PDU 名称,系统内不可重名
数据中心必填先选这台 PDU 所在的数据中心(机房)
机柜必填选定数据中心后出现,选择 PDU 实际所在机柜
型号必填PDU 的驱动型号。系统当前内置 APC 型号(APC 是一家主流 PDU 厂商);不同型号支持的控制协议不同
控制协议选定型号后出现由所选型号决定;APC 型号为 SNMP
电压必填PDU 工作电压,文本输入
SNMP IP必填(选定机柜后出现)选择 PDU 的管理 IP 地址(即通过哪个 IP 与这台 PDU 通信)。需依次选择"IP 段类型 → IP 段 → 具体 IP 地址"
SNMP版本必填可选 1 或 2c(SNMP 协议版本号,按 PDU 实际设置填)
SNMP社区必填即 SNMP Community,相当于访问 PDU 的"口令",须与 PDU 上设置的一致
SNMP端口必填SNMP 通信使用的网络端口号(整数,常见为 161)
填好后点击"确定"提交,"取消"放弃。
保存时系统会真正去连接这台 PDU。 提交后,后端会用你填的 IP/社区/端口尝试连上 PDU 并读取它的端口列表:
若所选 IP 当前不是"空闲(Idle)"状态,会报"Ip not idle"(IP 不可用);
若连接不上,会报"connect error"(连接错误);
若连上了但读不到任何端口,会报"No port found"(未找到端口)。
添加成功后,这台 PDU 的端口会被自动导入系统(无需手填端口),同时占用的那个 IP 会被标记为"使用中(Using)/类型 PDU"。
修改 IP 的副作用:编辑 PDU 时若更换了 SNMP IP,系统会清空并重新拉取该 PDU 的全部端口(因为换了通信地址相当于重新对接设备)。
hw-pdu-pdu-form.png

2.4 PDU 与服务器的供电关系(绑定端口)#

登记好 PDU 后,需要把"哪台服务器插在哪个端口上"对应起来,之后才能远程控制这台服务器的电源。绑定操作在服务器详情页完成,而不是在 PDU 页面:
导航路径:设备管理 > 服务器管理 > 点开某台服务器 > "PDU"标签页。
该标签页是一张已绑定端口的列表,列为:ID、设备名称、端口名称、用电量、上次采集时间、操作。操作流程:
1.
点击列表操作列表头的"添加"按钮,弹出"添加 PDU 端口"对话框。
2.
在"PDU设备"下拉里选择一台 PDU。
3.
在"PDU端口"下拉里选择一个或多个尚未被占用的端口(已被其他设备绑定的端口不会出现在可选项里)。
4.
点击"确定"完成绑定,系统提示"添加成功"。
要解除绑定,在列表中点对应行的"删除",或勾选多行后点列表底部"删除"——这只是解绑(把端口从该服务器上摘下来),不会删除 PDU 本身或端口。
一个端口同一时间只能绑一台设备。 这保证了"端口 ↔ 服务器"的一一对应,远程开关电源时才不会误伤别的机器。
📷 (界面截图待补充:服务器详情PDU标签页的"添加PDU端口"弹窗,展示PDU设备下拉与PDU端口多选下拉)

2.5 PDU 详情与远程电源控制#

在 PDU 列表点击某台 PDU 的名称,进入"PDU详情"页。页面顶部以卡片形式展示该 PDU 的端口(SNMP 通信端口号)、控制协议、电压三项概览信息;下方是端口明细表格:
列含义
ID端口编号
端口名称从 PDU 读到的端口名
端口状态一个开关,这就是远程电源控制的总开关(见下)
关联设备类型已绑定时显示"服务器"
关联设备该端口绑定的设备名称,可点击跳转到该设备详情
用电量该端口最近采集到的功率
上次采集时间最近一次成功采集的时间
远程开关电源:直接点击某端口"端口状态"列的开关即可。打开开关 = 给该端口通电(Power On);关闭 = 断电(Power Off)。系统会弹出加载提示并真正向 PDU 下发指令,成功后提示"修改成功"。
警告:断电是物理级操作。 关闭某端口等于直接拔掉对应服务器的电源(硬断电),会导致该服务器立即关机、可能丢失未保存数据。请务必先确认"关联设备"列指向的是你要操作的那台机器,再执行断电/通电。
系统在后端还实现了"电源重置(Power Cycle)"能力:若 PDU 型号原生支持(如 APC)就直接下发重置指令;否则按"先断电 → 等待 1 秒 → 再通电"的方式模拟一次硬重启。该能力供后端调用,详情页上直接可见的操作仍是"端口状态"开关。
📷 (界面截图待补充:PDU详情页,顶部端口/控制协议/电压概览卡片,下方端口明细表格,含"端口状态"开关、关联设备类型、关联设备等列)

2.6 删除 PDU 的注意事项#

在 PDU 列表勾选要删除的 PDU,点击列表底部"删除"并在确认框中确认。删除时系统会:
把该 PDU 占用的管理 IP 释放回"空闲(Idle)"状态;
清理该 PDU 的端口记录。
建议:删除前先在服务器详情页解除相关端口绑定,避免遗留无效关联。

三、常见问题与排错#

现象 / 提示可能原因与处理
硬件型号提示"名称已被占用"型号名称不可重复,换一个名字
提示"刀片机容量错误"/"机箱规格无法识别"/"机箱容量不能小于0"刀片机的"机箱容量"必须能被"机箱行数"整除,且均为正整数
提示"不支持刀片机修改机器规格"该刀片机型号已有服务器在用,结构性规格(机箱容量/行数)不可改;需先下架相关服务器
提示"mac偏移量不能为0"Mac 地址偏移量不能填 0,留空或填 110、-10-1 之间的整数
删除硬件型号提示"当前类型由服务器正在使用"该型号已被服务器使用;先下架相关服务器再删
删除硬件型号提示"当前机箱有设备正在使用"该刀片机型号的机箱内仍插有刀片服务器;先下架刀片再删
新增 PDU 提示"Ip not idle"(IP 不可用)所选 SNMP IP 不是空闲状态,换一个空闲 IP,或先释放该 IP
新增 PDU 提示"connect error"(连接错误)IP/SNMP 社区/端口/版本填错,或 PDU 不在线、网络不通;逐项核对后重试
新增 PDU 提示"No port found"(未找到端口)能连上但读不到端口,多为社区名不匹配或型号选错,核对 PDU 实际配置
远程开关端口无反应/报错该 PDU 型号可能不支持开关控制功能,或与设备通信中断;检查 PDU 在线状态
术语小结(详见《IDC 术语速查表》):U 位=机柜高度单位;BMC/IPMI=主板上的远程管理芯片与标准;KVM=远程看屏幕操作键鼠;刀片机箱=插卡式服务器柜;PDU=机柜智能插线板;SNMP/社区名=设备远程管理协议与口令;用电量(W)=功率瓦特。
修改于 2026-06-25 07:46:47
上一页
《交换机管理》
下一页
《设备故障与维护记录(issues)》
Built with