CSR配置字典之SOL类 ​

📋 文档信息 ​

📋 变更历史记录 ​

🎯 类概览 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

• 无可选属性

🔗 动态关联机制 ​

语法规范 ​

# SOL配置
Enabled: true
Mode: 0
SerialDirect: 1
Timeout: 15
Id: 1
AuthenWay: 0
EncryWay: 1
PrivilegeLevel: 4
SendThreshold: 32
SendInterval: 8
RetryCount: 3
RetryInterval: 20
SetProgress: 0
IPMISOLEnabled: true

关联说明 ​

• Enabled: 控制CLI_SOL功能总开关
• Mode: 控制CLI_SOL会话模式（共享/独占）
• SerialDirect: 控制串口数据流向
• Timeout: 控制空闲会话超时
• Id: 唯一标识SOL配置实例
• AuthenWay/EncryWay: 控制认证和加密方式
• PrivilegeLevel: 控制访问权限
• SendThreshold/SendInterval: 控制字符发送策略
• RetryCount/RetryInterval: 控制重传策略
• IPMISOLEnabled: 控制IPMI SOL功能

🔢 属性取值说明 ​

会话与串口方向 ​

说明：Mode、SerialDirect 属于运行时状态量，通常由 rmcpd 在 SOL 激活/去激活时自动改写（激活时 Mode=1、SerialDirect=1，去激活时恢复为 0），CSR 中的值仅作为初始值/默认值使用。

认证与加密 ​

说明：PrivilegeLevel 在 IPMI 命令解析时校验 2 ≤ 取值 ≤ 5，取值 0/1 或大于 5 会返回 IPMIOutOfRange；AuthenWay、EncryWay 与 PrivilegeLevel 三者由同一条 Set SOL Configuration（参数 2）写入。

设置进度 ​

传输与会话参数 ​

📂 分类标准 ​

硬件属性 ​

• 定义：当前版本无硬件属性
• 特点：所有属性都是软件管理相关
• 示例：无

软件属性 ​

• 定义：由软件管理和维护的SOL配置参数
• 特点：会话管理、串口重定向、认证加密等
• 示例：所有属性都是软件属性

📝 配置示例 ​

标准共享模式配置 ​

{
  "SOL": {
    "Enabled": true,
    "Mode": 0,
    "SerialDirect": 1,
    "Timeout": 15,
    "Id": 1,
    "AuthenWay": 0,
    "EncryWay": 1,
    "PrivilegeLevel": 4,
    "SendThreshold": 32,
    "SendInterval": 8,
    "RetryCount": 3,
    "RetryInterval": 20,
    "SetProgress": 0,
    "IPMISOLEnabled": true
  }
}

独占模式配置 ​

{
  "SOL": {
    "Enabled": true,
    "Mode": 1,
    "SerialDirect": 1,
    "Timeout": 30,
    "Id": 1,
    "AuthenWay": 0,
    "EncryWay": 1,
    "PrivilegeLevel": 4,
    "SendThreshold": 64,
    "SendInterval": 5,
    "RetryCount": 5,
    "RetryInterval": 30,
    "SetProgress": 0,
    "IPMISOLEnabled": true
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 使能SOL功能：配置Enabled和IPMISOLEnabled
2. 选择会话模式：配置Mode属性
3. 设置串口方向：配置SerialDirect属性
4. 设置超时时间：配置Timeout属性
5. 配置认证加密：配置AuthenWay和EncryWay
6. 设置权限级别：配置PrivilegeLevel
7. 配置传输参数：配置SendThreshold和SendInterval
8. 配置重传策略：配置RetryCount和RetryInterval

会话模式说明 ​

串口方向说明 ​

使用场景 ​

• 远程调试：通过网络远程访问系统串口
• 故障诊断：查看系统启动信息和错误日志
• 设备配置：通过串口配置设备参数
• 应急处理：在无法通过其他方式访问系统时使用

注意事项 ​

• 安全性：SOL传输未加密，建议配合VPN使用
• 会话限制：共享模式下性能可能下降
• 超时设置：合理设置Timeout避免占用资源
• 权限控制：根据需要设置PrivilegeLevel
• 字符丢失：调整SendThreshold和SendInterval优化传输

故障排除 ​

1. SOL连接失败：

   • 检查Enabled和IPMISOLEnabled是否为true
   • 确认网络连接是否正常
   • 验证防火墙设置

2. 字符显示异常：

   • 检查SerialDirect配置是否正确
   • 调整SendThreshold和SendInterval -确认串口波特率设置

3. 会话超时：

   • 检查Timeout设置是否过短
   • 确认是否有网络中断 -验证会话保活机制